Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GLARRAYELEMENT()					      GLARRAYELEMENT()

NAME
       glArrayElement  - render	a vertex using the specified vertex array ele-
       ment

C SPECIFICATION
       void glArrayElement( GLint i )

       delim $$

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 ver-
       tex is drawn, using vertex and attribute	data taken from	location i  of
       the  enabled  arrays. If	GL_VERTEX_ARRAY	is not enabled,	no drawing oc-
       curs but	the attributes corresponding to	the enabled arrays  are	 modi-
       fied.

       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 ex-
       plicitly	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 en-
       tered into a display list, the necessary	array data (determined by  the
       array  pointers and enables) is also entered into the display list. Be-
       cause the array pointers	and enables are	client-side state, their  val-
       ues affect display lists	when the lists are created, not	when the lists
       are executed.

SEE ALSO
       glColorPointer, glDrawArrays, glEdgeFlagPointer,	glGetPointerv,
       glIndexPointer,	 glInterleavedArrays,	glNormalPointer,   glTexCoord-
       Pointer,	glVertexPointer

							      GLARRAYELEMENT()

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glArrayElement&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help