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 |
|
| Bibliothek |
|
| DLL |
|