Chaos可视调试器中的数据可视化标记 | 虚幻引擎 5.7 文档

为帮助你识别异常的物理行为，Chaos可视调试器（CVD）提供了调试绘制工具，以直观显示应用程序在运行时通常不可见的内容。

切换数据标记即可控制视口中会显示哪些调试绘制工具。数据标记的分类如下：

某些标记，比如质心（Center of Mass）等，可能会影响CVD的性能。如果达到调试绘制的上限，视口中会显示如下警告：

已达到调试绘制线上限！请尝试选择更少的调试绘制类别，或将摄像机聚焦集中在更狭窄的区域内。（Max Debug Draw lines limit reached! Try selecting fewer debug draw categories or focus the camera in a narrower area.）

碰撞数据

可视化碰撞数据可帮助你识别碰撞行为异常的区域。例如两个对象发生相交，而不是按预期发生碰撞。

要启用碰撞数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 碰撞数据标记（Collision Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击碰撞数据可视化设置（Collision Data Visualization Settings）以自定义数据在视口中的绘制方式。

可视化设置包括下列选项：

显示调试文本（Show Debug Text）：开关视口调试文本（如果有）。
深度优先级（Depth Priority）：在世界空间或前景中绘制数据（始终置于其他场景组件之上）。
缩放和半径选项：控制调试绘制元素的大小，使其在视口中更为可见。

大部分数据标记的可视化设置都提供了相似的可切换功能。

场景查询

可视化场景查询（线迹、扫描和重叠）能帮助你调试在运行时执行了查询但未能找到预期对象的情况。

要启用场景查询数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 场景查询数据标记（Scene Query Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击场景查询可视化设置（Scene Query Visualization Settings）以自定义数据在视口中的绘制方式。

粒子数据

可视化的粒子数据可以帮助你识别不规律的粒子行为，例如受力后粒子的移动速度超出预期的情况。

要启用粒子数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 粒子数据标记（Particle Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击粒子数据可视化设置（Particle Data Visualization Settings）以自定义数据在视口中的绘制方式。

CVD只会录制并可视化物理线程粒子数据，而非游戏线程粒子数据。游戏线程粒子数据不会被可视化。

几何体

大部分粒子都具有简单和复杂碰撞几何体，但只会将其中一种用于碰撞检测。

用于切换简单和复杂几何体的选项以及其他几何体可视化标记的选项位于视口工具栏的显示（Show） > 几何体标记（Geometry Flags）菜单下。

仅查询（Query Only）几何体使用半透明材质可视化。按T键或点击汉堡菜单中的允许半透明选择（Allow Translucent Selection）即可启用或禁用半透明选择。

粒子着色

如需增加绘制的可视性，你可以使用如下模式为粒子着色：

无（None）：使用默认灰色绘制粒子。
状态（State）：根据模拟中物理对象的状态（动态、休眠、运动或静态）着色。
形状类型（Shape Type）：根据碰撞几何体类型（简单形状、凸包、高度场或三角网格图）着色。
客户端服务器（Client Server）：根据客户端或服务器生成的粒子着色。

状态和默认灰色

要更改模式和自定义颜色，请执行以下操作：

转到视口工具栏，点击显示（Show） > 粒子着色（Particle Colorization）。
打开颜色模式（Colors Mode）下拉菜单，点击粒子颜色模式（Particle Color Mode）下拉菜单，选择要使用的模式。
点击颜色按[模式]（Colors by [mode]）下拉菜单并自定义颜色。然后点击颜色图块以打开上下文取色器。

下表描述了上下文取色器的用户界面（UI）。

编号	说明
1	色轮（或切换为色谱）。
2	显示当前和之前选中的颜色。
3	切换sRGB预览。
4	切换色轮和色谱。
5	切换颜色方案的可视性。
6	滴管工具。
7	RBG/HSV滑块。
8	Alpha滑块。
9	显示当前颜色的十六进制代码。
10	颜色方案：功能类似于Adobe Photoshop和其他设计程序中的色卡。

关节约束

可视化关节约束可以帮助你调试多余的布娃娃行为，例如关节扭曲等。 CVD会将关节约束数据录制为逐帧的单独数据片段。因此，目前无法跨游戏帧保持所选项。

要启用关节约束数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 关节约束数据标记（Joint Constraint Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击关节约束可视化设置（Joint Constraint Visualization Settings）以自定义数据在视口中的绘制方式。

默认情况下，CVD不会录制关节约束。要将其启用，请点击主工具栏中的数据通道（Data Channel）下拉菜单，并勾选JointConstraints。

角色地面约束

CVD可以录制虚幻引擎角色移动系统（即Mover 2.0）所使用的角色地面约束的状态。你可以使用此标记识别并调试异常行为，例如角色漂浮在地面上方或与地面平面穿模。

要启用角色地面约束数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 角色地面约束数据标记（Character Ground Constraints Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击角色地面约束可视化设置（Character Ground Constraints Visualization Settings）以自定义数据在视口中的绘制方式。

默认情况下，CVD不会录制角色地面约束。要将其启用，请点击主工具栏中的数据通道（Data Channel）下拉菜单，并勾选角色地面约束（Character Ground Constraints）。

泛型调试绘制数据

以下C++宏和蓝图节点会直接在CVD中录制调试绘制形状。调试绘制形状可以在调试物理计算时提供上下文。

例如，如果你使用空间中的两个点来计算施加于物理对象的力，CVD仅会显示对象受力前后的状态。若出现异常，你可以使用泛型调试绘制宏（或蓝图节点）逐帧可视化这两个点和施加的力。此工作流程可以为你提供力的计算方式的上下文，并帮你进行纠正。

C++宏

根据你需要绘制的形状，每个宏都有其特定的一组参数 — 各宏使用的下列可选参数除外：

宏	参数	说明
TraceDebugDrawBox	InBox	你要录制的形状。
所有宏	标记（Tag）	充当标记的FName，用于筛选、搜索以及在CVD的视口中作为文本标记而调试绘制。
所有宏	颜色（Color）	当形状在CVD中被调试绘制时，该形状应用的颜色。
所有宏	解算器ID（SolverID）	该形状应该关联的解算器的ID。如未提供ID，则该形状将从数据桶中被添加为当前游戏的一部分。
TraceDebugDrawLine、TraceDebugDrawVector	内起始点（InStartLocation）	线段的起始点。
TraceDebugDrawLine	内结束点（InEndLocation）	线段的结束点。
TraceDebugDrawVector	内向量（InVector）	你要录制的向量。
TraceDebugDrawSphere	中心（Center）	球体的原点。
TraceDebugDrawSphere	半径（Radius）	球体的半径。
所有宏	拥有者（Owner）	与此调试绘制形状相关的所有UObject。此属性供内部使用，负责判断形状是从服务器解算器还是客户端解算器录制的。

蓝图节点

以下泛型调试绘制宏也可以作为蓝图事件图表中的函数节点实现：

CVD Record Debug Draw Sphere
CVD Record Debug Draw Box
CVD Record Debug Draw Line

如需详细了解各节点，请参阅虚幻引擎蓝图API参考的Chaos可视调试器小节。

启用泛型调试绘制数据

要启用泛型调试绘制数据，请执行以下操作：

转到视口工具栏，点击显示（Show） > 泛型调试绘制数据标记（Generic Debug Draw Data Flags） > 启用绘制（Enable Draw）。此选项将打开数据标记列表。
从列表选择要打开或关闭的数据标记。
点击泛型调试绘制数据可视化设置（Generic Debug Draw Data Visualization Settings）以自定义数据在视口中的绘制方式。