RenderDoc是一款免费的开源图形调试程序,可以逐帧捕捉虚幻引擎等应用的画面。捕捉内容将被载入到RenderDoc中,并解释各个事件、API等内容对GPU的影响。
安装RenderDoc
RenderDoc是一款开源图形调试器,可从RenderDoc.org免费下载和安装。
以下列表指明了RenderDoc当前支持的操作系统和API,它们与Unreal Engine的支持可能有所不同。欲知最新更新,请参阅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可兼容虚幻引擎可执行文件。请参阅RenderDoc文档,了解设置指南。
虚幻引擎4自带了一个在编辑器中执行下一帧采集并在RenderDoc中自动打开该采集的简易插件。使用以下步骤即可在你的项目中将其启用:
- 导航到主菜单,选择 编辑(Edit) > 插件(Plugins) 打开插件浏览器。
-
你可在 渲染(Rendering) 类目下找到 RenderDoc插件(RenderDoc Plugin),也可直接使用插件浏览器窗口顶部的搜索栏。
- 勾选 启用(Enabled) 旁边的复选框,并在出现提示后重新启动编辑器。
编辑器重新启动后,关卡视口的右上角将包含新的UI按钮。你可使用它来执行采集。

执行帧采集
以下步骤详细介绍如何使用集成的RenderDoc插件或直接在RenderDoc应用程序中对Unreal Engine项目执行单帧采集。
欲知RenderDoc功能和使用的详细信息,请参阅RenderDoc文档。
RenderDoc插件
以下是使用Unreal Engine的RenderDoc插件采集帧的步骤:
- 为你的项目启用RenderDoc插件。
- 打开需要执行采集的项目和场景。
-
在关卡视口中点击 RenderDoc采集(RenderDoc Capture) 按钮。
点击查看大图。
RenderDoc应用程序
以下介绍使用Unreal Engine和standalone 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 executable path) | 设置要使用的RenderDoc可执行文件的路径。 |
其他注释和资源
- 欲知有关RenderDoc使用和帧采集分析的更多内容,请参阅RenderDoc文档。
- RenderDoc插件由Fredrik Lindh("Temaran")为Unreal Engine独家开发。欲知更多信息,请参阅RenderDoc的GitHub元库。