WebGLRenderingContext.disable()
The WebGLRenderingContext.disable()
method of the WebGL API disables specific WebGL capabilities for this context.
Syntax
void gl.disable(cap);
Parameters
cap
- A
GLenum
(en-US) specifying which WebGL capability to disable. Possible values: -
When using a WebGL 2 context, the following values are available additionally:
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()
(en-US).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()
(en-US).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.
Return value
None.
Examples
gl.disable(gl.DITHER);
To check if a capability is disabled, use the WebGLRenderingContext.isEnabled()
method:
gl.isEnabled(gl.DITHER);
// false
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 disable |
Recommendation | Initial definition for WebGL. |
OpenGL ES 2.0 glDisable |
Standard | Man page of the (similar) OpenGL ES 2.0 API. |
OpenGL ES 3.0 glDisable |
Standard | Man page of the (similar) OpenGL ES 3.0 API. |
Browser compatibility
BCD tables only load in the browser