ImageMagick: MagickCore, C API for ImageMagick: Transform an Image
Author: ImageMagick Studio LLC
Description: ImageMagick (TM) is a free software suite to create, edit and compose bitmap images. It can read, convert and write images in a large variety of formats. Images can be cropped, colors can be changed, various effects can be applied, images can be rotated and combined, and text, lines, polygons, ellipses and Bézier curves can be added to images and stretched and rotated. ImageMagick is free software: it is delivered with full source code and can be freely used, copied, modified and distributed. Its license is compatible with the GPL. It runs on all major operating systems. Most of the functionality of ImageMagick can be used interactively from the command line; more often, however, the features are used from programs written in the programming languages Perl, C, C++, Python, PHP, Ruby or Java, for which ready-made ImageMagick interfaces (PerlMagick, Magick++, PythonMagick, MagickWand for PHP, RubyMagick, and JMagick) are available. This makes it possible to modify or create images automa [cell cut: 1159 characters, first 1000 kept]
Keywords: magickcore, c, api, for, imagemagick:, transform, an, image, ImageMagick, PerlMagick, Magick++, Image, Magick

## Chop Chop() removes a region of an image and collapses the image to occupy the removed portion. The format of the ChopImage method is:
      Image *ChopImage(const Image *image,const RectangleInfo *chop_info)
        ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### chop_info Define the region of the image to chop. #### exception Return any errors or warnings in this structure. ## CoalesceImages CoalesceImages() composites a set of images while respecting any page offsets and disposal methods. GIF, MIFF, and MNG animation sequences typically start with an image background and each subsequent image varies in size and offset. CoalesceImages() returns a new sequence where each image in the sequence is the same size as the first and composited with the next image in the sequence. The format of the CoalesceImages method is:
      Image *CoalesceImages(Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image sequence. #### exception Return any errors or warnings in this structure. ## CropImage CropImage() extracts a region of the image starting at the offset defined by geometry. The format of the CropImage method is:
      Image *CropImage(const Image *image,const RectangleInfo *geometry,
        ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### geometry Define the region of the image to crop with members x, y, width, and height. #### exception Return any errors or warnings in this structure. ## DeconstructImages DeconstructImages() compares each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers. The format of the DeconstructImages method is:
      Image *DeconstructImages(const Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### exception Return any errors or warnings in this structure. ## FlattenImage FlattenImage() composites all images from the current image pointer to the end of the image list and returns a single flattened image. The format of the FlattenImage method is:
      Image *FlattenImage(Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image sequence. #### exception Return any errors or warnings in this structure. ## FlipImage FlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis. The format of the FlipImage method is:
      Image *FlipImage(const Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### exception Return any errors or warnings in this structure. ## FlopImage FlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis. The format of the FlopImage method is:
      Image *FlopImage(const Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### exception Return any errors or warnings in this structure. ## MosaicImages MosaicImages() inlays an image sequence to form a single coherent picture. It returns a single image with each image in the sequence composited at the location defined by the page member of the image structure. The format of the MosaicImage method is:
      Image *MosaicImages(const Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### exception Return any errors or warnings in this structure. ## RollImage RollImage() offsets an image as defined by x_offset and y_offset. The format of the RollImage method is:
      Image *RollImage(const Image *image,const long x_offset,
        const long y_offset,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### x_offset The number of columns to roll in the horizontal direction. #### y_offset The number of rows to roll in the vertical direction. #### exception Return any errors or warnings in this structure. ## ShaveImage ShaveImage() shaves pixels from the image edges. It allocates the memory necessary for the new Image structure and returns a pointer to the new image. The format of the ShaveImage method is:
      Image *ShaveImage(const Image *image,const RectangleInfo *shave_info,
        ExceptionInfo *exception)
A description of each parameter follows: #### shave_image Method ShaveImage returns a pointer to the shaved image. A null image is returned if there is a memory shortage or if the image width or height is zero. #### image The image. #### shave_info Specifies a pointer to a RectangleInfo which defines the region of the image to crop. #### exception Return any errors or warnings in this structure. ## SpliceImage SpliceImage() splices a solid color into the image as defined by the geometry. The format of the SpliceImage method is:
      Image *SpliceImage(const Image *image,const RectangleInfo *geometry,
        ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### geometry Define the region of the image to splice with members x, y, width, and height. #### exception Return any errors or warnings in this structure. ## TransformImage TransformImage() is a convenience method that behaves like ResizeImage() or CropImage() but accepts scaling and/or cropping information as a region geometry specification. If the operation fails, the original image handle is returned. The format of the TransformImage method is:
      MagickBooleanType TransformImage(Image **image,const char *crop_geometry,
        const char *image_geometry)
A description of each parameter follows: #### image The image The transformed image is returned as this parameter. #### crop_geometry A crop geometry string. This geometry defines a subregion of the image to crop. #### image_geometry An image geometry string. This geometry defines the final size of the image. ## TransformImages TransformImages() calls TransformImage() on each image of a sequence. The format of the TransformImage method is:
      MagickBooleanType TransformImages(Image **image,
        const char *crop_geometry,const char *image_geometry)
A description of each parameter follows: #### image The image The transformed image is returned as this parameter. #### crop_geometry A crop geometry string. This geometry defines a subregion of the image to crop. #### image_geometry An image geometry string. This geometry defines the final size of the image. ## TrimImage TrimImage() trims pixels from the image edges. It allocates the memory necessary for the new Image structure and returns a pointer to the new image. The format of the TrimImage method is:
      Image *TrimImage(const Image *image,ExceptionInfo *exception)
A description of each parameter follows: #### image The image. #### exception Return any errors or warnings in this structure. |

Discourse Server | Mailing Lists | Image Gallery | ImageMagick Studio
© 1999-2006 ImageMagick Studio LLC