glReadBuffer-Funktion

Die glReadBuffer-Funktion wählt eine Farbpufferquelle für Pixel aus.

Syntax

void WINAPI glReadBuffer(
   GLenum mode
);

Parameter

mode

Ein Farbpuffer. Zulässige Werte sind GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT und GL_AUX i, wobei i zwischen 0 und GL_AUX_BUFFERS 1 liegt.

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	der Modus war kein von zwölf (oder mehr) akzeptierten Werten.
GL_INVALID_OPERATION	im Modus wurde ein Puffer angegeben, der nicht vorhanden ist.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glReadBuffer-Funktion gibt einen Farbpuffer als Quelle für nachfolgende befehle glReadPixels und glCopyPixels an. Der mode-Parameter akzeptiert einen von zwölf oder mehr vordefinierten Werten. (GL_AUX0 bis GL_AUX3 sind immer definiert.) In einem vollständig konfigurierten System GL_FRONT, GL_LEFT und GL_FRONT_LEFT alle den Vorder-links-Puffer benennen, GL_FRONT_RIGHT und GL_RIGHT den Vorder-rechts-Puffer benennen, und GL_BACK_LEFT und GL_BACK den Puffer hinten links benennen.

Nichtstereo-Konfigurationen mit doppelter Pufferung verfügen nur über einen Puffer von vorne links und hinten links. Konfigurationen mit einzelgepufferter Puffer verfügen über einen Front-Left-Puffer und einen Front-Right-Puffer,wenn stereo, und nur einen Puffer von vorne links, wenn keinStereo ist. Es ist ein Fehler, einen nicht vorhandenen Puffer für glReadBuffer anzugeben.

Standardmäßig ist der Modus in Konfigurationen mit einer Pufferung GL_FRONT und GL_BACK in doppelt gepufferten Konfigurationen.

Die folgende Funktion ruft Informationen im Zusammenhang mit glReadBuffer ab:

glGet mit Argument GL_READ_BUFFER

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

glCopyPixels

glDrawBuffer

glEnd

glReadPixels