The WebGLRenderingContext.disable()
method of the WebGL API disables specific WebGL capabilities for this context.
Syntax
void gl.disable(cap);
Parameters
cap
- A
GLenum
specifying which WebGL capability to disable. Possible values: - {|
! Constant
! Description
|-
|
gl.BLEND
| Deactivates blending of the computed fragment color values. SeeWebGLRenderingContext.blendFunc()
. |- |gl.CULL_FACE
| Deactivates culling of polygons. SeeWebGLRenderingContext.cullFace()
. |- |gl.DEPTH_TEST
| Deactivates depth comparisons and updates to the depth buffer. SeeWebGLRenderingContext.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. SeeWebGLRenderingContext.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. SeeWebGLRenderingContext.sampleCoverage()
. |- |gl.SCISSOR_TEST
| Deactivates the scissor test that discards fragments that are outside of the scissor rectangle. SeeWebGLRenderingContext.scissor()
. |- |gl.STENCIL_TEST
| Deactivates stencil testing and updates to the stencil buffer. SeeWebGLRenderingContext.stencilFunc()
. |} When using a WebGL 2 context, the following values are available additionally: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.0The definition of 'disable' in that specification. | Recommendation | Initial definition for WebGL. |
OpenGL ES 2.0The definition of 'glDisable' in that specification. | Standard | Man page of the (similar) OpenGL ES 2.0 API. |
OpenGL ES 3.0The definition of 'glDisable' in that specification. | Standard | Man page of the (similar) OpenGL ES 3.0 API. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
disable
|
Chrome
Full support 9 |
Edge
Full support 12 |
Firefox
Full support 4 |
IE
Full support 11 |
Opera
Full support 12 |
Safari
Full support 5.1 |
WebView Android
Full support Yes |
Chrome Android
Full support 25 |
Firefox Android
Full support Yes |
Opera Android
Full support 12 |
Safari iOS
Full support 8 |
Samsung Internet Android
Full support 1.5 |
Legend
- Full support
- Full support
See also
WebGLRenderingContext.disable() by Mozilla Contributors is licensed under CC-BY-SA 2.5.