README.txt 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. Introduction to ImageMagick
  2. ImageMagick® is a software suite to create, edit, compose, or convert
  3. bitmap images. It can read and write images in a variety of formats (over
  4. 200) including PNG, JPEG, GIF, HEIC, TIFF, DPX, EXR, WebP, Postscript,
  5. PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort,
  6. shear and transform images, adjust image colors, apply various special
  7. effects, or draw text, lines, polygons, ellipses and Bezier curves.
  8. The functionality of ImageMagick is typically utilized from the command
  9. line or you can use the features from programs written in your favorite
  10. language. Choose from these interfaces: G2F (Ada), MagickCore (C),
  11. MagickWand (C), ChMagick (Ch), Magick++ (C++),
  12. JMagick (Java), L-Magick (Lisp), Lua, NMagick (Neko/haXe), Magick.NET
  13. (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP
  14. (PHP), IMagick (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick
  15. (Tcl/TK). With a language interface, use ImageMagick to modify or create
  16. images dynamically and automagically.
  17. ImageMagick utilize multiple computational threads to increase performance
  18. and can read, process, or write mega-, giga-, or tera-pixel image sizes.
  19. ImageMagick is free software delivered as a ready-to-run binary distribution
  20. or as source code that you may use, copy, modify, and distribute in both open
  21. and proprietary applications. It is distributed under a derived Apache 2.0
  22. license.
  23. The ImageMagick development process ensures a stable API and ABI. Before
  24. each ImageMagick release, we perform a comprehensive security assessment
  25. that includes memory error and thread data race detection to prevent
  26. security vulnerabilities.
  27. The current release is the ImageMagick 7.0.11-* series. It runs on Linux,
  28. Windows, Mac Os X, iOS, Android OS, and others.
  29. The authoritative ImageMagick web site is https://imagemagick.org. The
  30. authoritative source code repository is
  31. https://github.com/ImageMagick/ImageMagick.
  32. We continue to maintain the legacy release of ImageMagick, version 6,
  33. at https://legacy.imagemagick.org.
  34. Features and Capabilities
  35. Here are just a few examples of what ImageMagick can do:
  36. * Format conversion: convert an image from one format to another (e.g.
  37. PNG to JPEG).
  38. * Transform: resize, rotate, deskew, crop, flip or trim an image.
  39. * Transparency: render portions of an image invisible.
  40. * Draw: add shapes or text to an image.
  41. * Decorate: add a border or frame to an image.
  42. * Special effects: blur, sharpen, threshold, or tint an image.
  43. * Animation: create a GIF animation sequence from a group of images.
  44. * Text & comments: insert descriptive or artistic text in an image.
  45. * Image gradients: create a gradual blend of one color whose shape is
  46. horizontal, vertical, circular, or elliptical.
  47. * Image identification: describe the format and attributes of an image.
  48. * Composite: overlap one image over another.
  49. * Montage: juxtapose image thumbnails on an image canvas.
  50. * Generalized pixel distortion: correct for, or induce image distortions
  51. including perspective.
  52. * Computer vision: Canny edge detection.
  53. * Morphology of shapes: extract features, describe shapes and recognize
  54. patterns in images.
  55. * Motion picture support: read and write the common image formats used in
  56. digital film work.
  57. * Image calculator: apply a mathematical expression to an image or image
  58. channels.
  59. * Connected component labeling: uniquely label connected regions in an
  60. image.
  61. * Discrete Fourier transform: implements the forward and inverse DFT.
  62. * Perceptual hash: maps visually identical images to the same or similar
  63. hash-- useful in image retrieval, authentication, indexing, or copy
  64. detection as well as digital watermarking.
  65. * Complex text layout: bidirectional text support and shaping.
  66. * Color management: accurate color management with color profiles or in
  67. lieu of-- built-in gamma compression or expansion as demanded by the
  68. colorspace.
  69. * Bilateral blur: non-linear, edge-preserving, and noise-reducing
  70. smoothing filter.
  71. * High dynamic-range images: accurately represent the wide range of
  72. intensity levels found in real scenes ranging from the brightest direct
  73. sunlight to the deepest darkest shadows.
  74. * Encipher or decipher an image: convert ordinary images into
  75. unintelligible gibberish and back again.
  76. * Virtual pixel support: convenient access to pixels outside the image
  77. region.
  78. * Large image support: read, process, or write mega-, giga-, or
  79. tera-pixel image sizes.
  80. * Threads of execution support: ImageMagick is thread safe and most
  81. internal algorithms are OpenMP-enabled to take advantage of speed-ups
  82. offered by multicore processor chips.
  83. * Distributed pixel cache: offload intermediate pixel storage to one or
  84. more remote servers.
  85. * Heterogeneous distributed processing: certain algorithms are
  86. OpenCL-enabled to take advantage of speed-ups offered by executing in
  87. concert across heterogeneous platforms consisting of CPUs, GPUs, and
  88. other processors.
  89. * ImageMagick on the iPhone: convert, edit, or compose images on your
  90. iPhone or iPad.
  91. Examples of ImageMagick Usage * https://legacy.imagemagick.org/Usage/
  92. shows how to use ImageMagick from the command-line to accomplish any
  93. of these tasks and much more. Also, see Fred's ImageMagick Scripts @
  94. http://www.fmwconcepts.com/imagemagick/: a plethora of command-line scripts
  95. that perform geometric transforms, blurs, sharpens, edging, noise removal,
  96. and color manipulations. With Magick.NET, use ImageMagick without having
  97. to install ImageMagick on your server or desktop.
  98. News
  99. ImageMagick best practices strongly encourages you to configure a security
  100. policy that suits your local environment.
  101. Now that ImageMagick version 7 is released, we continue
  102. to maintain the legacy release of ImageMagick, version 6, at
  103. https://legacy.imagemagick.org. Learn how ImageMagick version 7 differs
  104. from previous versions with our porting guide.
  105. Want more performance from ImageMagick? Try these options:
  106. * add more memory to your system, see the pixel cache;
  107. * add more cores to your system, see threads of execution support;
  108. * reduce lock contention with the tcmalloc memory allocation library;
  109. * push large images to a solid-state drive, see large image support.
  110. If these options are prohibitive, you can reduce the quality of the image
  111. results. The default build is Q16 HDRI. If you disable HDRI, you use
  112. half the memory and instead of predominantly floating point operations,
  113. you use the typically more efficient integer operations. The tradeoff
  114. is reduced precision and you cannot process out of range pixel values
  115. (e.g. negative). If you build the Q8 non-HDRI version of ImageMagick,
  116. you again reduce the memory requirements in half-- and once again there
  117. is a tradeoff, even less precision and no out of range pixel values. For
  118. a Q8 non-HDRI build of ImageMagick, use these configure script options:
  119. --with-quantum-depth=8 --disable-hdri.