Enum Gradient 

#[non_exhaustive]
pub enum Gradient {
    Linear {
        angle_deg: f32,
        stops: Vec<Stop>,
    },
    Radial {
        cx: f32,
        cy: f32,
        radius: f32,
        stops: Vec<Stop>,
    },
}

Multi-stop gradient pattern.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Linear

Straight-line gradient. angle_deg follows CSS conventions: 0° paints bottom-to-top, 90° left-to-right, etc. Stops are offset-sorted (see Gradient::linear).

Fields

angle_deg: f32

stops: Vec<Stop>

Radial

Circular gradient. (cx, cy) is the centre in normalised canvas coordinates (0.5, 0.5 is dead-centre). radius is in normalised units of the canvas’s smaller axis. Stops are offset-sorted.

Fields

cx: f32

cy: f32

radius: f32

stops: Vec<Stop>

Implementations

impl Gradient

pub fn linear(angle_deg: f32, stops: impl IntoIterator<Item = Stop>) -> Self

Build a linear gradient. Stops are sorted by offset; duplicates at the same offset keep their original relative order (sort_by is stable).

pub fn radial( cx: f32, cy: f32, radius: f32, stops: impl IntoIterator<Item = Stop>, ) -> Self

Build a radial gradient. Stops are offset-sorted (see Gradient::linear).

pub fn stops(&self) -> &[Stop]

Borrow the gradient’s stop list.

pub fn sample(&self, t: f32) -> Option<u32>

Sample the gradient at a normalised position t ∈ [0, 1] along the gradient axis (for linear) or along the radius (for radial). Out-of-range t clamps to the nearest endpoint stop. Returns None if the gradient has no stops.

Interpolation is linear per channel — the same lerp used by crate::animation::KeyframeValue::Color keyframes — so the behaviour is consistent across the data model.

Trait Implementations

impl Clone for Gradient

fn clone(&self) -> Gradient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Gradient

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

Formats the value using the given formatter.

impl PartialEq for Gradient

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Gradient