C SPECIFICATION

       void GLAPIENTRY glTexCoordPointer( GLint size,
                                          GLenum typ )

PARAMETERS

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

       typ   Specifies the data type of  each  texture  coordinate.   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 elements 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 format of an array of
       texture coordinates to use when rendering.  size specifies  the  number
       of  coordinates  per element, and must be 1, 2, 3, or 4.  typ 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 implemen-
       tations; see
       glInterleavedArrays.)  When a texture coordinate  array  is  specified,
       size, typ, _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  primitives by indexing vertexes and vertex
       attributes and glDrawElements to construct a sequence of primitives  by
       indexing vertexes and vertex attributes.

NOTES

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

       The texture coordinate array is initially  disabled  and  it  won't  be

       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 size is not 1, 2, 3, or 4.

       GL_INVALID_ENUM is generated if typ 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



                                                         GLTEXCOORDPOINTER(3G)