use std::fmt; use std::ptr; use std::ffi::{CStr, CString}; use libc::{c_uint, c_double, c_void}; use ::{size_t, ssize_t}; use ::filters::FilterType; use ::bindings; use ::conversions::*; use super::{DrawingWand, PixelWand}; /// MagickWand is a Rustic wrapper to the Rust bindings to ImageMagick. /// /// Instantiating a `MagickWand` will construct an ImageMagick "wand" /// on which operations can be performed via the `MagickWand` functions. /// When the `MagickWand` is dropped, the ImageMagick wand will be /// destroyed as well. wand_common!( MagickWand, NewMagickWand, ClearMagickWand, IsMagickWand, CloneMagickWand, DestroyMagickWand, MagickClearException, MagickGetExceptionType, MagickGetException ); impl MagickWand { pub fn new_image(&self, columns: size_t, rows: size_t, pixel_wand: &PixelWand) -> Result<(), &'static str> { match unsafe { bindings::MagickNewImage(self.wand, columns, rows, pixel_wand.wand) } { bindings::MagickTrue => Ok(()), _ => Err("Could not create image"), } } pub fn annotate_image(&mut self, drawing_wand: &DrawingWand, x: f64, y: f64, angle: f64, text: &str) -> Result<(), &'static str> { let c_string = try!(CString::new(text).map_err(|_| "could not convert to cstring")); match unsafe { bindings::MagickAnnotateImage(self.wand, drawing_wand.wand, x, y, angle, c_string.as_ptr() as *const _) } { bindings::MagickTrue => Ok(()), _ => Err("unable to annotate image") } } pub fn append_all(&mut self, stack: bool) -> MagickWand { unsafe { bindings::MagickResetIterator(self.wand) }; MagickWand { wand: unsafe { bindings::MagickAppendImages(self.wand, stack.to_magick()) } } } pub fn label_image(&self, label: &str) -> Result<(), &'static str> { let c_label = CString::new(label).unwrap(); let result = unsafe { bindings::MagickLabelImage(self.wand, c_label.as_ptr()) }; match result { bindings::MagickTrue => Ok(()), _ => Err("failed to add label") } } pub fn write_images(&self, path: &str, adjoin: bool) -> Result<(), &'static str> { let c_name = CString::new(path).unwrap(); let result = unsafe { bindings::MagickWriteImages(self.wand, c_name.as_ptr(), adjoin.to_magick()) }; match result { bindings::MagickTrue => Ok(()), _ => Err("failed to write images") } } /// Read the image data from the named file. pub fn read_image(&self, path: &str) -> Result<(), &'static str> { let c_name = CString::new(path).unwrap(); let result = unsafe { bindings::MagickReadImage(self.wand, c_name.as_ptr()) }; match result { bindings::MagickTrue => Ok(()), _ => Err("failed to read image") } } /// Read the image data from the vector of bytes. pub fn read_image_blob(&self, data: Vec) -> Result<(), &'static str> { let int_slice = &data[..]; let size = data.len(); let result = unsafe { bindings::MagickReadImageBlob( self.wand, int_slice.as_ptr() as *const c_void, size as size_t) }; match result { bindings::MagickTrue => Ok(()), _ => Err("failed to read image") } } /// Retrieve the width of the image. pub fn get_image_width(&self) -> usize { unsafe { bindings::MagickGetImageWidth(self.wand) as usize } } /// Retrieve the height of the image. pub fn get_image_height(&self) -> usize { unsafe { bindings::MagickGetImageHeight(self.wand) as usize } } /// Retrieve the named image property value. pub fn get_image_property(&self, name: &str) -> Result { let c_name = CString::new(name).unwrap(); let result = unsafe { bindings::MagickGetImageProperty(self.wand, c_name.as_ptr()) }; let value = if result.is_null() { Err("missing property") } else { // convert (and copy) the C string to a Rust string let cstr = unsafe { CStr::from_ptr(result) }; Ok(cstr.to_string_lossy().into_owned()) }; unsafe { bindings::MagickRelinquishMemory(result as *mut c_void); } value } /// Resize the image to the specified width and height, using the /// specified filter type with the specified blur / sharpness factor. /// /// blur_factor values greater than 1 create blurriness, while values /// less than 1 create sharpness. pub fn resize_image(&self, width: usize, height: usize, filter: FilterType, blur_factor: f64) { unsafe { bindings::MagickResizeImage( self.wand, width as size_t, height as size_t, filter as c_uint, blur_factor as c_double ); } } /// Resize the image to find within the given dimensions, maintaining /// the current aspect ratio. pub fn fit(&self, width: size_t, height: size_t) { let mut width_ratio = width as f64; width_ratio /= self.get_image_width() as f64; let mut height_ratio = height as f64; height_ratio /= self.get_image_height() as f64; let new_width: size_t; let new_height: size_t; if width_ratio < height_ratio { new_width = width; new_height = (self.get_image_height() as f64 * width_ratio) as size_t; } else { new_width = (self.get_image_width() as f64 * height_ratio) as size_t; new_height = height; } unsafe { bindings::MagickResetIterator(self.wand); while bindings::MagickNextImage(self.wand) != bindings::MagickFalse { bindings::MagickResizeImage(self.wand, new_width, new_height, FilterType::LanczosFilter as c_uint, 1.0); } } } /// Detect if the loaded image is not in top-left orientation, and /// hence should be "auto" oriented so it is suitable for viewing. pub fn requires_orientation(&self) -> bool { unsafe { bindings::MagickGetImageOrientation(self.wand) != bindings::TopLeftOrientation } } /// Automatically adjusts the loaded image so that its orientation is /// suitable for viewing (i.e. top-left orientation). /// /// Returns `true` if successful or `false` if an error occurred. pub fn auto_orient(&self) -> bool { unsafe { bindings::MagickAutoOrientImage(self.wand) == bindings::MagickTrue } } /// Write the current image to the provided path. pub fn write_image(&self, path: &str) -> Result<(), &'static str> { let c_name = CString::new(path).unwrap(); let result = unsafe { bindings::MagickWriteImage(self.wand, c_name.as_ptr()) }; match result { bindings::MagickTrue => Ok(()), _ => Err("failed to write image") } } /// Write the image in the desired format to a new blob. /// /// The `format` argument may be any ImageMagick supported image /// format (e.g. GIF, JPEG, PNG, etc). pub fn write_image_blob(&self, format: &str) -> Result, &'static str> { let c_format = CString::new(format).unwrap(); let mut length: size_t = 0; let blob = unsafe { bindings::MagickSetImageFormat(self.wand, c_format.as_ptr()); bindings::MagickResetIterator(self.wand); bindings::MagickGetImageBlob(self.wand, &mut length) }; let mut bytes = Vec::with_capacity(length as usize); unsafe { bytes.set_len(length as usize); ptr::copy_nonoverlapping(blob, bytes.as_mut_ptr(), length as usize); bindings::MagickRelinquishMemory(blob as *mut c_void); }; Ok(bytes) } string_set_get!( get_filename, set_filename, MagickGetFilename, MagickSetFilename get_font, set_font, MagickGetFont, MagickSetFont get_format, set_format, MagickGetFormat, MagickSetFormat get_image_filename, set_image_filename, MagickGetImageFilename, MagickSetImageFilename get_image_format, set_image_format, MagickGetImageFormat, MagickSetImageFormat ); set_get!( get_colorspace, set_colorspace, MagickGetColorspace, MagickSetColorspace, u32 get_compression, set_compression, MagickGetCompression, MagickSetCompression, u32 get_compression_quality, set_compression_quality, MagickGetCompressionQuality, MagickSetCompressionQuality, size_t get_gravity, set_gravity, MagickGetGravity, MagickSetGravity, u32 get_image_colorspace, set_image_colorspace, MagickGetImageColorspace, MagickSetImageColorspace, u32 get_image_compose, set_image_compose, MagickGetImageCompose, MagickSetImageCompose, u32 get_image_compression, set_image_compression, MagickGetImageCompression, MagickSetImageCompression, u32 get_image_compression_quality, set_image_compression_quality, MagickGetImageCompressionQuality, MagickSetImageCompressionQuality, size_t get_image_delay, set_image_delay, MagickGetImageDelay, MagickSetImageDelay, size_t get_image_depth, set_image_depth, MagickGetImageDepth, MagickSetImageDepth, size_t get_image_dispose, set_image_dispose, MagickGetImageDispose, MagickSetImageDispose, u32 get_image_endian, set_image_endian, MagickGetImageEndian, MagickSetImageEndian, u32 get_image_fuzz, set_image_fuzz, MagickGetImageFuzz, MagickSetImageFuzz, f64 get_image_gamma, set_image_gamma, MagickGetImageGamma, MagickSetImageGamma, f64 get_image_gravity, set_image_gravity, MagickGetImageGravity, MagickSetImageGravity, u32 get_image_index, set_image_index, MagickGetImageIndex, MagickSetImageIndex, ssize_t get_image_interlace_scheme, set_image_interlace_scheme, MagickGetImageInterlaceScheme, MagickSetImageInterlaceScheme, u32 get_image_interpolate_method, set_image_interpolate_method, MagickGetImageInterpolateMethod, MagickSetImageInterpolateMethod, u32 get_image_iterations, set_image_iterations, MagickGetImageIterations, MagickSetImageIterations, size_t get_image_orientation, set_image_orientation, MagickGetImageOrientation, MagickSetImageOrientation, u32 get_image_rendering_intent, set_image_rendering_intent, MagickGetImageRenderingIntent, MagickSetImageRenderingIntent, u32 get_image_scene, set_image_scene, MagickGetImageScene, MagickSetImageScene, size_t get_image_type, set_image_type, MagickGetImageType, MagickSetImageType, u32 get_image_units, set_image_units, MagickGetImageUnits, MagickSetImageUnits, u32 get_interlace_scheme, set_interlace_scheme, MagickGetInterlaceScheme, MagickSetInterlaceScheme, u32 get_interpolate_method, set_interpolate_method, MagickGetInterpolateMethod, MagickSetInterpolateMethod, u32 get_iterator_index, set_iterator_index, MagickGetIteratorIndex, MagickSetIteratorIndex, ssize_t get_orientation, set_orientation, MagickGetOrientation, MagickSetOrientation, u32 get_pointsize, set_pointsize, MagickGetPointsize, MagickSetPointsize, f64 get_type, set_type, MagickGetType, MagickSetType, u32 ); } impl fmt::Debug for MagickWand { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { try!(writeln!(f, "MagickWand {{")); try!(writeln!(f, " Exception: {:?}", self.get_exception())); try!(writeln!(f, " IsWand: {:?}", self.is_wand())); try!(self.fmt_string_settings(f, " ")); try!(self.fmt_checked_settings(f, " ")); writeln!(f, "}}") } }