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 individueller Bits in den Stenzelebenen für die Vorder- und/oder Rückseite.

Die WebGLRenderingContext.stencilMask()-Methode kann sowohl die vorderen als auch die hinteren Stenzelebenen auf einen Wert gleichzeitig setzen.

Syntax

js
stencilMaskSeparate(face, mask)

Parameter

face

Ein GLenum, der angibt, ob die Schreibmaske der vorderen und/oder hinteren Stenzelebenen aktualisiert wird. Die möglichen Werte sind:

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

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

Rückgabewert

Keiner (undefined).

Beispiele

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

Um die aktuellen Stenzelschreiber-Masken zu erhalten, fragen Sie die STENCIL_WRITEMASK, STENCIL_BACK_WRITEMASK oder STENCIL_BITS Konstanten 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

Siehe auch