glIsEnabled

The gllsEnabled function tests whether a capability is enabled.

GLboolean glIsEnabled(
  GLenum cap   
);
 

Parameters

cap
A symbolic constant indicating an OpenGL capability. The following capabilities are accepted:
GL_ALPHA_TEST See glAlphaFunc
GL_AUTO_NORMAL See glEvalCoord
GL_BLEND See glBlendFunc
GL_CLIP_PLANEi See glClipPlane
GL_COLOR_MATERIAL See glColorMaterial
GL_CULL_FACE See glCullFace
GL_DEPTH_TEST See glDepthFunc and glDepthRange
GL_DITHER See glEnable
GL_FOG See glFog
GL_LIGHTi See glLightModel and glLight
GL_LIGHTING See glMaterial, glLightModel, and glLight
GL_LINE_SMOOTH See glLineWidth
GL_LINE_STIPPLE See glLineStipple
GL_LOGIC_OP See glLogicOp
GL_MAP1_COLOR_4 See glMap1
GL_MAP1_INDEX See glMap1
GL_MAP1_NORMAL See glMap1
GL_MAP1_TEXTURE_COORD_1 See glMap1
GL_MAP1_TEXTURE_COORD_2 See glMap1
GL_MAP1_TEXTURE_COORD_3 See glMap1
GL_MAP1_TEXTURE_COORD_4 See glMap1
GL_MAP1_VERTEX_3 See glMap1
GL_MAP1_VERTEX_4 See glMap1
GL_MAP2_COLOR_4 See glMap2
GL_MAP2_INDEX See glMap2
GL_MAP2_NORMAL See glMap2
GL_MAP2_TEXTURE_COORD_1 See glMap2
GL_MAP2_TEXTURE_COORD_2 See glMap2
GL_MAP2_TEXTURE_COORD_3 See glMap2
GL_MAP2_TEXTURE_COORD_4 See glMap2
GL_MAP2_VERTEX_3 See glMap2
GL_MAP2_VERTEX_4 See glMap2
GL_NORMALIZE See glNormal
GL_POINT_SMOOTH See glPointSize
GL_POLYGON_SMOOTH See glPolygonMode
GL_POLYGON_STIPPLE See glPolygonStipple
GL_SCISSOR_TEST See glScissor
GL_STENCIL_TEST See glStencilFunc and glStencilOp
GL_TEXTURE_1D See glTexImage1D
GL_TEXTURE_2D See glTexImage2D
GL_TEXTURE_GEN_Q See glTexGen
GL_TEXTURE_GEN_R See glTexGen
GL_TEXTURE_GEN_S See glTexGen
GL_TEXTURE_GEN_T See glTexGen

Remarks

The gllsEnabled function returns GL_TRUE if cap is an enabled capability and returns GL_FALSE otherwise.

Error Codes

If an error is generated, glIsEnabled returns zero.

The following are the error codes generated and their conditions.

Error Code Condition
GL_INVALID_ENUM cap was not an accepted value.
GL_INVALID_OPERATION glIsEnabled was called between a call to glBegin and the corresponding call to glEnd.

QuickInfo

  Windows NT: Use version 3.5 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in gl.h.
  Import Library: Link with opengl32.lib.

See Also

glBegin, glEnable, glEnd