04e1052266
Leave the generated bindings out of the source repository and instead have Cargo automatically build them if they are missing. This allows the version of MagickWand to be incorporated into the bindings automatically. For instance, in Homebrew the version is 6.Q16, while on FreeBSD 10.2 it is 6.9, and only be generating the bindings for each system can we ensure a smooth compilation process.
1.2 KiB
1.2 KiB
magick-rust
A somewhat safe Rust interface to the ImageMagick system, in particular, the MagickWand library. Many of the functions in the MagickWand API are still missing, and those that are needed will be gradually added.
Dependenices
- Rust
- Cargo
- ImageMagick
Build and Test
Pretty simple for now.
$ cargo build
$ cargo test
Example Usage
MagickWand has some global state that needs to be initialized prior to using the library, but fortunately Rust makes handling this pretty easy. In the example below, we read in an image from a file and resize it to fit a square of 240 by 240 pixels, then convert the image to JPEG.
use magick_rust::{MagickWand, magick_wand_genesis};
use std::sync::{Once, ONCE_INIT};
// Used to make sure MagickWand is initialized exactly once. Note that we
// do not bother shutting down, we simply exit when we're done.
static START: Once = ONCE_INIT;
fn resize() -> Result<Vec<u8>, &'static str> {
START.call_once(|| {
magick_wand_genesis();
});
let wand = MagickWand::new();
try!(wand.read_image("kittens.jpg"));
wand.fit(240, 240);
wand.write_image_blob("jpeg")
}