游戏客户端架构 / 系统课时
Debug Draw 怎么查碰撞体偏移
Debug Draw 怎么查碰撞体偏移
模型站在地上,碰撞壳却埋进地面;射线看似朝前,实际查询沿局部坐标偏转。这类问题只看渲染模型很难定位。本节规定调试绘制应展示什么,并用坐标变换示例复现局部偏移被错误当成世界坐标的现象。
学习目标
- 同时观察模型、实际碰撞壳、查询形状和接触信息。
- 区分局部坐标、世界坐标及物理快照时刻。
- 用可重复输入验证偏移修复。
绘制真实查询使用的数据
调试线条应由传给物理 API 的同一组起点、终点、半径和姿态生成。重新根据模型位置“估算”一个可视化胶囊,可能恰好把错误画对。射线画实际起终点;球体或胶囊扫掠画起点形状、终点形状及覆盖路径,不能只画中心线。
命中点用小标记,法线从命中点向外画短箭头。给参与查询的碰撞层与被排除对象留一个可查询的日志字段;画面太密时只显示选中角色的一步数据。颜色需要图例,不能仅凭红色就让读者猜是命中、失败还是危险。

局部偏移先变换再相加
碰撞体中心经常存储在物体的局部空间。世界中心需要先应用物体缩放和旋转,再加世界平移。若父节点也有变换,应使用完整的层级变换,而不是只读取最末节点的旋转。以下 Python 3 示例在二维中演示旋转的影响。
from math import cos, sin, radians
def world_center(position, local_offset, angle):
c, s = cos(radians(angle)), sin(radians(angle))
x, y = local_offset
# 这里只演示旋转和平移,例子没有父节点与缩放。
rotated = (c*x - s*y, s*x + c*y)
return tuple(round(p + q, 3) for p, q in zip(position, rotated))
position, offset = (10.0, 0.0), (1.0, 0.0)
correct = world_center(position, offset, 90)
wrong = tuple(p + q for p, q in zip(position, offset))
print("正确中心:", correct)
print("错误中心:", wrong)预期输出:
正确中心: (10.0, 1.0)
错误中心: (11.0, 0.0)若偏移只在旋转后出现,这类局部与世界空间混用应优先排查;若尺寸也不对,再检查缩放以及引擎对非均匀缩放形状的处理。不要仅调整碰撞体中心数值去补偿错误变换,否则换个朝向还会出错。
画面对齐还需要时间对齐
渲染插值后的模型姿态可能处于两个物理快照之间,调试碰撞壳却显示最新物理姿态。高速运动时,两者看起来存在偏移,并不必然是中心配置错误。应暂停在某个物理步,标注快照编号,或同时显示物理姿态与渲染姿态。
录制排查时保留输入、固定步长、查询参数、命中对象 ID、命中点和法线。接触点与查询命中点可能来自不同过程,也应使用不同标记。穿透恢复后的点不能冒充最初发生碰撞的位置。
用旋转和父节点验证修复
让对象分别取 0、90、180 度朝向,重复同一次查询;再增加一个旋转的父节点和明确的缩放。检查碰撞中心、查询方向及命中点是否仍与预期一致。接缝排查则需要显示所有相关形状,避免只检查可见模型。
调试绘制应能按对象、距离或类别开关,短线也应有有限生命周期。验证完成后关闭绘制和逐次打印再测性能,防止诊断本身制造新的掉帧。