A Spotlight is a type of Light3D node that emits lights in a specific direction, in the shape of a cone. The light is attenuated through the distance. This attenuation can be configured by changing the energy, radius and attenuation parameters of Light3D.
The spotlight's angle in degrees.
Note: spot_angle is not affected by Node3D.scale (the light's scale or its parent's scale).
The spotlight's angular attenuation curve. See also spot_attenuation.
Controls the distance attenuation function for spotlights.
A value of 0.0
will maintain a constant brightness through most of the range, but smoothly attenuate the light at the edge of the range. Use a value of 2.0
for physically accurate lights as it results in the proper inverse square attenutation.
Note: Setting attenuation to 2.0
or higher may result in distant objects receiving minimal light, even within range. For example, with a range of 4096
, an object at 100
units is attenuated by a factor of 0.0001
. With a default brightness of 1
, the light would not be visible at that distance.
Note: Using negative or values higher than 10.0
may lead to unexpected results.
The maximal range that can be reached by the spotlight. Note that the effectively lit area may appear to be smaller depending on the spot_attenuation in use. No matter the spot_attenuation in use, the light will never reach anything outside this range.
Note: spot_range is not affected by Node3D.scale (the light's scale or its parent's scale).