WebGLRenderingContext: blendEquation()-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.blendEquation()-Methode der
WebGL-API wird verwendet, um sowohl die RGB- als auch die Alpha-Blend-Gleichung auf eine einzige Gleichung festzulegen.
Die Blend-Gleichung bestimmt, wie ein neues Pixel mit einem Pixel kombiniert wird, das bereits im
WebGLFramebuffer vorhanden ist.
Syntax
blendEquation(mode)
Parameter
mode-
Ein
GLenum, das angibt, wie Quell- und Ziel-Farben kombiniert werden. Muss entweder sein:gl.FUNC_ADD: Quelle + Ziel (Standardwert)gl.FUNC_SUBTRACT: Quelle - Zielgl.FUNC_REVERSE_SUBTRACT: Ziel - Quelle
Bei Verwendung der
EXT_blend_minmax-Erweiterung:ext.MIN_EXT: Minimum von Quelle und Zielext.MAX_EXT: Maximum von Quelle und Ziel
Bei Verwendung eines WebGL 2-Kontexts, sind zusätzlich folgende Werte verfügbar:
gl.MIN: Minimum von Quelle und Zielgl.MAX: Maximum von Quelle und Ziel
Ausnahmen
Falls mode nicht einer der drei möglichen Werte ist, wird ein
gl.INVALID_ENUM-Fehler ausgelöst.
Rückgabewert
Keiner (undefined).
Beispiele
Um die Blend-Gleichung festzulegen, verwenden Sie:
gl.blendEquation(gl.FUNC_ADD);
gl.blendEquation(gl.FUNC_SUBTRACT);
gl.blendEquation(gl.FUNC_REVERSE_SUBTRACT);
Um die Blend-Gleichungen abzurufen, fragen Sie die Konstanten BLEND_EQUATION,
BLEND_EQUATION_RGB und BLEND_EQUATION_ALPHA ab, die
gl.FUNC_ADD, gl.FUNC_SUBTRACT,
gl.FUNC_REVERSE_SUBTRACT zurückgeben, oder wenn die EXT_blend_minmax aktiviert ist: ext.MIN_EXT oder ext.MAX_EXT.
gl.getParameter(gl.BLEND_EQUATION_RGB) === gl.FUNC_ADD;
// true
gl.getParameter(gl.BLEND_EQUATION_ALPHA) === gl.FUNC_ADD;
// true
Spezifikationen
| Specification |
|---|
| WebGL Specification # 5.14.3 |