Struct ColorStop 

pub struct ColorStop {
    pub position: f64,
    pub color: Color,
    pub name: Option<String>,
}

A color stop in a gradient (position + color)

Fields

position: f64

Position along the gradient (0.0 to 1.0)

color: Color

RGB color at this position

name: Option<String>

Optional name for documentation/UI purposes

Implementations

impl ColorStop

pub fn new(position: f64, color: Color) -> Self

Create a new color stop

Examples found in repository

examples/basic_usage.rs (line 22)

fn main() {
    // Load built-in colormap
    println!("Loading Fire colormap...");
    let fire = scala_chromatica::io::load_builtin_colormap("Fire")
        .expect("Failed to load Fire colormap");

    // Sample colors at different positions
    println!("\nFire gradient samples:");
    for i in 0..=10 {
        let position = i as f64 / 10.0;
        let color = fire.get_color(position);
        println!("  {:.1}: RGB({}, {}, {})", position, color.r, color.g, color.b);
    }

    // Create custom gradient
    println!("\nCreating custom gradient...");
    let mut custom = ColorMap::new("RedBlue");
    custom.add_stop(ColorStop::new(0.0, Color::new(255, 0, 0)));
    custom.add_stop(ColorStop::new(0.5, Color::new(255, 255, 255)));
    custom.add_stop(ColorStop::new(1.0, Color::new(0, 0, 255)));

    println!("\nCustom gradient samples:");
    for i in 0..=10 {
        let position = i as f64 / 10.0;
        let color = custom.get_color(position);
        println!("  {:.1}: RGB({}, {}, {})", position, color.r, color.g, color.b);
    }

    // List all available colormaps
    println!("\nListing all available colormaps...");
    match scala_chromatica::io::list_available_colormaps() {
        Ok(colormaps) => {
            println!("Found {} colormap(s):", colormaps.len());
            for info in colormaps {
                let type_str = if info.is_builtin {
                    "built-in"
                } else {
                    "custom"
                };
                println!("  - {} ({})", info.name, type_str);
            }
        }
        Err(e) => eprintln!("Error listing colormaps: {}", e),
    }

    // Demonstrate HSV color creation
    println!("\nHSV color examples:");
    let red = Color::from_hsv(0.0, 1.0, 1.0);
    println!("  Red (H=0):   RGB({}, {}, {})", red.r, red.g, red.b);

    let green = Color::from_hsv(120.0, 1.0, 1.0);
    println!("  Green (H=120): RGB({}, {}, {})", green.r, green.g, green.b);

    let blue = Color::from_hsv(240.0, 1.0, 1.0);
    println!("  Blue (H=240): RGB({}, {}, {})", blue.r, blue.g, blue.b);
}

pub fn with_name(position: f64, color: Color, name: impl Into<String>) -> Self

Create a new color stop with a name

Trait Implementations

impl Clone for ColorStop

fn clone(&self) -> ColorStop

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorStop

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ColorStop

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ColorStop

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

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 ColorStop