Rust 编程语言虽然已经发展了好几年的时间了,但对于图片处理还是没有好用的以纯 Rust 或是纯 Rust+libc 来开发的函数库,虽然在 crates.io 上有 image 这个套件,但它的格式支持度还很有限。因此为了让 Rust 程序能够拥有强大的图片处理能力,现阶段还是必须使其与 ImageMagick 等历史悠久的 C 语言函数库来进行绑定,才能实现出功能完整且性能优良的图片处理程序。

image-convert

「Image Convert」是笔者开发的套件,利用 ImageMagick 的 MagickWand API 来实现出高级的图片信息查看、高品质缩放、交错化与格式转换的函数。

Crates.io

Cargo.toml

image-convert = "*"

使用方法

查看图片信息

利用 image_convert 这个 crate 所提供的 identify 函数,可以快速取得一张图片的格式、尺寸以及其交错化的方式。

例如:

use image_convert::{ImageResource, InterlaceType, identify};

let input = ImageResource::from_path("tests/data/P1060382.JPG");

let mut output = None;

let id = identify(&mut output, &input).unwrap();

assert_eq!(4592, id.resolution.width);
assert_eq!(2584, id.resolution.height);
assert_eq!("JPEG", id.format);
assert_eq!(InterlaceType::NoInterlace, id.interlace);

在使用 identify 函数时,第一个参数要传入一个 Option 枚举的可变参考,通常会传入 None 的可变参考,表示不要读取完整的图片,只读取图片信息,如此一来可以省下很多读取时间。不过如果想要同时读取图片的图像数据和图片信息的话,第一个参数可以传入 Some(None),在成功运行 identify 函数后,Some(None) 就会被改为 Some(Some(image_convert::magick_rust::MagickWand)),接着我们就可以用这个 MagickWand 实体来对图片进行低级的处理啦!这部份要参考 magick_rust 这个 crate 的用法。

缩放、交错化与格式转换

图片的缩放、交错化与格式转换可以透过 image_convert 这个 crate 在一个函数内完成。例如要将一张图片,进行缩放并转成 PNG 格式,程序如下:

use std::path::Path;

use image_convert::{ImageResource, PNGConfig, to_png};

let source_image_path = Path::new("tests/data/P1060382.JPG");

let target_image_path = Path::join(source_image_path.parent().unwrap(), "P1060382_output.png");

let mut config = PNGConfig::new();

config.width = 1920;

let input = ImageResource::from_path(source_image_path);

let mut output = ImageResource::from_path(target_image_path);

to_png(&mut output, &input, &config).unwrap();

简单来说,每种转出格式 XXX(如 BMP、JPG、PNG、GIF、WEBP、ICO 和 GrayRaw)都有其专属的 XXXConfig 和 to_xxx 等函数可以使用。一开始可以先产生 XXXConfig 的结构实体,并且设置好结构实体的字段。接着创建出两个 ImageResource 结构实体,来指定图片的输入来源和输出目的地,可以是文件路径或是 Vec<u8> 结构实体。最后再调用 to_xxx 函数来处理即可。

在预设的情况下,当图片需要进行缩放时,这个套件还会自动进行不同程度的图片锐化,使得图片看起来品质更好。当然,借由编辑 XXXConfig 结构实体的 sharpen 字段,是可以手动控制锐化程度的。