图形渲染与 Shader / 系统课时
把光照拆成可调试的中间量
把光照拆成可调试的中间量
材质出现“太黑、发亮位置不对、法线像翻面、局部突然变暗”时,直接盯着最终颜色很难判断是哪一步出错。本节把漫反射、镜面反射、法线和遮罩分别输出到屏幕,用可切换的调试视图快速定位光照计算中的问题。
学习目标
- 将漫反射、镜面、法线和遮罩转换为可直接观察的屏幕颜色
- 使用统一调试开关在中间量与最终材质之间切换
- 根据调试视图判断常见的方向、范围和贴图问题
为什么要先拆中间量
一段常见光照代码会连续完成法线采样、方向归一化、点积、镜面计算、遮罩调制和最终合成。最终颜色异常时,这些步骤会互相掩盖:例如错误法线可能让漫反射变暗,也可能同时让高光跑到错误位置。
更有效的方法是暂时停止合成,让每个关键量直接控制输出颜色。标量可以复制到 RGB 显示为灰度,方向向量则从 [-1, 1] 映射到 [0, 1]。这样每一步都变成肉眼可检查的结果。

建立统一调试开关
片段示例:下面的 HLSL 函数假定材质已经取得世界空间法线 normalWS、指向光源的方向 lightDirWS、指向相机的方向 viewDirWS、基础色和遮罩。它适合嵌入现有片元着色器,不是独立程序。
float3 EvaluateDebugLighting(
float3 baseColor,
float3 normalWS,
float3 lightDirWS,
float3 viewDirWS,
float mask,
int debugMode)
{
float3 N = normalize(normalWS);
float3 L = normalize(lightDirWS);
float3 V = normalize(viewDirWS);
float3 H = normalize(L + V);
// 中间量都限制到可显示范围,避免错误值被最终合成掩盖。
float diffuse = saturate(dot(N, L));
float specular = pow(saturate(dot(N, H)), 32.0);
float3 normalColor = N * 0.5 + 0.5;
float safeMask = saturate(mask);
if (debugMode == 1) return diffuse.xxx;
if (debugMode == 2) return specular.xxx;
if (debugMode == 3) return normalColor;
if (debugMode == 4) return safeMask.xxx;
return baseColor * diffuse * safeMask + specular.xxx;
}预期结果:将 debugMode 设为 1 时看到随受光角度变化的灰度;设为 2 时主要看到高光区域;设为 3 时法线方向表现为连续 RGB 颜色;设为 4 时只显示遮罩。设为 0 时恢复简单的最终光照合成。
这里故意让调试路径尽量短。调试代码本身越复杂,就越可能产生第二套错误。实际项目可以在材质面板、全局调试菜单或编译宏中控制模式,但不同模式最好共用同一组已经计算出的中间量。
逐项判断结果
漫反射视图主要检查 dot(N, L)。朝向光源的区域应更亮,背光区域应接近黑色。如果整个物体几乎全黑,先检查光线方向是否反了,以及法线和光线是否处在同一坐标空间。
镜面视图应形成相对集中的亮区,并随视线或光源移动。如果高光固定在模型某处,常见原因是视线方向没有按像素更新;如果高光出现在背面,则应检查法线方向以及是否错误地跳过了点积截断。
法线视图最适合寻找接缝、翻面和空间转换错误。平滑表面上的颜色通常应连续变化;如果某条 UV 接缝两侧突然出现明显颜色跳变,应继续检查切线空间到世界空间的转换、切线符号或法线贴图通道约定。
遮罩视图应该直接反映贴图或程序生成值。期望完全关闭效果的区域应接近黑色,完全开启区域应接近白色。如果遮罩边缘与模型纹理错位,问题通常位于 UV、采样通道或贴图导入设置,而不是光照公式。
从调试视图回到最终材质
确认单项正确后,再逐步恢复组合比一次性打开全部功能更可靠。可以先验证法线,再观察漫反射,然后加入镜面,最后乘入遮罩;每增加一项都比较最终结果是否符合刚才看到的中间量。
调试视图不应成为另一套材质实现。它的价值在于把已经存在的计算结果直接暴露出来,让“最终画面不对”变成“具体哪一个量不对”。建立这种逐项验证习惯后,复杂 Shader 的排查通常会比反复修改参数更快。