大网数据广告活动
Web 标准与前端开发

WebGLRenderingContext.clear()

· 52CE 我爱测

WebGL API 的 **`WebGLRenderingContext.clear()`** 方法使用预设值来清空缓冲。

WebGL

WebGL API 的 WebGLRenderingContext.clear() 方法使用预设值来清空缓冲。

预设值可以使用 WebGLRenderingContext.clearColor 、 WebGLRenderingContext.clearDepth 或 WebGLRenderingContext.clearStencil 设置。

裁剪、抖动处理和缓冲写入遮罩会影响 clear() 方法。

句法

void gl.clear(mask);

参数

  • mask
    • : 一个用于指定需要清除的缓冲区的 GLbitfield 。可能的值有:
      • gl.COLOR_BUFFER_BIT //颜色缓冲区
      • gl.DEPTH_BUFFER_BIT //深度缓冲区
      • gl.STENCIL_BUFFER_BIT //模板缓冲区

错误抛出

如果 mask 不是以上列出的值,会抛出 gl.INVALID_ENUM 错误。

返回值

无

示例

clear() 方法可接受复合值,

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 常量。

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

规范

浏览器兼容性

相关内容

  • WebGLRenderingContext.clearColor()
  • WebGLRenderingContext.clearDepth()
  • WebGLRenderingContext.clearStencil()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。