Web 图形与 3D / 系统课时

校准色彩空间与纹理显示

校准色彩空间与纹理显示

模型已经载入,却出现颜色发灰、金属发黑或表面忽亮忽暗时,先不要重做贴图。本篇用灰色贴图对照实验区分颜色与数据的处理方式,再给 PBR 材质建立统一的输出和环境光基准,逐项定位显示异常。

学习目标

  • 区分颜色贴图与粗糙度、金属度、法线等数据贴图的色彩空间。
  • 配置 Three.js 的输出色彩空间、色调映射和环境反射。
  • 通过对照实验和症状检查定位 GLB 材质显示问题。

贴图按用途标注

Three.js 的光照计算使用线性空间。来自 PNG、JPEG 的颜色通常按 sRGB 编码保存,采样时需要正确解码;粗糙度、法线和金属度存的是数值,不应该经过 sRGB 解码。对 MeshStandardMaterial 可以直接按下表核对:

贴图用途 材质属性 texture.colorSpace
基础色、发光色 map、emissiveMap THREE.SRGBColorSpace
粗糙度、金属度、法线、AO roughnessMap、metalnessMap、normalMap、aoMap THREE.NoColorSpace
浮点 EXR 环境光数据 envMap(经 PMREM 处理) 通常为 THREE.LinearSRGBColorSpace

glTF 常把 AO、粗糙度、金属度合并为 ORM 纹理:R 通道存 AO,G 存粗糙度,B 存金属度。Three.js 的粗糙度因子与贴图采样值相乘,例如 roughness=0.8、G 通道约为 0.5,最终粗糙度约为 0.4。误把 ORM 标为 sRGB,会改变这些数据值。

GLTFLoader 会按 glTF 材质用途自动标注文件内的纹理,不要遍历模型后把所有贴图强制改成 sRGB。若用 TextureLoader 另载贴图替换 GLB 的 map,再设置 colorSpace=THREE.SRGBColorSpace、flipY=false;替换 roughnessMap 时保持 NoColorSpace。

颜色贴图与非颜色数据贴图进入 Three.js 着色流程的不同路径

建立可复现的渲染基准

适用于 Three.js r152 及之后的 WebGLRenderer。输出给普通浏览器画布时使用 renderer.outputColorSpace = THREE.SRGBColorSpace(现代版本默认如此);旧教程里的 outputEncoding、sRGBEncoding 不要与新 API 混用。

色调映射与色彩空间不是同一件事:NoToneMapping 是默认值,能否使用 ACESFilmicToneMapping 取决于项目观感要求。排查时先固定为 ACES、曝光 1.0,避免一边调曝光一边修改贴图。若需要核对原始颜色,改用不受光照影响且关闭色调映射的 MeshBasicMaterial。

金属材质尤其依赖周围环境。只有直射光而没有环境反射时,高金属度表面可能大面积发黑。下面用 RoomEnvironment 生成 PMREM,作为可重复的测试环境;产品正式上线时再换成经确认的 HDR 环境图。

运行灰度对照实验

在已安装 Node.js 与 npm 的环境中新建 Vite 原生 JavaScript 项目,并安装同一版本的 Three.js 主包和 Addons:

bash
# 创建不依赖前端框架的测试项目
npm create vite@latest three-color-check -- --template vanilla
cd three-color-check
npm install
npm install three
# 启动服务后,可通过热更新查看代码修改效果
npm run dev

预期结果:终端出现本地开发地址,例如:

text
Local: http://localhost:<PORT>/

<PORT> 是实际分配的端口,可能与示例不同。将 src/main.js 完整替换为以下内容,无需额外图片文件:

js
import * as THREE from 'three';
import { RoomEnvironment } from 'three/addons/environments/RoomEnvironment.js';

