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 con‐
stants 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 at‐
tributes 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,
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 at‐
tributes and glDrawElements to construct a sequence of primitives by in‐
dexing 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 ac‐
cessed when glArrayElement, glDrawElements, glDrawRangeElements, or
glDrawArrays is called.
Execution of glTexCoordPointer is not allowed between the execution of
glBegin and the corresponding execution of glEnd, but an error may or
may not be generated. If no error is generated, the operation is unde‐
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)
Man(1) output converted with
man2html