- define an array of colors



C SPECIFICATION


PARAMETERS

       _param1  Specifies  the  number  of  components per color.
                Must be 3 or 4.  The initial value is 4.

       _param2  Specifies the data type of each  color  component
                in   the   array.   Symbolic  constants  GL_BYTE,
                GL_UNSIGNED_BYTE,  GL_SHORT,   GL_UNSIGNED_SHORT,
                GL_INT,  GL_UNSIGNED_INT, GL_FLOAT, and GL_DOUBLE
                are accepted.  The initial value is GL_FLOAT.

       _param3  Specifies the  byte  offset  between  consecutive
                colors.  If _param3 is 0 (the initial value), the
                colors are understood to be tightly packed in the
                array. The initial value is 0.

       _param4  Specifies a pointer to the first component of the
                first color element in the array.


DESCRIPTION

       glColorPointer specifies the  location  and  data   of  an
       array  of color components to use when rendering.  _param1
       specifies the number of components per color, and must  be
       3  or  4.   _param2  specifies the data type of each color
       component, and _param3 specifies the byte stride from  one
       color  to  the next allowing vertexes and attributes to be
       packed into a single array or stored in  separate  arrays.
       (Single-array storage may be more efficient on some imple-
       mentations; see glInterleavedArrays.)

       When  a  color  array  is  specified,  _param1,   _param2,
       _param3, and _param4 are saved as client-side state.

       To    enable   and   disable   the   color   array,   call
       glEnableClientState and
       glDisableClientState with the argument GL_COLOR_ARRAY.  If
       enabled,  the  color  array  is  used  when  glDrawArrays,
       glDrawElements, glDrawRangeElements, or glArrayElement  is
       called.


NOTES

       glColorPointer  is available only if the GL version is 1.1
       or greater.

       The color array is initially disabled and  isn't  accessed
       when glArrayElement, glDrawArrays, glDrawRangeElements, or
       glDrawElements is called.

       Execution of glColorPointer is  not  allowed  between  the

       GL_INVALID_ENUM is generated if _param2 is not an accepted
       value.

       GL_INVALID_VALUE is generated if _param3 is negative.


ASSOCIATED GETS

       glIsEnabled with argument GL_COLOR_ARRAY
       glGet with argument GL_COLOR_ARRAY_SIZE
       glGet with argument GL_COLOR_ARRAY_TYPE
       glGet with argument GL_COLOR_ARRAY_STRIDE
       glGetPointerv with argument GL_COLOR_ARRAY_POINTER


SEE ALSO

       glArrayElement,       glDrawArrays,        glDrawElements,
       glEdgeFlagPointer,         glEnable,        glGetPointerv,
       glIndexPointer,   glInterleavedArrays,    glNormalPointer,
       glPopClientAttrib,  glPushClientAttrib, glTexCoordPointer,
       glVertexPointer



                                                                1