- 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