glReadBuffer – funkce

Funkce glReadBuffer vybere zdroj barevné vyrovnávací paměti pro pixely.

Syntaxe

void WINAPI glReadBuffer(
   GLenum mode
);

Parametry

režimu

Barevná vyrovnávací paměť. Přijaté hodnoty jsou GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT a GL_AUX i, kde je mezi 0 a GL_AUX_BUFFERS 1.

Návratová hodnota

Tato funkce nevrací hodnotu.

Kódy chyb

Následující kódy chyb lze načíst funkcí glGetError .

Název	Význam
GL_INVALID_ENUM	režim nebyl jednou z dvanácti (nebo více) přijatých hodnot.
GL_INVALID_OPERATION	byl zadán vyrovnávací paměť, která neexistuje.
GL_INVALID_OPERATION	Funkce byla volána mezi voláním glBegin a odpovídajícím voláním glEnd.

Poznámky

Funkce glReadBuffer určuje vyrovnávací paměť barev jako zdroj pro následné příkazy glReadPixels a glCopyPixels . Parametr režimu přijímá jednu z dvanácti nebo více předdefinovaných hodnot. (GL_AUX0 prostřednictvím GL_AUX3 jsou vždy definovány.) V plně nakonfigurovaném systému, GL_FRONT, GL_LEFT a GL_FRONT_LEFT všechny názvy front-left buffer, GL_FRONT_RIGHT a GL_RIGHT pojmenovat front-right vyrovnávací paměť a GL_BACK_LEFT a GL_BACK pojmenovat back-left vyrovnávací paměť.

Konfigurace nestereo s dvojitou vyrovnávací pamětí mají pouze levou přední a zadní vyrovnávací paměť. Konfigurace s jednou vyrovnávací pamětí mají přední levou a přední pravou vyrovnávací paměť, pokud stereo, a pouze přední levou vyrovnávací paměť, pokud není stereo. Jedná se o chybu při zadání neexistující vyrovnávací paměti pro glReadBuffer.

Ve výchozím nastavení je režim GL_FRONT v konfiguracích s jednou vyrovnávací pamětí a GL_BACK v konfiguracích s dvojitou vyrovnávací pamětí.

Následující funkce načte informace související s glReadBuffer:

glGet s argumentem GL_READ_BUFFER

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	Gl.h
Knihovna	Opengl32.lib
Knihovna dll	Opengl32.dll

Viz také

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels