glArrayElement

glArrayElement

Name

glArrayElement - rendert ein Vertex mithilfe des angegebenen Vertexfeldelements (vertex array element).

Delphi-Spezifikation

procedure glArrayElement(i: TGLint);

Parameter

i	Spezifiziert einen Index bezüglich der aktivierten Vertexdatenfelder (Vertex Data Arrays).

Beschreibung

Der glArrayElement Befehl wird zwischen glBegin/glEnd Paaren aufgerufen, um Positionen und Eigenschaften von Polygonen, Linien und Polygon Primitiven zu übergeben. Ist GL_VERTEX_ARRAY aktiviert während glArrayElement aufgerufen wird, dann wird ein einzelner Vertex mit den Vertexdaten und Attributen, die an der iten Stelle des Vertex Arrays gespeichert sind, gezeichet. Ist GL_VERTEX_ARRAY nicht aktiviert, wird nichts aus dem Feld gezeichnet. Allerding werden die Attribute, die zu dem aktivierten Array gehören, modifiziert.

Benutzen Sie glArrayElements, um Primitive durch Indexierung von Vertexdaten anstatt durch einfaches Durchlaufen von Datenfeldern (von vorn bis hinten) zu generieren. Da jeder Aufruf nur ein einzelnes Vertex generiert, ist es möglich expliziet für jedes Primitiv Attribute zu vergeben, wie z.B. eine Normale pro Dreieck.

Falls die Eckpunke so im Array angeordnet sind, wie man sie auch rendern möchte, so lohnt sicher der Einsatzt von glArrayElement nicht. Statt dessen sollte der Befehl glDrawArrays verwendet werden. glArrayElement sollte man dann nutzen, wenn man gleich alle Daten/Eigenschaften eines Eckpunktes übergeben möchte, und obriger Fall nicht vor liegt.

Veränderungen am Inhalt eines Feldes, die innerhalb eines glBegin-glEnd Blocks gemacht werden, können Aufrufe von glArrayElement in nicht sequenzieller Weise beeinflussen, die im selben Block gemacht werden. Das bedeutet, dass ein Aufruf von glArrayElement der vor einer Änderung gerufen wird bereits die neuen Daten nutzt, während der nachfolgende Aufruf noch auf die originalen Daten zugreift.

Hinweise

glArrayElement ist erst ab OpenGL Version 1.1 oder später verfügbar.

glArrayElement wird von Displaylisten aufgenommen. Wenn glArrayElement in eine Displayliste geschrieben wird, werden auch die notwendigen Feldwerte (angegeben durch den Feldzeiger und die Aktivierungen) in die Displayliste eingetragen. Da die Feldzeiger und Aktivierungen auf der Clientseite liegen, beeinflussen ihre Werte die Displayliste wenn diese erstellt wird, nicht aber wenn diese ausgeführt wird.

Siehe auch

glColorPointer, glDrawArrays, glEdgeFlagPointer, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormalPointer, glTexCoordPointer, glVertexPointer