glGetClipPlane

The glGetClipPlane function returns the coefficients of the specified clipping plane.

void glGetClipPlane(
  GLenum plane,         
  GLdouble * equation   
);
 

Parameters

plane
A clipping plane. The number of clipping planes depends on the implementation, but at least six clipping planes are supported. They are identified by symbolic names of the form GL_CLIP_PLANEi where 0 ≤ i < GL_MAX_CLIP_PLANES.
equation
Returns four double-precision values that are the coefficients of the plane equation of plane in eye coordinates.

Remarks

The glGetClipPlane function returns in equation the four coefficients of the plane equation for plane.

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

If an error is generated, no change is made to the contents of equation.

Error Codes

The following are the error codes generated and their conditions.

Error Code Condition
GL_INVALID_ENUM plane was not an accepted value.
GL_INVALID_OPERATION glGetClipPlane was called between a call to glBegin and the corresponding call to glEnd.

QuickInfo

  Windows NT: Use version 3.5 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in gl.h.
  Import Library: Link with opengl32.lib.

See Also

glBegin, glClipPlane, glEnd