glDrawElements

glDrawElements

Name

glDrawElements - Rendert Primitiven aus einem Datenarray heraus.

Delphi-Spezifikation

procedure glDrawElements(mode : glEnum; count : glSizei; _type : glEnum;
                         const indices : PGLvoid); 

Parameter

mode	Gibt an welcher Primitiven-Type gerendert werden soll. Hier sind die symbolische Konstanten 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 erlaubt.
count	Anzahl der zu rendernden Elemente.
type	Gibt den Typ der Werte in indices an. Muss entweder GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT oder GL_UNSIGNED_INT sein.
indices	Zeiger hinter dem die Indizes hinterlegt sind. Wird ein Buffer Object verwendet, gibt dieser Parameter das Offset im Buffer in Bytes an.

Beschreibung

glDrawElements beschreibt mehrere geometrische Primitiven mit nur sehr wenigen Unteraufrufen. Anstatt also für einzelne Eckpunkte, Normalen, Texturkoordinaten, Kantenflags oder Farbwerte einen eigenen GL-Befehl aufzurufen, kann man hier für Eckpunkte, Normalen, usw. eigene Arrays angeben und nutzen, um mit glDrawElements eine Sequenz von Primitiven mit nur einem Befehl zu rendern.

Wenn glDrawElements aufgerufen wird, nimmt es count Elemente aus den aktivierten Arrays, deren Positionen in indices gespeichert sind, um eine Abfolge geometrischer Primitiven zu erstellen. mode gibt dabei an, welche Art von Primitive konstruiert werden soll und wie diese Arrayelemente Primitiven darstellen. Wenn mehr als ein Array aktiviert wurde, werden diese auch genutzt (Vertexarray, Normalenarray, Farbarray, Texturkoordinatenarray, etc.) Wenn GL_VERTEX_ARRAY nicht aktiviert ist, werden allerdings keine geometrischen Primitiven erstellt.

Vertexattribute, die durch glDrawElements verändert werden, haben nach dem Rücksprung von glDrawElements undefinierte Werte. Wenn z.B. GL_COLOR_ARRAY aktiviert wurde, ist der aktuell gesetze Farbwert nach der Ausführung von glDrawElements undefiniert. Unveränderte Attribute behalten allerdings ihren angegebenen Status.

Der Effekt von glDrawElements ist derselbe wie

 glBegin(''mode'');
     for i := 0 to ''count'' - 1 do begin
         glArrayElement(''indices''[i]);
     end;
 glEnd();

Beispiele

Beispiel 1

oneIndices : ARRAY[0..6] OF GLubyte = (0,  1,  2,  3,  4,  5,  6);
twoIndices : ARRAY[0..5] OF GLubyte = (7,  1,  8,  9, 10, 11);
...
glDrawElements(GL_LINE_STRIP, 7, GL_UNSIGNED_BYTE, @oneIndices);
glDrawElements(GL_LINE_STRIP, 6, GL_UNSIGNED_BYTE, @twoIndices);

Beispiel 2
Ein Array mit Farbwerten und ein Array mit Vertices werden eingebunden, aktiviert und mit einem 16-Bit (entspricht Word) Indexarray über glDrawElements gezeichnet:

glEnableClientState(GL_COLOR_ARRAY);
glEnableClientState(GL_VERTEX_ARRAY);

glColorPointer(4,GL_UNSIGNED_BYTE,0,@Colors[0]); 
glVertexPointer(3,GL_FLOAT,0,@Positions[0]);

glDrawElements(GL_LINE_STRIP, Count, GL_UNSIGNED_SHORT, @Indices[0]);

glDisableClientState(GL_COLOR_ARRAY);
glDisableClientState(GL_VERTEX_ARRAY); 

Hinweise

glDrawElements ist erst ab GL Version 1.1 oder höher nutzbar.

glDrawElements wird in Displaylisten eingebunden, wenn die Funktion also in eine Displayliste kompiliert wird, werden die benötigten Arrayzeiger (welche das sind, wird durch die Arrayzeiger und aktivierten States beschrieben) in die Displayliste kompiliert. Dies geschieht, da die Arrayzeiger und aktivierten States clientseitige States sind, und die Displayliste daher nur bei ihrer Erstellung beeinflussen, nicht jedoch bei ihrer Ausführung.

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn mode keinen gültigen Wert enthält.

GL_INVALID_VALUE wird, generiert wenn count negativ ist.

GL_INVALID_OPERATION wird generiert, wenn glDrawElements in einem glBegin-glEnd Block aufgerufen wird.

Siehe auch

glArrayElement, glEnableClientState, glDisableClientState, glBegin / glEnd, glColorPointer, glDrawArrays, glDrawRangeElements, glEdgeFlagPointer, glFogCoordPointer, glGetPointerv, glGetString, glIndexPointer, glInterleavedArrays, glMultiDrawArrays, glMultiDrawElements, glNormalPointer, glSecondaryColorPointer, glTexCoordPointer, glVertexPointer