WebGLRenderingContext: clear() 方法

基线 广泛可用

此功能非常成熟，可在许多设备和浏览器版本上运行。它从 2015 年 7 月.

**WebGLRenderingContext.clear()** 方法是 WebGL API 的一部分，用于将缓冲区清除为预设值。

可以使用 clearColor()、clearDepth() 或 clearStencil() 设置预设值。

剪切框、抖动和缓冲区写掩码会影响 clear() 方法。

语法

js
clear(mask)

参数

mask

一个 GLbitfield 按位或掩码，指示要清除的缓冲区。可能的取值包括

  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

返回值

无 (undefined).

异常

如果 mask 不是列出的可能值之一，则会抛出 gl.INVALID_ENUM 错误。

示例

clear() 方法接受多个值。

js
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);

要获取当前清除值，请查询 COLOR_CLEAR_VALUE、DEPTH_CLEAR_VALUE 和 STENCIL_CLEAR_VALUE 常量。

js
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);

规范

规范
WebGL 规范
# 5.14.11

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