GLISENABLED(3G)

📦 version 1.1, in centos-stream 9, fedora 43, fedora 44

✨ GLISENABLED ✨

okay bestie so this page lives in the 3G manual section (that's the OpenGL one, iykyk) 💅 and it's literally just one lil question: is this thing on?

🌸 NAME 🌸

glIsEnabled — test whether a capability is enabled

🎀 C SPECIFICATION 🎀

GLboolean glIsEnabled( GLenum cap )

🦋 PARAMETERS 🦋

  • cap — a symbolic constant that names one specific GL capability. that's it, that's the whole input 🫶

👑 DESCRIPTION 👑

glIsEnabled hits you back with GL_TRUE when cap is an enabled capability, and GL_FALSE when it isn't. periodt.

and here's the tea on the starting lineup: initially every single capability is disabled except GL_DITHER — GL_DITHER is the one that starts out enabled 💖

these are all the capabilities that are accepted for cap, with where to go read about them:

  • GL_ALPHA_TEST — see glAlphaFunc
  • GL_AUTO_NORMAL — see glEvalCoord
  • GL_BLEND — see glBlendFunc, glLogicOp
  • GL_CLIP_PLANEi — see glClipPlane
  • GL_COLOR_ARRAY — see glColorPointer
  • GL_COLOR_LOGIC_OP — see glLogicOp
  • GL_COLOR_MATERIAL — see glColorMaterial
  • GL_COLOR_TABLE — see glColorTable
  • GL_CONVOLUTION_1D — see glConvolutionFilter1D
  • GL_CONVOLUTION_2D — see glConvolutionFilter2D
  • GL_CULL_FACE — see glCullFace
  • GL_DEPTH_TEST — see glDepthFunc, glDepthRange
  • GL_DITHER — see glEnable
  • GL_EDGE_FLAG_ARRAY — see glEdgeFlagPointer
  • GL_FOG — see glFog
  • GL_HISTOGRAM — see glHistogram
  • GL_INDEX_ARRAY — see glIndexPointer
  • GL_INDEX_LOGIC_OP — see glLogicOp
  • GL_LIGHTi — see glLightModel, glLight
  • GL_LIGHTING — see glMaterial, glLightModel, 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_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_MINMAX — see glMinmax
  • GL_NORMAL_ARRAY — see glNormalPointer
  • GL_NORMALIZE — see glNormal
  • GL_POINT_SMOOTH — see glPointSize
  • GL_POLYGON_SMOOTH — see glPolygonMode
  • GL_POLYGON_OFFSET_FILL — see glPolygonOffset
  • GL_POLYGON_OFFSET_LINE — see glPolygonOffset
  • GL_POLYGON_OFFSET_POINT — see glPolygonOffset
  • GL_POLYGON_STIPPLE — see glPolygonStipple
  • GL_POST_COLOR_MATRIX_COLOR_TABLE — see glColorTable
  • GL_POST_CONVOLUTION_COLOR_TABLE — see glColorTable
  • GL_RESCALE_NORMAL — see glNormal
  • GL_SCISSOR_TEST — see glScissor
  • GL_SEPARABLE_2D — see glSeparableFilter2D
  • GL_STENCIL_TEST — see glStencilFunc, glStencilOp
  • GL_TEXTURE_1D — see glTexImage1D
  • GL_TEXTURE_2D — see glTexImage2D
  • GL_TEXTURE_3D — see glTexImage3D
  • 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

sixty-three constants, no skips, no shortcuts 💜

💀 NOTES 💀

if an error gets generated, glIsEnabled returns 0. that's your red flag bestie, don't ignore it 😭

these ones are only available if the GL version is 1.1 or greater:

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

and these two need GL version 1.2 or greater:

GL_RESCALE_NORMAL, and GL_TEXTURE_3D

meanwhile this whole squad is only available if GL_ARB_imaging shows up when glGet is called with GL_EXTENSIONS:

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

now listen. when the GL_ARB_multitexture extension is supported, these 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, these ones 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.

that's the whole multitexture situation, no cap 🧚

🔥 ERRORS 🔥

  • GL_INVALID_ENUM gets generated if cap is not an accepted value. like, you made that one up bestie, it's giving improv 🫠
  • GL_INVALID_OPERATION gets generated if glIsEnabled is executed between the execution of glBegin and the corresponding execution of glEnd. do not try to vibe-check a capability mid-draw, that's illegal in OpenGL court 💀

🌈 SEE ALSO 🌈

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

and that's the whole page, main character energy from top to bottom ✨ the footer line is just GLISENABLED(3G) all over again — same 3G manual section we started in — so consider yourself properly tagged and released, bestie. go check your caps, stay iconic 👑💖

📦 where this page comes from