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

浏览器兼容性

另见