阅读数:221 评论数:0

一、概述

THREE.Object3D 是 Three.js 的基础类，用于表示 3D 空间中的一个对象。几乎所有的 3D 对象（如 Mesh、Group、Camera、Light 等）都继承自 THREE.Object3D，它定义了这些对象的基本属性和行为，如位置、旋转、缩放、层次关系等。

二、核心属性

（1）空间变换相关

• position: 对象的位置，类型为 THREE.Vector3，默认值为 (0, 0, 0)。
• rotation: 对象的旋转，类型为 THREE.Euler，表示欧拉角（以弧度为单位）。
• quaternion: 对象的旋转（四元数表示），可用于替代欧拉角。
• scale: 对象的缩放比例，类型为 THREE.Vector3，默认值为 (1, 1, 1)。
• matrix: 对象的世界变换矩阵，描述其在 3D 空间中的位置、旋转和缩放。
• matrixWorld: 世界空间中的变换矩阵（包括父对象的影响）。

（2）层次关系

• parent: 当前对象的父对象。
• children: 包含的子对象数组，类型为 THREE.Object3D[]。

（3）其他属性

• visible: 是否可见，默认为 true。
• castShadow: 是否投射阴影。
• receiveShadow: 是否接收阴影。
• name: 对象的名称，便于标识和查找。
• userData: 自定义数据存储，类型为 Object。

三、核心方法

1、层次管理

• add(child): 将一个子对象添加到当前对象。
• remove(child): 从当前对象移除一个子对象。
• getObjectByName(name): 根据名称查找子对象。
• traverse(callback): 遍历当前对象及其所有子对象，并对每个对象执行回调函数。

2、空间变换

• translateX(distance) / translateY(distance) / translateZ(distance): 沿 X、Y、Z 轴移动指定距离。
• lookAt(vector): 使对象朝向指定位置。
• rotateX(angle) / rotateY(angle) / rotateZ(angle): 绕 X、Y、Z 轴旋转指定角度。
• localToWorld(vector): 将局部坐标转换为世界坐标。
• worldToLocal(vector): 将世界坐标转换为局部坐标。