GLENABLE(3G) GLENABLE(3G)
NAME
glEnable,, glDisable - enable or disable server-side GL capabilities
C SPECIFICATION
void glEnable( GLenum cap )
PARAMETERS
cap Specifies a symbolic constant indicating a GL capability.
C SPECIFICATION
void glDisable( GLenum cap )
PARAMETERS
cap Specifies a symbolic constant indicating a GL capability.
DESCRIPTION
glEnable and glDisable enable and disable various capabilities. Use
glIsEnabled or glGet to determine the current setting of any capabil-
ity. The initial value for each capability with the exception of
GLDITHER is GLFALSE. The initial value for GLDITHER is GLTRUE.
Both glEnable and glDisable take a single argument, cap, which can
assume one of the following values:
GLALPHATEST If enabled, do alpha testing. See glAlphaFunc.
GLAUTONORMAL If enabled, generate normal vectors when
either GLMAP2VERTEX3 or GLMAP2VERTEX4 is
used to generate vertices. See glap2.
GLBLEND If enabled, blend the incoming RGBA color val-
ues with the values in the color buffers. See
glBlendFunc.
GLCLIPLANEi If enabled, clip geometry against user-defined
clipping plane i. See glClipPlane.
GLCOLORLOGICOP If enabled, apply the currently selected logi-
cal operation to the incoming RGBA color and
color buffer values. See glLogicOp.
GLCOLORMATERIAL If enabled, have one or more material parame-
ters track the current color. See
glColoraterial.
GLCOLORTABLE If enabled, preform a color table lookup on
the incoming RGBA color values. See
glColorTable.
GLCONVOLUTION1D If enabled, perform a 1D convolution operation
on incoming RGBA color values. See
glConvolutionFilter1D.
GLCONVOLUTION2D If enabled, perform a 2D convolution operation
on incoming RGBA color values. See
glConvolutionFilter2D.
GLCULFACE If enabled, cull polygons based on their wind-
ing in window coordinates. See glCullFace.
GLDEPTHTEST If enabled, do depth comparisons and update
the depth buffer. Note that even if the depth
buffer exists and the depth mask is non-zero,
the depth buffer is not updated if the depth
test is disabled. See glDepthFunc and
glDepthRange.
GLDITHER If enabled, dither color components or indices
before they are written to the color buffer.
GLFOG If enabled, blend a fog color into the post-
texturing color. See glFog.
GLHISTOGRAM If enabled, histogram incoming RGBA color val-
ues. See glHistogram.
GLINDEXLOGICOP If enabled, apply the currently selected logi-
cal operation to the incoming index and color
buffer indices. See
glLogicOp.
GLIGHTi If enabled, include light i in the evaluation
of the lighting equation. See glLightodel and
glLight.
GLIGHTING If enabled, use the current lighting parame-
ters to compute the vertex color or index.
Otherwise, simply associate the current color
or index with each vertex. See
glaterial, glLightodel, and glLight.
GLINESMOTH If enabled, draw lines with correct filtering.
Otherwise, draw aliased lines. See
glLineWidth.
GLINESTIPLE If enabled, use the current line stipple pat-
tern when drawing lines. See glLineStipple.
GLMAP1COLOR4 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate RGBA
values. See glap1.
GLMAP1INDEX If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate color
indices. See glap1.
GLMAP1NORMAL If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate nor-
mals. See glap1.
GLMAP1TEXTURECORD1 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate s tex-
ture coordinates. See glap1.
GLMAP1TEXTURECORD2 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate s and t
texture coordinates. See glap1.
GLMAP1TEXTURECORD3 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate s, t,
and r texture coordinates. See glap1.
GLMAP1TEXTURECORD4 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate s, t,
r, and q texture coordinates. See glap1.
GLMAP1VERTEX3 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate x, y,
and z vertex coordinates. See glap1.
GLMAP1VERTEX4 If enabled, calls to glEvalCoord1,
glEvalesh1, and glEvalPoint1 generate homoge-
neous x, y, z, and w vertex coordinates. See
glap1.
GLMAP2COLOR4 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate RGBA
values. See glap2.
GLMAP2INDEX If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate color
indices. See glap2.
GLMAP2NORMAL If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate nor-
mals. See glap2.
GLMAP2TEXTURECORD1 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate s tex-
ture coordinates. See glap2.
GLMAP2TEXTURECORD2 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate s and t
texture coordinates. See glap2.
GLMAP2TEXTURECORD3 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate s, t,
and r texture coordinates. See glap2.
GLMAP2TEXTURECORD4 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate s, t,
r, and q texture coordinates. See glap2.
GLMAP2VERTEX3 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate x, y,
and z vertex coordinates. See glap2.
GLMAP2VERTEX4 If enabled, calls to glEvalCoord2,
glEvalesh2, and glEvalPoint2 generate homoge-
neous x, y, z, and w vertex coordinates. See
glap2.
GLMINMAX If enabled, compute the minimum and maximum
values of incoming RGBA color values. See
glinmax.
GLNORMALIZE If enabled, normal vectors specified with
glNormal are scaled to unit length after
transformation. See glNormal.
GLPOINTSMOTH If enabled, draw points with proper filtering.
Otherwise, draw aliased points. See
glPointSize.
GLPOLYGONOFSETFIL If enabled, and if the polygon is rendered in
GLFIL mode, an offset is added to depth val-
ues of a polygon's fragments before the depth
comparison is performed. See glPolygonOffset.
GLPOLYGONOFSETLINE If enabled, and if the polygon is rendered in
GLINE mode, an offset is added to depth val-
ues of a polygon's fragments before the depth
comparison is performed. See glPolygonOffset.
GLPOLYGONOFSETPOINT If enabled, an offset is added to depth values
of a polygon's fragments before the depth com-
parison is performed, if the polygon is ren-
dered in GLPOINT mode. See glPolygonOffset.
GLPOLYGONSMOTH If enabled, draw polygons with proper filter-
ing. Otherwise, draw aliased polygons. For
correct anti-aliased polygons, an alpha buffer
is needed and the polygons must be sorted
front to back.
GLPOLYGONSTIPLE If enabled, use the current polygon stipple
pattern when rendering polygons. See
glPolygonStipple.
GLPOSTCOLORMATRIXCOLORTABLE
If enabled, preform a color table lookup on
RGBA color values after color matrix transfor-
mation. See glColorTable.
GLPOSTCONVOLUTIONCOLORTABLE
If enabled, preform a color table lookup on
RGBA color values after convolution. See
glColorTable.
GLRESCALENORMAL If enabled, normal vectors specified with
glNormal are scaled to unit length after
transformation. See glNormal.
GLSEPARABLE2D If enabled, perform a two-dimensional convolu-
tion operation using a separable convolution
filter on incoming RGBA color values. See
glSeparableFilter2D.
GLSCISORTEST If enabled, discard fragments that are outside
the scissor rectangle. See glScissor.
GLSTENCILTEST If enabled, do stencil testing and update the
stencil buffer. See glStencilFunc and
glStencilOp.
GLTEXTURE1D If enabled, one-dimensional texturing is per-
formed (unless two- or three-dimensional tex-
turing is also enabled). See glTexImage1D.
GLTEXTURE2D If enabled, two-dimensional texturing is per-
formed (unless three-dimensional texturing is
also enabled). See glTexImage2D.
GLTEXTURE3D If enabled, three-dimensional texturing is
performed. See glTexImage3D.
GLTEXTUREGENQ If enabled, the q texture coordinate is com-
puted using the texture generation function
defined with glTexGen. Otherwise, the current
q texture coordinate is used. See glTexGen.
GLTEXTUREGENR If enabled, the r texture coordinate is com-
puted using the texture generation function
defined with glTexGen. Otherwise, the current
r texture coordinate is used. See glTexGen.
GLTEXTUREGENS If enabled, the s texture coordinate is com-
puted using the texture generation function
defined with glTexGen. Otherwise, the current
s texture coordinate is used. See glTexGen.
GLTEXTUREGENT If enabled, the t texture coordinate is com-
puted using the texture generation function
defined with glTexGen. Otherwise, the current
t texture coordinate is used. See glTexGen.
NOTES
GLPOLYGONOFSETFIL, GLPOLYGONOFSETLINE,
GLPOLYGONOFSETPOINT, GLCOLORLOGICOP, and GLINDEXLOGICOP are
available only if the GL version is 1.1 or greater.
GLRESCALENORMAL, and GLTEXTURE3D are available only if the GL ver-
sion is 1.2 or greater.
GLCOLORTABLE, GLCONVOLUTION1D, GLCONVOLUTION2D, GLHISTOGRAM,
GLMINMAX, GLPOSTCOLORMATRIXCOLORTABLE,
GLPOSTCONVOLUTIONCOLORTABLE, and GLSEPARABLE2D are available only
if GLARBimaging is returned from glGet with an argument of
GLEXTENSIONS.
If GLARBmultitexture is supported, GLTEXTURE1D, GLTEXTURE2D,
GLTEXTURE3D, GLTEXTUREGENS, GLTEXTUREGENT, GLTEXTUREGENR,
and GLTEXTUREGENQ enable or disable the respective state for the
active texture unit specified with glActiveTextureARB.
ERORS
GLINVALIDENUM is generated if cap is not one of the values listed
previously.
GLINVALIDOPERATION is generated if glEnable or glDisable is executed
between the execution of glBegin and the corresponding execution of
glEnd.
SEE ALSO
glActiveTextureARB, glAlphaFunc, glBlendFunc, glClipPlane,
glColoraterial, glCullFace, glDepthFunc, glDepthRange,
glEnableClientState, glFog, glGet, glIsEnabled, glLight, glLightodel,
glLineWidth, glLineStipple, glLogicOp, glap1, glap2, glaterial,
glNormal, glPointSize, glPolygonode, glPolygonOffset,
glPolygonStipple, glScissor, glStencilFunc, glStencilOp, glTexGen,
glTexImage1D, glTexImage2D, glTexImage3D
GLENABLE(3G)
|
