glArrayElement-Funktion

Die glArrayElement-Funktion gibt die Arrayelemente an, die zum Rendern eines Scheitelpunkts verwendet werden.

Syntax

void WINAPI glArrayElement(
   GLint index
);

Parameter

Index

Ein Index in den aktivierten Arrays.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Verwenden Sie die glArrayElement-Funktion in glBegin - und glEnd-Paaren , um Vertex- und Attributdaten für Punkt-, Linien- und Polygongrundsätze anzugeben. Die glArrayElement-Funktion gibt die Daten für einen einzelnen Scheitelpunkt mithilfe von Vertex- und Attributdaten an, die sich im Index der aktivierten Vertexarrays befinden.

Sie können glArrayElement verwenden, um Primitive zu erstellen, indem Sie Vertexdaten indizieren, anstatt datenarrays in erster bis letzter Reihenfolge zu streamen. Da glArrayElement nur einen einzelnen Scheitelpunkt angibt, können Sie Attribute für einzelne Grundtypen explizit angeben. Beispielsweise können Sie einen einzelnen Normalwert für jedes einzelne Dreieck festlegen.

Wenn Sie GlArrayElement-Aufrufe in Anzeigelisten einschließen, werden die erforderlichen Arraydaten, die durch die Arrayzeiger und Aktivierungswerte bestimmt werden, ebenfalls in die Anzeigeliste eingegeben. Arrayzeiger- und Aktivierungswerte werden beim Erstellen von Anzeigelisten und nicht beim Ausführen von Anzeigelisten bestimmt.

Sie können statische Arraydaten jederzeit mit glArrayElement lesen und zwischenspeichern. Wenn Sie die Elemente eines statischen Arrays ändern, ohne das Array erneut anzugeben, sind die Ergebnisse der nachfolgenden Aufrufe von glArrayElement nicht definiert.

Wenn Sie glArrayElement aufrufen, ohne zuerst glEnableClientState(GL_VERTEX_ARRAY) aufzurufen, erfolgt keine Zeichnung, aber die Attribute, die aktivierten Arrays entsprechen, werden geändert. Obwohl kein Fehler generiert wird, wenn Sie ein Array innerhalb der GlBegin - und glEnd-Paare angeben, sind die Ergebnisse nicht definiert.

Hinweis

Die glArrayElement-Funktion ist nur in OpenGL Version 1.1 oder höher verfügbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer