|
Table of Contents
glArrayElement - render a vertex using the specified vertex array
element
void glArrayElement( GLint i )
eqn not supported
- i
- Specifies an index into the enabled vertex
data arrays.
glArrayElement commands are used within glBegin/glEnd
pairs to specify vertex and attribute data for point, line, and polygon
primitives. If GL_VERTEX_ARRAY is enabled when glArrayElement is called,
a single vertex is drawn, using vertex and attribute data taken from location
i of the enabled arrays. If GL_VERTEX_ARRAY is not enabled, no drawing occurs
but the attributes corresponding to the enabled arrays are modified.
Use
glArrayElement to construct primitives by indexing vertex data, rather
than by streaming through arrays of data in first-to-last order. Because each
call specifies only a single vertex, it is possible to explicitly specify
per-primitive attributes such as a single normal per individual triangle.
Changes made to array data between the execution of glBegin and the corresponding
execution of glEnd may affect calls to glArrayElement that are made within
the same glBegin/glEnd period in non-sequential ways. That is, a call to
glArrayElement that precedes a change to array data may access the changed
data, and a call that follows a change to array data may access original
data.
glArrayElement is available only if the GL version is 1.1 or greater.
glArrayElement is included in display lists. If glArrayElement is entered
into a display list, the necessary array data (determined by the array
pointers and enables) is also entered into the display list. Because the
array pointers and enables are client-side state, their values affect display
lists when the lists are created, not when the lists are executed.
glClientActiveTextureARB(3G)
,
glColorPointer(3G)
, glDrawArrays(3G)
, glEdgeFlagPointer(3G)
, glGetPointerv(3G)
,
glIndexPointer(3G)
, glInterleavedArrays(3G)
, glNormalPointer(3G)
, glTexCoordPointer(3G)
,
glVertexPointer(3G)
Table of Contents
|
