Web 图形与 3D / 系统课时
Group 层级如何传递变换
Group 层级如何传递变换
制作产品展示场景时,底座、商品和装饰部件往往需要一起移动或旋转。逐个修改 Mesh 容易破坏相对位置。使用 Three.js 的 Group 可以把多个对象组织成父子层级,让父节点统一控制组合模型,同时保留每个子对象独立调整的能力。
学习目标
- 使用
Group、add()和remove()组织场景层级。 - 理解父节点的位置、旋转和缩放如何影响子节点的世界变换。
- 创建能够整体旋转的组合模型,并验证子节点的挂载与移除行为。
Group 如何组织场景层级
THREE.Group 继承自 Object3D,本身不包含可见的几何体,主要用于把多个对象作为一个整体管理。
例如,一个商品展台可以采用以下组织方式:
Scene:整个三维场景的根节点。Group:商品展台组合,统一控制位置和旋转。Mesh:底座,位置相对于 Group 原点。Mesh:商品主体,可以独立调整高度和水平偏移。
调用 group.add(base, product) 后,两个 Mesh 都成为 Group 的直接子节点。调用 scene.add(group) 后,整个组合进入场景树。
每个 Object3D 通过 parent 指向父节点,通过 children 数组保存直接子节点。一个对象同一时刻只能拥有一个父节点,将它添加到新的父节点时,Three.js 会自动解除旧的父子关系。

