]> granicus.if.org Git - imagemagick/blob - README.txt
(no commit message)
[imagemagick] / README.txt
1 Introduction to ImageMagick
2
3   ImageMagick® is a software suite to create, edit, and compose bitmap
4   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
8   special 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   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.
19
20   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 in
22   both open and proprietary applications. It is distributed under an Apache
23   2.0-style license, approved by the OSI.
24
25   The ImageMagick development process ensures a stable API and ABI. Before
26   each ImageMagick release, we perform a comprehensive security assessment
27   that includes memory and thread error detection to help prevent exploits.
28
29 Features and Capabilities
30
31   Here are just a few examples of what ImageMagick can do:
32
33     * Format conversion: convert an image from one format to another (e.g. PNG
34       to JPEG)
35     * Transform: resize, rotate, crop, flip or trim an image
36     * Transparency: render portions of an image invisible
37     * Draw: add shapes or text to an image
38     * Decorate: add a border or frame to an image
39     * Special effects: blur, sharpen, threshold, or tint an image
40     * Animation: create a GIF animation sequence from a group of images
41     * Text & comments: insert descriptive or artistic text in an image
42     * Image identification: describe the format and properties of an image
43     * Composite: overlap one image over another
44     * Montage: juxtapose image thumbnails on an image canvas
45     * Generalized pixel distortion: correct for, or induce image distortions
46       including perspective.
47     * Morphology of shapes: extract features, describe shapes and recognize
48       patterns in images.
49     * Motion picture support: read and write the common image formats used in
50       digital film work
51     * Image calculator: apply a mathematical expression to an image or image
52       channels
53     * Discrete Fourier transform: implements the forward and inverse DFT.
54     * High dynamic-range images: accurately represent the wide range of
55       intensity levels found in real scenes ranging from the brightest direct
56       sunlight to the deepest darkest shadows
57     * Encipher or decipher an image: convert ordinary images into
58       unintelligible gibberish and back again
59     * Virtual pixel support: convenient access to pixels outside the image
60       region
61     * Large image support: read, process, or write mebi- and gibi-pixel image
62       sizes
63     * Threads of execution support: ImageMagick is thread safe and most
64       internal algorithms are OpenMP-enabled to take advantage of speed-ups
65       offered by the dual and quad-core processor technologies
66     * Heterogeneous distributed processing: certain algorithms are
67       OpenCL-enabled to take advantage of speed-ups offered by executing in
68       concert across heterogeneous platforms consisting of CPUs, GPUs, and
69       other processors.
70
71   Examples of ImageMagick Usage, http://www.imagemagick.org/Usage/,
72   shows how to use ImageMagick from the command-line to accomplish any
73   of these tasks and much more. Also, see Fred's ImageMagick Scripts at
74   http://www.fmwconcepts.com/imagemagick/, a plethora of command-line scripts
75   that perform geometric transforms, blurs, sharpens, edging, noise removal,
76   and color manipulations.