图形渲染与 Shader / 系统课时
为效果增加调试显示开关
为效果增加调试显示开关
复杂 Shader 最难排查的不是“最终颜色不好看”,而是不知道 UV、法线、遮罩、深度或透明度中的哪一步先出错。本节给片元阶段加入统一的调试视图开关,让每个关键中间量都能直接映射成屏幕颜色,同时保留正常渲染路径。
学习目标
- 设计一个统一的 Debug View 参数,在正常画面与诊断画面之间切换
- 把 UV、世界法线、遮罩、场景深度和 Alpha 转成可读的颜色
- 明确哪些性能问题可以由 Shader 调试视图发现,哪些必须交给 GPU Profiler
让中间量可以被看见
诊断输出的原则是“一次只看一个问题”。UV 适合直接输出 frac(uv);单位法线从 -1~1 映射到 0~1;单通道 Mask、Depth、Alpha 则复制到 RGB。这样颜色本身就代表数据,不需要在最终材质结果上猜原因。
调试模式建议使用整数参数:0 保持正常渲染,1~5 分别显示 UV、法线、Mask、Depth、Alpha。开发阶段用 if 分支足够直观;发布前把参数恢复为 0,并确认材质实例没有遗留诊断状态。
加入统一调试函数
下面片段基于 Unity URP,依赖 Core.hlsl 与 DeclareDepthTexture.hlsl。它展示如何在已有片元函数中统一返回调试颜色;finalColor、mask 和 alpha 代表前面正常着色阶段已经算出的结果。
#include "Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl"
#include "Packages/com.unity.render-pipelines.universal/ShaderLibrary/DeclareDepthTexture.hlsl"
float _DebugView;
float4 DebugOutput(
float2 uv,
float3 normalWS,
float4 positionCS,
float mask,
float alpha,
float4 finalColor)
{
int mode = (int)round(_DebugView);
if (mode == 1)
{
// UV 超出 0~1 时仍显示重复后的局部坐标,便于发现拉伸与接缝。
return float4(frac(uv), 0.0, 1.0);
}
if (mode == 2)
{
float3 encodedNormal = normalize(normalWS) * 0.5 + 0.5;
return float4(encodedNormal, 1.0);
}
if (mode == 3)
{
return float4(mask.xxx, 1.0);
}
if (mode == 4)
{
float2 screenUV = GetNormalizedScreenSpaceUV(positionCS);
float rawDepth = SampleSceneDepth(screenUV);
float linearDepth01 = Linear01Depth(rawDepth, _ZBufferParams);
return float4(linearDepth01.xxx, 1.0);
}
if (mode == 5)
{
return float4(alpha.xxx, 1.0);
}
return finalColor;
}这是片段示例:需要把 _DebugView 声明到材质常量缓冲,并在已有 Frag 中传入真实的 uv、normalWS、positionCS、mask、alpha 和 finalColor。深度视图还要求 URP 为当前相机提供可采样的场景深度纹理;若项目没有启用相应深度纹理,不能把黑屏直接判断为“场景没有深度”。
验证时依次把 _DebugView 设为 1 到 5。预期结果:UV 显示周期性红绿渐变,法线呈随朝向变化的 RGB,Mask 与 Alpha 显示黑白灰度,Depth 从近到远呈不同灰度;设回 0 后恢复原始材质颜色。
把开关接到材质参数
在 Shader 的 Properties 中加入一个离散范围即可由材质面板切换。若团队已有自定义 Inspector,也可以把数字显示成枚举名称,但 Shader 侧仍保持单一参数,避免每个调试量都增加一个布尔开关。
_DebugView ("Debug View: 0 Final, 1 UV, 2 Normal, 3 Mask, 4 Depth, 5 Alpha", Range(0, 5)) = 0这属于配置片段,不会单独产生控制台输出。生效行为是材质面板出现 0~5 的滑杆;运行时修改该值后,片元函数应立即切换对应诊断颜色。验证重点不是“数值能不能改”,而是每个模式是否只暴露一个中间量。
用固定顺序定位异常
出现画面错误时,建议按数据产生顺序检查,而不是随意切换。先看 UV 是否连续,再看法线是否正确,然后看 Mask 是否符合预期;如果效果依赖深度,再检查 Depth;最后看 Alpha 是否把本来正确的颜色过度裁掉或混合掉。
这种顺序的价值在于“上游错误优先”。例如 Mask 全黑时,如果 UV 本身已经错位,就没有必要先怀疑噪声函数;深度视图异常时,也应先确认相机确实提供了深度纹理,再检查线性化公式。
对于性能关键量,可以额外把“纹理采样开关、昂贵特效分支是否启用、透明 Alpha 覆盖范围”作为诊断信息,但不要在 Shader 中伪造毫秒耗时。真正要判断某个版本是否更快,应固定相机与场景,用 GPU Profiler 对比 Draw Call、片元耗时和带宽相关指标。
发布前避免遗留调试状态
调试路径长期保留没有问题,问题在于材质实例可能把 _DebugView 保存成非零值。提交前应在代表性场景检查所有正式材质,确认默认值和运行时初始化都回到 0。如果项目通过脚本切换该参数,也应把调试入口限制在开发环境或内部工具中。
当 Shader 变复杂后,这套开关可以继续扩展,但编号要保持稳定并写在代码旁。稳定的诊断入口比临时改 return 更安全:它不会破坏正常着色逻辑,也能让程序、美术和技术美术使用同一套观察方式复现问题。