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

瀏覽器相容性

另見