- define an array of texture coordinates



C SPECIFICATION


PARAMETERS

       _param1  Specifies  the  number  of  coordinates per array
                element. Must be 1, 2, 3 or 4. The initial  value
                is 4.

       _param2  Specifies  the  data type of each texture coordi-
                nate.   Symbolic  constants   GL_SHORT,   GL_INT,
                GL_FLOAT,  or GL_DOUBLE are accepted. The initial
                value is GL_FLOAT.

       _param3  Specifies the  byte  offset  between  consecutive
                array  elements.  If _param3 is 0, the array ele-
                ments are understood to be  tightly  packed.  The
                initial value is 0.

       _param4  Specifies  a  pointer  to the first coordinate of
                the first element  in  the  array.   The  initial
                value is 0.


DESCRIPTION

       glTexCoordPointer  specifies  the location and data  of an
       array  of  texture  coordinates  to  use  when  rendering.
       _param1  specifies  the number of coordinates per element,
       and must be 1, 2, 3, or 4.   _param2  specifies  the  data
       type  of each texture coordinate and _param3 specifies the
       byte stride from one array element 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 implementations; see
       glInterleavedArrays.)   When a texture coordinate array is
       specified, _param1,  _param2,  _param3,  and  _param4  are
       saved client-side state.

       To  enable  and disable the texture coordinate array, call
       glEnableClientState  and  glDisableClientState  with   the
       argument  GL_TEXTURE_COORD_ARRAY.  If enabled, the texture
       coordinate    array    is    used    when    glDrawArrays,
       glDrawElements,  glDrawRangeElements  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


       The texture coordinate array  parameters  are  client-side
       state   and   are  therefore  not  saved  or  restored  by
       glPushAttrib and glPopAttrib.  Use glPushClientAttrib  and
       glPopClientAttrib instead.

       When    the   GL_ARB_imaging   extension   is   supported,
       glTexCoordPointer updates  the  texture  coordinate  array
       state  of  the  active client texture unit, specified with
       glClientActiveTextureARB.


ERRORS

       GL_INVALID_VALUE is generated if _param1 is not 1,  2,  3,
       or 4.

       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_TEXTURE_COORD_ARRAY
       glGet with argument GL_TEXTURE_COORD_ARRAY_SIZE
       glGet with argument GL_TEXTURE_COORD_ARRAY_TYPE
       glGetPointerv with argument GL_TEXTURE_COORD_ARRAY_POINTER


SEE ALSO

       glArrayElement,  glClientActiveTextureARB, glColorPointer,
       glDrawArrays,     glDrawElements,     glDrawRangeElements,
       glEdgeFlagPointer,         glEnable,        glGetPointerv,
       glIndexPointer,    glNormalPointer,     glPopClientAttrib,
       glPushClientAttrib, glTexCoord, glVertexPointer



                                                                1