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函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
mode 不是 12 個 (或多個) 接受值之一。 |
|
模式 指定了不存在的緩衝區。 |
|
函式是在 對 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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|