Class Matrix4x4

Matrix4x4 类表示一个转换矩阵，该矩阵确定三维 (3D) 显示对象的位置和方向。该矩阵可以执行转换功能，包括平移（沿 x、y 和 z 轴重新定位）、旋转和缩放（调整大小）。 Matrix4x4 类还可以执行透视投影，这会将 3D 坐标空间中的点映射到二维 (2D) 视图。

 ---                                   ---
 |   scaleX      0         0       0     |   x轴
 |     0       scaleY      0       0     |   y轴
 |     0         0       scaleZ    0     |   z轴
 |     tx        ty        tz      1     |   平移
 ---                                   ---

 ---                                   ---
 |     0         1         2        3    |   x轴
 |     4         5         6        7    |   y轴
 |     8         9         10       11   |   z轴
 |     12        13        14       15   |   平移
 ---                                   ---

See

Hierarchy

Matrix4x4

Constructors

constructor

new Matrix4x4(rawData?): Matrix4x4
创建 Matrix4x4 对象。
Parameters
- Optional rawData: Number16
  
  一个由 16 个数字组成的矢量，其中，每四个元素可以是 4x4 矩阵的一列。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:130

Properties

elements

elements: Number16

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

Accessors

determinant

get determinant(): number
一个用于确定矩阵是否可逆的数字。如果值为0则不可逆。

Returns number
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:95

Methods

append

append(lhs): Matrix4x4
通过将另一个 Matrix4x4 对象与当前 Matrix4x4 对象相乘来后置一个矩阵。
Parameters
- lhs: Number16 | {
  elements: Number16;
  }
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:170

appendRotation

appendRotation(axis, degrees, pivotPoint?): Matrix4x4
在 Matrix4x4 对象上后置一个增量旋转。
Parameters
- axis: Vector3
  
  旋转轴
- degrees: number
  
  角度
- Optional pivotPoint: Vector3
  
  旋转中心点
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:179

appendScale

appendScale(sx, sy, sz): Matrix4x4
在 Matrix4x4 对象上后置一个增量缩放，沿 x、y 和 z 轴改变位置。
Parameters
- sx: number
  
  用于沿 x 轴缩放对象的乘数。
- sy: number
  
  用于沿 y 轴缩放对象的乘数。
- sz: number
  
  用于沿 z 轴缩放对象的乘数。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:186

appendTranslation

appendTranslation(x, y, z): Matrix4x4
在 Matrix4x4 对象上后置一个增量平移，沿 x、y 和 z 轴重新定位。
Parameters
- x: number
  
  沿 x 轴的增量平移。
- y: number
  
  沿 y 轴的增量平移。
- z: number
  
  沿 z 轴的增量平移。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:193

clone

clone(): Matrix4x4
返回一个新 Matrix4x4 对象，它是与当前 Matrix4x4 对象完全相同的副本。

Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:197

copy

copy(source): Matrix4x4
将源 Matrix4x4 对象中的所有矩阵数据复制到调用方 Matrix4x4 对象中。
Parameters
- source: Matrix4x4
  
  要从中复制数据的 Matrix4x4 对象。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:202

equals

equals(matrix, precision?): boolean
比较矩阵是否相等
Parameters
- matrix: Matrix4x4
- Optional precision: number
Returns boolean
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:343

fromArray

fromArray(array, index?, transpose?): Matrix4x4
从数组中初始化
Parameters
- array: number[]
  
  包含矩阵数据的数组
- Optional index: number
  
  数组中的起始位置
- Optional transpose: boolean
  
  是否转置
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:210

fromAxisRotate

fromAxisRotate(axis, degrees): Matrix4x4
从轴与旋转角度创建矩阵
Parameters
- axis: Vector3
  
  旋转轴
- degrees: number
  
  角度
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:166

fromPosition

fromPosition(x, y, z): Matrix4x4
创建位移矩阵
Parameters
- x: number
  
  沿 x 轴的增量平移。
- y: number
  
  沿 y 轴的增量平移。
- z: number
  
  沿 z 轴的增量平移。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:137

fromQuaternion

fromQuaternion(q): Matrix4x4
从四元素初始化矩阵。
Parameters
- q: Quaternion
  
  四元素
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:159

fromRotation

