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 |
|---|---|
|
mode war kein der zwölf (oder mehr) akzeptierten Werte. |
|
-Modus hat einen Puffer angegeben, der nicht vorhanden ist. |
|
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 |
|
| Bibliothek |
|
| DLL |
|