glReadBuffer

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