Group 特别适合商品组合、机器人关节、车辆部件和数字展厅中的展品单元。需要整体操作时修改父节点,需要调整单个零件时修改对应子节点。
父节点变换如何影响子节点
Three.js 使用局部坐标和世界坐标区分对象的位置。子节点的 position、rotation 和 scale 都相对于父节点,而不是直接相对于整个场景。
对象的世界变换矩阵等于父节点的世界矩阵乘以自身的局部矩阵。多层嵌套时,从场景根节点到当前对象的变换会依次累积。
例如,设置以下参数:
| 对象 | 参数 | 数值 |
|---|---|---|
| Group | position |
(3, 0, 0) |
| Group | rotation.y |
Math.PI / 2 |
| 商品 Mesh | position |
(1, 0.6, 0) |
| 商品 Mesh | rotation |
(0, 0, 0) |
父节点绕 Y 轴旋转 90° 后,子节点的局部 X 方向偏移被转换到世界坐标的负 Z 方向。因此商品主体的世界位置变成 (3, 0.6, -1),但它的局部 position 仍然是 (1, 0.6, 0)。
三类父节点变换的效果不同:
- 平移:父节点移动时,全部后代跟随移动。
- 旋转:后代的位置围绕父节点原点旋转,自身朝向也受到影响。
- 缩放:后代的位置偏移和几何尺寸都会受到父节点缩放影响。
若要读取对象的实际世界位置,应使用 getWorldPosition(target),不能直接把 mesh.position 当成世界坐标。
创建可整体旋转的组合模型
下面创建一个底座与商品主体组成的展台。展台整体持续旋转,商品始终跟随底座运动,并通过浏览器控制台验证局部位置与世界位置。
使用 Node.js 20.19+ 或 22.12+,创建 Vite 原生 JavaScript 工程:
npm create vite@latest group-demo -- --template vanilla
cd group-demo
npm install
npm install three
npm run dev预期结果:项目创建成功并启动开发服务器,终端显示类似以下本地访问地址,实际端口可能不同。
Local: http://localhost:<PORT>/将项目中的 src/main.js 完整替换为以下代码:
import * as THREE from 'three';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf5f7fb);
const camera = new THREE.PerspectiveCamera(
50, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(7, 5, 8);
camera.lookAt(2, 0, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
// Group 原点作为整个展台的旋转中心
const group = new THREE.Group();
group.name = '展台';
group.position.set(3, 0, 0);
scene.add(group);
const material = new THREE.MeshNormalMaterial();
const base = new THREE.Mesh(
new THREE.BoxGeometry(3, 0.2, 2), material
);
base.name = '底座';
const product = new THREE.Mesh(
new THREE.BoxGeometry(0.8, 1, 0.8), material
);
product.name = '商品';
product.position.set(1, 0.6, 0);
// 子节点的位置相对于 Group,而不是 Scene
group.add(base, product);
group.rotation.y = Math.PI / 2;
scene.updateMatrixWorld(true);
console.log('子节点数:', group.children.length);
console.log('商品局部位置:', product.position.toArray().join(','));
const world = product.getWorldPosition(new THREE.Vector3());
console.log('商品世界位置:', world.toArray()
.map(v => +v.toFixed(2)).join(','));
// 按 R 键移除或重新挂载商品
window.addEventListener('keydown', (event) => {
if (event.key.toLowerCase() !== 'r') return;
if (product.parent === group) {
group.remove(product);
} else {
group.add(product);
}
console.log('挂载状态:', product.parent === group ? '已挂载' : '已移除');
});
renderer.setAnimationLoop(() => {
group.rotation.y += 0.008;
renderer.render(scene, camera);
});预期输出(浏览器开发者工具控制台,动画开始前):
子节点数: 2
商品局部位置: 1,0.6,0
商品世界位置: 3,0.6,-1页面中会出现一个由长方形底座和立方体商品构成的组合模型。两者围绕同一个 Group 原点持续旋转,彼此间的相对位置不会改变。
旋转角度使用弧度,Math.PI / 2 表示 90°。示例中每帧增加 0.008 弧度,因此实际旋转速度与帧率有关。正式项目如果需要恒定角速度,应根据相邻帧的时间差计算增量。
add 与 remove 如何改变父子关系
add() 和 remove() 修改的是场景层级关系,不是直接修改模型顶点数据。
在刚才的页面中执行以下操作:
- 打开浏览器开发者工具的 Console 面板。
- 按一次
R键,商品从场景中消失,控制台显示挂载状态: 已移除。 - 再按一次
R键,商品重新进入 Group,显示挂载状态: 已挂载。 - 观察底座始终持续旋转,商品重新加入后继续跟随底座旋转。
执行 group.remove(product) 后,product.parent 变为 null,Group 的直接子节点数量由 2 变为 1。由于商品没有其他场景父节点,它不会继续被该场景渲染。
移除对象并不会销毁其几何体或材质。重新执行 group.add(product) 可以复用原对象,product.position 等局部变换参数也不会因为移除操作而被清空。
需要特别注意重新挂载的坐标行为:
add()保留对象的局部变换数值,换父节点后世界位置可能发生跳变。attach()在重新指定父节点时尝试保持原有世界变换,适合需要维持视觉位置的重新挂载场景。attach()不支持包含非均匀缩放节点的场景层级,复杂变换下不能假定它始终可以无损保持世界变换。
例如,商品先属于世界位置为 (3, 0, 0) 的 Group,其局部位置是 (1, 0, 0)。如果把它直接 add() 到没有变换的 Scene,局部位置仍是 (1, 0, 0),世界位置也会变为 (1, 0, 0),而不是保持原先的位置。
检查旋转轴心与层级错误
Group 的旋转中心是它的局部原点。如果组合模型看起来绕远处某个点公转,通常是子模型相对 Group 原点的偏移不符合预期。
可以按以下顺序检查:
- 检查
group.position,确认组合整体放置在预期位置。 - 检查子节点的
position,确认模型围绕正确的局部原点排列。 - 检查
mesh.parent === group,确认对象确实位于目标 Group 下。 - 检查
group.children.length,排除重复创建、错误移除或挂载到其他父节点的问题。 - 修改父子变换后,调用
scene.updateMatrixWorld(true),再读取getWorldPosition()验证结果。
如果一个展台需要围绕底座中心旋转,可以让 Group 原点与底座中心重合;若导入的模型原点偏移,应优先通过中间 Group 调整模型相对轴心的位置,而不是反复修改所有部件的世界坐标。
实际项目还应区分整体操作与局部操作:商品展示台整体旋转应修改 Group,商品单独升降应修改商品 Mesh,多个展台统一移动则可以再添加一层上级 Group。这样每一层都对应一种明确的控制职责。
掌握父子层级后,可以通过少量父节点变换控制整组模型,同时利用局部坐标独立调整零件。验证时始终区分 position 与 getWorldPosition(),便能避免大多数场景层级中的位置和旋转问题。