NAME
fglArrayElement - render a vertex using the specified vertex
array element
FORTRAN SPECIFICATION
SUBROUTINE fglArrayElement( INTEGER*4 i )
PARAMETERS
i Specifies an index into the enabled vertex data arrays.
DESCRIPTION
fglArrayElement commands are used within fglBegin/fglEnd
pairs to specify vertex and attribute data for point, line,
and polygon primitives. If GL_VERTEX_ARRAY is enabled when
fglArrayElement 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 fglArrayElement 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 fglBegin
and the corresponding execution of fglEnd may affect calls
to fglArrayElement that are made within the same
fglBegin/fglEnd period in non-sequential ways. That is, a
call to
fglArrayElement 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.
NOTES
fglArrayElement is available only if the GL version is 1.1
or greater.
fglArrayElement is included in display lists. If
fglArrayElement 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.
SEE ALSO
fglColorPointer, fglDrawArrays, fglEdgeFlagPointer,
fglGetPointerv,
fglIndexPointer, fglInterleavedArrays, fglNormalPointer,
fglTexCoordPointer, fglVertexPointer