游戏客户端架构 / 系统课时
三大引擎的 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。
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)预期输出:
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,无需创建场景或网格。
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()预期输出:
point 12.0 23.0 0.0
delta 2.0 3.0 0.0
roundtrip true这里只列脚本日志,启动时的引擎版本横幅随安装版本变化。Godot 的普通 inverse() 要求正交归一基,包含非均匀缩放时使用 affine_inverse(),并拒绝零行列式。
适配测试还要覆盖旋转和祖先
夹具正确只证明平移与缩放契约。还要添加九十度旋转、移动父节点和世界到局部往返;各引擎的轴向、距离单位与欧拉顺序在适配层处理。不要把本课程的列向量矩阵直接当成所有引擎的乘法书写规则。
若层级组合产生剪切,完整矩阵与只保存 TRS 的值类型还可能出现表达能力差异。应明确支持范围,不能只靠一个统一函数名掩盖。业务层拿到的应是已经符合约定的世界点或方向,而不是让每个调用方重新记忆引擎细节。