游戏客户端架构 / 系统课时

三大引擎的 Transform 怎样对应

三大引擎的 Transform 怎样对应

跨引擎迁移时,最危险的不是 API 名字不同,而是名字相似却包含不同的缩放和空间规则。本节按“点、位移、纯旋转方向”建立对应关系,再用一个独立示例验证这些操作的差别。

学习目标

  • 按数学语义选择各引擎转换接口
  • 区分完整变换与忽略缩放的旋转
  • 用同一数值夹具检查适配层

对齐操作语义,再对齐函数名

Unity 的 Transform 是场景组件,Unreal 的 FTransform 是变换值类型,Godot 的 Node3D 持有 Transform3D。三者并非同一种对象。局部到世界转换必须拿到该节点的世界变换,而不是任意一份相对父级的变换。

意图 Unity Unreal FTransform Godot 4
局部点到目标空间 TransformPoint TransformPosition Transform3D * Vector3
位移继承缩放 TransformVector TransformVector Basis * Vector3
只应用旋转 TransformDirection TransformVectorNoScale 已知纯旋转 Basis 乘向量
世界点回局部 InverseTransformPoint InverseTransformPosition 世界 Transform3D 的 affine_inverse() 乘点

表中 Unreal 与 Godot 的值类型操作映射到该变换的目标空间;只有传入世界变换,目标才是世界。Godot 的 Basis 可以包含缩放与剪切,不能无条件把它当作纯旋转。Unity 的方向接口忽略位置与缩放,并保留输入长度,输入不是单位向量时不会自动变成单位方向。Unity 点接口、Unity 方向接口、Unreal 变换 API、Godot 变换 API分别给出了对应契约。

用数值夹具定义期望

目标变换无旋转,平移 (10,20,0),缩放 (2,3,1)。输入点与位移都取 (1,1,0),点应得到 (12,23,0),位移得到 (2,3,0)。使用 Python 3.12、NumPy 2.3.5 保存为 demo.py,执行 python demo.py。

python
import numpy as np

linear = np.diag([2., 3, 1])
translation = np.array([10., 20, 0])
value = np.array([1., 1, 0])
# 点包含平移,位移与纯旋转方向都不包含平移。
point = linear @ value + translation
delta = linear @ value
rotation_only = np.eye(3) @ value
print("point", point.tolist())
print("delta", delta.tolist())
print("rotation_only", rotation_only.tolist())
assert not np.allclose(delta, rotation_only)

预期输出:

text
point [12.0, 23.0, 0.0]
delta [2.0, 3.0, 0.0]
rotation_only [1.0, 1.0, 0.0]

在 Godot 中验证同一个夹具

以下完整脚本适用于 Godot 4.7.2。把它保存为任意 Godot 项目根目录下的 transform_probe.gd,使用该版本可执行文件运行参数 --headless --path 项目目录 --script transform_probe.gd,无需创建场景或网格。

gdscript
extends SceneTree

func _initialize() -> void:
    var basis := Basis.from_scale(Vector3(2, 3, 1))
    var transform := Transform3D(basis, Vector3(10, 20, 0))
    var local := Vector3(1, 1, 0)
    # 完整变换作用于点,单独的 Basis 不包含原点平移。
    var point := transform * local
    var delta := basis * local
    var restored := transform.affine_inverse() * point
    print("point %.1f %.1f %.1f" % [point.x, point.y, point.z])
    print("delta %.1f %.1f %.1f" % [delta.x, delta.y, delta.z])
    assert(restored.is_equal_approx(local))
    print("roundtrip ", restored.is_equal_approx(local))
    quit()

预期输出:

text
point 12.0 23.0 0.0
delta 2.0 3.0 0.0
roundtrip true

这里只列脚本日志,启动时的引擎版本横幅随安装版本变化。Godot 的普通 inverse() 要求正交归一基,包含非均匀缩放时使用 affine_inverse(),并拒绝零行列式。

适配测试还要覆盖旋转和祖先

夹具正确只证明平移与缩放契约。还要添加九十度旋转、移动父节点和世界到局部往返;各引擎的轴向、距离单位与欧拉顺序在适配层处理。不要把本课程的列向量矩阵直接当成所有引擎的乘法书写规则。

若层级组合产生剪切,完整矩阵与只保存 TRS 的值类型还可能出现表达能力差异。应明确支持范围,不能只靠一个统一函数名掩盖。业务层拿到的应是已经符合约定的世界点或方向,而不是让每个调用方重新记忆引擎细节。

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

目录与阅读设置

阅读设置

17

记录一个想法

三大引擎的 Transform 怎样对应

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

登录哪都通