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

Note: currently, the Size property 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.