cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1 | Introduction to ImageMagick |
| 2 | |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 3 | ImageMagick® is a software suite to create, edit, and compose bitmap |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 4 | images. It can read, convert and write images in a variety of formats |
| 5 | (over 100) including DPX, EXR, GIF, JPEG, JPEG-2000, PDF, PhotoCD, PNG, |
| 6 | Postscript, SVG, and TIFF. Use ImageMagick to translate, flip, mirror, |
| 7 | rotate, scale, shear and transform images, adjust image colors, apply various |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 8 | special effects, or draw text, lines, polygons, ellipses and Bézier curves. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 9 | |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 10 | The functionality of ImageMagick is typically utilized from the command |
| 11 | line or you can use the features from programs written in your favorite |
| 12 | programming language. Choose from these interfaces: G2F (Ada), MagickCore |
| 13 | (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ |
| 14 | (C++), JMagick (Java), L-Magick (Lisp), NMagick (Neko/haXe), MagickNet |
| 15 | (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP |
| 16 | (PHP), IMagick (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick |
| 17 | (Tcl/TK). With a language interface, use ImageMagick to modify or create |
| 18 | images dynamically and automagically. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 19 | |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 20 | ImageMagick is free software delivered as a ready-to-run binary distribution |
cristy | 1bd5c4d | 2010-06-11 13:55:20 +0000 | [diff] [blame] | 21 | or as source code that you may freely use, copy, modify, and distribute in |
| 22 | both open and proprietary applications. It is distributed under an Apache |
| 23 | 2.0-style license, approved by the OSI. |
| 24 | |
| 25 | The ImageMagick development process ensures a stable API and ABI. Before |
| 26 | each ImageMagick release, we perform a comprehensive security assessment |
| 27 | that includes memory and thread error detection to help prevent exploits. |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 28 | |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 29 | Features and Capabilities |
| 30 | |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 31 | Here are just a few examples of what ImageMagick can do: |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 32 | |
| 33 | * Format conversion: convert an image from one format to another (e.g. PNG |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 34 | to JPEG). |
| 35 | * Transform: resize, rotate, crop, flip or trim an image. |
| 36 | * Transparency: render portions of an image invisible. |
| 37 | * Draw: add shapes or text to an image. |
| 38 | * Decorate: add a border or frame to an image. |
| 39 | * Special effects: blur, sharpen, threshold, or tint an image. |
| 40 | * Animation: create a GIF animation sequence from a group of images. |
| 41 | * Text & comments: insert descriptive or artistic text in an image. |
| 42 | * Image identification: describe the format and attributes of an image. |
| 43 | * Composite: overlap one image over another. |
| 44 | * Montage: juxtapose image thumbnails on an image canvas. |
cristy | 1bd5c4d | 2010-06-11 13:55:20 +0000 | [diff] [blame] | 45 | * Generalized pixel distortion: correct for, or induce image distortions |
| 46 | including perspective. |
| 47 | * Morphology of shapes: extract features, describe shapes and recognize |
| 48 | patterns in images. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 49 | * Motion picture support: read and write the common image formats used in |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 50 | digital film work. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 51 | * Image calculator: apply a mathematical expression to an image or image |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 52 | channels. |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 53 | * Discrete Fourier transform: implements the forward and inverse DFT. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 54 | * High dynamic-range images: accurately represent the wide range of |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 55 | intensity levels found in real scenes ranging from the brightest direct |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 56 | sunlight to the deepest darkest shadows. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 57 | * Encipher or decipher an image: convert ordinary images into |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 58 | unintelligible gibberish and back again. |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 59 | * Virtual pixel support: convenient access to pixels outside the image |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 60 | region. |
| 61 | * Large image support: read, process, or write mega-, giga-, or tera-pixel |
| 62 | image sizes. |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 63 | * Threads of execution support: ImageMagick is thread safe and most |
| 64 | internal algorithms are OpenMP-enabled to take advantage of speed-ups |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 65 | offered by multicore processor chips. |
cristy | 5949beb | 2010-01-14 02:04:40 +0000 | [diff] [blame] | 66 | * Heterogeneous distributed processing: certain algorithms are |
| 67 | OpenCL-enabled to take advantage of speed-ups offered by executing in |
| 68 | concert across heterogeneous platforms consisting of CPUs, GPUs, and |
| 69 | other processors. |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 70 | * ImageMagick on the iPhone: convert, edit, or compose images on your |
| 71 | iPhone. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 72 | |
cristy | ad8e761 | 2010-07-03 17:42:01 +0000 | [diff] [blame] | 73 | Examples of ImageMagick Usage shows how to use ImageMagick from the |
| 74 | command-line to accomplish any of these tasks and much more. Also, |
| 75 | see Fred's ImageMagick Scripts: a plethora of command-line scripts that |
| 76 | perform geometric transforms, blurs, sharpens, edging, noise removal, |
cristy | c1c6166 | 2009-09-30 14:04:37 +0000 | [diff] [blame] | 77 | and color manipulations. |
cristy | 52bf953 | 2010-08-04 22:57:14 +0000 | [diff] [blame] | 78 | |