WebGLRenderingContext: stencilMaskSeparate() 方法

Baseline 已廣泛支援

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

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

WebGLRenderingContext.stencilMaskSeparate() 方法是 WebGL API 的一部分，用於控制啟用和停用模板緩衝（stencil planes）中各個位的寫入。

WebGLRenderingContext.stencilMask() 方法可以同時設定正面和背面的模板寫入掩碼（stencil writemask）為一個值。

語法

stencilMaskSeparate(face, mask)

一個 GLenum，指定正面和/或背面模板寫入掩碼是否被更新。可能的值為：

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

無（undefined）。

gl.stencilMaskSeparate(gl.FRONT, 110101);

要獲取當前的模板掩碼，請查詢 STENCIL_WRITEMASK、STENCIL_BACK_WRITEMASK 或 STENCIL_BITS 常量。

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

規範
WebGL 規範 # 5.14.3

此頁面最後修改於 ⁨2025年6月23日⁩，由 MDN 貢獻者進行編輯。