glReadBuffer-Funktion

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

Syntax

void WINAPI glReadBuffer(
   GLenum mode
);

Parameter

mode

Ein Farbpuffer. Akzeptierte 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
mode war kein der zwölf (oder mehr) akzeptierten Werte.
UNGÜLTIGER _ _ GL-VORGANG
-Modus hat einen Puffer angegeben, der nicht vorhanden ist.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Hinweise

Die glReadBuffer-Funktion gibt einen Farbpuffer als Quelle für nachfolgende glReadPixels- und glCopyPixels-Befehle 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 nennen GL FRONT, GL LEFT und GL FRONT LEFT den Puffer ganz links vorne, GL FRONT RIGHT und GL RIGHT den Puffer rechts vorn und GL BACK LEFT und GL BACK den _ _ _ _ _ _ _ _ _ _ Back-Left-Puffer.

Nichtstereo-Konfigurationen mit doppelter Pufferung verfügen nur über einen Linken-Front-End- und einen back-left-Puffer. Einzelpufferkonfigurationen verfügen über einen Front-Left-Puffer und einen Front-Right-Puffer bei Stereo und nur über einen puffer von links nach vorn, wenn nonstereo. Es ist ein Fehler, einen nicht vorhandenen Puffer für glReadBuffer anzugeben.

Standardmäßig ist der Modus GL FRONT in Einzelpufferkonfigurationen und GL BACK in doppelt _ _ gepufferten Konfigurationen.

Die folgende Funktion ruft Informationen im Zusammenhang mit glReadBuffer ab:

glGet mit dem 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

Siehe auch

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels