auto-palette 0.7.0

🎨 A Rust library that extracts prominent color palettes from images automatically.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

#![deny(warnings)]

use auto_palette::{ImageData, Palette};

/// Extracts a palette from an image file.
///
/// The image path can be provided as a command line argument as follows:
/// ```sh
/// cargo run --example basic -- 'path/to/image.jpg'
/// ```
fn main() {
    // Read the image path from the command line arguments
    let path = std::env::args().nth(1).unwrap_or_else(|| {
        println!("No image path provided, using the default image path");
        "./gfx/holly-booth-hLZWGXy5akM-unsplash.jpg".into()
    });

    // Load the image data from the file
    let image_data = ImageData::load(path).unwrap();

    // Extract the color palette from the image data
    let palette: Palette<f32> = Palette::extract(&image_data).unwrap();
    println!("Extracted {} swatch(es)", palette.len());

    // Find the 5 dominant colors in the palette and print their information
    let swatches = palette.find_swatches(5);
    println!(
        "{:>2} | {:<7} | {:<12} | {:<10} | {:<6}",
        "#", "Color", "Position", "Population", "Ratio"
    );
    for (i, swatch) in swatches.iter().enumerate() {
        println!(
            "{:>2} | {:<7} | {:>4?} | {:>10} | {:>5.2}",
            i + 1,
            swatch.color().to_hex_string(),
            swatch.position(),
            swatch.population(),
            swatch.ratio()
        );
    }
}