-
Notifications
You must be signed in to change notification settings - Fork 22.4k
/
index.md
75 lines (53 loc) · 3.75 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
---
title: "WebGLRenderingContext: disable() method"
short-title: disable()
slug: Web/API/WebGLRenderingContext/disable
page-type: web-api-instance-method
browser-compat: api.WebGLRenderingContext.disable
---
{{APIRef("WebGL")}}
The **`WebGLRenderingContext.disable()`** method of the [WebGL API](/en-US/docs/Web/API/WebGL_API) disables specific WebGL
capabilities for this context.
## Syntax
```js-nolint
disable(capability)
```
### Parameters
- `capability`
- : A {{domxref("WebGL_API/Types", "GLenum")}} specifying which WebGL capability to disable. Possible
values:
| Constant | Description |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gl.BLEND` | Deactivates blending of the computed fragment color values. See {{domxref("WebGLRenderingContext.blendFunc()")}}. |
| `gl.CULL_FACE` | Deactivates culling of polygons. See {{domxref("WebGLRenderingContext.cullFace()")}}. |
| `gl.DEPTH_TEST` | Deactivates depth comparisons and updates to the depth buffer. See {{domxref("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 {{domxref("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 {{domxref("WebGLRenderingContext.sampleCoverage()")}}. |
| `gl.SCISSOR_TEST` | Deactivates the scissor test that discards fragments that are outside of the scissor rectangle. See {{domxref("WebGLRenderingContext.scissor()")}}. |
| `gl.STENCIL_TEST` | Deactivates stencil testing and updates to the stencil buffer. See {{domxref("WebGLRenderingContext.stencilFunc()")}}. |
When using a {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, 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 ({{jsxref("undefined")}}).
## Examples
```js
gl.disable(gl.DITHER);
```
To check if a capability is disabled, use the
{{domxref("WebGLRenderingContext.isEnabled()")}} method:
```js
gl.isEnabled(gl.DITHER);
// false
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- {{domxref("WebGLRenderingContext.enable()")}}
- {{domxref("WebGLRenderingContext.isEnabled()")}}