glReadBuffer: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (GlReadBuffer wurde nach glReadBuffer verschoben)
(Siehe auch)
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 1: Zeile 1:
 
= glReadBuffer =
 
= glReadBuffer =
  
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
 
'''glReadBuffer''' gibt den Quellfarbpuffer an, aus dem Pixeldaten gelesen werden sollen.
 
'''glReadBuffer''' gibt den Quellfarbpuffer an, aus dem Pixeldaten gelesen werden sollen.
  
<br>
+
 
 +
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
 
  '''procedure''' glReadBuffer(''mode'': TGLenum);
 
  '''procedure''' glReadBuffer(''mode'': TGLenum);
  
<br>
+
 
 +
 
 
== Parameter ==
 
== Parameter ==
 
<table border=1 rules=all>
 
<table border=1 rules=all>
Zeile 22: Zeile 25:
 
</table>
 
</table>
  
<br>
+
 
 +
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
Zeile 54: Zeile 58:
 
: Nur der '''i'''te Hilfsfarbpuffer wird beschrieben.
 
: Nur der '''i'''te Hilfsfarbpuffer wird beschrieben.
  
<br>
+
 
 +
 
 
== Hinweise ==
 
== Hinweise ==
 
Es ist ein Fehler einen nichtexistenten [[Farbpuffer]] als Parameter zu übergeben.
 
Es ist ein Fehler einen nichtexistenten [[Farbpuffer]] als Parameter zu übergeben.
Zeile 68: Zeile 73:
 
Es gilt immer: '''GL_AUX'''i = '''GL_AUX0''' + i
 
Es gilt immer: '''GL_AUX'''i = '''GL_AUX0''' + i
  
<br>
+
 
 +
 
  
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
Zeile 75: Zeile 81:
 
GL_INVALID_OPERATION wird generiert wenn '''glReadBuffer''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
 
GL_INVALID_OPERATION wird generiert wenn '''glReadBuffer''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
  
<br>
+
 
 +
 
  
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
 
[[glGet]] mit Token [[glGet#GL_READ_BUFFER|GL_READ_BUFFER]]<br>
 
[[glGet]] mit Token [[glGet#GL_READ_BUFFER|GL_READ_BUFFER]]<br>
  
<br>
+
 
 +
 
  
 
== Siehe auch ==
 
== Siehe auch ==
Zeile 86: Zeile 94:
  
 
[[Kategorie:GL|DrawBuffer]]
 
[[Kategorie:GL|DrawBuffer]]
 +
[[Kategorie:GL1.0]]

Aktuelle Version vom 16. April 2007, 00:29 Uhr

glReadBuffer

Name

glReadBuffer gibt den Quellfarbpuffer an, aus dem Pixeldaten gelesen werden sollen.


Delphi-Spezifikation

procedure glReadBuffer(mode: TGLenum);


Parameter

mode Spezifiziert bis zu vier Farbpuffer aus denen gelesen werden soll. Akzeptiert werden folgende symbolische Konstanten:

GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT und GL_AUXi wobei i zwischen 0 und GL_AUX_BUFFERS-1 liegen kann. (GL_AUX_BUFFERS ist nicht die obere Grenze. Benutzen Sie glGet um die Anzahl der vorhandenen Hilfspuffer (Aux-Buffer) zu bestimmen.)


Vorgabewert ist GL_FRONT für einfach gepufferte (single buffered) Kontexte und GL_BACK für doppelt gepufferte Kontexte. (siehe Doppelpufferung)



Beschreibung

glReadBuffer gibt an, aus welchem Farbpuffer die Daten für glReadPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D und glCopyPixels gelesen werden.

Wenn Farben aus dem Framebuffer gelesen werden, wird der Farbpuffer, der mittels glReadBuffer angegeben wurde als Quelle benutzt.

Die Konstanten haben folgende Bedeutung:

GL_FRONT_LEFT GL_FRONT GL_LEFT

Nur der vordere linke Farbpuffer wird als Quelle genutzt.


GL_FRONT_RIGHT GL_RIGHT

Nur der vordere rechte Farbpuffer wird als Quelle genutzt.


GL_BACK_LEFT GL_BACK

Nur der hintere linke Farbpuffer wird als Quelle genutzt.


GL_BACK_RIGHT

Nur der hintere rechte Farbpuffer wird als Quelle genutzt.


GL_AUXi

Nur der ite Hilfsfarbpuffer wird beschrieben.


Hinweise

Es ist ein Fehler einen nichtexistenten Farbpuffer als Parameter zu übergeben.


Monoskopische Kontexte besitzen nur linke Buffer.
Stereoskopische Kontexte besitzen linke und rechte Buffer.
Einfach gepufferte Kontexte besitzen nur Frontpuffer.
Doppelt gepufferte Kontexte besitzen Front- und Backpuffer.

Der Kontext wird bei der Initialisierung der GL erstellt.

Es gilt immer: GL_AUXi = GL_AUX0 + i



Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn mode ein ungültiger Wert übergeben wird.
GL_INVALID_OPERATION wird generiert wenn keiner der in mode übergebenen Puffer existiert.
GL_INVALID_OPERATION wird generiert wenn glReadBuffer innerhalb eines glBegin-glEnd Blocks aufgerufen wird.



Zugehörige Wertrückgaben

glGet mit Token GL_READ_BUFFER



Siehe auch

glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D, glDrawBuffer, glReadPixels