游戏引擎 / 系统课时
用 vertex 改造 2D 网格形状
用 vertex 改造 2D 网格形状
让 Sprite2D 顶部摆动、整体像呼吸一样起伏,不必改贴图。Godot 4 的 CanvasItem Shader 能在 vertex() 阶段移动绘制顶点。本课实现摆动与呼吸,并解释四顶点 Sprite 为何无法做出平滑波浪。
学习目标
- 理解
VERTEX、UV与节点变换在 2D 顶点阶段的分工。 - 使用
TIME实现顶端摆动和整体呼吸变形。 - 判断什么时候必须增加网格顶点,以及哪些系统不会随 Shader 变形更新。
顶点阶段修改的究竟是什么
vertex() 处理的是绘制网格中的每个顶点,不是逐个纹理像素。在默认的 canvas_item Shader 中,可读写的 VERTEX 是相对于节点原点的局部像素位置,UV 表示该顶点对应的贴图坐标。修改 VERTEX.x 可以让网格向局部 X 方向偏移;引擎随后再应用节点和画布变换。
fragment() 负责已绘制图元内部的颜色与采样。仅改变纹理采样的 UV 能让图案看起来扭曲,却不能让原本笔直的几何外轮廓产生真正的弯曲;要改变轮廓,需要移动顶点。
实现顶部摆动和整体呼吸
为一个默认居中、带纹理的 Sprite2D 新建 ShaderMaterial 和 Shader,使用以下完整代码。这里让顶部的横向位移最大,底部不受横向摆动项影响;呼吸则围绕 Sprite 的局部原点进行。
shader_type canvas_item;
uniform float sway_pixels : hint_range(0.0, 30.0) = 10.0;
uniform float breathing : hint_range(0.0, 0.15) = 0.04;
uniform float speed : hint_range(0.1, 6.0) = 2.0;
void vertex() {
// UV.y 越靠近顶部,横向摆动权重越大。
float upper_weight = 1.0 - UV.y;
float sway = sin(TIME * speed) * sway_pixels;
VERTEX.x += upper_weight * sway;
// 居中 Sprite 的局部原点作为呼吸缩放中心。
float factor = 1.0 + breathing * sin(TIME * speed);
VERTEX *= factor;
}预期结果:运行场景后,Sprite 顶边沿自身局部 X 方向周期性移动,底部不会受到横向摆动项影响;整张 Sprite 同时围绕中心产生约 ±4% 的缩放。把 sway_pixels 设为 0 可单独观察呼吸,把 breathing 设为 0 则只保留摆动。无需编写 fragment(),原贴图仍会正常绘制。
为什么四个顶点做不出柔顺波浪
普通 Sprite2D 的矩形绘制通常只有四个角顶点,由两个三角形构成。即使给位移加入 sin(TIME * speed + UV.y * 10.0),着色器也只在现有顶点求值;两个顶点之间的直线边不会自动长出多个弯曲波峰。四顶点模型适合平移、斜切、拉伸或轻微摆动,却不适合复杂轮廓波浪。
要让波纹沿高度连续传播,需要使用带有更多顶点和三角形、且 UV 分布合理的二维网格。此时可将摆动改为 sin(TIME * speed + UV.y * 10.0) * 8.0 这样的位移项;这是替换主示例中摆动计算的片段思路,前提是网格已经沿 Y 方向细分,而不是简单给四顶点 Sprite 换一个公式。

验证形变边界
测试时先让 Sprite2D 旋转 90°:由于示例偏移的是局部 VERTEX.x,摆动方向会跟着节点旋转,而不是始终朝屏幕右侧。再逐步调大 sway_pixels,检查附近的裁剪容器和可见区域是否截掉变形后的边缘。
选择方案时先看目标:轻微摆动和呼吸用四顶点 Sprite 就足够;要改轮廓、做多段波浪,就准备细分网格;只想让纹理里的颜色或花纹流动,则考虑在 fragment() 阶段处理 UV,无需为每个视觉扰动增加几何密度。