OES_draw_buffers_indexed: colorMaskiOES() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Dezember 2022.
Die Methode colorMaskiOES() der OES_draw_buffers_indexed WebGL-Erweiterung legt fest, welche Farbkomponenten beim Zeichnen oder Rendern für einen bestimmten Zeichenpuffer aktiviert oder deaktiviert werden. Es ist die indizierte Version der Methode WebGLRenderingContext.colorMask() aus WebGL 1.
Syntax
colorMaskiOES(buf, r, g, b, a)
Parameter
buf-
Ein ganzzahliger Wert
i, der den Zeichenpuffer angibt, der mit der Konstantegl.DRAW_BUFFERiverbunden ist. Siehe WebGL Zeichenpufferkonstanten. r-
Ein
GLboolean, der angibt, ob die rote Farbkomponente in den Zeichenpuffer geschrieben werden soll oder nicht. g-
Ein
GLboolean, der angibt, ob die grüne Farbkomponente in den Zeichenpuffer geschrieben werden soll oder nicht. b-
Ein
GLboolean, der angibt, ob die blaue Farbkomponente in den Zeichenpuffer geschrieben werden soll oder nicht. a-
Ein
GLboolean, der angibt, ob die rote Alpha-Komponente (Transparenz) in den Zeichenpuffer geschrieben werden soll oder nicht.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
buf,r,b,goderakeine gültigen Werte sind, wird eingl.INVALID_VALUEFehler ausgelöst.
Beispiele
Einstellen und Abrufen von Farbmasken
Sie können die Farbmasken für die Zeichenpuffer gl.DRAW_BUFFER0 und gl.DRAW_BUFFER1 wie folgt einstellen:
const ext = gl.getExtension("OES_draw_buffers_indexed");
ext.colorMaskiOES(0, 1, 0, 0, 0);
ext.colorMaskiOES(1, 0, 1, 0, 0);
Um die Farbmasken für die Zeichenpuffer gl.DRAW_BUFFER0 und gl.DRAW_BUFFER1 abzurufen, können Sie die Konstante COLOR_WRITEMASK mit WebGL2RenderingContext.getIndexedParameter() abfragen:
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 0);
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 1);
Spezifikationen
| Specification |
|---|
| WebGL OES_draw_buffers_indexed Extension Specification |
Browser-Kompatibilität
Loading…