GLENABLECLIENTSTATEMachTen Programmer’s ManuGLENABLECLIENTSTATE()

NAME
glEnableClientState, glDisableClientState - enable or dis-
able client-side capability

C SPECIFICATION
void glEnableClientState( GLenum cap )

delim $$

PARAMETERS
cap Specifies the capability to enable. Symbolic con-
stants GL_COLOR_ARRAY, GL_EDGE_FLAG_ARRAY,
GL_INDEX_ARRAY, GL_NORMAL_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 glEnable-
ClientState and glDisableClientState take a single argu-
ment, cap, which can assume one of the following values:

GL_COLOR_ARRAY If enabled, the color array is
enabled for writing and used dur-
ing rendering when glDrawArrays
or glDrawElement is called. See
glColorPointer.

GL_EDGE_FLAG_ARRAY If enabled, the edge flag array
is enabled for writing and used
during rendering when glDrawAr-
rays or glDrawElements is called.
See glEdgeFlagPointer.

GL_INDEX_ARRAY If enabled, the index array is
enabled for writing and used dur-
ing rendering when glDrawArrays
or glDrawElements is called. See
glIndexPointer.

GL_NORMAL_ARRAY If enabled, the normal array is
enabled for writing and used dur-
ing rendering when glDrawArrays
or glDrawElements is called. See
glNormalPointer.

GL_TEXTURE_COORD_ARRAY If enabled, the texture coordi-
nate array is enabled for writing
and used for rendering when
glDrawArrays or glDrawElements is
called. See glTexCoordPointer.

GL_VERTEX_ARRAY If enabled, the vertex array is
enabled for writing and used dur-
ing rendering when glDrawArrays
or glDrawElements is called. See
glVertexPointer.

NOTES
glEnableClientState is available only if the GL version is
1.1 or greater.

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, glColorPointer, glDrawArrays, glDrawEle-
ments, glEdgeFlagPointer, glEnable, glGetPointerv, glInd-
exPointer, glInterleavedArrays, glNormalPointer, glTexCo-
ordPointer, glVertexPointer

MachTen 2