Class: Matrix4 ​

4*4 的矩阵

Properties ​

• blockBytes
• count
• EPSILON
• index
• help_matrix_0
• help_matrix_1
• help_matrix_2
• rawData

Methods ​

• init
• lookAt
• multiply
• multiplyMatrices
• multiplyPoint3
• multiplyVector4
• transformVector4
• perspectiveMultiplyPoint3
• perspective
• ortho
• orthoZO
• orthoOffCenter
• transformDir
• fromToRotation
• append
• add
• sub
• mult
• appendRotation
• createByRotation
• appendScale
• createByScale
• appendTranslation
• clone
• copyRowFrom
• copyRowTo
• copyFrom
• copyRawDataTo
• copyColFrom
• copyColTo
• copyToMatrix3D
• makeRotationFromQuaternion
• decompose
• getEuler
• compose
• deltaTransformVector
• identity
• fill
• invers33
• invert
• transformPoint
• transformVector
• transpose
• getAxisRotation
• getPosition
• toString
• lerp
• get
• set
• getMaxScaleOnAxis
• sanitizeEuler
• makePositive
• matrixToEuler
• translate
• setTRInverse
• setScale
• matrix_Multiply
• matrix_Append
• matrix_RotateY
• matrix_Rotate
• makeBasis
• setElements
• makeRotationAxis

Constructors ​

• constructor

Accessors ​

• determinant
• position
• scale

Properties ​

blockBytes ​

▪ Static blockBytes: number

区块大小

Defined in ​

src/engine/math/Matrix4.ts:15

count ​

▪ Static count: number = 31000

初始化的区块数量

Defined in ​

src/engine/math/Matrix4.ts:25

EPSILON ​

▪ Static EPSILON: number = 0.000001

保留的最小精度

Defined in ​

src/engine/math/Matrix4.ts:30

index ​

• index: number = 0

矩阵索引值

Defined in ​

src/engine/math/Matrix4.ts:35

help_matrix_0 ​

▪ Static help_matrix_0: Matrix4

临时缓存矩阵

Defined in ​

src/engine/math/Matrix4.ts:57

help_matrix_1 ​

▪ Static help_matrix_1: Matrix4

临时缓存矩阵

Defined in ​

src/engine/math/Matrix4.ts:62

help_matrix_2 ​

▪ Static help_matrix_2: Matrix4

临时缓存矩阵

Defined in ​

src/engine/math/Matrix4.ts:67

rawData ​

• rawData: Float32Array

Language

zh_CN 一个由 16 个数字组成的矢量，其中，每四个元素可以是 4x4 矩阵的一行或一列

Version

UU3D 3.0

Platform

Web,Native

Defined in ​

src/engine/math/Matrix4.ts:133

Methods ​

init ​

▸ Static init(count): Promise<void>

初始化矩阵，分配wasm内存

Parameters ​

Returns ​

Promise<void>

Defined in ​

src/engine/math/Matrix4.ts:86

lookAt ​

▸ lookAt(eye, at, up?): void

Language

zh_CN 生成一个注视目标的矩阵.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:169

multiply ​

▸ multiply(mat4): void

Language

zh_CN 矩阵相乘.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:223

multiplyMatrices ​

▸ multiplyMatrices(a, b): Matrix4

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:266

multiplyPoint3 ​

▸ multiplyPoint3(v, output?): Vector3

当前矩阵与3维相乘

Parameters ​

Returns ​

Vector3

结果向量

Defined in ​

src/engine/math/Matrix4.ts:312

multiplyVector4 ​

▸ multiplyVector4(a, out?): Vector3

Parameters ​

Returns ​

Vector3

Defined in ​

src/engine/math/Matrix4.ts:323

transformVector4 ​

▸ transformVector4(v, target?): Vector3

Language

zh_CN 用当前矩阵变换一个3D向量

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Vector3

Vector3 变换后的向量

Defined in ​

