游戏引擎 / 系统课时
写一个最小 Shader 并让画面变色
写一个最小 Shader 并让画面变色
本课不依赖复杂光照或贴图算法,只用一个 Sprite2D 和几行 Godot Shader 代码,让原始图像立即变成指定颜色。你将亲手使用 shader_type、fragment() 与 COLOR,观察代码修改如何影响屏幕上的像素,并避免把透明背景误改成色块。
学习目标
- 编写能在 Godot 4.x 运行的最小 2D Shader。
- 解释
shader_type canvas_item、fragment()、COLOR和vec4的作用。 - 验证画面颜色及透明度变化,定位常见的无效果问题。
准备一个有纹理的 Sprite2D
在 Godot 4.x 新建 2D 场景,根节点使用 Node2D,添加子节点 Sprite2D。选中 Sprite2D,在 Inspector 的 Texture 属性中加载项目的 icon.svg 或任意带透明背景的 PNG,使图片在 2D 画布中可见。
随后打开 CanvasItem → Material,选择 New ShaderMaterial;展开新材质,在 Shader 属性中选择 New Shader,点击 Shader 资源进入 Shader 编辑器。如果资源已有默认代码,可以直接将其替换为下方的完整示例。
Shader 不会凭空绘制整张屏幕:本例只修改 Sprite2D 参与绘制的区域。若节点没有可绘制的纹理,后续代码正确也可能看不到效果。
写入最小的片元着色器
将以下内容完整写入 Shader 编辑器。
shader_type canvas_item;
void fragment() {
// 修改 RGB 颜色,但沿用纹理原有的 Alpha。
COLOR = vec4(0.95, 0.25, 0.15, COLOR.a);
}预期结果:Sprite2D 的可见部分呈珊瑚红色,原来透明的背景仍保持透明。保存场景并运行当前场景时,显示效果应与编辑器 2D 画布一致。
第一行的 shader_type canvas_item; 指定 2D CanvasItem 着色器,决定可用的内置变量与处理阶段。void fragment() 是片元处理函数:对于被绘制覆盖的片元,它计算最终颜色;这里不必编写 vertex() 或 light()。
COLOR 在 fragment() 中既是输入也是输出。对 Sprite2D 而言,其输入通常已经包含纹理颜色及节点的颜色调制。vec4(r, g, b, a) 是四分量向量:前三个值代表红、绿、蓝通道,最后一个是透明度,常用范围为 0.0 到 1.0。
这里用常量覆盖 RGB,却从原始 COLOR.a 读取透明度,因而保留图像轮廓。若直接使用 vec4(0.95, 0.25, 0.15, 1.0),精灵原本透明的纹理区域也可能被画成不透明色块,这与“给原图换色”的目标不同。
修改参数并核对结果
把三个 RGB 常量依次改成 0.15、0.80、0.35,保存后观察:精灵应由珊瑚红变为绿色,而透明区域不变。只修改数字就能得到反馈,说明 Shader 已通过材质参与实际渲染。
颜色变化位置与代码责任可以这样理解:节点决定画在哪里,ShaderMaterial 决定使用哪段 Shader,fragment() 决定这些片元最终输出什么 COLOR。这一示例是固定颜色覆盖,不是“将原贴图整体乘上一层颜色”;后者需要对原 RGB 保留或混合计算。
看不到预期颜色时如何定位
若整个精灵消失,先确认 Sprite2D 的 Visible 已开启、纹理已加载、节点位于画面内,再检查 Alpha 是否被写为 0.0。如果仍保持原色,确认 ShaderMaterial 挂在当前 Sprite2D 的 Material 上,其 Shader 字段引用的是刚才编辑的代码。
若 Shader 编辑器报错,核对 shader_type canvas_item; 的分号、fragment() 的花括号,以及 COLOR 是否大写;不要误写成 3D 的 shader_type spatial;。有多个相似节点时,可以临时隐藏其他精灵,只观察当前对象。
当你能稳定地把精灵从红色改为绿色并保留透明轮廓,就已经验证了“着色器类型 → 片元函数 → 颜色输出”的最小工作链路。