游戏引擎 / 系统课时
为什么一张贴图里的 UV 总在 0 到 1
为什么一张贴图里的 UV 总在 0 到 1
一张贴图可以是 64×64,也可以是 1024×512;若直接用像素编号描述颜色位置,换图就得重算坐标。本课在 Godot 4 的 Sprite2D 上把 UV 显示成颜色,再把它换算为像素位置,理解为什么多数 2D Shader 用 0~1 的比例坐标控制效果。
学习目标
- 解释
UV.x、UV.y的方向和归一化含义。 - 区分贴图 UV、纹理像素坐标与屏幕 UV。
- 在
Sprite2D上运行 Shader,并验证贴图尺寸变化后的表现。
UV 是比例位置,不是像素编号
在完整映射一张纹理的常见 Sprite2D 中,Shader 内置的 UV 是 vec2:UV.x 从左侧的 0 增至右侧的 1,UV.y 从顶部的 0 增至底部的 1。(0.5, 0.5) 表示贴图中央,与节点在场景中的坐标无关。
贴图若为 256×128,UV 的连续像素位置可按 UV * vec2(256.0, 128.0) 计算。于是 (0.25, 0.75) 对应 (64, 96);若改成 512×256,同一个 UV 对应 (128, 192)。比例不变,像素距离却变了。
将 UV 看成整个矩形的相对位置,能直接画出坐标与像素之间的关系:

贴图的右、下边界可以标成 UV 为 1,但它们不是一个额外的像素编号。以宽 256 的纹理为例,最后一列像素的中心横坐标为 255.5,对应的 U 值是 255.5 / 256.0,而不是 1。
把 UV 显示成红绿渐变
创建一个 Sprite2D,赋予一张不透明的白色纹理;在节点的 Material 属性中新建 ShaderMaterial,再为其 Shader 新建 CanvasItem Shader,替换内容为以下完整代码:
shader_type canvas_item;
void fragment() {
// 用红色表示水平比例,用绿色表示垂直比例。
// 保留原纹理和节点调制后的透明度。
COLOR = vec4(UV.x, UV.y, 0.0, COLOR.a);
}预期结果:左上角接近黑色,右上角偏红,左下角偏绿,右下角偏黄;中心约为 (0.5, 0.5, 0.0) 对应的暗黄色。颜色由当前位置的 UV 决定,而不是由屏幕上的像素坐标决定。
观察时可把 Sprite2D 的缩放调大:画面占用更多屏幕像素,但从左到右、从上到下的颜色变化顺序不会改变。若纹理包含透明区域,代码保留 COLOR.a,透明位置仍不可见;为了观察完整矩形,先使用不透明白图。
UV 与像素位置怎样互换
Godot 4 的 CanvasItem Shader 提供 TEXTURE_PIXEL_SIZE,它表示一个纹理像素在 UV 空间中的大小。对于 256×128 的贴图,其值是 vec2(1.0 / 256.0, 1.0 / 128.0);因此 UV / TEXTURE_PIXEL_SIZE 得到按像素尺度表达的连续位置。
需要按固定像素宽度画边框或棋盘格时,应先换算到像素尺度;需要让渐变始终覆盖贴图宽度的 30% 时,直接用 UV 更方便。像素索引是离散整数,UV 是连续采样坐标,不要把二者等同。
另一个常见混淆是 SCREEN_UV。它相对于当前视口归一化,而 UV 通常相对于对象使用的纹理映射。移动一个 Sprite2D 时,物体上的 UV 渐变随物体移动;基于 SCREEN_UV 的图案则按屏幕位置计算。
记住 0~1 的适用边界
“UV 总在 0~1”是完整贴图默认映射下的直觉,不是所有 Shader 的硬限制。使用纹理图集、裁切区域、重复平铺或在顶点阶段主动修改 UV 时,当前绘制区域的 UV 范围或采样值可能不同。
验证方法是先运行上述可视化 Shader,再替换纹理、修改 Sprite2D 缩放,观察四角颜色;如果四角不再覆盖完整红绿范围,就检查资源映射和 UV 是否被改写。以后做遮罩、渐变与纹理采样时,先确认“这个 UV 是相对谁的”,比死记坐标范围更可靠。