使用RenderDoc分析虚幻引擎画面 | 虚幻引擎 5.4 文档

RenderDoc是一款免费开源的图形调试程序，可以逐帧捕捉虚幻引擎等应用的画面。捕捉内容将被载入到RenderDoc中，并解释各个事件、API等内容对GPU的影响。

安装RenderDoc

RenderDoc是一款开源图形调试器，可从RenderDoc.org免费下载和安装。

以下列表指明了RenderDoc当前支持的操作系统和API，它们与虚幻引擎的支持可能有所不同。欲知最新更新，请参阅RenderDoc的FAQ页面。

RenderDoc支持以下操作系统：

RenderDoc支持以下API：

RenderDoc 插件随附在引擎中并默认启用。你可以通过两种方式对项目运行RenderDoc：使用命令行参数或项目设置。

若RenderDoc在启动时附加，你会在关卡视口右上角看到RenderDoc图标。

执行下面的步骤，查看每一项的启用方式。

在项目设置的 高级设置（Advanced Settings） 下的 插件（Plugins）> RenderDoc 中，启用 启动时自动附加（Auto attach on startup） 。如果你希望不论项目在何时加载均在启动时运行RenderDoc，那么此方法非常适合。

使用编辑器快捷方式启用命令行参数。在 快捷方式（Shortcut） 选项卡中，将以下内容添加到 目标（Target） 行：-AttachRenderDoc 。如果你只希望在某些时候运行RenderDoc，此方法非常适合。

以下步骤详细介绍如何使用集成的RenderDoc插件或直接在RenderDoc应用程序中对虚幻引擎项目执行单帧采集。

欲知RenderDoc功能和使用的详细信息，请参阅RenderDoc文档。

以下是使用虚幻引擎的RenderDoc插件进行帧采集的步骤：

以下是使用虚幻引擎以及独立版RenderDoc进行帧采集的步骤（进阶版）：

使用对应的命令行参数来配置RenderDoc启动游戏或UEEditor.exe。

启动UEEditor.exe时启用 采集子进程（Capture Child Processes） 。
启动可执行文件。
按下 F12 热键执行帧采集。

欲知设置RenderDoc、启动应用程序和执行帧采集的详细信息，请参阅RenderDoc入门指南。

在项目设置（Project Settings）窗口中设置RenderDoc插件的其他选项。在主菜单中，选择 编辑（Edit） > 项目设置（Project Settings） ，然后在 插件（Plugins） 类目下选择 RenderDoc 。

属性	描述
帧采集设置（Frame Capture Settings）
采集所有活动（Capture all activity）	启用后，RenderDoc将采集整个帧过程中所有视口和编辑器窗口中的所有活动，而不仅是当前视口中的活动。
采集所有调用堆栈（Capture all call stacks）	启用后，RenderDoc将采集所有API调用的调用堆栈。
引用所有资源（Reference all resources）	启用后，RenderDoc将包括采集中的所有渲染资源，甚至包括帧过程期间未使用的资源。启用此属性会极大增加采集内容的容量。
保存所有初始状态（Save all initial states）	启用后，RenderDoc将始终采集所有渲染资源的初始状态，即使这些渲染资源不大可能在帧过程中使用也同样如此。启用此属性会极大增加采集内容的容量。
高级设置（Advanced Settings）
启动时显示帮助（Show help on startup）	启用后，RenderDoc的帮助窗口将在编辑器启动时显示。
使用RenderDoc崩溃处理器（Use the RenderDoc crash handler）	启用后，发生崩溃时将使用RenderDoc崩溃处理器。建议在你了解RenderDoc应用程序存在问题并想要通知RenderDoc开发人员时才使用此设置。
RenderDoc可执行文件路径（RenderDoc executable path）	设置要使用的RenderDoc可执行文件的路径。安装RenderDoc时，它应自动填写正确路径。