light3d
A 3D light placed and aimed by the node. kind is directional, point or spot; the first light3d in a scene retires the engine's default key light.
On this page
3d · render · 9 properties · 3D
A 3D light placed and aimed by the node. kind is directional, point or spot; the first light3d in a scene retires the engine's default key light.
In a scene, light3d is the node key that applies it. A script reaches each property below as a field on node.light3d: reading one asks the running component, and assigning one leaves the rest alone. The whole table is node.light3d.get() and node.light3d.set(table).
Properties
| property | type | default | description |
|---|---|---|---|
color |
color | [1,1,1,1] |
Light colour, as channel floats or #rrggbb / #rrggbbaa |
inner_angle_degrees |
float | 20 |
Half-angle of a spot light's full-brightness cone, in degrees Range 0–179. |
intensity |
float | 3 |
Brightness multiplier; over 1 blows past white At least 0. |
kind |
enum | directional |
A point light fades to nothing at range, a directional one lights the whole scene, a spot one throws a cone the node aims One of directional, point, spot. |
light_layers |
flags | [] |
The light layers this light reaches: a node whose light_layers share one; empty is every layer One of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32. |
outer_angle_degrees |
float | 35 |
Half-angle a spot light fades to nothing at, in degrees Range 0–179. |
range |
float | 30 |
How far a point or spot light reaches, in world units At least 0. |
shadow_enabled |
bool | true |
Whether this light casts shadows from the nodes that say they cast |
source_radius |
float | 0 |
Radius of the sphere the light shines from, in world units, which softens its shadows. Read by the path tracer only; the rasterizer's edge is environment.shadow_softness At least 0. |