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

建立一套跨引擎数学检查表

建立一套跨引擎数学检查表

课程中的单项公式只有进入一致的约定体系,才能可靠地用于跨引擎协作。本篇把坐标、单位、矩阵、旋转和数值边界整理成可验收的契约,再用一组序列化探针展示如何记录转换证据,避免项目成员各自猜测数据含义。

学习目标

  • 为每条数据边界写出数学契约。
  • 把检查项转成具体探针与预期。
  • 区分数学通过与真实接口通过。

契约必须绑定数据边界

同一引擎内部也会同时出现世界、局部、视图和屏幕空间。不要只在项目首页写一句“使用右手系”,而应给导入文件、网络消息、CPU/GPU 接口分别记录约定。位置、方向、速度、法线和角速度应使用不同语义标签,即使底层都保存三个浮点数。

项目 必须记录 最小验收探针
坐标基 手性、上轴、前向、原点 三个单位轴和非对称点
单位 米/厘米、度/弧度、秒 已知一米与直角转动
空间 输入与输出空间 非恒等父级下的点与方向
矩阵 行列向量、组合、存储布局 原点、基轴、w 分量
四元数 排列、乘法、主动/被动 已知轴转动及 q/−q
投影 深度、反向 Z、视口原点 近远面与屏幕往返
几何 法线、绕序、镜像策略 非均匀与负缩放
数值 精度、容差、异常策略 零向量、病态矩阵、非有限值

保存小而明确的转换夹具

以下 Python 3.12 与 NumPy 2.x 程序定义一个示例来源到目标轴置换,位置单位从米到厘米。预期数值手工写入,不能由被测试的同一转换函数生成。程序同时检查三根轴和一个非对称点,并输出可保存的 JSON 证据。

python
import json
import numpy as np

contract={'source':'example XYZ meters','target':'example ZXY centimeters',
          'vectors':'column','positionScale':100,'origin':'shared'}
c=np.array([[0,0,1],[1,0,0],[0,1,0]],dtype=float)
fixtures=[([1,0,0],[0,1,0]),([0,1,0],[0,0,1]),([0,0,1],[1,0,0])]
for source,expected in fixtures:
    assert np.allclose(c@source,expected,atol=1e-10,rtol=0)
position=100*(c@np.array([2,3,4]))
assert np.allclose(position,[400,200,300],atol=1e-10,rtol=0)
report={'contract':contract,'passed':4,'position':position.tolist()}
print(json.dumps(report,sort_keys=True))

预期输出:

text
{"contract": {"origin": "shared", "positionScale": 100, "source": "example XYZ meters", "target": "example ZXY centimeters", "vectors": "column"}, "passed": 4, "position": [400.0, 200.0, 300.0]}

变更后重新跑对应边界

更新资源导入器时复测单位、枢轴与模型前向;替换数学库时复测乘法、分量排列与容差;切换图形后端时复测矩阵上传、投影深度与屏幕原点。只因工具名称没变就沿用旧假设,会让版本升级把错误带到运行时。

自动测试保存来源版本、输入快照、输出与误差,不要求所有结果逐位相同。对姿态比较用等价旋转标准,对位置使用单位相关阈值,对无效输入检查明确的拒绝或降级行为。不要为了通过而不断放宽所有容差。

完成一条从数据到画面的证据链

本课程的独立 Python 示例覆盖向量、矩阵、四元数、插值、瞄准与解析拾取。数学结果通过后,还需在实际引擎验证 API、父子层级、输入调度、GPU 上传、材质和碰撞查询。验收记录应分别标明已经实跑的层次与尚未实测的层次,保证后续成员能够复现,而非只看到一张正确画面。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立一套跨引擎数学检查表

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

登录哪都通