Scroll to navigation

GLENABLECLIENTSTATE(3G) GLENABLECLIENTSTATE(3G)

NAME

glEnableClientState, glDisableClientState - enable or disable client-side capability

C SPECIFICATION

void glEnableClientState( GLenum cap); 1.1 )


PARAMETERS

1.1
Specifies the capability to enable. Symbolic constants 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); 1.1 )


PARAMETERS

1.1
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, 1.1, which can assume one of the following values:

If enabled, the color array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glColorPointer.
If enabled, the edge flag array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glEdgeFlagPointer.
If enabled, the index array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glIndexPointer.
If enabled, the normal array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glNormalPointer.
If enabled, the texture coordinate array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glTexCoordPointer.
If enabled, the vertex array is enabled for writing and used during rendering when glArrayElement, glDrawArrays, glDrawElement, or glDrawRangeElements is called. See glVertexPointer.

NOTES

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

If GL_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 glClientActiveTextureARB.

ERRORS

GL_INVALID_ENUM is generated if 1.1 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(3G), glClientActiveTextureARB(3G), glColorPointer(3G), glDrawArrays(3G), glDrawElements(3G), glEdgeFlagPointer(3G), glEnable(3G), glGetPointerv(3G), glIndexPointer(3G), glInterleavedArrays(3G), glNormalPointer(3G), glTexCoordPointer(3G), glVertexPointer(3G)