WebGLRenderingContext: clearColor() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.clearColor() 方法是 WebGL API 的一部分,用於指定清除顏色緩衝區時使用的顏色值。

此方法指定了呼叫 clear() 方法時使用的顏色值。這些值將被限制在 0 到 1 之間。

語法

js
clearColor(red, green, blue, alpha)

引數

red

一個 GLclampf,用於指定清除顏色緩衝區時使用的紅色值。預設值為 0。

green

一個 GLclampf,用於指定清除顏色緩衝區時使用的綠色值。預設值為 0。

blue

一個 GLclampf,用於指定清除顏色緩衝區時使用的藍色值。預設值為 0。

alpha

一個 GLclampf,用於指定清除顏色緩衝區時使用的 alpha(透明度)值。預設值為 0。

返回值

無(undefined)。

示例

js
gl.clearColor(1, 0.5, 0.5, 1);

要獲取當前的清除顏色,請查詢 COLOR_CLEAR_VALUE 常量,它會返回一個 Float32Array

js
gl.getParameter(gl.COLOR_CLEAR_VALUE);
// Float32Array[1, 0.5, 0.5, 1]

規範

規範
WebGL 規範
# 5.14.3

瀏覽器相容性

另見