Enum LightSource 

pub enum LightSource {
    Distant {
        azimuth: f32,
        elevation: f32,
    },
    Point {
        x: f32,
        y: f32,
        z: f32,
    },
    Spot {
        x: f32,
        y: f32,
        z: f32,
        points_at_x: f32,
        points_at_y: f32,
        points_at_z: f32,
        specular_exponent: f32,
        limiting_cone_angle: Option<f32>,
    },
}

Light source configurations for lighting effects.

Defines different types of light sources used in diffuse and specular lighting filter primitives. Each type has different characteristics and use cases.

Variants

Distant

Distant light source (infinitely far away, like the sun).

All rays are parallel, creating uniform lighting across the surface. Direction is specified using spherical coordinates (azimuth and elevation).

Fields

azimuth: f32

Azimuth angle in degrees (0° = pointing right, 90° = pointing up). Defines the horizontal direction of the light.

elevation: f32

Elevation angle in degrees (0° = horizon, 90° = directly overhead). Defines the vertical angle of the light source.

Point

Point light source at a specific 3D position.

Light radiates uniformly in all directions from a single point. Intensity decreases with distance. Like a light bulb.

Fields

x: f32

Light source X coordinate in user space.

y: f32

Light source Y coordinate in user space.

z: f32

Light source Z coordinate (height above the surface). Larger values create softer lighting across larger areas.

Spot

Spot light with position, direction, and cone angle.

Light emanates from a point in a specific direction with limited spread. Like a flashlight or stage spotlight with adjustable focus.

Fields

x: f32

Light source X coordinate in user space.

y: f32

Light source Y coordinate in user space.

z: f32

Light source Z coordinate (height above the surface).

points_at_x: f32

X coordinate the spotlight is aimed at.

points_at_y: f32

Y coordinate the spotlight is aimed at.

points_at_z: f32

Z coordinate the spotlight is aimed at.

specular_exponent: f32

Specular exponent controlling the focus/sharpness of the spotlight beam. Higher values create tighter, more focused beams.

limiting_cone_angle: Option<f32>

Optional cone angle in degrees limiting the spotlight spread. If None, the light spreads based only on the specular exponent.

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 PartialEq for LightSource

fn eq(&self, other: &LightSource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for LightSource