fromRotation(rx, ry, rz, order?): Matrix4x4
从欧拉角旋转角度初始化矩阵。
Parameters
- rx: number
  
  用于沿 x 轴旋转对象的角度。
- ry: number
  
  用于沿 y 轴旋转对象的角度。
- rz: number
  
  用于沿 z 轴旋转对象的角度。
- Optional order: RotationOrder
  
  绕轴旋转的顺序。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:153

fromScale

fromScale(sx, sy, sz): Matrix4x4
创建缩放矩阵
Parameters
- sx: number
  
  用于沿 x 轴缩放对象的乘数。
- sy: number
  
  用于沿 y 轴缩放对象的乘数。
- sz: number
  
  用于沿 z 轴缩放对象的乘数。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:144

fromTRS

fromTRS(position, rotation, scale, order?): Matrix4x4
通过位移旋转缩放重组矩阵
Parameters
- position: Vector3
  
  位移
- rotation: Vector3
  
  旋转角度，按照指定旋转顺序旋转角度。
- scale: Vector3
  
  缩放。
- Optional order: RotationOrder
  
  旋转顺序。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:231

getAxisX

getAxisX(out?): Vector3
获取X轴向量
Parameters
- Optional out: Vector3
  
  保存X轴向量
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:101

getAxisY

getAxisY(out?): Vector3
获取Y轴向量
Parameters
- Optional out: Vector3
  
  保存Y轴向量
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:113

getAxisZ

getAxisZ(out?): Vector3
获取Z轴向量
Parameters
- Optional out: Vector3
  
  保存Z轴向量
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:125

getMaxScaleOnAxis

getMaxScaleOnAxis(): number
获取XYZ轴中最大缩放值

Returns number
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:353

getPosition

getPosition(value?): Vector3
获取位移
Parameters
- Optional value: Vector3
  
  用于存储位移信息的向量
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:59

getRotation

getRotation(rotation?, order?): Vector3
获取欧拉旋转角度。
Parameters
- Optional rotation: Vector3
  
  欧拉旋转角度。
- Optional order: RotationOrder
  
  绕轴旋转的顺序。
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:72

getScale

getScale(scale?): Vector3
获取缩放值。
Parameters
- Optional scale: Vector3
  
  用于存储缩放值的向量。
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:85

identity

identity(): Matrix4x4
将当前矩阵转换为恒等或单位矩阵。

Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:244

invert

invert(): Matrix4x4
反转当前矩阵。逆矩阵

Returns Matrix4x4
如果成功反转矩阵，则返回该矩阵。
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:249

lookAt

lookAt(target, upAxis?): Matrix4x4
看向目标位置
Parameters
- target: Vector3
  
  目标位置
- Optional upAxis: Vector3
  
  向上朝向
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:349

moveForward

moveForward(distance): Matrix4x4
Z轴方向移动
Parameters
- distance: number
  
  移动距离
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:291

moveRight

moveRight(distance): Matrix4x4
X轴方向移动
Parameters
- distance: number
  
  移动距离
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:281

moveUp

moveUp(distance): Matrix4x4
Y轴方向移动
Parameters
- distance: number
  
  移动距离
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:286

prepend

prepend(rhs): Matrix4x4
通过将当前 Matrix4x4 对象与另一个 Matrix4x4 对象相乘来前置一个矩阵。得到的结果将合并两个矩阵转换。
Parameters
- rhs: Matrix4x4
  
  个右侧矩阵，它与当前 Matrix4x4 对象相乘。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:254

prependRotation

prependRotation(axis, degrees, _pivotPoint?): Matrix4x4
在 Matrix4x4 对象上前置一个增量旋转。在将 Matrix4x4 对象应用于显示对象时，矩阵会在 Matrix4x4 对象中先执行旋转，然后再执行其他转换。
Parameters
- axis: Vector3
  
  旋转的轴或方向。常见的轴为 X_AXIS (Vector3(1,0,0))、Y_AXIS (Vector3(0,1,0)) 和 Z_AXIS (Vector3(0,0,1))。此矢量的长度应为 1。
- degrees: number
  
  旋转的角度。
- Optional _pivotPoint: Vector3
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:261

prependScale

prependScale(xScale, yScale, zScale): Matrix4x4
在 Matrix4x4 对象上前置一个增量缩放，沿 x、y 和 z 轴改变位置。在将 Matrix4x4 对象应用于显示对象时，矩阵会在 Matrix4x4 对象中先执行缩放更改，然后再执行其他转换。
Parameters
- xScale: number
  
  用于沿 x 轴缩放对象的乘数。
