WebGLRenderingContext: blendEquationSeparate() method
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.
Note: This feature is available in Web Workers.
Phương thức WebGLRenderingContext.blendEquationSeparate() của WebGL API được sử dụng để thiết lập riêng biệt phương trình hòa trộn RGB và phương trình hòa trộn alpha.
Phương trình hoà trộn xác định cách một pixel mới được kết hợp với một pixel đã có trong WebGLFramebuffer.
Cú pháp
blendEquationSeparate(modeRGB, modeAlpha)
Thông số
modeRGB-
A
GLenumchỉ định cách các thành phần màu đỏ, lục và lam của nguồn và màu đích được kết hợp. Phải là:-
gl.FUNC_ADD: nguồn + đích (giá trị mặc định), -
gl.FUNC_SUBTRACT: nguồn - đích, -
gl.FUNC_REVERSE_SUBTRACT: đích – nguồn, -
Khi sử dụng phần mở rộng
EXT_blend_minmax:ext.MIN_EXT: Nguồn và đích tối thiểu,ext.MAX_EXT: Nguồn và đích tối đa.
-
Khi sử dụng WebGL 2 context, các giá trị sau đây có sẵn bổ sung:
gl.MIN: Nguồn và đích tối thiểu,gl.MAX: Nguồn và đích tối đa.
-
modeAlpha-
A
GLenumchỉ định cách thành phần alpha (độ trong suốt) của nguồn và màu đích được kết hợp. Phải là:-
gl.FUNC_ADD: nguồn + đích (giá trị mặc định), -
gl.FUNC_SUBTRACT: nguồn - đích, -
gl.FUNC_REVERSE_SUBTRACT: đích – nguồn, -
Khi sử dụng phần mở rộng
EXT_blend_minmax:ext.MIN_EXT: Nguồn và đích tối thiểu,ext.MAX_EXT: Nguồn và đích tối đa.
-
Khi sử dụng WebGL 2 context, các giá trị sau đây có sẵn bổ sung:
gl.MIN: Nguồn và đích tối thiểu,gl.MAX: Nguồn và đích tối đa.
-
Giá trị trả về
Không có (undefined).
Ngoại lệ
Nếu mode không phải là một trong ba giá trị có thể, lỗi gl.INVALID_ENUM sẽ được đưa ra.
Ví dụ
Để thiết lập các phương trình pha trộn, hãy sử dụng:
gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_SUBTRACT);
Để có được các phương trình hòa trộn hiện tại, hãy truy vấn các hằng số BLEND_EQUATION, BLEND_EQUATION_RGB và BLEND_EQUATION_ALPHA trả về gl.FUNC_ADD, gl.FUNC_SUBTRACT, gl.FUNC_REVERSE_SUBTRACT, hoặc nếu EXT_blend_minmax được bật: ext.MIN_EXT hoặc ext.MAX_EXT.
gl.getParameter(gl.BLEND_EQUATION_RGB) === gl.FUNC_ADD;
// true
gl.getParameter(gl.BLEND_EQUATION_ALPHA) === gl.FUNC_ADD;
// true
Thông số kỹ thuật
| Specification |
|---|
| WebGL Specification # 5.14.3 |