blob: 070869f548b62a949b7475c3b6f695903a417560 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001Introduction to ImageMagick
2
cristye99fd5c2009-12-02 01:54:25 +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
cristye99fd5c2009-12-02 01:54:25 +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
21 or as source code that you may freely use, copy, modify, and distribute. Its
22 license is compatible with the GPL. It runs on all major operating systems.
23
cristy3ed852e2009-09-05 21:47:34 +000024Features and Capabilities
25
cristyc1c61662009-09-30 14:04:37 +000026 Here are just a few examples of what ImageMagick can do:
cristy3ed852e2009-09-05 21:47:34 +000027
28 * Format conversion: convert an image from one format to another (e.g. PNG
29 to JPEG)
30 * Transform: resize, rotate, crop, flip or trim an image
31 * Transparency: render portions of an image invisible
32 * Draw: add shapes or text to an image
33 * Decorate: add a border or frame to an image
34 * Special effects: blur, sharpen, threshold, or tint an image
35 * Animation: create a GIF animation sequence from a group of images
36 * Text & comments: insert descriptive or artistic text in an image
37 * Image identification: describe the format and properties of an image
38 * Composite: overlap one image over another
39 * Montage: juxtapose image thumbnails on an image canvas
40 * Motion picture support: read and write the common image formats used in
41 digital film work
42 * Image calculator: apply a mathematical expression to an image or image
43 channels
cristyc1c61662009-09-30 14:04:37 +000044 * Discrete Fourier transform: implements the forward and inverse DFT.
cristy3ed852e2009-09-05 21:47:34 +000045 * High dynamic-range images: accurately represent the wide range of
cristyc1c61662009-09-30 14:04:37 +000046 intensity levels found in real scenes ranging from the brightest direct
cristy3ed852e2009-09-05 21:47:34 +000047 sunlight to the deepest darkest shadows
cristy3ed852e2009-09-05 21:47:34 +000048 * Encipher or decipher an image: convert ordinary images into
49 unintelligible gibberish and back again
cristyc1c61662009-09-30 14:04:37 +000050 * Virtual pixel support: convenient access to pixels outside the image
51 region
52 * Large image support: read, process, or write mebi- and gibi-pixel image
53 sizes
54 * Threads of execution support: ImageMagick is thread safe and most
55 internal algorithms are OpenMP-enabled to take advantage of speed-ups
cristy3ed852e2009-09-05 21:47:34 +000056 offered by the dual and quad-core processor technologies
cristy5949beb2010-01-14 02:04:40 +000057 * Heterogeneous distributed processing: certain algorithms are
58 OpenCL-enabled to take advantage of speed-ups offered by executing in
59 concert across heterogeneous platforms consisting of CPUs, GPUs, and
60 other processors.
cristy3ed852e2009-09-05 21:47:34 +000061
cristyc1c61662009-09-30 14:04:37 +000062 Examples of ImageMagick Usage, http://www.imagemagick.org/Usage/,
63 shows how to use ImageMagick from the command-line to accomplish any
64 of these tasks and much more. Also, see Fred's ImageMagick Scripts at
65 http://www.fmwconcepts.com/imagemagick/, a plethora of command-line scripts
66 that perform geometric transforms, blurs, sharpens, edging, noise removal,
67 and color manipulations.