- yScale: number
  
  用于沿 y 轴缩放对象的乘数。
- zScale: number
  
  用于沿 z 轴缩放对象的乘数。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:268

prependScale1

prependScale1(xScale, yScale, zScale): Matrix4x4
Parameters
- xScale: number
- yScale: number
- zScale: number
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:269

prependTranslation

prependTranslation(x, y, z): Matrix4x4
在 Matrix4x4 对象上前置一个增量平移，沿 x、y 和 z 轴重新定位。在将 Matrix4x4 对象应用于显示对象时，矩阵会在 Matrix4x4 对象中先执行平移更改，然后再执行其他转换。
Parameters
- x: number
  
  沿 x 轴的增量平移。
- y: number
  
  沿 y 轴的增量平移。
- z: number
  
  沿 z 轴的增量平移。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:276

random

random(): Matrix4x4
随机矩阵。

Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:222

setAxisX

setAxisX(vector?): Matrix4x4
设置X轴向量
Parameters
- Optional vector: Vector3
  
  X轴向量
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:107

setAxisY

setAxisY(vector?): Matrix4x4
设置Y轴向量
Parameters
- Optional vector: Vector3
  
  X轴向量
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:119

setOrtho

setOrtho(left, right, top, bottom, near, far): Matrix4x4
初始化正射投影矩阵
Parameters
- left: number
  
  可视空间左边界
- right: number
  
  可视空间右边界
- top: number
  
  可视空间上边界
- bottom: number
  
  可视空间下边界
- near: number
  
  可视空间近边界
- far: number
  
  可视空间远边界
  
  可视空间的八个顶点分别被投影到立方体 [(-1, -1, -1), (1, 1, 1)] 八个顶点上
  
  将长方体 [(left, bottom, near), (right, top, far)] 投影至立方体 [(-1, -1, -1), (1, 1, 1)] 中
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:367

setPerspective

setPerspective(left, right, top, bottom, near, far): Matrix4x4
初始化透视投影矩阵
Parameters
- left: number
  
  可视空间左边界
- right: number
  
  可视空间右边界
- top: number
  
  可视空间上边界
- bottom: number
  
  可视空间下边界
- near: number
  
  可视空间近边界
- far: number
  
  可视空间远边界
  
  可视空间的八个顶点分别被投影到立方体 [(-1, -1, -1), (1, 1, 1)] 八个顶点上
  
  将长方体 [(left, bottom, near), (right, top, far)] 投影至立方体 [(-1, -1, -1), (1, 1, 1)] 中
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:391

setPerspectiveFromFOV

setPerspectiveFromFOV(fov, aspect, near, far): Matrix4x4
初始化透视投影矩阵
Parameters
- fov: number
  
  垂直视角，视锥体顶面和底面间的夹角，必须大于0 （角度）
- aspect: number
  
  近裁剪面的宽高比
- near: number
  
  视锥体近边界
- far: number
  
  视锥体远边界
  
  视锥体的八个顶点分别被投影到立方体 [(-1, -1, -1), (1, 1, 1)] 八个顶点上
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:377

setPosition

setPosition(value): Matrix4x4
设置位移
Parameters
- value: Vector3
  
  位移
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:65

setRotation

setRotation(rotation, order?): Matrix4x4
设置欧拉旋转角度。
Parameters
- rotation: Vector3
  
  欧拉旋转角度。
- Optional order: RotationOrder
  
  绕轴旋转的顺序。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:79

setScale

setScale(scale): Matrix4x4
获取缩放值。
Parameters
- scale: Vector3
  
  缩放值。
Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:91

toArray

toArray(array?, index?, transpose?): number[] | Float32Array
将矩阵数据转换为数组
Parameters
- Optional array: number[] | Float32Array
  
  保存矩阵数据的数组
- Optional index: number
  
  数组中的起始位置
- Optional transpose: boolean
  
  是否转置
Returns number[] | Float32Array
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:218

toMatrix3x3

toMatrix3x3(out?): Matrix3x3
转换为3x3矩阵
Parameters
- Optional out: Matrix3x3
  
  3x3矩阵
Returns Matrix3x3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:397

toString

toString(): string
以字符串返回矩阵的值

