glDrawRangeElements - Versionsgeschichte

Glawesome: /* Siehe auch */

2014-02-21T16:58:27Z

‎Siehe auch

Openglerf: /* Fehlermeldungen */

2012-03-11T15:13:17Z

‎Fehlermeldungen

Shaijan: Kategorie GL3 hinzugefügt

2011-06-15T20:10:22Z

Kategorie GL3 hinzugefügt

Thoronador: Kategorisierung unter GL1.2

2008-06-03T22:02:30Z

Kategorisierung unter GL1.2

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:19:49Z

Bot: konvertiere/korrigiere

Dj3hut1: an manpages angepasst

2006-04-10T09:21:42Z

an manpages angepasst

Dj3hut1: Extension-Hinweis hinzugefügt

2006-04-06T14:46:00Z

Extension-Hinweis hinzugefügt

Dj3hut1: neu erstellt

2006-04-06T14:37:26Z

neu erstellt

Neue Seite

= glDrawRangeElements =

 
== Name ==
'''glDrawRangeElements''' - Rendert Primitiven aus einem Daten-Array mithilfe eines Index-Arrays.

 
== Delphi-Spezifikation ==
procedure '''glDrawRangeElements'''(''mode'' : glEnum; start: TGLuint; _end: TGLuint; ''count'' : glSizei;
''_type'' : glEnum; const ''indices'' : PGLvoid);

 
== Parameter ==

{| border="1" rules="all"
! ''mode''
| Gibt an, welcher [[Primitiv]]en-Typ 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.
|-
! ''start''
| Startwert im Index-Array.
|-
! ''_end''
| Endwert im Index-Array.
|-
! ''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 ==
'''glDrawRangeElements''' verhält sich genauso wie der Befehl [[glDrawElements]], mit dem Unterschied, dass man die Werte des Index-Arrays mit den zusätzlichen Parametern ''start'' und ''_end'' einschränken kann.
Es werden nur dann Primitiven gerendert, falls sich die Indizes ihrer Daten zwischen dem angegebenem Start- und Endwert (einschliesslich dieser) befinden.

 
== Hinweise ==
'''glDrawRangeElements''' ist erst ab GL Version 1.2 oder höher nutzbar.

Nicht alle Werte zwischen ''start'' und ''_end'' müssen vom Index-Array referenziert werden.
Allerdings kann eine nicht optimale Indexmenge zur Reduzierung der Performance führen, da nutzlose Vertices an die Grafikkarte gesendet werden.

'''glDrawRangeElements''' 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.

Es sollte darauf geachtet werden, dass der Wert von ''count'' nicht grösser als der von der OpenGL-Implementierung maximal zulässige Wert für Vertex-Arrays ist (abfragbar mit [[glGetIntegerv]]('''GL_MAX_ELEMENTS_VERTICES''')), da es ansonsten zu Performance-Einbußen kommen kann.

Ebenso sollte ''_end'' - ''start'' + 1 nicht grösser sein als der Wert, den man mit [[glGetIntegerv]]('''GL_MAX_ELEMENTS_INDICES''')) abfragen kann.

 
== 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 '''glDrawRangeElements''' in einem [[glBegin]]-[[glEnd]] Block aufgerufen wird.

'''GL_INVALID_VALUE''' wird generiert, wenn ''_end'' < ''begin'' ist.

Abhängig von der OpenGL-Implementierung kann ein Fehler generiert werden, wenn die Werte des Index-Arrays außerhalb des Bereichs [''begin'', ''_end''] liegen.

 
== Siehe auch ==
[[glArrayElement]], [[glColorPointer]], [[glDrawArrays]], [[glDrawElements]], [[glEdgeFlagPointer]], [[glGetPointerv]], [[glIndexPointer]], [[glInterleavedArrays]], [[glMultiDrawArrays]], [[glMultiDrawElements]], [[glNormalPointer]], [[glTexCoordPointer]], [[glVertexPointer]]

