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