UE4中使用RenderDoc截幀

RenderDoc（src，doc，ue4 doc，ue4文檔）是一個獨立的開源圖形調試器，經過採集和檢查GPU上運行的單個幀，來定位圖形bug和優化性能

RenderDoc支持任何在Win七、Win十、Linux或Android上使用Vulkan、D3D十一、D3D十二、OpenGL3.2+ & OpenGL ES2.0-3.2的應用程序

市面上大部分Android平臺的GPU都是通用的，所以，RenderDoc做爲通用的圖形調試器，對這些GPU均可以進行截幀

而不像高通和mali的截幀工具那樣，須要區分GPU（高通GPU只能snapdragon截幀工具，mali的只能用Mali Graphics Debugger）

RenderDoc容許開發者編寫python腳原本快速發現當前幀繪製中存在的問題、提升截幀分析效率和對使用的資源統計分析（Drawcall與紋理、shader program 信息的統計與分組等）

 

RenderDocPlugin（wiki，src）是UE4引擎中集成的一個插件（代碼在：Plugins\Developer\RenderDocPlugin），方便UE4拉起和調用RenderDoc工具

 

環境設置

① 安裝RenderDoc工具（缺省會安裝到C:\Program Files\RenderDoc）

② 在UE4編輯器的Plugins面板中搜索RenderDocPlugin，並勾選Enabled啓用該插件

③ 按照提示，重啓UE4編輯器，此時C:\Program Files\RenderDoc\renderdoc.dll會被加載到編輯器進程

④ 設置RenderDoc：在UE4編輯器的Project Settings面板中Plugins -- RenderDoc標籤中

這些設置項可在Output Log面板的Cmd（輸出到log）和遊戲控制檯（輸出到控制檯窗口）中執行命令進行查看和修改

FrameCaptureSettings下的選項勾選得越多，抓取的幀中數據就越豐富，文件也越大，也會使得截取和分析幀的時間更久

renderdoc.BinaryPath  // 查看RenderDoc的安裝路徑

renderdoc.BinaryPath "C:\Program Files\RenderDoc"  // 設置RenderDoc的安裝路徑爲C:\Program Files\RenderDoc

renderdoc.CaptureAllActivity 1   // 勾選CaptureAllActivity（獲取編輯器全部viewport和窗口的渲染數據，而不單單是當前viewport）

renderdoc.CaptureCallstacks // 查看CaptureCallstacks（獲取圖形API的調用堆棧）是否勾選

renderdoc.EnableCrashHandler 0 // 取消勾選EnableCrashHandler（截幀崩潰時是否使用RenderDoc的crash handler）

renderdoc.ReferenceAllResources  // 查看ReferenceAllResources（獲取全部mesh、材質，紋理等渲染資源，開啓該選項會致使幀文件很大）是否勾選

renderdoc.SaveAllInitials 1 // 勾選SaveAllInitials（獲取全部mesh、材質，紋理等渲染資源的初始狀態，開啓該選項會致使幀文件很大）

renderdoc.ShowHelpOnStartup  // 查看ShowHelpOnStartup（啓動編輯器時是否彈出RenderDoc的幫助對話框）是否勾選

⑤ 截幀後Shader只能看到彙編代碼片斷，若想看到源代碼，須要打開Engine\Config\ConsoleVariables.ini配置文件，取消如下兩行的註釋

r.Shaders.Optimize=0
r.Shaders.KeepDebugInfo=1

⑥ UE4爲了方便對幀的繪製過程進行分析，代碼中插入了不少Event調用，用來講明後面的渲染行爲

    可在控制檯中執行ToggleDrawEvents命令來打開和關閉Event的調用

    在UE4中插入Event主要是經過調用SCOPED_DRAW_EVENT、SCOPED_CONDITIONAL_DRAW_EVENT等宏來構造一個TDrawEvent<TRHICmdList>對象並調用Start方法，而後在對象析構時調用其Stop方法

    相關的宏和代碼在：RealtimeGPUProfiler.h  RealtimeGPUProfiler.cpp

    Start / Stop方法會調用不一樣渲染API的RHI的PushEvent / PopEvent方法，由這些PushEvent來實現Event標記的添加。如：Dx中會調用D3DPERF_BeginEvent / D3DPERF_EndEvent兩個API來實現

 

編輯器截幀

編輯器中主要是經過RenderDocPlugin插件調用void  FRenderDocPluginModule::CaptureFrame()函數來截幀，而後拉起RenderDoc進程

方法一：在編輯器非Play狀態下，點擊右上角按鈕進行截幀；Play狀態下，先Eject後，再點擊右上角按鈕進行截幀

方法二：經過renderdoc.CaptureFrame命令來截幀（支持編輯器和單機）

方法三：啓動RenderDoc，點擊菜單：File -- Attach to Running Instance

點擊Connect to App按鈕，讓RenderDoc和目標進程創建會話，而後點擊會話面板上的Capture Frame(s) Immediately按鈕進行截幀

注1：截取的幀會臨時保存在項目工程的Saved\RenderDocCaptures目錄中，截取成功後，會使用RenderDoc打開該臨時幀文件，若須要保留該文件須要手動進行保存

注2：RenderDoc的log文件在%Temp%\RenderDoc目錄中

　　

PC客戶端截幀

方法一：從RenderDoc中拉起目標進程

① 啓動RenderDoc，點擊菜單：File -- Launch Application，而後填寫exe可執行路徑（注：若是遊戲進程是被登陸器等做爲子進程拉起，須要勾選"Capture Child Processes"）

② Launch啓動遊戲後，而後按F12進行截幀 

 

方法二： 在啓動初期（任何圖形API都沒有調用的狀況下），將RenderDoc注入到目標遊戲進程

① 啓動RenderDoc，點擊菜單：File -- Inject into Process，搜索並選中目標進程，而後點擊Inject按鈕進行注入

   爲了抓啓動初期這個時間點，可使用windbg調試運行進程（啓動後會當即中斷到windbg中），而後在RenderDoc中準備好後，在windbg中F5運行後，在RenderDoc中當即進行Inject

   另外，對於非shipping版的遊戲進程，能夠帶上-WaitForDebugger啓動，這樣遊戲會一直等待調試器Attach，而後在RenderDoc中Inject，最後拿windbg或vs Attach遊戲並讓其繼續運行

② Launch啓動遊戲後，而後按F12進行截幀  

 

方法三：使用global process hooking來創建與RenderDoc之間的會話

① 在RenderDoc菜單Tools -- Settings面板的General標籤下勾選"Allow global process hooking - be careful"

② 點擊菜單：File -- Launch Application，填寫exe可執行路徑，而後點擊"Enable Global Hook"按鈕，讓hook鉤子對目標路徑進行監聽，一旦有進程啓動自動完成注入

③ 按照正常流程啓動遊戲後，而後按F12進行截幀  

 

注1：截取的幀缺省會保存在%Temp%\RenderDoc目錄中（可在RenderDoc菜單Tools -- Settings面板的General標籤下的Directory for temporary capture files中指定路徑）

注2：RenderDoc的log文件在%Temp%\RenderDoc目錄中

注3：PC客戶端的截幀方法一樣適合編輯器

 

另外，不管編輯器仍是PC客戶端，與RenderDoc創建會話後，後續也能夠經過點擊會話面板上的Capture Frame(s) Immediately按鈕來快捷截幀