OES_draw_buffers_indexed: Methode blendEquationiOES()
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 blendEquationiOES() der WebGL-Erweiterung OES_draw_buffers_indexed legt sowohl die RGB- als auch die Alpha-Blending-Gleichung für einen bestimmten Zeichnungspuffer fest.
Informationen zum getrennten Festlegen der RGB- und Alpha-Blending-Gleichungen finden Sie unter OES_draw_buffers_indexed.blendEquationSeparateiOES(). Die WebGL-1-Version dieser Methode finden Sie unter WebGLRenderingContext.blendEquation().
Syntax
blendEquationiOES(buf, mode)
Parameter
buf-
Eine Ganzzahl
i, die den Zeichnungspuffer angibt, der der Konstantegl.DRAW_BUFFERizugeordnet ist. Siehe WebGL-Konstanten für Zeichnungspuffer. mode-
Ein
GLenum, das angibt, wie Quell- und Zielfarben kombiniert werden. Akzeptiert dieselben Enum-Werte wie der ParametermodeinWebGLRenderingContext.blendEquation().
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
bufkein gültiger Wert ist, wird eingl.INVALID_VALUE-Fehler ausgelöst. - Wenn
modekeiner der möglichen Werte ist, wird eingl.INVALID_ENUM-Fehler ausgelöst.
Beispiele
Blending-Gleichungen festlegen und abrufen
Sie können die Blending-Gleichungen für die Zeichnungspuffer gl.DRAW_BUFFER0 und gl.DRAW_BUFFER1 wie folgt festlegen:
const ext = gl.getExtension("OES_draw_buffers_indexed");
ext.blendEquationiOES(0, gl.FUNC_ADD);
ext.blendEquationiOES(1, gl.FUNC_SUBTRACT);
Um die Blending-Gleichungen für die Zeichnungspuffer gl.DRAW_BUFFER0 und gl.DRAW_BUFFER1 abzurufen, fragen Sie die Konstanten BLEND_EQUATION_RGB und BLEND_EQUATION_ALPHA mit WebGL2RenderingContext.getIndexedParameter() ab:
// For gl.DRAW_BUFFER0
gl.getIndexedParameter(gl.BLEND_EQUATION_RGB, 0);
gl.getIndexedParameter(gl.BLEND_EQUATION_ALPHA, 0);
// For gl.DRAW_BUFFER0
gl.getIndexedParameter(gl.BLEND_EQUATION_RGB, 1);
gl.getIndexedParameter(gl.BLEND_EQUATION_ALPHA, 1);
Spezifikationen
| Spezifikation |
|---|
| WebGL OES_draw_buffers_indexed Extension Specification |