'\"! tbl|eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.1.0
.ds Dp Mar 17 18:04
.ds Dm  Mar  6 20:0
.ds Xs 3615 4 cullface.gl
.TH GLCULLFACE
.SH NAME
.B "glCullFace
\- specify whether front- or back-facing facets can be culled

.SH C SPECIFICATION
void \f3glCullFace\fP(
GLenum \fImode\fP )
.nf
.fi

.SH PARAMETERS
.TP \w'\f2mode\fP\ \ 'u 
\f2mode\fP
Specifies whether front- or back-facing facets are candidates for culling.
Symbolic constants
\f3GL_FRONT\fP, \f3GL_BACK\fP, and \f3GL_FRONT_AND_BACK\fP are accepted.
The initial value is \f3GL_BACK\fP.
.SH DESCRIPTION
\f3glCullFace\fP specifies whether front- or back-facing facets are culled
(as specified by \f2mode\fP) when facet culling is enabled. Facet
culling is initially disabled.
To enable and disable facet culling, call the
\f3glEnable\fP and \f3glDisable\fP commands
with the argument \f3GL_CULL_FACE\fP.
Facets include triangles,
quadrilaterals,
polygons,
and rectangles.
.P
\f3glFrontFace\fP specifies which of the clockwise and counterclockwise facets
are front-facing and back-facing.
See \f3glFrontFace\fP.
.SH NOTES
If  \f2mode\fP is \f3GL_FRONT_AND_BACK\fP, no facets are drawn, but other
primitives such as points and lines are drawn.
.SH ERRORS
\f3GL_INVALID_ENUM\fP is generated if \f2mode\fP is not an accepted value.
.P
\f3GL_INVALID_OPERATION\fP is generated if \f3glCullFace\fP
is executed between the execution of \f3glBegin\fP
and the corresponding execution of \f3glEnd\fP.
.SH ASSOCIATED GETS
\f3glIsEnabled\fP with argument \f3GL_CULL_FACE\fP
.br
\f3glGet\fP with argument \f3GL_CULL_FACE_MODE\fP
.SH SEE ALSO
\f3glEnable\fP,
\f3glFrontFace\fP