1GLINTERLEAVEDARRAYS(3G)                                GLINTERLEAVEDARRAYS(3G)
2
3
4

NAME

6       glInterleavedArrays  - simultaneously specify and enable several inter‐
7       leaved arrays
8
9

C SPECIFICATION

11       void glInterleavedArrays( GLenum format,
12                                 GLsizei stride,
13                                 const GLvoid *pointer )
14
15

PARAMETERS

17       format   Specifies the type of  array  to  enable.  Symbolic  constants
18                GL_V2F,    GL_V3F,   GL_C4UB_V2F,   GL_C4UB_V3F,   GL_C3F_V3F,
19                GL_N3F_V3F,    GL_C4F_N3F_V3F,     GL_T2F_V3F,     GL_T4F_V4F,
20                GL_T2F_C4UB_V3F,        GL_T2F_C3F_V3F,        GL_T2F_N3F_V3F,
21                GL_T2F_C4F_N3F_V3F, and GL_T4F_C4F_N3F_V4F are accepted.
22
23       stride   Specifies the offset in bytes  between  each  aggregate  array
24                element.
25

DESCRIPTION

27       glInterleavedArrays  lets you specify and enable individual color, nor‐
28       mal, texture and vertex arrays whose elements  are  part  of  a  larger
29       aggregate  array element.  For some implementations, this is more effi‐
30       cient than specifying the arrays separately.
31
32       If stride is 0, the aggregate elements are stored consecutively.   Oth‐
33       erwise, stride bytes occur between the beginning of one aggregate array
34       element and the beginning of the next aggregate array element.
35
36       format serves as a ``key''  describing  the  extraction  of  individual
37       arrays  from the aggregate array.  If format contains a T, then texture
38       coordinates are extracted from the interleaved array.  If C is present,
39       color  values  are  extracted.  If N is present, normal coordinates are
40       extracted.  Vertex coordinates are always extracted.
41
42       The digits 2, 3, and 4 denote how many values are extracted.   F  indi‐
43       cates  that  values are extracted as floating-point values.  Colors may
44       also be extracted as 4 unsigned bytes if 4UB follows the C.  If a color
45       is  extracted  as 4 unsigned bytes, the vertex array element which fol‐
46       lows is located at the first possible floating-point aligned address.
47

NOTES

49       glInterleavedArrays is available only if  the  GL  version  is  1.1  or
50       greater.
51
52       If  glInterleavedArrays is called while compiling a display list, it is
53       not compiled into the list, and it is executed immediately.
54
55       Execution of glInterleavedArrays is not allowed between  the  execution
56       of  glBegin  and the corresponding execution of glEnd, but an error may
57       or may not be generated. If no error is  generated,  the  operation  is
58       undefined.
59
60       glInterleavedArrays is typically implemented on the client side.
61
62       Vertex  array  parameters  are  client-side state and are therefore not
63       saved   or   restored   by   glPushAttrib   and    glPopAttrib.     Use
64       glPushClientAttrib and glPopClientAttrib instead.
65
66       When     the     GL_ARB_multitexture     extension     is    supported,
67       glInterleavedArrays only updates the texture coordinate array  for  the
68       active  active  texture  unit.  The  texture coordinate state for other
69       client texture units is not update, regardless if they are  enabled  or
70       not.
71

ERRORS

73       GL_INVALID_ENUM is generated if format is not an accepted value.
74
75       GL_INVALID_VALUE is generated if stride is negative.
76

SEE ALSO

78       glArrayElement(3G),  glClientActiveTextureARB(3G),  glColorPointer(3G),
79       glDrawArrays(3G),      glDrawElements(3G),       glEdgeFlagPointer(3G),
80       glEnableClientState(3G),      glGetPointer(3G),     glIndexPointer(3G),
81       glNormalPointer(3G), glTexCoordPointer(3G), glVertexPointer(3G)
82
83
84
85                                                       GLINTERLEAVEDARRAYS(3G)
Impressum