OptionalcastWhether this source casts a shadow map. Omitted preserves legacy output.
What this light would cast, not what the frame renders: a scene's environment.shadows.enabled is the master switch and turning it off renders no shadow map for any light, which is also how the render budget prices it. A scene declaring no environment leaves the decision to the host renderer, exactly as it did before environments existed.
Only the three punctual kinds can cast one. A rectangular area source is analytically integrated rather than rasterized from a light-space camera, so three.js renders no shadow map for it and the engine refuses castShadow on an IAutoMovieAreaLight instead of accepting a flag no frame would honor.
Light color (linear).
Half-angle of the cone in degrees, (0, 90].
Stable id.
Finite nonnegative photometric magnitude: illuminance in lux for directional, luminous intensity in candela for point/spot and luminance in nits (candela per square metre) for an area panel. Three's rectangular-area power convention is luminous flux in lumens equal to intensity times width times height times PI.
Range in meters beyond which the light contributes nothing. 0 = infinite.
OptionalshadowDeterministic shadow-camera tuning, required exactly when castShadow is true.
World placement. For directional light only the orientation matters.
Light motion supports position for point/spot/area and rotation for directional/spot/area, through /lights/<id>/position and /lights/<id>/rotation. Other supported axes are intensity, RGB colour, point/spot range and spot cone angle. Scale, identity, shadow settings and area dimensions have no light pointer channel; the viewer still applies the authored TRS to its native light object.
Discriminator.
Aimed punctual source with finite-position falloff and a declared emission cone.