场景树与对象管理

使用 Object3D 和 Group 组织父子对象,掌握 visible、name、userData 与 Box3 包围盒。

🎯 引言

学完这篇文章,你能把复杂模型拆成容易管理的层级,按名字或业务数据找到对象,控制一组对象的显示与变换,并用包围盒计算模型中心和尺寸。

🧱 Object3D 是共同基类

Scene、Camera、Mesh、Group 等对象都继承自 Object3D,因此它们都有 position、rotation、scale、visible、parent 和 children 等属性。

const building = new THREE.Group();
building.name = 'building';

const body = new THREE.Mesh(bodyGeometry, bodyMaterial);
body.name = 'body';
body.userData = { type: 'building-part', id: 'body-01' };

const roof = new THREE.Mesh(roofGeometry, roofMaterial);
roof.name = 'roof';
building.add(body, roof);
scene.add(building);

父级变换会影响所有后代,visible = false 会让整个子树暂时不参与渲染:

building.visible = false;
const roofFromName = building.getObjectByName('roof');
building.traverse((object) => {
    if (object.isMesh) object.castShadow = true;
});

userData 适合保存业务 id、类型、状态等信息。不要把响应式对象、DOM 节点或无法序列化的大对象随意挂进去。

📦 add、remove 和资源归属

一个对象只能有一个父级。把它 add 到新父级时,Three.js 会从旧父级移除它。删除对象只是断开场景树关系,不会自动释放几何体、材质和纹理。

scene.remove(building);
building.traverse((object) => {
    if (!object.isMesh) return;
    object.geometry.dispose();
    object.material.dispose();
});

多个 Mesh 共享同一材质时,要等所有使用者都不再需要它后再 dispose,否则其他物体也会失去材质资源。

📐 Box3 包围盒

模型文件的原点和尺寸经常不符合页面展示需求。Box3 可以根据对象的世界变换计算轴对齐包围盒:

const box = new THREE.Box3().setFromObject(building);
const center = box.getCenter(new THREE.Vector3());
const size = box.getSize(new THREE.Vector3());

building.position.sub(center); // 把模型中心移动到世界原点附近

如果模型已经有旋转或缩放,计算包围盒前先更新世界矩阵:

building.updateWorldMatrix(true, true);
const box = new THREE.Box3().setFromObject(building);

下面的演示展示父级、子级和包围盒的关系:

🧾 小节总结

  • Object3D 提供了 Three.js 对象共有的变换和层级能力。
  • Group 适合把一组有关联的对象当成整体管理。
  • name、getObjectByName、traverse 便于查找和批量处理。
  • userData 用来保存轻量的业务信息。
  • remove 不等于释放 GPU 资源,几何体、材质和纹理仍需按归属清理。
  • Box3 常用于计算模型中心、尺寸和相机适配范围。

❓ 知识问答

Q1:为什么 scene.remove(mesh) 后显存没有下降?

remove 只修改场景树,GPU 资源仍由几何体、材质和纹理持有,需要在确认不再使用后调用对应的 dispose()。

Q2:visible = false 和 remove 有什么区别?

visible = false 保留层级和引用,之后可以快速恢复;remove 会断开父子关系,但资源也不会自动释放。

Q3:Box3 为什么有时算出的中心不对?

通常是父子对象的世界矩阵还没有更新,或你只计算了局部几何体而不是通过 setFromObject 计算整个对象树。

🧪 小练习

创建一个 Group,放入三个不同颜色的几何体,为每个物体设置 name 和 userData.type,再用 traverse 统一打开线框模式。

// 请在这里编写代码

🎉 有了场景树,你就能用清晰的结构管理模型,而不是把所有对象都堆在 Scene 下面。