README.md
1ImageMagick
2===========
3
4<p align="center">
5<img align="center" src="http://www.imagemagick.org/image/wizard.png" alt="ImageMagick logo" width="265"/>
6
7[ImageMagick®](http://www.imagemagick.org/) is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of [formats](http://www.imagemagick.org/script/formats.php) (over 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.
8
9
10| Version | *nix | Windows |
11| ------------- | ------------- | ------------- |
12| 7 | [![Build Status](https://travis-ci.org/ImageMagick/ImageMagick.svg?branch=master)](https://travis-ci.org/ImageMagick/ImageMagick) | [![Build status](https://ci.appveyor.com/api/projects/status/jk7yr5plamnuh9g6/branch/master?svg=true)](https://ci.appveyor.com/project/dlemstra/imagemagick-windows/branch/master) |
13| 6 | [![Build Status](https://travis-ci.org/ImageMagick/ImageMagick.svg?branch=ImageMagick-6)](https://travis-ci.org/ImageMagick/ImageMagick) | [![Build status](https://ci.appveyor.com/api/projects/status/jk7yr5plamnuh9g6/branch/ImageMagick-Windows-6?svg=true)](https://ci.appveyor.com/project/dlemstra/imagemagick-windows/branch/ImageMagick-Windows-6) |
14
15#### What is ImageMagick?
16
17The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), L-Magick (Lisp), NMagick (Neko/haXe), MagickNet (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), IMagick (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and automagically.
18
19ImageMagick utilizes multiple computational threads to increase performance and can read, process, or write mega-, giga-, or tera-pixel image sizes.
20
21ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 [license](http://www.imagemagick.org/script/license.php).
22
23The ImageMagick development process ensures a stable API and ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to prevent security vulnerabilities.
24
25ImageMagick is available from http://www.imagemagick.org/script/binary-releases.php. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.
26
27The authoritative ImageMagick web site is http://www.imagemagick.org. The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick/.
28
29#### Features and Capabilities
30
31Here are just a few examples of what ImageMagick can do:
32
33* [Format conversion](http://www.imagemagick.org/script/convert.php): convert an image from one [format](http://www.imagemagick.org/script/formats.php) to another (e.g. PNG to JPEG).
34* [Transform](http://www.imagemagick.org/Usage/resize/): resize, rotate, deskew, crop, flip or trim an image.
35* [Transparency](http://www.imagemagick.org/Usage/masking/): render portions of an image invisible.
36* [Draw](http://www.imagemagick.org/Usage/draw/): add shapes or text to an image.
37* [Decorate](http://www.imagemagick.org/Usage/crop/): add a border or frame to an image.
38* [Special effects](http://www.imagemagick.org/Usage/blur/): blur, sharpen, threshold, or tint an image.
39* [Animation](http://www.imagemagick.org/Usage/anim_basics/): create a GIF animation sequence from a group of images.
40* [Text & comments](http://www.imagemagick.org/Usage/text/): insert descriptive or artistic text in an image.
41* [Image gradients](http://www.imagemagick.org/script/gradient.php): create a gradual blend of one color whose shape is horizontal, vertical, circular, or ellipical.
42* [Image identification](http://www.imagemagick.org/script/identify.php): describe the format and attributes of an image.
43* [Composite](http://www.imagemagick.org/script/composite.php): overlap one image over another.
44* [Montage](http://www.imagemagick.org/script/montage.php): juxtapose image thumbnails on an image canvas.
45* [Generalized pixel distortion](http://www.imagemagick.org/Usage/distorts/): correct for, or induce image distortions including perspective.
46* [Morphology of shapes](http://www.imagemagick.org/Usage/morphology/): extract features, describe shapes and recognize patterns in images.
47* [Delineate image features](http://www.imagemagick.org/Usage/transform/#vision): Canny edge detection, mean-shift, Hough lines.
48* [Motion picture support](http://www.imagemagick.org/script/motion-picture.php): read and write the common image formats used in digital film work.
49* [Image calculator](http://www.imagemagick.org/script/fx.php): apply a mathematical expression to an image or image channels.
50* [Connected component labeling](http://www.imagemagick.org/script/connected-components.php): uniquely label connected regions in an image.
51* [Discrete Fourier transform](http://www.imagemagick.org/Usage/fourier/): implements the forward and inverse [DFT](http://en.wikipedia.org/wiki/Discrete_Fourier_transform).
52* [Perceptual hash](http://www.fmwconcepts.com/misc_tests/perceptual_hash_test_results_510/index.html): maps visually identical images to the same or similar hash-- useful in image retrieval, authentication, indexing, or copy detection as well as digital watermarking.
53* [Complex text layout](https://en.wikipedia.org/wiki/Complex_text_layout) bidirectional text support and shaping.
54* [Color management](http://www.imagemagick.org/script/color-management.php): accurate color management with color profiles or in lieu of-- built-in gamma compression or expansion as demanded by the colorspace.
55* [High dynamic-range images](http://www.imagemagick.org/script/high-dynamic-range.php): accurately represent the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows.
56* [Encipher or decipher an image](http://www.imagemagick.org/script/cipher.php): convert ordinary images into unintelligible gibberish and back again.
57* [Virtual pixel support](http://www.imagemagick.org/script/architecture.php#virtual-pixels): convenient access to pixels outside the image region.
58* [Large image support](http://www.imagemagick.org/script/architecture.php#tera-pixel): read, process, or write mega-, giga-, or tera-pixel image sizes.
59* [Threads of execution support](http://www.imagemagick.org/script/architecture.php#threads): ImageMagick is thread safe and most internal algorithms are OpenMP-enabled to take advantage of speed-ups offered by multicore processor chips.
60* [Distributed pixel cache](http://www.imagemagick.org/script/distribute-pixel-cache.php): offload intermediate pixel storage to one or more remote servers.
61* [Heterogeneous distributed processing](http://www.imagemagick.org/script/architecture.php#distributed): certain algorithms are OpenCL-enabled to take advantage of speed-ups offered by executing in concert across heterogeneous platforms consisting of CPUs, GPUs, and other processors.
62* [ImageMagick on the iPhone](http://www.imagemagick.org/script/binary-releases.php#iOS): convert, edit, or compose images on your iPhone.
63
64[Examples of ImageMagick Usage](http://www.imagemagick.org/Usage/), shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see [Fred's ImageMagick Scripts](http://www.fmwconcepts.com/imagemagick/): a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With [Magick.NET](https://magick.codeplex.com/), use ImageMagick without having to install ImageMagick on your server or desktop.
65
66#### News
67
68The design of ImageMagick is an evolutionary process, with the design and implementation efforts serving to influence and guide further progress in the other. With [ImageMagick version 7](http://nextgen.imagemagick.org), we aim to improve the design based on lessons learned from the version 6 implementation. See the [porting](http://www.imagemagick.org/script/porting.php) guide to track the progress of the version 7 development effort.
69
README.txt
1Introduction to ImageMagick
2
3 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.
9
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 language. Choose from these interfaces: G2F (Ada), MagickCore (C),
13 MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++),
14 JMagick (Java), L-Magick (Lisp), Lua, NMagick (Neko/haXe), Magick.NET
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.
19
20 ImageMagick utilizes multiple computational threads to increase performance
21 and can read, process, or write mega-, giga-, or tera-pixel image sizes.
22
23 ImageMagick is free software delivered as a ready-to-run binary distribution
24 or as source code that you may use, copy, modify, and distribute in both open
25 and proprietary applications. It is distributed under the Apache 2.0 license.
26
27 The ImageMagick development process ensures a stable API and ABI. Before
28 each ImageMagick release, we perform a comprehensive security assessment
29 that includes memory error and thread data race detection to prevent
30 security vulnerabilities.
31
32 ImageMagick is available from
33 http://www.imagemagick.org/script/binary-releases.php. It runs on Linux,
34 Windows, Mac Os X, iOS, Android OS, and others.
35
36 The authoritative ImageMagick web site is
37 http://www.imagemagick.org. The authoritative source code repository is
38 http://git.imagemagick.org/repos/ImageMagick/.
39
40
41Features and Capabilities
42
43 Here are just a few examples of what ImageMagick can do:
44
45 * Format conversion: convert an image from one format to another (e.g.
46 PNG to JPEG).
47 * Transform: resize, rotate, deskew, crop, flip or trim an image.
48 * Transparency: render portions of an image invisible.
49 * Draw: add shapes or text to an image.
50 * Decorate: add a border or frame to an image.
51 * Special effects: blur, sharpen, threshold, or tint an image.
52 * Animation: create a GIF animation sequence from a group of images.
53 * Text & comments: insert descriptive or artistic text in an image.
54 * Image gradients: create a gradual blend of one color whose shape is
55 horizontal, vertical, circular, or ellipical.
56 * Image identification: describe the format and attributes of an image.
57 * Composite: overlap one image over another.
58 * Montage: juxtapose image thumbnails on an image canvas.
59 * Generalized pixel distortion: correct for, or induce image distortions
60 including perspective.
61 * Computer vision: Canny edge detection.
62 * Morphology of shapes: extract features, describe shapes and recognize
63 patterns in images.
64 * Motion picture support: read and write the common image formats used in
65 digital film work.
66 * Image calculator: apply a mathematical expression to an image or image
67 channels.
68 * Connected component labeling: uniquely label connected regions in an
69 image.
70 * Discrete Fourier transform: implements the forward and inverse DFT.
71 * Perceptual hash: maps visually identical images to the same or similar
72 hash-- useful in image retrieval, authentication, indexing, or copy
73 detection as well as digital watermarking.
74 * Complex text layout: bidirectional text support and shaping.
75 * Color management: accurate color management with color profiles or in
76 lieu of-- built-in gamma compression or expansion as demanded by the
77 colorspace.
78 * High dynamic-range images: accurately represent the wide range of
79 intensity levels found in real scenes ranging from the brightest direct
80 sunlight to the deepest darkest shadows.
81 * Encipher or decipher an image: convert ordinary images into
82 unintelligible gibberish and back again.
83 * Virtual pixel support: convenient access to pixels outside the image
84 region.
85 * Large image support: read, process, or write mega-, giga-, or
86 tera-pixel image sizes.
87 * Threads of execution support: ImageMagick is thread safe and most
88 internal algorithms are OpenMP-enabled to take advantage of speed-ups
89 offered by multicore processor chips.
90 * Distributed pixel cache: offload intermediate pixel storage to one or
91 more remote servers.
92 * Heterogeneous distributed processing: certain algorithms are
93 OpenCL-enabled to take advantage of speed-ups offered by executing in
94 concert across heterogeneous platforms consisting of CPUs, GPUs, and
95 other processors.
96 * ImageMagick on the iPhone: convert, edit, or compose images on your
97 iPhone or iPad.
98
99 Examples of ImageMagick Usage shows how to use ImageMagick from the
100 command-line to accomplish any of these tasks and much more. Also,
101 see Fred's ImageMagick Scripts: a plethora of command-line scripts that
102 perform geometric transforms, blurs, sharpens, edging, noise removal,
103 and color manipulations. With Magick.NET, use ImageMagick without having
104 to install ImageMagick on your server or desktop.
105
106