WebGLRenderingContext.uniform[1234][fi][v]()
WebGL API 的 WebGLRenderingContext.uniform[1234][fi][v]()
方法指定了 uniform 变量的值。所有在 ShaderProgram 对象中定义的,且激活的 uniform 变量在 ShaderProgram 执行 link 成功后被初始化为 0。它们将保留通过调用此方法分配给它们的值,直到再次将其初始化为 0 时,也就是 ShaderProgram 对象上发生下一次成功的 link 操作为止。
备注: 这里描述的许多函数都扩展了 WebGL 2 接口,可在以下地址查看 WebGL2RenderingContext.uniform[1234][uif][v]()
。
语法
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);
参数
location
-
WebGLUniformLocation
对象包含了将要修改的 uniform 属性位置。 value, v0, v1, v2, v3
-
新的值将被用于 uniform 变量。可能的类型:
- 浮点值
Number
(方法名跟"f"). - 浮点数组 (例如
Float32Array
或Array
的数组) 用于浮点型向量方法 (方法名跟 "fv"). - 整型值
Number
(方法名跟"i"). - 整型数组
Int32Array
用于整型向量方法 (方法名跟 "iv").
- 浮点值
返回值
无(undefined
)。
示例
gl.uniform1f(u_alpha, 0.8);
规范
Specification |
---|
WebGL Specification # 5.14.10 |
浏览器兼容性
BCD tables only load in the browser