rust-icns

这是mdsteele/rust-icns的一个分支。

Rust库，用于编码/解码Apple Icon Image (.icns)文件。

文档：https://docs.rs/tauri-icns

概述

icns crate实现了ICNS文件的读取和写入，将图像编码和解码成ICNS图标家族，将这些图像转换为其他像素格式（如果需要将图像数据传输到另一个期望特定格式的库），并将这些图像保存到PNG文件或从PNG文件加载。

crate文档提供了更多关于如何使用此库的信息。

示例用法

extern crate icns;
use tauri_icns::{IconFamily, IconType, Image};
use std::fs::File;
use std::io::{BufReader, BufWriter};

fn main() {
    // Load an icon family from an ICNS file.
    let file = BufReader::new(File::open("16.icns").unwrap());
    let mut icon_family = IconFamily::read(file).unwrap();

    // Extract an icon from the family and save it as a PNG.
    let image = icon_family.get_icon_with_type(IconType::RGB24_16x16).unwrap();
    let file = BufWriter::new(File::create("16.png").unwrap());
    image.write_png(file).unwrap();

    // Read in another icon from a PNG file, and add it to the icon family.
    let file = BufReader::new(File::open("32.png").unwrap());
    let image = Image::read_png(file).unwrap();
    icon_family.add_icon(&image).unwrap();

    // Save the updated icon family to a new ICNS file.
    let file = BufWriter::new(File::create("16-and-32.icns").unwrap());
    icon_family.write(file).unwrap();
}

支持的图标类型

ICNS文件可以包含多种不同的图标类型。此库支持最常用的类型，但一些较旧的类型尚未支持。下表显示了当前支持的类型；有关每种类型的更多信息，请参阅https://en.wikipedia.org/wiki/Apple_Icon_Image_format#Icon_types。

当前最大的限制是，许多较新的图标类型可以使用PNG或JPEG 2000数据进行编码，但此库尚不支持JPEG 2000；尝试解码此类图标将返回错误值（尽管您仍然可以从同一ICNS文件中解码其他图标）。原因是我目前不知道有任何Rust的JPEG 2000库；如果有，请随时提交错误报告或发送拉取请求。

许可

rust-icns 在MIT 许可证下提供。