glDrawElements-Funktion
Die glDrawElements-Funktion rendert Grundtypen aus Arraydaten.
Syntax
void WINAPI glDrawElements(
GLenum mode,
GLsizei count,
GLenum type,
const GLvoid *indices
);
Parameter
-
mode
-
Die Art der zu rendernden Grundtypen. Er kann einen der folgenden symbolischen Werte annehmen: GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS und GL_POLYGON.
-
count
-
Die Anzahl der elemente, die gerendert werden sollen.
-
type
-
Der Typ der Werte in Indizes. Muss eine der GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT oder GL_UNSIGNED_INT sein.
-
Indizes
-
Ein Zeiger auf den Speicherort, an dem die Indizes gespeichert sind.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
mode war kein akzeptierter Wert. |
|
count war ein negativer Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Mit der glDrawElements-Funktion können Sie mehrere geometrische Grundtypen mit sehr wenigen Funktionsaufrufen angeben. Anstatt eine OpenGL-Funktion aufzurufen, um jeden einzelnen Scheitelpunkt, jede Normalität oder jede Farbe zu übergeben, können Sie im Voraus separate Arrays von Scheitelpunkten, Normals und Farben angeben und sie verwenden, um eine Sequenz von Grundtypen (alle vom gleichen Typ) mit einem einzigen Aufruf von glDrawElements zu definieren.
Wenn Sie die glDrawElements-Funktion aufrufen , werden sequenzielle Elemente aus Indizes zählen verwendet, um eine Sequenz geometrischer Grundtypen zu erstellen. Der Mode-Parameter gibt an, welche Arten von Grundtypen erstellt werden und wie die Arrayelemente zum Erstellen dieser Grundtypen verwendet werden. Wenn GL_VERTEX_ARRAY nicht aktiviert ist, werden keine geometrischen Grundtypen generiert.
Vertexattribute, die von glDrawElements geändert werden, verfügen nach der Rückgabe von glDrawElements über einen nicht angegebenen Wert. Wenn beispielsweise GL_COLOR_ARRAY aktiviert ist, ist der Wert der aktuellen Farbe nach der Ausführung von glDrawElements nicht definiert. Attribute, die nicht geändert werden, bleiben unverändert.
Sie können die glDrawElements-Funktion in Anzeigelisten einschließen. Wenn glDrawElements in einer Anzeigeliste enthalten ist, werden auch die erforderlichen Arraydaten (bestimmt durch die Arrayzeiger und -aktivierten) in die Anzeigeliste eingegeben. Da die Arrayzeiger und -aktiviert clientseitige Zustandsvariablen sind, wirken sich ihre Werte auf Anzeigelisten aus, wenn die Listen erstellt werden und nicht, wenn die Listen ausgeführt werden.
Hinweis
Die glDrawElements-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 |
|