glTexCoordPointer(3gl)

1GLTEXCOORDPOINTER(3G)                                    GLTEXCOORDPOINTER(3G)
2
3
4

NAME

6       glTexCoordPointer - define an array of texture coordinates
7
8

C SPECIFICATION

10       void glTexCoordPointer( GLint size,
11                               GLenum type,
12                               GLsizei stride,
13                               const GLvoid *ptr )
14
15

PARAMETERS

17       size    Specifies  the number of coordinates per array element. Must be
18               1, 2, 3 or 4. The initial value is 4.
19
20       type    Specifies the data type of each texture  coordinate.   Symbolic
21               constants   GL_SHORT,   GL_INT,   GL_FLOAT,  or  GL_DOUBLE  are
22               accepted. The initial value is GL_FLOAT.
23
24       stride  Specifies the byte offset between consecutive  array  elements.
25               If stride is 0, the array elements are understood to be tightly
26               packed. The initial value is 0.
27
28       ptr     Specifies a pointer to the first coordinate of the  first  ele‐
29               ment in the array.  The initial value is 0.
30

DESCRIPTION

32       glTexCoordPointer  specifies the location and data  of an array of tex‐
33       ture coordinates to use when rendering.  size specifies the  number  of
34       coordinates per element, and must be 1, 2, 3, or 4.  type specifies the
35       data type of each texture coordinate  and  stride  specifies  the  byte
36       stride  from  one  array  element  to  the  next  allowing vertices and
37       attributes to be packed into a  single  array  or  stored  in  separate
38       arrays.   (Single-array storage may be more efficient on some implemen‐
39       tations; see
40       glInterleavedArrays.)  When a texture coordinate  array  is  specified,
41       size, type, stride, and ptr are saved client-side state.
42
43       To   enable   and   disable   the   texture   coordinate   array,  call
44       glEnableClientState  and   glDisableClientState   with   the   argument
45       GL_TEXTURE_COORD_ARRAY.  If  enabled,  the  texture coordinate array is
46       used  when   glDrawArrays,   glDrawElements,   glDrawRangeElements   or
47       glArrayElement is called.
48
49       Use glDrawArrays to construct a sequence of primitives (all of the same
50       type) from  prespecified  vertex  and  vertex  attribute  arrays.   Use
51       glArrayElement  to  specify  primitives by indexing vertices and vertex
52       attributes and glDrawElements to construct a sequence of primitives  by
53       indexing vertices and vertex attributes.
54

NOTES

56       glTexCoordPointer  is  available  only  if  the  GL  version  is 1.1 or
57       greater.
58
59       The texture coordinate array is initially  disabled  and  it  won't  be
60       accessed  when  glArrayElement, glDrawElements, glDrawRangeElements, or
61       glDrawArrays is called.
62
63       Execution of glTexCoordPointer is not allowed between the execution  of
64       glBegin  and  the corresponding execution of glEnd, but an error may or
65       may not be generated. If no error is generated, the operation is  unde‐
66       fined.
67
68       glTexCoordPointer  is  typically implemented on the client side with no
69       protocol.
70
71       The texture coordinate array parameters are client-side state  and  are
72       therefore  not  saved or restored by glPushAttrib and glPopAttrib.  Use
73       glPushClientAttrib and glPopClientAttrib instead.
74
75       When  the  GL_ARB_imaging  extension  is  supported,  glTexCoordPointer
76       updates the texture coordinate array state of the active client texture
77       unit, specified with glClientActiveTextureARB.
78

ERRORS

80       GL_INVALID_VALUE is generated if size is not 1, 2, 3, or 4.
81
82       GL_INVALID_ENUM is generated if type is not an accepted value.
83
84       GL_INVALID_VALUE is generated if stride is negative.
85

ASSOCIATED GETS

87       glIsEnabled with argument GL_TEXTURE_COORD_ARRAY
88       glGet with argument GL_TEXTURE_COORD_ARRAY_SIZE
89       glGet with argument GL_TEXTURE_COORD_ARRAY_TYPE
90       glGetPointerv with argument GL_TEXTURE_COORD_ARRAY_POINTER
91