图形渲染与 Shader / 系统课时
黑屏与花屏如何快速定位
黑屏与花屏如何快速定位
后处理一旦出现全黑、全白、随机噪点或画面撕裂,最有效的方法不是继续改效果参数,而是把整条 Pass 缩减为“输入纹理能否原样输出”。只要按输入纹理、格式、UV、颜色空间和输出目标的顺序排查,通常能很快锁定故障层级。
学习目标
- 建立从输入纹理到 Pass 输出的固定排障顺序
- 区分纹理格式、UV、颜色空间和 Render Target 配置引发的不同症状
- 用最小透传 Shader 判断问题是在采样前、采样中还是输出后
先把效果退回到透传
无论当前 Pass 做 Bloom、色调映射还是故障特效,第一步都应暂时移除全部复杂计算,只保留一次输入纹理采样并直接返回。这样可以把“算法错误”和“渲染链路错误”快速分开。
下面是一个最小 HLSL 片段示例。它假设顶点阶段已经提供 0 到 1 范围的 UV,并且输入纹理绑定到 _SourceTex。
hlsl
Texture2D _SourceTex;
SamplerState sampler_SourceTex;
struct PSInput
{
float4 position : SV_POSITION;
float2 uv : TEXCOORD0;
};
float4 Frag(PSInput input) : SV_Target
{
float2 uv = saturate(input.uv);
return _SourceTex.Sample(sampler_SourceTex, uv);
}预期结果
text
后处理输出应与输入画面基本一致;如果仍然黑屏或花屏,问题大概率不在特效公式,而在纹理绑定、UV、格式、颜色空间或输出目标。按渲染链路从前往后检查
排障顺序应与数据流方向一致:先确认 Pass 收到了正确输入,再看怎样采样,最后看怎样写回目标。

- 输入纹理:确认资源真的绑定到了当前 Pass,且前一个 Pass 已经完成写入。
- 尺寸和格式:检查源纹理与目标纹理的宽高、MSAA、HDR 格式、通道数和采样方式是否兼容。
- UV:确认 UV 范围、Y 轴方向、全屏三角形插值和平台差异。
- 颜色空间:确认输入是线性值还是 sRGB 值,HDR 数据是否在错误阶段被 Clamp。
- 输出目标:确认当前 Pass 写入的 Render Target 正是后续链路读取的目标,没有读写同一纹理造成未定义行为。
用症状反推故障层
不同故障通常有明显特征,可以用来缩短搜索范围。
| 现象 | 优先检查 |
|---|---|
| 整屏纯黑 | 输入纹理未绑定、采样返回 0、目标未写入 |
| 整屏纯白或极亮 | HDR 数值溢出、颜色空间重复转换、错误曝光 |
| 图像上下翻转 | UV 的 Y 轴方向或平台坐标约定 |
| 规律性方块或随机噪点 | 未初始化 Render Target、格式解释错误、越界采样 |
| 只有部分平台异常 | 纹理格式支持、精度、UV 原点、MSAA Resolve |
如果黑屏只出现在某个后处理 Pass 之后,可以让该 Pass 输出常量颜色进一步定位。例如把返回值临时改成 float4(1, 0, 1, 1)。若屏幕能显示洋红色,说明 Pass 本身被执行且输出目标可见,问题更可能位于输入采样或中间计算。
恢复效果时一次只加一层
透传正常后,不要一次恢复整段原始 Shader。按依赖顺序逐层加回:先 UV 变换,再颜色空间处理,再核心特效公式,最后恢复多 Pass 混合和临时 Render Target。
每恢复一层都观察画面是否仍正确,这相当于对渲染链做二分缩小。若某一步刚恢复就出错,根因通常就在这一层新增的采样、格式转换或数学运算中。
当排障顺序固定为“先透传,再检查输入、格式、UV、颜色空间和输出”,黑屏与花屏就会从难以复现的视觉问题,变成可以逐层验证的数据链路问题。
按自己的节奏,确认真正理解。