游戏客户端架构 / 系统课时
用最小测试验证数学约定
用最小测试验证数学约定
跨库接入数学代码时,复杂场景可能同时包含资源轴向、矩阵上传和相机问题,让排查失去方向。本篇建立一组数值小、预期明确的测试,用原点、基轴和非对称点验证约定,使问题在进入场景之前就能暴露。
学习目标
- 选择能区分常见错误的探针。
- 用独立已知结果检验矩阵链。
- 把容差和运行范围写进证据。
每个探针对应一种假设
原点检查平移,单位轴检查旋转与缩放,非对称点检查分量次序。不要只测 (1,1,1),因为轴置换可能保持它不变。对于列向量二维齐次变换,先缩放 (2,1)、正转 90 度、再平移 (10,0),输入 (1,3) 应到 (7,2)。这个预期可由三步手算独立得到。
另加方向 w=0,确保不叠加平移;再做逆变换往返,确认可恢复原点。往返只是辅助:如果正反两条路径同时采用了错误约定,仍可能互相抵消,所以不能只依赖往返通过。
一次运行明确的断言集合
以下 Python 3.12 与 NumPy 2.x 程序给每项断言命名,失败时立即报告。使用绝对容差并关闭相对容差,适合本例数值规模;大型世界坐标应根据单位和精度另选误差标准。
python
import numpy as np
m = np.array([[0,-1,10],[2,0,0],[0,0,1]],dtype=float)
checks = {
'origin': (m@[0,0,1],[10,0,1]),
'x point': (m@[1,0,1],[10,2,1]),
'y point': (m@[0,1,1],[9,0,1]),
'asymmetric': (m@[1,3,1],[7,2,1]),
'direction': (m@[1,0,0],[0,2,0]),
'inverse': (np.linalg.solve(m,[7,2,1]),[1,3,1]),
}
for name,(actual,expected) in checks.items():
assert np.allclose(actual,expected,atol=1e-10,rtol=0), name
print('passed=', len(checks))
print('convention= column, XY, CCW, homogeneous')预期输出:
text
passed= 6
convention= column, XY, CCW, homogeneous把旋转与投影加入接入门槛
三维接入还应验证绕已知轴正转 90 度后的三根基轴、四元数 q 与 −q 同姿态、非均匀缩放后的法线垂直关系。屏幕链应验证视口中心、四角和已知深度往返,并包含相机不在原点的情况,否则会漏掉视图矩阵方向错误。
错误输入也必须有预期行为:零方向拒绝或保留旧状态、零缩放不能求逆、非有限值不能进入下游。测试要检查业务选择,而不只是保证“不抛异常”。
结果随约定一起保存
保存版本、精度、空间、单位、矩阵表达和输出数值。更新数学库、渲染后端或资源导入器后,先跑这些小测试再开复杂场景。本例测试已在 Python 数学环境运行;同一探针仍需通过目标引擎的真实接口和上传路径,才能宣称完成跨系统验证。
按自己的节奏,确认真正理解。