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

用最小测试验证数学约定

用最小测试验证数学约定

跨库接入数学代码时,复杂场景可能同时包含资源轴向、矩阵上传和相机问题,让排查失去方向。本篇建立一组数值小、预期明确的测试,用原点、基轴和非对称点验证约定,使问题在进入场景之前就能暴露。

学习目标

  • 选择能区分常见错误的探针。
  • 用独立已知结果检验矩阵链。
  • 把容差和运行范围写进证据。

每个探针对应一种假设

原点检查平移,单位轴检查旋转与缩放,非对称点检查分量次序。不要只测 (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 数学环境运行;同一探针仍需通过目标引擎的真实接口和上传路径,才能宣称完成跨系统验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

用最小测试验证数学约定

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

登录哪都通