|
1 | 1 | --- |
2 | | -title: WebGLRenderingContext.enable() |
| 2 | +title: WebGLRenderingContext:enable() 方法 |
3 | 3 | slug: Web/API/WebGLRenderingContext/enable |
| 4 | +l10n: |
| 5 | + sourceCommit: eda49877b9078b24cd18f794470e5e225add9b94 |
4 | 6 | --- |
5 | 7 |
|
6 | 8 | {{APIRef("WebGL")}} |
7 | 9 |
|
8 | | -[WebGL API](/zh-CN/docs/Web/API/WebGL_API) 中的**`WebGLRenderingContext.enable()`** 方法,用于对该上下文开启某种特性。 |
| 10 | +[WebGL API](/zh-CN/docs/Web/API/WebGL_API) 的 **`WebGLRenderingContext.enable()`** 方法用于为上下文启用特定的 WebGL 的功能。 |
9 | 11 |
|
10 | 12 | ## 语法 |
11 | 13 |
|
| 14 | +```js-nolint |
| 15 | +enable(cap) |
12 | 16 | ``` |
13 | | -void gl.enable(cap);参数 |
14 | | -``` |
| 17 | + |
| 18 | +### 参数 |
15 | 19 |
|
16 | 20 | - `cap` |
17 | 21 |
|
18 | | - - : 让 WebGL 开启某种特性,可能的值: |
| 22 | + - : 一个指定要启用的 WebGL 的功能的 {{domxref("WebGL_API/Types", "GLenum")}}。可能的值有: |
19 | 23 |
|
20 | | - | Constant | Description | |
21 | | - | ----------------------------- | ----------------------------------------------------------------------------------------------------- | |
22 | | - | `gl.BLEND` | 激活片元的颜色融合计算。参见 {{domxref("WebGLRenderingContext.blendFunc()")}}. | |
23 | | - | `gl.CULL_FACE` | 激活多边形正反面剔除。参见{{domxref("WebGLRenderingContext.cullFace()")}}. | |
24 | | - | `gl.DEPTH_TEST` | 激活深度比较,并且更新深度缓冲区。参见{{domxref("WebGLRenderingContext.depthFunc()")}}. | |
25 | | - | `gl.DITHER` | 激活在写入颜色缓冲区之前,抖动颜色成分。 | |
26 | | - | `gl.POLYGON_OFFSET_FILL` | 激活添加多边形片段的深度值偏移。参见{{domxref("WebGLRenderingContext.polygonOffset()")}}. | |
27 | | - | `gl.SAMPLE_ALPHA_TO_COVERAGE` | 激活通过 alpha 值决定的临时覆盖值计算。(抗锯齿) | |
28 | | - | `gl.SAMPLE_COVERAGE` | 激活使用临时覆盖值,位和运算片段的覆盖值。参见 {{domxref("WebGLRenderingContext.sampleCoverage()")}}. | |
29 | | - | `gl.SCISSOR_TEST` | 激活剪裁测试,即丢弃在剪裁矩形范围外的片段。{{domxref("WebGLRenderingContext.scissor()")}}. | |
30 | | - | `gl.STENCIL_TEST` | 激活模板测试并且更新模板缓冲区。参见{{domxref("WebGLRenderingContext.stencilFunc()")}}. | |
| 24 | + | 常量 | 描述 | |
| 25 | + | ----------------------------- | ------------------------------------------------------------------------------------------------- | |
| 26 | + | `gl.BLEND` | 激活片元的颜色融合计算。参见 {{domxref("WebGLRenderingContext.blendFunc()")}}。 | |
| 27 | + | `gl.CULL_FACE` | 激活多边形的面剔除。参见 {{domxref("WebGLRenderingContext.cullFace()")}}。 | |
| 28 | + | `gl.DEPTH_TEST` | 激活深度比较,并更新深度缓冲区。参见 {{domxref("WebGLRenderingContext.depthFunc()")}}。 | |
| 29 | + | `gl.DITHER` | 激活在写入颜色缓冲区之前,抖动颜色成分。 | |
| 30 | + | `gl.POLYGON_OFFSET_FILL` | 激活添加多边形片段的深度值偏移。参见 {{domxref("WebGLRenderingContext.polygonOffset()")}}。 | |
| 31 | + | `gl.SAMPLE_ALPHA_TO_COVERAGE` | 激活通过 alpha 值确定临时掩模的计算。 | |
| 32 | + | `gl.SAMPLE_COVERAGE` | 激活片段掩模与临时掩模的与运算。参见 {{domxref("WebGLRenderingContext.sampleCoverage()")}}。 | |
| 33 | + | `gl.SCISSOR_TEST` | 激活剪裁测试,即丢弃在剪裁矩形范围外的片段。参见 {{domxref("WebGLRenderingContext.scissor()")}}。 | |
| 34 | + | `gl.STENCIL_TEST` | 激活模板测试并更新模板缓冲区。参见 {{domxref("WebGLRenderingContext.stencilFunc()")}}。 | |
31 | 35 |
|
32 | | - 当使用 {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}时,可以添加使用下面的值。 |
| 36 | + 当使用 {{domxref("WebGL2RenderingContext", "WebGL 2 上下文", "", 1)}}时,还可以使用以下值: |
33 | 37 |
|
34 | | - | Constant | Description | |
35 | | - | ----------------------- | ------------------------------------------------------------------------------------------ | |
36 | | - | `gl.RASTERIZER_DISCARD` | 图元光栅化阶段之前,但在任意的 transform 反馈之后,就立刻被丢弃。`gl.clear() 命令被忽略。` | |
| 38 | + | 常量 | 描述 | |
| 39 | + | ----------------------- | ----------------------------------------------------------------------------- | |
| 40 | + | `gl.RASTERIZER_DISCARD` | 图元在光栅化阶段前,可选的变换反馈之后被立刻丢弃。`gl.clear()` 命令会被忽略。 | |
37 | 41 |
|
38 | 42 | ### 返回值 |
39 | 43 |
|
40 | | -None. |
| 44 | +无({{jsxref("undefined")}})。 |
41 | 45 |
|
42 | | -## 样例 |
| 46 | +## 示例 |
43 | 47 |
|
44 | 48 | ```js |
45 | 49 | gl.enable(gl.DITHER); |
46 | 50 | ``` |
47 | 51 |
|
48 | | -如果要检测可用性,可以使用 {{domxref("WebGLRenderingContext.isEnabled()")}} 方法: |
| 52 | +要检测功能是否启用,请使用 {{domxref("WebGLRenderingContext.isEnabled()")}} 方法: |
49 | 53 |
|
50 | 54 | ```js |
51 | 55 | gl.isEnabled(gl.DITHER); |
|
0 commit comments