glEnableClientState, glDisableClientState Function
The glEnableClientState and glDisableClientState functions enable and disable arrays respectively.
Syntax
void glEnableClientState, glDisableClientState(
GLenum array
);
Parameters
array
A symbolic constant for the array you want to enable or disable. This parameter can assume one of the following values:Value Meaning GL_COLOR_ARRAY If enabled, use color arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glColorPointer.
GL_EDGE_FLAG_ARRAY If enabled, use edge flag arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glEdgeFlagPointer.
GL_INDEX_ARRAY If enabled, use index arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glIndexPointer.
GL_NORMAL_ARRAY If enabled, use normal arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glNormalPointer.
GL_TEXTURE_COORD_ARRAY If enabled, use texture coordinate arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glTexCoordPointer.
GL_VERTEX_ARRAY If enabled, use vertex arrays with calls to glArrayElement, glDrawElements, or glDrawArrays.
See also glVertexPointer.
Return Value
Returns the following error code and its condition.
| Return code | Description |
|---|---|
| GL_INVALID_ENUM | array was not an accepted value. |
Remarks
The glEnableClientState and glDisableClientState functions enable and disable various individual arrays. Use glIsEnabled or glGet to determine the current setting of any capability.
Calling glEnableClientState and glDisableClientState between calls to glBegin and the corresponding call to glEnd can cause an error. If no error is generated, the behavior is undefined.
Note The glEnableClientState and glDisableClientState functions are only available in OpenGL version 1.1 or later.
Requirements
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Header | Gl.h |
| Library | Opengl32.lib |
| DLL | Opengl32.dll |
See Also
Send comments about this topic to Microsoft
Build date: 6/9/2009