cristy | 59348c2 | 2015-07-23 11:15:13 +0000 | [diff] [blame] | 1 | ImageMagick |
| 2 | =========== |
| 3 | |
cristy | 3794da3 | 2015-07-23 11:19:38 +0000 | [diff] [blame] | 4 | <p align="center"> |
cristy | 59348c2 | 2015-07-23 11:15:13 +0000 | [diff] [blame] | 5 | <img align="center" src="http://www.imagemagick.org/image/wizard.png" alt="ImageMagick logo" width="265"/> |
| 6 | |
cristy | 4438734 | 2015-07-23 11:38:05 +0000 | [diff] [blame^] | 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. |
cristy | 59348c2 | 2015-07-23 11:15:13 +0000 | [diff] [blame] | 8 | |
| 9 | |
dirk | ff776cc | 2015-06-17 15:22:12 +0000 | [diff] [blame] | 10 | | Version | *nix | Windows | |
| 11 | | ------------- | ------------- | ------------- | |
dirk | c6ca06c | 2015-06-17 15:38:10 +0000 | [diff] [blame] | 12 | | 7 | [](https://travis-ci.org/ImageMagick/ImageMagick) | [](https://ci.appveyor.com/project/dlemstra/imagemagick-windows/branch/master) | |
| 13 | | 6 | [](https://travis-ci.org/ImageMagick/ImageMagick) | [](https://ci.appveyor.com/project/dlemstra/imagemagick-windows/branch/ImageMagick-Windows-6) | |
dirk | 7a1d070 | 2015-06-06 11:17:51 +0000 | [diff] [blame] | 14 | |
cristy | 59348c2 | 2015-07-23 11:15:13 +0000 | [diff] [blame] | 15 | ####What is ImageMagick? |
dirk | 7a1d070 | 2015-06-06 11:17:51 +0000 | [diff] [blame] | 16 | |
cristy | a0ef2ec | 2015-07-21 12:31:20 +0000 | [diff] [blame] | 17 | The 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. |
dirk | 7a1d070 | 2015-06-06 11:17:51 +0000 | [diff] [blame] | 18 | |
cristy | a0ef2ec | 2015-07-21 12:31:20 +0000 | [diff] [blame] | 19 | ImageMagick utilizes multiple computational threads to increase performance and can read, process, or write mega-, giga-, or tera-pixel image sizes. |
dirk | 7a1d070 | 2015-06-06 11:17:51 +0000 | [diff] [blame] | 20 | |
cristy | 4438734 | 2015-07-23 11:38:05 +0000 | [diff] [blame^] | 21 | ImageMagick 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). |
cristy | a0ef2ec | 2015-07-21 12:31:20 +0000 | [diff] [blame] | 22 | |
| 23 | The 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 | |
| 25 | ImageMagick is available from http://www.imagemagick.org/download to download. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others. |
| 26 | |
| 27 | The authoritative ImageMagick web site is http://www.imagemagick.org. The authoritative source code repository is https://subversion.imagemagick.org/subversion/ImageMagick/. |
dirk | 7a1d070 | 2015-06-06 11:17:51 +0000 | [diff] [blame] | 28 | |
cristy | 59348c2 | 2015-07-23 11:15:13 +0000 | [diff] [blame] | 29 | ####Features and Capabilities |
cristy | a0ef2ec | 2015-07-21 12:31:20 +0000 | [diff] [blame] | 30 | |
| 31 | Here 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 identification](http://www.imagemagick.org/script/identify.php): describe the format and attributes of an image. |
| 42 | * [Composite](http://www.imagemagick.org/script/composite.php): overlap one image over another. |
| 43 | * [Montage](http://www.imagemagick.org/script/montage.php): juxtapose image thumbnails on an image canvas. |
| 44 | * [Generalized pixel distortion](http://www.imagemagick.org/Usage/distorts/): correct for, or induce image distortions including perspective. |
| 45 | * [Morphology of shapes](http://www.imagemagick.org/Usage/morphology/): extract features, describe shapes and recognize patterns in images. |
cristy | 4c7fd76 | 2015-07-21 13:04:18 +0000 | [diff] [blame] | 46 | * [Delineate image features](http://www.imagemagick.org/Usage/transform/#vision): Canny edge detection, mean-shift, Hough lines. |
cristy | a0ef2ec | 2015-07-21 12:31:20 +0000 | [diff] [blame] | 47 | * [Motion picture support](http://www.imagemagick.org/script/motion-picture.php): read and write the common image formats used in digital film work. |
| 48 | * [Image calculator](http://www.imagemagick.org/script/fx.php): apply a mathematical expression to an image or image channels. |
| 49 | * [Connected component labeling](http://www.imagemagick.org/script/connected-components.php): uniquely label connected regions in an image. |
| 50 | * [Discrete Fourier transform](http://www.imagemagick.org/Usage/fourier/): implements the forward and inverse [DFT](http://en.wikipedia.org/wiki/Discrete_Fourier_transform). |
| 51 | * [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. |
| 52 | * [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. |
| 53 | * [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. |
| 54 | * [Encipher or decipher an image](http://www.imagemagick.org/script/cipher.php): convert ordinary images into unintelligible gibberish and back again. |
| 55 | * [Virtual pixel support](http://www.imagemagick.org/script/architecture.php#virtual-pixels): convenient access to pixels outside the image region. |
| 56 | * [Large image support](http://www.imagemagick.org/script/architecture.php#tera-pixel): read, process, or write mega-, giga-, or tera-pixel image sizes. |
| 57 | * [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. |
| 58 | * [Distributed pixel cache](http://www.imagemagick.org/script/distribute-pixel-cache.php): offload intermediate pixel storage to one or more remote servers. |
| 59 | * [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. |
| 60 | * [ImageMagick on the iPhone](http://www.imagemagick.org/script/binary-releases.php#iOS): convert, edit, or compose images on your iPhone. |
| 61 | |
| 62 | [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. |