The WebGLRenderingContext.stencilMaskSeparate()
method of the WebGL API controls enabling and disabling of front and/or back writing of individual bits in the stencil planes.
The WebGLRenderingContext.stencilMask()
method can set both, the front and back stencil writemasks to one value at the same time.
Syntax
void gl.stencilMaskSeparate(face, mask);
Parameters
- face
- A
GLenum
specifying whether the front and/or back stencil writemask is updated. The possible values are:gl.FRONT
gl.BACK
gl.FRONT_AND_BACK
mask
- A
GLuint
specifying a bit mask to enable or disable writing of individual bits in the stencil planes. By default, the mask is all 1.
Return value
None.
Examples
gl.stencilMaskSeparate(gl.FRONT, 110101);
To get the current stencil masks, query the STENCIL_WRITEMASK
, STENCIL_BACK_WRITEMASK
, or STENCIL_BITS
constants.
gl.getParameter(gl.STENCIL_WRITEMASK); // 110101 gl.getParameter(gl.STENCIL_BACK_WRITEMASK); // 110101 gl.getParameter(gl.STENCIL_BITS); // 0
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'stencilMaskSeparate' in that specification. |
Recommendation | Initial definition. |
OpenGL ES 2.0 The definition of 'glStencilMaskSeparate' in that specification. |
Standard | Man page of the OpenGL API. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
stencilMaskSeparate | Chrome Full support 9 | Edge Full support 12 | Firefox Full support 4 | IE Full support 11 | Opera Full support 12 | Safari Full support 5.1 | WebView Android Full support Yes | Chrome Android Full support 25 | Firefox Android Full support Yes | Opera Android Full support 12 | Safari iOS Full support 8 | Samsung Internet Android Full support 1.5 |
Legend
- Full support
- Full support