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