场景树与对象管理
🎯 引言
学完这篇文章,你能把复杂模型拆成容易管理的层级,按名字或业务数据找到对象,控制一组对象的显示与变换,并用包围盒计算模型中心和尺寸。
🧱 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 下面。
