Rust颜色处理库colorz使用指南

colorz是一个高效的Rust颜色处理库，提供了RGB、HEX、HSL等色彩模型的转换功能以及调色板生成能力。

主要特性

• RGB、HEX、HSL颜色格式相互转换
• 调色板生成功能
• 颜色混合与调整
• 高性能实现

安装

在Cargo.toml中添加依赖：

[dependencies]
colorz = "0.3"

基本使用

颜色创建与转换

use colorz::{Color, Rgb, Hsl, Hex};

fn main() {
    // 从RGB创建颜色
    let red = Rgb::new(255, 0, 0);
    
    // 转换为HSL
    let red_hsl: Hsl = red.into();
    println!("Red in HSL: {:?}", red_hsl);
    
    // 从HEX字符串创建
    let blue = Hex::from_str("#0000FF").unwrap();
    println!("Blue from HEX: {:?}", blue);
    
    // 转换为RGB
    let blue_rgb: Rgb = blue.into();
    println!("Blue in RGB: {:?}", blue_rgb);
}

颜色调整

use colorz::{Rgb, Hsl};

fn main() {
    let mut green = Rgb::new(0, 128, 0);
    
    // 调亮颜色
    green.lighten(10);
    println!("Lighter green: {:?}", green);
    
    // 转换为HSL并调整饱和度
    let mut green_hsl: Hsl = green.into();
    green_hsl.saturate(20);
    println!("More saturated green: {:?}", green_hsl);
}

调色板生成

use colorz::{Rgb, Palette};

fn main() {
    let base_color = Rgb::new(100, 150, 200);
    
    // 生成单色调色板
    let monochromatic = Palette::monochromatic(&base_color, 5);
    println!("Monochromatic palette: {:?}", monochromatic);
    
    // 生成互补色调色板
    let complementary = Palette::complementary(&base_color, 3);
    println!("Complementary palette: {:?}", complementary);
    
    // 生成类似色调色板
    let analogous = Palette::analogous(&base_color, 5, 30.0);
    println!("Analogous palette: {:?}", analogous);
}

高级功能

颜色混合

use colorz::{Rgb, BlendMode};

fn main() {
    let red = Rgb::new(255, 0, 0);
    let blue = Rgb::new(0, 0, 255);
    
    // 混合颜色
    let purple = red.blend(&blue, BlendMode::Multiply);
    println!("Red multiplied by blue: {:?}", purple);
    
    // 线性插值混合
    let gradient = red.mix(&blue, 0.5);
    println!("50% mix of red and blue: {:?}", gradient);
}

颜色对比度计算

use colorz::{Rgb, contrast_ratio};

fn main() {
    let black = Rgb::new(0, 0, 0);
    let white = Rgb::new(255, 255, 255);
    
    let ratio = contrast_ratio(&black, &white);
    println!("Contrast ratio between black and white: {:.2}", ratio);
    
    // WCAG 2.1建议最小对比度为4.5:1
    if ratio >= 4.5 {
        println!("This contrast meets WCAG 2.1 AA standard");
    }
}

性能提示

colorz在设计上注重性能：

• 使用整数运算而非浮点数运算
• 尽量减少内存分配
• 提供无panic的API

对于批量处理颜色，建议使用迭代器模式：

use colorz::{Rgb, Palette};

fn process_colors(colors: &[Rgb]) -> Vec<Rgb] {
    colors.iter()
        .map(|c| c.darken(10))
        .collect()
}

colorz库适合需要高性能颜色处理的Rust应用，如图形处理、数据可视化、游戏开发等场景。

完整示例demo

下面是一个综合使用colorz库的完整示例，展示了多种颜色操作：

use colorz::{Color, Rgb, Hsl, Hex, Palette, BlendMode, contrast_ratio};

fn main() {
    // 1. 颜色创建与转换
    println!("=== 颜色创建与转换 ===");
    let red = Rgb::new(255, 0, 0);
    let red_hsl: Hsl = red.into();
    println!("红色 (RGB): {:?}", red);
    println!("红色 (HSL): {:?}", red_hsl);
    
    let cyan = Hex::from_str("#00FFFF").unwrap();
    let cyan_rgb: Rgb = cyan.into();
    println!("青色 (HEX): {:?}", cyan);
    println!("青色 (RGB): {:?}", cyan_rgb);
    
    // 2. 颜色调整
    println!("\n=== 颜色调整 ===");
    let mut purple = Rgb::new(128, 0, 128);
    println!("原始紫色: {:?}", purple);
    
    purple.lighten(15);
    println!("调亮15%后: {:?}", purple);
    
    let mut purple_hsl: Hsl = purple.into();
    purple_hsl.desaturate(30);
    println!("降低饱和度30%后: {:?}", purple_hsl);
    
    // 3. 调色板生成
    println!("\n=== 调色板生成 ===");
    let primary = Rgb::new(255, 165, 0); // 橙色
    
    let shades = Palette::monochromatic(&primary, 5);
    println!("单色调色板 (5种): {:?}", shades);
    
    let triadic = Palette::complementary(&primary, 3);
    println!("互补色调色板 (3种): {:?}", triadic);
    
    // 4. 颜色混合
    println!("\n=== 颜色混合 ===");
    let yellow = Rgb::new(255, 255, 0);
    let blue = Rgb::new(0, 0, 255);
    
    let multiply = yellow.blend(&blue, BlendMode::Multiply);
    println!("黄色与蓝色相乘混合: {:?}", multiply);
    
    let overlay = yellow.blend(&blue, BlendMode::Overlay);
    println!("黄色与蓝色叠加混合: {:?}", overlay);
    
    let gradient = yellow.mix(&blue, 0.3);
    println!("30%黄色与70%蓝色混合: {:?}", gradient);
    
    // 5. 颜色对比度
    println!("\n=== 颜色对比度 ===");
    let dark_gray = Rgb::new(50, 50, 50);
    let light_gray = Rgb::new(200, 200, 200);
    
    let ratio = contrast_ratio(&dark_gray, &light_gray);
    println!("对比度比率: {:.2}", ratio);
    
    if ratio >= 4.5 {
        println!("符合WCAG 2.1 AA标准");
    } else {
        println!("不符合WCAG 2.1 AA标准");
    }
    
    // 6. 批量处理颜色
    println!("\n=== 批量处理颜色 ===");
    let colors = vec![
        Rgb::new(255, 0, 0),
        Rgb::new(0, 255, 0),
        Rgb::new(0, 0, 255)
    ];
    
    let darkened: Vec<Rgb> = colors.iter()
        .map(|c| {
            let mut color = *c;
            color.darken(20);
            color
        })
        .collect();
    
    println!("原始颜色: {:?}", colors);
    println!("调暗20%后: {:?}", darkened);
}

这个完整示例演示了：

1. 颜色创建与不同格式间的转换
2. 颜色亮度、饱和度的调整
3. 多种调色板生成方式
4. 不同混合模式的颜色混合
5. 颜色对比度计算和WCAG标准检查
6. 使用迭代器批量处理颜色

运行此示例将输出各种颜色操作的结果，帮助您全面了解colorz库的功能。