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。

图像像素坐标、平面 UV 与纹理贴图方向的对应关系

用 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。

html
<!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 增加四分之一纹理宽度

对于原始 u=0.4u=0.4,本例变换后 u′=2u+0.25=1.05u'=2u+0.25=1.05,重复寻址得到的采样位置相当于 u=0.05u=0.05。正的 offset.x 增加采样坐标,视觉上图案通常向左移动,不要将它当成移动网格本身。

用过滤参数控制远近清晰度

放大图片时,magFilter 决定如何在少量纹素间插值;缩小图片时,minFilter 决定如何避免闪烁和锯齿。普通产品表面贴图可先保留 LinearFilter 与 LinearMipmapLinearFilter,后者使用多级渐远纹理。需要像素风格时,可把 magFilter 改成 NearestFilter 并重新加载页面,放大后将看到明显的方格边界。

颜色图片用于 material.map 时设置 texture.colorSpace = THREE.SRGBColorSpace;粗糙度、法线等非颜色数据贴图不要套用 sRGB 标记。过滤影响采样观感,但不会修复 UV 布局引起的几何拉伸。

按症状检查纹理异常

  1. 方向颠倒:先用四象限图确认是整张图上下反转,还是模型 UV 本身倒置。自制几何体常用默认 flipY = true;给 GLTFLoader 导入的 glTF 材质手动补贴图时,通常应将新贴图设为 flipY = false。
  2. 不能重复:同时检查 repeat 是否大于 1,以及对应轴的 wrapS、wrapT 是否使用重复模式;仅修改 repeat 不够。
  3. 图案被拉宽:检查表面长宽比与纹理图案比例。例如 4:2 的平面套用正方形标志,默认完整 UV 会让标志横向拉宽;应改用匹配宽高比的图片、调整 UV 或更改平铺布局。
  4. 近处模糊或远处闪烁:先检查 magFilter、minFilter;斜视角的地面纹理可再尝试 texture.anisotropy = renderer.capabilities.getMaxAnisotropy(),以设备支持值为上限。

如果在首次渲染之后才改动 wrapS、wrapT 或过滤参数,记得设置 texture.needsUpdate = true;单纯调整 repeat 和 offset 通常会自动更新 UV 变换矩阵。修复时先确认方向,再确认取样边界,最后处理图片比例与过滤,能避免把 UV 问题误判为材质或灯光问题。参数定义可对照 Three.js Texture 官方文档。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

UV 坐标如何决定纹理位置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通