glReadBuffer 函式

  • 發行項

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

語法

void WINAPI glReadBuffer(
   GLenum mode
);

參數

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 不是 12 個 (或多個) 接受值之一。
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將後端緩衝區命名為後方緩衝區。

非星號雙緩衝組態只有左前緩衝區和左後緩衝區。 單一緩衝組態具有前端和右方緩衝區，如果是身歷聲，則只有左方緩衝區，如果是非星號，則只有左方緩衝區。 將不存在的緩衝區指定為 glReadBuffer是錯誤。

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

下列函式會擷取 與 glReadBuffer相關的資訊：

glGet with argument GL_READ_BUFFER

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels