WebGLRenderingContext: stencilMask() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

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

WebGLRenderingContext.stencilMask() 方法是 WebGL API 的一部分,用於控制模板緩衝區(stencil planes)中各個位寫入的啟用和停用,包括正面和背面。

可以使用 WebGLRenderingContext.stencilMaskSeparate() 方法為正面和背面模板寫入掩碼設定不同的值。

語法

js
stencilMask(mask)

引數

mask

一個 GLuint 值,用於指定一個位掩碼,以啟用或停用模板緩衝區中各個位的寫入。預設情況下,掩碼是全 1。

返回值

無(undefined)。

示例

js
gl.stencilMask(110101);

要獲取當前的模板寫入掩碼,可以查詢 STENCIL_WRITEMASKSTENCIL_BACK_WRITEMASKSTENCIL_BITS 常量。

js
gl.getParameter(gl.STENCIL_WRITEMASK);
// 110101
gl.getParameter(gl.STENCIL_BACK_WRITEMASK);
// 110101
gl.getParameter(gl.STENCIL_BITS);
// 0

規範

規範
WebGL 規範
# 5.14.3

瀏覽器相容性

另見