W3cubDocs

/DOM

WebGL2RenderingContext.uniform

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The WebGL2RenderingContext.uniform[1234][uif][v]() methods of the WebGL API specify values of uniform variables.

ui stands for unsigned integer, i for integer, f for float, and v for vector.
Not all combination are valid: ui can be combined with v, but not i or f. See the syntax table below.

Syntax

void gl.uniform1ui(location, v0); 
void gl.uniform2ui(location, v0, v1); 
void gl.uniform3ui(location, v0, v1, v2); 
void gl.uniform4ui(location, v0, v1, v2, v3); 
void gl.uniform1fv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform2fv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform3fv(location, data, optional srcOffset, optional srcLength);
void gl.uniform4fv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform1iv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform2iv(location, data, optional srcOffset, optional srcLength);
void gl.uniform3iv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform4iv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform1uiv(location, data, optional srcOffset, optional srcLength);
void gl.uniform2uiv(location, data, optional srcOffset, optional srcLength);
void gl.uniform3uiv(location, data, optional srcOffset, optional srcLength); 
void gl.uniform4uiv(location, data, optional srcOffset, optional srcLength);

Parameters

location
A WebGLUniformLocation object containing the location of the uniform attribute to modify.
value, v0, v1, v2, v3
A new value to be used for the uniform variable. Possible types:
  • A Number for unsigned integer values (methods with ui), for integer values (methods with i), or for floats (methods with f).
  • A Uint32Array for unsigned integer vector methods (methods with uiv).

Return value

None.

Specifications

Specification Status Comment
WebGL 2.0
The definition of 'uniform' in that specification.
Editor's Draft Initial definition for WebGL.
OpenGL ES 3.0
The definition of 'glUniform' in that specification.
Standard Man page of the (similar) OpenGL API.

Browser compatibility

Feature Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 56 No 51 No 43 No
Feature Android webview Chrome for Android Edge mobile Firefox for Android IE mobile Opera Android iOS Safari
Basic support 58 58 No 51 No 43 No

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/uniform