Returns string
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:401

toTRS

toTRS(position?, rotation?, scale?, order?): Vector3[]
把矩阵分解为位移旋转缩放。
Parameters
- Optional position: Vector3
  
  位移
- Optional rotation: Vector3
  
  旋转角度，按照指定旋转顺序旋转。
- Optional scale: Vector3
  
  缩放。
- Optional order: RotationOrder
  
  旋转顺序。
Returns Vector3[]
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:240

transformPoint3

transformPoint3(vIn, vOut?): Vector3
使用转换矩阵将 Vector3 对象从一个空间坐标转换到另一个空间坐标。
Parameters
- vIn: Vector3
  
  一个容纳要转换的坐标的 Vector3 对象。
- Optional vOut: Vector3
Returns Vector3
一个包含转换后的坐标的 Vector3 对象。
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:297

transformPoints

transformPoints(vIn, vOut?): number[]
变换坐标数组数据
Parameters
- vIn: number[]
  
  被变换坐标数组数据
- Optional vOut: number[]
  
  变换后的坐标数组数据
Returns number[]
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:320

transformRay

transformRay(inRay, outRay?): Ray3
使用转换矩阵将 Ray3 对象从一个空间坐标转换到另一个空间坐标。
Parameters
- inRay: Ray3
  
  被转换的Ray3。
- Optional outRay: Ray3
  
  转换后的Ray3。
Returns Ray3
转换后的Ray3。
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:335

transformRotation

transformRotation(vIn, vOut?): Vector3
变换旋转角度
Parameters
- vIn: Vector3
  
  被变换的旋转角度
- Optional vOut: Vector3
  
  变换后的旋转角度
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:327

transformVector3

transformVector3(vIn, vOut?): Vector3
变换Vector3向量

与变换点不同，并不会受到矩阵平移分量的影响。
Parameters
- vIn: Vector3
  
  被变换的向量
- Optional vOut: Vector3
  
  变换后的向量
Returns Vector3
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:306

transformVector4

transformVector4(vIn, vOut?): Vector4
变换Vector4向量
Parameters
- vIn: Vector4
  
  被变换的向量
- Optional vOut: Vector4
  
  变换后的向量
Returns Vector4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:313

transpose

transpose(): Matrix4x4
将当前 Matrix4x4 对象转换为一个矩阵，并将互换其中的行和列。

Returns Matrix4x4
- Defined in node_modules/@feng3d/math/lib/geom/Matrix4x4.d.ts:339

Class Matrix4x4

See

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Optional rawData: Number16

Returns Matrix4x4

Properties

elements

Accessors

determinant

Returns number

Methods

append

Parameters

lhs: Number16 | { elements: Number16; }

Returns Matrix4x4

appendRotation

Parameters

axis: Vector3

degrees: number

Optional pivotPoint: Vector3

Returns Matrix4x4

appendScale

Parameters

sx: number

sy: number

sz: number

Returns Matrix4x4

appendTranslation

Parameters

x: number

y: number

z: number

Returns Matrix4x4

clone

Returns Matrix4x4

copy

Parameters

source: Matrix4x4

Returns Matrix4x4

equals

Parameters

matrix: Matrix4x4

Optional precision: number

Returns boolean

fromArray

Parameters

array: number[]

Optional index: number

Optional transpose: boolean

Returns Matrix4x4

fromAxisRotate

Parameters

axis: Vector3

degrees: number

Returns Matrix4x4

fromPosition

Parameters

x: number

y: number

z: number

Returns Matrix4x4

fromQuaternion

Parameters

q: Quaternion

Returns Matrix4x4

fromRotation

Parameters

rx: number

ry: number

rz: number

Optional order: RotationOrder

Returns Matrix4x4

`Optional` rawData: Number16

lhs: Number16 | {
elements: Number16;
}

`Optional` pivotPoint: Vector3

`Optional` precision: number

`Optional` index: number

`Optional` transpose: boolean

`Optional` order: RotationOrder

`Optional` order: RotationOrder

`Optional` out: Vector3

`Optional` out: Vector3

`Optional` out: Vector3

`Optional` value: Vector3

`Optional` rotation: Vector3

`Optional` order: RotationOrder

`Optional` scale: Vector3

`Optional` upAxis: Vector3

`Optional` _pivotPoint: Vector3