WebGL2RenderingContext: uniform[1234][uif][v]() 方法

基线 广泛可用

此功能已得到良好建立,并且可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用: 2021 年 9 月.

WebGL2RenderingContext.uniform[1234][uif][v]() 方法是 WebGL API 的一部分,用于指定统一变量的值。

注意:ui 代表无符号整数i 代表整数f 代表浮点数v 代表向量。并非所有组合都是有效的:u 不能与 f 组合。请参见下面的语法表。等效正则表达式:uniform[1234](u?i|f)v?

语法

js
uniform1ui(location, v0)
uniform2ui(location, v0, v1)
uniform3ui(location, v0, v1, v2)
uniform4ui(location, v0, v1, v2, v3)

uniform1fv(location, data)
uniform1fv(location, data, srcOffset)
uniform1fv(location, data, srcOffset, srcLength)

uniform2fv(location, data)
uniform2fv(location, data, srcOffset)
uniform2fv(location, data, srcOffset, srcLength)

uniform3fv(location, data)
uniform3fv(location, data, srcOffset)
uniform3fv(location, data, srcOffset, srcLength)

uniform4fv(location, data)
uniform4fv(location, data, srcOffset)
uniform4fv(location, data, srcOffset, srcLength)

uniform1iv(location, data)
uniform1iv(location, data, srcOffset)
uniform1iv(location, data, srcOffset, srcLength)

uniform2iv(location, data)
uniform2iv(location, data, srcOffset)
uniform2iv(location, data, srcOffset, srcLength)

uniform3iv(location, data)
uniform3iv(location, data, srcOffset)
uniform3iv(location, data, srcOffset, srcLength)

uniform4iv(location, data)
uniform4iv(location, data, srcOffset)
uniform4iv(location, data, srcOffset, srcLength)

uniform1uiv(location, data)
uniform1uiv(location, data, srcOffset)
uniform1uiv(location, data, srcOffset, srcLength)

uniform2uiv(location, data)
uniform2uiv(location, data, srcOffset)
uniform2uiv(location, data, srcOffset, srcLength)

uniform3uiv(location, data)
uniform3uiv(location, data, srcOffset)
uniform3uiv(location, data, srcOffset, srcLength)

uniform4uiv(location, data)
uniform4uiv(location, data, srcOffset)
uniform4uiv(location, data, srcOffset, srcLength)

参数

location

一个 WebGLUniformLocation 对象,包含要修改的统一属性的位置。

data, v0, v1, v2, v3

用于统一变量的新值。可能的类型

  • 对于无符号整数(带有 ui 的方法)、整数(带有 i 的方法)或浮点数(带有 f 的方法),可以使用 Number
  • 对于无符号整数向量方法(带有 uiv 的方法),可以使用 Uint32Array

返回值

无 (undefined).

规范

规范
WebGL 2.0 规范
# 3.7.8

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