纹理与颜色空间

使用 TextureLoader 加载图片纹理,理解 UV、颜色贴图、法线贴图、重复方式和颜色空间设置。

🎯 引言

学完这篇文章,你能把图片贴到几何体表面,理解 UV 如何决定图片位置,认识颜色、法线、粗糙度和金属度贴图,并避免颜色发灰或发暗的问题。

🧱 TextureLoader 和 map

纹理是 GPU 使用的一张图片或像素数据。TextureLoader 负责加载图片,材质的 map 负责把它当作颜色贴图使用:

import * as THREE from 'three';

const texture = new THREE.TextureLoader().load(
    '/textures/wood-color.jpg',
    () => console.log('纹理加载完成'),
    (event) => console.log(`已加载 ${event.loaded} 字节`),
    (error) => console.error('纹理加载失败', error)
);
texture.colorSpace = THREE.SRGBColorSpace;

const material = new THREE.MeshStandardMaterial({ map: texture });

map 不是纹理文件本身,而是材质上“使用哪张图片作为基础颜色”的属性;colorSpace 告诉 Three.js 这张图片里的数字应该怎样还原成人眼看到的颜色。两者缺一个,纹理可能已经加载成功,但画面仍然不正确。

在网页项目中,可以把图片放在静态资源目录,并使用浏览器可访问的 URL 加载,例如 /textures/wood-color.jpg。图片资源必须能被当前页面访问,部署到其他域名时还要确认服务器允许跨域加载;如果使用打包工具,也可以改用它提供的资源导入方式。

🧭 UV、重复与过滤

几何体上的 UV 是一组 0 到 1 的二维坐标:左下角通常接近 (0, 0),右上角接近 (1, 1)。内置几何体已经准备了 UV,自定义 BufferGeometry 时要自己提供。

需要重复图案时,可以配置纹理的包裹方式和重复次数。wrapS 表示水平方向,wrapT 表示垂直方向;默认的 ClampToEdgeWrapping 会拉伸边缘像素,只有改成 RepeatWrapping 后,repeat 才会真正平铺:

texture.wrapS = THREE.RepeatWrapping;
texture.wrapT = THREE.RepeatWrapping;
texture.repeat.set(3, 2);

上面的配置会让图片沿水平方向重复 3 次、垂直方向重复 2 次,适合地面、墙面等需要连续图案的表面。

放大图片时,magFilter 影响放大后的平滑程度;缩小时,Three.js 默认会使用 mipmap 帮助保持稳定。纹理尺寸、压缩方式和重复次数都应该结合实际设备验证。

mipmap 是提前生成的一组更小尺寸图片,物体缩远时可以使用合适尺寸的版本,减少纹理闪烁和采样压力。它不是另一张业务图片,而是 GPU 为缩小显示准备的辅助版本。

🎨 常见贴图和颜色空间

const material = new THREE.MeshStandardMaterial({
    map: colorTexture,
    normalMap,
    roughnessMap,
    metalnessMap,
});
  • 颜色贴图决定表面颜色,应设置 colorSpace = THREE.SRGBColorSpace。
  • 法线贴图用颜色记录微小凹凸,不会真正改变几何轮廓。
  • 粗糙度贴图控制不同位置的高光扩散程度。
  • 金属度贴图控制不同位置的金属属性。

颜色贴图和普通数据贴图的处理方式不同。渲染器通常还要设置:

renderer.outputColorSpace = THREE.SRGBColorSpace;

如果颜色贴图忘记标记 sRGB,结果可能发灰;把法线、粗糙度等数据贴图错误地当成 sRGB,也会让光照计算失真。

这里可以把 sRGB 理解为面向显示器和图片文件的颜色编码,把线性空间理解为适合光照计算的数值空间:颜色贴图输入通常是 sRGB,法线、粗糙度和金属度是计算数据,不能按颜色图片处理。

下面的演示使用一张程序生成的图案,展示纹理重复和贴图后的表面效果:

文档中的贴图路径必须对应真实文件。加载失败时,先检查 public 目录、大小写、文件名和部署后的静态资源路径。

🧾 小节总结

  • TextureLoader 加载图片,材质的 map 使用颜色纹理。
  • UV 决定二维图片如何映射到三维表面。
  • RepeatWrapping 和 repeat 用于平铺图案。
  • 颜色、法线、粗糙度和金属度贴图承担不同职责。
  • 颜色贴图使用 sRGB,数据贴图保持线性数据处理。

❓ 知识问答

Q1:为什么纹理加载成功但物体没有图片?

确认材质使用了 map,场景中使用的是这个材质,并且物体的几何体有 UV attribute。

Q2:为什么重复设置后只有边缘拉伸?

需要先设置 wrapS 和 wrapT 为 RepeatWrapping,默认的包裹方式不会重复。

Q3:法线贴图会让模型轮廓变复杂吗?

不会。它只改变光照计算的表面方向,模型轮廓仍由几何体顶点决定。

🧪 小练习

在一个平面上加载一张图片,将重复次数设置为 4 × 4,再分别修改 magFilter 和 minFilter 对比缩放效果。

// 请在这里编写代码

🎉 纹理让简单几何体拥有了丰富细节。下一篇学习如何用场景树管理一组有关联的对象。