glMultiDrawArrays: Unterschied zwischen den Versionen
(neu erstellt) |
DGLBot (Diskussion | Beiträge) K (Bot: konvertiere/korrigiere <BR>) |
||
| Zeile 3: | Zeile 3: | ||
'''glMultiDrawArrays''' - Erlaubt es mehrere [[Primitive]] auf einmal zu zeichnen. | '''glMultiDrawArrays''' - Erlaubt es mehrere [[Primitive]] auf einmal zu zeichnen. | ||
| − | + | ||
| + | |||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| Zeile 9: | Zeile 10: | ||
''primcount'': TGLsizei); | ''primcount'': TGLsizei); | ||
| − | + | ||
| + | |||
== Parameter == | == Parameter == | ||
| Zeile 29: | Zeile 31: | ||
|} | |} | ||
| − | + | ||
| + | |||
== Beschreibung == | == Beschreibung == | ||
'''glMultiDrawArrays''' definiert mehrere geometrische Primitiven mit sehr wenig Unterfunktionsaufrufen. Anstatt eine OpenGL-Funktion aufzurufen, um jedes einzelne [[glVertex|Vertex]], [[glEdgeFlag|Kantenflag]], jede [[glColor|Farbe]], [[glSecondaryColor|Zweitfarbe]], [[glNormal|Normale]], [[glTexCoord|Textur-]] und [[glFogCoord|Nebelkoordinate]] zu übergeben, kann man getrennte Vertex-, Normalen- und Farb-Arrays vordefinieren und diese benutzen, um eine Folge an Primitiven mit einem einzigen Aufruf von '''glMultiDrawArrays''' zu konstruieren. | '''glMultiDrawArrays''' definiert mehrere geometrische Primitiven mit sehr wenig Unterfunktionsaufrufen. Anstatt eine OpenGL-Funktion aufzurufen, um jedes einzelne [[glVertex|Vertex]], [[glEdgeFlag|Kantenflag]], jede [[glColor|Farbe]], [[glSecondaryColor|Zweitfarbe]], [[glNormal|Normale]], [[glTexCoord|Textur-]] und [[glFogCoord|Nebelkoordinate]] zu übergeben, kann man getrennte Vertex-, Normalen- und Farb-Arrays vordefinieren und diese benutzen, um eine Folge an Primitiven mit einem einzigen Aufruf von '''glMultiDrawArrays''' zu konstruieren. | ||
| Zeile 45: | Zeile 48: | ||
| − | + | ||
| + | |||
== Hinweise == | == Hinweise == | ||
'''glMultiDrawArrays'' ist nur ab GL Version 1.4 oder höher verfügbar. | '''glMultiDrawArrays'' ist nur ab GL Version 1.4 oder höher verfügbar. | ||
Aktuelle Version vom 22. April 2006, 19:22 Uhr
Inhaltsverzeichnis
glMultiDrawArrays
glMultiDrawArrays - Erlaubt es mehrere Primitive auf einmal zu zeichnen.
Delphi-Spezifikation
procedure glMultiDrawArrays(mode: TGLenum; first: PGLint; count: PGLsizei;
primcount: TGLsizei);
Parameter
| Parameter | Beschreibung |
|---|---|
| mode | Bestimmt, welche Primitiven anhand der Vertexe gezeichnet werden sollen. Es können die gleichen Werte wie bei glBegin übergeben werden: 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. |
| first | Zeiger auf mehrere Startindexwerte der aktivierten Arrays. |
| count | Zeiger auf Array, bei dem jedes Element die Anzahl von Indizes angibt, die gerendert werden sollen. |
| primcount | Anzahl der Elemente von first bzw. count. |
Beschreibung
glMultiDrawArrays definiert mehrere geometrische Primitiven mit sehr wenig Unterfunktionsaufrufen. Anstatt eine OpenGL-Funktion aufzurufen, um jedes einzelne Vertex, Kantenflag, jede Farbe, Zweitfarbe, Normale, Textur- und Nebelkoordinate zu übergeben, kann man getrennte Vertex-, Normalen- und Farb-Arrays vordefinieren und diese benutzen, um eine Folge an Primitiven mit einem einzigen Aufruf von glMultiDrawArrays zu konstruieren.
Wenn glMultiDrawArrays ausgeführt wird, verhält sich die Funktion so, als würde sie primcount mal die Funktion glDrawArrays mit mode, count[i] und first[i] als Parameter aufrufen (Wobei i von 0 bis primcount - 1 läuft). D.h. die Funktion benutzt count[i] aufeinanderfolgende Elemente von jedem aktiviertem Array um eine Folge an geometrischen Primitiven zu konstruieren, beginnend mit Element first[i]. mode definiert, welche Art von Primitiven konstruiert wird und wie die Arrayelemente diese Primitiven konstruieren. Falls GL_VERTEX_ARRAY nicht aktiviert ist, werden keine geometrischen Primitiven erzeugt.
Vertex-Attribute, die von glMultiDrawArrays verändert werden, haben einen undefinierten Wert, nachdem der Aufruf von glMultiDrawArrays beendet ist. Ist z.B. GL_COLOR_ARRAY aktiviert, ist der Wert der aktuellen Farbe undefiniert, nachdem glMultiDrawArrays ausgeführt wird. Attribute, die nicht verändert werden, bleiben wohldefiniert.
Der Effekt von glMultiDrawArrays ist derselbe wie
FOR i := 0 TO primcount - 1 DO BEGIN
IF (count[i] > 0)
THEN glDrawArrays(mode, first[i], count[i]);
END;
Hinweise
'glMultiDrawArrays ist nur ab GL Version 1.4 oder höher verfügbar.
Der Befehl glMultiDrawArrays kann in Displaylisten verwendet werden. Dadurch werden alle Daten aus den Arrays in die Liste übernommen.
Fehlermeldungen
- GL_INVALID_VALUE
- primcount hatte einen negativen Wert.
- GL_INVALID_VALUE
- count[i] hatte einen negativen Wert.
- GL_INVALID_ENUM
- mode hatte einen ungültigen Wert.
- GL_INVALID_OPERATION
- glMultiDrawArrays wurde zwischen glBegin und dem dazugehörigen glEnd aufgerufen.
Siehe auch
glArrayElement, glEnableClientState, glDisableClientState, glBegin / glEnd, glColorPointer, glDrawArrays, glDrawElements, glDrawRangeElements, glEdgeFlagPointer, glFogCoordPointer, glGetPointerv, glGetString, glIndexPointer, glInterleavedArrays, glMultiDrawElements, glNormalPointer, glSecondaryColorPointer, glTexCoordPointer, glVertexPointer
