glEnableClientState, glDisableClientState

The glEnableClientState and glDisableClientState functions enable and disable arrays respectively.

void glEnableClientState(
  GLenum array  
);
 
void 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.


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.

Error Codes

The following is the error code generated and its condition.

Error code Condition
GL_INVALID_ENUM array was not an accepted value.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Gl.h.
  Library: Use Opengl32.lib.

See Also

glArrayElement, glBegin, glColorPointer, glDrawArrays, glDrawElements, glEdgeFlagPointer, glEnable, glEnd, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormalPointer, glTexCoordPointer, glVertexPointer


  

Community Additions

Show: