Mat4 类型

继承于 ValueType

模块: cc 父模块: cc

表示 4*4 矩阵

索引

属性（properties）

• IDENTITY Mat4 Identity of Mat4
• m Float64Array | Float32Array 矩阵数据

方法

• mul 将当前矩阵与指定矩阵相乘
• mulScalar 将矩阵的每一个元素都乘以指定的缩放值。
• sub 将当前矩阵与指定的矩阵相减
• clone 获得指定矩阵的拷贝
• copy 复制目标矩阵
• identity 将目标赋值为单位矩阵
• transpose 转置矩阵
• invert 矩阵求逆
• determinant 矩阵行列式
• multiply 矩阵乘法
• transform 在给定矩阵变换基础上加入变换
• translate 在给定矩阵变换基础上加入新位移变换
• scale 在给定矩阵变换基础上加入新缩放变换
• rotate 在给定矩阵变换基础上加入新旋转变换
• rotateX 在给定矩阵变换基础上加入绕 X 轴的旋转变换
• rotateY 在给定矩阵变换基础上加入绕 Y 轴的旋转变换
• rotateZ 在给定矩阵变换基础上加入绕 Z 轴的旋转变换
• fromTranslation 计算位移矩阵
• fromScaling 计算缩放矩阵
• fromRotation 计算旋转矩阵
• fromXRotation 计算绕 X 轴的旋转矩阵
• fromYRotation 计算绕 Y 轴的旋转矩阵
• fromZRotation 计算绕 Z 轴的旋转矩阵
• fromRT 根据旋转和位移信息计算矩阵
• getTranslation 提取矩阵的位移信息, 默认矩阵中的变换以 S->R->T 的顺序应用
• getScaling 提取矩阵的缩放信息, 默认矩阵中的变换以 S->R->T 的顺序应用
• getRotation 提取矩阵的旋转信息, 默认输入矩阵不含有缩放信息，如考虑缩放应使用 toRTS 函数。
• toRTS 提取旋转、位移、缩放信息， 默认矩阵中的变换以 S->R->T 的顺序应用
• fromRTS 根据旋转、位移、缩放信息计算矩阵，以 S->R->T 的顺序应用
• fromRTSOrigin 根据指定的旋转、位移、缩放及变换中心信息计算矩阵，以 S->R->T 的顺序应用
• fromQuat 根据指定的旋转信息计算矩阵
• frustum 根据指定的视锥体信息计算矩阵
• perspective 计算透视投影矩阵
• ortho 计算正交投影矩阵
• lookAt 根据视点计算矩阵，注意 eye - center 不能为零向量或与 up 向量平行
• inverseTranspose 计算逆转置矩阵
• add 逐元素矩阵加法
• subtract 逐元素矩阵减法
• multiplyScalar 矩阵标量乘法
• multiplyScalarAndAdd 逐元素矩阵标量乘加: A + B * scale
• strictEquals 矩阵等价判断
• equals 排除浮点数误差的矩阵近似等价判断
• toArray 矩阵转数组
• fromArray 数组转矩阵
• constructor 构造函数，可查看 cc.mat4
• clone 克隆一个 Mat4 对象
• set 用另一个矩阵设置这个矩阵的值。
• equals 当前的矩阵是否与指定的矩阵相等。
• fuzzyEquals 近似判断两个矩阵是否相等。
• toString 转换为方便阅读的字符串。
• identity Set the matrix to the identity matrix
• transpose Transpose the values of a mat4
• invert Inverts a mat4
• adjoint Calculates the adjugate of a mat4
• determinant Calculates the determinant of a mat4
• add Adds two Mat4
• subtract Subtracts the current matrix with another one
• multiply Subtracts the current matrix with another one
• multiplyScalar Multiply each element of the matrix by a scalar.
• translate Translate a mat4 by the given vector
• scale Scales the mat4 by the dimensions in the given vec3
• rotate Rotates a mat4 by the given angle around the given axis
• getTranslation Returns the translation vector component of a transformation matrix.
• getScale Returns the scale factor component of a transformation matrix
• getRotation Returns the rotation factor component of a transformation matrix
• fromRTS Restore the matrix values from a quaternion rotation, vector translation and vector scale
• fromQuat Restore the matrix values from a quaternion rotation
• lerp 线性插值。

Details

属性（properties）

IDENTITY

Identity of Mat4

m

矩阵数据

方法

mul

将当前矩阵与指定矩阵相乘

参数列表

• other Mat4 the second operand
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

mulScalar

将矩阵的每一个元素都乘以指定的缩放值。

参数列表

• number Number amount to scale the matrix's elements by
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

sub

将当前矩阵与指定的矩阵相减

参数列表

• other Mat4 the second operand
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

clone

获得指定矩阵的拷贝

copy

复制目标矩阵

identity

将目标赋值为单位矩阵

transpose

转置矩阵

invert

矩阵求逆

determinant

矩阵行列式

multiply

矩阵乘法

transform

在给定矩阵变换基础上加入变换

translate

在给定矩阵变换基础上加入新位移变换

scale

在给定矩阵变换基础上加入新缩放变换

rotate

在给定矩阵变换基础上加入新旋转变换

参数列表

• rad Unknown 旋转角度
• axis Unknown 旋转轴

rotateX

在给定矩阵变换基础上加入绕 X 轴的旋转变换

参数列表

• rad Unknown 旋转角度

rotateY

在给定矩阵变换基础上加入绕 Y 轴的旋转变换

参数列表

• rad Unknown 旋转角度

