游戏引擎 / 系统课时

做一个可调方向的扫描线效果

做一个可调方向的扫描线效果

本节让 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。最后比较像素坐标与移动扫描头的距离,距离越近,亮带越明显。

UV 投影方向与扫描亮带宽度示意

挂载材质并编写 Shader

在 Godot 4 中创建 Sprite2D,指定一张有透明轮廓的纹理,将其 Material 设为 ShaderMaterial,再新建 Shader 并写入以下完整代码。示例假设节点的 Modulate 为白色,以便观察原始贴图和叠色效果。

glsl
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 会一起生效;需要分别调参时,先让每个实例使用独立的材质资源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

做一个可调方向的扫描线效果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通