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 |
|---|---|
|
der Modus war kein von zwölf (oder mehr) akzeptierten Werten. |
|
im Modus wurde ein Puffer angegeben, der nicht vorhanden ist. |
|
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 |
|
| Bibliothek |
|
| DLL |
|