游戏引擎 / 系统课时

把节点放进 3D 世界坐标

把节点放进 3D 世界坐标

本课解决场景摆放时最容易混淆的问题:为什么子节点的 Position 没变,物体却跟着父节点移动。你将用一个父节点和一个立方体验证 Position、Rotation、Scale 的作用,并读出局部坐标与世界坐标。

学习目标

  • 正确调整 3D 节点的 Position、Rotation 和 Scale。
  • 解释父节点如何影响子节点在世界中的位置和方向。
  • 用 Cocos Creator 3.8 的 Node API 验证两套坐标值。

三种变换究竟改了什么

Cocos Creator 的 3D 场景使用右手坐标系,通常 X 向右、Y 向上,默认前方为 -Z。一个节点拥有自己的局部坐标系,属性检查器中的变换值默认都相对于父节点,而不是直接相对于整个场景。

属性 常见初始值 实际控制
Position (0, 0, 0) 沿父节点坐标轴的相对位移
Rotation (0, 0, 0) 相对父节点绕 X、Y、Z 轴的欧拉角,编辑器以度显示
Scale (1, 1, 1) 相对父节点沿三轴的缩放倍率

选择物体后可在属性检查器直接输入数值,也可以在场景编辑器使用移动、旋转、缩放手柄。切换手柄的 Local/Global 方向,只会改变拖动参考的轴向,不会把属性检查器里的 Position 自动改成世界坐标。

父子层级决定世界位置

设父节点 ParentPivot 的 Position 为 (10, 0, 0)、Rotation 为 (0, 0, 0)、Scale 为 (1, 1, 1);它下面的 Cube 的 Position 是 (1, 0, 0)。此时 Cube 的局部位置为 (1, 0, 0),世界位置是 (11, 0, 0)。

当父节点沿 X 轴再移动 2 个单位,Cube 的局部 Position 仍是 (1, 0, 0),但世界位置变为 (13, 0, 0)。这是父子层级传播变换的结果,不是编辑器替你修改了子节点字段。

父子节点的局部坐标与世界坐标关系

这个直接相加的例子有前提:父节点没有旋转,缩放也是单位值。只要父节点发生旋转或缩放,子节点的局部位移还会受到父坐标轴方向和倍率影响,不能继续把三个 Position 数值简单相加。

在场景中亲手验证

  1. 打开一个含 Camera 的 3D 场景,在层级管理器中新建空节点并命名 ParentPivot,将其 Position 设置为 (10, 0, 0),Rotation 为 (0, 0, 0),Scale 为 (1, 1, 1)。
  2. 在 ParentPivot 下创建 3D 立方体并命名 Cube,将其 Position 设为 (1, 0, 0)。父子关系必须在层级管理器中实际成立;需要在运行时看到 Cube,还应调整 Camera 使它进入镜头范围。
  3. 将 ParentPivot 的 Position 改为 (12, 0, 0),观察 Cube 一起移动但其局部 Position 不变。再恢复父节点 X 为 10,便于对照脚本输出。
  4. 尝试单独调整父节点 Rotation 的 Y 值和 Scale 的 X 值,观察 Cube 的位置、朝向或外观变化;实验完成后分别恢复为 0 和 1。保存场景。

用脚本读出两套位置

在资源管理器创建 TransformCheck.ts,使用下列完整组件脚本,并将其挂在 Cube 而不是 ParentPivot 上。预览前确保数值恢复到上一节的初始设置。

ts
import { _decorator, Component } from 'cc';
const { ccclass } = _decorator;

@ccclass('TransformCheck')
export class TransformCheck extends Component {
    start() {
        // 组件挂在 Cube 上,父节点位于世界坐标 (10, 0, 0)。
        const local = this.node.getPosition();
        const world = this.node.getWorldPosition();
        // 同时输出两套坐标,避免把局部字段误认成世界位置。
        console.log(`local=(${local.x}, ${local.y}, ${local.z})`);
        console.log(`world=(${world.x}, ${world.y}, ${world.z})`);
    }
}

预期输出(浏览器 Console 中):

text
local=(1, 0, 0)
world=(11, 0, 0)

getPosition() 和 setPosition() 面向局部位置,getWorldPosition() 和 setWorldPosition() 面向世界位置。属性检查器显示的 Rotation 是欧拉角,脚本里的 node.eulerAngles 也可读写欧拉角;node.rotation 则是四元数,不能把两者当作相同格式。

实践中,角色身上的武器、头顶标识适合使用局部变换,以便跟随角色移动;需要把物体放在场景某个固定地点时,应明确采用世界坐标。判断一个数值的意义时,先确认它相对于谁,再决定使用哪组 API。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把节点放进 3D 世界坐标

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通