Spherical Lights
Cocos Creator 3.x's spherical light is similar to v2.x's point light.
Spherical light spreads light evenly in all directions, similar to the light produced by a candle. The intensity of light on an object decreases as the distance from the light increases, and is zero when the distance exceeds the set light effect range.
In practical applications, it can be used to simulate lights such as torches, candles, and light bulbs to illuminate the surrounding environment within a certain distance.
The light location and color, as well as its illumination range can be clearly seen in the editor, as shown in the image below. The light range of the spherical light can be adjusted by modifying the Range property of the spherical light component in the Inspector panel.
Adding spherical lights to the scene can be done as described in Adding Lights.
For the spherical light component interface, please refer to SphereLight API.
Sphere Light Properties
| Property | Description |
|---|---|
| Color | Sets the light color. |
| UseColorTemperature | Whether to enable the color temperature. |
| ColorTemperature | Adjusts the color temperature. |
| Size | Sets the light size. |
| Range | Sets the range of light effect. |
| Term | Sets the type of light intensity unit, including LUMINOUS_POWER and LUMINANCE. |
| LuminousPower | Luminous flux in lumens (lm). Effective when Term is set to LUMINOUS_POWER. |
| Luminance | Brightness in Candela per square meter (cd/m2). Effective when Term is set to LUMINANCE. |
| StaticSettings | Static lighting settings, please refer to Lightmapping. |
Note: currently, the
Sizeproperty of the spherical light does not take effect in actual operation, as well as the display of shadows is not supported for now, we will optimize it in subsequent versions, please pay attention to the update announcement.