# 1、applyMatrix4
/**
* 对当前物体应用这个变换矩阵，并更新物体的位置、旋转和缩放。
*
* @param matrix 传入的4x4矩阵
* @returns 无返回值，直接修改对象的矩阵、位置、四元数和缩放值
*/
applyMatrix4( matrix ) {
// 如果自动更新矩阵为true，则更新局部矩阵
if ( this.matrixAutoUpdate ) this.updateMatrix();
// 将传入的矩阵与当前矩阵相乘
// 表示该matrix是在当前matrix之后才应用给当前对象的
// 相当于 this.matrix = matrix * this.matrix;
this.matrix.premultiply( matrix );
// 分解当前矩阵为位置、四元数和缩放值
this.matrix.decompose( this.position, this.quaternion, this.scale );
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 2、updateMatrix
/**
* 更新局部矩阵
*
* 将位置、四元数和缩放组合到矩阵中，并标记矩阵世界需要更新
*/
updateMatrix() {
// 将位置、四元数和缩放组合到矩阵中
this.matrix.compose( this.position, this.quaternion, this.scale );
// 标记世界矩阵需要更新
this.matrixWorldNeedsUpdate = true;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 3、updateMatrixWorld
/**
* 更新对象的世界矩阵
*
* @param force 是否强制更新，即使 matrixWorldNeedsUpdate 为 false
*/
updateMatrixWorld( force ) {
// 如果 matrixAutoUpdate 为 true，则更新局部矩阵
if ( this.matrixAutoUpdate ) this.updateMatrix();
// 如果 matrixWorldNeedsUpdate 为 true 或者 force 为 true
if ( this.matrixWorldNeedsUpdate || force ) {
// 如果 matrixWorldAutoUpdate 为 true
if ( this.matrixWorldAutoUpdate === true ) {
// 如果 parent 为 null
if ( this.parent === null ) {
// 将 matrix 复制到 matrixWorld
this.matrixWorld.copy( this.matrix );
// 否则
} else {
// 将 parent 的 matrixWorld 和自身的 matrix 相乘，结果赋值给 matrixWorld
this.matrixWorld.multiplyMatrices( this.parent.matrixWorld, this.matrix );
}
}
// 将 matrixWorldNeedsUpdate 设置为 false
this.matrixWorldNeedsUpdate = false;
// 将 force 设置为 true
force = true;
}
// 确保如果需要，则更新子节点
// make sure descendants are updated if required
const children = this.children;
for ( let i = 0, l = children.length; i < l; i ++ ) {
const child = children[ i ];
// 递归调用子节点的 updateMatrixWorld 方法
child.updateMatrixWorld( force );
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 4、getWorldDirection
返回一个表示该物体在世界空间中Z轴正方向的矢量。
/**
* 获取世界方向
*
* @param target 目标向量，用于存储结果
* @returns 返回经过归一化的目标向量，表示当前对象在世界空间中的方向
*/
getWorldDirection( target ) {
// 更新世界矩阵
this.updateWorldMatrix( true, false );
// 获取矩阵元素的数组
const e = this.matrixWorld.elements;
// 设置目标向量的 x、y、z 分量，并返回归一化后的向量
// 这里假设 target 是一个向量对象，具有 set 和 normalize 方法
return target.set( e[ 8 ], e[ 9 ], e[ 10 ] ).normalize();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
阅读量：