glIsEnabled

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:

Constant See
GL_ALPHA_TESTglAlphaFunc
GL_AUTO_NORMALglEvalCoord
GL_BLENDglBlendFunc, glLogicOp
GL_CLIP_PLANEiglClipPlane
GL_COLOR_ARRAYglColorPointer
GL_COLOR_LOGIC_OPglLogicOp
GL_COLOR_MATERIALglColorMaterial
GL_COLOR_TABLE_EXTglColorTableEXT
GL_CONVOLUTION_1D_EXTglConvolutionFilter1DEXT
GL_CONVOLUTION_2D_EXTglConvolutionFilter2DEXT
GL_CULL_FACEglCullFace
GL_DEPTH_TESTglDepthFunc, glDepthRange
GL_DITHERglEnable
GL_EDGE_FLAG_ARRAYglEdgeFlagPointer
GL_FOGglFog
GL_FOG_OFFSET_EXTglFog
GL_INDEX_ARRAYglIndexPointer
GL_INDEX_LOGIC_OPglLogicOp
GL_INTERLACE_EXTglDrawPixels
GL_INTERLACE_READ_I3DglReadPixels
GL_LIGHTiglLightModel, glLight
GL_LIGHTINGglMaterial, glLightModel, glLight
GL_LINE_SMOOTHglLineWidth
GL_LINE_STIPPLEglLineStipple
GL_MAP1_COLOR_4glMap1, glMap2
GL_MAP2_TEXTURE_COORD_2glMap2
GL_MAP2_TEXTURE_COORD_3glMap2
GL_MAP2_TEXTURE_COORD_4glMap2
GL_MAP2_VERTEX_3glMap2
GL_MAP2_VERTEX_4glMap2
GL_MULTISAMPLE_EXTglEnable
GL_NORMAL_ARRAYglNormalPointer
GL_NORMALIZEglNormal
GL_OCCLUSION_TEST_EXTglEnable
GL_PIXEL_TEX_GEN_EXTglPixelTexGenEXT
GL_POINT_SMOOTHglPointSize
GL_POST_COLOR_MATRIX_COLOR_TABLE_EXTglColorTableEXT
GL_POST_CONVOLUTION_COLOR_TABLE_EXTglColorTableEXT
GL_POLYGON_SMOOTHglPolygonMode
GL_POLYGON_OFFSET_FILLglPolygonOffset
GL_POLYGON_OFFSET_LINEglPolygonOffset
GL_POLYGON_OFFSET_POINTglPolygonOffset
GL_POLYGON_STIPPLEglPolygonStipple
GL_RESCALE_NORMAL_EXTglEnable
GL_SAMPLE_ALPHA_TO_MASK_EXTglEnable
GL_SAMPLE_ALPHA_TO_ONE_EXTglEnable
GL_SAMPLE_MASK_EXTglEnable, glSampleMaskEXT
GL_SCISSOR_TESTglScissor
GL_SEPARABLE_2D_EXTglSeparableFilter2DEXT
GL_STENCIL_TESTglStencilFunc, glStencilOp
GL_TEXTURE_1DglTexImage1D
GL_TEXTURE_2DglTexImage2D
GL_TEXTURE_3D_EXTglTexImage3DEXT
GL_TEXTURE_COLOR_TABLE_EXTglColorTableEXT
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 a value of 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 only available if the GL version is 1.1 or greater.

EXTENSIONS

Some routines and constants for this function are part of an extension, not part of the core GL command set. The following extension names must be present in the string returned by glGetString when called with argument GL_EXTENSIONS to use these routines and constants.
GL_EXT_color_table
GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, and GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT are part of the EXT_color_table extension.

GL_EXT_convolution
GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, and GL_SEPARABLE_2D_EXT are part of the EXT_convolution extension.

GL_EXT_fog_offset
GL_FOG_OFFSET_EXT is part of the EXT_fog_offset extension.

EXT_interlace
GL_INTERLACE_EXT is part of the EXT_interlace extension.

EXT_interlace_read
GL_INTERLACE_READ_I3D is part of the EXT_interlace_read extension.

GL_EXT_multisample
GL_MULTISAMPLE_EXT, GL_SAMPLE_ALPHA_TO_MASK_EXT, GL_SAMPLE_ALPHA_TO_ONE_EXT, and GL_SAMPLES_EXT are part of the EXT_multisample extension.

GL_EXT_occlusion_test
GL_OCCLUSION_TEST_EXT is part of the EXT_occlusion_test extension.

GL_EXT_pixel_texture
GL_PIXEL_TEX_GEN_EXT is part of the EXT_pixel_texture extension.

GL_EXT_rescale_normal
GL_RESCALE_NORMAL_EXT is part of the EXT_rescale_normal extension.

GL_EXT_texture3D
GL_TEXTURE_3D_EXT, is part of the EXT_texture3D extension.

GL_EXT_texture_color_table
GL_TEXTURE_COLOR_TABLE_EXT is part of the EXT_texture_color_table extension.

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, glEnableClientState