glReadBuffer, funkcja

Funkcja glReadBuffer wybiera źródło buforu kolorów dla pikseli.

Składnia

void WINAPI glReadBuffer(
   GLenum mode
);

Parametry

tryb

Bufor kolorów. Akceptowane wartości to GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT i GL_AUX i, gdzie GL_AUX_BUFFERS 1.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Kody błędów

Następujące kody błędów można pobrać za pomocą funkcji glGetError .

Nazwa	Znaczenie
GL_INVALID_ENUM	tryb nie był jednym z dwunastu (lub więcej) akceptowanych wartości.
GL_INVALID_OPERATION	tryb określił bufor, który nie istnieje.
GL_INVALID_OPERATION	Funkcja została wywołana między wywołaniem funkcji glBegin a odpowiadającym wywołaniem funkcji glEnd.

Uwagi

Funkcja glReadBuffer określa bufor kolorów jako źródło kolejnych poleceń glReadPixels i glCopyPixels . Parametr mode akceptuje jedną z dwunastu lub więcej wstępnie zdefiniowanych wartości. (GL_AUX0 przez GL_AUX3 są zawsze zdefiniowane). W w pełni skonfigurowanym systemie GL_FRONT, GL_LEFT i GL_FRONT_LEFT wszystkie nazwy buforu z lewej strony frontu, GL_FRONT_RIGHT i GL_RIGHT nazwa buforu prawego frontu oraz GL_BACK_LEFT i GL_BACK nazwa buforu po lewej stronie.

Konfiguracje niestereo z podwójnym buforem mają tylko bufor z przodu w lewo i z tyłu po lewej stronie. Konfiguracje z jednym buforem mają lewy przedni i prawy bufor z przodu, jeśli jest to stereo, i tylko bufor z przodu po lewej stronie, jeśli niestereo. Jest to błąd podczas określania nieistniejących do glReadBuffer.

Domyślnie tryb jest GL_FRONT w konfiguracjach z pojedynczym buforem i GL_BACK w konfiguracjach z podwójnym buforem.

Poniższa funkcja pobiera informacje związane z glReadBuffer:

glGet z argumentem GL_READ_BUFFER

Wymagania

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek	Gl.h
Biblioteka	Opengl32.lib
DLL	Opengl32.dll

Zobacz także

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels