1GLARRAYELEMENT(3G)               OpenGL Manual              GLARRAYELEMENT(3G)
2
3
4

NAME

6       glArrayElement - render a vertex using the specified vertex array
7       element
8

C SPECIFICATION

10       void glArrayElement(GLint i);
11

PARAMETERS

13       i
14           Specifies an index into the enabled vertex data arrays.
15

DESCRIPTION

17       glArrayElement commands are used within glBegin()/glEnd() pairs to
18       specify vertex and attribute data for point, line, and polygon
19       primitives. If GL_VERTEX_ARRAY is enabled when glArrayElement is
20       called, a single vertex is drawn, using vertex and attribute data taken
21       from location i of the enabled arrays. If GL_VERTEX_ARRAY is not
22       enabled, no drawing occurs but the attributes corresponding to the
23       enabled arrays are modified.
24
25       Use glArrayElement to construct primitives by indexing vertex data,
26       rather than by streaming through arrays of data in first-to-last order.
27       Because each call specifies only a single vertex, it is possible to
28       explicitly specify per-primitive attributes such as a single normal for
29       each triangle.
30
31       Changes made to array data between the execution of glBegin() and the
32       corresponding execution of glEnd() may affect calls to glArrayElement
33       that are made within the same glBegin()/glEnd() period in nonsequential
34       ways. That is, a call to glArrayElement that precedes a change to array
35       data may access the changed data, and a call that follows a change to
36       array data may access original data.
37

NOTES

39       glArrayElement is available only if the GL version is 1.1 or greater.
40
41       glArrayElement is included in display lists. If glArrayElement is
42       entered into a display list, the necessary array data (determined by
43       the array pointers and enables) is also entered into the display list.
44       Because the array pointers and enables are client-side state, their
45       values affect display lists when the lists are created, not when the
46       lists are executed.
47

ERRORS

49       GL_INVALID_VALUE may be generated if i is negative.
50
51       GL_INVALID_OPERATION is generated if a non-zero buffer object name is
52       bound to an enabled array and the buffer object's data store is
53       currently mapped.
54

SEE ALSO

56       glClientActiveTexture(), glColorPointer(), glDrawArrays(),
57       glEdgeFlagPointer(), glFogCoordPointer(), glGetPointerv(),
58       glIndexPointer(), glInterleavedArrays(), glNormalPointer(),
59       glSecondaryColorPointer(), glTexCoordPointer(), glVertexPointer()
60

62       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
63       under the SGI Free Software B License. For details, see
64       http://oss.sgi.com/projects/FreeB/.
65

AUTHORS

67       opengl.org
68
69
70
71opengl.org                        06/10/2014                GLARRAYELEMENT(3G)
Impressum