[[Kategorie:GL|DrawRangeElements]]

@@ Zeile 81: / Zeile 81: @@
 [[Kategorie:GL|DrawRangeElements]]
 [[Kategorie:GL1.2|DrawRangeElements]]
-[[Kategorie:GL3]]
+[[Kategorie:GL3|DrawRangeElements]]

@@ Zeile 59: / Zeile 59: @@
 == Fehlermeldungen ==
-Es ist ein Fehler für Indizes ausserhalb des Bereiches [''start'', ''_end''] zu liegen, aber Implementationen müssen diesen Fall nicht überprüfen. Solche Indizes verursachen implementationsabhängiges Verhalten.
+Es ist ein Fehler für Indizes außerhalb des Bereiches [''start'', ''_end''] zu liegen, aber Implementationen müssen diesen Fall nicht überprüfen. Solche Indizes verursachen implementationsabhängiges Verhalten.
 '''GL_INVALID_ENUM''' wird generiert, wenn ''mode'' keinen gültigen Wert enthält.
@@ Zeile 68: / Zeile 68: @@
 '''GL_INVALID_VALUE''' wird generiert, wenn ''_end'' < ''begin'' ist.
 == Zugehörige Wertrückgaben ==

← Nächstältere Version		Version vom 15. Juni 2011, 20:10 Uhr
Zeile 83:		Zeile 83:
	[[Kategorie:GL\|DrawRangeElements]]		[[Kategorie:GL\|DrawRangeElements]]
	[[Kategorie:GL1.2\|DrawRangeElements]]		[[Kategorie:GL1.2\|DrawRangeElements]]
		+	[[Kategorie:GL3]]

@@ Zeile 9: / Zeile 9: @@
 == Delphi-Spezifikation ==
-  procedure '''glDrawRangeElements'''(''mode'' : glEnum; ''start'': TGLuint;
+  procedure '''glDrawRangeElements'''(''mode'': GLenum; ''start'': TGLuint;
-                                ''_end'': TGLuint; ''count'' : glSizei;
+                                ''_end'': TGLuint; ''count'': GLSizei;
-                                ''_type'' : glEnum; '''const''' ''indices'' : PGLvoid);
+                                ''_type'': GLenum; '''const''' ''indices'': PGLvoid);
 == Parameter ==
 {| border="1" rules="all"
 ! ''mode''
@@ Zeile 36: / Zeile 35: @@
 | Zeiger auf Speicher, in dem die Indizes liegen.
 |}
@@ Zeile 57: / Zeile 55: @@
 '''glDrawRangeElements''' wird in [[Displaylisten]] eingebunden. Falls '''glDrawRangeElements''' in eine Displayliste hineinkommt, kommen auch die zugehörigen Array-Daten (festgelegt durch die Arrayzeiger und -aktivierungen) in die Displayliste mithinein. Da die Arrayzeiger und -aktivierungen clientseitige Zustände sind, beeinflussen ihre Werte Displaylisten nur, wenn die Listen erzeugt, jedoch nicht wenn die Listen ausgeführt werden.
-<br>
 == Fehlermeldungen ==
-Es ist ein Fehler für Indizes ausserhalb des Bereiches [''start'', ''_end''] zu liegen, aber Implementationen müssen diesen Fall nicht überprüfen. Solche Indizes verursachen Implementation-abhängiges Verhalten.
+Es ist ein Fehler für Indizes ausserhalb des Bereiches [''start'', ''_end''] zu liegen, aber Implementationen müssen diesen Fall nicht überprüfen. Solche Indizes verursachen implementationsabhängiges Verhalten.
 '''GL_INVALID_ENUM''' wird generiert, wenn ''mode'' keinen gültigen Wert enthält.
@@ Zeile 66: / Zeile 65: @@
 '''GL_INVALID_VALUE''' wird generiert, wenn ''count'' negativ ist.
