Struct LightManager 

pub struct LightManager {
    pub ambient_color: Color,
    pub ambient_intensity: f32,
    /* private fields */
}

Manages up to 64 simultaneous lights with spatial grid queries.

Fields

ambient_color: Color

Ambient light applied everywhere.

ambient_intensity: f32

Implementations

impl LightManager

pub fn new() -> Self

pub fn with_grid_cell_size(self, size: f32) -> Self

pub fn add(&mut self, light: Light) -> Option<LightId>

Add a light, returning its ID. Returns None if at max capacity.

pub fn add_point(&mut self, light: PointLight) -> Option<LightId>

Add a point light.

pub fn add_spot(&mut self, light: SpotLight) -> Option<LightId>

Add a spot light.

pub fn add_directional(&mut self, light: DirectionalLight) -> Option<LightId>

Add a directional light.

pub fn add_area(&mut self, light: AreaLight) -> Option<LightId>

Add an area light.

pub fn add_emissive(&mut self, light: EmissiveGlyph) -> Option<LightId>

Add an emissive glyph light.

pub fn add_animated(&mut self, light: AnimatedLight) -> Option<LightId>

Add an animated light.

pub fn add_ies(&mut self, light: IESProfile) -> Option<LightId>

Add an IES profile light.

pub fn remove(&mut self, id: LightId) -> Option<Light>

Remove a light by ID.

pub fn get(&self, id: LightId) -> Option<&Light>

Get a reference to a light by ID.

pub fn get_mut(&mut self, id: LightId) -> Option<&mut Light>

Get a mutable reference to a light by ID.

pub fn update(&mut self, dt: f32)

Update all time-varying lights.

pub fn rebuild_grid(&mut self)

Force a rebuild of the spatial grid.

pub fn lights_at(&mut self, pos: Vec3) -> Vec<LightId>

Query which lights affect a given world position.

pub fn lights_in_aabb(&mut self, min: Vec3, max: Vec3) -> Vec<LightId>

Query which lights affect a given AABB.

pub fn irradiance_at(&mut self, point: Vec3, normal: Vec3) -> Color

Compute total irradiance at a world position from all affecting lights.

pub fn active_count(&self) -> usize

Get the number of active lights.

pub fn total_count(&self) -> usize

Get the total number of lights (active + disabled).

pub fn iter(&self) -> impl Iterator<Item = (&LightId, &Light)>

Iterate over all lights.

pub fn ids(&self) -> impl Iterator<Item = &LightId>

Iterate over all light IDs.

pub fn clear(&mut self)

Remove all lights.

pub fn most_important_lights( &mut self, point: Vec3, normal: Vec3, count: usize, ) -> Vec<LightId>

Get the N most important lights for a given point (sorted by contribution).

pub fn set_enabled(&mut self, id: LightId, enabled: bool)

Enable or disable a light.

pub fn set_position(&mut self, id: LightId, position: Vec3)

Set the position of a positional light.

pub fn shadow_casters(&self) -> Vec<(LightId, &Light)>

Get shadow-casting lights for the shadow system.

pub fn enabled_lights(&self) -> Vec<(LightId, &Light)>

Get all enabled lights as a flat list (useful for GPU upload).

pub fn stats(&self) -> LightManagerStats

Get statistics about the light manager.

Trait Implementations

impl Debug for LightManager

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

Formats the value using the given formatter.

impl Default for LightManager

fn default() -> Self

Returns the “default value” for a type.