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