OES_draw_buffers_indexed: Methode colorMaskiOES()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Dezember 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode colorMaskiOES() der WebGL-Erweiterung OES_draw_buffers_indexed legt für einen bestimmten Zeichenpuffer fest, welche Farbkomponenten beim Zeichnen oder Rendern aktiviert oder deaktiviert werden. Sie ist die indizierte Version der WebGL-1-Methode WebGLRenderingContext.colorMask().
Syntax
colorMaskiOES(buf, r, g, b, a)
Parameter
buf-
Eine Ganzzahl
i, die den Zeichenpuffer angibt, der der Konstantegl.DRAW_BUFFERizugeordnet ist; siehe WebGL-Konstanten für Zeichenpuffer. r-
Ein
GLboolean, der angibt, ob die rote Farbkomponente in den Zeichenpuffer geschrieben werden soll. g-
Ein
GLboolean, der angibt, ob die grüne Farbkomponente in den Zeichenpuffer geschrieben werden soll. b-
Ein
GLboolean, der angibt, ob die blaue Farbkomponente in den Zeichenpuffer geschrieben werden soll. a-
Ein
GLboolean, der angibt, ob die Alphakomponente (Transparenz) in den Zeichenpuffer geschrieben werden soll.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
buf,r,b,goderakeinen gültigen Wert haben, wird eingl.INVALID_VALUE-Fehler ausgelöst.
Beispiele
Farbmasken festlegen und abrufen
Sie können die Farbmasken für die Zeichenpuffer gl.DRAW_BUFFER0 und gl.DRAW_BUFFER1 wie folgt festlegen:
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, fragen Sie die Konstante COLOR_WRITEMASK mit WebGL2RenderingContext.getIndexedParameter() ab:
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 0);
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 1);
Spezifikationen
| Spezifikation |
|---|
| WebGL OES_draw_buffers_indexed Extension Specification |