Struct LightSource 

#[non_exhaustive]
pub struct LightSource {
    pub kind: LightKind,
    pub colour: [f32; 3],
    pub intensity: f32,
    pub importance: f32,
    pub cast_shadows: bool,
}

A single light source with colour and intensity.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

kind: LightKind

The type and geometric parameters of this light.

colour: [f32; 3]

RGB light colour in linear 0..1. Default [1.0, 1.0, 1.0].

intensity: f32

Intensity multiplier. Default 1.0.

importance: f32

Importance hint used by the renderer when more lights are pushed than fit under the per-frame cap. Higher values are kept; lower values are dropped first. Default 1.0.

The renderer ranks lights by importance * proximity_weight where proximity_weight scales the contribution of points and spots by distance to the active camera. Directional lights are treated as infinitely close (proximity_weight = 1).

cast_shadows: bool

When true, this light contributes to shadow casting.

Directional lights cast cascaded shadows into the shared atlas (only the first directional light is treated as the CSM caster). Point lights with cast_shadows = true acquire a slot in the cubemap shadow pool, up to MAX_POINT_SHADOW_LIGHTS active casters. Spot lights cast a single-face perspective shadow.

Default: true. Disable per-light to skip the shadow render work.

Trait Implementations

impl Clone for LightSource

fn clone(&self) -> LightSource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LightSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LightSource

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LightSource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LightSource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.