README.txt 7.31 KB
Newer Older
cristy's avatar
cristy committed
1 2
Introduction to ImageMagick

cristy's avatar
cristy committed
3 4
  ImageMagick® is a software suite to create, edit, compose, or convert
  bitmap images. It can read and write images in a variety of formats (over
Cristy's avatar
Cristy committed
5
  200) including PNG, JPEG, GIF, HEIC, TIFF, DPX, EXR, WebP, Postscript,
cristy's avatar
cristy committed
6
  PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort,
cristy's avatar
cristy committed
7 8
  shear and transform images, adjust image colors, apply various special
  effects, or draw text, lines, polygons, ellipses and Bézier curves.
cristy's avatar
cristy committed
9
  
cristy's avatar
cristy committed
10 11
  The functionality of ImageMagick is typically utilized from the command
  line or you can use the features from programs written in your favorite
cristy's avatar
cristy committed
12 13 14
  language. Choose from these interfaces: G2F (Ada), MagickCore (C),
  MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++),
  JMagick (Java), L-Magick (Lisp), Lua, NMagick (Neko/haXe), Magick.NET
cristy's avatar
cristy committed
15 16 17 18
  (.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.
cristy's avatar
cristy committed
19

dirk's avatar
dirk committed
20
  ImageMagick utilizes multiple computational threads to increase performance
cristy's avatar
cristy committed
21
  and can read, process, or write mega-, giga-, or tera-pixel image sizes.
cristy's avatar
cristy committed
22
  
cristy's avatar
cristy committed
23
  ImageMagick is free software delivered as a ready-to-run binary distribution
cristy's avatar
cristy committed
24
  or as source code that you may use, copy, modify, and distribute in both open
25 26
  and proprietary applications. It is distributed under a derived Apache 2.0
  license.
cristy's avatar
cristy committed
27
  
cristy's avatar
cristy committed
28 29
  The ImageMagick development process ensures a stable API and ABI. Before
  each ImageMagick release, we perform a comprehensive security assessment
cristy's avatar
cristy committed
30 31
  that includes memory error and thread data race detection to prevent
  security vulnerabilities.
cristy's avatar
cristy committed
32

Cristy's avatar
Cristy committed
33 34
  The current release is the ImageMagick 7.0.8-* series. It runs on Linux,
  Windows, Mac Os X, iOS, Android OS, and others.
cristy's avatar
cristy committed
35

Cristy's avatar
Cristy committed
36
  The authoritative ImageMagick web site is https://imagemagick.org. The
Cristy's avatar
Cristy committed
37 38
  authoritative source code repository is https://github.com/ImageMagick. We
  maintain a source code mirror at https://gitlab.com/ImageMagick.
cristy's avatar
cristy committed
39

Cristy's avatar
Cristy committed
40 41 42
  We continue to maintain the legacy release of ImageMagick, version 6,
  at https://legacy.imagemagick.org.

cristy's avatar
cristy committed
43

cristy's avatar
cristy committed
44
Features and Capabilities
cristy's avatar
cristy committed
45
  
cristy's avatar
cristy committed
46
  Here are just a few examples of what ImageMagick can do:
cristy's avatar
cristy committed
47 48 49
  
      * Format conversion: convert an image from one format to another (e.g.
        PNG to JPEG).
cristy's avatar
cristy committed
50
      * Transform: resize, rotate, deskew, crop, flip or trim an image.
cristy's avatar
cristy committed
51 52 53 54 55 56
      * Transparency: render portions of an image invisible.
      * Draw: add shapes or text to an image.
      * Decorate: add a border or frame to an image.
      * Special effects: blur, sharpen, threshold, or tint an image.
      * Animation: create a GIF animation sequence from a group of images.
      * Text & comments: insert descriptive or artistic text in an image.
Cristy's avatar
Cristy committed
57
      * Image gradients: create a gradual blend of one color whose shape is 
Cristy's avatar
Cristy committed
58
        horizontal, vertical, circular, or ellipical.
cristy's avatar
cristy committed
59 60 61 62 63
      * Image identification: describe the format and attributes of an image.
      * Composite: overlap one image over another.
      * Montage: juxtapose image thumbnails on an image canvas.
      * Generalized pixel distortion: correct for, or induce image distortions
        including perspective.
cristy's avatar
cristy committed
64
      * Computer vision: Canny edge detection.
cristy's avatar
cristy committed
65 66 67 68 69 70
      * Morphology of shapes: extract features, describe shapes and recognize
        patterns in images.
      * Motion picture support: read and write the common image formats used in
        digital film work.
      * Image calculator: apply a mathematical expression to an image or image
        channels.
cristy's avatar
cristy committed
71 72
      * Connected component labeling: uniquely label connected regions in an
        image.
cristy's avatar
cristy committed
73
      * Discrete Fourier transform: implements the forward and inverse DFT.
cristy's avatar
cristy committed
74
      * Perceptual hash: maps visually identical images to the same or similar
cristy's avatar
cristy committed
75 76
        hash-- useful in image retrieval, authentication, indexing, or copy
        detection as well as digital watermarking.
Cristy's avatar
Cristy committed
77
      * Complex text layout: bidirectional text support and shaping.
cristy's avatar
cristy committed
78 79 80
      * Color management: accurate color management with color profiles or in
        lieu of-- built-in gamma compression or expansion as demanded by the
        colorspace.
cristy's avatar
cristy committed
81 82 83 84 85 86 87 88 89 90 91 92
      * High dynamic-range images: accurately represent the wide range of
        intensity levels found in real scenes ranging from the brightest direct
        sunlight to the deepest darkest shadows.
      * Encipher or decipher an image: convert ordinary images into
        unintelligible gibberish and back again.
      * Virtual pixel support: convenient access to pixels outside the image
        region.
      * Large image support: read, process, or write mega-, giga-, or
        tera-pixel image sizes.
      * Threads of execution support: ImageMagick is thread safe and most
        internal algorithms are OpenMP-enabled to take advantage of speed-ups
        offered by multicore processor chips.
cristy's avatar
cristy committed
93 94
      * Distributed pixel cache: offload intermediate pixel storage to one or
        more remote servers.
cristy's avatar
cristy committed
95 96 97 98 99
      * Heterogeneous distributed processing: 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.
      * ImageMagick on the iPhone: convert, edit, or compose images on your
cristy's avatar
cristy committed
100
        iPhone or iPad.
cristy's avatar
cristy committed
101
  
Cristy's avatar
Cristy committed
102
  Examples of ImageMagick Usage * https://imagemagick.org/Usage/
Cristy's avatar
Cristy committed
103 104 105 106
  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,
cristy's avatar
cristy committed
107 108
  and color manipulations. With Magick.NET, use ImageMagick without having
  to install ImageMagick on your server or desktop.
cristy's avatar
cristy committed
109

Cristy's avatar
Cristy committed
110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140

News

  Now that ImageMagick version 7 is released, we continue
  to maintain the legacy release of ImageMagick, version 6, at
  https://legacy.imagemagick.org. Learn how ImageMagick version 7 differs
  from previous versions with our porting guide.

  ImageMagick best practices strongly encourages you to configure a security
  policy that suits your local environment.

  As an analog to linear (RGB) and non-linear (sRGB) color colorspaces, as
  of ImageMagick 7.0.7-17, we introduce the LinearGray colorspace. Gray is
  non-linear grayscale and LinearGray is linear (e.g. -colorspace linear-gray).

  Want more performance from ImageMagick? Try these options:

    Add more memory to your system, see the pixel cache; Add more cores to
    your system, see threads of execution support; push large images to a
    solid-state drive, see large image support.

  If these options are prohibitive, you can reduce the quality of the image
  results. The default build is Q16 HDRI. If you disable HDRI, you use
  half the memory and instead of predominately floating point operations,
  you use the typically more efficient integer operations. The tradeoff
  is reduced precision and you cannot process out of range pixel values
  (e.g. negative). If you build the Q8 non-HDRI version of ImageMagick,
  you again reduce the memory requirements in half-- and once again there
  is a tradeoff, even less precision and no out of range pixel values. For
  a Q8 non-HDRI build of ImageMagick, use these configure script options:
  --with-quantum-depth=8 --disable-hdri.