Struct SpotLight 

pub struct SpotLight {
    pub position: [f32; 3],
    pub direction: [f32; 3],
    pub color: [f32; 3],
    pub intensity: f32,
    pub range: f32,
    pub inner_angle: f32,
    pub outer_angle: f32,
    pub cast_shadows: bool,
}

A cone-shaped local light: a point light restricted to the cone around direction, with a soft edge between inner_angle and outer_angle.

Distance attenuation matches PointLight; the cone adds an angular falloff that is full brightness inside the inner cone and fades to black at the outer cone. Spot lights share the same per-scene local-light budget as point lights and are culled by the same clustered pass. Secondary effects (volumetric fog, SDF raymarching, and reflection-probe capture) do not consider them.

SpotLight {
    position: [0.0, 4.0, -2.0],
    direction: [0.0, -1.0, 0.0],
    color: [1.0, 0.9, 0.7],
    intensity: 20.0,
    range: 10.0,
    inner_angle: 18.0,
    ..Default::default()
};

Fields

position: [f32; 3]

World-space position of the light source.

direction: [f32; 3]

Direction the cone points, away from the light. Does not need to be normalised; defaults to straight down when degenerate.

color: [f32; 3]

Linear-space RGB colour of the light.

intensity: f32

Intensity multiplier applied to the colour.

range: f32

Maximum reach in world units; attenuation is zero at this distance.

inner_angle: f32

Half-angle in degrees of the fully lit inner cone. Clamped to outer_angle.

outer_angle: f32

Half-angle in degrees at which the cone fades to black. Clamped to (0, 89.9].

cast_shadows: bool

Whether this light casts shadows. Shadowed spots claim one slice of the spot shadow map in declaration order; once the slices are used up the remaining spots still light the scene but cast nothing.

Trait Implementations

impl Clone for SpotLight

fn clone(&self) -> SpotLight

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for SpotLight

const NAME: &'static str = "SpotLight"

The registry name a world authors this component under.

fn from_baked(bytes: &[u8]) -> Result<SpotLight, CnResult>

Reconstruct this component from a blob record, whose bytes are the serialized runtime component (cook already ran the asset -> component translation). The default rejects: runtime-only components are never stored in a blob, so only loadable types provide an implementation.

fn inject_locator(&mut self, _locator: PayloadLocator)

Called after construction to inject the payload locator from the blob def. Only meaningful for components with a compiled payload. The default implementation does nothing (correct for most components).

fn inject_name(&mut self, _id: AssetId)

Called after construction to inject the asset’s identity from the blob def. Only meaningful for components that look themselves up by id at runtime. The default implementation does nothing.

impl ComponentSlot for SpotLight

const DISCRIMINANT: u8

The component type’s stable id, used as its ComponentId.

fn slot(s: &ComponentStorage) -> &Column<SpotLight>

Borrow this type’s column out of the storage.

fn slot_mut(s: &mut ComponentStorage) -> &mut Column<SpotLight>

Mutably borrow this type’s column out of the storage.

impl Debug for SpotLight

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

Formats the value using the given formatter.

impl Default for SpotLight

fn default() -> SpotLight

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SpotLight

where SpotLight: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<SpotLight, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<SpotLight> for ComponentAsset

fn from(c: SpotLight) -> ComponentAsset

Converts to this type from the input type.

impl RuntimeComponent for SpotLight

impl Serialize for SpotLight

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SpotLightGeometry for SpotLight

fn unit_direction(&self) -> [f32; 3]

Unit-length cone axis, falling back to straight down when the authored direction is degenerate.

fn cos_inner(&self) -> f32

Cosine of the inner half-angle: the widest angle still at full brightness.

fn cos_outer(&self) -> f32

Cosine of the outer half-angle: the angle at which the cone reaches black.