游戏客户端架构 / 系统课时
Debug 线条怎样证明空间正确
Debug 线条怎样证明空间正确
一条调试线画出来并不等于计算正确,它也可能使用了另一套坐标或过期姿态。本节从原点与三条基轴构造世界线段,用长度、方向和往返测试给视觉检查补上数值证据。
学习目标
- 为调试线生成同空间的两个端点
- 区分位置错误、轴向错误与尺度错误
- 让调试输入与实际业务输入保持一致
每条线都是两个点
多数线段接口需要起点和终点,方向应先乘显示长度,再加起点。把单位方向直接作为终点,会让线从角色位置连到世界原点附近,角色移动时线长也跟着改变。线段接口若接收局部顶点,还需要把生成的世界端点转换到该绘制节点空间。
验证变换时先画节点世界原点,再画局部三条基轴转换后的结果。只画前向无法发现某一条侧轴被镜像;只画位置也看不出旋转顺序错误。颜色可以区分轴,但必须同时保留文字或日志标签,避免颜色成为唯一信息来源。

生成可传给绘制适配层的线段
使用 Python 3.12、NumPy 2.3.5 保存为 demo.py 并执行 python demo.py。示例输出世界端点,实际引擎绘制时应使用明确接收世界线段的入口,或在边界转成绘制节点局部坐标。
import numpy as np
rotation = np.array([[0., -1, 0], [1, 0, 0], [0, 0, 1]])
origin = np.array([10., 0, 0])
segments = []
for name, local_axis in zip("XYZ", np.eye(3)):
axis = rotation @ local_axis
end = origin + axis * 2
segments.append((origin.copy(), end.copy()))
print(name, end.astype(int).tolist())
# 检查的是世界线段长度,不是终点到世界原点的距离。
assert np.isclose(np.linalg.norm(end - origin), 2)
assert np.allclose(rotation.T @ (end - origin) / 2, local_axis)
print("segments", len(segments))
print("orthogonal", bool(np.allclose(rotation.T @ rotation, np.eye(3))))预期输出:
X [10, 2, 0]
Y [8, 0, 0]
Z [10, 0, 2]
segments 3
orthogonal True图形与业务必须使用同一个快照
攻击射线的调试线应直接来自查询起点、单位方向和最大距离,不能另外根据角色外观重算一条“看起来差不多”的线。否则调试线正确也无法证明实际物理查询正确。记录同一帧与同一采样阶段,必要时把端点和对象标识保存到日志。
若原点正确但轴方向错,检查旋转、前轴与手性;轴方向正确但长度随外观变化,检查缩放是否应该继承;整组轴随父级移动出现二倍偏移,检查重复世界变换。若所有数值正确却屏幕看不到线,检查线的生命周期、深度遮挡、相机和绘制入口,而不是立即更改数学公式。
调试线应配合已知地标:地面向上、角色右侧、世界固定位置。往返检查只能证明内部一致,地标才能验证外部约定。负缩放场景还要查看三条轴的定向关系,并明确是在展示几何基还是忽略缩放后的运动基。
对数值误差采用合适容差。大世界远处的短线可能受精度限制影响,日志应同时记录绝对坐标与相对长度。把线搬到原点附近比较有助于区分坐标约定错误与精度问题,但最终仍要回到真实运行范围验收。