OES_draw_buffers_indexed: colorMaskiOES() Methode
Baseline 2022
Newly available
Since December 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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_BUFFERi
verbunden 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
,g
odera
keine gültigen Werte sind, wird eingl.INVALID_VALUE
Fehler 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
BCD tables only load in the browser