Rust颜色处理库matugen的使用指南

介绍

matugen是一个Rust库，用于根据Material Design 3规范生成主题颜色和动态调色板。它可以从图像或颜色中提取主色调，并生成完整的调色板系统，非常适合需要遵循Material Design设计规范的应用程序开发。

主要功能：

• 从图像或颜色生成Material主题
• 创建动态调色板
• 支持浅色和深色主题
• 遵循Material Design 3 (Material You)规范

安装

在Cargo.toml中添加依赖：

[dependencies]
matugen = "0.1"

基本使用方法

从颜色生成主题

use matugen::{theme_from_color, Color};

fn main() {
    // 使用十六进制颜色代码
    let color = Color::from_hex("#6750A4").unwrap();
    
    // 生成主题
    let theme = theme_from_color(&color, false, false).unwrap();
    
    println!("Primary color: {:?}", theme.primary);
    println!("Secondary color: {:?}", theme.secondary);
    println!("Tertiary color: {:?}", theme.tertiary);
}

从图像生成主题

use matugen::{theme_from_image, Image};

fn main() {
    // 加载图像
    let image = Image::from_path("path/to/image.jpg").unwrap();
    
    // 生成主题 (参数分别是: 图像, 是否提取深色主题, 是否使用内容策略)
    let theme = theme_from_image(&image, false, false).unwrap();
    
    println!("Generated theme colors:");
    println!("Primary: {:?}", theme.primary);
    println!("On Primary: {:?}", theme.on_primary);
    println!("Primary Container: {:?}", theme.primary_container);
}

高级功能

创建动态调色板

use matugen::{palette::Palette, Color};

fn main() {
    let seed_color = Color::from_hex("#4285F4").unwrap();
    let palette = Palette::new(&seed_color);
    
    println!("Primary tones:");
    for (tone, color) in palette.primary.iter() {
        println!("Tone {}: {:?}", tone, color);
    }
}

生成完整的主题系统

use matugen::{theme_system_from_color, Color};

fn main() {
    let color = Color::from_hex("#FF5722").unwrap();
    let theme_system = theme_system_from_color(&color).unwrap();
    
    // 浅色主题
    println!("Light theme primary: {:?}", theme_system.light.primary);
    
    // 深色主题
    println!("Dark theme primary: {:?}", theme_system.dark.primary);
}

实际应用示例

在GUI应用中使用生成的调色板

use iced::{Application, Settings, Color as IcedColor};
use matugen::{theme_from_color, Color};

struct MyApp {
    theme: matugen::Theme,
}

impl Application for MyApp {
    // ... 其他必要的实现
    
    fn theme(&self) -> iced::Theme {
        iced::Theme::custom(iced::theme::Palette {
            primary: IcedColor::from_rgba8(
                self.theme.primary.red,
                self.theme.primary.green,
                self.theme.primary.blue,
                self.theme.primary.alpha as f32 / 255.0,
            ),
            // 设置其他颜色...
            ..Default::default()
        })
    }
}

fn main() {
    let seed_color = Color::from_hex("#6200EE").unwrap();
    let theme = theme_from_color(&seed_color, false, false).unwrap();
    
    MyApp::run(Settings::with_flags(theme)).unwrap();
}

完整示例代码

下面是一个完整的示例，展示如何使用matugen库创建一个简单的GUI应用，并应用生成的Material主题：

use iced::{Application, Command, Element, Settings, Theme as IcedTheme};
use iced::widget::{Column, Text, Button};
use matugen::{theme_from_color, Color};

// 定义应用结构体
struct MatugenDemo {
    theme: matugen::Theme,
    color_index: usize,
}

// 预定义的颜色列表
const COLORS: &[&str] = &[
    "#6750A4",  // 紫色
    "#4285F4",  // 蓝色
    "#FF5722",  // 橙色
    "#6200EE",  // 深紫色
];

#[derive(Debug, Clone)]
enum Message {
    ChangeColor,
}

impl Application for MatugenDemo {
    type Message = Message;
    type Theme = IcedTheme;
    type Executor = iced::executor::Default;
    type Flags = matugen::Theme;

    // 初始化应用
    fn new(theme: Self::Flags) -> (Self, Command<Message>) {
        (Self {
            theme,
            color_index: 0,
        }, Command::none())
    }

    // 应用标题
    fn title(&self) -> String {
        String::from("Matugen Demo")
    }

    // 处理消息
    fn update(&mut self, message: Message) -> Command<Message> {
        match message {
            Message::ChangeColor => {
                self.color_index = (self.color_index + 1) % COLORS.len();
                let new_color = Color::from_hex(COLORS[self.color_index]).unwrap();
                self.theme = theme_from_color(&new_color, false, false).unwrap();
                Command::none()
            }
        }
    }

    // 应用主题
    fn theme(&self) -> IcedTheme {
        IcedTheme::custom(iced::theme::Palette {
            primary: iced::Color::from_rgba8(
                self.theme.primary.red,
                self.theme.primary.green,
                self.theme.primary.blue,
                self.theme.primary.alpha as f32 / 255.0,
            ),
            success: iced::Color::from_rgba8(
                self.theme.secondary.red,
                self.theme.secondary.green,
                self.theme.secondary.blue,
                self.theme.secondary.alpha as f32 / 255.0,
            ),
            danger: iced::Color::from_rgba8(
                self.theme.tertiary.red,
                self.theme.tertiary.green,
                self.theme.tertiary.blue,
                self.theme.tertiary.alpha as f32 / 255.0,
            ),
            ..Default::default()
        })
    }

    // 构建UI
    fn view(&self) -> Element<Message> {
        Column::new()
            .push(Text::new("Matugen Demo").size(24))
            .push(Text::new(format!("当前主题颜色: {}", COLORS[self.color_index])))
            .push(Button::new("切换颜色").on_press(Message::ChangeColor))
            .padding(20)
            .spacing(10)
            .into()
    }
}

fn main() {
    // 初始颜色
    let seed_color = Color::from_hex(COLORS[0]).unwrap();
    let theme = theme_from_color(&seed_color, false, false).unwrap();
    
    // 启动应用
    MatugenDemo::run(Settings::with_flags(theme)).unwrap();
}

注意事项

1. 图像处理功能需要启用image特性：

   matugen = { version = "0.1", features = ["image"] }
   

2. 颜色值范围是0-255的RGBA格式

3. 对于性能敏感的应用，考虑在后台线程执行颜色生成操作

matugen库为Rust开发者提供了实现Material Design主题系统的便捷方式，特别适合跨平台应用和需要动态主题支持的场景。