WebGLRenderingContext: getShaderPrecisionFormat() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

Note: This feature is available inWeb Workers.

TheWebGLRenderingContext.getShaderPrecisionFormat() method oftheWebGL API returns a newWebGLShaderPrecisionFormat object describing the range and precision forthe specified shader numeric format.

Syntax

getShaderPrecisionFormat(shaderType, precisionType)

Parameters

shaderType: Either agl.FRAGMENT_SHADER or agl.VERTEX_SHADER.
precisionType: A precision type value. Eithergl.LOW_FLOAT,gl.MEDIUM_FLOAT,gl.HIGH_FLOAT,gl.LOW_INT,gl.MEDIUM_INT, orgl.HIGH_INT.

Return value

AWebGLShaderPrecisionFormat object ornull, if an erroroccurs.

Exceptions

gl.INVALID_ENUM if the shader or precision types aren't recognized.
gl.INVALID_OPERATION if the shader compiler isn't supported.

Examples

The following code gets the precision format of agl.VERTEX_SHADER with agl.MEDIUM_FLOAT precision type.

const canvas = document.getElementById("canvas");const gl = canvas.getContext("webgl");gl.getShaderPrecisionFormat(gl.VERTEX_SHADER, gl.MEDIUM_FLOAT);// WebGLShaderPrecisionFormat { rangeMin: 127, rangeMax: 127, precision: 23 }