src/engine/math/Matrix4.ts:359

perspectiveMultiplyPoint3 ​

▸ perspectiveMultiplyPoint3(v, output): boolean

将投影坐标转换为3D坐标

Parameters ​

Returns ​

boolean

Defined in ​

src/engine/math/Matrix4.ts:385

perspective ​

▸ perspective(fov, aspect, zn, zf): void

Language

zh_CN 生成一个透视投影矩阵.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:468

ortho ​

▸ ortho(w, h, zn, zf): void

Language

zh_CN 生成一个透视投影矩阵.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:506

orthoZO ​

▸ orthoZO(left, right, bottom, top, near, far): Matrix4

计算一个正交投影矩阵。

Parameters ​

Returns ​

Matrix4

结果矩阵

Defined in ​

src/engine/math/Matrix4.ts:540

orthoOffCenter ​

▸ orthoOffCenter(l, r, b, t, zn, zf): void

Language

zh_CN 生成一个透视投影矩阵.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:576

transformDir ​

▸ transformDir(fromDirection, toDirection): void

Language

zh_CN 计算出一个方向变换到另一个方向的旋转矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:608

fromToRotation ​

▸ Static fromToRotation(fromDirection, toDirection, target?): Matrix4

Language

zh_CN 计算出一个方向变换到另一个方向的旋转矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

Matrix4 计算出的旋转矩阵 如果 target为null 就会创建新实例返回

Defined in ​

src/engine/math/Matrix4.ts:713

append ​

▸ append(lhs): void

Language

zh_CN 通过将当前 Matrix4 对象与另一个 Matrix4 对象相乘来前置一个矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:729

add ​

▸ add(lhs): Matrix4

Language

zh_CN 矩阵相加.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

Matrix4 相加后的结果.

Defined in ​

src/engine/math/Matrix4.ts:777

sub ​

▸ sub(lhs): Matrix4

Language

zh_CN 矩阵相减.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

Matrix4 相加减的结果.

Defined in ​

src/engine/math/Matrix4.ts:842

mult ​

▸ mult(v): Matrix4

Language

zh_CN 矩阵乘分量.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

Matrix4 返回一个相乘后的结果 矩阵.

Defined in ​

src/engine/math/Matrix4.ts:908

appendRotation ​

▸ appendRotation(degrees, axis): void

Language

zh_CN 给当前矩阵追加一个方向角旋转 (按axis轴旋转degrees角度创建出来的矩阵)

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:958

createByRotation ​

▸ createByRotation(degrees, axis): void

Language

zh_CN 根据坐标轴和旋转角，创建矩阵 (按axis轴旋转degrees角度创建出来的矩阵)

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:971

appendScale ​

▸ appendScale(xScale, yScale, zScale): void

Language

zh_CN 追加三轴缩放值

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1048

createByScale ​

▸ createByScale(xScale, yScale, zScale): void

Language

zh_CN 生成一个缩放矩阵，其他的属性会被重置

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1062

appendTranslation ​

▸ appendTranslation(x, y, z): void

Language

zh_CN 加上一个平移矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1091

clone ​

▸ clone(): Matrix4

Language

zh_CN 返回一个当前矩阵的克隆矩阵

Version

UU3D 3.0

Platform

Web,Native

Returns ​

Matrix4

Matrix4 克隆后的矩阵

Defined in ​

src/engine/math/Matrix4.ts:1105

copyRowFrom ​

▸ copyRowFrom(row, Vector3): void

Language

zh_CN 给当前矩阵其中一行赋值

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1119

copyRowTo ​

▸ copyRowTo(row, Vector3): void

Language

zh_CN 拷贝矩阵中的其中一行 把值存在Vector3.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1159

copyFrom ​

▸ copyFrom(sourceMatrix3D): Matrix4

Language

zh_CN 把一个矩阵的值赋给当前矩阵.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

返回当前矩阵

Defined in ​

src/engine/math/Matrix4.ts:1199

