WebGLRenderingContext: blendEquation() 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.blendEquation() của WebGL API được sử dụng để thiết lập cả phương trình hòa trộn RGB và phương trình hòa trộn alpha thành một phương trình duy nhất.
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
blendEquation(mode)
Thông số
mode-
A
GLenumchỉ định cách kết hợp màu nguồn và màu đích. Phải là:gl.FUNC_ADD: nguồn + đích (giá trị mặc định)gl.FUNC_SUBTRACT: nguồn – đíchgl.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
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.
Giá trị trả về
Không có (undefined).
Ví dụ
Để thiết lập phương trình pha trộn, sử dụng:
gl.blendEquation(gl.FUNC_ADD);
gl.blendEquation(gl.FUNC_SUBTRACT);
gl.blendEquation(gl.FUNC_REVERSE_SUBTRACT);
Để có được các phương trình hòa trộn, 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
| Thông số kỹ thuật |
|---|
| WebGL Specification # 5.14.3 |