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_ARRAY See glColorPointer
GL_COLOR_LOGIC_OP See glLogicOp
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_INDEX_ARRAY See glIndexPointer
GL_INDEX_LOGIC_OP See glLogicOp
GL_LIGHTi See glLightModel and glLight
GL_LIGHTING See glMaterial, glLightModel, and glLight
GL_LINE_SMOOTH See glLineWidth
GL_LINE_STIPPLE See glLineStipple
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_NORMAL_ARRAY See glNormalPointer
GL_NORMALIZE See glNormal
GL_POINT_SMOOTH See glPointSize
GL_POLYGON_OFFSET_FILL See glPolygonOffset
GL_POLYGON_OFFSET_LINE See glPolygonOffset
GL_POLYGON_OFFSET_POINT See glPolygonOffset
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_COORD_ARRAY See glTexCoordPointer.
GL_TEXTURE_GEN_Q See glTexGen
GL_TEXTURE_GEN_R See glTexGen
GL_TEXTURE_GEN_S See glTexGen
GL_TEXTURE_GEN_T See glTexGen
GL_VERTEX_ARRAY See glVertexPointer

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.

Requirements

  Windows NT/2000: Requires Windows NT 3.5 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Gl.h.
  Library: Use Opengl32.lib.

See Also

glBegin, glEnable, glEnd


  

Community Additions

Show: