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

Copyright © 2003-2004 Silicon Graphics, Inc.

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

See Also

glClientActiveTexture, glColorPointer, glDrawArrays, glDrawElements, glEnable, glNormalPointer, glTexCoordPointer, glVertexPointer