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: Dieses Feature ist verfügbar in Web Workers.
Die WebGLRenderingContext.blendEquation()
-Methode der
WebGL-API wird verwendet, um sowohl die RGB- als auch die Alphablendgleichung auf eine einzelne Gleichung festzulegen.
Die Blendgleichung bestimmt, wie ein neuer Pixel mit einem bereits im
WebGLFramebuffer
vorhandenen Pixel kombiniert wird.
Syntax
blendEquation(mode)
Parameter
mode
-
Ein
GLenum
, der 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-Kontext sind zusätzlich folgende Werte verfügbar:
gl.MIN
: Minimum von Quelle und Zielgl.MAX
: Maximum von Quelle und Ziel
Ausnahmen
Wenn mode nicht einer der drei möglichen Werte ist, wird ein
gl.INVALID_ENUM
-Fehler ausgelöst.
Rückgabewert
None (undefined
).
Beispiele
Um die Blendgleichung festzulegen, verwenden Sie:
gl.blendEquation(gl.FUNC_ADD);
gl.blendEquation(gl.FUNC_SUBTRACT);
gl.blendEquation(gl.FUNC_REVERSE_SUBTRACT);
Um die Blendgleichungen zu erhalten, 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 falls 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 |
Browser-Kompatibilität
BCD tables only load in the browser