glIsEnabled — test whether a capability is enabled
GLboolean glIsEnabled( | GLenum | cap); |
glIsEnabled returns GL_TRUE if cap is an enabled capability
and returns GL_FALSE otherwise.
Initially all capabilities except GL_DITHER are disabled;
GL_DITHER is initially enabled.
The following capabilities are accepted for cap:
| Constant | See |
|---|---|
GL_ALPHA_TEST
| glAlphaFunc |
GL_AUTO_NORMAL
| glEvalCoord |
GL_BLEND
| glBlendFunc, glLogicOp |
GL_CLIP_PLANEi
| glClipPlane |
GL_COLOR_ARRAY
| glColorPointer |
GL_COLOR_LOGIC_OP
| glLogicOp |
GL_COLOR_MATERIAL
| glColorMaterial |
GL_COLOR_SUM
| glSecondaryColor |
GL_COLOR_TABLE
| glColorTable |
GL_CONVOLUTION_1D
| glConvolutionFilter1D |
GL_CONVOLUTION_2D
| glConvolutionFilter2D |
GL_CULL_FACE
| glCullFace |
GL_DEPTH_TEST
| glDepthFunc, glDepthRange |
GL_DITHER
| glEnable |
GL_EDGE_FLAG_ARRAY
| glEdgeFlagPointer |
GL_FOG
| glFog |
GL_FOG_COORD_ARRAY
| glFogCoordPointer |
GL_HISTOGRAM
| glHistogram |
GL_INDEX_ARRAY
| glIndexPointer |
GL_INDEX_LOGIC_OP
| glLogicOp |
GL_LIGHTi
| glLightModel, glLight |
GL_LIGHTING
| glMaterial, glLightModel, glLight |
GL_LINE_SMOOTH
| glLineWidth |
GL_LINE_STIPPLE
| glLineStipple |
GL_MAP1_COLOR_4
| glMap1 |
GL_MAP1_INDEX
| glMap1 |
GL_MAP1_NORMAL
| glMap1 |
GL_MAP1_TEXTURE_COORD_1
| glMap1 |
GL_MAP1_TEXTURE_COORD_2
| glMap1 |
GL_MAP1_TEXTURE_COORD_3
| glMap1 |
GL_MAP1_TEXTURE_COORD_4
| glMap1 |
GL_MAP2_COLOR_4
| glMap2 |
GL_MAP2_INDEX
| glMap2 |
GL_MAP2_NORMAL
| glMap2 |
GL_MAP2_TEXTURE_COORD_1
| glMap2 |
GL_MAP2_TEXTURE_COORD_2
| glMap2 |
GL_MAP2_TEXTURE_COORD_3
| glMap2 |
GL_MAP2_TEXTURE_COORD_4
| glMap2 |
GL_MAP2_VERTEX_3
| glMap2 |
GL_MAP2_VERTEX_4
| glMap2 |
GL_MINMAX
| glMinmax |
GL_MULTISAMPLE
| glSampleCoverage |
GL_NORMAL_ARRAY
| glNormalPointer |
GL_NORMALIZE
| glNormal |
GL_POINT_SMOOTH
| glPointSize |
GL_POINT_SPRITE
| glEnable |
GL_POLYGON_SMOOTH
| glPolygonMode |
GL_POLYGON_OFFSET_FILL
| glPolygonOffset |
GL_POLYGON_OFFSET_LINE
| glPolygonOffset |
GL_POLYGON_OFFSET_POINT
| glPolygonOffset |
GL_POLYGON_STIPPLE
| glPolygonStipple |
GL_POST_COLOR_MATRIX_COLOR_TABLE
| glColorTable |
GL_POST_CONVOLUTION_COLOR_TABLE
| glColorTable |
GL_RESCALE_NORMAL
| glNormal |
GL_SAMPLE_ALPHA_TO_COVERAGE
| glSampleCoverage |
GL_SAMPLE_ALPHA_TO_ONE
| glSampleCoverage |
GL_SAMPLE_COVERAGE
| glSampleCoverage |
GL_SCISSOR_TEST
| glScissor |
GL_SECONDARY_COLOR_ARRAY
| glSecondaryColorPointer |
GL_SEPARABLE_2D
| glSeparableFilter2D |
GL_STENCIL_TEST
| glStencilFunc, glStencilOp |
GL_TEXTURE_1D
| glTexImage1D |
GL_TEXTURE_2D
| glTexImage2D |
GL_TEXTURE_3D
| glTexImage3D |
GL_TEXTURE_COORD_ARRAY
| glTexCoordPointer |
GL_TEXTURE_CUBE_MAP
| glTexImage2D |
GL_TEXTURE_GEN_Q
| glTexGen |
GL_TEXTURE_GEN_R
| glTexGen |
GL_TEXTURE_GEN_S
| glTexGen |
GL_TEXTURE_GEN_T
| glTexGen |
GL_VERTEX_ARRAY
| glVertexPointer |
GL_VERTEX_PROGRAM_POINT_SIZE
| glEnable |
GL_VERTEX_PROGRAM_TWO_SIDE
| glEnable |
If an error is generated,
glIsEnabled returns 0.
GL_COLOR_LOGIC_OP,
GL_COLOR_ARRAY,
GL_EDGE_FLAG_ARRAY,
GL_INDEX_ARRAY,
GL_INDEX_LOGIC_OP,
GL_NORMAL_ARRAY,
GL_POLYGON_OFFSET_FILL,
GL_POLYGON_OFFSET_LINE,
GL_POLYGON_OFFSET_POINT,
GL_TEXTURE_COORD_ARRAY, and
GL_VERTEX_ARRAY
are available only
if the GL version is 1.1 or greater.
GL_RESCALE_NORMAL, and GL_TEXTURE_3D are available only if the GL
version is 1.2 or greater.
GL_MULTISAMPLE,
GL_SAMPLE_ALPHA_TO_COVERAGE,
GL_SAMPLE_ALPHA_TO_ONE,
GL_SAMPLE_COVERAGE,
GL_TEXTURE_CUBE_MAP
are available only if the GL version is 1.3 or greater.
GL_FOG_COORD_ARRAY and GL_SECONDARY_COLOR_ARRAY
are available only if the GL version is 1.4 or greater.
GL_POINT_SPRITE,
GL_VERTEX_PROGRAM_POINT_SIZE, and
GL_VERTEX_PROGRAM_TWO_SIDE
are available only if the GL version is 2.0 or greater.
GL_COLOR_TABLE, GL_CONVOLUTION_1D, GL_CONVOLUTION_2D,
GL_HISTOGRAM, GL_MINMAX,
GL_POST_COLOR_MATRIX_COLOR_TABLE,
GL_POST_CONVOLUTION_COLOR_TABLE, and
GL_SEPARABLE_2D are available only if ARB_imaging is
returned when glGet is called with GL_EXTENSIONS.
For OpenGL versions 1.3 and greater, or when the ARB_multitexture extension is supported, the following
parameters return the associated value for the active texture unit:
GL_TEXTURE_1D,
GL_TEXTURE_2D,
GL_TEXTURE_3D,
GL_TEXTURE_CUBE_MAP,
GL_TEXTURE_GEN_S,
GL_TEXTURE_GEN_T,
GL_TEXTURE_GEN_R,
GL_TEXTURE_GEN_Q,
GL_TEXTURE_MATRIX, and
GL_TEXTURE_STACK_DEPTH.
Likewise, the following parameters return the associated value for the
active client texture unit:
GL_TEXTURE_COORD_ARRAY,
GL_TEXTURE_COORD_ARRAY_SIZE,
GL_TEXTURE_COORD_ARRAY_STRIDE,
GL_TEXTURE_COORD_ARRAY_TYPE.
GL_INVALID_ENUM is generated if cap is not an accepted value.
GL_INVALID_OPERATION is generated if glIsEnabled
is executed between the execution of glBegin
and the corresponding execution of glEnd.
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/.