glClear 函式

glClear函式會將緩衝區清除為預設值。

語法

void WINAPI glClear(
   GLbitfield mask
);

參數

mask

遮罩的位 OR 運算子,表示要清除的緩衝區。 四個遮罩如下所示。

意義
GL_COLOR_BUFFER_BIT
目前為色彩寫入啟用的緩衝區。
GL_DEPTH_BUFFER_BIT
深度緩衝區。
GL_ACCUM_BUFFER_BIT
累積緩衝區。
GL_STENCIL_BUFFER_BIT
樣板緩衝區。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱 意義
GL_INVALID_VALUE
四個已定義位以外的任何位都設定為 遮罩
GL_INVALID_OPERATION
對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

glClear函式會將視窗的位平面區域設定為glClearColorglClearIndexglClearDepthglClearStencilglClearAccum先前選取的值。 您可以使用 glDrawBuffer一次選取多個緩衝區,以同時清除多個色彩緩衝區。

圖元擁有權測試、剪刀測試、刪除和緩衝區寫入遮罩會影響 glClear的作業。 剪刀方塊會系結清除的區域。 glClear函式會忽略 Alpha 函式、混合函式、邏輯作業、stenciling、紋理對應和z緩衝處理。

glClear函式會採用單一引數 (mask) ,這是數個值的位 OR,指出要清除的緩衝區。

清除每個緩衝區的值取決於該緩衝區的清除值設定。

如果緩衝區不存在,則指向該緩衝區的 glClear 呼叫沒有任何作用。

下列函式會擷取 與 glClear相關的資訊:

glGet 與引數GL_ACCUM_CLEAR_VALUE

glGet 與引數GL_DEPTH_CLEAR_VALUE

glGet with argument GL_INDEX_CLEAR_VALUE

glGet 與引數GL_COLOR_CLEAR_VALUE

glGet 與引數GL_STENCIL_CLEAR_VALUE

規格需求

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

另請參閱

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor