用途:面向 Three.js 场景的灯光与阴影配置参考,适用于添加光源、设置阴影、搭建 IBL 环境光照或优化灯光性能时查阅。
主要能力:说明各类光源(AmbientLight、HemisphereLight、DirectionalLight、PointLight、SpotLight、RectAreaLight)的构造参数与特性,并标注阴影支持与开销:环境光均匀无方向;半球光提供天空到地面渐变;平行光模拟太阳、有阴影;点光全向发光;聚光灯为锥形并支持角度与边缘柔和度;矩形区域光适合柔和真实照明,但仅适用于 MeshStandardMaterial 与 MeshPhysicalMaterial,原生不投影。
使用方式:文档给出各光源的代码片段,例如 new THREE.AmbientLight(0xffffff, 0.5)、new THREE.DirectionalLight(0xffffff, 1) 与位置设置。阴影需在渲染器开启 renderer.shadowMap.enabled = true 并选择类型,再对光源设置 castShadow、对物体设置 castShadow 与 receiveShadow。文档还包含阴影相机的近远裁剪与范围配置、bias 与 normalBias 修复阴影痤疮、阴影贴图尺寸权衡。RectAreaLight 需先调用 RectAreaLightUniformsLib.init()。IBL 部分介绍用 RGBELoader 加载 HDR、设置 scene.environment,或经 PMREMGenerator 生成环境贴图,也支持 CubeTextureLoader 与 LightProbe。
适用场景:提供三点布光、户外日光、室内影棚等示例组合,以及灯光动画(时钟驱动位置、强度与颜色)示例,另附各光源与阴影辅助对象。
限制:矩形区域光阴影需自定义方案;性能建议限制光源数量、使用烘焙光照、缩小阴影贴图与阴影相机范围、按需关闭阴影,并可用图层排除不受光对象。文档未提供具体性能数据、兼容性版本或收费信息。