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 //模板缓冲区
- : 一个用于指定需要清除的缓冲区的 GLbitfield 。可能的值有:
错误抛出
如果 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。离线整理了版式、链接和媒体显示。
