游戏引擎 / 系统课时
做一个可调方向的扫描线效果
做一个可调方向的扫描线效果
本节让 Sprite2D 上的亮带按指定方向循环扫过,不移动节点,也不修改原始贴图。你将用 UV 投影确定扫描位置,用平滑阈值做出有宽度的亮带,并把方向、速度、宽度和颜色暴露到 ShaderMaterial 面板中。
学习目标
- 理解方向向量、UV 投影坐标与亮带朝向的对应关系。
- 使用
TIME、fract和smoothstep构造循环扫描区域。 - 在 Godot 4 中挂载材质、调整参数并验证结果。
把二维 UV 转成扫描进度
Sprite2D 的 UV 通常覆盖纹理的 0~1 范围:U 向右增加,V 向下增加。令 scan_direction 为 (0, 1),扫描头沿纵向前进,画面显示水平亮线;改为 (1, 0),则得到从左向右移动的竖线。注意方向向量表示移动方向,不是线条的延伸方向。
计算时先把方向归一化,再将像素 UV 相对纹理中心的偏移投影到该方向。除以两个方向分量绝对值之和,可把水平、垂直和斜向的投影范围都归一化到 0~1。最后比较像素坐标与移动扫描头的距离,距离越近,亮带越明显。

挂载材质并编写 Shader
在 Godot 4 中创建 Sprite2D,指定一张有透明轮廓的纹理,将其 Material 设为 ShaderMaterial,再新建 Shader 并写入以下完整代码。示例假设节点的 Modulate 为白色,以便观察原始贴图和叠色效果。
shader_type canvas_item;
uniform vec2 scan_direction = vec2(0.0, 1.0);
uniform float scan_speed : hint_range(0.0, 2.0, 0.01) = 0.4;
uniform float scan_width : hint_range(0.01, 0.3, 0.005) = 0.08;
uniform float edge_softness : hint_range(0.001, 0.1, 0.001) = 0.015;
uniform vec4 scan_color : source_color = vec4(0.15, 0.9, 1.0, 0.9);
void fragment() {
vec4 base = texture(TEXTURE, UV);
// 零向量不能归一化,退回默认的向下扫描。
vec2 axis = scan_direction;
if (length(axis) < 0.0001) {
axis = vec2(0.0, 1.0);
}
axis = normalize(axis);
float span = abs(axis.x) + abs(axis.y);
float coord = dot(UV - vec2(0.5), axis) / span + 0.5;
// 扫描头在归一化坐标内循环,平滑阈值控制边缘。
float head = fract(TIME * scan_speed);
float distance_to_head = abs(coord - head);
float mask = 1.0 - smoothstep(
scan_width * 0.5,
scan_width * 0.5 + edge_softness,
distance_to_head
);
// 只混合可见颜色,保留原纹理的透明度。
float strength = mask * scan_color.a;
COLOR = vec4(mix(base.rgb, scan_color.rgb, strength), base.a);
}预期结果:运行场景后,青色水平亮带约每 2.5 秒从上向下扫过一次,然后回到起点;贴图主体仍然可见,原本透明的区域不会被填充。无需额外编写 GDScript。
调整方向、速度与阈值
scan_direction |
可见效果 |
|---|---|
(0, 1) |
水平亮带自上而下 |
(0, -1) |
水平亮带自下而上 |
(1, 0) |
垂直亮带自左向右 |
(-1, 0) |
垂直亮带自右向左 |
(1, 1) |
斜向亮带朝右下推进 |
scan_speed 表示每秒经过多少个完整的归一化扫描范围,并非像素速度;设为 0 可停止循环。scan_width 决定亮带的核心厚度,edge_softness 决定边缘过渡范围,scan_color 的 Alpha 控制叠色强度。先固定方向,再分别只调整一个参数,更容易看出其职责。
避免扫描线看不见或联动异常
若画面没有变化,先确认 Sprite2D 已指定纹理、ShaderMaterial 实际挂到该节点,并在运行场景而不是只检查静态图。过低的 scan_color Alpha 或过窄的 scan_width 会让亮带很难发现;可暂时把宽度调至 0.15,Alpha 调至 1。
宽度按 UV 投影的比例计算,横扫与竖扫在长方形纹理上的实际像素厚度可能不同。多个 Sprite2D 若共享同一个 ShaderMaterial,修改 uniform 会一起生效;需要分别调参时,先让每个实例使用独立的材质资源。