球面光

Cocos Creator 3.x 的球面光与 v2.x 的点光源(Point Light)类似。

球面光会向所有方向均匀地发散光线,接近于蜡烛产生的光线。物体受到的光照强度会随着跟光源距离的增大而减弱,当距离超过设置的光照影响范围,则光照强度为 0。

在实际应用中可用于模拟火把、蜡烛、灯泡等光源,照亮四周一定距离内的环境。

sphere-light-edit

在编辑器中可以直观地看到光源位置、颜色,以及它的照射范围,如下图所示。通过修改 属性检查器 中球面光组件的 Range 属性即可调整球面光的光照范围。

sphere-light-edit

在场景中添加球面光的方式可参考 添加光源

球面光组件接口请参考 SphereLight API

球面光属性

image

属性说明
Color设置光源颜色
UseColorTemperature是否启用色温
ColorTemperature调节色温
Size设置光源大小
Range设置光照影响范围
Term设置光照强度单位的类型,包括 光通量(LUMINOUS_POWER)和 亮度(LUMINANCE) 两种
LuminousPower光通量,单位 流明(lm)
Term 设置为 LUMINOUS_POWER 时生效
Luminance亮度,单位 坎德拉每平方米(cd/m2
Term 设置为 LUMINANCE 时生效
StaticSettings静态灯光设置,详情请参考 光照贴图

注意:目前球面光的 Size 属性在实际运行中不生效,以及暂不支持显示阴影,我们会在后续版本进行优化,请关注版本更新公告。