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

先判断空间再动手算

先判断空间再动手算

一个位置错了,最容易想到的是调整正负号;更可靠的第一步是问它属于哪个空间。本节把空间当成数据契约,建立输入、输出和转换边界,使混用局部位置与世界目标的错误在计算前就能暴露。

学习目标

  • 给空间计算写出明确输入和输出
  • 在不同空间之间设置唯一转换边界
  • 用原点和往返验证定位错误

先填三项信息

收到一个三分量值,先确认它描述点还是向量,再确认参考空间,最后确认单位。世界位置与某角色局部位置可能都是米,但原点和轴向不同,不能直接相减。相同空间的两个位置之差才是该空间中的位移。

空间也不是只有 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

转换边界越集中,排查越容易

业务函数可以统一接收世界位置;需要在模型上放置特效时,最后一步再把结果转回对应挂点空间。另一种设计让函数始终在角色局部空间计算,输入目标先转换一次。两种方案都可行,关键是函数内部不要时而使用局部、时而使用世界值。

调试日志至少记录节点标识、空间名和单位。只打印三个数字,很难判断是数值本身错误还是解释错误。检查转换时先把局部原点映射到世界,结果应等于节点世界位置;再转换三条单位轴,验证方向;最后做正向再反向的往返测试。

往返正确只能证明两套函数彼此一致,不能证明它们符合引擎约定。一对都错误的换轴也可能互为逆。还要用已知地标验证,例如世界向上、角色前方和屏幕中心。基础方向验证通过后,再考虑浮点精度、插值和复杂层级,避免同时修改多个因素。

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

目录与阅读设置

阅读设置

17

记录一个想法

先判断空间再动手算

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

登录哪都通