You need to enable JavaScript to run this app. THREE.js配置shadowMap等参数后阴影无法正常生效的问题
优惠活动
大模型
产品
解决方案
定价
更多

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是适配入门学习的合理配置,不存在错误,无需修改。

对应修正方案

  1. 移除所有对light.shadow.cameraLeft/cameraRight/cameraTop/cameraBottom的无效赋值
  2. 调整点光源阴影相机的裁剪参数,适配实际场景尺寸:
    light.shadow.camera.near = 0.01; // 降低近裁剪面,捕捉近距物体
    light.shadow.camera.far = 3; // 远裁剪面覆盖整个场景范围即可
    
  3. 统一为所有需要投射阴影的网格对象开启属性,可通过遍历组内对象批量设置,避免遗漏:
    group.traverse((obj) => {
      if (obj.isMesh) {
        obj.castShadow = true;
      }
    })
    
  4. 可保留CameraHelper用于调试阴影相机范围,调整参数后即可看到和实际场景尺寸匹配的辅助框,用于确认阴影覆盖范围是否正确。

内容的提问来源于stack exchange,提问作者mroman

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 03:15:07