rust-icns

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

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

概述

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

关于如何使用库的更多信息，请参阅crate文档。

示例用法

extern crate icns;
use 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许可证下提供。MIT许可证.