- 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