Web 图形与 3D / 系统课时
UV 坐标如何决定纹理位置
UV 坐标如何决定纹理位置
当一张图片贴到 Three.js 网格上时,图案倒置、重复方向不对或被拉长,往往不是图片本身的问题。本篇用两块平面比较默认贴图与重复偏移效果,再用 UV 坐标、采样参数和检查步骤定位原因。
学习目标
- 读懂网格顶点的 UV 坐标与图片像素坐标的对应关系。
- 使用
TextureLoader加载纹理并调整wrapS、wrapT、repeat和offset。 - 根据放大、缩小、翻转或拉伸现象选择正确的修复方法。
从图片像素到网格 UV
UV 是网格上的二维采样坐标,与顶点的三维位置互相独立。U 表示横向,V 表示纵向;常见平面的左下角为 (0, 0),右上角为 (1, 1)。默认 PlaneGeometry 已生成 uv 顶点属性,材质通过这个属性决定每个位置读取哪一部分图片。
常见 PNG、Canvas 的像素原点在左上角,纵向向下;UV 图通常以左下角为原点,V 向上。TextureLoader 创建的纹理默认 flipY = true,上传时处理两者的方向差异。不要只因为图片像素的 Y 轴朝下就手动把 flipY 改成 false。

用 TextureLoader 对比默认与重复贴图
示例适用于 Three.js 0.186.1,只依赖网络加载库,不依赖外部图片素材。用 Canvas 生成一张四象限 PNG,再通过 TextureLoader.loadAsync() 读取其 Data URL。将下面代码保存为 index.html;在该目录运行 python3 -m http.server 8000(Windows 可用 py -m http.server 8000),打开 http://localhost:8000。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Three.js UV 贴图检查</title>
<style>
body { margin: 24px; font: 16px sans-serif; background: #f5f7fa; }
canvas { max-width: 100%; height: auto; }
</style>
</head>
<body>
<p>左:默认 UV 右:U 重复 2 次、偏移 0.25</p>
<div id="stage"></div>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.186.1/build/three.module.js';
// 自制方向测试图,避免外部图片路径影响实验。
const source = document.createElement('canvas');
source.width = source.height = 256;
const ctx = source.getContext('2d');
const blocks = [
[0, 0, '#ef7970', '左上'],
[128, 0, '#87c7a4', '右上'],
[0, 128, '#7fb0e8', '左下'],
[128, 128, '#f4d178', '右下']
];
ctx.font = 'bold 21px sans-serif';
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
for (const [x, y, color, label] of blocks) {
ctx.fillStyle = color;
ctx.fillRect(x, y, 128, 128);
ctx.fillStyle = '#263445';
ctx.fillText(label, x + 64, y + 64);
}
const loader = new THREE.TextureLoader();
// 分别加载,防止修改一块平面的贴图参数影响另一块。
const dataUrl = source.toDataURL('image/png');
const [plain, tiled] = await Promise.all([
loader.loadAsync(dataUrl), loader.loadAsync(dataUrl)
]);
for (const texture of [plain, tiled]) {
texture.colorSpace = THREE.SRGBColorSpace;
texture.magFilter = THREE.LinearFilter;
texture.minFilter = THREE.LinearMipmapLinearFilter;
}
// 允许超出 0~1 的 U 坐标循环取样。
tiled.wrapS = THREE.RepeatWrapping;
tiled.wrapT = THREE.RepeatWrapping;
tiled.repeat.set(2, 1);
tiled.offset.set(0.25, 0);
tiled.needsUpdate = true;
const scene = new THREE.Scene();
scene.background = new THREE.Color('#f5f7fa');
const camera = new THREE.PerspectiveCamera(45, 2, 0.1, 100);
camera.position.z = 7;
const geometry = new THREE.PlaneGeometry(2.8, 2.8);
// 检查 UV 时不引入光照影响;PBR 材质也使用相同的 map。
const left = new THREE.Mesh(geometry, new THREE.MeshBasicMaterial({ map: plain }));
const right = new THREE.Mesh(geometry, new THREE.MeshBasicMaterial({ map: tiled }));
left.position.x = -1.6;
right.position.x = 1.6;
scene.add(left, right);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(900, 450);
document.querySelector('#stage').appendChild(renderer.domElement);
renderer.render(scene, camera);
</script>
</body>
</html>预期结果:页面出现左右两块方形平面。左侧保留红、绿、蓝、黄四象限的原始方位;右侧图案沿水平方向出现两轮重复,纹理起点发生偏移。若控制台报加载错误,应先检查网络是否能访问示例中的 Three.js 模块地址。
理解平铺和偏移的取样规则
wrapS 控制 U 越界的处理方式,wrapT 控制 V;默认均为 ClampToEdgeWrapping,超出边界时延用边缘像素。只有设置为 RepeatWrapping 或 MirroredRepeatWrapping,大于 1 的 repeat 才能按预期平铺。
| 参数 | 本例右侧值 | 实际效果 |
|---|---|---|
wrapS |
RepeatWrapping |
U 越界时回到另一侧 |
wrapT |
RepeatWrapping |
V 越界时也允许平铺 |
repeat |
(2, 1) |
横向两次、纵向一次 |
offset |
(0.25, 0) |
取样起点沿 U 增加四分之一纹理宽度 |
对于原始 ,本例变换后 ,重复寻址得到的采样位置相当于 。正的 offset.x 增加采样坐标,视觉上图案通常向左移动,不要将它当成移动网格本身。
用过滤参数控制远近清晰度
放大图片时,magFilter 决定如何在少量纹素间插值;缩小图片时,minFilter 决定如何避免闪烁和锯齿。普通产品表面贴图可先保留 LinearFilter 与 LinearMipmapLinearFilter,后者使用多级渐远纹理。需要像素风格时,可把 magFilter 改成 NearestFilter 并重新加载页面,放大后将看到明显的方格边界。
颜色图片用于 material.map 时设置 texture.colorSpace = THREE.SRGBColorSpace;粗糙度、法线等非颜色数据贴图不要套用 sRGB 标记。过滤影响采样观感,但不会修复 UV 布局引起的几何拉伸。
按症状检查纹理异常
- 方向颠倒:先用四象限图确认是整张图上下反转,还是模型 UV 本身倒置。自制几何体常用默认
flipY = true;给GLTFLoader导入的 glTF 材质手动补贴图时,通常应将新贴图设为flipY = false。 - 不能重复:同时检查
repeat是否大于 1,以及对应轴的wrapS、wrapT是否使用重复模式;仅修改repeat不够。 - 图案被拉宽:检查表面长宽比与纹理图案比例。例如 4:2 的平面套用正方形标志,默认完整 UV 会让标志横向拉宽;应改用匹配宽高比的图片、调整 UV 或更改平铺布局。
- 近处模糊或远处闪烁:先检查
magFilter、minFilter;斜视角的地面纹理可再尝试texture.anisotropy = renderer.capabilities.getMaxAnisotropy(),以设备支持值为上限。
如果在首次渲染之后才改动 wrapS、wrapT 或过滤参数,记得设置 texture.needsUpdate = true;单纯调整 repeat 和 offset 通常会自动更新 UV 变换矩阵。修复时先确认方向,再确认取样边界,最后处理图片比例与过滤,能避免把 UV 问题误判为材质或灯光问题。参数定义可对照 Three.js Texture 官方文档。