RenderDoc是一款免费的standalone开源图形调试器，可用于对虚幻引擎4（UE4）等应用程序执行单帧采集。采集内容将被载入到RenderDoc中，并通过事件、API等内容全面检查GPU上的情况。
安装RenderDoc
RenderDoc是一款开源图形调试器，可从RenderDoc.org免费下载和安装。
以下列表指明了RenderDoc当前支持的操作系统和API，它们与UE4的支持可能有所不同。欲知最新更新，请参阅RenderDoc的FAQ页面。
| 支持操作系统 |
| Windows 7和10 |
| Linux |
| Android |
| Google Stadia |
| Nintendo Switch |
| 支持API |
| Vulkan |
| D3D11 |
| D3D12 |
| Open GL3.2+ |
| Open GL ES 2.0 - 3.2 |
启用RenderDoc插件
无需启用RenderDoc插件即可将其与虚幻引擎项目一同使用。Standalone RenderDoc可兼容UE4可执行文件。请参阅RenderDoc文档，了解设置指南。
虚幻引擎4自带了一个在编辑器中执行下一帧采集并在RenderDoc中自动打开该采集的简易插件。使用以下步骤即可在您的项目中将其启用：
- 导航到主菜单，选择 编辑（Edit） > 插件（Plugins） 打开插件浏览器。
-
您可在 渲染（Rendering） 类目下找到 RenderDoc插件（RenderDoc Plugin），也可直接使用插件浏览器窗口顶部的搜索栏。
- 勾选 启用（Enabled） 旁边的复选框，并在出现提示后重新启动编辑器。
编辑器重新启动后，关卡视口的右上角将包含新的UI按钮。您可使用它来执行采集。
执行帧采集
以下步骤详细介绍如何使用集成的RenderDoc插件或直接在RenderDoc应用程序中对UE4项目执行单帧采集。
欲知RenderDoc功能和使用的详细信息，请参阅RenderDoc文档。
RenderDoc插件
以下是使用UE4的RenderDoc插件采集帧的步骤：
- 为您的项目启用RenderDoc插件。
- 打开需要执行采集的项目和场景。
-
在关卡视口中点击 RenderDoc采集（RenderDoc Capture） 按钮。
点击查看大图。
RenderDoc应用程序
以下介绍使用UE4和standalone RenderDoc可执行文件采集帧需要执行的高级步骤：
-
使用对应的命令行参数来配置RenderDoc启动游戏或UE4Editor.exe。
启动UE4Editor.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 executable path） | 设置要使用的RenderDoc可执行文件的路径。 |
其他注释和资源
- 欲知有关RenderDoc使用和帧采集分析的更多内容，请参阅RenderDoc文档。
- RenderDoc插件由Fredrik Lindh（“Temaran”）为UE4独家开发。欲知更多信息，请参阅RenderDoc的GitHub元库。