·  Home
+   man pages
 -> Linux -> FreeBSD -> OpenBSD -> NetBSD -> Tru64 Unix -> HP-UX 11i -> IRIX
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

man pages->Tru64 Unix man pages -> glClipPlane (3)
 Title
 Content
 Arch
 Section All Sections 1 - General Commands 2 - System Calls 3 - Subroutines 4 - Special Files 5 - File Formats 6 - Games 7 - Macros and Conventions 8 - Maintenance Commands 9 - Kernel Interface n - New Commands

## glClipPlane(3G)

```
```

### NAME[Toc][Back]

```       glClipPlane  -  specify a plane against which all geometry
is clipped
```

### SYNOPSIS[Toc][Back]

```       void glClipPlane(
GLenum plane,
const GLdouble *equation );
```

### PARAMETERS[Toc][Back]

```       Specifies which clipping plane is being  positioned.  Symbolic
names  of  the  form  GL_CLIP_PLANEi, where i is an
integer between 0 and GL_MAX_CLIP_PLANES-1, are  accepted.
Specifies the address of an array of four double-precision
floating-point values. These values are interpreted  as  a
plane equation.
```

### DESCRIPTION[Toc][Back]

```       Geometry  is  always  clipped  against the boundaries of a
six-plane frustum in x, y, and z.  glClipPlane allows  the
specification  of  additional planes, not necessarily perpendicular
to the x, y, or z axis, against which all geometry
is clipped. To determine the maximum number of additional
clipping planes, call glGetIntegerv() with argument
GL_MAX_CLIP_PLANES.  All  implementations support at least
six such clipping planes.  Because the resulting  clipping
region  is the intersection of the defined half-spaces, it
is always convex.

glClipPlane() specifies a half-space using  a  four-component
plane  equation. When glClipPlane() is called, equation
is transformed by the inverse of the modelview matrix
and  stored  in  the resulting eye coordinates. Subsequent
changes to the modelview matrix  have  no  effect  on  the
stored  plane-equation  components.  If the dot product of
the eye coordinates of a  vertex  with  the  stored  plane
equation  components is positive or zero, the vertex is in
with respect to that clipping plane. Otherwise, it is out.

To enable and disable clipping planes, call glEnable() and
glDisable() with the argument GL_CLIP_PLANEi, where  i  is
the plane number.

All  clipping planes are initially defined as (0, 0, 0, 0)
in eye coordinates and are disabled.
```

### NOTES[Toc][Back]

```       It   is   always   the   case   that   GL_CLIP_PLANEi    =
GL_CLIP_PLANE0+i.
```

### ERRORS[Toc][Back]

```       GL_INVALID_ENUM  is  generated if plane is not an accepted
value.

GL_INVALID_OPERATION is generated if glClipPlane() is executed
between  the  execution of glBegin() and the corresponding
execution of glEnd().

```

### ASSOCIATED GETS[Toc][Back]

```       glGetClipPlane()
glIsEnabled() with argument GL_CLIP_PLANEi

```

### SEE ALSO[Toc][Back]

```       glEnable(3)

glClipPlane(3G)
```
[ Back ]
Similar pages
 Name OS Title glreferenceplanesgix IRIX define a reference plane for coplanar geometry maintgeom IRIX maintain geometry of one window relative to another finish IRIX blocks until the Geometry Pipeline is empty pack IRIX Geometry manager that packs around edges of cavity passthrough IRIX passes a single token through the Geometry Pipeline pack IRIX Geometry manager that packs around edges of cavity managegeom IRIX arrange to handle geometry requests for a window geomreq IRIX specify desired geometry or internal border for a window pack-old IRIX Obsolete syntax for packer geometry manager place IRIX Geometry manager for fixed or rubber-sheet placement
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service