WebGLRenderingContext: stencilMaskSeparate() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.stencilMaskSeparate()-Methode der WebGL API steuert das Ein- und Ausschalten des Schreibens einzelner Bits in den Stencil-Ebenen für die Vorder- und/oder Rückseite.

Die Methode WebGLRenderingContext.stencilMask() kann gleichzeitig sowohl die Vorder- als auch Rückseiten-Stencil-Schreibmasken auf einen Wert setzen.

Syntax

js
stencilMaskSeparate(face, mask)

Parameter

face

Ein GLenum, der angibt, ob die Vorder- und/oder Rückseiten-Stencil-Schreibmaske aktualisiert wird. Die möglichen Werte sind:

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

Ein GLuint, das eine Bitmaske angibt, um das Schreiben einzelner Bits in den Stencil-Ebenen zu aktivieren oder zu deaktivieren. Standardmäßig ist die Maske auf alle 1 gesetzt.

Rückgabewert

Keiner (undefined).

Beispiele

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

Um die aktuellen Stencil-Masken zu ermitteln, fragen Sie die Konstanten STENCIL_WRITEMASK, STENCIL_BACK_WRITEMASK oder STENCIL_BITS ab.

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

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch