GLTEXCOORDPOINTER(3G)UNIX Programmer's ManuaGLTEXCOORDPOINTER(3G)
NAME
glTexCoordPointer - define an array of texture coordinates
C SPECIFICATION
void glTexCoordPointer( GLint size,
GLenum type,
GLsizei stride,
const GLvoid *ptr )
PARAMETERS
size Specifies the number of coordinates per array ele-
ment. Must be 1, 2, 3 or 4. The initial value is 4.
type 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.
stride Specifies the byte offset between consecutive array
elements. If stride is 0, the array elements are
understood to be tightly packed. The initial value
is 0.
ptr 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. size
specifies the number of coordinates per element, and must be
1, 2, 3, or 4. type specifies the data type of each texture
coordinate and stride specifies the byte stride from one
array element to the next allowing vertices 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, size, type, stride, and ptr are saved client-side
state.
To enable and disable the texture coordinate array, call
glEnableClientState and glDisableClientState with the argu-
ment GL_TEXTURE_COORD_ARRAY. If enabled, the texture coordi-
nate 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 attri-
bute arrays. Use glArrayElement to specify primitives by
indexing vertices and vertex attributes and glDrawElements
MirBSD #10-current Printed 2021-12-07 1
GLTEXCOORDPOINTER(3G)UNIX Programmer's ManuaGLTEXCOORDPOINTER(3G)
to construct a sequence of primitives by indexing vertices
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 accessed 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 undefined.
glTexCoordPointer is typically implemented on the client
side with no protocol.
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 size is not 1, 2, 3, or 4.
GL_INVALID_ENUM is generated if type is not an accepted
value.
GL_INVALID_VALUE is generated if stride 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(3G), glClientActiveTextureARB(3G),
glColorPointer(3G), glDrawArrays(3G), glDrawElements(3G),
glDrawRangeElements(3G), glEdgeFlagPointer(3G),
glEnable(3G), glGetPointerv(3G), glIndexPointer(3G),
glNormalPointer(3G), glPopClientAttrib(3G),
glPushClientAttrib(3G), glTexCoord(3G), glVertexPointer(3G)
MirBSD #10-current Printed 2021-12-07 2