1991-2006
Silicon Graphics, Inc.
glEnableClientState
3G
glEnableClientState
enable or disable client-side capability
C Specification
void glEnableClientState
GLenum cap
Parameters
cap
Specifies the capability to enable.
Symbolic constants
GL_COLOR_ARRAY,
GL_EDGE_FLAG_ARRAY,
GL_FOG_COORD_ARRAY,
GL_INDEX_ARRAY,
GL_NORMAL_ARRAY,
GL_SECONDARY_COLOR_ARRAY,
GL_TEXTURE_COORD_ARRAY, and
GL_VERTEX_ARRAY
are accepted.
C Specification
void glDisableClientState
GLenum cap
Parameters
cap
Specifies the capability to disable.
Description
glEnableClientState and glDisableClientState
enable or disable individual client-side capabilities. By default, all
client-side capabilities are disabled.
Both
glEnableClientState and glDisableClientState take a
single argument, cap, which can assume one of the following
values:
GL_COLOR_ARRAY
If enabled, the color array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glColorPointer.
GL_EDGE_FLAG_ARRAY
If enabled, the edge flag array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glEdgeFlagPointer.
GL_FOG_COORD_ARRAY
If enabled, the fog coordinate array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glFogCoordPointer.
GL_INDEX_ARRAY
If enabled, the index array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glIndexPointer.
GL_NORMAL_ARRAY
If enabled, the normal array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glNormalPointer.
GL_SECONDARY_COLOR_ARRAY
If enabled, the secondary color array is enabled for writing and used
during rendering when glArrayElement, glDrawArrays,
glDrawElements, glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glColorPointer.
GL_TEXTURE_COORD_ARRAY
If enabled, the texture coordinate array is enabled for writing and used
during rendering when glArrayElement, glDrawArrays,
glDrawElements, glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glTexCoordPointer.
GL_VERTEX_ARRAY
If enabled, the vertex array is enabled for writing and used during
rendering when glArrayElement, glDrawArrays, glDrawElements,
glDrawRangeElements glMultiDrawArrays, or
glMultiDrawElements is called. See glVertexPointer.
Notes
glEnableClientState is available only if the GL version is 1.1 or greater.
GL_FOG_COORD_ARRAY and GL_SECONDARY_COLOR_ARRAY are available only if the GL version is 1.4 or
greater.
For OpenGL versions 1.3 and greater, or when ARB_multitexture
is supported, enabling and disabling
GL_TEXTURE_COORD_ARRAY affects the active client texture unit.
The active client texture unit is controlled with
glClientActiveTexture.
Errors
GL_INVALID_ENUM is generated if cap is not an accepted value.
glEnableClientState is not allowed between the execution of glBegin and the
corresponding glEnd, but an error may or may not be generated. If
no error is generated, the behavior is undefined.
See Also
glArrayElement,
glClientActiveTexture,
glColorPointer,
glDrawArrays,
glDrawElements,
glEdgeFlagPointer,
glFogCoordPointer,
glEnable,
glGetPointerv,
glIndexPointer,
glInterleavedArrays,
glNormalPointer,
glSecondaryColorPointer,
glTexCoordPointer,
glVertexPointer
Copyright
Copyright 1991-2006
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/.