Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die glReadBuffer-Funktion wählt eine Farbpufferquelle für Pixel aus.
Syntax
void WINAPI glReadBuffer(
GLenum mode
);
Die Parameter
-
Modus
-
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 ich 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 keine der zwölf (oder mehr) akzeptierten Werte. |
|
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 glReadPixels - und glCopyPixels-Befehle an. Der Modusparameter akzeptiert einen von zwölf oder mehr vordefinierten Werten. (GL_AUX0 bis GL_AUX3 werden immer definiert.) In einem vollständig konfigurierten System geben GL_FRONT, GL_LEFT und GL_FRONT_LEFT allen namen den Front-left-Puffer, GL_FRONT_RIGHT und GL_RIGHT den Front-right-Puffer und GL_BACK_LEFT und GL_BACK den Hintergrundpuffer benennen.
Nichtstereo-Doppelpufferkonfigurationen verfügen nur über einen Front-left- und einen Back-left-Puffer. Einzelpufferkonfigurationen verfügen über einen Front-left- und einen Front-right-Puffer, wenn Stereo und nur ein Front-left-Puffer, wenn nichtstereo. Fehler beim Angeben eines nicht vorhandenen Puffers für glReadBuffer.
Standardmäßig wird der Modus in einzelpufferten Konfigurationen GL_FRONT und in doppelt gepufferten Konfigurationen GL_BACK.
Die folgende Funktion ruft Informationen zu glReadBuffer ab:
glGet mit Argument GL_READ_BUFFER
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindest unterstützter Client |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützter Server (Mindestversion) |
Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile |
|
| Bibliothek |
|
| DLL |
|