WebGLRenderingContext:disable() 方法

基线 广泛可用

此功能已得到良好建立,并且可以在许多设备和浏览器版本中使用。它已在浏览器中可用,自 2015 年 7 月.

WebGL API 的 WebGLRenderingContext.disable() 方法禁用此上下文的特定 WebGL 功能。

语法

js
disable(capability)

参数

capability

指定要禁用的 WebGL 功能的 GLenum。可能的值

常量 描述
gl.BLEND 停用计算出的片段颜色值的混合。请参阅 WebGLRenderingContext.blendFunc()
gl.CULL_FACE 停用多边形的剔除。请参阅 WebGLRenderingContext.cullFace()
gl.DEPTH_TEST 停用深度比较和对深度缓冲区的更新。请参阅 WebGLRenderingContext.depthFunc()
gl.DITHER 停用颜色分量在写入颜色缓冲区之前的抖动。
gl.POLYGON_OFFSET_FILL 停用向多边形片段的深度值添加偏移量。请参阅 WebGLRenderingContext.polygonOffset()
gl.SAMPLE_ALPHA_TO_COVERAGE 停用由 alpha 值确定的临时覆盖值计算。
gl.SAMPLE_COVERAGE 停用将片段的覆盖范围与临时覆盖值进行 AND 操作。请参阅 WebGLRenderingContext.sampleCoverage()
gl.SCISSOR_TEST 停用剪切测试,该测试丢弃位于剪切矩形之外的片段。请参阅 WebGLRenderingContext.scissor()
gl.STENCIL_TEST 停用模板测试和对模板缓冲区的更新。请参阅 WebGLRenderingContext.stencilFunc()

使用 WebGL 2 上下文 时,以下值也可用

常量 描述
gl.RASTERIZER_DISCARD 停用在光栅化阶段之前但可选的转换反馈阶段之后立即丢弃图元的操作。gl.clear() 命令将被忽略。

返回值

无 (undefined)。

示例

js
gl.disable(gl.DITHER);

要检查功能是否已禁用,请使用 WebGLRenderingContext.isEnabled() 方法

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

规范

规范
WebGL 规范
# 5.14.3

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