glEnableClientState

Name

glEnableClientState , glDisableClientState - enable or disable client-side capability

C Specification

void glEnableClientState(GLenum array)
void glDisableClientState(GLenum array)

Parameters

array: Specifies the capability to enable or disable. Symbolic constants GL_COLOR_ARRAY, GL_MATRIX_INDEX_ARRAY_OES, GL_NORMAL_ARRAY, GL_POINT_SIZE_ARRAY_ARRAY_OES, GL_TEXTURE_COORD_ARRAY, GL_VERTEX_ARRAY, and GL_WEIGHT_ARRAY_OES are accepted.

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, array, 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 glDrawArrays, or glDrawElements is called. See glColorPointer.
GL_MATRIX_INDEX_ARRAY_OES: If enabled, the matrix index array is enabled. See glMatrixIndexPointer
GL_NORMAL_ARRAY: If enabled, the normal array is enabled for writing and used during rendering when glDrawArrays, or glDrawElements is called. See glNormalPointer.
GL_POINT_SIZE_ARRAY_OES: If enabled, the point size array controls the sizes used to render points and point sprites. In this case the point size defined by glPointSize is ignored. The point sizes supplied in the point size arrays will be the sizes used to render both points and point sprites. See glPointSize
GL_TEXTURE_COORD_ARRAY: If enabled, the texture coordinate array is enabled for writing and used during rendering when glDrawArrays, or glDrawElements is called. See glTexCoordPointer.
GL_VERTEX_ARRAY: If enabled, the vertex array is enabled for writing and used during rendering when glDrawArrays, or glDrawElements is called. See glVertexPointer.
GL_WEIGHT_ARRAY_OES: If enabled, the weight array is enabled. See glWeightPointer

Notes

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 array is not an accepted value.

Copyright

This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.