blob: 6572b3c5fe026a54bb72534d3924848885717350 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001Introduction to ImageMagick
2
cristye68f5992015-03-03 17:44:51 +00003 ImageMagick® is a software suite to create, edit, compose, or convert
4 bitmap images. It can read and write images in a variety of formats (over
5 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript,
6 PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort,
7 shear and transform images, adjust image colors, apply various special
8 effects, or draw text, lines, polygons, ellipses and Bézier curves.
cristya1410932010-11-06 18:16:16 +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.
cristya1410932010-11-06 18:16:16 +000019
cristyc1c61662009-09-30 14:04:37 +000020 ImageMagick is free software delivered as a ready-to-run binary distribution
cristya1410932010-11-06 18:16:16 +000021 or as source code that you may freely use, copy, modify, and distribute
22 in both open and proprietary applications. It is distributed under the
23 Apache 2.0 license, approved by the OSI and recommended for use by the OSSCC.
24
cristy1bd5c4d2010-06-11 13:55:20 +000025 The ImageMagick development process ensures a stable API and ABI. Before
26 each ImageMagick release, we perform a comprehensive security assessment
cristya1410932010-11-06 18:16:16 +000027 that includes memory and thread error detection to prevent security
28 vulnerabilities.
cristyc1c61662009-09-30 14:04:37 +000029
cristye68f5992015-03-03 17:44:51 +000030 ImageMagick is available from http://www.imagemagick.org/download to
31 download. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.
32
33 The authoritative ImageMagick web site is http://www.imagemagick.org.
34
35
cristy3ed852e2009-09-05 21:47:34 +000036Features and Capabilities
cristya1410932010-11-06 18:16:16 +000037
cristyc1c61662009-09-30 14:04:37 +000038 Here are just a few examples of what ImageMagick can do:
cristya1410932010-11-06 18:16:16 +000039
40 * Format conversion: convert an image from one format to another (e.g.
41 PNG to JPEG).
42 * Transform: resize, rotate, crop, flip or trim an image.
43 * Transparency: render portions of an image invisible.
44 * Draw: add shapes or text to an image.
45 * Decorate: add a border or frame to an image.
46 * Special effects: blur, sharpen, threshold, or tint an image.
47 * Animation: create a GIF animation sequence from a group of images.
48 * Text & comments: insert descriptive or artistic text in an image.
49 * Image identification: describe the format and attributes of an image.
50 * Composite: overlap one image over another.
51 * Montage: juxtapose image thumbnails on an image canvas.
52 * Generalized pixel distortion: correct for, or induce image distortions
53 including perspective.
cristy698968d2014-04-11 16:39:25 +000054 * Computer vision: Canny edge detection.
cristya1410932010-11-06 18:16:16 +000055 * Morphology of shapes: extract features, describe shapes and recognize
56 patterns in images.
57 * Motion picture support: read and write the common image formats used in
58 digital film work.
59 * Image calculator: apply a mathematical expression to an image or image
60 channels.
cristy4bc91a12014-12-27 01:45:49 +000061 * Connected component labeling: uniquely label connected regions in an
62 image.
cristya1410932010-11-06 18:16:16 +000063 * Discrete Fourier transform: implements the forward and inverse DFT.
cristydf6cf212014-01-29 18:06:41 +000064 * Perceptual hash: maps visually identical images to the same or similar
cristyeab3d612014-01-29 18:09:51 +000065 hash-- useful in image retrieval, authentication, indexing, or copy
66 detection as well as digital watermarking.
cristy48002432014-01-29 15:31:47 +000067 * Color management: accurate color management with color profiles or in
68 lieu of-- built-in gamma compression or expansion as demanded by the
69 colorspace.
cristya1410932010-11-06 18:16:16 +000070 * High dynamic-range images: accurately represent the wide range of
71 intensity levels found in real scenes ranging from the brightest direct
72 sunlight to the deepest darkest shadows.
73 * Encipher or decipher an image: convert ordinary images into
74 unintelligible gibberish and back again.
75 * Virtual pixel support: convenient access to pixels outside the image
76 region.
77 * Large image support: read, process, or write mega-, giga-, or
78 tera-pixel image sizes.
79 * Threads of execution support: ImageMagick is thread safe and most
80 internal algorithms are OpenMP-enabled to take advantage of speed-ups
81 offered by multicore processor chips.
cristy37aa5592013-01-27 22:59:34 +000082 * Distributed pixel cache: offload intermediate pixel storage to one or
83 more remote servers.
cristya1410932010-11-06 18:16:16 +000084 * Heterogeneous distributed processing: certain algorithms are
85 OpenCL-enabled to take advantage of speed-ups offered by executing in
86 concert across heterogeneous platforms consisting of CPUs, GPUs, and
87 other processors.
88 * ImageMagick on the iPhone: convert, edit, or compose images on your
89 iPhone.
90
91 Examples of ImageMagick Usage, http://www.imagemagick.org/Usage/, shows how
92 to use ImageMagick from the command-line to accomplish any of these tasks and
93 much more. Also, see Fred's ImageMagick Scripts,
94 http://www.fmwconcepts.com/imagemagick/: a plethora of command-line scripts
95 that perform geometric transforms, blurs, sharpens, edging, noise removal,
cristyc1c61662009-09-30 14:04:37 +000096 and color manipulations.
cristy4bc91a12014-12-27 01:45:49 +000097