The configure script looks at your environment and decides what it can cobble together to get ImageMagick compiled and installed on your system. This includes finding a compiler, where your compiler header files are located (e.g. stdlib.h), and if any delegate libraries are available for ImageMagick to use (e.g. JPEG, PNG, TIFF, etc.). If you are willing to accept configure's default options, and build from within the source directory, you can simply type:
-
$magick> cd ImageMagick-6.6.5-10 $magick> ./configure
+
$magick> cd ImageMagick-6.6.5-0 $magick> ./configure
Watch the configure script output to verify that it finds everything that
you think it should. Pay particular attention to the last lines of the script output. For example, here is a recent report from our system:
@@ -546,7 +543,7 @@ Options used to compile and link:
Download the ImageMagick source distribution and verify the distribution against its message digest.
Unpack and change into the top-level ImageMagick directory:
-
$magick> tar xvfz ImageMagick-6.6.5-10.tar.gz $magick> cd ImageMagick-6.6.5-10
Configure ImageMagick:
+
$magick> tar xvfz ImageMagick-6.6.5-0.tar.gz $magick> cd ImageMagick-6.6.5-0
Configure ImageMagick:
$magick> ./configure --prefix=/opt --with-quantum-depth=16 \
--disable-dependency-tracking --with-x=yes \
--x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib/ \
@@ -566,7 +563,7 @@ Options used to compile and link:
Although you can download and install delegate libraries yourself, many are already available in the GnuWin32 distribution. Download and install whichever delegate libraries you require such as JPEG, PNG, TIFF, etc. Make sure you specify the development headers when you install a package. Next type,
-
$magick> tar jxvf ImageMagick-6.6.5-?.tar.bz2 $magick> cd ImageMagick-6.6.5-10 $magick> export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include" $magick> export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib" $magick> ./configure --without-perl $magick> make $magick> sudo make install
+
$magick> tar jxvf ImageMagick-6.6.5-?.tar.bz2 $magick> cd ImageMagick-6.6.5-0 $magick> export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include" $magick> export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib" $magick> ./configure --without-perl $magick> make $magick> sudo make install
Double-click on
- VisualMagick/bin/ImageMagick-6.6.5-10-Q16-windows-dll.exe
+ VisualMagick/bin/ImageMagick-6.6.5-0-Q16-windows-dll.exe
to launch the ImageMagick binary distribution.
Complete the installer screens to install ImageMagick on your system.
G2F implements an Ada 95 binding to a subset of the low-level MagickCore library.
+
G2F implements an Ada 95 binding to a subset of the low-level MagickCore library.
C
@@ -190,7 +187,7 @@
Ch
-
ChMagick is a Ch binding to the MagickCore and MagickWand API. Ch is an embeddable C/C++ interpreter for cross-platform scripting.
+
ChMagick is a Ch binding to the MagickCore and MagickWand API. Ch is an embeddable C/C++ interpreter for cross-platform scripting.
COM+
@@ -202,31 +199,31 @@
C++
-
Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.
+
Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.
Java
-
JMagick provides an object-oriented Java interface to ImageMagick. Im4java is a pure-java interface to the ImageMagick command-line.
+
JMagick provides an object-oriented Java interface to ImageMagick. Im4java is a pure-java interface to the ImageMagick command-line.
LabVIEW
-
LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.
+
LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.
Lisp
-
CL-Magick provides a Common Lisp interface to the ImageMagick library.
+
CL-Magick provides a Common Lisp interface to the ImageMagick library.
Neko
-
NMagick is a port of the ImageMagick library to the haXe and Neko platforms. It provides image manipulation capabilities to both web and desktop applications using Neko.
+
NMagick is a port of the ImageMagick library to the haXe and Neko platforms. It provides image manipulation capabilities to both web and desktop applications using Neko.
.NET
@@ -240,7 +237,7 @@
Pascal
-
PascalMagick a Pascal binding for the MagickWand API and also the low-level MagickCore library. It works with Free Pascal / Lazarus and Delphi.
+
PascalMagick a Pascal binding for the MagickWand API and also the low-level MagickCore library. It works with Free Pascal / Lazarus and Delphi.
Perl
@@ -252,50 +249,50 @@
PHP
-
MagickWand for PHP a native PHP-extension to the ImageMagick MagickWand API.
+
MagickWand for PHP a native PHP-extension to the ImageMagick MagickWand API.
-
IMagick is a native PHP extension to create and modify images using the ImageMagick API. Documentation for the extension is available here.
+
IMagick is a native PHP extension to create and modify images using the ImageMagick API. Documentation for the extension is available here.
-
phMagick is a wrapper class for ImageMagick, wrapping the most common web image manipulation actions in easy to use functions, but allowing full access to ImageMagick's power by issuing system calls to it's command-line programs.
+
phMagick is a wrapper class for ImageMagick, wrapping the most common web image manipulation actions in easy to use functions, but allowing full access to ImageMagick's power by issuing system calls to it's command-line programs.
Python
-
PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.
+
PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.
-
PythonMagick is an object-oriented Python interface to ImageMagick.
+
PythonMagick is an object-oriented Python interface to ImageMagick.
REALbasic
-
The MBS Realbasic ImageMagick is a plugin that utilizes the power of ImageMagick from within the RealBasic environment.
+
The MBS Realbasic ImageMagick is a plugin that utilizes the power of ImageMagick from within the RealBasic environment.
Ruby
-
RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.
+
RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.
-
MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.
+
MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.
-
MiniMagick is a Ruby wrapper for ImageMagick command line. MiniMagick gives you convenient access to all the command line options ImageMagick supports.
+
MiniMagick is a Ruby wrapper for ImageMagick command line. MiniMagick gives you convenient access to all the command line options ImageMagick supports.
-
QuickMagick is a gem for easily accessing ImageMagick command line tools from Ruby programs.
+
QuickMagick is a gem for easily accessing ImageMagick command line tools from Ruby programs.
Tcl/Tk
-
TclMagick a native Tcl-extension to the ImageMagick MagickWand API.
+
TclMagick a native Tcl-extension to the ImageMagick MagickWand API.
XML RPC
-
RemoteMagick is an XML-RPC web service that creates image thumbnails.
+
RemoteMagick is an XML-RPC web service that creates image thumbnails.
When the pixel cache is initialized, pixels are scaled from whatever bit depth they originated from to that required by the pixel cache. For example, a 1-channel 1-bit monochrome PBM image is scaled to a 4 channel 8-bit RGBA image, if you are using the Q8 version of ImageMagick, and 16-bit RGBA for the Q16 version. You can determine which version you have with the ‑version option:
As you can see, the convenience of the pixel cache sometimes comes with a trade-off in storage (e.g. storing a 1-bit monochrome image as 16-bit RGBA is wasteful) and speed (i.e. storing the entire image in memory is generally slower than accessing one scanline of pixels at a time). In most cases, the benefits of the pixel cache typically outweigh any disadvantages.
The amount of memory can be an important factor, especially if you intend to work on large images. A minimum of 512 MB of RAM is recommended, but the more RAM the better. Although ImageMagick runs well on a single core computer, it automagically runs in parallel on multi-core systems reducing run times considerably.
The Windows version of ImageMagick is self-installing. Simply click on the appropriate version below and it will launch itself and ask you a few installation questions. Versions with Q8 in the name are 8 bits-per-pixel component (e.g. 8-bit red, 8-bit green, etc.), whereas, Q16 in the filename are 16 bits-per-pixel component. A Q16 version permits you to read or write 16-bit images without losing precision but requires twice as much resources as the Q8 version. Versions with dll in the filename include ImageMagick libraries as dynamic link libraries. If you are not sure which version is appropriate, choose
-ImageMagick-6.6.5-10-Q16-windows-dll.exe.
@@ -4161,16 +4158,17 @@ style="background-color: #bdbdbd;">this shade of gray.
MAE mean absolute error (normalized), average channel error distance
MEPP mean error per pixel (normalized mean error, normalized peak error)
MSE mean error squared, average of the channel error squared
+ NCC normalized cross correlation
PAE peak absolute (normalize peak absolute)
PSNR peak signal to noise ratio
RMSE root mean squared (normalized root mean squared)
-
The 'AE' or absolute count of pixels that are different, can be
-controlled using a -fuzz factor to ignore pixels which
-only changed by a small amount. The 'PAE' can be used to find the
+
Control the 'AE', or absolute count of pixels that are different,
+with the -fuzz factor (ignore pixels which
+only changed by a small amount). Use 'PAE' to find the
size of the -fuzz factor needed to make all pixels
-'similar', while 'MAE' can be used to find out the factor needed
+'similar', while 'MAE' dtermines the factor needed
for about half the pixels to be similar.
The 'MEPP' metric returns three different metrics
diff --git a/www/command-line-processing.html b/www/command-line-processing.html
index b3d0be12b..f6f0231ca 100644
--- a/www/command-line-processing.html
+++ b/www/command-line-processing.html
@@ -127,7 +127,7 @@
ImageMagick includes a number of command-line utilities for manipulating images. Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as gimp or Photoshop. However, a GUI is not always convenient. Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image. For these types of operations, the command-line image processing utility is appropriate.
+
ImageMagick includes a number of command-line utilities for manipulating images. Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as gimp or Photoshop. However, a GUI is not always convenient. Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image. For these types of operations, the command-line image processing utility is appropriate.
The ImageMagick command-line tools exit with a status of 0 if the command line arguments have a proper syntax and no problems are encountered. Expect a descriptive message and an exit status of 1 if any exception occurs such as improper syntax, a problem reading or writing an image, or any other problem that prevents the command from completing successfully.
-
In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves. If you are just getting acquainted with ImageMagick, start with the convert program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to convert, compose, or edit images from the command-line.
+
In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves. If you are just getting acquainted with ImageMagick, start with the convert program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to convert, compose, or edit images from the command-line.
Use this form to contact the ImageMagick Wizards for any of the issues listed below. You can expect a reply within 24-48 hours if your message is on topic and is a sponsorshp, license, or security issue. The bug and documentation issues are for reporting only. For any other issue, post your message to the discourse server. Do not use this form to send solicitations / advertisements. Be assured you will not get a response.
+
Use this form to contact the ImageMagick Wizards for any of the issues listed below. You can expect a reply within 24-48 hours if your message is on topic and is a sponsorshp, license, or security issue. The bug and documentation issues are for reporting only. For any other issue, post your message to the discourse server. Do not use this form to send solicitations / advertisements. Be assured you will not get a response.