游戏客户端架构 / 系统课时
先判断空间再动手算
先判断空间再动手算
一个位置错了,最容易想到的是调整正负号;更可靠的第一步是问它属于哪个空间。本节把空间当成数据契约,建立输入、输出和转换边界,使混用局部位置与世界目标的错误在计算前就能暴露。
学习目标
- 给空间计算写出明确输入和输出
- 在不同空间之间设置唯一转换边界
- 用原点和往返验证定位错误
先填三项信息
收到一个三分量值,先确认它描述点还是向量,再确认参考空间,最后确认单位。世界位置与某角色局部位置可能都是米,但原点和轴向不同,不能直接相减。相同空间的两个位置之差才是该空间中的位移。
空间也不是只有 Local 和 World。武器挂点、骨骼、相机、UI 容器各有自己的参考系。“局部位置”必须说明相对哪个节点;两个兄弟节点的局部值不能因为名字相同就当作同一空间。空间契约应包含稳定的拥有者标识。
| 计算 | 合法输入 | 输出 |
|---|---|---|
| 目标减起点 | 两个世界位置 | 世界位移 |
| 方向乘距离 | 单位方向、同单位距离 | 位移 |
| 局部点转世界 | 点、该局部空间的世界矩阵 | 世界点 |
| 世界点转相机 | 世界点、视图矩阵 | 相机点 |
让错误在运算入口被拒绝
下面的最小包装只演示“两个点相减”这一条规则,不冒充完整引擎类型系统。Python 3.12 标准库即可运行:保存为 demo.py,执行 python demo.py。数据使用不可变元组,减少标签正确但内部坐标被悄悄修改的机会。
python
from dataclasses import dataclass
@dataclass(frozen=True)
class Point:
space: str
xyz: tuple[float, float, float]
def displacement(start: Point, target: Point):
# 相减之前检查空间,绝不在这里猜测转换矩阵。
if start.space != target.space:
raise ValueError("space mismatch")
return tuple(b - a for a, b in zip(start.xyz, target.xyz))
start = Point("world:m", (10, 2, 0))
target = Point("world:m", (13, 2, 4))
print("delta", displacement(start, target))
try:
displacement(start, Point("weapon-local:m", (1, 0, 0)))
except ValueError as error:
# 失败路径也是接口契约的一部分。
print("rejected", str(error))预期输出:
text
delta (3, 0, 4)
rejected space mismatch转换边界越集中,排查越容易
业务函数可以统一接收世界位置;需要在模型上放置特效时,最后一步再把结果转回对应挂点空间。另一种设计让函数始终在角色局部空间计算,输入目标先转换一次。两种方案都可行,关键是函数内部不要时而使用局部、时而使用世界值。
调试日志至少记录节点标识、空间名和单位。只打印三个数字,很难判断是数值本身错误还是解释错误。检查转换时先把局部原点映射到世界,结果应等于节点世界位置;再转换三条单位轴,验证方向;最后做正向再反向的往返测试。
往返正确只能证明两套函数彼此一致,不能证明它们符合引擎约定。一对都错误的换轴也可能互为逆。还要用已知地标验证,例如世界向上、角色前方和屏幕中心。基础方向验证通过后,再考虑浮点精度、插值和复杂层级,避免同时修改多个因素。
按自己的节奏,确认真正理解。