WebGL2RenderingContext.uniformMatrix[234]x[234]fv()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

WebGL 2 API 的 WebGL2RenderingContext.uniformMatrix[234]x[234]fv() 方法向 uniform 变量中传入指定的矩阵值。

备注：这个方法不用 2x2、3x3 和 4x4 版本，它们通常分别用 2、3、4 简写表示，详见下方语法。

语法

uniformMatrix2fv(location, transpose, data)
uniformMatrix2fv(location, transpose, data, srcOffset)
uniformMatrix2fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix3x2fv(location, transpose, data)
uniformMatrix3x2fv(location, transpose, data, srcOffset)
uniformMatrix3x2fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix4x2fv(location, transpose, data)
uniformMatrix4x2fv(location, transpose, data, srcOffset)
uniformMatrix4x2fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix2x3fv(location, transpose, data)
uniformMatrix2x3fv(location, transpose, data, srcOffset)
uniformMatrix2x3fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix3fv(location, transpose, data)
uniformMatrix3fv(location, transpose, data, srcOffset)
uniformMatrix3fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix4x3fv(location, transpose, data)
uniformMatrix4x3fv(location, transpose, data, srcOffset)
uniformMatrix4x3fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix2x4fv(location, transpose, data)
uniformMatrix2x4fv(location, transpose, data, srcOffset)
uniformMatrix2x4fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix3x4fv(location, transpose, data)
uniformMatrix3x4fv(location, transpose, data, srcOffset)
uniformMatrix3x4fv(location, transpose, data, srcOffset, srcLength)

uniformMatrix4fv(location, transpose, data)
uniformMatrix4fv(location, transpose, data, srcOffset)
uniformMatrix4fv(location, transpose, data, srcOffset, srcLength)

参数

location: 一个包含想要修改的 uniform 变量的WebGLUniformLocation 对象
transpose: 一个决定是否转置矩阵的布尔值（ GLboolean。在 webgl 中必须为false。
data: 一个包含方阵中浮点数的类数组对象 (TypeArray) Float32Array。

返回值

没有。

例子

gl.uniformMatrix2x3fv(loc, false, [1, 2, 3, 4, 5, 6]);

规范

Specification
WebGL Specification # 5.14.10

浏览器兼容性

BCD tables only load in the browser

令见

WebGLRenderingContext.uniformMatrix()