THREE.js配置shadowMap等参数后阴影无法正常生效的问题
THREE.js 阴影失效核心问题定位
具体配置错误
- 点光源阴影相机配置逻辑错误
点光源生成阴影时依托6面立方体透视相机实现,不存在正交相机专属的cameraLeft/cameraRight/cameraTop/cameraBottom属性,代码中对这些字段的赋值属于无效操作,无法对阴影范围产生实际影响。
点光源阴影相机的默认近裁剪面为0.5,而当前场景内所有物体距离光源的距离最远不超过1米,近裁剪面距离远大于物体实际位置,导致所有物体都被排除在阴影深度图的采集范围外,完全无法生成阴影。 - 阴影相机参数与实际场景尺寸严重失配
代码中设置的阴影覆盖范围参数d=200、远裁剪面far=1000,但整个场景所有物体的坐标跨度仅不到2米。超大的覆盖范围会让场景内的微小物体在深度图中仅占不足1个像素,无法被识别为可投射阴影的实体。 - 阴影投射属性遗漏
仅对场景中单独放置的小方块设置了castShadow = true,group组内的圆柱、多个二十面体、立方体等所有位于光源下方的实体,均未开启castShadow属性,本身不具备投射阴影的能力。 - 补充说明:代码中使用
THREE.BasicShadowMap是适配入门学习的合理配置,不存在错误,无需修改。
对应修正方案
- 移除所有对
light.shadow.cameraLeft/cameraRight/cameraTop/cameraBottom的无效赋值 - 调整点光源阴影相机的裁剪参数,适配实际场景尺寸:
light.shadow.camera.near = 0.01; // 降低近裁剪面,捕捉近距物体 light.shadow.camera.far = 3; // 远裁剪面覆盖整个场景范围即可 - 统一为所有需要投射阴影的网格对象开启属性,可通过遍历组内对象批量设置,避免遗漏:
group.traverse((obj) => { if (obj.isMesh) { obj.castShadow = true; } }) - 可保留
CameraHelper用于调试阴影相机范围,调整参数后即可看到和实际场景尺寸匹配的辅助框,用于确认阴影覆盖范围是否正确。
内容的提问来源于stack exchange,提问作者mroman
相关产品推荐
相关产品推荐

