154 lines
5.5 KiB
Markdown
154 lines
5.5 KiB
Markdown
---
|
||
title: RDG Debug笔记
|
||
date: 2025-06-14 15:44:47
|
||
excerpt:
|
||
tags:
|
||
rating: ⭐
|
||
---
|
||
# 前言
|
||
- [UE5 Render Dependency Graph-实用指南](https://zhuanlan.zhihu.com/p/637889120)
|
||
|
||
# Command
|
||
- r.rdg
|
||
- AsyncCompute
|
||
- BreakPoint
|
||
|
||
## Reference
|
||
```c++
|
||
FAutoConsoleVariableRef CVarRDGDebug(
|
||
TEXT("r.RDG.Debug"),
|
||
GRDGDebug,
|
||
TEXT("Allow to output warnings for inefficiencies found during wiring and execution of the passes.\n")
|
||
TEXT(" 0: disabled;\n")
|
||
TEXT(" 1: emit warning once (default);\n")
|
||
TEXT(" 2: emit warning everytime issue is detected."),
|
||
ECVF_RenderThreadSafe);
|
||
|
||
FAutoConsoleVariableRef CVarRDGClobberResources(
|
||
TEXT("r.RDG.ClobberResources"),
|
||
GRDGClobberResources,
|
||
TEXT("Clears all render targets and texture / buffer UAVs with the requested clear color at allocation time. Useful for debugging.\n")
|
||
TEXT(" 0:off (default);\n")
|
||
TEXT(" 1: 1000 on RGBA channels;\n")
|
||
TEXT(" 2: NaN on RGBA channels;\n")
|
||
TEXT(" 3: +INFINITY on RGBA channels.\n"),
|
||
ECVF_Cheat | ECVF_RenderThreadSafe);
|
||
|
||
FAutoConsoleVariableRef CVarRDGOverlapUAVs(
|
||
TEXT("r.RDG.OverlapUAVs"), GRDGOverlapUAVs,
|
||
TEXT("RDG will overlap UAV work when requested; if disabled, UAV barriers are always inserted."),
|
||
ECVF_RenderThreadSafe);
|
||
|
||
FAutoConsoleVariableRef CVarRDGTransitionLog(
|
||
TEXT("r.RDG.TransitionLog"), GRDGTransitionLog,
|
||
TEXT("Logs resource transitions to the console.\n")
|
||
TEXT(" 0: disabled(default);\n")
|
||
TEXT(">0: enabled for N frames;\n")
|
||
TEXT("<0: enabled;\n"),
|
||
ECVF_RenderThreadSafe);
|
||
|
||
TAutoConsoleVariable<FString> CVarRDGDebugPassFilter(
|
||
TEXT("r.RDG.Debug.PassFilter"), TEXT(""),
|
||
TEXT("Filters certain debug events to specific passes. Set to 'None' to reset.\n"),
|
||
ECVF_Default);
|
||
|
||
TAutoConsoleVariable<FString> CVarRDGDebugResourceFilter(
|
||
TEXT("r.RDG.Debug.ResourceFilter"), TEXT(""),
|
||
TEXT("Filters certain debug events to a specific resource. Set to 'None' to reset.\n"),
|
||
ECVF_Default);
|
||
|
||
FAutoConsoleVariableRef CVarRDGParallelSetup(
|
||
TEXT("r.RDG.ParallelSetup"), GRDGParallelSetup,
|
||
TEXT("RDG will setup passes in parallel when prompted by calls to FRDGBuilder::FlushSetupQueue.")
|
||
TEXT(" 0: pass setup is done synchronously in AddPass;")
|
||
TEXT(" 1: pass setup is done asynchronously (default);"),
|
||
ECVF_RenderThreadSafe);
|
||
```
|
||
|
||
# Visualize Texture Integration
|
||
**vis**
|
||
使用vis指令，可以打印vis指令帮助信息，以及当前帧使用到的所有的资源信息
|
||
|
||
![[RDG_Vis.jpg|1200]]
|
||
|
||
**vis [RT Name]**
|
||
使用vis [RT Name]可以实时预览当前RT的内容，在调试渲染特性的时候可以很方便的Debug
|
||
|
||
![[RDG_Vis_RTName.jpg|800]]
|
||
|
||
**vis [RT Name] bump**
|
||
打印当前RT到Saved/Screenshots
|
||
|
||
**vis off**
|
||
关闭当前帧的debug模式
|
||
|
||
# r.RDG.ImmediateMode
|
||
将RDG设置成理解执行模式，方便进行资源绑定Debug以及断点。
|
||
- RDG立即执行模式:
|
||
- 立刻执行Pass在其被添加的时候
|
||
- 产生和延后执行时一样的功能
|
||
- 如果打断点，会非常容易检查其创建的代码
|
||
- 由于这个原因，所以不能在AddPass后再去更改Pass参数
|
||
- 可以利用r.RDG.ImmediateMode在运行时切换
|
||
- 会消耗更多的内存，可以考虑使用r.Test.SecondaryUpscaleOverride运行在低分辨率下。（r.Test.SecondaryUpscaleOverride 设置的参数越大越模糊）
|
||
|
||
![[RDG_Immediate.png|800]]
|
||
|
||
- **r.RDG.ImmediateMode 1** / -rdgimmediate : 去除RDG的影响
|
||
- **r.RHICmdBypass 1** ：去除RHI和并行渲染的影响
|
||
- r.RDG.ParallelExecute=0
|
||
- r.RDG.ParallelSetup=0
|
||
|
||
## RDG Async Compute
|
||
1.直接设置ComputePassFlags为ERDGPassFlags::AsyncCompute，剩下的工作交给RDG自动判断和设置
|
||
```c++
|
||
ERDGPassFlags ComputePassFlags = (GSupportsEfficientAsyncCompute && CVarTSRAsyncCompute.GetValueOnRenderThread() != 0) ? ERDGPassFlags::AsyncCompute : ERDGPassFlags::Compute;
|
||
|
||
TShaderMapRef<FTSRClearPrevTexturesCS> ComputeShader(View.ShaderMap);
|
||
FComputeShaderUtils::AddPass(
|
||
GraphBuilder,
|
||
RDG_EVENT_NAME("TSR ClearPrevTextures %dx%d", InputRect.Width(), InputRect.Height()),
|
||
ComputePassFlags,
|
||
ComputeShader,
|
||
PassParameters,
|
||
FComputeShaderUtils::GetGroupCount(InputRect.Size(), 8 * 2));
|
||
```
|
||
|
||
2.在Render层调整Pass顺序，为RDG提供更多Async Compute Overlap的可能性
|
||
|
||
# ValidateShaderParameters
|
||
ValidateShaderParameters()可以检测RDG绑定的资源是否都存在。
|
||
|
||
# -rdgdebug
|
||
`r.RDG.Debug = 1`来开启。
|
||
|
||
# RDG Insight
|
||
开启RDG Insight Plugin之后即可在UnrealInsight看到额外添加RDG Channel。
|
||
|
||
命令行启动游戏：
|
||
`Game.exe -trace=rdg,defaults`
|
||
|
||
# DumpGPU
|
||
使用DumpGPU指令可以将当前帧的所有Pass和资源信息打印，可以很方便的进行查看。
|
||
在Console中输入DumpGPU指令，会弹出生成好的html文件：
|
||
|
||
|
||
|
||
|
||
执行OpenGPUDumpViewer.bat打开网页，默认只支持chrome浏览器，可以通过修改脚本调用别的浏览器：
|
||
|
||
|
||
|
||
可以看到各个Pass的信息：
|
||
|
||
|
||
|
||
|
||
显示当前帧所有CVar的值：
|
||
|
||
|
||
|
||
|
||
比较像素的值：
|
||
|
||
 |