Firefox Tomorrow

web api instance method

WebGLRenderingContext: disable() method

View on MDN ↗

Available in workers

The WebGLRenderingContext.disable() method of the WebGL API disables specific WebGL capabilities for this context.

Syntax

disable(capability)

Parameters

  • capability
    • : A GLenum specifying which WebGL capability to disable. Possible values:

      ConstantDescription
      gl.BLENDDeactivates blending of the computed fragment color values. See blendFunc().
      gl.CULL_FACEDeactivates culling of polygons. See cullFace().
      gl.DEPTH_TESTDeactivates depth comparisons and updates to the depth buffer. See depthFunc().
      gl.DITHERDeactivates dithering of color components before they get written to the color buffer.
      gl.POLYGON_OFFSET_FILLDeactivates adding an offset to depth values of polygon’s fragments. See polygonOffset().
      gl.SAMPLE_ALPHA_TO_COVERAGEDeactivates the computation of a temporary coverage value determined by the alpha value.
      gl.SAMPLE_COVERAGEDeactivates ANDing the fragment’s coverage with the temporary coverage value. See sampleCoverage().
      gl.SCISSOR_TESTDeactivates the scissor test that discards fragments that are outside of the scissor rectangle. See scissor().
      gl.STENCIL_TESTDeactivates stencil testing and updates to the stencil buffer. See stencilFunc().

      When using a WebGL 2 context, the following values are available additionally:

      ConstantDescription
      gl.RASTERIZER_DISCARDDeactivates that primitives are discarded immediately before the rasterization stage, but after the optional transform feedback stage. gl.clear() commands are ignored.

Return value

None (undefined).

Examples

gl.disable(gl.DITHER);

To check if a capability is disabled, use the isEnabled() method:

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

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also