glDrawElements: Unterschied zwischen den Versionen
Flo (Diskussion | Beiträge) K () |
(Artikel erstellt) |
||
| Zeile 1: | Zeile 1: | ||
| − | { | + | = glDrawElements = |
| + | |||
| + | <br> | ||
| + | == Name == | ||
| + | '''glDrawElements''' - Rendert Primitiven aus einem Datenarray heraus. | ||
| + | |||
| + | <br> | ||
| + | == Delphi-Spezifikation == | ||
| + | procedure '''glDrawElements'''(''mode'' : glEnum; ''count'' : glSizei; ''_type'' : glEnum; const ''indices'' : PGLvoid); | ||
| + | |||
| + | <br> | ||
| + | == Parameter == | ||
| + | |||
| + | {| border="1" rules="all" | ||
| + | ! ''mode'' | ||
| + | | Gibt an welcher [[Primitiv]]en-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. | ||
| + | |} | ||
| + | |||
| + | <br> | ||
| + | == Beschreibung == | ||
| + | '''glDrawElements''' beschreibt mehrere geometrische Primitiven mit nur sehr wenigen Unteraufrufen. Anstatt also für einzelne [[Eckpunkt]]e, [[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'' aufeinanderfolgende Elemente aus den aktivierten Arrays, beginnend bei ''indices'' um eine Abfolge geometrischer [[Primitive]]n zu erstellen. ''mode'' gibt dabei an welche Art von [[Primitive]] konstruiert werden soll und wie diese Arrayelemente [[Primitive]]n darstellen. Wenn mehr als ein Array aktiviert wurde, werden diese auch genutzt (Vertexarray, Normalenarray, Farbarray, Texturkoordinatenarray, etc.) Wenn '''GL_VERTEX_ARRAY''' nicht aktiviert ist, wreden allerdings keine geometrischen [[Primitive]]n 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. | ||
| + | |||
| + | <br> | ||
| + | == 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. | ||
| + | |||
| + | <br> | ||
| + | == 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. | ||
| + | |||
| + | <br> | ||
| + | == Siehe auch == | ||
| + | [[glArrayElement]], [[glColorPointer]], [[glDrawArrays]], [[glEdgeFlagPointer]], [[glGetPointerv]], [[glIndexPointer]], [[glInterleavedArrays]], [[glNormalPointer]], [[glTexCoordPointer]], [[glVertexPointer]] | ||
Version vom 21. Oktober 2004, 11:07 Uhr
Inhaltsverzeichnis
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. |
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 aufeinanderfolgende Elemente aus den aktivierten Arrays, beginnend bei indices 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, wreden 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.
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, glColorPointer, glDrawArrays, glEdgeFlagPointer, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormalPointer, glTexCoordPointer, glVertexPointer
