图形渲染与 Shader / 系统课时
用 HLSL 写第一个片元颜色
用 HLSL 写第一个片元颜色
这一节只做一件事:写出最小 HLSL 片元程序,让物体表面输出固定颜色。通过这个例子,你会看到片元函数的返回值如何对应到渲染目标,并理解为什么第一段 Shader 不需要纹理、光照或复杂输入。
学习目标
- 写出能返回固定 RGBA 颜色的最小 HLSL 片元函数
- 理解
SV_Target与float4在输出颜色时各自承担的作用 - 知道什么时候需要输入结构,什么时候固定颜色可以省略输入
最小片元函数
在 HLSL 中,片元阶段通常写成一个返回颜色的函数。下面是片段示例,它需要由 Unity、Unreal、自研 Direct3D 程序或其他宿主完成编译与绑定,本身不是独立可执行程序。
float4 PSMain() : SV_Target
{
// RGBA 四个分量都使用 0~1 范围的浮点值。
return float4(1.0, 0.2, 0.1, 1.0);
}这里的 float4 表示四个浮点分量,通常对应红、绿、蓝和 Alpha。SV_Target 是输出语义,告诉编译器:这个返回值要写入当前渲染目标的颜色附件。
预期结果:当宿主程序把 PSMain 作为当前像素着色函数,并且前面的顶点阶段已经成功输出可见三角形时,覆盖到的像素会显示为偏红色;实际亮度还可能受颜色空间、混合状态和后续处理影响。
为什么这里没有输入结构
固定颜色完全不依赖顶点属性、纹理坐标或世界位置,因此片元函数可以不接收参数。这样能把第一个实验压缩到最小:只验证“片元阶段是否执行”和“返回值是否写入目标”。
当颜色需要根据 UV、法线或位置变化时,才需要定义输入结构。例如后续纹理采样通常会接收由顶点阶段插值得到的 UV。不要为了形式完整而提前加入当前逻辑用不到的字段。
颜色值如何理解
HLSL 中常见的颜色写法使用 0 到 1 的浮点数。float4(1.0, 0.2, 0.1, 1.0) 表示红色分量最高、绿色和蓝色较低、Alpha 为 1。它不是 255, 51, 26, 255 这种 8 位整数写法。
如果要把常见 8 位颜色换算成 Shader 浮点值,可以逐通道除以 255。例如红色通道 128 对应约 0.502。第一节练习固定颜色时,直接使用易读的小数即可。
验证失败时先查什么
如果代码没有语法错误但屏幕仍然没有目标颜色,优先确认宿主侧是否真的使用了这个入口函数。Shader 文件能成功编译,不代表当前材质、Pass 或管线已经绑定到它。
随后检查几何体是否在相机内、顶点阶段是否产生可见图元、背面剔除和深度测试是否把它挡掉。最后再看混合、HDR、色调映射或颜色空间设置,因为这些状态可能让最终屏幕颜色与代码里的数值不同。
当固定颜色能稳定显示后,你就已经验证了最关键的一条链路:几何体经过前序阶段生成片元,片元函数被调用,SV_Target 的结果进入渲染目标。后续所有材质效果,本质上都是把“固定返回值”逐步替换成由输入数据计算出的颜色。