cullface.3gl   [plain text]


'\" te
'\"! tbl|eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 01 cullface.
.ds Xs 63441 4 cullface.gl
.TH GLCULLFACE 3G
.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(3G)\fP,
\%\f3glFrontFace(3G)\fP