Web 图形与 3D / 系统课时

HDR 环境贴图如何影响反射

HDR 环境贴图如何影响反射

把一张 HDR 全景图接入 Three.js 后,金属表面会映出环境中的亮窗与灯带,粗糙表面则得到更宽、更柔和的高光。本课搭建三球对照场景,固定相机与曝光,只改变环境光强度,辨认 HDR、粗糙度和金属度各自造成的视觉差异。

学习目标

  • 用 RGBELoader 加载 .hdr 文件并设置场景环境贴图。
  • 区分 scene.environment、scene.background 与材质环境强度的作用。
  • 通过三组球体和键盘切换验证反射亮度、清晰度与金属度的关系。

HDR 怎样参与材质反射

HDR(高动态范围)全景图储存的亮度范围通常超过普通 JPG。摄影棚里的明亮柔光箱会在低粗糙度金属表面形成清楚的亮带;同一处光源在高粗糙度表面上被扩散成宽而模糊的光斑。非金属材质也能接收环境漫反射和较弱的镜面反射,但不会像金属那样呈现强烈的有色反射。

渲染器会把等距柱状 HDR 环境图转换为适合不同粗糙度采样的预过滤环境数据(PMREM)。Three.js r179 的 WebGLRenderer 已自动处理这一步;直接设置 scene.environment 即可,无须手动重复创建 PMREMGenerator。

同一 HDR 下环境强度与材质粗糙度的反射对比

scene.environment 给场景中的 PBR 材质提供光照与反射;scene.background 只控制可见的背景,可以不设置。scene.environmentIntensity 调整场景环境贡献,material.envMapIntensity 则对某一个材质额外缩放环境贡献。比较时必须保持 renderer.toneMappingExposure 不变,否则无法判断亮度差来自哪里。

准备独立运行的工程

使用 Node.js 22.12 或更新版本,在终端创建 Vite 原生 JavaScript 项目;锁定 Three.js 0.179.1,因为从 r180 开始 RGBELoader 改名为 HDRLoader,不能用旧的导入路径套在新版本上。

bash
npm create vite@latest hdr-ibl-demo -- --template vanilla
cd hdr-ibl-demo
npm install
npm install three@0.179.1

预期结果:生成含 index.html 和 src/main.js 的项目目录,安装命令正常结束,three 被安装为 0.179.1。

从 Poly Haven 的 Studio Small 09 下载 1K / HDR 版本(CC0 资源),把文件放在项目的 public 目录中,重命名为 studio.hdr。开发服务器会把它作为 /studio.hdr 提供;不要从 src 目录拼接磁盘绝对路径。

加载贴图并构建三球对照

用下列代码完整替换 src/main.js。三个球体使用同一个 HDR:左侧光滑金属(metalness=1、roughness=0.08),中间粗糙金属(1、0.65),右侧光滑非金属(0、0.12)。保留少量环境之外的补光,便于观察非金属球的轮廓。

js
import * as THREE from 'three';
import { RGBELoader } from 'three/addons/loaders/RGBELoader.js';

