WebGLRenderingContext: disable() 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.disable() của WebGL API vô hiệu hóa các khả năng cụ thể của WebGL cho bối cảnh này.

Cú pháp

js
disable(capability)

Thông số

capability

Một GLenum chỉ định khả năng WebGL nào sẽ bị vô hiệu hóa. Khả thi giá trị:

Constant Description
gl.BLEND Deactivates blending of the computed fragment color values. See WebGLRenderingContext.blendFunc().
gl.CULL_FACE Deactivates culling of polygons. See WebGLRenderingContext.cullFace().
gl.DEPTH_TEST Deactivates depth comparisons and updates to the depth buffer. See WebGLRenderingContext.depthFunc().
gl.DITHER Deactivates dithering of color components before they get written to the color buffer.
gl.POLYGON_OFFSET_FILL Deactivates adding an offset to depth values of polygon's fragments. See WebGLRenderingContext.polygonOffset().
gl.SAMPLE_ALPHA_TO_COVERAGE Deactivates the computation of a temporary coverage value determined by the alpha value.
gl.SAMPLE_COVERAGE Deactivates ANDing the fragment's coverage with the temporary coverage value. See WebGLRenderingContext.sampleCoverage().
gl.SCISSOR_TEST Deactivates the scissor test that discards fragments that are outside of the scissor rectangle. See WebGLRenderingContext.scissor().
gl.STENCIL_TEST Deactivates stencil testing and updates to the stencil buffer. See WebGLRenderingContext.stencilFunc().

Khi sử dụng WebGL 2 context, các giá trị sau đây có sẵn bổ sung:

| Constant                | Description                                                                                                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gl.RASTERIZER_DISCARD` | Deactivates that primitives are discarded immediately before the rasterization stage, but after the optional transform feedback stage. `gl.clear()` commands are ignored. |

Giá trị trả về

Không có (undefined).

Ví dụ

js
gl.disable(gl.DITHER);

Để kiểm tra xem một khả năng có bị vô hiệu hóa hay không, hãy sử dụng phương thức WebGLRenderingContext.isEnabled():

js
gl.isEnabled(gl.DITHER);
// false

Thông số kỹ thuật

Specification
WebGL Specification
# 5.14.3

Khả năng tương thích của trình duyệt

Xem thêm