游戏引擎 / 系统课时
让 Shader 随时间自动播放
让 Shader 随时间自动播放
想让 Sprite2D 的亮色像呼吸一样变化、纹理轻微晃动,甚至高亮范围也持续改变,不一定要编写逐帧更新脚本。本节直接使用 Godot 4 内置的 TIME 同时驱动颜色、UV 和亮度阈值,完成运行后自动播放的 2D 动态材质。
学习目标
- 区分
TIME、周期函数和逐帧累加时间的作用。 - 使用同一时间源控制颜色强度、纹理采样坐标和阈值。
- 验证动画参数,并理解暂停和纹理边界的限制。
从时间生成三条变化曲线
TIME 是引擎启动后经过的秒数,可直接在 canvas_item 的 fragment() 中读取。它不是帧数,也不需要每帧手动增加。sin(TIME * speed) 在 -1~1 之间往复变化;转换成 0.5 + 0.5 * sin(...) 后,就得到适合控制混合强度的 0~1 信号。
同一个 TIME 可以分流给三条计算:颜色通道让高亮强弱起伏,UV 通道给采样位置加入细微摆动,阈值通道改变哪些亮度区域受到染色。速度参数改变各自的周期;对于正的 speed,完整正弦周期约为 2π / speed 秒,而不是每秒循环 speed 次。

用一份 Shader 让精灵自动变化
创建 Sprite2D,指定一张同时包含明暗区域的纹理;在其 Material 中新建 ShaderMaterial 和 Shader,粘贴以下完整代码。为方便观察,尽量选择有渐变或高光的图案,而不是纯黑或纯白图块。
shader_type canvas_item;
uniform float pulse_speed : hint_range(0.0, 6.0, 0.1) = 2.0;
uniform float wave_speed : hint_range(0.0, 6.0, 0.1) = 1.5;
uniform float wave_amount : hint_range(0.0, 0.05, 0.001) = 0.02;
uniform float threshold_speed : hint_range(0.0, 6.0, 0.1) = 1.0;
uniform vec4 highlight_color : source_color = vec4(0.15, 0.85, 1.0, 0.9);
void fragment() {
float t = TIME;
// UV 扰动在左右边缘趋近零,避免采样越界。
vec2 warped_uv = UV;
warped_uv.x += wave_amount
* sin(UV.y * 12.0 + t * wave_speed)
* sin(UV.x * PI);
vec4 base = texture(TEXTURE, warped_uv);
// 动态阈值选出适合显示高亮的亮部区域。
float luminance = dot(base.rgb, vec3(0.299, 0.587, 0.114));
float threshold = 0.4 + 0.2 * sin(t * threshold_speed);
float mask = smoothstep(threshold, threshold + 0.08, luminance);
// 呼吸系数和遮罩共同决定最终染色强度。
float pulse = 0.5 + 0.5 * sin(t * pulse_speed);
float strength = mask * pulse * highlight_color.a;
COLOR = vec4(mix(base.rgb, highlight_color.rgb, strength), base.a);
}预期结果:运行场景后,图案内部产生小幅波纹,高亮颜色有节奏地变强变弱,同时被染色的亮部范围随阈值扩大或收缩。纹理原有的透明轮廓仍被保留;材质无需脚本逐帧更新。
分别验证颜色、UV 和阈值
先将 wave_amount 设为 0,纹理采样不再摆动,但颜色与阈值仍继续变化;恢复为 0.02 后波动重新出现。接着将 threshold_speed 设为 0,亮度门槛固定在 0.4,只剩其他动态通道。把 pulse_speed 设为 0,高亮强度会固定在半幅值,而不是完全消失。
如果完全看不到阈值变化,检查底图是否有不同明暗层次:对于纯白区域,亮度总是高于本例的阈值范围;纯黑区域则不会被选中。UV 摆动幅度不要突然加大,否则可能出现可见形变或纹理采样异常。
TIME 在暂停和同步时的边界
Godot 4 的 TIME 受引擎 time_scale 影响,但场景树暂停不会让它自动停止;因此暂停游戏后,材质动画仍可能继续。默认计时还会在较长时间后回绕,所以不宜把它当作永久递增的业务计时器。
如果只是制作持续呼吸的发光、传送门或水波,直接用 TIME 最省事;如果必须随游戏暂停、从零重新播放、为不同实例设置独立起点,或实现确定性回放,应改为由脚本更新自定义时间 uniform,并用那个值替换 TIME。