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

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

安装RenderDoc

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

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

RenderDoc支持以下操作系统：

RenderDoc支持以下API：

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

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

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

在项目设置的插件（Plugins）> RenderDoc中的高级设置（Advanced Settings）下，启用启动时自动附加（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）
捕获所有活动	启用后，RenderDoc将采集整个帧过程中所有视口和编辑器窗口中的所有活动，而不仅是当前视口中的活动。
捕获所有调用堆栈	启用后，RenderDoc将采集所有API调用的调用堆栈。
引用所有资源	启用后，RenderDoc将包括采集中的所有渲染资源，甚至包括帧过程期间未使用的资源。启用此属性会极大增加采集内容的容量。
保存所有初始状态	启用后，RenderDoc将始终采集所有渲染资源的初始状态，即使这些渲染资源不大可能在帧过程中使用也同样如此。启用此属性会极大增加采集内容的容量。
高级设置
在启动时显示帮助	启用后，RenderDoc的帮助窗口将在编辑器启动时显示。
使用RenderDoc崩溃处理程序	启用后，发生崩溃时将使用RenderDoc崩溃处理器。建议在你了解RenderDoc应用程序存在问题并想要通知RenderDoc开发人员时才使用此设置。
RenderDoc可执行路径	设置要使用的RenderDoc可执行文件的路径。安装RenderDoc时，它应自动填写正确路径。