rotateZ

在给定矩阵变换基础上加入绕 Z 轴的旋转变换

参数列表

• rad Unknown 旋转角度

fromTranslation

计算位移矩阵

fromScaling

计算缩放矩阵

fromRotation

计算旋转矩阵

fromXRotation

计算绕 X 轴的旋转矩阵

fromYRotation

计算绕 Y 轴的旋转矩阵

fromZRotation

计算绕 Z 轴的旋转矩阵

fromRT

根据旋转和位移信息计算矩阵

getTranslation

提取矩阵的位移信息, 默认矩阵中的变换以 S->R->T 的顺序应用

getScaling

提取矩阵的缩放信息, 默认矩阵中的变换以 S->R->T 的顺序应用

getRotation

提取矩阵的旋转信息, 默认输入矩阵不含有缩放信息，如考虑缩放应使用 toRTS 函数。

toRTS

提取旋转、位移、缩放信息， 默认矩阵中的变换以 S->R->T 的顺序应用

fromRTS

根据旋转、位移、缩放信息计算矩阵，以 S->R->T 的顺序应用

fromRTSOrigin

根据指定的旋转、位移、缩放及变换中心信息计算矩阵，以 S->R->T 的顺序应用

参数列表

• q Unknown 旋转值
• v Unknown 位移值
• s Unknown 缩放值
• o Unknown 指定变换中心

fromQuat

根据指定的旋转信息计算矩阵

frustum

根据指定的视锥体信息计算矩阵

参数列表

• left Unknown 左平面距离
• right Unknown 右平面距离
• bottom Unknown 下平面距离
• top Unknown 上平面距离
• near Unknown 近平面距离
• far Unknown 远平面距离

perspective

计算透视投影矩阵

参数列表

• fovy Unknown 纵向视角高度
• aspect Unknown 长宽比
• near Unknown 近平面距离
• far Unknown 远平面距离

ortho

计算正交投影矩阵

参数列表

• left Unknown 左平面距离
• right Unknown 右平面距离
• bottom Unknown 下平面距离
• top Unknown 上平面距离
• near Unknown 近平面距离
• far Unknown 远平面距离

lookAt

根据视点计算矩阵，注意 eye - center 不能为零向量或与 up 向量平行

参数列表

• eye Unknown 当前位置
• center Unknown 目标视点
• up Unknown 视口上方向

inverseTranspose

计算逆转置矩阵

add

逐元素矩阵加法

subtract

逐元素矩阵减法

multiplyScalar

矩阵标量乘法

multiplyScalarAndAdd

逐元素矩阵标量乘加: A + B * scale

strictEquals

矩阵等价判断

equals

排除浮点数误差的矩阵近似等价判断

toArray

矩阵转数组

参数列表

• ofs Unknown 数组内的起始偏移量

fromArray

数组转矩阵

参数列表

• ofs Unknown 数组起始偏移量

constructor

构造函数，可查看 cc.mat4

clone

克隆一个 Mat4 对象

set

用另一个矩阵设置这个矩阵的值。

参数列表

• srcObj Mat4

equals

当前的矩阵是否与指定的矩阵相等。

参数列表

• other Mat4

fuzzyEquals

近似判断两个矩阵是否相等。
判断 2 个矩阵是否在默认误差范围之内，如果在则返回 true，反之则返回 false。

参数列表

• other Mat4

toString

转换为方便阅读的字符串。

identity

Set the matrix to the identity matrix

transpose

Transpose the values of a mat4

参数列表

• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created.

invert

Inverts a mat4

参数列表

• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created.

adjoint

Calculates the adjugate of a mat4

参数列表

• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created.

determinant

Calculates the determinant of a mat4

add

Adds two Mat4

参数列表

• other Mat4 the second operand
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created.

subtract

Subtracts the current matrix with another one

参数列表

• other Mat4 the second operand

multiply

Subtracts the current matrix with another one

参数列表

• other Mat4 the second operand

multiplyScalar

Multiply each element of the matrix by a scalar.

参数列表

• number Number amount to scale the matrix's elements by

translate

Translate a mat4 by the given vector

参数列表

• v Vec3 vector to translate by
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

scale

Scales the mat4 by the dimensions in the given vec3

参数列表

• v Vec3 vector to scale by
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

rotate

Rotates a mat4 by the given angle around the given axis

参数列表

• rad Number the angle to rotate the matrix by
• axis Vec3 the axis to rotate around
• out Mat4 the receiving matrix, you can pass the same matrix to save result to itself, if not provided, a new matrix will be created

getTranslation

Returns the translation vector component of a transformation matrix.

参数列表

• out Vec3 Vector to receive translation component, if not provided, a new vec3 will be created

getScale

Returns the scale factor component of a transformation matrix

参数列表

• out Vec3 Vector to receive scale component, if not provided, a new vec3 will be created

getRotation

Returns the rotation factor component of a transformation matrix

参数列表

• out Quat Vector to receive rotation component, if not provided, a new quaternion object will be created

fromRTS

Restore the matrix values from a quaternion rotation, vector translation and vector scale

参数列表

• q Quat Rotation quaternion
• v Vec3 Translation vector
• s Vec3 Scaling vector

fromQuat

Restore the matrix values from a quaternion rotation

参数列表

• q Quat Rotation quaternion

lerp

线性插值。
当 ratio = 0 时返回自身，ratio = 1 时返回目标，ratio = 0.5 返回自身和目标的平均值。。

参数列表

• to ValueType the to value
• ratio number the interpolation coefficient