GLAPI/glCullFace

From OpenGL.org
Jump to: navigation, search
glCullFace
Core in version 4.4
Core since version 1.0

glCullFace: specify whether front- or back-facing facets can be culled

Function Definition

 void glCullFace(GLenum mode​);
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

glCullFace specifies whether front- or back-facing facets are culled (as specified by mode) 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

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

Errors

GL_INVALID_ENUM​ is generated if mode​ is not an accepted value.

Associated Gets

glIsEnabled with argument GL_CULL_FACE​

glGet with argument GL_CULL_FACE_MODE​

See Also

glEnable(GL_CULL_FACE), glFrontFace

Copyright

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