-'''GL_INVALID_OPERATION''' wird generiert, wenn '''glDrawRangeElements''' in einem [[glBegin]]-[[glEnd]] Block aufgerufen wird.
+'''GL_INVALID_OPERATION''' wird generiert, wenn '''glDrawRangeElements''' in einem [[glBegin]]-[[glEnd]]-Block aufgerufen wird.
 '''GL_INVALID_VALUE''' wird generiert, wenn ''_end'' < ''begin'' ist.
@@ Zeile 72: / Zeile 71: @@
-== Zugehörige Wertrückgaben ==
+[[glGet]] mit Token [[glGet#GL_MAX_ELEMENTS_INDICES|GL_MAX_ELEMENTS_INDICES]]
@@ Zeile 83: / Zeile 82: @@
 [[Kategorie:GL|DrawRangeElements]]

@@ Zeile 1: / Zeile 1: @@
 = glDrawRangeElements =
-<br>
 == Name ==
 '''glDrawRangeElements''' - Rendert Primitiven aus einem Daten-Array mithilfe eines Index-Arrays.
-<br>
 == Delphi-Spezifikation ==
   procedure '''glDrawRangeElements'''(''mode'' : glEnum; ''start'': TGLuint;
@@ Zeile 11: / Zeile 13: @@
                                 ''_type'' : glEnum; '''const''' ''indices'' : PGLvoid);
-<br>
 == Parameter ==
@@ Zeile 35: / Zeile 38: @@
-<br>
 == Beschreibung ==
 '''glDrawRangeElements''' ist eine eingeschränkte Form von [[glDrawElements]]. ''mode'', ''start'', ''_end'' und ''count'' stimmen mit den entsprechenden Argumenten von [[glDrawElements]] überein, mit der zusätzlichen Bedingung, dass alle Werte im Array ''indices'' im Bereich [''start'', ''_end''] liegen müssen.
@@ Zeile 45: / Zeile 49: @@
 Vertex-Attribute, die durch [[glDrawRangeElements]] verändert werden, haben einen undefinierten Wert nachdem [[glDrawRangeElements]] beendet ist. Z.B., falls '''GL_COLOR_ARRAY''' aktiviert ist, ist der Wert der aktuell gesetzten Farbe undefiniert nachdem [[glDrawRangeElements]] ausgeführt wurde. Attribute, die nicht verändert wurden, behalten ihre ursprünglichen Werte.
-<br>
 == Hinweise ==
 '''glDrawRangeElements''' ist erst ab GL Version 1.2 oder höher nutzbar.
@@ Zeile 65: / Zeile 70: @@
 '''GL_INVALID_VALUE''' wird generiert, wenn ''_end'' < ''begin'' ist.
-<br>
 == Zugehörige Wertrückgaben ==
@@ Zeile 71: / Zeile 77: @@
 [[glGet]] mit Token [[glGet#GL_MAX_ELEMENTS_INDICES|GL_MAX_ELEMENTS_INDICES]]<br>
-<br>
 == Siehe auch ==
 [[glArrayElement]], [[glColorPointer]], [[glDrawArrays]], [[glDrawElements]], [[glEdgeFlagPointer]], [[glFogCoordPointer]], [[glGetPointerv]], [[glIndexPointer]], [[glInterleavedArrays]], [[glMultiDrawArrays]], [[glMultiDrawElements]], [[glNormalPointer]], [[glSecondaryColorPointer]], [[glTexCoordPointer]], [[glVertexPointer]]
 [[Kategorie:GL|DrawRangeElements]]

@@ Zeile 7: / Zeile 7: @@
 <br>
 == Delphi-Spezifikation ==
-  procedure '''glDrawRangeElements'''(''mode'' : glEnum; start: TGLuint; _end: TGLuint; ''count'' : glSizei;
+  procedure '''glDrawRangeElements'''(''mode'' : glEnum; ''start'': TGLuint;
-                                ''_type'' : glEnum; const ''indices'' : PGLvoid);
+                               ''_end'': TGLuint; ''count'' : glSizei;
 <br>
@@ Zeile 18: / Zeile 19: @@
 |-
 ! ''start''
-| Startwert im Index-Array.
+| Kleinster Array-Index in ''indices''.
 |-
 ! ''_end''
-| Endwert im Index-Array.
+| Grösster Array-Index in ''indices''.
 |-
 ! ''count''
@@ Zeile 30: / Zeile 31: @@
 |-
 ! ''indices''
-| Zeiger, hinter dem die Indizes hinterlegt sind.
+| Zeiger auf Speicher, in dem die Indizes liegen.
 |}
@@ Zeile 36: / Zeile 37: @@
 <br>
 == Beschreibung ==
-'''glDrawRangeElements''' verhält sich genauso wie der Befehl [[glDrawElements]], mit dem Unterschied, dass man die Werte des Index-Arrays mit den zusätzlichen Parametern ''start'' und ''_end'' einschränken kann.
+'''glDrawRangeElements''' ist eine eingeschränkte Form von [[glDrawElements]]. ''mode'', ''start'', ''_end'' und ''count'' stimmen mit den entsprechenden Argumenten von [[glDrawElements]] überein, mit der zusätzlichen Bedingung, dass alle Werte im Array ''indices'' im Bereich [''start'', ''_end''] liegen müssen.
-Es werden nur dann Primitiven gerendert, falls sich die Indizes ihrer Daten zwischen dem angegebenem Start- und Endwert (einschliesslich dieser) befinden.
 <br>
@@ Zeile 45: / Zeile 51: @@
 Ersetzt die Extension [[GL_EXT_draw_range_elements]].
-Nicht alle Werte zwischen ''start'' und ''_end'' müssen vom Index-Array referenziert werden.
+'''glDrawRangeElements''' wird in [[Displaylisten]] eingebunden. Falls '''glDrawRangeElements''' in eine Displayliste hineinkommt, kommen auch die zugehörigen Array-Daten (festgelegt durch die Arrayzeiger und -aktivierungen) in die Displayliste mithinein. Da die Arrayzeiger und -aktivierungen clientseitige Zustände sind, beeinflussen ihre Werte Displaylisten nur, wenn die Listen erzeugt, jedoch nicht wenn die Listen ausgeführt werden.
 <br>
 == Fehlermeldungen ==
 '''GL_INVALID_ENUM''' wird generiert, wenn ''mode'' keinen gültigen Wert enthält.
@@ Zeile 67: / Zeile 65: @@
 '''GL_INVALID_VALUE''' wird generiert, wenn ''_end'' < ''begin'' ist.
-Abhängig von der OpenGL-Implementierung kann ein Fehler generiert werden, wenn die Werte des Index-Arrays außerhalb des Bereichs [''begin'', ''_end''] liegen.
+<br>
 <br>
 == Siehe auch ==
-[[glArrayElement]], [[glColorPointer]], [[glDrawArrays]], [[glDrawElements]], [[glEdgeFlagPointer]], [[glGetPointerv]], [[glIndexPointer]], [[glInterleavedArrays]], [[glMultiDrawArrays]], [[glMultiDrawElements]], [[glNormalPointer]], [[glTexCoordPointer]], [[glVertexPointer]]
+[[glArrayElement]], [[glColorPointer]], [[glDrawArrays]], [[glDrawElements]], [[glEdgeFlagPointer]], [[glFogCoordPointer]], [[glGetPointerv]], [[glIndexPointer]], [[glInterleavedArrays]], [[glMultiDrawArrays]], [[glMultiDrawElements]], [[glNormalPointer]], [[glSecondaryColorPointer]], [[glTexCoordPointer]], [[glVertexPointer]]
 [[Kategorie:GL|DrawRangeElements]]