游戏引擎 / 系统课时
采样纹理时该用哪种坐标
采样纹理时该用哪种坐标
给 Sprite2D 编写采样效果时,常见错误是把像素距离直接加到 UV 上,导致纹理偏移过大或边缘异常。本课通过一次双影采样实验,区分 UV、纹理像素尺寸和屏幕坐标,学会按照实际纹理像素精确移动采样位置。
学习目标
- 理解
texture(TEXTURE, UV)的采样过程和返回值。 - 掌握 UV 与纹理像素坐标的换算关系。
- 使用
TEXTURE_PIXEL_SIZE实现与纹理分辨率匹配的采样偏移。
先分清三种坐标
在 Godot 4 的 CanvasItem Shader 中,texture() 用于读取纹理。最常见的写法是 texture(TEXTURE, UV),其中 TEXTURE 是 Sprite2D 当前使用的默认纹理,UV 是采样位置。
texture() 返回 vec4,分别包含红、绿、蓝和透明度四个分量。采样位置并不直接使用图片的像素编号,而是使用归一化纹理坐标。
对于普通、未启用 Region 的 Sprite2D,UV 的主要对应关系是:
- 左上角约为
(0.0, 0.0)。 - 右上角约为
(1.0, 0.0)。 - 左下角约为
(0.0, 1.0)。 - 中心位置约为
(0.5, 0.5)。
假设纹理宽 256 像素、高 128 像素,那么 UV 中心对应的纹理位置约为 (128, 64),而不是屏幕中的 (128, 64)。

这三类坐标不能随意混用:
| 坐标或变量 | 参照范围 | 主要用途 |
|---|---|---|
UV |
当前纹理映射区域 | 读取 Sprite 纹理 |
TEXTURE_PIXEL_SIZE |
一个纹理像素的归一化尺寸 | 计算邻近像素偏移 |
SCREEN_UV |
整个视口 | 屏幕空间采样与后处理 |
特别要注意,SCREEN_UV 虽然也通常处于 0~1 范围,但它描述的是当前片元在屏幕中的位置,不能直接代替 Sprite 的纹理 UV。
把像素距离换算成 UV 偏移
假设一张纹理的尺寸为 256×128,那么一个纹理像素在 UV 空间中的尺寸为:
- 水平方向:
1.0 / 256.0。 - 垂直方向:
1.0 / 128.0。
因此,向右偏移两个纹理像素,不是直接对 UV.x 加 2.0,而是加 2.0 / 256.0。
Godot 已经提供了内置变量 TEXTURE_PIXEL_SIZE,无需自己硬编码纹理宽高。对于上述纹理,该变量等价于 vec2(1.0 / 256.0, 1.0 / 128.0)。
只要将希望偏移的像素数量乘以 TEXTURE_PIXEL_SIZE,就能得到对应的 UV 偏移量。这种写法可以适配不同分辨率的纹理,也适合后续制作模糊、描边、轮廓检测和邻域采样效果。
注意,这里计算的是原始纹理像素距离,而不是屏幕像素距离。即使放大 Sprite2D,TEXTURE_PIXEL_SIZE 也不会因为节点缩放而改变。
运行双影采样实验
准备一个 Godot 4 项目,在场景中添加 Sprite2D,为它指定带有清晰图案的 PNG 纹理。建议使用不对称图案,例如文字、箭头或人物头像,这样更容易观察偏移方向。
接着,为 Sprite2D 创建 ShaderMaterial,并创建一个 Shader 资源,将下面的代码保存为 texture_offset.gdshader:
shader_type canvas_item;
uniform float horizontal_shift_px : hint_range(0.0, 8.0, 1.0) = 2.0;
varying vec4 sprite_tint;
void vertex() {
// 保留 Sprite2D 的顶点颜色与节点调制颜色
sprite_tint = COLOR;
}
void fragment() {
// 将纹理像素数量转换为 UV 偏移
vec2 delta_uv = vec2(horizontal_shift_px, 0.0) * TEXTURE_PIXEL_SIZE;
vec2 shifted_uv = clamp(UV + delta_uv, vec2(0.0), vec2(1.0));
vec4 original = texture(TEXTURE, UV);
vec4 shifted = texture(TEXTURE, shifted_uv);
// 混合原始采样和偏移采样,便于观察差异
COLOR = mix(original, shifted, 0.5) * sprite_tint;
}预期结果:Sprite2D 显示两个略微错开的纹理图案,形成轻微双影。默认偏移量为两个纹理像素,由于采样位置向右移动,偏移采样形成的图案在画面中表现为向左错开。
可以在 ShaderMaterial 的参数中调整 horizontal_shift_px,观察以下现象:
- 设置为
0.0:两次采样位置相同,图像恢复正常。 - 设置为
2.0:出现较轻的双影。 - 设置为
8.0:两个图案明显错开。
代码使用 clamp() 将采样坐标限制在 0~1 范围内,避免直接访问范围外的 UV。但这也意味着靠近边界的位置可能出现颜色延伸,而不是自动变为透明。
这里使用 varying 保存了顶点阶段的颜色,再与最终采样结果相乘,目的是保留 Sprite2D 的调制颜色。否则,直接把 texture() 的返回值赋给 COLOR,可能绕过原本的节点颜色调制。
处理滤波与边界问题
同样的采样代码,在不同纹理设置下可能显示出不同效果。最常见的区别来自纹理过滤方式。
| 过滤方式 | 采样表现 | 适用场景 |
|---|---|---|
| Nearest | 选择邻近纹理像素,边缘清晰 | 像素风格游戏 |
| Linear | 对周围像素插值,过渡平滑 | 普通精灵与平滑视觉效果 |
例如,偏移量为半个纹理像素时,Linear 过滤可能产生中间颜色,而 Nearest 通常会保持某个像素的颜色。这并不是 UV 计算错误,而是采样过滤规则不同。
还需要关注三个边界条件:
- UV 越界:纹理重复模式会影响范围外采样,可能出现边缘颜色延伸或纹理重复。
- 透明边缘:透明像素附近使用线性过滤时,可能产生半透明的过渡颜色;制作像素级轮廓时需要检查透明边距。
- 图集区域:Sprite2D 使用 Region 或纹理图集时,需要确认实际 UV 映射、区域边界以及是否会采样到相邻图块。
对于普通 Sprite2D 的局部采样,优先使用 UV 定位、TEXTURE_PIXEL_SIZE 计算偏移,并根据需要处理越界。只有确实要处理整个视口时,才应该考虑 SCREEN_UV 等屏幕空间变量。
掌握这个区分后,向周围采样一个纹理像素就不再依赖手工填写图片尺寸,也能为后续基于透明度的边缘检测提供稳定的坐标基础。