Web 图形与 3D / 系统课时
阴影贴图如何改善边缘质量
阴影贴图如何改善边缘质量
产品展示中的模型常出现锯齿阴影、表面条纹,或与地面脱开的“悬浮阴影”。这里用方向光、立方体和地面搭建可运行场景,再按阴影相机范围、贴图分辨率与深度偏移的顺序,把阴影调到清晰且贴合物体。
学习目标
- 正确配置
shadowMap、castShadow和receiveShadow,让模型投影到地面。 - 通过阴影相机范围和
mapSize改善边缘质量,并理解性能代价。 - 区分阴影锯齿、表面条纹与悬浮阴影,选择对应修复参数。
阴影边缘为何出现锯齿
方向光先从光源视角把遮挡物渲染为深度贴图;正式渲染地面时,再将地面像素投影到这张贴图中比较深度,决定是否处于阴影。这里同时涉及投影物、接收面、光源阴影相机与深度贴图,缺一环都可能导致没有阴影。

例如阴影相机水平覆盖 8 个世界单位,1024 像素宽对应约 8 / 1024 = 0.0078 单位/像素;若范围扩大到 40 单位而尺寸不变,每个像素覆盖约 0.039 单位,边缘精度下降约 5 倍。因此先收紧投影范围,再考虑增加分辨率。
生成可见的接地阴影
以下示例适用于 Three.js r185 的 WebGLRenderer。保存为 index.html,在文件所在目录运行 python3 -m http.server 8000,再打开 http://localhost:8000/;需可访问示例 CDN,且浏览器支持 WebGL 2。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<style>body { margin: 0; overflow: hidden; }</style>
</head>
<body>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.185.0/build/three.module.js';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf4f6f8);
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.1, 100);
camera.position.set(5, 4, 7);
camera.lookAt(0, 0.6, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
renderer.shadowMap.enabled = true;
renderer.shadowMap.type = THREE.PCFShadowMap;
document.body.appendChild(renderer.domElement);
scene.add(new THREE.AmbientLight(0xffffff, 0.4));
const sun = new THREE.DirectionalLight(0xffffff, 2.5);
sun.position.set(-3, 6, 4);
sun.castShadow = true;
sun.shadow.mapSize.set(1024, 1024); // 深度贴图的分辨率
Object.assign(sun.shadow.camera, {
left: -4, right: 4, top: 4, bottom: -4, near: 0.5, far: 15
});
sun.shadow.camera.updateProjectionMatrix();
sun.shadow.bias = -0.0002; // 微调深度比较,减轻阴影条纹
sun.shadow.normalBias = 0.02; // 沿法线偏移采样位置
scene.add(sun);
const box = new THREE.Mesh(
new THREE.BoxGeometry(1.5, 1.5, 1.5),
new THREE.MeshStandardMaterial({ color: 0x218ca8, roughness: 0.6 })
);
box.position.y = 0.75;
box.castShadow = true;
box.receiveShadow = true;
scene.add(box);
const ground = new THREE.Mesh(
new THREE.PlaneGeometry(10, 10),
new THREE.MeshStandardMaterial({ color: 0xd8dde3, roughness: 0.9 })
);
ground.rotation.x = -Math.PI / 2;
ground.receiveShadow = true; // 地面必须接收阴影
scene.add(ground);
function render() { renderer.render(scene, camera); }
window.addEventListener('resize', () => {
camera.aspect = innerWidth / innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(innerWidth, innerHeight);
render();
});
render();
</script>
</body>
</html>预期结果:页面显示蓝色立方体、灰色地面,以及沿光照反方向延伸的接地阴影。终端应提示 HTTP 服务监听 8000 端口,具体日志格式随 Python 版本而异;改变窗口尺寸,画面比例仍保持正常。antialias: true 处理画布中的几何边缘,不能代替阴影贴图分辨率。
优先调整投影范围和采样质量
- 先确认覆盖区域:本例正交阴影相机的
left/right/top/bottom均为±4,适合中心附近的产品与落影。把范围设成±20会让同一张贴图覆盖更多场景,阴影更容易呈现台阶。范围不能小到裁掉模型或落影。 - 再增加贴图尺寸:从
1024×1024测试到2048×2048,每个轴向采样密度翻倍,但贴图像素总数变为 4 倍,显存和渲染开销也可能明显增加。只有局部阴影仍有可见锯齿时才升级。 - 使用合适的过滤方式:本例使用
PCFShadowMap。从 Three.js r182 起,WebGLRenderer中的PCFSoftShadowMap已弃用,PCFShadowMap也提供软化过滤;不要照搬旧教程的枚举值。可对照 Three.js 迁移指南。
阴影相机的 near、far 也必须包含物体与可见落影;本例为 0.5 和 15。收紧深度范围有助于减少深度精度问题,但不能为了提高精度而截断阴影。
用症状定位偏移量问题
| 现象 | 优先检查 | 调整方向 |
|---|---|---|
| 完全没有投影 | renderer.shadowMap.enabled、光源与模型的 castShadow、地面 receiveShadow |
三处都开启,再确认光源照到模型 |
| 阴影被截断 | 阴影相机的左右上下、near/far |
扩大到刚好覆盖模型与落影 |
| 阴影边缘呈台阶 | mapSize 太小或阴影相机范围太宽 |
先缩范围,再从 1024 试到 2048 |
| 表面出现条纹或斑块 | 自阴影深度精度冲突(shadow acne) | 将 bias 以约 0.0001 的步长微调,或小幅增加 normalBias |
| 阴影与接触点分离 | bias 或 normalBias 偏移过大(peter-panning) |
将偏移量逐渐调回接近 0 |
这里 bias 作用于深度比较,normalBias 让采样点沿表面法线偏移;两者都不是越大越好。本例尺寸以 1 个世界单位约等于模型边长的三分之二为基准,换成大型建筑或毫米级模型时必须重新试值。
验证时先把 sun.shadow.mapSize.set(1024, 1024) 临时改为 sun.shadow.mapSize.set(256, 256) 并刷新,阴影边缘应更粗糙;恢复 1024 后再把 box.castShadow 改为 false,地面投影应消失。若仍有异常,可以在上述脚本首次调用 render() 前加入 scene.add(new THREE.CameraHelper(sun.shadow.camera))(片段示例,依赖已创建的 scene 与 sun),显示阴影相机覆盖框,定位完移除。清晰阴影来自合理的覆盖范围、足够的采样密度和小幅偏移修正,而不是单纯把贴图调到最大。