glReadBuffer 函式

glReadBuffer 函式會選取圖元的色彩緩衝區來源。

語法

void WINAPI glReadBuffer(
   GLenum mode
);

參數

模式

色彩緩衝區。 接受的值是 GL_FRONT_LEFT、GL_FRONT_RIGHT、GL_BACK_LEFT、GL_BACK_RIGHT、GL_FRONT、GL_BACK、GL_LEFT、GL_RIGHT 和 GL_AUX i，其中 i 介於 0 到 GL_AUX_BUFFERS 1 之間。

返回值

此函式不會傳回值。

錯誤碼

glGetError 函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	mode 不是十二個 （或更多） 接受的值之一。
GL_INVALID_OPERATION	模式 指定了不存在的緩衝區。
GL_INVALID_OPERATION	在 glBegin 呼叫與 glEnd 的對應呼叫之間呼叫函式。

備註

glReadBuffer 函式會將色彩緩衝區指定為後續 glReadPixels 和 glCopyPixels 命令的來源。 mode 參數接受十二個或多個預先定義的值之一。 （GL_AUX0到GL_AUX3總是定義的。在完整設定的系統中，GL_FRONT、GL_LEFT和GL_FRONT_LEFT所有名稱的前端緩衝區、GL_FRONT_RIGHT和GL_RIGHT名稱為右前緩衝區，以及GL_BACK_LEFT和GL_BACK將後端緩衝區命名為左方緩衝區。

非stereo 雙緩衝組態只有左前和左後緩衝區。 單一緩衝組態具有前端和右前緩衝區，如果立體聲，則只有左方緩衝區，如果非立體化，則只有左方緩衝區。 指定 glReadBuffer 不存在的緩衝區是錯誤的。

根據預設， 模式 會在單一緩衝組態中GL_FRONT，並在雙緩衝組態中GL_BACK。

下列函式會擷取 glReadBuffer 的相關信息：

glGet 與自變數GL_READ_BUFFER

需求

要求	價值觀
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
頁首	Gl.h
圖書館	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels