Dela via


glReadBuffer-funktion

Funktionen glReadBuffer väljer en färgbuffertkälla för pixlar.

Syntax

void WINAPI glReadBuffer(
   GLenum mode
);

Parameterar

läge

En färgbuffert. Godkända värden är GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT och GL_AUX i, där jag är mellan 0 och GL_AUX_BUFFERS 1.

Returvärde

Den här funktionen returnerar inte något värde.

Felkoder

Följande felkoder kan hämtas av funktionen glGetError .

Namn Innebörd
GL_INVALID_ENUM
läget inte var ett av de tolv (eller fler) accepterade värdena.
GL_INVALID_OPERATION
läge angavs en buffert som inte finns.
GL_INVALID_OPERATION
Funktionen anropades mellan ett anrop till glBegin och motsvarande anrop till glEnd.

Anmärkningar

Funktionen glReadBuffer anger en färgbuffert som källa för efterföljande glReadPixels - och glCopyPixels-kommandon . Lägesparametern accepterar ett av tolv eller fler fördefinierade värden. (GL_AUX0 via GL_AUX3 definieras alltid.) I ett fullständigt konfigurerat system GL_FRONT, GL_LEFT och GL_FRONT_LEFT alla namn på bufferten längst fram till vänster, GL_FRONT_RIGHT och GL_RIGHT namnge bufferten längst fram till höger och GL_BACK_LEFT och GL_BACK namnge bufferten längst till vänster.

Dubbelbuffertade konfigurationer med icke-stereo har bara en buffert längst fram till vänster och en buffert till vänster. Enbuffertade konfigurationer har en främre vänster och en främre höger buffert om stereo, och endast en främre vänstra buffert om nonstereo. Det är ett fel att ange en obefintlig buffert till glReadBuffer.

Som standard är läget GL_FRONT i enbuffertade konfigurationer och GL_BACK i dubbelbuffertade konfigurationer.

Följande funktion hämtar information om glReadBuffer:

glGet med argument GL_READ_BUFFER

Kravspecifikation

Krav Värde
Lägsta klient som stöds
Windows 2000 Professional [endast skrivbordsappar]
Lägsta server som stöds
Windows 2000 Server [endast skrivbordsappar]
Rubrik
Gl.h
Bibliotek
Opengl32.lib
DLL
Opengl32.dll

Se även

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels