游戏客户端架构 / 系统课时
建立一套跨引擎数学检查表
建立一套跨引擎数学检查表
课程中的单项公式只有进入一致的约定体系,才能可靠地用于跨引擎协作。本篇把坐标、单位、矩阵、旋转和数值边界整理成可验收的契约,再用一组序列化探针展示如何记录转换证据,避免项目成员各自猜测数据含义。
学习目标
- 为每条数据边界写出数学契约。
- 把检查项转成具体探针与预期。
- 区分数学通过与真实接口通过。
契约必须绑定数据边界
同一引擎内部也会同时出现世界、局部、视图和屏幕空间。不要只在项目首页写一句“使用右手系”,而应给导入文件、网络消息、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 上传、材质和碰撞查询。验收记录应分别标明已经实跑的层次与尚未实测的层次,保证后续成员能够复现,而非只看到一张正确画面。
按自己的节奏,确认真正理解。