Web 图形与 3D / 系统课时

控制阴影贴图尺寸和刷新

控制阴影贴图尺寸和刷新

本课把方向光阴影限制在需要投影的区域,用合适的贴图分辨率维持清晰度,并让静态阴影只在物体或光源变化时重绘。完成后,你可以直接比较自动刷新与按需刷新带来的绘制调用差异。

学习目标

  • 识别阴影深度绘制与主场景绘制的额外成本。
  • 使用 mapSize 和阴影相机边界调整阴影精度。
  • 用 autoUpdate、needsUpdate 控制刷新并验证调用数。

阴影为什么增加绘制

开启 renderer.shadowMap.enabled、光源的 castShadow 和物体的 castShadow 后,Three.js 先从光源视角绘制阴影深度贴图,再从主相机绘制可见场景。地面通常只需 receiveShadow = true,不必投射自己的阴影。

一个普通方向光或聚光灯通常使用一个阴影视图;点光源需要处理立方体贴图的六个方向。假设有 20 个独立投影网格都进入某方向光的阴影相机,理论上约多出 20 次阴影绘制调用;实际还受剔除、材质分组和实例化影响。阴影视图数量不等于绘制调用数量。

收紧分辨率与投影范围

方向光的阴影相机是正交相机。mapSize 决定阴影纹理的像素数,left/right/top/bottom 决定这些像素覆盖多大的世界范围。优先收紧有效投影区域,再考虑增大分辨率。

设置 示例值 影响
shadow.mapSize 1024 × 1024 相比 512 × 512,像素数增至 4 倍
阴影相机左右边界 -6 / 6 水平覆盖 12 个世界单位
阴影相机上下边界 6 / -6 垂直覆盖 12 个世界单位
near / far 0.5 / 25 限制光源视角的深度范围
normalBias 0.02 缓解部分表面阴影痤疮;须按场景尺度调节

水平覆盖 12 单位、贴图宽 1024 时,每个阴影像素约对应 12 / 1024 ≈ 0.0117 个世界单位;若扩大到 24 单位而分辨率不变,则约为 0.0234,阴影细节更粗。2048 × 2048 相比 1024 × 1024 又会产生 4 倍像素量,但 GPU 耗时不一定恰好翻四倍。

方向光阴影相机范围与贴图像素密度

阴影边界必须包含投影物体及其落影所需区域,否则会出现被截断的阴影。调试时可临时加入 new THREE.CameraHelper(sun.shadow.camera) 查看范围,统计绘制调用前应移除辅助线。贴图尺寸还须不超过 renderer.capabilities.maxTextureSize;最好在第一次渲染前设定,运行中改尺寸需要另行处理已有阴影渲染目标。

实现自动与按需刷新切换

以下示例使用 Three.js r185(npm 包 0.185.0)与 WebGLRenderer。先创建一个 Vite 原生 JavaScript 项目;需要满足当前 Vite 对 Node.js 的版本要求。

bash
npm create vite@latest shadow-lab -- --template vanilla
cd shadow-lab
npm install
npm install three@0.185.0
npm run dev

预期结果:终端显示类似 Local: http://localhost:<PORT>/ 的开发地址;<PORT> 是动态端口。保留服务运行,把 src/main.js 完整替换为下列代码,浏览器会自动更新。

js
import * as THREE from 'three';

document.body.style.margin = '0';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
renderer.shadowMap.enabled = true;
renderer.shadowMap.type = THREE.PCFShadowMap;
renderer.info.autoReset = false;
document.body.appendChild(renderer.domElement);

const scene = new THREE.Scene();
scene.background = new THREE.Color(0xeaf0f3);
const camera = new THREE.PerspectiveCamera(50, innerWidth / innerHeight, 0.1, 100);
camera.position.set(7, 6, 10);
camera.lookAt(0, 0, 0);

const sun = new THREE.DirectionalLight(0xffffff, 3);
sun.position.set(5, 8, 4);
sun.castShadow = true;
sun.shadow.mapSize.set(1024, 1024);
Object.assign(sun.shadow.camera, {
  left: -6, right: 6, top: 6, bottom: -6, near: 0.5, far: 25
});
sun.shadow.camera.updateProjectionMatrix();
sun.shadow.normalBias = 0.02;
scene.add(sun, sun.target, new THREE.AmbientLight(0xffffff, 0.6));

const floor = new THREE.Mesh(
  new THREE.PlaneGeometry(16, 16),
  new THREE.MeshStandardMaterial({ color: 0xd7e4e1 })
);
floor.rotation.x = -Math.PI / 2;
floor.receiveShadow = true;
scene.add(floor);

const box = new THREE.Mesh(
  new THREE.BoxGeometry(2, 2, 2),
  new THREE.MeshStandardMaterial({ color: 0x198779 })
);
box.position.y = 1;
box.castShadow = true;
scene.add(box);

// 首帧构建阴影贴图,其余帧默认复用缓存。
let automatic = false;
sun.shadow.autoUpdate = false;
sun.shadow.needsUpdate = true;

const panel = document.createElement('div');
panel.style.cssText = 'position:fixed;top:12px;left:12px;padding:10px;background:white;color:#203040;font:14px sans-serif';
document.body.appendChild(panel);

window.addEventListener('keydown', (event) => {
  const key = event.key.toLowerCase();
  if (key === 'a') {
    automatic = !automatic;
    sun.shadow.autoUpdate = automatic;
  }
  if (key === 'm') {
    box.position.x = box.position.x === 0 ? 2 : 0;
    sun.shadow.needsUpdate = true; // 投影物体位移后刷新阴影
  }
});

window.addEventListener('resize', () => {
  camera.aspect = innerWidth / innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(innerWidth, innerHeight);
});

function frame() {
  renderer.info.reset(); // 同一帧累计阴影绘制与主场景绘制
  renderer.render(scene, camera);
  panel.textContent = `A 切换模式:${automatic ? '自动' : '按需'} | M 移动物体 | draw calls: ${renderer.info.render.calls}`;
  requestAnimationFrame(frame);
}
frame();

预期结果:页面显示绿色立方体、地面及其投影。左上角默认显示“按需”;按 A 切换自动刷新,按 M 移动立方体并触发一次阴影重绘。这里持续渲染主场景,是为了比较两种阴影策略,不代表静态页面必须每帧渲染。

自动刷新与按需刷新阴影贴图的时序

核对绘制次数与失效条件

在这个只有一个投影立方体、两个可见网格的示例中,renderer.info.render.calls 预计出现如下计数。r185 的 WebGLRenderer 统计包含阴影绘制;旧版的计数重置行为可能不同,因此比较前需固定版本。

操作 阴影贴图本帧重绘 预期 draw calls
首次显示 是 3
按需模式保持静止 否 2
按 M 移动后的那帧 是 3
按 A 切到自动模式 每帧 3

如果阴影不更新,检查是否在首次渲染前设置了 needsUpdate = true;投影物体、光源位置、光源目标或阴影相机范围改变后,也要标记失效。只移动主观察相机通常不需要重绘固定方向光的阴影图;但跟随相机移动的阴影相机、级联阴影等策略需要另行判断。若阴影缺失,先核对 castShadow、receiveShadow 和阴影相机范围,不要直接把分辨率提高到 4096。

对于静态展厅、建筑模型等场景,优先保留较小的阴影投影范围和按需刷新;持续变形、移动的投影物体则不能长期复用旧图。参数接口可参阅 Three.js LightShadow 文档。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制阴影贴图尺寸和刷新

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

登录哪都通