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 的版本要求。
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 完整替换为下列代码,浏览器会自动更新。
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 文档。