59 lines
1.7 KiB
Plaintext
59 lines
1.7 KiB
Plaintext
'\" 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
|