Struct LightRig 

pub struct LightRig<'a> {
    pub sun: Option<DirectionalLight>,
    pub points: &'a [PointLight],
    pub ambient: [f32; 3],
    pub shadow_strength: f32,
    pub shadow_bias_voxels: f32,
    pub shadow_max_dist: f32,
    pub bands: u32,
    pub shadow_tint: [f32; 3],
}

The whole per-frame light environment, borrowed into crate::FrameParams. GPU-only.

Fields

sun: Option<DirectionalLight>

The sun. None ⇒ no directional light this frame.

points: &'a [PointLight]

Point lights. The backend caps the count (excess dropped with a log warning), so this slice may be longer than the GPU honours.

ambient: [f32; 3]

Multiplier applied to the baked ambient byte — the global ambient level / tint. [1.0; 3] uses the baked byte as-is.

shadow_strength: f32

Stylized-shadow strength 0..1: the fraction of a caster’s light removed in shadow (1.0 = full black, 0.0 = no visible shadow).

shadow_bias_voxels: f32

Shadow-ray origin bias along the surface normal, in voxel units — kills self-shadow acne. ~1.5 is a good default.

shadow_max_dist: f32

Sun shadow-ray length cap, world units (point-light shadow rays stop at the light instead).

bands: u32

DL.6 — stylized lighting. 0 ⇒ smooth (physically-ish) diffuse (the default). ≥1 ⇒ retro cel look: the sun’s key term and each point light’s diffuse factor quantize to bands + 1 discrete levels (terraced light instead of a smooth gradient), and the banded sun key drives a gradient map from shadow_tint (cool, unlit) to the sun’s colour (warm, lit) — hue-shifted shadows rather than plain darkening. Avoids the “generic Phong” read that flattens the voxel/retro identity.

shadow_tint: [f32; 3]

DL.6 — the cool shadow/ambient tint the stylized ramp starts from (the unlit end). Multiplied by the baked ambient/AO byte. Ignored when bands == 0 (then ambient is used instead).

Trait Implementations

impl<'a> Clone for LightRig<'a>

fn clone(&self) -> LightRig<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for LightRig<'a>

impl<'a> Debug for LightRig<'a>

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

Formats the value using the given formatter.

impl Default for LightRig<'_>

fn default() -> Self

Returns the “default value” for a type.