blob: 34f64b88cef58c8344a7745748931cad44b43054 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001Introduction to ImageMagick
2
cristyad8e7612010-07-03 17:42:01 +00003 ImageMagick® is a software suite to create, edit, and compose bitmap
cristyc1c61662009-09-30 14:04:37 +00004 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
cristyad8e7612010-07-03 17:42:01 +00008 special effects, or draw text, lines, polygons, ellipses and Bézier curves.
cristy3ed852e2009-09-05 21:47:34 +00009
cristyc1c61662009-09-30 14:04:37 +000010 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.
cristy3ed852e2009-09-05 21:47:34 +000019
cristyc1c61662009-09-30 14:04:37 +000020 ImageMagick is free software delivered as a ready-to-run binary distribution
cristy1bd5c4d2010-06-11 13:55:20 +000021 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.
cristyc1c61662009-09-30 14:04:37 +000028
cristy3ed852e2009-09-05 21:47:34 +000029Features and Capabilities
30
cristyc1c61662009-09-30 14:04:37 +000031 Here are just a few examples of what ImageMagick can do:
cristy3ed852e2009-09-05 21:47:34 +000032
33 * Format conversion: convert an image from one format to another (e.g. PNG
cristyad8e7612010-07-03 17:42:01 +000034 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.
cristy1bd5c4d2010-06-11 13:55:20 +000045 * 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.
cristy3ed852e2009-09-05 21:47:34 +000049 * Motion picture support: read and write the common image formats used in
cristyad8e7612010-07-03 17:42:01 +000050 digital film work.
cristy3ed852e2009-09-05 21:47:34 +000051 * Image calculator: apply a mathematical expression to an image or image
cristyad8e7612010-07-03 17:42:01 +000052 channels.
cristyc1c61662009-09-30 14:04:37 +000053 * Discrete Fourier transform: implements the forward and inverse DFT.
cristy3ed852e2009-09-05 21:47:34 +000054 * High dynamic-range images: accurately represent the wide range of
cristyc1c61662009-09-30 14:04:37 +000055 intensity levels found in real scenes ranging from the brightest direct
cristyad8e7612010-07-03 17:42:01 +000056 sunlight to the deepest darkest shadows.
cristy3ed852e2009-09-05 21:47:34 +000057 * Encipher or decipher an image: convert ordinary images into
cristyad8e7612010-07-03 17:42:01 +000058 unintelligible gibberish and back again.
cristyc1c61662009-09-30 14:04:37 +000059 * Virtual pixel support: convenient access to pixels outside the image
cristyad8e7612010-07-03 17:42:01 +000060 region.
61 * Large image support: read, process, or write mega-, giga-, or tera-pixel
62 image sizes.
cristyc1c61662009-09-30 14:04:37 +000063 * Threads of execution support: ImageMagick is thread safe and most
64 internal algorithms are OpenMP-enabled to take advantage of speed-ups
cristyad8e7612010-07-03 17:42:01 +000065 offered by multicore processor chips.
cristy5949beb2010-01-14 02:04:40 +000066 * 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.
cristyad8e7612010-07-03 17:42:01 +000070 * ImageMagick on the iPhone: convert, edit, or compose images on your
71 iPhone.
cristy3ed852e2009-09-05 21:47:34 +000072
cristyad8e7612010-07-03 17:42:01 +000073 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,
cristyc1c61662009-09-30 14:04:37 +000077 and color manipulations.
cristy52bf9532010-08-04 22:57:14 +000078