Struct LightingSettings 

#[non_exhaustive]
pub struct LightingSettings {
    pub lights: Vec<LightSource>,
    pub shadow_bias: f32,
    pub shadows_enabled: bool,
    pub sky_colour: [f32; 3],
    pub ground_colour: [f32; 3],
    pub hemisphere_intensity: f32,
    pub shadow_extent_override: Option<f32>,
    pub shadow_cascade_count: u32,
    pub shadow_atlas_resolution: u32,
    pub shadow_filter: ShadowFilter,
    pub pcss_light_radius: f32,
    pub debug_vis: DebugVis,
}

Per-frame lighting configuration for the viewport.

Supports up to 8 light sources. Only lights[0] casts shadows. Blinn-Phong shading coefficients (ambient, diffuse, specular, shininess) have moved to per-object [Material] structs.

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.

lights: Vec<LightSource>

Active light sources (max 8). Default: one directional light.

shadow_bias: f32

Constant NDC depth bias subtracted from the receiver comparison depth. Default: 0.0.

shadows_enabled: bool

Whether shadow maps are computed and sampled. Default: true.

sky_colour: [f32; 3]

Sky colour for hemisphere ambient. Default [0.8, 0.9, 1.0].

ground_colour: [f32; 3]

Ground colour for hemisphere ambient. Default [0.3, 0.2, 0.1].

hemisphere_intensity: f32

Hemisphere ambient intensity. 0.0 = disabled. Default 0.0.

shadow_extent_override: Option<f32>

Override the shadow frustum half-extent (world units). None = auto (20.0). Tighter values improve shadow map texel density and reduce contact-shadow penumbra.

shadow_cascade_count: u32

Number of cascaded shadow map splits (1-4). Default: 4.

shadow_atlas_resolution: u32

Shadow atlas resolution (width = height). Default: 4096. Each cascade tile is atlas_resolution / 2.

shadow_filter: ShadowFilter

Shadow filtering mode. Default: PCF.

pcss_light_radius: f32

PCSS light source radius in shadow-map UV space. Controls penumbra width. Default: 0.02.

debug_vis: DebugVis

Debug visualization configuration. Off by default (zero overhead when inactive).

Trait Implementations

impl Clone for LightingSettings

fn clone(&self) -> LightingSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LightingSettings

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

Formats the value using the given formatter.

impl Default for LightingSettings

fn default() -> Self

Returns the “default value” for a type.