游戏引擎 / 系统课时
UV 方向反了怎么判断坐标链路
UV 方向反了怎么判断坐标链路
当水波、扫光或溶解效果出现上下颠倒、左右镜像或移动错位时,不要立刻修改贴图。先用颜色把实际采样坐标显示出来,再区分纹理 UV、节点变换与屏幕坐标,就能定位究竟是哪一层改变了方向。
学习目标
- 使用红绿渐变检查 UV 的 X、Y 方向,并验证翻转是否有效。
- 分辨
UV、节点变换和SCREEN_UV的作用,按症状修复错位。
用渐变直接测试坐标
在 Godot 4 中创建 Sprite2D,指定一张不透明矩形纹理,为它配置 ShaderMaterial,再把下面的 CanvasItem Shader 粘贴进去。暂时不采样原贴图,而让红色表示横坐标、绿色表示纵坐标。
shader_type canvas_item;
uniform int debug_mode : hint_range(0, 2, 1) = 0;
void fragment() {
// 0:纹理 UV;1:翻转 UV 的 Y;2:使用屏幕坐标
vec2 p = debug_mode == 2 ? SCREEN_UV : UV;
if (debug_mode == 1) {
p.y = 1.0 - p.y;
}
COLOR = vec4(p.x, p.y, 0.0, 1.0);
}预期结果:普通未翻转精灵在 debug_mode = 0 时,左上角接近黑色、右上偏红、左下偏绿、右下偏黄。设为 1 后,绿色的上下方向反转;设为 2 后,渐变依赖片元在视口中的位置,移动精灵会改变它显示的颜色范围。此测试会临时覆盖原纹理颜色和透明度。
区分 UV 与屏幕位置
UV 是附在几何顶点上的纹理坐标;Sprite2D 的位置、旋转和缩放主要改变几何体投影到屏幕的位置,并不会自动把 UV 改写成屏幕坐标。因此,沿 UV.x 移动的亮带通常会跟着精灵旋转,而沿 SCREEN_UV.x 计算的亮带保持屏幕方向。

图集与局部区域也是常见陷阱:启用 Sprite2D 的 Region 后,UV 可能指向整张贴图中的子区域,并不一定从 (0, 0) 走到 (1, 1)。不要在未确认坐标范围之前,直接套用 1.0 - UV.y 修正所有效果。
根据症状逐层定位
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
| 上下渐变反了 | UV.y、flip_v 和贴图朝向 |
确认来源后再做 Y 翻转 |
| 左右流动反了 | UV.x、flip_h、滚动速度符号 |
只改错误的轴或方向 |
| 精灵旋转时亮带也转 | 效果使用 UV 还是 SCREEN_UV |
随物体走用 UV,固定屏幕方向用 SCREEN_UV |
| 精灵移动后纹理像在滑动 | 是否用屏幕 UV 采样局部贴图 | 改为对应贴图的 UV |
| 图集里只有部分帧错位 | Region、Atlas 与 UV 范围 | 先换算正确的子区域采样范围 |
一次只调整一个变量:先把 flip_h、flip_v 关闭并暂时取消旋转,再对比 debug_mode 的三个结果。确认渐变本身正确后,逐个恢复翻转、旋转、图集裁切,记录首次出现异常的步骤。
恢复效果并验证
定位到问题后,移除诊断用的纯色输出,恢复原 Shader 的纹理采样和透明度逻辑。若确实需要反转纵向采样,只在相应的局部纹理坐标上使用 1.0 - y;屏幕级扭曲应继续用正确的 SCREEN_UV。
最后分别验证精灵旋转、镜像、移动以及 Camera2D 缩放时的方向。判断标准不是“画面看起来正了”,而是效果与其预期参照系一致:贴在角色身上的纹理随角色走,固定在屏幕上的效果不随角色的局部变换漂移。