Spotlights

A Spotlight is a cone-shaped beam of light emitted from a point in one direction, similar to the light produced by a flashlight or stage lighting. Compared to other lights, spotlights have an additional SpotAngle property, which is used to adjust the light range of the spotlight.

spotlight

In the editor, one can clearly see the position, color and light range of the light as well as its spot angle, as shown in the following image. With the Transform Gizmos in the upper left corner of the editor, it is possible to adjust the position and direction of the spotlight.

spotlight

See Adding Lights for how to add spotlights to a scene.

For the Spotlight component interface, please refer to SpotLight API.

Spotlight Properties

image

PropertyDescription
ColorSets the color of the light.
UseColorTemperatureWhether to enable the color temperature.
ColorTemperatureAdjusts the color temperature.
SizeSets the light size.
RangeSets the range of light effect.
SpotAngleAdjusts the spot angle to control the light range.
TermSets the light intensity unit type, including LUMINOUS_POWER and LUMINANCE.
LuminousPowerLuminous flux in lumens (lm).
Effective when Term is set to LUMINOUS_POWER.
LuminanceBrightness in Candela per square meter (cd/m2).
Effective when Term is set to LUMINANCE.
StaticSettingsStatic lighting settings, please refer to the Lightmapping documentation.