WebGLRenderingContext.uniform[1234][fi][v]()

The WebGLRenderingContext.uniform[1234][fi][v]() methods of the WebGL API specify values of uniform variables. All active uniform variables defined in a program object are initialized to 0 when the program object is linked successfully. They retain the values assigned to them by a call to this method until the next successful link operation occurs on the program object, when they are once again initialized to 0.

Syntax

void gl.uniform1f(location, v0);
void gl.uniform1fv(location, value);
void gl.uniform1i(location, v0);
void gl.uniform1iv(location, value);

void gl.uniform2f(location, v0, v1);
void gl.uniform2fv(location, value);
void gl.uniform2i(location, v0, v1);
void gl.uniform2iv(location, value);

void gl.uniform3f(location, v0, v1, v2);
void gl.uniform3fv(location, value);
void gl.uniform3i(location, v0, v1, v2);
void gl.uniform3iv(location, value);

void gl.uniform4f(location, v0, v1, v2, v3);
void gl.uniform4fv(location, value);
void gl.uniform4i(location, v0, v1, v2, v3);
void gl.uniform4iv(location, value);

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 floating point Number for floating point values (methods with "f").
• A sequence of floating point numbers (for example a Float32Array or an Array of numbers) for floating point vector methods (methods with "fv").
• An integer Number for integer values (methods with "i").
• An Int32Array for integer vector methods (methods with "iv").

Return value

None.

Examples

gl.uniform1f(u_alpha, 0.8);

Specifications

Browser compatibility

See also

• WebGLRenderingContext.uniformMatrix()