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.
Note: Many of the functions described here have expanded WebGL 2 interfaces, which can be
found under
WebGL2RenderingContext.uniform[1234][uif][v]()
.
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 anArray
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").
-
A floating point
Return value
None.
Examples
gl.uniform1f(u_alpha, 0.8);
Specifications
Specification |
---|
WebGL Specification # 5.14.10 |
Browser compatibility
BCD tables only load in the browser