diff --git a/crates/bevy_pbr/src/light.rs b/crates/bevy_pbr/src/light.rs index 1f08147411d3f..4befa56fff767 100644 --- a/crates/bevy_pbr/src/light.rs +++ b/crates/bevy_pbr/src/light.rs @@ -41,7 +41,7 @@ use crate::*; #[reflect(Component, Default)] pub struct PointLight { pub color: Color, - /// Luminous power in lumens + /// Luminous power in lumens, representing the amount of light emitted by this source in all directions. pub intensity: f32, pub range: f32, pub radius: f32, @@ -92,7 +92,7 @@ impl Default for PointLightShadowMap { #[reflect(Component, Default)] pub struct SpotLight { pub color: Color, - /// Luminous power in lumens + /// Luminous power in lumens, representing the amount of light emitted by this source in all directions. pub intensity: f32, pub range: f32, pub radius: f32, @@ -188,7 +188,12 @@ impl Default for SpotLight { #[reflect(Component, Default)] pub struct DirectionalLight { pub color: Color, - /// Illuminance in lux + /// Illuminance in lux (lumens per square meter), representing the amount of + /// light projected onto surfaces by this light source. Lux is used here + /// instead of lumens because a directional light illuminates all surfaces + /// more-or-less the same way (depending on the angle of incidence). Lumens + /// can only be specified for light sources which emit light from a specific + /// area. pub illuminance: f32, pub shadows_enabled: bool, pub shadow_depth_bias: f32,