游戏引擎 / 系统课时
处理父子节点的坐标关系
处理父子节点的坐标关系
武器挂点、跟随特效和角色血条经常是其他节点的子节点。它们的 position 表示相对父节点的偏移,不一定是场景中的实际位置。本课用一个可复现的二维示例观察父节点平移和旋转对子节点的影响,并掌握本地坐标与世界坐标的读写方法。
学习目标
- 分清节点本地位置与世界位置各自使用的参照系。
- 用
setPosition()、getWorldPosition()和setWorldPosition()验证父子变换。 - 判断角色挂点、跟随物体和触控定位应使用哪种坐标。
本地坐标的原点在父节点
在 Cocos Creator 3.8 中,Node.position 和 getPosition() 读取的是本地位置,其参照物是直接父节点;getWorldPosition() 读取的是世界位置,它考虑了整个祖先节点链的变换。场景里看到的位置不能直接从子节点的 position 判断。
假设一个没有额外祖先变换的父节点位于 (200, 80, 0),没有旋转,缩放为 (1, 1, 1);子节点的本地位置为 (40, 20, 0)。此时子节点世界位置是 (240, 100, 0)。只有在父节点没有旋转和缩放时,才可以这样直接相加。
父节点绕 Z 轴逆时针旋转 90° 后,子节点本地位置依旧是 (40, 20, 0),但世界位置变成 (180, 120, 0):相对父节点的偏移也一起旋转了。

用脚本重现两种位置
新建 LocalWorldDemo.ts,把组件挂到场景根层的空节点上,确保该节点没有带位移、旋转或缩放的其他祖先。脚本在运行时创建一个 Child,依次记录初始、父节点旋转和指定世界位置后的结果。
import { _decorator, Component, Node } from 'cc';
const { ccclass } = _decorator;
@ccclass('LocalWorldDemo')
export class LocalWorldDemo extends Component {
start(): void {
// 测试节点直接挂在场景根层,排除祖先节点变换。
this.node.setPosition(200, 80, 0);
this.node.setRotationFromEuler(0, 0, 0);
this.node.setScale(1, 1, 1);
const child = new Node('Child');
this.node.addChild(child);
child.setPosition(40, 20, 0);
const report = (stage: string): void => {
const local = child.getPosition();
const world = child.getWorldPosition();
const round = (v: number): number => Math.round(v);
console.log(`${stage} local=(${round(local.x)},${round(local.y)}) world=(${round(world.x)},${round(world.y)})`);
};
report('初始');
this.node.setRotationFromEuler(0, 0, 90);
report('父节点旋转');
// 世界坐标设置会由引擎换算成新的子节点本地位置。
child.setWorldPosition(200, 100, 0);
report('指定世界位置');
}
}预期输出(数值取整,控制台可能另附时间或来源信息):
初始 local=(40,20) world=(240,100)
父节点旋转 local=(40,20) world=(180,120)
指定世界位置 local=(20,0) world=(200,100)最后一行尤其重要:父节点仍旋转 90°,为使子节点落在世界位置 (200, 100, 0),引擎把它的本地位置反算成 (20, 0, 0)。因此 setWorldPosition() 不是给 position 简单赋同样的数值。
旋转、缩放和祖先节点怎样共同起作用
节点的世界变换来自父节点的世界变换与自身本地变换的组合。父节点移动,会带着子节点整体移动;父节点旋转,会改变子节点偏移的方向;父节点缩放,会改变这个偏移在世界中的长度。更上层的祖先节点也按同样规则参与计算。
例如将示例恢复到父节点不旋转、子节点本地位置 (40,20,0),再把父节点缩放设为 (2,2,1),子节点世界位置就会变成 (280,120,0)。这证明局部坐标值保持不变,并不代表视觉间距保持不变。需要判断最终位置时,应读世界坐标,而不是试图手工累加多个祖先的位置。
挂点和界面定位怎样选用坐标
角色手中的武器、跟随的光效通常采用本地坐标:武器只需固定在角色或骨骼挂点附近,角色移动、转向时就能自然跟随。如果任务要求物体移动到场景中的某个绝对目标点,则使用 setWorldPosition() 更明确。
验证时可先让父节点保持静止、修改子节点本地位置,再只改变父节点的旋转或缩放。如果子节点的本地数值不变而世界位置符合预期,说明你已经把父子变换关系区分清楚。