Struct Gradient 

pub struct Gradient { /* private fields */ }

A multi-stop color gradient for smooth transitions.

Gradients interpolate between two or more color stops. Use at(t) to sample a color at any point along the gradient, or generate(n) to produce a sequence of evenly-spaced colors.

Implementations

impl Gradient

pub fn new(stops: Vec<OpalineColor>) -> Self

Create a gradient from a list of color stops.

Panics

Panics if stops is empty. For a fallible alternative, use try_new.

pub fn try_new(stops: Vec<OpalineColor>) -> Result<Self, OpalineError>

Create a gradient from a list of color stops, returning an error if empty.

pub fn at(&self, t: f32) -> OpalineColor

Sample the gradient at position t (clamped to [0.0, 1.0]).

With a single stop, always returns that stop. With multiple stops, linearly interpolates between the appropriate segment.

pub fn generate(&self, n: usize) -> Vec<OpalineColor>

Generate n evenly-spaced colors across the gradient.

Returns a single color for n == 1, or empty vec for n == 0.

pub fn len(&self) -> usize

Number of color stops in this gradient.

pub fn is_empty(&self) -> bool

Whether this gradient has no stops (always false after construction).

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

Access the underlying color stops.

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 Default for Gradient

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Gradient

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Gradient

fn eq(&self, other: &Gradient) -> 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 Serialize for Gradient

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Gradient