MirOS Manual: glArrayElement(3)


GLARRAYELEMENT(3G)  UNIX Programmer's Manual   GLARRAYELEMENT(3G)

NAME

     glArrayElement - render a vertex using the specified vertex
     array element

C SPECIFICATION

     void glArrayElement( GLint i )

PARAMETERS

     i  Specifies an index into the enabled vertex data arrays.

DESCRIPTION

     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 draw-
     ing occurs but the attributes corresponding to the enabled
     arrays are modified.

     Use glArrayElement to construct primitives by indexing ver-
     tex data, rather than by streaming through arrays of data in
     first-to-last order. Because each call specifies only a sin-
     gle 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.

NOTES

     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.

SEE ALSO

     glClientActiveTextureARB(3G), glColorPointer(3G),
     glDrawArrays(3G), glEdgeFlagPointer(3G), glGetPointerv(3G),

MirOS BSD #10-current   Printed 20.2.2012                       1

GLARRAYELEMENT(3G)  UNIX Programmer's Manual   GLARRAYELEMENT(3G)

     glIndexPointer(3G), glInterleavedArrays(3G),
     glNormalPointer(3G), glTexCoordPointer(3G),
     glVertexPointer(3G)

MirOS BSD #10-current   Printed 20.2.2012                       2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.