document.body.style.margin = '0';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x1a2230);
const camera = new THREE.PerspectiveCamera(
  45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(0, 0, 8);

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
renderer.toneMapping = THREE.ACESFilmicToneMapping;
renderer.toneMappingExposure = 1;
document.body.appendChild(renderer.domElement);

// 保持几何、相机和曝光不变,只改变材质参数。
const geometry = new THREE.SphereGeometry(0.9, 64, 32);
const samples = [
  { x: -2.2, metalness: 1, roughness: 0.08 },
  { x: 0, metalness: 1, roughness: 0.65 },
  { x: 2.2, metalness: 0, roughness: 0.12 }
];
for (const sample of samples) {
  const material = new THREE.MeshStandardMaterial({
    color: 0xbfc9d2,
    metalness: sample.metalness,
    roughness: sample.roughness,
    envMapIntensity: 1
  });
  const sphere = new THREE.Mesh(geometry, material);
  sphere.position.x = sample.x;
  scene.add(sphere);
}
scene.add(new THREE.AmbientLight(0xffffff, 0.15));

const label = document.createElement('div');
label.style.cssText =
  'position:fixed;left:16px;top:16px;color:white;' +
  'font:16px sans-serif;background:#263344cc;padding:10px';
document.body.appendChild(label);

function draw() {
  renderer.render(scene, camera);
}
function setLevel(value) {
  scene.environmentIntensity = value;
  label.textContent = `按 1/2/3 切换环境强度:${value}`;
  draw();
}
window.addEventListener('keydown', (event) => {
  const levels = { Digit1: 0, Digit2: 0.7, Digit3: 1.8 };
  if (Object.hasOwn(levels, event.code)) setLevel(levels[event.code]);
});

// 等 HDR 成功解析后再把它交给场景环境和背景。
new RGBELoader().load(
  '/studio.hdr',
  (hdr) => {
    hdr.mapping = THREE.EquirectangularReflectionMapping;
    scene.environment = hdr;
    scene.background = hdr;
    scene.backgroundIntensity = 0.6; // 背景亮度与反射强度分开控制
    scene.backgroundBlurriness = 0.35;
    setLevel(0.7);
  },
  undefined,
  (error) => {
    console.error('HDR 加载失败', error);
    label.textContent = 'HDR 加载失败:检查 public/studio.hdr';
  }
);
window.addEventListener('resize', () => {
  camera.aspect = window.innerWidth / window.innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(window.innerWidth, window.innerHeight);
  draw();
});
draw();

预期结果:页面出现三个球和模糊的摄影棚背景。左球反射亮带清晰,中球亮带更宽更柔,右球以材质本色和较弱高光为主。按 1、2、3 后显示的环境强度依次为 0、0.7、1.8;金属球在 0 时会明显变暗。HDR 文件较大时,首次显示会有短暂延迟。

启动与验证强度变化

bash
npm run dev

预期输出(版本、耗时和端口随环境变化):

text
VITE v<VERSION>  ready in <TIME> ms
Local: http://localhost:<PORT>/

在浏览器打开终端给出的实际地址,固定相机和曝光,依次按 1、2、3,确认明暗变化不等于反射模糊程度变化:

比较项 固定设置 应观察的变化
全局环境强度 0 → 0.7 → 1.8 金属反射从接近消失到明显增强;高光形状基本不变
粗糙度 左 0.08、中 0.65 左侧亮带清楚,中间亮带扩散,即使强度相同也不一样
金属度 左 1、右 0 金属更依赖反射形成外观;非金属保留漫反射主色

若只想压低一个产品零件的环境反射,把该零件的 material.envMapIntensity 从 1 改为 0.4;不要直接降低整个场景的 environmentIntensity,否则其他材质也会一起改变。若只是背景过亮,改 scene.backgroundIntensity,而不是改变 PBR 光照强度。

反射异常时按顺序排查

  1. 没有反射且报 404:在浏览器开发者工具的 Network 面板检查 /studio.hdr 的响应,确认资源真实位于 public/studio.hdr。若返回 HTML 而不是 HDR 数据,检查文件路径和开发服务器配置。
  2. 加载成功但金属发黑:确认 scene.environment 已赋值,环境强度不是 0,材质是 MeshStandardMaterial 或 MeshPhysicalMaterial;纯金属在没有有效环境照明时本来就可能很暗。
  3. 画面过曝、亮带一片白:先保持 roughness 不变,将 scene.environmentIntensity 从 1.8 降到 0.7,再视需要微调固定的 renderer.toneMappingExposure。不要同时更改多个变量。
  4. 复制示例后导入失败:先执行 npm ls three 确认安装的是 0.179.1。如果项目使用 r180 及之后版本,需将导入与构造器统一改为 HDRLoader,不能只改其中一处。

HDR 贴图既提供光源的亮度分布,也提供物体可反射的空间图案;环境强度负责放大或缩小这份贡献,粗糙度决定反射有多锐利,金属度决定材质如何分配镜面与漫反射。做产品对比图时,应先固定 HDR、曝光与镜头,再逐项调整材质参数。

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

目录与阅读设置

阅读设置

17

记录一个想法

HDR 环境贴图如何影响反射

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

登录哪都通