copyRawDataTo ​

▸ copyRawDataTo(vector, index?, transpose?): void

Language

zh_CN 把当前矩阵的值拷贝给一个 float 数组.

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1229

copyColFrom ​

▸ copyColFrom(col, Vector3): void

Language

zh_CN 给当前矩阵的某一列 赋值

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1257

copyColTo ​

▸ copyColTo(col, Vector3): void

Language

zh_CN 拷贝当前矩阵的某一列

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1297

copyToMatrix3D ​

▸ copyToMatrix3D(dest): void

Language

zh_CN 拷贝当前矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1336

makeRotationFromQuaternion ​

▸ makeRotationFromQuaternion(quaternion): Matrix4

计算旋转矩阵

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:1348

decompose ​

▸ decompose(orientationStyle?, target?): Vector3[]

Language

zh_CN 分解当前矩阵

See

• fly.Orientation3D.AXIS_ANGLE
• fly.Orientation3D.EULER_ANGLES
• fly.Orientation3D.QUATERNION

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Vector3[]

Vector3[3] pos rot scale

Defined in ​

src/engine/math/Matrix4.ts:1466

getEuler ​

▸ Static getEuler(target, quaternion, isDegree?, order?): Vector3

获取欧拉向量

Parameters ​

Returns ​

Vector3

Defined in ​

src/engine/math/Matrix4.ts:1590

compose ​

▸ compose(position, quaternion, scale): Matrix4

计算位移、旋转、缩放组合矩阵

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:1603

deltaTransformVector ​

▸ deltaTransformVector(v, target?): Vector3

Language

zh_CN 当前矩阵变换一个向量

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Vector3

Vector3 变换后的向量

Defined in ​

src/engine/math/Matrix4.ts:1659

identity ​

▸ identity(): Matrix4

Language

zh_CN 单位化当前矩阵

Version

UU3D 3.0

Platform

Web,Native

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:1681

fill ​

▸ fill(value): void

Language

zh_CN 填充当前矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1710

invers33 ​

▸ invers33(): void

Language

zh_CN 当前矩阵求逆

Version

UU3D 3.0

Platform

Web,Native

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:1736

invert ​

▸ invert(): boolean

Language

zh_CN 当前矩阵求逆

Version

UU3D 3.0

Platform

Web,Native

Returns ​

boolean

boolean 是否能求逆

Defined in ​

src/engine/math/Matrix4.ts:1834

transformPoint ​

▸ transformPoint(v, target?): Vector3

将当前坐标转换为世界坐标

Parameters ​

Returns ​

Vector3

世界坐标

Defined in ​

src/engine/math/Matrix4.ts:1993

transformVector ​

▸ transformVector(v, target?): Vector3

Language

zh_CN 用当前矩阵变换一个3D向量 不处理位移

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Vector3

Vector3 变换后的向量

Defined in ​

src/engine/math/Matrix4.ts:2020

transpose ​

▸ transpose(): void

Language

zh_CN 当前矩阵转置

Version

UU3D 3.0

Platform

Web,Native

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2044

getAxisRotation ​

▸ Static getAxisRotation(x, y, z, degrees): Matrix4

Language

zh_CN 生成一个(以x,y,z为中心轴旋转degrees角度)的矩阵

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

Matrix4

Matrix4 矩阵

Defined in ​

src/engine/math/Matrix4.ts:2076

getPosition ​

▸ getPosition(out?): Vector3

返回矩阵位移

Parameters ​

Returns ​

Vector3

位移

Defined in ​

src/engine/math/Matrix4.ts:2129

toString ​

▸ toString(): string

Language

zh_CN 以字符串返回矩阵的值

Version

UU3D 3.0

Platform

Web,Native

Returns ​

string

string 字符

Defined in ​

src/engine/math/Matrix4.ts:2203

lerp ​

▸ lerp(m0, m1, t): void

Language

zh_CN 求两个矩阵之间的插值

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2251

