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函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
四個已定義位以外的任何位都設定為 遮罩。 |
|
在 對 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
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|