glDrawBuffer-Funktion

Die glDrawBuffer-Funktion gibt an, in welche Farbpuffer gezeichnet werden soll.

Syntax

void WINAPI glDrawBuffer(
   GLenum mode
);

Parameter

mode

Gibt bis zu vier Farbpuffer an, in die mit den folgenden zulässigen symbolischen Konstanten gezeichnet werden soll.

Wert Bedeutung
GL _ NONE
Es werden keine Farbpuffer geschrieben.
GL _ FRONT _ LEFT
Es wird nur der Farbpuffer links vorn geschrieben.
GL _ FRONT _ RIGHT
Es wird nur der Rechts-Rechts-Puffer geschrieben.
GL _ ZURÜCK _ LINKS
Es wird nur der Hintergrund-Links-Farbpuffer geschrieben.
GL _ ZURÜCK _ RECHTS
Es wird nur der Hintergrund-rechts-Farbpuffer geschrieben.
GL _ FRONT
Es werden nur die Farbpuffer "front-left" und "front-right" geschrieben. Wenn kein Farbpuffer rechts von vorne vorn angezeigt wird, wird nur der Puffer für die linke Frontfarbe geschrieben.
GL _ BACK
Es werden nur die Farbpuffer "zurück links" und "zurück rechts" geschrieben. Wenn kein Hintergrund-rechts-Farbpuffer vorüber ist, wird nur der Hintergrund-Links-Farbpuffer geschrieben.
GL _ LEFT
Es werden nur die Farbpuffer "front-left" und "back-left" geschrieben. Wenn kein Hintergrund-Links-Farbpuffer vorüber ist, wird nur der Linke-Hintergrund-Farbpuffer geschrieben.
GL _ RIGHT
Es werden nur die Farbpuffer "front-right" und "back-right" geschrieben. Wenn kein Farbpuffer rechts nach rechts angezeigt wird, wird nur der Rechts-Rechts-Puffer geschrieben.
GL _ FRONT _ AND _ BACK
Alle Vorder- und Hintergrundfarbpuffer (front-left, front-right, back-left, back-right) werden geschrieben. Wenn es keine Hintergrundfarbpuffer gibt, werden nur die Farbpuffer "front-left" und "front-right" geschrieben. Wenn es keine rechten Farbpuffer gibt, werden nur die Farbpuffer von vorn links und zurück links geschrieben. Wenn keine Rechts- oder Hintergrundfarbpuffer angezeigt werden, wird nur der Farbpuffer links vorn geschrieben.
GL _ AUXi
Es wird nur der zusätzliche Farbpuffer i geschrieben. i liegt zwischen 0 und GL _ AUX _ BUFFERS - 1. (GL) _ AUX BUFFERS ist nicht die Obergrenze. Verwenden Sie glGet, um die Anzahl der verfügbaren _ Hilfspuffer abfragt.)

Der Standardwert ist GL _ FRONT für Einzelpufferkontexte und GL BACK für doppelt _ gepufferte Kontexte.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ INVALID _ ENUM
mode war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
Keiner der vom Modus angegebenen Puffer war vorhanden.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Wenn Farben in den Framepuffer geschrieben werden, werden sie in die von glDrawBuffer angegebenen Farbpuffer geschrieben.

Wenn mehr als ein Farbpuffer zum Zeichnen ausgewählt ist, werden Blending- oder logische Vorgänge unabhängig für jeden Farbpuffer berechnet und angewendet und können in jedem Puffer unterschiedliche Ergebnisse erzeugen.

Monotone Kontexte enthalten nur linke Puffer, und stereotone Kontexte enthalten sowohl linke als auch rechte Puffer. Ebenso enthalten einzelpufferte Kontexte nur Frontpuffer, und doppelt gepufferte Kontexte enthalten sowohl Front- als auch Backpuffer. Der Kontext wird bei der OpenGL-Initialisierung ausgewählt.

Es ist immer der Fall, dass GL _ AUX i = GL _ AUX0 + i ist.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit der glDrawBuffer-Funktion ab:

glGet mit dem Argument GL _ DRAW _ BUFFER

glGet mit argument GL _ AUX _ BUFFERS

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glBlendFunc

glColorMask

glEnd

glGet

glIndexMask

glLogicOp

glReadBuffer