GLISENABLED

Section: Misc. Reference Manual Pages (3G)
Index Return to Main Contents
 

NAME

glIsEnabled - test whether a capability is enabled

 

C SPECIFICATION

GLboolean glIsEnabled( GLenum cap ) 




 

PARAMETERS





cap

Specifies a symbolic constant indicating a GL capability.


 

DESCRIPTION


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:








ConstantSee




GL_ALPHA_TESTglAlphaFunc


GL_AUTO_NORMALglEvalCoord


GL_BLENDglBlendFunc, glLogicOp


GL_CLIP_PLANEiglClipPlane


GL_COLOR_ARRAYglColorPointer


GL_COLOR_LOGIC_OPglLogicOp


GL_COLOR_MATERIALglColorMaterial


GL_COLOR_TABLEglColorTable


GL_CONVOLUTION_1DglConvolutionFilter1D


GL_CONVOLUTION_2DglConvolutionFilter2D


GL_CULL_FACEglCullFace


GL_DEPTH_TESTglDepthFunc, glDepthRange


GL_DITHERglEnable


GL_EDGE_FLAG_ARRAYglEdgeFlagPointer


GL_FOGglFog


GL_HISTOGRAMglHistogram


GL_INDEX_ARRAYglIndexPointer


GL_INDEX_LOGIC_OPglLogicOp


GL_LIGHTiglLightModel, glLight


GL_LIGHTINGglMaterial, glLightModel, glLight


GL_LINE_SMOOTHglLineWidth


GL_LINE_STIPPLEglLineStipple


GL_MAP1_COLOR_4glMap1


GL_MAP1_INDEXglMap1


GL_MAP1_NORMALglMap1


GL_MAP1_TEXTURE_COORD_1glMap1


GL_MAP1_TEXTURE_COORD_2glMap1


GL_MAP1_TEXTURE_COORD_3glMap1


GL_MAP1_TEXTURE_COORD_4glMap1


GL_MAP2_COLOR_4glMap2


GL_MAP2_INDEXglMap2


GL_MAP2_NORMALglMap2


GL_MAP2_TEXTURE_COORD_1glMap2


GL_MAP2_TEXTURE_COORD_2glMap2


GL_MAP2_TEXTURE_COORD_3glMap2


GL_MAP2_TEXTURE_COORD_4glMap2


GL_MAP2_VERTEX_3glMap2


GL_MAP2_VERTEX_4glMap2


GL_MINMAXglMinmax


GL_NORMAL_ARRAYglNormalPointer


GL_NORMALIZEglNormal


GL_POINT_SMOOTHglPointSize


GL_POLYGON_SMOOTHglPolygonMode


GL_POLYGON_OFFSET_FILL glPolygonOffset


GL_POLYGON_OFFSET_LINE glPolygonOffset


GL_POLYGON_OFFSET_POINT glPolygonOffset


GL_POLYGON_STIPPLEglPolygonStipple


GL_POST_COLOR_MATRIX_COLOR_TABLEglColorTable


GL_POST_CONVOLUTION_COLOR_TABLEglColorTable


GL_RESCALE_NORMALglNormal


GL_SCISSOR_TESTglScissor


GL_SEPARABLE_2DglSeparableFilter2D


GL_STENCIL_TESTglStencilFunc, glStencilOp


GL_TEXTURE_1DglTexImage1D


GL_TEXTURE_2DglTexImage2D


GL_TEXTURE_3DglTexImage3D


GL_TEXTURE_COORD_ARRAYglTexCoordPointer


GL_TEXTURE_GEN_QglTexGen


GL_TEXTURE_GEN_RglTexGen


GL_TEXTURE_GEN_SglTexGen


GL_TEXTURE_GEN_TglTexGen


GL_VERTEX_ARRAYglVertexPointer








 

NOTES


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_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 GL_ARB_imaging is
returned when glGet is called with GL_EXTENSIONS.

When the GL_ARB_multitexture extension is supported, the following
parameters return the associated value for the active texture unit.
GL_TEXTURE_1D, GL_TEXTURE_BINDING_1D,
GL_TEXTURE_2D, GL_TEXTURE_BINDING_2D,
GL_TEXTURE_3D, GL_TEXTURE_BINDING_3D,
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.
 

ERRORS


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.
 

SEE ALSO


glEnable(3G),
glEnableClientState(3G),
glGet(3G)