const scene = new THREE.Scene();
scene.background = new THREE.Color(0x202631);
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.1, 100);
camera.position.set(0, 0, 5);

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
renderer.outputColorSpace = THREE.SRGBColorSpace;
renderer.toneMapping = THREE.ACESFilmicToneMapping;
renderer.toneMappingExposure = 1;
document.body.style.margin = '0';
document.body.replaceChildren(renderer.domElement);

// PMREM 为高金属度的 PBR 球体提供可观察的反射。
const room = new RoomEnvironment();
const pmrem = new THREE.PMREMGenerator(renderer);
const target = pmrem.fromScene(room);
scene.environment = target.texture;
room.dispose();
pmrem.dispose();

const canvas = document.createElement('canvas');
canvas.width = canvas.height = 4;
const ctx = canvas.getContext('2d');
ctx.fillStyle = '#808080';
ctx.fillRect(0, 0, 4, 4);
const correct = new THREE.CanvasTexture(canvas);
correct.colorSpace = THREE.SRGBColorSpace;
const incorrect = new THREE.CanvasTexture(canvas);

// 上方左右两块板关闭光照和色调映射,只比较颜色解码。
for (const [texture, x] of [[correct, -0.8], [incorrect, 0.8]]) {
  const material = new THREE.MeshBasicMaterial({ map: texture, toneMapped: false });
  const panel = new THREE.Mesh(new THREE.PlaneGeometry(1.35, 1.35), material);
  panel.position.set(x, 0.9, 0);
  scene.add(panel);
}

// G 通道为 128/255,粗糙度因子 1 会得到约 0.50。
const roughnessMap = new THREE.DataTexture(new Uint8Array([0, 128, 0, 255]), 1, 1);
roughnessMap.needsUpdate = true;
const sphere = new THREE.Mesh(
  new THREE.SphereGeometry(0.73, 48, 32),
  new THREE.MeshStandardMaterial({
    color: 0xbecbd8, metalness: 0.8, roughness: 1, roughnessMap
  })
);
sphere.position.y = -0.85;
scene.add(sphere);

console.log('color sRGB:', correct.colorSpace === THREE.SRGBColorSpace);
console.log('roughness data:', roughnessMap.colorSpace === THREE.NoColorSpace);
console.log('output sRGB:', renderer.outputColorSpace === THREE.SRGBColorSpace);
renderer.render(scene, camera);

预期输出(浏览器开发者工具 Console):

text
color sRGB: true
roughness data: true
output sRGB: true

画面上方左侧应为接近 #808080 的灰色,右侧相同像素因误当线性数值而显得更亮;下方球体应出现可辨认的环境反射。灰色面板使用 toneMapped: false,因此亮度差不是 ACES 或灯光造成的。

按症状定位 GLB 问题

依次保持模型、相机、渲染器配置不变,只改变一个因素,再截图比较:

  1. 整体偏亮或泛灰:检查基础色贴图是否被当成 NoColorSpace,以及是否在自定义 Shader 中额外做了一次 sRGB 编码。先用上述灰板确认输入、输出链路。
  2. 模型过暗、金属发黑:先在材质上临时设 metalness=0 区分金属反射问题;再恢复原值并提供 scene.environment。不要只靠提高 toneMappingExposure 掩盖缺失的环境光。
  3. 反射过于锐利或粗糙度不一致:检查 roughnessMap 是否仍是 NoColorSpace,确认使用 G 通道,且 roughness 因子不是意外的 0.2。数据贴图被错标为 sRGB 时,采样值会被非线性改变。
  4. 纹理上下颠倒或出现接缝:如果问题只发生在手动替换的 glTF 贴图,检查 flipY=false 及 UV 集合。它属于纹理坐标问题,不应靠调整色调映射修复。

最后恢复模型的真实贴图,在相同曝光 1.0、相同环境和相机角度下复测。若只有某一张 GLB 异常,再检查源文件的 ORM 通道打包、材质系数和贴图实际像素,而不是全局提高亮度。

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

目录与阅读设置

阅读设置

17

记录一个想法

校准色彩空间与纹理显示

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

登录哪都通