- define an array of color indexes
C SPECIFICATION
PARAMETERS
_param1 Specifies the data type of each color index in
the array. Symbolic constants GL_UNSIGNED_BYTE,
GL_SHORT, GL_INT, GL_FLOAT, and GL_DOUBLE are
accepted. The initial value is GL_FLOAT.
_param2 Specifies the byte offset between consecutive
color indexes. If _param2 is 0 (the initial
value), the color indexes are understood to be
tightly packed in the array. The initial value
is 0.
_param3 Specifies a pointer to the first index in the
array. The initial value is 0.
DESCRIPTION
glIndexPointer specifies the location and data of an
array of color indexes to use when rendering. _param1
specifies the data type of each color index and _param2
gives the byte stride from one color index to the next
allowing vertexes and attributes to be packed into a sin-
gle array or stored in separate arrays. (Single-array
storage may be more efficient on some implementations; see
glInterleavedArrays.)
_param1, _param2, and _param3 are saved as client-side
state.
The color index array is initially disabled. To enable and
disable the array, call glEnableClientState and
glDisableClientState with the argument GL_INDEX_ARRAY. If
enabled, the color index array is used when glDrawArrays,
glDrawElements or glArrayElement is called.
Use glDrawArrays to construct a sequence of primitives
(all of the same type) from prespecified vertex and vertex
attribute arrays. Use glArrayElement to specify primi-
tives by indexing vertexes and vertex attributes and
glDrawElements to construct a sequence of primitives by
indexing vertexes and vertex attributes.
NOTES
glIndexPointer is available only if the GL version is 1.1
or greater.
The color index array is initially disabled, and it isn't
accessed when glArrayElement, glDrawElements, or
glDrawArrays is called.
ERRORS
GL_INVALID_ENUM is generated if _param1 is not an accepted
value.
GL_INVALID_VALUE is generated if _param2 is negative.
ASSOCIATED GETS
glIsEnabled with argument GL_INDEX_ARRAY
glGet with argument GL_INDEX_ARRAY_TYPE
glGet with argument GL_INDEX_ARRAY_STRIDE
glGetPointerv with argument GL_INDEX_ARRAY_POINTER
SEE ALSO
glArrayElement, glColorPointer, glDrawArrays,
glDrawElements, glEdgeFlagPointer, glEnable,
glGetPointerv, glInterleavedArrays, glNormalPointer,
glPopClientAttrib, glPushClientAttrib, glTexCoordPointer,
glVertexPointer
1