glDrawBuffer 函式

GlDrawBuffer 函式會指定要繪製的色彩緩衝區。

語法

void WINAPI glDrawBuffer(
   GLenum mode
);

參數

mode

使用下列可接受的符號常數,指定要繪製的最多四個色彩緩衝區。

意義
GL _ 無
不會寫入任何色彩緩衝區。
GL _ FRONT _ 左方
只會寫入 front 左色緩衝區。
GL _ 正面 _
只會寫入右上方的色彩緩衝區。
GL _ 向 _ 左復原
只會寫入向左色彩緩衝區。
GL _ 向 _ 右
只會寫入向右色彩緩衝區。
GL _ FRONT
只會寫入左上角和右上角的色彩緩衝區。 如果沒有右邊的色彩緩衝區,則只會寫入 front 左色緩衝區。
GL _ 回
只會寫入向左和向右色彩緩衝區。 如果沒有右邊的色彩緩衝區,則只會寫入向左色彩緩衝區。
GL _ 剩餘
只會寫入左上角和左邊的色彩緩衝區。 如果沒有上一頁的色彩緩衝區,則只會寫入左上角的色彩緩衝區。
GL _ 右邊
只會寫入左右和右邊的色彩緩衝區。 如果沒有右邊的色彩緩衝區,則只會寫入右上方的色彩緩衝區。
GL _ 正面 _ 和 _ 背面
所有前端和背景色彩緩衝區都 (由左上角、右上角、左上角、右) 書寫。 如果沒有背面的色彩緩衝區,則只會寫入左上角和右上角的色彩緩衝區。 如果沒有正確的色彩緩衝區,則只會寫入左上角和左邊的色彩緩衝區。 如果沒有右邊或背面的色彩緩衝區,則只會寫入左上角的色彩緩衝區。
GL _ AUXi
只寫入輔助 *顏色緩衝區,*i 介於0和 GL _ AUX _ 的緩衝區-1 之間。 (GL _ AUX _ 緩衝區不是上限; 請使用 glGet 來查詢可用輔助緩衝區的數目。 )

預設值為單一緩衝內容的 GL _ 前端,而 _ 針對雙重緩衝的內容則會傳回 gl。

傳回值

此函式不會傳回值。

錯誤碼

GlGetError函式可以取出下列錯誤碼。

Name 意義
GL _ 無效 _ 列舉
模式 不是可接受的值。
GL _ 不正確 _ 操作
模式 所指出的緩衝區都不存在。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

當色彩寫入至畫面格緩衝區時,會將其寫入至 glDrawBuffer 所指定的色彩緩衝區。

如果選取了一個以上的色彩緩衝區來進行繪製,則會針對每個顏色緩衝區個別計算並套用混合或邏輯運算,而且可能會在每個緩衝區中產生不同的結果。

Monoscopic 內容只會包含左邊的緩衝區,而 stereoscopic 內容則包含左邊和右邊的緩衝區。 同樣地,單一緩衝的內容只會包含前端緩衝區,而雙重緩衝的內容則包含前端和後端緩衝區。 內容會在 OpenGL 初始化時選取。

這一律是 GL _ AUX i = gl _ AUX0 + i

下列函式會取出與 glDrawBuffer 函數相關的資訊:

glGet 與引數 GL _ 繪圖 _ 緩衝區

具有引數 GL _ AUX _ 緩衝區的 glGet

規格需求

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

另請參閱

glBegin

glBlendFunc

glColorMask

glEnd

glGet

glIndexMask

glLogicOp

glReadBuffer