WebGLRenderingContext: colorMask() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

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

WebGLRenderingContext.colorMask() 方法是 WebGL API 的一部分,用于在绘制或渲染到 WebGLFramebuffer 时,设置启用或禁用哪些颜色分量。

语法

js
colorMask(red, green, blue, alpha)

参数

red

一个 GLboolean,指定是否允许写入红色颜色分量到帧缓冲区。默认值为 true

green

一个 GLboolean,指定是否允许写入绿色颜色分量到帧缓冲区。默认值为 true

blue

一个 GLboolean,指定是否允许写入蓝色颜色分量到帧缓冲区。默认值为 true

alpha

一个 GLboolean,指定是否允许写入 alpha(透明度)分量到帧缓冲区。默认值为 true

返回值

无(undefined)。

示例

js
gl.colorMask(true, true, true, false);

要获取当前的颜色蒙版,请查询 COLOR_WRITEMASK 常量,它会返回一个 Array

js
gl.getParameter(gl.COLOR_WRITEMASK);
// [true, true, true, false]

规范

规范
WebGL 规范
# 5.14.3

浏览器兼容性

另见