glCullFace

From OpenGL Reference
Jump to navigation Jump to search

Specify whether front- or back-facing facets can be culled.

C Specification[edit]

void glCullFace( GLenum mode );


Parameters[edit]

mode - Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants GL_FRONT , GL_BACK , and GL_FRONT_AND_BACK are accepted. The initial value is GL_BACK .


Description[edit]

 glCullFace specifies whether front- or back-facing facets are culled (as specified bymode) when facet culling is enabled. Facet culling is initially disabled. To enable and disable facet culling, call the glEnable and glDisable commands with the argument GL_CULL_FACE . Facets include triangles, quadrilaterals, polygons, and rectangles.

 glFrontFace specifies which of the clockwise and counterclockwise facets are front-facing and back-facing. See glFrontFace .


Notes[edit]

If mode is GL_FRONT_AND_BACK , no facets are drawn, but other primitives such as points and lines are drawn.


Errors[edit]

 GL_INVALID_ENUM is generated if mode is not an accepted value.


Associated Gets[edit]

 glIsEnabled with argument GL_CULL_FACE 

 glGet with argument GL_CULL_FACE_MODE 


Version Support[edit]

 glCullFace  2.0+

See Also[edit]

 glEnable , glFrontFace 


Copyright[edit]

Copyright© 1991-2006 Silicon Graphics, Inc. Copyright© 2010-2014 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.