WebGLRenderingContext: blendEquationSeparate() метод

Базовая версия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Примечание: Эта функция доступна в Потоках Web Workers.

Метод WebGLRenderingContext.blendEquationSeparate() API WebGL используется для самостоятельной настройки уравнений смешивания RGB и альфа-каналов.

Уравнение смешивания определяет, как новый пиксель комбинируется с пикселем, уже находящимся в WebGLFramebuffer.

Синтаксис

blendEquationSeparate(modeRGB, modeAlpha)

Параметры

modeRGB

Значение GLenum, определяющее, как комбинируются красные, зеленые и синие компоненты цветов источника и назначения. Должно быть одним из:

gl.FUNC_ADD: источник + назначение (значение по умолчанию),
gl.FUNC_SUBTRACT: источник - назначение,
gl.FUNC_REVERSE_SUBTRACT: назначение - источник,
При использовании расширения EXT_blend_minmax:
- ext.MIN_EXT: Минимальное значение из источника и назначения,
- ext.MAX_EXT: Максимальное значение из источника и назначения.
При использовании контекста WebGL 2 доступны следующие дополнительные значения:
- gl.MIN: Минимальное значение из источника и назначения,
- gl.MAX: Максимальное значение из источника и назначения.

modeAlpha

Значение GLenum, определяющее, как комбинируется альфа-компонент (прозрачность) цветов источника и назначения. Должно быть одним из:

gl.FUNC_ADD: источник + назначение (значение по умолчанию),
gl.FUNC_SUBTRACT: источник - назначение,
gl.FUNC_REVERSE_SUBTRACT: назначение - источник,
При использовании расширения EXT_blend_minmax:
- ext.MIN_EXT: Минимальное значение из источника и назначения,
- ext.MAX_EXT: Максимальное значение из источника и назначения.
При использовании контекста WebGL 2 доступны следующие дополнительные значения:
- gl.MIN: Минимальное значение из источника и назначения,
- gl.MAX: Максимальное значение из источника и назначения.

Возвращаемое значение

None (undefined).

Исключения

Если mode не соответствует одному из допустимых значений, выбрасывается ошибка gl.INVALID_ENUM.

Примеры

Для установки уравнений смешивания используйте:

gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_SUBTRACT);

Для получения текущих уравнений смешивания запросите константы BLEND_EQUATION, BLEND_EQUATION_RGB и BLEND_EQUATION_ALPHA, которые вернут значения gl.FUNC_ADD, gl.FUNC_SUBTRACT, gl.FUNC_REVERSE_SUBTRACT, или, если включено расширение EXT_blend_minmax: ext.MIN_EXT или ext.MAX_EXT.

gl.getParameter(gl.BLEND_EQUATION_RGB) === gl.FUNC_ADD;
// true

gl.getParameter(gl.BLEND_EQUATION_ALPHA) === gl.FUNC_ADD;
// true

Спецификации

Спецификация
Спецификация WebGL # 5.14.3

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`blendEquationSeparate`	9	12	4	12	5.1	25	4	12	8	1.5	4.4.3

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/blendEquationSeparate