用途:为 Three.js 构建稳定且可扩展的方向光阴影系统,适合大型程序化世界、城市场景、地形以及相机持续移动的 WebGPU/TSL 阴影场景。仅在接收区域确实有界时使用单一阴影贴图;大范围移动视图应将阴影覆盖做成显式的空间层级。
主要能力(缓存 clipmap 工作流):定义同心光空间方形层级;把每层中心吸附到各自的纹素网格;在着色器空间对相邻层做交叉淡入淡出;持续刷新近处层级;按帧预算缓存粗层级并更新;当重要投影物或流式地形变化时,使相交层级失效;按世界空间纹素宽度缩放 normal bias。需要实现大世界方向光前,先阅读 references/cached-clipmap-shadows.md;缓存阴影 clipmap 提供三个光空间方形层级,包含逐层纹素吸附、包含关系交叉淡入、粗层级缓存更新、缩放偏置以及未阴影外部权重。
使用方式:按资料所述流程组织层级与更新,命令或参考文件路径保持原样。资料未提供安装命令与具体代码示例。
限制与失败条件:投影中心按纹素分数移动;着色器包含关系与贴图已提交中心不一致;无证据地每帧刷新所有级联;粗层级无限冻结移动投影物;深度纹理采样出现在分支片段控制流中;在纹素尺寸差异很大时仍使用同一 normal bias;相机运动下层级边界变得可见。
路由边界:本技能用于光空间方向光阴影贴图;视角相关的环境可见性请用 $threejs-screen-space-ambient-occlusion,环境光遮蔽不能替代投影阴影。