The WebGLRenderingContext.getShaderPrecisionFormat()
method of the WebGL API returns a new WebGLShaderPrecisionFormat
object describing the range and precision for the specified shader numeric format.
Syntax
WebGLShaderPrecisionFormat gl.getShaderPrecisionFormat(shaderType, precisionType);
Parameters
shaderType
- Either a
gl.FRAGMENT_SHADER
or agl.VERTEX_SHADER
. precisionType
- A precision type value. Either
gl.LOW_FLOAT
,gl.MEDIUM_FLOAT
,gl.HIGH_FLOAT
,gl.LOW_INT
,gl.MEDIUM_INT
, orgl.HIGH_INT
.
Return value
A WebGLShaderPrecisionFormat
object or null
, if an error occurs.
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 a gl.VERTEX_SHADER
with a gl.MEDIUM_FLOAT
precision type.
var canvas = document.getElementById('canvas'); var gl = canvas.getContext('webgl'); gl.getShaderPrecisionFormat(gl.VERTEX_SHADER, gl.MEDIUM_FLOAT); // WebGLShaderPrecisionFormat { rangeMin: 127, rangeMax: 127, precision: 23 }
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'getShaderPrecisionFormat' in that specification. |
Recommendation | Initial definition. |
OpenGL ES 2.0 The definition of 'glGetShaderPrecisionFormat' in that specification. |
Standard | Man page of the (similar) OpenGL API. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getShaderPrecisionFormat | Chrome Full support 9 | Edge Full support 12 | Firefox Full support 4 | IE Full support 11 | Opera Full support 12 | Safari Full support 5.1 | WebView Android Full support Yes | Chrome Android Full support 25 | Firefox Android Full support Yes | Opera Android Full support 12 | Safari iOS Full support 8 | Samsung Internet Android Full support 1.5 |
Legend
- Full support
- Full support