get ​

▸ get(row, column): number

读取矩阵元素值

Parameters ​

Returns ​

number

Defined in ​

src/engine/math/Matrix4.ts:2262

set ​

▸ set(row, column, v): void

设置矩阵元素值

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2272

getMaxScaleOnAxis ​

▸ getMaxScaleOnAxis(): number

Language

zh_CN 求矩阵在各个轴上缩放的最大值

Version

UU3D 4.0

Platform

Web,Native

Returns ​

number

Defined in ​

src/engine/math/Matrix4.ts:2282

sanitizeEuler ​

▸ Static sanitizeEuler(euler): void

整理欧拉值

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2296

makePositive ​

▸ Static makePositive(euler): void

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2304

matrixToEuler ​

▸ Static matrixToEuler(matrix, v): boolean

将矩阵转换为欧拉角

Parameters ​

Returns ​

boolean

Defined in ​

src/engine/math/Matrix4.ts:2324

translate ​

▸ translate(inTrans): Matrix4

根据向量计算位移

Parameters ​

Returns ​

Matrix4

当前矩阵

Defined in ​

src/engine/math/Matrix4.ts:2360

setTRInverse ​

▸ setTRInverse(pos, q): void

form unity API

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2378

setScale ​

▸ setScale(inScale): Matrix4

缩放

Parameters ​

Returns ​

Matrix4

当前矩阵

Defined in ​

src/engine/math/Matrix4.ts:2389

matrix_Multiply ​

▸ Static matrix_Multiply(aMat, bMat, target_Mat): void

世界矩阵间相乘，根据索引指定参数与结果

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2418

matrix_Append ​

▸ Static matrix_Append(aMat, bMat, target_Mat): void

世界矩阵间伸展，根据索引指定参数与结果

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2428

matrix_RotateY ​

▸ Static matrix_RotateY(rad, target_Mat): void

世界矩阵间延Y轴旋转，根据索引指定参数与结果

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2438

matrix_Rotate ​

▸ Static matrix_Rotate(rad, axis, target_Mat): void

世界矩阵间旋转，根据索引指定参数与结果

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2448

makeBasis ​

▸ makeBasis(xAxis, yAxis, zAxis): Matrix4

根据三轴生成矩阵

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:2458

setElements ​

▸ setElements(n11, n12, n13, n14, n21, n22, n23, n24, n31, n32, n33, n34, n41, n42, n43, n44): Matrix4

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:2469

makeRotationAxis ​

▸ makeRotationAxis(axis, angle): Matrix4

Parameters ​

Returns ​

Matrix4

Defined in ​

src/engine/math/Matrix4.ts:2482

Constructors ​

constructor ​

• new Matrix4(noWasm?)

构造函数，创建一个矩阵实例

Language

zh_CN

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Defined in ​

src/engine/math/Matrix4.ts:142

Accessors ​

determinant ​

• get determinant(): number

Language

zh_CN 返回矩阵行列式

Version

UU3D 3.0

Platform

Web,Native

Returns ​

number

number 行列式值

Defined in ​

src/engine/math/Matrix4.ts:2112

position ​

• get position(): Vector3

Language

zh_CN 返回矩阵位移

Version

UU3D 3.0

Platform

Web,Native

Returns ​

Vector3

Vector3 位移

Defined in ​

src/engine/math/Matrix4.ts:2148

• set position(value): void

Language

zh_CN 设置矩阵位移

Version

UU3D 3.0

Platform

Web,Native

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2161

scale ​

• get scale(): Vector3

Language

zh_CN 返回矩阵缩放

Version

UU3D 3.0

Platform

Web,Native

Returns ​

Vector3

Vector3 缩放

Defined in ​

src/engine/math/Matrix4.ts:2176

• set scale(value): void

设置矩阵缩放

Parameters ​

Returns ​

void

Defined in ​

src/engine/math/Matrix4.ts:2184