glReadBuffer függvény

A glReadBuffer függvény a képpontok színpufferforrását választja ki.

Szemantika

void WINAPI glReadBuffer(
   GLenum mode
);

Paraméterek

mód

Egy színpuffer. Az elfogadott értékek a következők: GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT és GL_AUX i, ahol 0 és GL_AUX_BUFFERS 1 között van.

Visszaadott érték

Ez a függvény nem ad vissza értéket.

Hibakódok

A glGetError függvény a következő hibakódokat tudja lekérni.

Név	Értelmezés
GL_INVALID_ENUM	módban nem szerepelt a tizenkét (vagy több) elfogadott érték egyike.
GL_INVALID_OPERATION	a mód olyan puffert adott meg, amely nem létezik.
GL_INVALID_OPERATION	A függvény a glBegin hívása és a glEnd felé irányuló megfelelő hívás között lett meghívva.

Megjegyzések

A glReadBuffer függvény egy színpuffert ad meg a glReadPixels és a glCopyPixels parancsok forrásaként. A módparaméter tizenkét vagy több előre definiált érték egyikét fogadja el. (GL_AUX0 GL_AUX3 mindig definiálva vannak.) Egy teljes körűen konfigurált rendszerben GL_FRONT, GL_LEFT és GL_FRONT_LEFT az összes nevet az előtér-bal puffernek, GL_FRONT_RIGHT és GL_RIGHT nevezze el az előtér jobb oldali pufferét, GL_BACK_LEFT és GL_BACK nevezze el a bal oldali puffert.

A nem kétpufferes konfigurációk csak előtér-balra és háttérbeli pufferrel rendelkeznek. Az egypufferes konfigurációk előtér-bal és előtér-jobb oldali pufferrel rendelkeznek, ha sztereó, és csak előtér-bal pufferrel, ha nem. Hiba, ha nem létező puffert ad meg a glReadBufferhez.

Alapértelmezés szerint a mód egypufferes konfigurációkban GL_FRONT, a kétpufferes konfigurációkban pedig GL_BACK.

Az alábbi függvény a glReadBuffer szolgáltatással kapcsolatos információkat kéri le:

glGet argumentummal GL_READ_BUFFER

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows 2000 Professional [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows 2000 Server [csak asztali alkalmazások]
Fejléc	Gl.h
Könyvtár	Opengl32.lib
DLL	Opengl32.dll

Lásd még

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels