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 combinations are valid: u cannot be combined with f. See the syntax table below. Equivalent Regex: uniform[1234](u?i|f)v?

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 compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 56 No 51 No 43 No
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 58 58 No 51 43 No 7.0

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