WebGLRenderingContext：stencilMaskSeparate() 方法

基线 广泛可用

此功能已得到良好建立，并且可在许多设备和浏览器版本上运行。它自以下时间起在各个浏览器中可用： 2015 年 7 月.

WebGLRenderingContext.stencilMaskSeparate() 方法是 WebGL API 的一部分，它控制着启用和禁用模板平面上单个位的正面和/或背面写入。

WebGLRenderingContext.stencilMask() 方法可以同时将正面和背面模板写掩码设置为一个值。

语法

js
stencilMaskSeparate(face, mask)

参数

face

一个 GLenum，指定更新正面和/或背面模板写掩码。可能的值为：

  • gl.FRONT
  • gl.BACK
  • gl.FRONT_AND_BACK
mask

一个 GLuint，指定一个位掩码以启用或禁用模板平面上单个位的写入。默认情况下，掩码全为 1。

返回值

无 (undefined)。

示例

js
gl.stencilMaskSeparate(gl.FRONT, 110101);

要获取当前模板掩码，请查询 STENCIL_WRITEMASK、STENCIL_BACK_WRITEMASK 或 STENCIL_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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

参见