glClear 函式

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

語法

void WINAPI glClear(
   GLbitfield mask
);

mask

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

此函式不會傳回值。

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

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

glClear函式會將視窗的位平面區域設定為glClearColor、glClearIndex、glClearDepth、glClearStencil和glClearAccum先前選取的值。您可以使用 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