图形渲染与 Shader / 系统课时

用 RenderDoc 追一条 Draw Call

用 RenderDoc 追一条 Draw Call

当画面只有某个物体变黑、贴图错误或某次绘制突然覆盖全屏时,从整帧 Shader 代码里猜原因效率很低。RenderDoc 的价值在于把一帧拆成可检查的 GPU 事件,让你选中具体 Draw Call,再核对输入资源、Shader、常量和渲染状态,快速确定错误发生在绘制前还是 Shader 执行中。

学习目标

  • 从帧捕获中准确找到造成异常的 Draw Call
  • 检查该次绘制绑定的纹理、Buffer、Shader 和固定渲染状态
  • 根据捕获结果区分资源错误、常量错误和 Shader 逻辑错误

先捕获能稳定复现问题的一帧

使用 RenderDoc 前,先把场景收敛到“每次都能看到同一异常”。如果黑屏只偶尔发生,可以先关闭随机动画、动态分辨率或无关后处理,减少每帧事件差异。捕获到问题帧后,不要急着浏览所有资源,先围绕最终出现异常的目标区域寻找对应绘制事件。

通常可以从事件列表中的 Draw、DrawIndexed 或具体 API 绘制事件开始。选中候选事件后观察输出目标,如果切到该事件时异常物体刚好出现,说明已经接近真正的问题 Draw Call;如果画面在更早事件就已损坏,则需要继续向前追踪。

RenderDoc 中定位单次绘制事件

不同 RenderDoc 版本、图形 API 和窗口布局可能稍有差异,因此应以你实际安装版本中的事件列表与 Pipeline State 面板为准,而不是死记某个按钮的位置。

沿着管线检查输入和输出

选中目标 Draw Call 后,先看它写入哪个 Render Target 或深度目标,再看顶点输入、纹理、Sampler 和常量资源。这个顺序能回答一个关键问题:Shader 收到的数据是否已经错了。

检查纹理时,重点确认绑定槽位、尺寸、Mip、格式和实际内容。若 Shader 期望法线贴图,但对应槽位绑定成了默认白图,继续读 Shader 源码没有意义。检查 Buffer 时则关注当前 Draw Call 真正看到的数值,而不是 CPU 代码里“理论上应该上传”的数值。

假设片元 Shader 依赖下面这组材质常量,RenderDoc 中就应该核对对应常量缓冲区的实际内容。

hlsl
cbuffer MaterialParams : register(b0)
{
    float4 BaseColor;
    float Roughness;
    float Metallic;
    float2 Padding;
};

float4 PSMain(float2 uv : TEXCOORD0) : SV_Target
{
    // 为了调试,先忽略复杂光照,直接验证常量是否按预期进入片元阶段。
    return float4(BaseColor.rgb * (1.0 - Roughness * 0.5), BaseColor.a);
}

这是片段示例,需要对应的顶点阶段、资源绑定以及图形 API 管线才能运行。若捕获中 BaseColor 和 Roughness 与 CPU 端预期一致,输出颜色应随这两个参数稳定变化;如果 RenderDoc 中数值本身已经错误,应优先检查常量缓冲区布局、更新时机和绑定槽位,而不是继续修改片元公式。

再检查 Shader 和固定渲染状态

资源正确后,再确认当前 Draw Call 实际绑定的是哪一个 Shader 变体。工程中常有宏、材质关键字和平台编译分支,源码文件看起来正确,不代表这一帧真正执行的就是你正在阅读的那一版。

随后检查深度测试、深度写入、面剔除、混合模式、Viewport 和 Scissor。很多“Shader 输出明明正确却看不见”的问题,本质上是固定管线状态把结果拒绝或裁掉了。例如深度比较方式错误可能让全部片元测试失败,错误的 Scissor 则可能只允许一个很小区域写入。

用中间结果验证是哪一阶段出错

如果纹理、常量和固定状态都没有异常,可以临时简化 Shader 输出。例如先直接输出 UV、法线或单个材质参数,重新捕获一帧,再比较结果。这样可以把一个复杂 PBR Shader 拆成多个可验证中间量。

还可以对比问题 Draw Call 前后的 Render Target 内容。如果绘制前目标正确,绘制后出现全屏覆盖,要重点检查顶点位置、Viewport、深度和混合状态;如果只有物体内部颜色异常,更应该检查材质纹理、常量和片元阶段计算。

RenderDoc 的核心不是“把所有面板看一遍”,而是始终围绕一条具体 Draw Call 建立证据链:事件是否正确、输入是否正确、Shader 是否正确、状态是否正确、输出从哪一步开始异常。按这条链路排查,复杂渲染错误通常能被缩小到一个资源绑定、一组常量、一个 Shader 变体或一项管线状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 RenderDoc 追一条 Draw Call

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通