Features and Capabilities â¢ News â¢ Community

Use ImageMagick^® to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and BÃ©zier curves.

The functionality of ImageMagick is typically utilized from the command-line or you can use the features from programs written in your favorite language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), JuliaIO (Julia), L-Magick (Lisp), Lua (LuaJIT), NMagick (Neko/haXe), Magick.NET (.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.

@@ -68,16 +68,16 @@ Use ImageMagick^{ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to help prevent security vulnerabilities.

-The current release is ImageMagick 7.0.5-10. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.
+The current release is ImageMagick 7.0.6-0. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.

The authoritative ImageMagick web site is https://www.imagemagick.org. The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick. We maintain a source code mirror at GitLab and GitHub.

We continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org.

-Features and Capabilities
+Features and Capabilities
Here are just a few examples of what ImageMagick can do for you:

-
+
@@ -209,15 +209,15 @@ Use ImageMagick^{Examples of ImageMagick Usage shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With Magick.NET, use ImageMagick without having to install ImageMagick on your server or desktop.
+Examples of ImageMagick Usage shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With Magick.NET, use ImageMagick without having to install ImageMagick on your server or desktop.

-News
+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.

-Community
+Community
To join the ImageMagick community, try the discourse server. You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions. If you want to contribute image processing algorithms, other enhancements, or bug fixes, open an issue.

@@ -239,4 +239,4 @@ Use ImageMagick^{-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Build ImageMagickObject From Source

@@ -65,17 +65,17 @@

ImageMagick provides a statically-built ImageMagick object as part of its Windows installation package. When this package is installed, ImageMagickObject and its sample programs are installed to this path:

-- c:\Program Files\ImageMagick-7.0.5-Q16\ImageMagickObject
-
+
+ c:\Program Files\ImageMagick-7.0.6-Q16\ImageMagickObject
+

The ImageMagickObject is registered if the checkbox, Register ImageMagickObject, is checked at install time.

To execute the sample program from the Windows Command Shell, type:

-+
cscript SimpleTest.vbs
-

+

Since the ImageMagick utility command line parsers are incorporated within ImageMagickObject, please refer to the command-line tools discussion to learn how to use it. The sample VBS scripts show how the object should be called and used and have lots of comments.

@@ -83,30 +83,30 @@ cscript SimpleTest.vbs

MagickCMD is a C++ sample, but it also serves as a replacement for all the other command line utilities in most applications. Instead of using convert xxxx yyyy you can use MagickCMD convert xxxx yyyy instead. MagickCMD calls the COM object to accomplish the designated task. This small tight combination replaces the entire usual binary distribution in just a few mebibytes.

-Build ImageMagickObject From Source
+Build ImageMagickObject From Source

The source code for ImageMagickObject is available from the ImageMagick GIT repository, or as part of the Windows source distribution. Once the source code has been retrieved and extracted, the source for ImageMagickObject is the directory ImageMagick\contrib\win32\ATL7ImageMagickObject, however, ImageMagick itself must be built using the static-multithread (VisualStaticMT) build configuration. Building ImageMagickObject requires Microsoft Visual C++ 7.0 as delivered with Microsoft's Visual Studio .NET package. See the Windows compilation instructions to get ImageMagick itself built before building the ImageMagick COM+ component.

Once the VisualStaticMT project has been built, build the ImageMagickObject with this procedure:

-+
cd ImageMagick/contrib/win32/ATL7/ImageMagickObject
BuildImageMagickObject release
-

+

Here, we assume that the VisualStaticMT project has been built using the release setting for an optimized build. If the debug setting was used for a debug build, specify the argument debug; instead.

To register the DLL as a COM+ server, type

-+
regsvr32 /c /s ImageMagickObject.dll
-

+

To unregister the DLL, type

-+
regsvr32 /u /s ImageMagickObject.dll
-

+

Use MagickCMD to exercise ImageMagickObject to verify that it is working properly.

@@ -130,4 +130,4 @@ regsvr32 /u /s ImageMagickObject.dll

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/advanced-unix-installation.html b/www/advanced-unix-installation.html
index 2bc6b51e0..d82a3b2bf 100644
--- a/www/advanced-unix-installation.html
+++ b/www/advanced-unix-installation.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Download & Unpack â¢ Configure â¢ Build â¢ Install â¢ Linux-specific Build Instructions â¢ Mac OS X-specific Build Instructions â¢ MinGW-specific Build Instructions â¢ Dealing with Unexpected Problems

It's possible you don't want to concern yourself with advanced installation under Unix or Linux systems. If so, you also have the option of installing a pre-compiled binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Unix or Linux systems, lets begin.

-Download & Unpack
+Download & Unpack

ImageMagick builds on a variety of Unix and Unix-like operating systems including Linux, Solaris, FreeBSD, Mac OS X, and others. A compiler is required and fortunately almost all modern Unix systems have one. Download ImageMagick.tar.gz from ftp.imagemagick.org or its mirrors and verify the distribution against its message digest.

Unpack the distribution it with this command:

-+
tar xvzf ImageMagick.tar.gz
-

+

Now that you have the ImageMagick Unix/Linux source distribution unpacked, let's configure it.

-Configure
+Configure

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:

- cd ImageMagick-7.0.5-10 ./configure
+ cd ImageMagick-7.0.6-0 ./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:

-ImageMagick is configured as follows. Please verify that this configuration
+ImageMagick is configured as follows. Please verify that this configuration
matches your expectations.

Host system type: x86_64-unknown-linux-gnu
@@ -153,32 +153,32 @@ Options used to compile and link:
-lSM -lICE -lX11 -lXt -lbz2 -lz -lm -lgomp -lpthread -lltdl
CXX = g++
CXXFLAGS = -g -O2 -Wall -W -pthread
-

+

You can influence choice of compiler, compilation flags, or libraries of the configure script by setting initial values for variables in the configure command line. These include, among others:

-
-CC
- Name of C compiler (e.g. cc -Xa) to use.
-CXX
- Name of C++ compiler to use (e.g. CC).
-CFLAGS
- Compiler flags (e.g. -g -O2) to compile C code.
-CXXFLAGS
- Compiler flags (e.g. -g -O2) to compile C++ code.
-CPPFLAGS
- Include paths (.e.g. -I/usr/local) to look for header files.
-LDFLAGS
- Library paths (.e.g. -L/usr/local) to look for libraries systems that support the notion of a library run-path may require an additional argument in order to find shared libraries at run time. For example, the Solaris linker requires an argument of the form -R/path. Some Linux systems will work with -rpath /usr/local/lib, while some other Linux systems who's gcc does not pass -rpath to the linker, require an argument of the form -Wl,-rpath,/usr/local/lib.
-LIBS
- Extra libraries (.e.g. -l/usr/local/lib) required to link.
+
+CC
+ Name of C compiler (e.g. cc -Xa) to use.
+CXX
+ Name of C++ compiler to use (e.g. CC).
+CFLAGS
+ Compiler flags (e.g. -g -O2) to compile C code.
+CXXFLAGS
+ Compiler flags (e.g. -g -O2) to compile C++ code.
+CPPFLAGS
+ Include paths (.e.g. -I/usr/local) to look for header files.
+LDFLAGS
+ Library paths (.e.g. -L/usr/local) to look for libraries systems that support the notion of a library run-path may require an additional argument in order to find shared libraries at run time. For example, the Solaris linker requires an argument of the form -R/path. Some Linux systems will work with -rpath /usr/local/lib, while some other Linux systems who's gcc does not pass -rpath to the linker, require an argument of the form -Wl,-rpath,/usr/local/lib.
+LIBS
+ Extra libraries (.e.g. -l/usr/local/lib) required to link.

Here is an example of setting configure variables from the command line:

-+
configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lposix
-

+

Any variable (e.g. CPPFLAGS or LDFLAGS) which requires a directory path must specify an absolute path rather than a relative path.

@@ -191,7 +191,7 @@ configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lp
Here are the optional features you can configure:

-}}

Animation
create a GIF animation sequence from a group of images.
+

--enable-shared
build the shared libraries and support for loading coder and process modules. Shared libraries are preferred because they allow programs to share common code, making the individual programs much smaller. In addition shared libraries are required in order for PerlMagick to be dynamically loaded by an installed PERL (otherwise an additional PERL (PerlMagick) must be installed.
@@ -245,7 +245,7 @@ configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lp
Here are the optional packages you can configure:

-
+
+
@@ -427,40 +427,40 @@ Quantum Depth Virtual Memory

ImageMagick is now configured and ready to build

-Build
+Build
Once ImageMagick is configured, these standard build targets are available from the generated make files:

-
-make
- Build ImageMagick.
-sudo make install
- Install ImageMagick.
-make check
- Run tests using the installed ImageMagick (sudo make install must be done first). Ghostscript is a prerequisite, otherwise certain unit tests that render text and the EPS, PS, and PDF formats will fail.
-make clean
- Remove everything in the build directory created by make.
-make distclean
- remove everything in the build directory created by configure and make. This useful if you want to start over from scratch.
-make uninstall
- Remove all files from the system which are (or would be) installed by sudo make install using the current configuration. Note that this target is imperfect for PerlMagick since Perl no longer supports an uninstall target.
+
+make
+ Build ImageMagick.
+sudo make install
+ Install ImageMagick.
+make check
+ Run tests using the installed ImageMagick (sudo make install must be done first). Ghostscript is a prerequisite, otherwise certain unit tests that render text and the EPS, PS, and PDF formats will fail.
+make clean
+ Remove everything in the build directory created by make.
+make distclean
+ remove everything in the build directory created by configure and make. This useful if you want to start over from scratch.
+make uninstall
+ Remove all files from the system which are (or would be) installed by sudo make install using the current configuration. Note that this target is imperfect for PerlMagick since Perl no longer supports an uninstall target.

In most cases you will simply wand to compile ImageMagick with this command:

-+
make
-

+

Once built, you can optionally install ImageMagick on your system as discussed below.

-Install
+Install

Now that ImageMagick is configured and built, type:

-+
make install
-

+

to install it.

@@ -468,57 +468,57 @@ make install

To confirm your installation of the ImageMagick distribution was successful, ensure that the installation directory is in your executable search path and type:

-+
convert logo: logo.gif
identify logo.gif
-

+

The ImageMagick logo is displayed on your X11 display.

To verify the ImageMagick build configuration, type:

-+
identify -list configure
-

+

To list which image formats are supported , type:

-+
identify -list format
-

+

For a more comprehensive test, you run the ImageMagick test suite by typing:

-+
make check
-

+

Ghostscript is a prerequisite, otherwise the EPS, PS, and PDF tests will fail. Note that due to differences between the developer's environment and your own it is possible that a few tests may fail even though the results are ok. Differences between the developer's environment environment and your own may include the compiler, the CPU type, and the library versions used. The ImageMagick developers use the current release of all dependent libraries.

-Linux-specific Build instructions
+Linux-specific Build instructions

Download ImageMagick.src.rpm from ftp.imagemagick.org or its mirrors and verify the distribution against its message digest.

Build ImageMagick with this command:

-+
rpmbuild --rebuild ImageMagick.src.rpm
-

+

After the build you, locate the RPMS folder and install the ImageMagick binary RPM distribution:

- rpm -ivh ImageMagick-7.0.5-?.*.rpm
-Mac OS X-specific Build instructions
+ rpm -ivh ImageMagick-7.0.6-?.*.rpm
+Mac OS X-specific Build instructions

Perform these steps as an administrator or with the sudo command:

Install MacPorts. Download and install MacPorts and type the following commands:

-+
sudo port -v install freetype +bytecode
sudo port -v install librsvg
sudo port -v install graphviz +gs +wmf +jbig +jpeg2 +lcms
-

+

This installs many of the delegate libraries ImageMagick will utilize such as JPEG and FreeType.

@@ -526,48 +526,48 @@ sudo port -v install graphviz +gs +wmf +jbig +jpeg2 +lcms
Install the latest Xcode from Apple.
Use the port command to install any delegate libraries you require, for example:

-+
sudo port install jpeg
-

+

Now lets build ImageMagick:

Download the ImageMagick source distribution and verify the distribution against its message digest.
Unpack and change into the top-level ImageMagick directory:
- tar xvzf ImageMagick-7.0.5-10.tar.gz cd ImageMagick-7.0.5-10
Configure ImageMagick:
-+ tar xvzf ImageMagick-7.0.6-0.tar.gz cd ImageMagick-7.0.6-0
Configure ImageMagick:
+
./configure --prefix=/opt --with-quantum-depth=16 \
--disable-dependency-tracking --with-x=yes \
--x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib/ \
--without-perl"
-

+
Build ImageMagick:
-+
make
-

+
Install ImageMagick:
-+
sudo make install
-

+
To verify your install, type

-+
/opt/local/bin/identify -list font
-

+

to list all the fonts ImageMagick knows about.
To test the ImageMagick GUI, in a new shell, type:

-+
display -display :0
-

+

-MinGW-specific Build instructions
+MinGW-specific Build instructions

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,

- tar jxvf ImageMagick-7.0.5-?.tar.bz2
cd ImageMagick-7.0.5-10
export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include"
export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib"
./configure --without-perl
make
sudo make install
-Dealing with Unexpected Problems
+ tar jxvf ImageMagick-7.0.6-?.tar.bz2
cd ImageMagick-7.0.6-0
export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include"
export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib"
./configure --without-perl
make
sudo make install
+Dealing with Unexpected Problems

Chances are the download, configure, build, and install of ImageMagick went flawlessly as it is intended, however, certain systems and environments may cause one or more steps to fail. We discuss a few problems we've run across and how to take corrective action to ensure you have a working release of ImageMagick

@@ -576,40 +576,40 @@ display -display :0

Some systems may fail to link at build time due to unresolved symbols. Try adding the LDFLAGS to the configure command line:

-+
configure LDFLAGS='-L/usr/local/lib -R/usr/local/lib'
-

+

Dynamic Linker Run-time Bindings
On some systems, ImageMagick may not find its shared library, libMagick.so. Try running the ldconfig with the library path:

-+
/sbin/ldconfig /usr/local/lib
-

+

Solaris and Linux systems have the ldd command which is useful to track which libraries ImageMagick depends on:

-+
ldd `which convert`
-

+

Delegate Libraries
On occasion you may receive these warnings:
-+
no decode delegate for this image format
no encode delegate for this image format
-

+
This exception indicates that an external delegate library or its headers were not available when ImageMagick was built. To add support for the image format, download and install the requisite delegate library and its header files and reconfigure, rebuild, and reinstall ImageMagick. As an example, lets add support for the JPEG image format. First we install the JPEG RPMS:

-+
yum install libjpeg libjpeg-devel
-

+

Now reconfigure, rebuild, and reinstall ImageMagick. To verify JPEG is now properly supported within ImageMagick, use this command:

-+
identify -list format
-

+

You should see a mode of rw- associated with the JPEG tag. This mode means the image can be read or written and can only support one image per image file.

@@ -636,4 +636,4 @@ identify -list format

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/advanced-windows-installation.html b/www/advanced-windows-installation.html
index 4823e28e0..edadae7e3 100644
--- a/www/advanced-windows-installation.html
+++ b/www/advanced-windows-installation.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Download & Unpack â¢ Configure â¢ Build â¢ Install â¢ Create a Self-installing Binary Distribution â¢ Dealing with Unexpected Problems â¢ Building Your Custom Project

It's possible you don't want to concern yourself with advanced installation under Windows. If so, you also have the option of installing a self-installing binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Windows, lets begin.

-Download & Unpack
+Download & Unpack

Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

@@ -69,14 +69,14 @@

You can unpack the distribution with WinZip or type the following from any Command Prompt window:

-+
unzip ImageMagick-windows.zip
-

+

Now that you have the ImageMagick Windows source distribution unpacked, let's configure it.

-Configure
+Configure

These instructions are specific to building ImageMagick with the Visual Studio under Windows XP, Win2K, or Windows 98. ImageMagick does not include any workspace (DSW) or project files (DSP) except for those included with third party libraries. Instead, there is a configure program that must be built and run which creates the Visual Studio workspaces for ImageMagick. The Visual Studio system provides four different types of runtime environments that must match across all application, library, and dynamic-library (DLL) code that is built. The configure program creates a set of build files that are consistent for a specific runtime selection listed here:

@@ -106,7 +106,7 @@ unzip ImageMagick-windows.zip
Key user defines in magick_config.h include:

-

--with-quantum-depth
number of bits in a pixel quantum (default 16).
@@ -254,23 +254,23 @@ configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lp

The number of bits in a quantum determines how many values it may contain. Each quantum level supports 256 times as many values as the previous level. The following table shows the range available for various quantum sizes.

-+
Quantum Depth Valid Range (Decimal) Valid Range (Hex)
8 0-255 00-FF
16 0-65535 0000-FFFF
32 0-4294967295 00000000-FFFFFFFF
-

+

Larger pixel quantums can cause ImageMagick to run more slowly and to require more memory. For example, using sixteen-bit pixel quantums can cause ImageMagick to run 15% to 50% slower (and take twice as much memory) than when it is built to support eight-bit pixel quantums.

The amount of virtual memory consumed by an image can be computed by the equation (5 * Quantum Depth * Rows * Columns) / 8. This an important consideration when resources are limited, particularly since processing an image may require several images to be in memory at one time. The following table shows memory consumption values for a 1024x768 image:

-+
Quantum Depth Virtual Memory
8 3MB
16 8MB
32 15MB
-

+
@@ -125,7 +125,7 @@ unzip ImageMagick-windows.zip

The default build is WIN32. For 64-bit, open a newly created solution and enter Configuration Manager. Add a x64 configuration, copying the configuration from Win32. Be sure that it adds the configuration to all the projects. Now compile. For the 64-bit build, you will also need to disable X11 support. Edit magick-config.h and undefine the MAGICKCORE_X11_DELEGATE define.

-Build
+Build
After creating your build environment, proceed to open the DSW (or SLN) workspace in the VisualMagick folder. In the DSW file choose the All project to make it the active project. Set the build configuration to the desired one (Debug, or Release) and clean and build:

@@ -161,10 +161,10 @@ unzip ImageMagick-windows.zip

With this feature enabled, you should be able to nab a copy of

-+
VisualMagick\utilities\UTIL_convert_xxx_exe.dsp (for C) or
VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp (for C++)
-

+
and pop it into Notepad, modify it (carefully) to your needs and be on your way to happy compiling and linking.

@@ -174,27 +174,27 @@ VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp (for C++)

For straight C API command line applications use something from:

-+
ImageMagick\tests or
ImageMagick\utilities (source code) or
ImageMagick\VisualMagick\tests or
ImageMagick\Visualmagick\utilities (project - DSP)
-

+
For C++ and Magick++ command line applications use something from:

-+
ImageMagick\Magick++\tests or ImageMagick\Magick++\demo (source code) or
ImageMagick\VisualMagick\Magick++\tests or

ImageMagick\VisualMagick\Magick++\demo (project - DSP)
-

+
For C++ and Magick++ and MFC windows applications use:

-+
ImageMagick\contrib\win32\MFC\NtMagick (source code) or
ImageMagick\VisualMagick\contrib\win32\MFC\NtMagick (project - DSP)
-

+
The ImageMagick distribution is very modular. The default configuration is there to get you rolling, but you need to make some serious choices when you wish to change things around.

@@ -225,16 +225,16 @@ ImageMagick\VisualMagick\contrib\win32\MFC\NtMagick (project - DSP)
This environmental variable sets the default list of places were Windows looks for EXE's and DLL's. Windows CMD shell seems to look in the current directory first no matter what, which may make it unnecessary to update the PATH. If you wish to run any of utilities from another location then you must add the path to your bin directory in. For instance, to do this for the default build environment like I do, you might add:

-+
C:\ImageMagick\VisualMagick\bin
-

+
MAGICK_HOME
If all you do is modify the PATH variable, the first problem you will run into is that ImageMagick may not be able to find any of its modules. Modules are all the IM_MOD*.DLL files you see in the distribution. There is one of these for each and every file format that ImageMagick supports. This environment variable tells the system were to look for these DLL's. The compiled in default is execution path - which says - look in the same place that the application is running in. If you are running from somewhere other then bin - this will no longer work and you must use this variable. If you elect to leave the modules in the same place as the EXE's (a good idea) then you can simply set this to the same place as you did the PATH variable. In my case:

-+
C:\ImageMagick\coders
-

+
This also the place were ImageMagick expects to find the colors.xml, delegates.xml, magic.xml, modules.xml, and type.xml files.

@@ -244,15 +244,15 @@ C:\ImageMagick\coders

You can elect to changes these things the good old hard-coded way. This define is applicable in magick-config.h:

-+
#define MagickConfigurePath "C:\\ImageMagick\\"
-

+
To view any image in a Microsoft window, type

-+
magick image.ext win:
-

+
Make sure Ghostscript is installed, otherwise, you will be unable to convert or view a Postscript document, and Postscript standard fonts will not be available.

@@ -264,14 +264,14 @@ magick image.ext win:

If you are looking to install the ImageMagick COM+ object, see Installing the ImageMagickObject COM+ Component.

-Install
+Install
You can run ImageMagick command line utilities directly from the VisualMagick\bin folder, however, in most cases you may want the convenience of an installer script. ImageMagick provides Inno Setup scripts for this purpose. Note, you must define MAGICKCORE_INSTALLED_SUPPORT at configure time to utilize the installer scripts.
To get started building a self-installing ImageMagick executable, go to VisualMagick\installer folder and click on a script that matches your build environment. Press F9 to build and install ImageMagick. The default location is C:Program Files\ImageMagick-7.?.?\Q?. The exact folder name depends on the ImageMagick version and quantum depth. Once installed, ImageMagick command line utilities and libraries are available to the MS Command Prompt, web scripts, or to meet your development needs.

-Create a Self-Installing Binary Distribution
+Create a Self-Installing Binary Distribution
Prerequisites

@@ -303,10 +303,10 @@ magick image.ext win:

Launch the Command Prompt application and move to the contrib\win32\ATL7\ImageMagickObject folder.
Build ImageMagickObject with these commands:
-+
BuildImageMagickObject clean
BuildImageMagickObject release
-

+

Build PerlMagick
@@ -314,10 +314,10 @@ BuildImageMagickObject release

Launch the Command Prompt application and move to the PerlMagick folder.
Build PerlMagick with these commands:
-+
perl Makefile.PL
dmake release
-

+

Create the Self-installing ImageMagick Binary Distribution
@@ -331,7 +331,7 @@ dmake release

Double-click on
- VisualMagick/bin/ImageMagick-7.0.5-10-Q16-windows-dll.exe
+ VisualMagick/bin/ImageMagick-7.0.6-0-Q16-windows-dll.exe
to launch the ImageMagick binary distribution.
Complete the installer screens to install ImageMagick on your system.

@@ -340,38 +340,38 @@ dmake release

Launch the Command Prompt application and move to the PerlMagick folder and type
-+
nmake test
-

+

Move to the VisualMagick/tests folder and type
-+
validate
-

+
Move to the VisualMagick/Magick++/tests folder and type
-+
run_tests.bat
-

+
Move to the VisualMagick/Magick++/demo folder and type
-+
run_demos.bat
-

+

If all the tests pass without complaint, the ImageMagick self-install binary distribution is ready for use.

-Dealing with Unexpected Problems
+Dealing with Unexpected Problems
Chances are the download, configure, build, and install of ImageMagick went flawlessly as it is intended, however, certain systems and environments may cause one or more steps to fail. We discuss a few problems we've run across and how to take corrective action to ensure you have a working release of ImageMagick.
If the compiler generates an error or if it quits unexpectedly, go to the Visual Studio web site and look for Visual Studio service packs. Chances are, after you download and install all the Visual Studio service packs, ImageMagick will compile and build as expected.

-Building Your Custom Project
+Building Your Custom Project
The Windows binary distribution includes a number of demo projects that you can use as a template for your own custom project. For example, start with the Button project, generally located in the c:/Program Files/ImageMagick-7.5.5-0/Magick++_demos folder. If not, be sure to select Configuration Properties->C/C++->Preprocessor and set these definitions:

-+
NDEBUG
WIN32
_CONSOLE
@@ -379,7 +379,7 @@ _VISUALC_
NeedFunctionPrototypes
_DLL
_MAGICKMOD_
-

+

@@ -401,4 +401,4 @@ _MAGICKMOD_

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/animate.html b/www/animate.html
index 0c6f74bcb..960b15f4e 100644
--- a/www/animate.html
+++ b/www/animate.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the animate program to animate an image sequence on any X server. See Command Line Processing for advice on how to structure your animate command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the animate command here to illustrate its usefulness and ease of use. To get started, lets animate an image sequence in the GIF format:

-+
magick animate movie.gif
-

+

To animate a directory of JPEG images, use:

-+
magick animate *.jpg
-

+

You can find additional examples of using animate in Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The animate command recognizes these options. Click on an option to get more details about how that option works.

-

MAGICKCORE_QUANTUM_DEPTH (default 16)
Specify the depth of the pixel component depth (8, 16, or 32). A value of 8 uses half the memory than 16 and may run 30% faster, but provides 256 times less color resolution than a value of 16. We recommend a quantum depth of 16 because 16-bit images are becoming more prevalent on the Internet.

+
@@ -532,4 +532,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/architecture.html b/www/architecture.html
index bb1cd84db..c9510cd34 100644
--- a/www/architecture.html
+++ b/www/architecture.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The Pixel Cache â¢ Streaming Pixels â¢ Image Properties and Profiles â¢ Large Image Support â¢ Threads of Execution â¢ Heterogeneous Distributed Processing â¢ Custom Image Coders â¢ Custom Image Filters

The citizens of Oz were quite content with their benefactor, the all-powerful Wizard. They accepted his wisdom and benevolence without ever questioning the who, why, and where of his power. Like the citizens of Oz, if you feel comfortable that ImageMagick can help you convert, edit, or compose your images without knowing what goes on behind the curtain, feel free to skip this section. However, if you want to know more about the software and algorithms behind ImageMagick, read on. To fully benefit from this discussion, you should be comfortable with image nomenclature and be familiar with computer programming.

-Architecture Overview
+Architecture Overview

An image typically consists of a rectangular region of pixels and metadata. To convert, edit, or compose an image in an efficient manner, we need convenient access to any pixel anywhere within the region (and sometimes outside the region). And in the case of an image sequence, we need access to any pixel of any region of any image in the sequence. However, there are hundreds of image formats such JPEG, TIFF, PNG, GIF, etc., that makes it difficult to access pixels on demand. Within these formats we find differences in:

@@ -101,7 +101,7 @@

ImageMagick consists of nearly a half million lines of C code and optionally depends on several million lines of code in dependent libraries (e.g. JPEG, PNG, TIFF libraries). Given that, one might expect a huge architecture document. However, a great majority of image processing is simply accessing pixels and its metadata and our simple, elegant, and efficient implementation makes this easy for the ImageMagick developer. We discuss the implementation of the pixel cache and getting and setting image properties and profiles in the next few sections. Next, we discuss using ImageMagick within a thread of execution. In the final sections, we discuss image coders to read or write a particular image format followed by a few words on creating a filter to access or update pixels based on your custom requirements.

-The Pixel Cache
+The Pixel Cache

The ImageMagick pixel cache is a repository for image pixels with up to 32 channels. The channels are stored contiguously at the depth specified when ImageMagick was built. The channel depths are 8 bits-per-pixel component for the Q8 version of ImageMagick, 16 bits-per-pixel component for the Q16 version, and 32 bits-per-pixel component for the Q32 version. By default pixel components are 32-bit floating-bit high dynamic-range quantities. The channels can hold any value but typically contain red, green, blue, and alpha intensities or cyan, magenta, yellow, alpha intensities. A channel might contain the colormap indexes for colormapped images or the black channel for CMYK images. The pixel cache storage may be heap memory, disk-backed memory mapped, or on disk. The pixel cache is reference-counted. Only the cache properties are copied when the cache is cloned. The cache pixels are subsequently copied only when you signal your intention to update any of the pixels.

@@ -110,32 +110,32 @@
The pixel cache is associated with an image when it is created and it is initialized when you try to get or put pixels. Here are three common methods to associate a pixel cache with an image:

-Create an image canvas initialized to the background color:

-image=AllocateImage(image_info);
+Create an image canvas initialized to the background color:

+image=AllocateImage(image_info);
if (SetImageExtent(image,640,480) == MagickFalse)
{ /* an exception was thrown */ }
(void) QueryMagickColor("red",&image->background_color,&image->exception);
SetImageBackgroundColor(image);
-

+

-Create an image from a JPEG image on disk:

-(void) strcpy(image_info->filename,"image.jpg"):
+Create an image from a JPEG image on disk:

+(void) strcpy(image_info->filename,"image.jpg"):
image=ReadImage(image_info,exception);
if (image == (Image *) NULL)
{ /* an exception was thrown */ }
-

-Create an image from a memory based image:

-image=BlobToImage(blob_info,blob,extent,exception);
+
+Create an image from a memory based image:

+image=BlobToImage(blob_info,blob,extent,exception);
if (image == (Image *) NULL)
{ /* an exception was thrown */ }
-

+

In our discussion of the pixel cache, we use the MagickCore API to illustrate our points, however, the principles are the same for other program interfaces to ImageMagick.

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 8-bit gray 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:

- identify -version
Version: ImageMagick 7.0.5-10 2017-05-30 Q16 https://www.imagemagick.org
+ identify -version
Version: ImageMagick 7.0.6-0 2017-06-13 Q16 https://www.imagemagick.org
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 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.

Access the Pixel Cache
@@ -150,7 +150,7 @@ if (image == (Image *) NULL)

Here is a typical MagickCore code snippet for manipulating pixels in the pixel cache. In our example, we copy pixels from the input image to the output image and decrease the intensity by 10%:

-const Quantum
+const Quantum
*p;

Quantum
@@ -184,13 +184,13 @@ for (y=0; y < (ssize_t) source->rows; y++)
}
if (y < (ssize_t) source->rows)
{ /* an exception was thrown */ }
-

+

When we first create the destination image by cloning the source image, the pixel cache pixels are not copied. They are only copied when you signal your intentions to modify or set the pixel cache by calling GetAuthenticPixels() or QueueAuthenticPixels(). Use QueueAuthenticPixels() if you want to set new pixel values rather than update existing ones. You could use GetAuthenticPixels() to set pixel values but it is slightly more efficient to use QueueAuthenticPixels() instead. Finally, use SyncAuthenticPixels() to ensure any updated pixels are pushed to the pixel cache.

You can associate arbitrary content with each pixel, called meta content. Use GetVirtualMetacontent() (to read the content) or GetAuthenticMetacontent() (to update the content) to gain access to this content. For example, to print the metacontent, use:

-const void
+const void
*metacontent;

for (y=0; y < (ssize_t) source->rows; y++)
@@ -203,12 +203,12 @@ for (y=0; y < (ssize_t) source->rows; y++)
}
if (y < (ssize_t) source->rows)
/* an exception was thrown */
-

+

The pixel cache manager decides whether to give you direct or indirect access to the image pixels. In some cases the pixels are staged to an intermediate buffer-- and that is why you must call SyncAuthenticPixels() to ensure this buffer is pushed out to the pixel cache to guarantee the corresponding pixels in the cache are updated. For this reason we recommend that you only read or update a scanline or a few scanlines of pixels at a time. However, you can get any rectangular region of pixels you want. GetAuthenticPixels() requires that the region you request is within the bounds of the image area. For a 640 by 480 image, you can get a scanline of 640 pixels at row 479 but if you ask for a scanline at row 480, an exception is returned (rows are numbered starting at 0). GetVirtualPixels() does not have this constraint. For example,

-p=GetVirtualPixels(source,-3,-3,source->columns+3,6,exception);
-
+p=GetVirtualPixels(source,-3,-3,source->columns+3,6,exception);
+

gives you the pixels you asked for without complaint, even though some are not within the confines of the image region.

@@ -217,37 +217,37 @@ if (y < (ssize_t) source->rows)
There are a plethora of image processing algorithms that require a neighborhood of pixels about a pixel of interest. The algorithm typically includes a caveat concerning how to handle pixels around the image boundaries, known as edge pixels. With virtual pixels, you do not need to concern yourself about special edge processing other than choosing which virtual pixel method is most appropriate for your algorithm.
Access to the virtual pixels are controlled by the SetImageVirtualPixelMethod() method from the MagickCore API or the ‑virtual‑pixel option from the command line. The methods include:

-
-background
-the area surrounding the image is the background color
-black
-the area surrounding the image is black
-checker-tile
-alternate squares with image and background color
-dither
-non-random 32x32 dithered pattern
-edge
-extend the edge pixel toward infinity (default)
-gray
-the area surrounding the image is gray
-horizontal-tile
-horizontally tile the image, background color above/below
-horizontal-tile-edge
-horizontally tile the image and replicate the side edge pixels
-mirror
-mirror tile the image
-random
-choose a random pixel from the image
-tile
-tile the image
-transparent
-the area surrounding the image is transparent blackness
-vertical-tile
-vertically tile the image, sides are background color
-vertical-tile-edge
-vertically tile the image and replicate the side edge pixels
-white
-the area surrounding the image is white
+
+background
+the area surrounding the image is the background color
+black
+the area surrounding the image is black
+checker-tile
+alternate squares with image and background color
+dither
+non-random 32x32 dithered pattern
+edge
+extend the edge pixel toward infinity (default)
+gray
+the area surrounding the image is gray
+horizontal-tile
+horizontally tile the image, background color above/below
+horizontal-tile-edge
+horizontally tile the image and replicate the side edge pixels
+mirror
+mirror tile the image
+random
+choose a random pixel from the image
+tile
+tile the image
+transparent
+the area surrounding the image is transparent blackness
+vertical-tile
+vertically tile the image, sides are background color
+vertical-tile-edge
+vertically tile the image and replicate the side edge pixels
+white
+the area surrounding the image is white

@@ -255,32 +255,32 @@ if (y < (ssize_t) source->rows)

Recall that this simple and elegant design of the ImageMagick pixel cache comes at a cost in terms of storage and processing speed. The pixel cache storage requirements scales with the area of the image and the bit depth of the pixel components. For example, if we have a 640 by 480 image and we are using the non-HDRI Q16 version of ImageMagick, the pixel cache consumes image width * height * bit-depth / 8 * channels bytes or approximately 2.3 mebibytes (i.e. 640 * 480 * 2 * 4). Not too bad, but what if your image is 25000 by 25000 pixels? The pixel cache requires approximately 4.7 gibibytes of storage. Ouch. ImageMagick accounts for possible huge storage requirements by caching large images to disk rather than memory. Typically the pixel cache is stored in memory using heap memory. If heap memory is exhausted, we create the pixel cache on disk and attempt to memory-map it. If memory-map memory is exhausted, we simply use standard disk I/O. Disk storage is cheap but it is also very slow, upwards of 1000 times slower than memory. We can get some speed improvements, up to 5 times, if we use memory mapping to the disk-based cache. These decisions about storage are made automagically by the pixel cache manager negotiating with the operating system. However, you can influence how the pixel cache manager allocates the pixel cache with cache resource limits. The limits include:

-
- width
- maximum width of an image. Exceed this limit and an exception is thrown and processing stops.
- height
- maximum height of an image. Exceed this limit and an exception is thrown and processing stops.
- area
- maximum area in bytes of any one image that can reside in the pixel cache memory. If this limit is exceeded, the image is automagically cached to disk and optionally memory-mapped.
- memory
- maximum amount of memory in bytes to allocate for the pixel cache from the heap.
- map
- maximum amount of memory map in bytes to allocate for the pixel cache.
- disk
- maximum amount of disk space in bytes permitted for use by the pixel cache. If this limit is exceeded, the pixel cache is not created and a fatal exception is thrown.
- files
- maximum number of open pixel cache files. When this limit is exceeded, any subsequent pixels cached to disk are closed and reopened on demand. This behavior permits a large number of images to be accessed simultaneously on disk, but without a speed penalty due to repeated open/close calls.
- thread
- maximum number of threads that are permitted to run in parallel.
- time
- maximum number of seconds that the process is permitted to execute. Exceed this limit and an exception is thrown and processing stops.
+
+ width
+ maximum width of an image. Exceed this limit and an exception is thrown and processing stops.
+ height
+ maximum height of an image. Exceed this limit and an exception is thrown and processing stops.
+ area
+ maximum area in bytes of any one image that can reside in the pixel cache memory. If this limit is exceeded, the image is automagically cached to disk and optionally memory-mapped.
+ memory
+ maximum amount of memory in bytes to allocate for the pixel cache from the heap.
+ map
+ maximum amount of memory map in bytes to allocate for the pixel cache.
+ disk
+ maximum amount of disk space in bytes permitted for use by the pixel cache. If this limit is exceeded, the pixel cache is not created and a fatal exception is thrown.
+ files
+ maximum number of open pixel cache files. When this limit is exceeded, any subsequent pixels cached to disk are closed and reopened on demand. This behavior permits a large number of images to be accessed simultaneously on disk, but without a speed penalty due to repeated open/close calls.
+ thread
+ maximum number of threads that are permitted to run in parallel.
+ time
+ maximum number of seconds that the process is permitted to execute. Exceed this limit and an exception is thrown and processing stops.

Note, these limits pertain to the ImageMagick pixel cache. Certain algorithms within ImageMagick do not respect these limits nor does any of the external delegate libraries (e.g. JPEG, TIFF, etc.).

To determine the current setting of these limits, use this command:

-+
-> identify -list resource
Resource limits:
Width: 100MP
@@ -293,10 +293,10 @@ Resource limits:
Thread: 12
Throttle: 0
Time: unlimited
-

+

You can set these limits either as a security policy (see policy.xml), with an environment variable, with the -limit command line option, or with the SetMagickResourceLimit() MagickCore API method. As an example, our online web interface to ImageMagick, ImageMagick Studio, includes these policy limits to help prevent a denial-of-service:
-+
<policymap>
<policy domain="resource" name="temporary-path" value="/tmp"/>
<policy domain="resource" name="memory" value="256MiB"/>
@@ -314,13 +314,13 @@ Resource limits:
<policy domain="delegate" rights="none" pattern="HTTPS" />
<policy domain="path" rights="none" pattern="@*"/> 
</policymap>
-

+
Since we process multiple simultaneous sessions, we don't want any one session consuming all the available memory.With this policy, large images are cached to disk. If the image is too large and exceeds the pixel cache disk limit, the program exits. In addition, we place a time limit to prevent any run-away processing tasks. If any one image has a width or height that exceeds 8192 pixels, an exception is thrown and processing stops. As of ImageMagick 7.0.1-8 you can prevent the use of any delegate or all delegates (set the pattern to "*"). Note, prior to this release, use a domain of "coder" to prevent delegate usage (e.g. domain="coder" rights="none" pattern="HTTPS"). The policy also prevents indirect reads. If you want to, for example, read text from a file (e.g. caption:@myCaption.txt), you'll need to remove this policy.

Note, the cache limits are global to each invocation of ImageMagick, meaning if you create several images, the combined resource requirements are compared to the limit to determine the pixel cache storage disposition.

To determine which type and how much resources are consumed by the pixel cache, add the -debug cache option to the command-line:
--> convert -debug cache logo: -sharpen 3x2 null:
+-> convert -debug cache logo: -sharpen 3x2 null:
2016-12-17T13:33:42-05:00 0:00.000 0.000u 7.0.0 Cache convert: cache.c/DestroyPixelCache/1275/Cache
destroy
2016-12-17T13:33:42-05:00 0:00.000 0.000u 7.0.0 Cache convert: cache.c/OpenPixelCache/3834/Cache
@@ -337,22 +337,22 @@ Resource limits:
destroy LOGO[0]
2016-12-17T13:33:42-05:00 0:00.050 0.100u 7.0.0 Cache convert: cache.c/DestroyPixelCache/1275/Cache
destroy LOGO[0]
-

+
This command utilizes a pixel cache in memory. The logo consumed 4.688MiB and after it was sharpened, 3.516MiB.

Distributed Pixel Cache
A distributed pixel cache is an extension of the traditional pixel cache available on a single host. The distributed pixel cache may span multiple servers so that it can grow in size and transactional capacity to support very large images. Start up the pixel cache server on one or more machines. When you read or operate on an image and the local pixel cache resources are exhausted, ImageMagick contacts one or more of these remote pixel servers to store or retrieve pixels. The distributed pixel cache relies on network bandwidth to marshal pixels to and from the remote server. As such, it will likely be significantly slower than a pixel cache utilizing local storage (e.g. memory, disk, etc.).
-+
convert -distribute-cache 6668 & // start on 192.168.100.50
convert -define registry:cache:hosts=192.168.100.50:6668 myimage.jpg -sharpen 5x2 mimage.png
-

+

Cache Views

GetVirtualPixels(), GetAuthenticPixels(), QueueAuthenticPixels(), and SyncAuthenticPixels(), from the MagickCore API, can only deal with one pixel cache area per image at a time. Suppose you want to access the first and last scanline from the same image at the same time? The solution is to use a cache view. A cache view permits you to access as many areas simultaneously in the pixel cache as you require. The cache view methods are analogous to the previous methods except you must first open a view and close it when you are finished with it. Here is a snippet of MagickCore code that permits us to access the first and last pixel row of the image simultaneously:

-CacheView
+CacheView
*view_1,
*view_2;

@@ -373,7 +373,7 @@ view_2=DestroyCacheView(view_2);
view_1=DestroyCacheView(view_1);
if (y < (ssize_t) source->rows)
{ /* an exception was thrown */ }
-

+

Magick Persistent Cache Format

@@ -402,30 +402,30 @@ if (y < (ssize_t) source->rows)

If you are dealing with large images, make sure the pixel cache is written to a disk area with plenty of free space. Under Unix, this is typically /tmp and for Windows, c:/temp. You can tell ImageMagick to write the pixel cache to an alternate location and conserve memory with these options:

-+
convert -limit memory 2GB -limit map 4GB -define registry:temporary-path=/data/tmp ...
-

+

Set global resource limits for your environment in the policy.xml configuration file.

If you plan on processing the same image many times, consider the MPC format. Reading a MPC image has near-zero overhead because its in the native pixel cache format eliminating the need for decoding the image pixels. Here is an example:

-+
convert image.tif image.mpc
convert image.mpc -crop 100x100+0+0 +repage 1.png
convert image.mpc -crop 100x100+100+0 +repage 2.png
convert image.mpc -crop 100x100+200+0 +repage 3.png
-

+

MPC is ideal for web sites. It reduces the overhead of reading and writing an image. We use it exclusively at our online image studio.

-Streaming Pixels
+Streaming Pixels

ImageMagick provides for streaming pixels as they are read from or written to an image. This has several advantages over the pixel cache. The time and resources consumed by the pixel cache scale with the area of an image, whereas the pixel stream resources scale with the width of an image. The disadvantage is the pixels must be consumed as they are streamed so there is no persistence.

Use ReadStream() or WriteStream() with an appropriate callback method in your MagickCore program to consume the pixels as they are streaming. Here's an abbreviated example of using ReadStream:

-static size_t StreamPixels(const Image *image,const void *pixels,const size_t columns)
+static size_t StreamPixels(const Image *image,const void *pixels,const size_t columns)
{
register const Quantum
*p;
@@ -447,33 +447,33 @@ convert image.mpc -crop 100x100+200+0 +repage 3.png
/* invoke the pixel stream here */
image_info->client_data=(void *) MyData;
image=ReadStream(image_info,&StreamPixels,exception);
-

+

We also provide a lightweight tool, stream, to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components. A majority of the image formats stream pixels (red, green, and blue) from left to right and top to bottom. However, a few formats do not support this common ordering (e.g. the PSD format).

-Image Properties and Profiles
+Image Properties and Profiles

Images have metadata associated with them in the form of properties (e.g. width, height, description, etc.) and profiles (e.g. EXIF, IPTC, color management). ImageMagick provides convenient methods to get, set, or update image properties and get, set, update, or apply profiles. Some of the more popular image properties are associated with the Image structure in the MagickCore API. For example:

-(void) printf("image width: %lu, height: %lu\n",image->columns,image->rows);
-
+(void) printf("image width: %lu, height: %lu\n",image->columns,image->rows);
+

For a great majority of image properties, such as an image comment or description, we use the GetImageProperty() and SetImageProperty() methods. Here we set a property and fetch it right back:

-const char
+const char
*comment;

(void) SetImageProperty(image,"comment","This space for rent");
comment=GetImageProperty(image,"comment");
if (comment == (const char *) NULL)
(void) printf("Image comment: %s\n",comment);
-

+

ImageMagick supports artifacts with the GetImageArtifact() and SetImageArtifact() methods. Artifacts are stealth properties that are not exported to image formats (e.g. PNG).

Image profiles are handled with GetImageProfile(), SetImageProfile(), and ProfileImage() methods. Here we set a profile and fetch it right back:

-StringInfo
+StringInfo
*profile;

profile=AcquireStringInfo(length);
@@ -483,57 +483,57 @@ DestroyStringInfo(profile);
profile=GetImageProfile(image,"EXIF");
if (profile != (StringInfo *) NULL)
(void) PrintStringInfo(stdout,"EXIF",profile);
-

+

-Large Image Support
+Large Image Support
ImageMagick can read, process, or write mega-, giga-, or tera-pixel image sizes. An image width or height can range from 1 to 2 giga-pixels on a 32 bit OS and up to 9 exa-pixels on a 64-bit OS. Note, that some image formats have restrictions on image size. For example, Photoshop images are limited to 300,000 pixels for width or height. Here we resize an image to a quarter million pixels square:

-+
convert logo: -resize 250000x250000 logo.miff
-

+

For large images, ImageMagick will likely create a pixel cache on disk. Make sure you have plenty of temporary disk space. If your default temporary disk partition is too small, tell ImageMagick to use another partition with plenty of free space. For example:

-+
convert -define registry:temporary-path=/data/tmp logo: \
-resize 250000x250000 logo.miff
-

+

To ensure large images do not consume all the memory on your system, force the image pixels to memory-mapped disk with resource limits:

-+
convert -define registry:temporary-path=/data/tmp -limit memory 16mb \
logo: -resize 250000x250000 logo.miff
-

+

Here we force all image pixels to disk:

-+
convert -define registry:temporary-path=/data/tmp -limit area 0 \
logo: -resize 250000x250000 logo.miff
-

+

Caching pixels to disk is about 1000 times slower than memory. Expect long run times when processing large images on disk with ImageMagick. You can monitor progress with this command:

-convert -monitor -limit memory 2GiB -limit map 4GiB -define registry:temporary-path=/data/tmp \
+convert -monitor -limit memory 2GiB -limit map 4GiB -define registry:temporary-path=/data/tmp \
logo: -resize 250000x250000 logo.miff
-

+

For really large images, or if there is limited resources on your host, you can utilize a distributed pixel cache on one or more remote hosts:
-+
convert -distribute-cache 6668 & // start on 192.168.100.50
convert -distribute-cache 6668 & // start on 192.168.100.51
convert -limit memory 2mb -limit map 2mb -limit disk 2gb \
-define registry:cache:hosts=192.168.100.50:6668,192.168.100.51:6668 \
myhugeimage.jpg -sharpen 5x2 myhugeimage.png
-

+

-Threads of Execution
+Threads of Execution

Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips. However, you are welcome to use ImageMagick algorithms in your threads of execution with the exception of the MagickCore's GetVirtualPixels(), GetAuthenticPixels(), QueueAuthenticPixels(), or SyncAuthenticPixels() pixel cache methods. These methods are intended for one thread of execution only with the exception of an OpenMP parallel section. To access the pixel cache with more than one thread of execution, use a cache view. We do this for the CompositeImage() method, for example. Suppose we want to composite a single image over a different image in each thread of execution. If we use GetVirtualPixels(), the results are unpredictable because multiple threads would likely be asking for different areas of the pixel cache simultaneously. Instead we use GetCacheViewVirtualPixels() which creates a unique view for each thread of execution ensuring our program behaves properly regardless of how many threads are invoked. The other program interfaces, such as the MagickWand API, are completely thread safe so there are no special precautions for threads of execution.

Here is an MagickCore code snippet that takes advantage of threads of execution with the OpenMP programming paradigm:

-CacheView
+CacheView
*image_view;

MagickBooleanType
@@ -581,11 +581,11 @@ for (y=0; y < (ssize_t) image->rows; y++)
image_view=DestroyCacheView(image_view);
if (status == MagickFalse)
perror("something went wrong");
-

+

This code snippet converts an uncompressed Windows bitmap to a Magick++ image:

-#include "Magick++.h"
+#include "Magick++.h"
#include <assert.h>
#include "omp.h"

@@ -639,7 +639,7 @@ void ConvertBMPToImage(const BITMAPINFOHEADER *bmp_info,
image->syncPixels(); // sync pixels to pixel cache.
}
return;
-}

+}

If you call the ImageMagick API from your OpenMP-enabled application and you intend to dynamically increase the number of threads available in subsequent parallel regions, be sure to perform the increase before you call the API otherwise ImageMagick may fault.

@@ -647,21 +647,21 @@ void ConvertBMPToImage(const BITMAPINFOHEADER *bmp_info,

In most circumstances, the default number of threads is set to the number of processor cores on your system for optimal performance. However, if your system is hyperthreaded or if you are running on a virtual host and only a subset of the processors are available to your server instance, you might get an increase in performance by setting the thread policy or the MAGICK_THREAD_LIMIT environment variable. For example, your virtual host has 8 processors but only 2 are assigned to your server instance. The default of 8 threads can cause severe performance problems. One solution is to limit the number of threads to the available processors in your policy.xml configuration file:

-+
<policy domain="resource" name="thread" value="2"/>
-

+

Or suppose your 12 core hyperthreaded computer defaults to 24 threads. Set the MAGICK_THREAD_LIMIT environment variable and you will likely get improved performance:

-+
export MAGICK_THREAD_LIMIT=12
-

+

The OpenMP committee has not defined the behavior of mixing OpenMP with other threading models such as Posix threads. However, using modern releases of Linux, OpenMP and Posix threads appear to interoperate without complaint. If you want to use Posix threads from a program module that calls one of the ImageMagick application programming interfaces (e.g. MagickCore, MagickWand, Magick++, etc.) from Mac OS X or an older Linux release, you may need to disable OpenMP support within ImageMagick. Add the --disable-openmp option to the configure script command line and rebuild and reinstall ImageMagick.

Threading Performance
It can be difficult to predict behavior in a parallel environment. Performance might depend on a number of factors including the compiler, the version of the OpenMP library, the processor type, the number of cores, the amount of memory, whether hyperthreading is enabled, the mix of applications that are executing concurrently with ImageMagick, or the particular image-processing algorithm you utilize. The only way to be certain of optimal performance, in terms of the number of threads, is to benchmark. ImageMagick includes progressive threading when benchmarking a command and returns the elapsed time and efficiency for one or more threads. This can help you identify how many threads is the most efficient in your environment. For this benchmark we sharpen a 1920x1080 image of a model 10 times with 1 to 12 threads:
-+
-> convert -bench 10 model.png -sharpen 5x2 null:
Performance[1]: 10i 1.135ips 1.000e 8.760u 0:08.810
Performance[2]: 10i 2.020ips 0.640e 9.190u 0:04.950
@@ -675,31 +675,31 @@ Performance[9]: 10i 4.484ips 0.798e 12.860u 0:02.230
Performance[10]: 10i 4.274ips 0.790e 14.830u 0:02.340
Performance[11]: 10i 4.348ips 0.793e 16.500u 0:02.300
Performance[12]: 10i 4.525ips 0.799e 18.320u 0:02.210
-

+
The sweet spot for this example is 6 threads. This makes sense since there are 6 physical cores. The other 6 are hyperthreads. It appears that sharpening does not benefit from hyperthreading.
In certain cases, it might be optimal to set the number of threads to 1 or to disable OpenMP completely with the MAGICK_THREAD_LIMIT environment variable, -limit command line option, or the policy.xml configuration file.

-Heterogeneous Distributed Processing
+Heterogeneous Distributed Processing
ImageMagick includes support for heterogeneous distributed processing with the OpenCL framework. OpenCL kernels within ImageMagick permit image processing algorithms to execute across heterogeneous platforms consisting of CPUs, GPUs, and other processors. Depending on your platform, speed-ups can be an order of magnitude faster than the traditional single CPU.

First verify that your version of ImageMagick includes support for the OpenCL feature:

-+
identify -version
Features: DPC Cipher Modules OpenCL OpenMP
-

+

If so, run this command to realize a significant speed-up for image convolution:

-+
convert image.png -convolve '-1, -1, -1, -1, 9, -1, -1, -1, -1' convolve.png
-

+

If an accelerator is not available or if the accelerator fails to respond, ImageMagick reverts to the non-accelerated convolution algorithm.

Here is an example OpenCL kernel that convolves an image:

-static inline long ClampToCanvas(const long offset,const ulong range)
+static inline long ClampToCanvas(const long offset,const ulong range)
{
if (offset < 0L)
return(0L);
@@ -755,19 +755,19 @@ __kernel void Convolve(const __global CLPixelType *source,__constant float *filt
destination[index].y=ClampToQuantum(gamma*sum.y);
destination[index].z=ClampToQuantum(gamma*sum.z);
destination[index].w=ClampToQuantum(sum.w);
-};

+};

See magick/accelerate.c for a complete implementation of image convolution with an OpenCL kernel.

Note, that under Windows, you might have an issue with TDR (Timeout Detection and Recovery of GPUs). Its purpose is to detect runaway tasks hanging the GPU by using an execution time threshold. For some older low-end GPUs running the OpenCL filters in ImageMagick, longer execution times might trigger the TDR mechanism and pre-empt the GPU image filter. When this happens, ImageMagick automatically falls back to the CPU code path and returns the expected results. To avoid pre-emption, increase the TdrDelay registry key.

-Custom Image Coders
+Custom Image Coders

An image coder (i.e. encoder / decoder) is responsible for registering, optionally classifying, optionally reading, optionally writing, and unregistering one image format (e.g. PNG, GIF, JPEG, etc.). Registering an image coder alerts ImageMagick a particular format is available to read or write. While unregistering tells ImageMagick the format is no longer available. The classifying method looks at the first few bytes of an image and determines if the image is in the expected format. The reader sets the image size, colorspace, and other properties and loads the pixel cache with the pixels. The reader returns a single image or an image sequence (if the format supports multiple images per file), or if an error occurs, an exception and a null image. The writer does the reverse. It takes the image properties and unloads the pixel cache and writes them as required by the image format.

Here is a listing of a sample custom coder. It reads and writes images in the MGK image format which is simply an ID followed by the image width and height followed by the RGB pixel values.

-/*
+/*
Include declarations.
*/
#include "magick/studio.h"
@@ -1167,23 +1167,23 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)
} while (image_info->adjoin != MagickFalse);
(void) CloseBlob(image);
return(MagickTrue);
-}

+}

To invoke the custom coder from the command line, use these commands:

-convert logo: logo.mgk
+convert logo: logo.mgk
display logo.mgk
-

+

We provide the Magick Coder Kit to help you get started writing your own custom coder.

-Custom Image Filters
+Custom Image Filters

ImageMagick provides a convenient mechanism for adding your own custom image processing algorithms. We call these image filters and they are invoked from the command line with the -process option or from the MagickCore API method ExecuteModuleProcess().

Here is a listing of a sample custom image filter. It computes a few statistics such as the pixel brightness and saturation mean and standard-deviation.

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
@@ -1380,11 +1380,11 @@ ModuleExport size_t analyzeImage(Image **images,const int argc,const char **argv
(void) SetImageProperty(image,"filter:saturation:skewness",text);
}
return(MagickImageFilterSignature);
-}

+}

To invoke the custom filter from the command line, use this command:

-convert logo: -process \"analyze\" -verbose info:
+convert logo: -process \"analyze\" -verbose info:
Image: logo:
Format: LOGO (ImageMagick Logo)
Class: PseudoClass
@@ -1398,7 +1398,7 @@ ModuleExport size_t analyzeImage(Image **images,const int argc,const char **argv
filter:saturation:mean: 5951.55
filter:saturation:skewness: 2.42848
filter:saturation:standard-deviation: 15575.9
-

+

We provide the Magick Filter Kit to help you get started writing your own custom image filter.
@@ -1423,4 +1423,4 @@ ModuleExport size_t analyzeImage(Image **images,const int argc,const char **argv

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/changelog.html b/www/changelog.html
index bb70eaa2d..2708e3e3f 100644
--- a/www/changelog.html
+++ b/www/changelog.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

-2017-06-02 7.0.5-10 Cristy <quetzlzacatenango@image...>
+
+2017-06-10 7.0.6-0 Cristy <quetzlzacatenango@image...>
+ Release ImageMagick version 7.0.6-0, GIT revision 20194:b0c0d00:20170611.
+2017-06-10 7.0.6-1 Glenn Randers-Pehrson <glennrp@image...>
+ coders/png.c: Accept exIf chunks whose data segment erroneously begins with "Exif\0\0".
+2017-06-10 7.0.6-0 Cristy <quetzlzacatenango@image...>
+ Introduce SetMagickSecurityPolicy() (MagickCore) and MagickSetSecurityPolicy() (MagickWand) to set the ImageMagick security policy (reference https://github.com/ImageMagick/ImageMagick/issues/407).
+2017-06-02 7.0.5-10 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-10, GIT revision 20155:38ebc02:20170602.
-2017-06-01 7.0.5-10 Glenn Randers-Pehrson <glennrp@image...>
- Removed experimental zxIF chunk support; the proposal is dead.
-2017-06-01 7.0.5-10 Cristy <quetzlzacatenango@image...>
+2017-06-01 7.0.5-10 Glenn Randers-Pehrson <glennrp@image...>
+ Removed experimental PNG zxIF chunk support; the proposal is dead.
+2017-06-01 7.0.5-10 Cristy <quetzlzacatenango@image...>
Fix choppy bitmap font rendering (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=32071).
The +opaque option is not longer a noop (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=32081).
Add support for 'hex:' property.
-2017-05-28 7.0.5-9 Cristy <quetzlzacatenango@image...>
+2017-05-28 7.0.5-9 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-9, GIT revision 20113:8b67333:20170528.
-2017-05-28 7.0.5-9 Cristy <quetzlzacatenango@image...>
+2017-05-28 7.0.5-9 Cristy <quetzlzacatenango@image...>
Transient error validating the JPEG-2000 image format (reference https://github.com/ImageMagick/ImageMagick/issues/501).
Properly allocate DCM image colormap (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=32063).
-2017-05-26 7.0.5-8 Cristy <quetzlzacatenango@image...>
+2017-05-26 7.0.5-8 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-8, GIT revision 20099:870a016:20170526.
-2017-05-23 7.0.5-8 Cristy <quetzlzacatenango@image...>
+2017-05-23 7.0.5-8 Cristy <quetzlzacatenango@image...>
Improper allocation of memory for IM instances without threads (reference https://github.com/ImageMagick/ImageMagick/issues/497).
Delete corrupt image from list (reference https://github.com/ImageMagick/ImageMagick/issues/500).
-2017-05-19 7.0.5-7 Cristy <quetzlzacatenango@image...>
+2017-05-19 7.0.5-7 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-6, GIT revision 20078:7ce2d38:20170519.
-2017-05-15 7.0.5-7 Cristy <quetzlzacatenango@image...>
+2017-05-15 7.0.5-7 Cristy <quetzlzacatenango@image...>
Support various image operators for the compare utility (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=2&t=31938).
2017-05-12 7.0.5-6 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-6, GIT revision 20039:9371904:20170512.
-2017-05-10 7.0.5-6 John Cupitt <jcupitt@gmail.com>
+2017-05-10 7.0.5-6 John Cupitt <jcupitt@gmail.com>
Revise DICOM window and rescale handling (reference https://github.com/ImageMagick/ImageMagick/pull/484)
-2017-05-06 7.0.5-6 Cristy <quetzlzacatenango@image...>
+2017-05-06 7.0.5-6 Cristy <quetzlzacatenango@image...>
Restore the -alpha Shape option (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31879).
Fix transient PDF bug (reference https://github.com/ImageMagick/ImageMagick/issues/463).
The +opaque option now works on all channels (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31862).
Ensure backwards compatibility for the -combine option (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31855).
Check for EOF conditions for RLE image format.
Reset histogram page geometry (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31920).
-2017-04-24 7.0.5-5 Cristy <quetzlzacatenango@image...>
+2017-04-24 7.0.5-5 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-5, GIT revision 19915:12eec43:20170424.
-2017-03-26 7.0.5-5 Cristy <quetzlzacatenango@image...>
+2017-03-26 7.0.5-5 Cristy <quetzlzacatenango@image...>
Minimize buffer copies to improve OpenCL performance.
Morphology thinning is no longer a no-op (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31650).
Patch two PCD writer problems, corrupt output and dark pixels (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=3164).
Support ICC based PDF's (reference https://github.com/ImageMagick/ImageMagick/issues/417).
Fix improper EPS clip path rendering (reference http://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31722).
-2017-03-24 7.0.5-4 Cristy <quetzlzacatenango@image...>
+2017-03-24 7.0.5-4 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-4, GIT revision 19754:350fff3:20170324.
-2017-03-21 7.0.5-4 Cristy <quetzlzacatenango@image...>
+2017-03-21 7.0.5-4 Cristy <quetzlzacatenango@image...>
Respect -loop option for animate -window (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31619).
-2017-03-17 7.0.5-3 Cristy <quetzlzacatenango@image...>
+2017-03-17 7.0.5-3 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-3, GIT revision 19741:070c3fb:20170317.
-2017-03-14 7.0.5-3 Cristy <quetzlzacatenango@image...>
+2017-03-14 7.0.5-3 Cristy <quetzlzacatenango@image...>
Support namespaces for the security policy.
Support the -authenticate option for PDF (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31530).
-2017-03-11 7.0.5-2 Cristy <quetzlzacatenango@image...>
+2017-03-11 7.0.5-2 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-2, GIT revision 19696:da91a7c:20170311.
-2017-03-06 7.0.5-2 Cristy <quetzlzacatenango@image...>
+2017-03-06 7.0.5-2 Cristy <quetzlzacatenango@image...>
Respect throttle policy (reference https://github.com/ImageMagick/ImageMagick/issues/393).
Return proper minima / maxima (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31377).
-2017-03-03 7.0.5-1 Cristy <quetzlzacatenango@image...>
+2017-03-03 7.0.5-1 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-1, GIT revision 19662:b7f455a:20170303.
-2017-02-21 7.0.5-1 Cristy <quetzlzacatenango@image...>
+2017-02-21 7.0.5-1 Cristy <quetzlzacatenango@image...>
Fix Spurious memory allocation message (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31438).
Identical images should return inf for PSNR (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31487).
-2017-02-20 7.0.5-0 Cristy <quetzlzacatenango@image...>
+2017-02-20 7.0.5-0 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.5-0, GIT revision 19616:505fea9:20170220.
-2017-02-20 7.0.5-0 Cristy <quetzlzacatenango@image...>
+2017-02-20 7.0.5-0 Cristy <quetzlzacatenango@image...>
Fix transient bug with -separate option (reference https://github.com/ImageMagick/ImageMagick/issues/385).
-2017-02-18 7.0.4-10 Cristy <quetzlzacatenango@image...>
+2017-02-18 7.0.4-10 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-10, GIT revision 19608:fe757a2:20170218.
-2017-02-18 7.0.4-10 Dirk Lemstra <dirk@lem.....org>
+2017-02-18 7.0.4-10 Dirk Lemstra <dirk@lem.....org>
Fixed fd leak for webp coder (reference https://github.com/ImageMagick/ImageMagick/pull/382)
-2017-02-15 7.0.4-10 Cristy <quetzlzacatenango@image...>
+2017-02-15 7.0.4-10 Cristy <quetzlzacatenango@image...>
Prevent random pixel data for corrupt JPEG image (bug report from Hirokazu Moriguchi, Sony).
Restore -mattecolor option.
Support pixel-cache and shred security policies.
Bump Magick++ SO. Previously a global replace changed matteColor to alphaColor.
-2017-02-14 7.0.4-9 Cristy <quetzlzacatenango@image...>
+2017-02-14 7.0.4-9 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-9, GIT revision 19580:d474b37:20170214.
-2017-02-14 7.0.4-9 Cristy <quetzlzacatenango@image...>
+2017-02-14 7.0.4-9 Cristy <quetzlzacatenango@image...>
Revert patch that did not set update trait on alpha channel.
-2017-02-13 7.0.4-8 Cristy <quetzlzacatenango@image...>
+2017-02-13 7.0.4-8 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-8, GIT revision 19574:7642384:20170213.
-2017-02-09 7.0.4-8 Dirk Lemstra <dirk@lem.....org>
+2017-02-09 7.0.4-8 Dirk Lemstra <dirk@lem.....org>
Fixed memory leak when creating nested exceptions in Magick++ (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=23&p=142634)
-2017-02-09 7.0.4-8 Cristy <quetzlzacatenango@image...>
+2017-02-09 7.0.4-8 Cristy <quetzlzacatenango@image...>
Unbreak build without JPEG support (reference https://github.com/ImageMagick/ImageMagick/pull/373).
Document behavior change in the security policy (thanks to yoya @ https://blog.awm.jp/2017/02/09/imagemagick-en/).
Return unbiased standard deviation for image statistics (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31377).
Don't set update trait on alpha channel (private e-mail concerning -levels-colors option).
-2017-02-04 7.0.4-7 Cristy <quetzlzacatenango@image...>
+2017-02-04 7.0.4-7 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-7, GIT revision 19513:5783e57:20170204.
-2017-01-28 7.0.4-7 Cristy <quetzlzacatenango@image...>
+2017-01-28 7.0.4-7 Cristy <quetzlzacatenango@image...>
Sanitize comments that include braces for the MIFF image format (reference https://github.com/ImageMagick/ImageMagick/issues/368).
-2017-01-27 7.0.4-7 Glenn Randers-Pehrson <glennrp@image...>
+2017-01-27 7.0.4-7 Glenn Randers-Pehrson <glennrp@image...>
coders/png.c: Added support for a proposed new PNG chunk (zxIf, read-only) that is currently being discussed on the png-mng-misc at lists.sourceforge.net mailing list. Enable exIf and zxIf with CPPFLAGS="-DexIf_SUPPORTED -DxzIf_SUPPORTED". If exIf is enabled, only the uncompressed exIF chunk will be written and the hex-encoded zTXt chunk containing the raw Exif profile won't be written.
-2017-01-27 7.0.4-6 Cristy <quetzlzacatenango@image...>
+2017-01-27 7.0.4-6 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-6, GIT revision 19442:4747de9:20170127.
-2017-01-27 7.0.4-6 Cristy <quetzlzacatenango@image...>
+2017-01-27 7.0.4-6 Cristy <quetzlzacatenango@image...>
Uninitialized data in MAT image format (reference https://github.com/ImageMagick/ImageMagick/issues/362).
Properly auto-fit caption (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30887).
Correction to composite Over operator (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31282).
Respect gravity option (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31284).
-2017-01-22 7.0.4-6 Glenn Randers-Pehrson <glennrp@image...>
+2017-01-22 7.0.4-6 Glenn Randers-Pehrson <glennrp@image...>
Renamed read_vpag_chunk_callback() function to png_user_chunk_callback() in coders/png.c
Implemented a private PNG caNv (canvas) chunk for remembering the original dimensions and offsets when an image is cropped. Previously we used the oFFs and vpAg chunks for this purpose, but this had potential conflicts with other applications that also use the oFFs chunk.
coders/png.c: Added support for a proposed new PNG chunk (exIf read-write, eXIf read-only) that is currently being discussed on the png-mng-misc at lists.sourceforge.net mailing list.
-2017-01-22 7.0.4-6 Dirk Lemstra <dirk@lem.....org>
+2017-01-22 7.0.4-6 Dirk Lemstra <dirk@lem.....org>
Replaced CoderSeekableStreamFlag with CoderDecoderSeekableStreamFlag and CoderEncoderSeekableStreamFlag.
-2017-01-21 7.0.4-5 Cristy <quetzlzacatenango@image...>
+2017-01-21 7.0.4-5 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-5, GIT revision 19381:7ae396f:20170121.
-2017-01-18 7.0.4-5 Cristy <quetzlzacatenango@image...>
+2017-01-18 7.0.4-5 Cristy <quetzlzacatenango@image...>
Don't set background for transparent tiled images (reference http://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31210).
-2017-01-14 7.0.4-4 Cristy <quetzlzacatenango@image...>
+2017-01-14 7.0.4-4 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-4, GIT revision 19361:a12953c:20170114.
-2017-01-14 7.0.4-4 Dirk Lemstra <dirk@lem.....org>
+2017-01-14 7.0.4-4 Dirk Lemstra <dirk@lem.....org>
Added support for RGB555, RGB565, ARGB4444 and ARGB1555 to the BMP encoder (reference https://github.com/ImageMagick/ImageMagick/issues/344).
-2017-01-10 7.0.4-4 Cristy <quetzlzacatenango@image...>
+2017-01-10 7.0.4-4 Cristy <quetzlzacatenango@image...>
Recognize XML policy closing tags (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31182).
Fix memory leak in the MPC format.
-2017-01-07 7.0.4-3 Cristy <quetzlzacatenango@image...>
+2017-01-07 7.0.4-3 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-3, GIT revision 19329:930ca78:20170107.
-2017-01-04 7.0.4-3 Cristy <quetzlzacatenango@image...>
+2017-01-04 7.0.4-3 Cristy <quetzlzacatenango@image...>
Increase memory allocation for TIFF pixels (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31161).
-2017-01-03 7.0.4-2 Cristy <quetzlzacatenango@image...>
+2017-01-03 7.0.4-2 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-2, GIT revision 19318:8766311:20170103.
-2017-01-02 7.0.4-2 Cristy <quetzlzacatenango@image...>
+2017-01-02 7.0.4-2 Cristy <quetzlzacatenango@image...>
Validation unit test for MNG works again.
-2016-12-31 7.0.4-1 Cristy <quetzlzacatenango@image...>
+2016-12-31 7.0.4-1 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-1, GIT revision 19292:c5ccfa8:20161231.
-2016-12-26 7.0.4-1 Cristy <quetzlzacatenango@image...>
+2016-12-26 7.0.4-1 Cristy <quetzlzacatenango@image...>
Initialize draw_info alpha member to OpaqueAlpha.
Monochrome images no longer have inverted colors (reference https://github.com/ImageMagick/ImageMagick/issues/332).
-2016-12-18 7.0.4-0 Cristy <quetzlzacatenango@image...>
+2016-12-18 7.0.4-0 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.4-0, GIT revision 19221:d5e8abc:20161218.
-2016-12-14 7.0.4-0 Cristy <quetzlzacatenango@image...>
+2016-12-14 7.0.4-0 Cristy <quetzlzacatenango@image...>
Do not close path for linejoins of round (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31039).
-2016-12-10 7.0.3-10 Cristy <quetzlzacatenango@image...>
+2016-12-10 7.0.3-10 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-10, GIT revision 19191:338f088:20161210.
-2016-12-07 7.0.3-10 Cristy <quetzlzacatenango@image...>
+2016-12-07 7.0.3-10 Cristy <quetzlzacatenango@image...>
Set colorspace to sRGB if -append has non-homogenous colorspaces (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29105).
Respect connected-components:area-threshold define (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31006).
Enable alpha channel if background color is non-opaque (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31016).
Return correct offset for negative index for -fx option (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31019).
Fixed improper scaling of certain FITS images (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31028).
Properly center text label (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=31027).
-2016-12-05 7.0.3-9 Cristy <quetzlzacatenango@image...>
+2016-12-05 7.0.3-9 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-9, GIT revision 19139:6fed3f1:20161205.
-2016-11-26 7.0.3-9 Cristy <quetzlzacatenango@image...>
+2016-11-26 7.0.3-9 Cristy <quetzlzacatenango@image...>
Support the compare -read-mask option.
Support read-masks for the -modulate option.
Prevent buffer overflow when streaming an image (reference https://github.com/ImageMagick/ImageMagick/issues/312).
Fix possible buffer overflow when writing compressed TIFFS (vulnerability report from Cisco Talos, CVE-2016-8707).
-2016-11-15 7.0.3-8 Cristy <quetzlzacatenango@image...>
+2016-11-15 7.0.3-8 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-8, GIT revision 19067:5aceded:20161125.
-2016-11-18 7.0.3-8 Cristy <quetzlzacatenango@image...>
+2016-11-18 7.0.3-8 Cristy <quetzlzacatenango@image...>
Support the phash:colorspaces and phash:normalize options.
If a convenient line break is not found, force it for caption: (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30887).
Set alpha member of draw structure to OpaqueAlpha (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30894).
@@ -216,186 +222,186 @@
Permit EPT images with just a TIFF or EPS image, not both (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30921).
The -clone option no longer leaks memory.
Render to clip mask rather than image for clip-path MVG graphics primitive.
-2016-11-15 7.0.3-7 Cristy <quetzlzacatenango@image...>
+2016-11-15 7.0.3-7 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-7, GIT revision 19024:87aca83:20161115.
-2016-11-10 7.0.3-7 Cristy <quetzlzacatenango@image...>
+2016-11-10 7.0.3-7 Cristy <quetzlzacatenango@image...>
Web pages were broken when we moved to HTTPS protocol.
-2016-11-08 7.0.3-6 Cristy <quetzlzacatenango@image...>
+2016-11-08 7.0.3-6 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-6, GIT revision 19001:4cff747:20161108.
-2016-11-01 7.0.3-6 Cristy <quetzlzacatenango@image...>
+2016-11-01 7.0.3-6 Cristy <quetzlzacatenango@image...>
Off by one memory allocation (reference https://github.com/ImageMagick/ImageMagick/issues/296).
The -extent option now matches the results of IMv6 (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=1&t=30779).
Prevent fault in MSL interpreter (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30797).
Mask composite produces proper results for the convert utility (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29675).
-2016-10-10 7.0.3-5 Cristy <quetzlzacatenango@image...>
+2016-10-10 7.0.3-5 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-5, GIT revision 18975:a8174a2:20161030.
-2016-10-16 7.0.3-5 Dirk Lemstra <dirk@lem.....org>
+2016-10-16 7.0.3-5 Dirk Lemstra <dirk@lem.....org>
Added layer RLE compression to the PSD encoder.
-2016-10-10 7.0.3-4 Cristy <quetzlzacatenango@image...>
+2016-10-10 7.0.3-4 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-4, GIT revision 18937:83da034:20161010.
-2016-10-10 7.0.3-4 Dirk Lemstra <dirk@lem.....org>
+2016-10-10 7.0.3-4 Dirk Lemstra <dirk@lem.....org>
Fixed incorrect parsing with ordered dither. (reference https://github.com/ImageMagick/ImageMagick/issues/254)
-2016-10-10 7.0.3-4 Cristy <quetzlzacatenango@image...>
+2016-10-10 7.0.3-4 Cristy <quetzlzacatenango@image...>
Unit test pass again after small SUN image patch.
-2016-10-08 7.0.3-3 Cristy <quetzlzacatenango@image...>
+2016-10-08 7.0.3-3 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-3, GIT revision 18924:d6614e7:20161008.
-2016-10-07 7.0.3-3 Dirk Lemstra <dirk@lem.....org>
+2016-10-07 7.0.3-3 Dirk Lemstra <dirk@lem.....org>
Fixed incorrect RLE decoding when reading a DCM image that contains multiple segments.
-2016-10-02 7.0.3-2 Cristy <quetzlzacatenango@image...>
+2016-10-02 7.0.3-2 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-2, GIT revision 18887:6b27c5b:20161002.
-2016-09-27 7.0.3-2 Dirk Lemstra <dirk@lem.....org>
+2016-09-27 7.0.3-2 Dirk Lemstra <dirk@lem.....org>
Fixed incorrect RLE decoding when reading an SGI image (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30514)
-2016-09-20 7.0.3-1 Cristy <quetzlzacatenango@image...>
+2016-09-20 7.0.3-1 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-1, GIT revision 18851:ad91ea8:20160920.
-2016-09-16 7.0.3-1 Dirk Lemstra <dirk@lem.....org>
+2016-09-16 7.0.3-1 Dirk Lemstra <dirk@lem.....org>
Added layer RLE compression to the PSD encoder.
Added define 'psd:preserve-opacity-mask' to preserve the opacity mask in a PSD file.
Fixed issue where the display window was used instead of the data window when reading EXR files (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&p=137849).
-2016-09-05 7.0.3-0 Cristy <quetzlzacatenango@image...>
+2016-09-05 7.0.3-0 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.3-0, GIT revision 18786:10aa64c:20160905.
-2016-08-29 7.0.3-0 Dirk Lemstra <dirk@lem.....org>
+2016-08-29 7.0.3-0 Dirk Lemstra <dirk@lem.....org>
Fixed reading DXT1 images with an alpha channel.
Fixed incorrect padding calculation in PSD encoder.
-2016-08-27 7.0.2-10 Cristy <quetzlzacatenango@image...>
+2016-08-27 7.0.2-10 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-10, GIT revision 18750:e3335b3:20160827.
-2016-08-27 7.0.2-10 Dirk Lemstra <dirk@lem.....org>
+2016-08-27 7.0.2-10 Dirk Lemstra <dirk@lem.....org>
Added define 'psd:additional-info' to preserve the additional information in a PSD file.
-2016-08-15 7.0.2-10 Cristy <quetzlzacatenango@image...>
+2016-08-15 7.0.2-10 Cristy <quetzlzacatenango@image...>
Prevent buffer overflow in BMP & SGI coders (bug report from pwchen&rayzhong of tencent).
Prevent buffer overflow and other problems in SIXEL, PDB, MAP, TIFF and CALS coders (bug report from Donghai Zhu).
The -stream option now increments the pixel pointer properly (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30327).
-2016-08-14 7.0.2-9 Cristy <quetzlzacatenango@image...>
+2016-08-14 7.0.2-9 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-9, GIT revision 18707:2c02f09:20160814.
-2016-08-14 7.0.2-9 Cristy <quetzlzacatenango@image...>
+2016-08-14 7.0.2-9 Cristy <quetzlzacatenango@image...>
Fix compile error in opencl.c (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30289).
Eliminate compiler warning.
-2016-08-14 7.0.2-8 Cristy <quetzlzacatenango@image...>
+2016-08-14 7.0.2-8 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-8, GIT revision 18698:74b1d5d:20160814.
-2016-08-07 7.0.2-8 Cristy <quetzlzacatenango@image...>
+2016-08-07 7.0.2-8 Cristy <quetzlzacatenango@image...>
Prevent spurious removal of MPC cache files (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30256).
Note alpha channel when combining 4 or more images (reference https://github.com/ImageMagick/ImageMagick/issues/250).
-2016-08-06 7.0.2-7 Cristy <quetzlzacatenango@image...>
+2016-08-06 7.0.2-7 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-7, GIT revision 10980:ecc03a2:20160806.
-2016-08-01 7.0.2-7 Cristy <quetzlzacatenango@image...>
+2016-08-01 7.0.2-7 Cristy <quetzlzacatenango@image...>
Evaluate lazy pixel cache morphology to prevent buffer overflow (bug report from Ibrahim M. El-Sayed).
Prevent buffer overflow (bug report from Max Thrane).
Prevent memory use after free (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=30245).
-2016-07-30 7.0.2-6 Cristy <quetzlzacatenango@image...>
+2016-07-30 7.0.2-6 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-6, GIT revision 18651:df24175:20160729.
-2016-07-29 7.0.2-6 Cristy <quetzlzacatenango@image...>
+2016-07-29 7.0.2-6 Cristy <quetzlzacatenango@image...>
Support -region option (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=1&t=29692).
-2016-07-21 7.0.2-5 Cristy <quetzlzacatenango@image...>
+2016-07-21 7.0.2-5 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-5, GIT revision 18627:2b5ddbd:20160721.
-2016-07-13 7.0.2-5 Cristy <quetzlzacatenango@image...>
+2016-07-13 7.0.2-5 Cristy <quetzlzacatenango@image...>
Fix MVG stroke-opacity (reference https://github.com/ImageMagick/ImageMagick/issues/229).
Prevent possible buffer overflow when reading TIFF images (bug report from Shi Pu of MS509 Team).
Initialize index channel to get expected results from the stegano coder.
-2016-07-11 7.0.2-4 Cristy <quetzlzacatenango@image...>
+2016-07-11 7.0.2-4 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-4, GIT revision 18591:50debe5:20160710.
-2016-07-10 7.0.2-4 Cristy <quetzlzacatenango@image...>
+2016-07-10 7.0.2-4 Cristy <quetzlzacatenango@image...>
To comply with the SVG standard, use stroke-opacity for transparent strokes.
Define CompositeChannels mask to Red, Green, Blue, Alpha, and Black.
-2016-07-09 7.0.2-3 Cristy <quetzlzacatenango@image...>
+2016-07-09 7.0.2-3 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-3, GIT revision 18572:28560fc:20160709.
-2016-07-01 7.0.2-3 Cristy <quetzlzacatenango@image...>
+2016-07-01 7.0.2-3 Cristy <quetzlzacatenango@image...>
Patch so -kuwahara option can preserve colormapped edges.
The histogram coder now returns the correct extent.
Use CopyMagickString() rather than CopyMagickMemory() for strings.
-2016-06-26 7.0.2-2 Cristy <quetzlzacatenango@image...>
+2016-06-26 7.0.2-2 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-2, GIT revision 18514:a7b5b46:20160626.
-2016-06-23 7.0.2-2 Cristy <quetzlzacatenango@image...>
- Correct for numerical instability (reference https://github.com/ImageMagick/ImageMagick/issues/218).
+2016-06-23 7.0.2-2 Cristy <quetzlzacatenango@image...>
+
Correct for numerical instability (reference https://github.com/ImageMagick/ImageMagick/issues/218).

2016-06-21 7.0.2-1 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-1, GIT revision 18479:931319b:20160622.
-2016-06-17 7.0.2-1 Dirk Lemstra <dirk@lem.....org>
+2016-06-17 7.0.2-1 Dirk Lemstra <dirk@lem.....org>
Added support for GROUP4 compression to the FAX coder.
-2016-06-12 7.0.2-1 Cristy <quetzlzacatenango@image...>
+2016-06-12 7.0.2-1 Cristy <quetzlzacatenango@image...>
Distort no longer converts grayscale image to sRGB (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=1&t=29895).
Don't return a zero bounding box for QueryMultilineFontMetrics() (reference https://github.com/ImageMagick/ImageMagick/issues/222).
-2016-06-12 7.0.2-0 Cristy <quetzlzacatenango@image...>
+2016-06-12 7.0.2-0 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.2-0, GIT revision 10884:f0e15e8:20160612.
-2016-06-09 7.0.2-0 Cristy <quetzlzacatenango@image...>
+2016-06-09 7.0.2-0 Cristy <quetzlzacatenango@image...>
Backoff finite precision epsilon (reference https://github.com/ImageMagick/ImageMagick/issues/215).
Fix drawing glitch for stroke widths greater than 2 (reference https://github.com/ImageMagick/ImageMagick/issues/218).
-2016-06-05 7.0.1-10 Cristy <quetzlzacatenango@image...>
+2016-06-05 7.0.1-10 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-10, GIT revision 18406:ba4ad2d:20160607.
-2016-06-04 7.0.1-10 Cristy <quetzlzacatenango@image...>
+2016-06-04 7.0.1-10 Cristy <quetzlzacatenango@image...>
Deny indirect reads by policy, remove policy to permit, e.g., convert caption:@mytext.txt ...
RLE check for pixel offset less than 0 (heap overflow report from Craig Young).
Properly initialze PES blocks (reference https://github.com/ImageMagick/ImageMagick/issues/213).
-2016-06-03 7.0.1-9 Cristy <quetzlzacatenango@image...>
+2016-06-03 7.0.1-9 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-9, GIT revision 10847:339f803:20160602.
-2016-06-02 7.0.1-9 Cristy <quetzlzacatenango@image...>
+2016-06-02 7.0.1-9 Cristy <quetzlzacatenango@image...>
Fix small memory leak (patch provided by ÐÐ½Ð´ÑÐµÐ¹ Ð§ÐµÑÐ½ÑÐ¹).
Coder path traversal is not authorized (bug report provided by Masaaki Chida).
Turn off alpha channel for the compare difference image (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29828).
-2016-05-31 7.0.1-8 Cristy <quetzlzacatenango@image...>
+2016-05-31 7.0.1-8 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-8, GIT revision 18334:97775b5:20160531.
-2016-05-31 7.0.1-8 Cristy <quetzlzacatenango@image...>
+2016-05-31 7.0.1-8 Cristy <quetzlzacatenango@image...>
Support configure script --enable-pipes option to enable pipes (|) in filenames.
Support configure script --enable-indirect-reads option to enable indirect reads (@) in filenames.
-2016-05-30 7.0.1-7 Cristy <quetzlzacatenango@image...>
+2016-05-30 7.0.1-7 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-7, GIT revision 18321:5511ef5:20160530.
-2016-05-25 7.0.1-7 Cristy <quetzlzacatenango@image...>
+2016-05-25 7.0.1-7 Cristy <quetzlzacatenango@image...>
Security improvements to TEXT coder broke it (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29754).
Fix stroke offset problem for -annotate (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29626).
Don't interpret -fx option arguments (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29774);
Add additional checks to DCM reader to prevent data-driven faults (bug report from Hanno BÃ¶ck).
-2016-05-21 7.0.1-6 Cristy <quetzlzacatenango@image...>
+2016-05-21 7.0.1-6 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-6, GIT revision 18241:d4f277c:20160521.
-2016-05-20 7.0.1-6 Cristy <quetzlzacatenango@image...>
+2016-05-20 7.0.1-6 Cristy <quetzlzacatenango@image...>
Fixed proper placement of text annotation for east / west gravity.
-2016-05-18 7.0.1-5 Cristy <quetzlzacatenango@image...>
+2016-05-18 7.0.1-5 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-5, GIT revision 10789:f7c2e89:20160518,
-2016-05-18 7.0.1-5 Cristy <quetzlzacatenango@image...>
+2016-05-18 7.0.1-5 Cristy <quetzlzacatenango@image...>
Process channels independently for -channel -equalize (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=29708).
Fix pixel cache on disk regression (reference https://github.com/ImageMagick/ImageMagick/issues/202).
-2016-05-15 7.0.1-4 Cristy <quetzlzacatenango@image...>
+2016-05-15 7.0.1-4 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-4, GIT revision 10778:52dae14:20160516.
-2016-05-10 7.0.1-4 Cristy <quetzlzacatenango@image...>
+2016-05-10 7.0.1-4 Cristy <quetzlzacatenango@image...>
Prevent possible shell command injection vulnerability through the authenticate parameter of the PDF, PCL and XPS coders (report from Erez Turjeman).
Quote passwords when passed to a delegate program.
Iterate channels over source image rather than destination (bug report from Hanno BÃ¶ck).
Can read geo-related EXIF metdata once-again (reference https://github.com/ImageMagick/ImageMagick/issues/198).
Sanitize all delegate emedded formatting characters.
Don't sync pixel cache in AcquireAuthenticCacheView() (bug report from Hanno BÃ¶ck).
-2016-05-09 7.0.1-3 Cristy <quetzlzacatenango@image...>
+2016-05-09 7.0.1-3 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-3, GIT revision 10755:d540dda:20160509.
-2016-05-07 7.0.1-3 Cristy <quetzlzacatenango@image...>
+2016-05-07 7.0.1-3 Cristy <quetzlzacatenango@image...>
Remove https delegate.
-2016-05-06 7.0.1-2 Cristy <quetzlzacatenango@image...>
+2016-05-06 7.0.1-2 Cristy <quetzlzacatenango@image...>
Release ImageMagick version 7.0.1-2, GIT revision 10741:5746147:20160507.
-2016-05-04 7.0.1-2 Cristy <quetzlzacatenango@image...>
+2016-05-04 7.0.1-2 Cristy <quetzlzacatenango@image...>
Check for buffer overflow in magick/draw.c/DrawStrokePolygon().
Replace show delegate title with image filename rather than label.
Fix GetNextToken() off by one error.
Remove support for internal ephemeral coder.
-2016-05-03 7.0.1-1 Cristy <quetzlzacatenango@image...>
+2016-05-03 7.0.1-1 Cristy <quetzlzacatenango@image...>
New version 7.0.1-1, GIT revision 10723:9fc8a0c:20160503.
-2016-05-03 7.0.1-1 Cristy <quetzlzacatenango@image...>
+2016-05-03 7.0.1-1 Cristy <quetzlzacatenango@image...>
Sanitize input filename for http / https delegates (improved patch).
Fix for possible security vulnerabilities (reference https://www.imagemagick.org/discourse-server/viewtopic.html?f=4&t=29588).
-2016-04-30 7.0.1-0 Cristy <quetzlzacatenango@image...>
+2016-04-30 7.0.1-0 Cristy <quetzlzacatenango@image...>
New version 7.0.1-0, GIT revision 10716:b527bce:20160430.
-2016-01-30 7.0.0-0 Fahad-Alsaidi & ShamsaHamed
+2016-01-30 7.0.0-0 Fahad-Alsaidi & ShamsaHamed
Add support for languages that require complex text layout (reference https://github.com/ImageMagick/ImageMagick/pull/88).
-2012-04-27 7.0.0-0 Anthony thyssen <A.Thyssen@griffith...>
+2012-04-27 7.0.0-0 Anthony thyssen <A.Thyssen@griffith...>
Allow the use of set and escapes when no images in memory (unless you attempt to access per-image meta-data) Currently does not include %[fx:...] and %[pixel:...]
-2012-10-05 7.0.0-0 Anthony thyssen <A.Thyssen@griffith...>
+2012-10-05 7.0.0-0 Anthony thyssen <A.Thyssen@griffith...>
Rather than replicate 'options' into 'artifacts' make a link from image to image_info and lookup a global option if no artifact is defined.
-2012-09-11 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
+2012-09-11 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
sigmoidal-contrast:
Remove unnecessary initial ClampToQuantum.
-2012-09-10 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
+2012-09-10 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
sigmoidal-contrast:
Direct computation, without LUT;
Fix re-declaration of i (at the top, and inside a conditional).
-2012-09-04 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
+2012-09-04 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
Add tanh/atanh clone of legacy sigmoidal map (faster & more accurate).
-2012-08-08 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
+2012-08-08 7.0.0-0 Nicolas Robidoux <nicolas.robidoux@gmail...>
Add final ClampToQuantum in sigmoidal colormap loop.
Remove OpenMP calls from colormap update loops.
-2011-08-01 7.0.0-0 Cristy <quetzlzacatenango@image...>
+2011-08-01 7.0.0-0 Cristy <quetzlzacatenango@image...>
New version 7.0.0-0.

Donate â¢
@@ -416,4 +422,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/cipher.html b/www/cipher.html
index 36b7f4a39..7c7b2767b 100644
--- a/www/cipher.html
+++ b/www/cipher.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Encipher an Image â¢ Decipher an Image â¢ Encipher and Decipher Caveats

@@ -63,29 +63,29 @@

You could use an enciphering utility to scramble your image but they typically scramble the entire file making it unrecognizable as an image format. With ImageMagick, only the pixels are scrambled. The scrambled image continues to be recognized as an image and will even display in your web page. However, the content appears as gibberish, nothing like the original content.

-Encipher an Image
+Encipher an Image

Use the -encipher option to scramble your image so that it is unrecognizable. The option requires a filename that contains your passphrase. In this example we scramble an image and save it in the PNG format:

-+
convert rose.jpg -encipher passphrase.txt rose.png
-

+

Here we encipher an image using another image as the passphrase:

-+
convert rose.jpg -encipher smiley.gif rose.png
-

+

-Decipher an Image
+Decipher an Image

Use the -decipher option to unscramble your image so that it is recognizable once again. The option requires a filename that contains your passphrase. In this example we unscramble an image and save it in the JPEG format:

-+
convert rose.png -decipher passphrase.txt rose.jpg
-

+

-Encipher and Decipher Caveats
+Encipher and Decipher Caveats

Some formats do not support enciphered pixels-- the JPEG or GIF format, for
example. To ensure your image format is supported, encipher a test image and
@@ -140,4 +140,4 @@ Examples

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/color-management.html b/www/color-management.html
index acd552055..19a74e80a 100644
--- a/www/color-management.html
+++ b/www/color-management.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Color management has changed significantly between ImageMagick version 6.7.5-5 and 6.8.0-3 in order to better conform to color and grayscale standards.
@@ -64,63 +64,63 @@

ImageMagick supports color profiles, however, for images without a profile or a declaration of colorspace, ImageMagick assumes non-linear sRGB. Most image processing algorithms assume a linear colorspace, therefore it might be prudent to convert to linear color or remove the gamma function before certain image processing algorithms are applied. For example,

-+
convert myimage.jpg -colorspace RGB -resize 200% -colorspace sRGB mybigimage.jpg
-

+

To declare that an image is linear RGB rather than sRGB, you can use the set option:

-+
convert myimage.png -set colorspace RGB myRGBimage.png
-

+

Afterwards, the verbose information for the output file lists the colorspace as RGB. This only works on image types containing meta data that distinguishes between linear RGB and non-linear sRGB, such as PNG and GIF. Therefore, if the above command is run with a JPG or TIF output format, the verbose information for the colorspace still shows sRGB. In order to properly have the JPG output know that it is linear RGB, include an appropriate color profile.

The second major change treats any grayscale image as linear rather than non-linear, as it was previously. This change is appropriate, since many types of processing requires a linear colorspace. This means that the conversion of a color image to grayscale via -colorspace gray looks darker relative to previous versions of ImageMagick (note that desaturating to convert to grayscale does not convert the image to linear grayscale). If you prefer to keep the conversion to non-linear grayscale, set the colorspace of the input to linear RGB so that -colorspace gray does not apply the gamma correction during the conversion process. For example, the following produces a non-linear grayscale result.

-+
convert myimage.png -set colorspace RGB -colorspace gray myRGBimage.png
-

+

The same concept is needed when separating channels. Normally, the conversion to separate each channel of an sRGB color image produces separate linear grayscale images. However the same concept can be applied, if it is desired to keep the separate channels as non-linear grayscale. For example, the following produces non-linear grayscale channels.

-+
convert myimage.png -set colorspace RGB -separate myimage_channels_%d.png
-

+

When separating and recombining channels, with potential intermediate processing, it is important to identify the colorspace used, especially during the recombination. For example,

-+
convert myimage.png -separate myimage_channels_%d.png
convert myimage_channels_*.png -combine myimage2.png
-

+

In the above example, the result is darker than the original, because the channels were separate as linear gray and subsequently combined as linear color. In order to return the channels back to sRGB, one must change the colorspace from RGB back to sRGB after the -combine step.

-+
convert myimage.png -separate myimage_channels_%d.png
convert myimage_channels_*.png -combine -colorspace sRGB myimage2.png
-

+

If one desires to separate to non-linear grayscale channels, recombine them later, perhaps after some processing, then use the same concept as above for maintaining non-linear grayscale:

-+
convert myimage.png -set colorspace RGB -separate myimage_channels_%d.png
convert myimage_channels_*.png -combine -colorspace RGB -set colorspace sRGB myimage2.png
-

+

When converting to another colorspace and back, such as between sRGB and HSL, the following two commands handle the first case of linear channels and the second case of non-linear channels:

-+
convert myimage.png -colorspace HSL -separate myimage_channels_%d.png
convert myimage_channels_*.png -set colorspace HSL -combine -colorspace sRGB myimage2.png
-

+

-+
convert myimage.png -set colorspace RGB -colorspace HSL -separate myimage_channels_%d.png
convert myimage_channels_*.png -set colorspace HSL -combine -colorspace RGB -set colorspace sRGB myimage2.png
-

+

A majority of the image formats assume an sRGB colorspace (e.g. JPEG, PNG, etc.). A few support only linear RGB (e.g. EXR, DPX, CIN, HDR) or only linear GRAY (e.g. PGM). A few formats support CMYK. For example JPG does, but PNG does not. Then there is the occasional format that also supports LAB (that is CieLAB) (e.g. TIFF, PSD, JPG, JP2). For additional information, see the Colorspace and Supported Formats pages.

@@ -150,4 +150,4 @@ convert myimage_channels_*.png -set colorspace HSL -combine -colorspace RGB -set

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/color.html b/www/color.html
index e85c81e45..8fff2b024 100644
--- a/www/color.html
+++ b/www/color.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Color Model Specification â¢ List of Color Names

@@ -63,25 +63,25 @@

Use the Color Converter to supply any valid ImageMagick color specification as described below to see a color swatch of that color and to convert to all the other color models.

-Example Usage
+Example Usage

Each of the following commands produces the same lime border around the image. (Use "double quotes" for Windows.)

-+
convert -bordercolor lime -border 10 image.jpg image.png
convert -bordercolor '#0f0' -border 10 image.jpg image.png
convert -bordercolor '#00ff00' -border 10 image.jpg image.png
convert -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png
convert -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png
-

+

The list of recognized color names (for example, aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, yellow, and others) is shown in a table further below.

-Color Model Specification
+Color Model Specification

The sRGB, CMYK, HSL and HSB color models are used in numerical color specifications. These examples all specify the same red sRGB color:

-+
#f00 #rgb
#ff0000 #rrggbb
#ff0000ff #rrggbbaa
@@ -99,12 +99,12 @@ rgb(100.0%, 0.0%, 0.0%) a float in the range 0â100% for each component

The sRGB color model is extended in this specification to include alpha to allow specification of the transparency of a color. These examples all specify the same color:

-+
rgb(255, 0, 0) range 0 - 255
rgba(255, 0, 0, 1.0) the same, with an explicit alpha value
rgb(100%, 0%, 0%) range 0.0% - 100.0%
rgba(100%, 0%, 0%, 1.0) the same, with an explicit alpha value
-

+

The format of an RGBA value in the functional notation is 'rgba(r,g,b,a)', where r, g, and b are as described above for the RGB functional notation, and where the alpha value a ranges from 0.0 (fully transparent) to 1.0 (fully opaque).

@@ -112,10 +112,10 @@ rgba(100%, 0%, 0%, 1.0) the same, with an explicit alpha value

Gray values are conveniently defined with a single intensity value or an intensity value and an alpha value:

-+
gray(50%) mid gray
graya(50%, 0.5) semi-transparent mid gray
-

+

The ImageMagick color model also supports hue-saturation-lightness (HSL) and hue-saturation-brightness (HSB) colors as a complement to numerical sRGB colors. HSL colors are encoding as a triple (hue, saturation, lightness). Likewise HSB colors are encoding as a triple (hue, saturation, brightness). HSL or HSB triples are either direct values (hue 0â360, saturation 0â255, lightness or brightness 0â255) or with S,L,B as percentage values relative to these ranges.

@@ -133,31 +133,31 @@ graya(50%, 0.5) semi-transparent mid gray

The HSB color system is a little easier to understand than the HSL color system. In the HSB color system, black is at the bottom apex and white is at the top center of the cone on the central axis. The most colorful or saturated colors will then be at the outer edge of the top of the cone at the widest part. Thus at Saturation=100% and Brightness=100%

-+
hsb(0, 100%, 100%) or hsb(0, 255, 255) full red
hsb(120, 100%, 100%) or hsb(120, 255, 255) full green
hsb(120, 100%, 75%) or hsb(120, 255, 191.25) medium green
hsb(120, 100%, 50%) or hsb(120, 255, 127.5) dark green
hsb(120, 100%, 25%) or hsb(120, 255, 63.75) very dark green
hsb(120, 50%, 50%) or hsb(120, 127.5, 127.5) pastel green
-

+

In the HSL color system, black is at the bottom apex and white is at the top apex. However, saturation is largest at the middle of the double cone on its outer perimeter and thus at a lightness value of 50%. The most colorful or saturated colors will then be at the outer edge of the double cone at its widest part. Thus at Saturation=100% and Brightness=50%

-+
hsl(0, 100%, 50%) or hsl(0, 255, 127.5) full red
hsl(120, 100%, 100%) or hsl(120, 255, 255) white
hsl(120, 100%, 75%) or hsl(120, 255, 191.25) pastel green
hsl(120, 100%, 50%) or hsl(120, 255, 127.5) full green
hsl(120, 100%, 25%) or hsl(120, 255, 63.75) dark green
hsl(120, 50%, 50%) or hsl(120, 127.5, 127.5) medium green
-

+

One advantage of HSB or HSL over RGB is that it can be more intuitive: you can guess at the colors you want, and then tweak. It is also easier to create sets of matching colors (by keeping the hue the same and varying the brightness or lightness and saturation, for example).

Just as the 'rgb()' functional notation has the 'rgba()' alpha counterpart, the 'hsl()' and 'hsb()' functional notations have their 'hsla()' 'hsba()' alpha counterparts. These examples specify the same color:

-+
hsb(120, 100%, 100%) full green in hsb
hsba(120, 100%, 100%, 1.0) the same, with an alpha value of 1.0
hsb(120, 255, 255) full green in hsb
@@ -167,14 +167,14 @@ hsl(120, 100%, 50%) full green in hsl
hsla(120, 100%, 50%, 1.0) the same, with an alpha value of 1.0
hsl(120, 255, 127.5) full green in hsl
hsla(120, 255, 127.5, 1.0) the same, with an alpha value of 1.0
-

+

For ImageMagick between 6.5.6-6 and 6.9.2-0, HSL (HSB) could only be specified with Hue as percent in range 0â100%, when Saturation and Lightness (Brightness) were also specified as percent in range 0â100%.

Specify the Lab colors like this:
-+
cielab(62.253188, 23.950124, 48.410653)
-

+
Note, the a and b components of any Lab color you specify are biased internally by 50% to ensure it fits in the quantum range (typically 0 to 65535). The bias is retained when writing to the TIFF and MIFF image formats. However, the TXT format supports negative pixel values so the bias is removed when writing to this format:
-> convert xc:cyan -colorspace LAB txt:
@@ -182,26 +182,26 @@ cielab(62.253188, 23.950124, 48.410653)
0,0: (91.1131%,-18.8571%,-5.5436%) #E93F00000000 cielab(91.1131%,-18.8571%,-5.5436%)

-> convert -size 100x100 xc:"cielab(91.1131%,-18.8571%,-5.5436%)" -colorspace sRGB cyan.png
-
+

Or specify colors generically with the icc-color keyword, for example:
-+
icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)
icc-color(rgb, white)
-

+

Or specify uncalibrated device colors with the device- keyword, for example:
-+
device-gray(0.5)
device-rgb(0.5, 1.0, 0.0)
device-cmyk(0.11, 0.48, 0.83, 0.00)
-

+

-List of Color Names
+List of Color Names

The table below provides a list of named colors recognized by ImageMagick:

-

Option

+
@@ -4951,4 +4951,4 @@ device-cmyk(0.11, 0.48, 0.83, 0.00)

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/command-line-options.html b/www/command-line-options.html
index 6a6908ecc..f3bc6fb9d 100644
--- a/www/command-line-options.html
+++ b/www/command-line-options.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

‑adaptive‑blur â¢ ‑adaptive‑resize â¢ ‑adaptive‑sharpen â¢ ‑adjoin â¢ ‑affine â¢ ‑alpha â¢ ‑annotate â¢ ‑antialias â¢ ‑append â¢ ‑attenuate â¢ ‑authenticate â¢ ‑auto‑gamma â¢ ‑auto‑level â¢ ‑auto‑orient â¢ ‑backdrop â¢ ‑background â¢ ‑bench â¢ ‑bias â¢ ‑black‑point‑compensation â¢ ‑black‑threshold â¢ ‑blend â¢ ‑blue‑primary â¢ ‑blue‑shift â¢ ‑blur â¢ ‑border â¢ ‑bordercolor â¢ ‑borderwidth â¢ ‑brightness‑contrast â¢ ‑cache â¢ ‑canny â¢ ‑caption â¢ ‑cdl â¢ ‑channel â¢ ‑charcoal â¢ ‑channel‑fx â¢ ‑chop â¢ ‑clamp â¢ ‑clip â¢ ‑clip‑mask â¢ ‑clip‑path â¢ ‑clone â¢ ‑clut â¢ ‑coalesce â¢ ‑colorize â¢ ‑colormap â¢ ‑color‑matrix â¢ ‑colors â¢ ‑colorspace â¢ ‑combine â¢ ‑comment â¢ ‑compare â¢ ‑complex â¢ ‑compose â¢ ‑composite â¢ ‑compress â¢ ‑connected‑components â¢ ‑contrast â¢ ‑contrast‑stretch â¢ ‑convolve â¢ ‑copy â¢ ‑crop â¢ ‑cycle â¢ ‑debug â¢ ‑decipher â¢ ‑deconstruct â¢ ‑define â¢ ‑delay â¢ ‑delete â¢ ‑density â¢ ‑depth â¢ ‑descend â¢ ‑deskew â¢ ‑despeckle â¢ ‑direction â¢ ‑displace â¢ ‑display â¢ ‑dispose â¢ ‑dissimilarity‑threshold â¢ ‑dissolve â¢ ‑distort â¢ ‑distribute‑cache â¢ ‑dither â¢ ‑draw â¢ ‑duplicate â¢ ‑edge â¢ ‑emboss â¢ ‑encipher â¢ ‑encoding â¢ ‑endian â¢ ‑enhance â¢ ‑equalize â¢ ‑evaluate â¢ ‑evaluate‑sequence â¢ ‑extent â¢ ‑extract â¢ ‑family â¢ ‑features â¢ ‑fft â¢ ‑fill â¢ ‑filter â¢ ‑flatten â¢ ‑flip â¢ ‑floodfill â¢ ‑flop â¢ ‑font â¢ ‑foreground â¢ ‑format â¢ ‑format[identify] â¢ ‑frame â¢ ‑frame[import] â¢ ‑function â¢ ‑fuzz â¢ ‑fx â¢ ‑gamma â¢ ‑gaussian‑blur â¢ ‑geometry â¢ ‑gravity â¢ ‑grayscale â¢ ‑green‑primary â¢ ‑hald‑clut â¢ ‑help â¢ ‑highlight‑color â¢ ‑hough‑lines â¢ ‑iconGeometry â¢ ‑iconic â¢ ‑identify â¢ ‑ift â¢ ‑immutable â¢ ‑implode â¢ ‑insert â¢ ‑intensity â¢ ‑intent â¢ ‑interlace â¢ ‑interpolate â¢ ‑interline‑spacing â¢ ‑interword‑spacing â¢ ‑kerning â¢ ‑kuwahara â¢ ‑label â¢ ‑lat â¢ ‑layers â¢ ‑level â¢ ‑level‑colors â¢ ‑limit â¢ ‑linear‑stretch â¢ ‑linewidth â¢ ‑liquid‑rescale â¢ ‑list â¢ ‑log â¢ ‑loop â¢ ‑lowlight‑color â¢ ‑magnify â¢ ‑map â¢ ‑map[stream] â¢ ‑mattecolor â¢ ‑median â¢ ‑mean‑shift â¢ ‑metric â¢ ‑mode â¢ ‑modulate â¢ ‑moments â¢ ‑monitor â¢ ‑monochrome â¢ ‑morph â¢ ‑morphology â¢ ‑mosaic â¢ ‑motion‑blur â¢ ‑name â¢ ‑negate â¢ ‑noise â¢ ‑normalize â¢ ‑opaque â¢ ‑ordered‑dither â¢ ‑orient â¢ ‑page â¢ ‑paint â¢ ‑path â¢ ‑pause[animate] â¢ ‑pause[import] â¢ ‑perceptible â¢ ‑ping â¢ ‑pointsize â¢ ‑polaroid â¢ ‑poly â¢ ‑posterize â¢ ‑precision â¢ ‑preview â¢ ‑print â¢ ‑process â¢ ‑profile â¢ ‑quality â¢ ‑quantize â¢ ‑quiet â¢ ‑radial‑blur â¢ ‑raise â¢ ‑random‑threshold â¢ ‑read‑mask â¢ ‑red‑primary â¢ ‑regard‑warnings â¢ ‑region â¢ ‑remap â¢ ‑remote â¢ ‑render â¢ ‑repage â¢ ‑resample â¢ ‑resize â¢ ‑respect‑parentheses â¢ ‑reverse â¢ ‑roll â¢ ‑rotate â¢ ‑sample â¢ ‑sampling‑factor â¢ ‑scale â¢ ‑scene â¢ ‑screen â¢ ‑seed â¢ ‑segment â¢ ‑selective‑blur â¢ ‑separate â¢ ‑sepia‑tone â¢ ‑set â¢ ‑shade â¢ ‑shadow â¢ ‑shared‑memory â¢ ‑sharpen â¢ ‑shave â¢ ‑shear â¢ ‑sigmoidal‑contrast â¢ ‑silent â¢ ‑similarity‑threshold â¢ ‑size â¢ ‑sketch â¢ ‑smush â¢ ‑snaps â¢ ‑solarize â¢ ‑sparse‑color â¢ ‑splice â¢ ‑spread â¢ ‑statistic â¢ ‑stegano â¢ ‑stereo â¢ ‑storage‑type â¢ ‑stretch â¢ ‑strip â¢ ‑stroke â¢ ‑strokewidth â¢ ‑style â¢ ‑subimage‑search â¢ ‑swap â¢ ‑swirl â¢ ‑synchronize â¢ ‑taint â¢ ‑text‑font â¢ ‑texture â¢ ‑threshold â¢ ‑thumbnail â¢ ‑tile â¢ ‑tile‑offset â¢ ‑tint â¢ ‑title â¢ ‑transform â¢ ‑transparent â¢ ‑transparent‑color â¢ ‑transpose â¢ ‑transverse â¢ ‑treedepth â¢ ‑trim â¢ ‑type â¢ ‑undercolor â¢ ‑unique‑colors â¢ ‑units â¢ ‑unsharp â¢ ‑update â¢ ‑verbose â¢ ‑version â¢ ‑view â¢ ‑vignette â¢ ‑virtual‑pixel â¢ ‑visual â¢ ‑watermark â¢ ‑wave â¢ ‑wavelet‑denoise â¢ ‑weight â¢ ‑white‑point â¢ ‑white‑threshold â¢ ‑window â¢ ‑window‑group â¢ ‑write â¢ ‑write‑mask
Below is list of command-line options recognized by the ImageMagick command-line tools. If you want a description of a particular option, click on the option name in the navigation bar above and you will go right to it. Unless otherwise noted, each option is recognized by the commands: convert and mogrify.

- -adaptive-blur radius[xsigma]
+ -adaptive-blur radius[xsigma]

Adaptively blur pixels, with decreasing effect near edges.
@@ -70,7 +70,7 @@
defaults to 1.

- -adaptive-resize geometry
+ -adaptive-resize geometry

Resize the image using data-dependent triangulation.
@@ -82,7 +82,7 @@ Offsets, if present in the geometry string, are ignored, and the -gravity option has no effect.

- -adaptive-sharpen radius[xsigma]
+ -adaptive-sharpen radius[xsigma]

Adaptively sharpen pixels, with increasing effect near edges.
@@ -92,7 +92,7 @@ href="command-line-options.html#gravity">-gravity option has no effect.
defaults to 1.

- -adjoin
+ -adjoin

Join images into a single multi-image file.
@@ -116,9 +116,9 @@ strings, such as '%d' or '%03d', are familiar to those
who have used the standard printf()' C-library function. As an
example, the command

-+
convert logo: rose: -morph 15 my%02dmorph.jpg
-

+

will create a sequence of 17 images (the two given plus 15 more created by
-morph), named: my00morph.jpg, my01morph.jpg,
@@ -135,7 +135,7 @@ save to multiple files, if any of the following conditions exist...

- -affine
+
-affine
s_x,r_x,r_y,s_y[,t_x,t_y]

@@ -178,23 +178,23 @@ href="command-line-options.html#distort">-distort method 'Affineprojec
information

-+
-affine s_x,0,0,s_y
-

+

Translation by a displacement (t_x, t_y) is accomplished like so:

-+
-affine 1,0,0,1,t_x,t_y
-

+

Rotate clockwise about the origin (the upper left-hand corner) by an angle
a by letting c = cos(a), s
= sin(a), and using the following.

-+
-affine c,s,-s,c
-

+

The cumulative effect of a sequence of -affine
transformations can be accomplished by instead by a single
matrix determinant has a sufficiently small absolute value it is rejected.

- -alpha type
+ -alpha type

Gives control of the alpha/matte channel of an image.
@@ -213,74 +213,74 @@ matrix determinant has a sufficiently small absolute value it is rejected.
Used to set a flag on an image indicating whether or not to use existing alpha
channel data, to create an alpha channel, or to perform other operations on the alpha channel. Choose the argument type from the list below.

-
- Activate
-
+
+ Activate
+
Enable the image's transparency channel. Note normally Set
should be used instead of this, unless you specifically need to
preserve existing (but specifically turned Off) transparency
channel.

- Associate
-
+
Associate
+
associate the alpha channel with the image.

- Deactivate
-
+
Deactivate
+
Disables the image's transparency channel. Does not delete or change the
existing data, just turns off the use of that data.

- Disassociate
-
+
Disassociate
+
disassociate the alpha channel from the image.

- Set
-
+
Set
+
Activates the alpha/matte channel. If it was previously turned off
then it also resets the channel to opaque. If the image already had
the alpha channel turned on, it will have no effect.

- Opaque
-
+
Opaque
+
Enables the alpha/matte channel and forces it to be fully opaque.

- Transparent
-
+
Transparent
+
Activates the alpha/matte channel and forces it to be fully
transparent. This effectively creates a fully transparent image the
same size as the original and with all its original RGB data still
intact, but fully transparent.

- Extract
-
+
Extract
+
Copies the alpha channel values into all the color channels and turns
'Off' the the image's transparency, so as to generate
a grayscale mask of the image's shape. The alpha channel data is left
intact just deactivated. This is the inverse of 'Copy'.

- Copy
-
+
Copy
+
Turns 'On' the alpha/matte channel, then copies the
grayscale intensity of the image, into the alpha channel, converting
a grayscale mask into a transparent shaped mask ready to be colored
appropriately. The color channels are not modified.

- Shape
-
+
Shape
+
As per 'Copy' but also colors the resulting shape mask with
the current background color. That is the RGB color channels is
replaced, with appropriate alpha shape.

- Remove
-
+
Remove
+
Composite the image over the background color.

- Background
-
+
Background
+
Set any fully-transparent pixel to the background color, while leaving
it fully-transparent. This can make some image file formats, such as
PNG, smaller as the RGB values of transparent pixels are more uniform,
@@ -294,7 +294,7 @@ same as "-alpha Off"
Set" and not "-alpha On".

-
+

-annotate degrees text

-annotate XdegreesxYdegrees text
-annotate XdegreesxYdegrees {+-}t_x{+-}t_y text
-annotate {+-}t_x{+-}t_y text

@@ -330,7 +330,7 @@ is of the form '@mytext.txt', the text is read from the file
formatting characters are recognized.

- -antialias
+ -antialias

Enable/Disable of the rendering of anti-aliasing pixels when drawing fonts and lines.
@@ -342,7 +342,7 @@ an image to just the colors being directly drawn. That is, no mixed colors
are added when drawing such objects.

- -append
+ -append

Join current images vertically or horizontally.
@@ -358,7 +358,7 @@ href="command-line-options.html#gravity">-gravity setting.

- -attenuate value
+ -attenuate value

Lessen (or intensify) when adding noise to an image.
@@ -366,7 +366,7 @@ href="command-line-options.html#gravity">-gravity setting.
If unset the value is equivalent to 1.0, or a maximum noise addition

- -authenticate password
+ -authenticate password

Decrypt a PDF with a password.
@@ -380,7 +380,7 @@ and -decipher.

- -auto-gamma
+ -auto-gamma

Automagically adjust gamma level of image.
@@ -405,7 +405,7 @@ together by the same gamma value, preserving colors.

- -auto-level
+ -auto-level

Automagically adjust color levels of image.
@@ -438,7 +438,7 @@ transparency.

- -auto-orient
+ -auto-orient

adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).
@@ -456,7 +456,7 @@ href="command-line-options.html#auto-orient" >-auto-orient operator will do

- -average
+ -average

Average a set of images.
@@ -465,7 +465,7 @@ href="command-line-options.html#auto-orient" >-auto-orient operator will do

- -backdrop
+ -backdrop

Display the image centered on a backdrop.
@@ -476,7 +476,7 @@ specified as the background color. The color is specified using the format
described under the -fill option.

- -background color
+ -background color

Set the background color.
@@ -486,7 +486,7 @@ href="command-line-options.html#fill">-fill option. The default background c
specified or found in the image) is white.

- -bench iterations
+ -bench iterations

Measure performance.
@@ -496,21 +496,21 @@ consider the following command and its output. Modify the benchmark with the
-duration to run the benchmark for a fixed number of seconds and -concurrent
to run the benchmark in parallel (requires the OpenMP feature).

-+
-> convert logo: -resize 200% -bench 5 logo.png
Performance[1]: 5i 1.344ips 1.000e 3.710u 0:03.720
Performance[2]: 5i 1.634ips 0.549e 3.890u 0:03.060
Performance[3]: 5i 2.174ips 0.618e 3.190u 0:02.300
Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
Performance[4]: 5i 0.875657ips 6.880u 0:05.710
-

+

In this example, 5 iterations were completed at 2.174 iterations per
second, using 3 threads and 3.190 seconds of the user allotted time, for
a total elapsed time of 2.300 seconds.

- -bias value{%}
+ -bias value{%}

Add bias when convolving an image.
@@ -537,13 +537,13 @@ href="http://en.wikipedia.org/wiki/High_dynamic_range_imaging">Wikipedia
entry.

- -black-point-compensation
+ -black-point-compensation

Use black point compensation.

- -black-threshold value{%}
+ -black-threshold value{%}

Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.
@@ -554,7 +554,7 @@ desired ‑channel value. S

- -blend geometry
+ -blend geometry

blend an image into another by the given absolute value or percent.
@@ -568,13 +568,13 @@ the background image is weighted by the exact opposite amount. That is a

- -blue-primary x,y
+ -blue-primary x,y

Set the blue chromaticity primary point.

- -blue-shift factor
+ -blue-shift factor

simulate a scene at nighttime in the moonlight. Start with a factor of 1.5
@@ -582,7 +582,7 @@ the background image is weighted by the exact opposite amount. That is a

- -blur radius
-blur radiusxsigma
+ -blur radius
-blur radiusxsigma

Reduce image noise and reduce detail levels.
@@ -618,7 +618,7 @@ pixels which are outside the image proper are blurred into the final result.

- -border geometry
+ -border geometry

Surround the image with a border of color.
@@ -629,31 +629,31 @@ ignored.

As of IM 6.7.8-8, the geometry arguments behave as follows:

-
-value
-value is added to both left/right and top/bottom
-value-xx
-value-x is added only to left/right and top/bottom are unchanged
-xvalue-y
-value-y is added only to top/bottom and left/right are unchanged
-value-xxvalue-y
-value-x is added to left/right and value-y added to top/bottom
-value-xx0
-value-x is added only to left/right and top/bottom are unchanged
-0xvalue-y
-value-y is added only to top/bottom and left/right are unchanged
-value%
-value % of width is added to left/right and value % of height is added to top/bottom
-value-xx%
-value-x % of width is added to left/right and to top/bottom
-xvalue-y%
-value-y % of height is added to top/bottom and to left/right
-value-x%xvalue-y%
-value-x % of width is added to left/right and value-y % of height is added to top/bottom
-value-x%x0%
-value-x % of width is added to left/right and top/bottom are unchanged
-0%xvalue-y%
-value-y % of height is added to top/bottom and left/right are unchanged
+
+value
+value is added to both left/right and top/bottom
+value-xx
+value-x is added only to left/right and top/bottom are unchanged
+xvalue-y
+value-y is added only to top/bottom and left/right are unchanged
+value-xxvalue-y
+value-x is added to left/right and value-y added to top/bottom
+value-xx0
+value-x is added only to left/right and top/bottom are unchanged
+0xvalue-y
+value-y is added only to top/bottom and left/right are unchanged
+value%
+value % of width is added to left/right and value % of height is added to top/bottom
+value-xx%
+value-x % of width is added to left/right and to top/bottom
+xvalue-y%
+value-y % of height is added to top/bottom and to left/right
+value-x%xvalue-y%
+value-x % of width is added to left/right and value-y % of height is added to top/bottom
+value-x%x0%
+value-x % of width is added to left/right and top/bottom are unchanged
+0%xvalue-y%
+value-y % of height is added to top/bottom and left/right are unchanged

Set the border color by preceding with the -bord
functionality.

- -bordercolor color
+ -bordercolor color

Set the border color.
@@ -680,13 +680,13 @@ functionality.
The default border color is #DFDFDF, this shade of gray.

- -borderwidth geometry
+ -borderwidth geometry

Set the border width.

- -brightness-contrast brightness
-brightness-contrast brightness{xcontrast}{%}
+ -brightness-contrast brightness
-brightness-contrast brightness{xcontrast}{%}

Adjust the brightness and/or contrast of the image.
@@ -724,13 +724,13 @@ totally black.
symbol is no different than leaving it off.

- -cache threshold
+ -cache threshold

(This option has been replaced by the -limit option).

- -canny radius
-canny radiusxsigma{+lower-percent}{+upper-percent}
+ -canny radius
-canny radiusxsigma{+lower-percent}{+upper-percent}

Canny edge detector uses a multi-stage algorithm to detect a wide range of edges in the image.
@@ -738,7 +738,7 @@ symbol is no different than leaving it off.
The thresholds range from 0 to 100% (e.g. -canny 0x1+10%+30%) with {+lower-percent} < {+upper-percent}. If {+upper-percent} is increased but {+lower-percent} remains the same, lesser edge components will be detected, but their lengths will be the same. If {+lower-percent} is increased but {+upper-percent} is the same, the same number of edge components will be detected but their lengths will be shorter. The default thresholds are shown. The radiusxsigma controls a gaussian blur applied to the input image to reduce noise and smooth the edges.

- -caption string
+ -caption string

Assign a caption to an image.
@@ -762,9 +762,9 @@ instead.

For example,

-+
-caption "%m:%f %wx%h" bird.miff
-

+

produces an image caption of MIFF:bird.miff 512x480 (assuming
that the image bird.miff has a width of 512 and a height of
@@ -772,14 +772,14 @@ that the image bird.miff has a width of 512 and a height of

- -cdl filename
+ -cdl filename

color correct with a color decision list.

Here is an example color correction collection:

-+
<?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
<ColorCorrection id="cc06668">
@@ -793,10 +793,10 @@ that the image bird.miff has a width of 512 and a height of
</SATNode>
</ColorCorrection>
</ColorCorrectionCollection>
-

+

- -channel type
+ -channel type

Specify those image color channels to which subsequent operators are limited.
@@ -814,13 +814,13 @@ abbreviated as a concatenation of the letters 'R', 'G'

For example, to only select the Red and Blue channels
you can either use
-+
-channel Red,Blue
-

+
or you can use the short hand form
-+
-channel RB
-

+

All the channels that are present in an image can be specified using the
special channel type All. Not all operators are 'channel capable',
@@ -924,50 +924,50 @@ the operator to apply the operation using alpha channels. The -clut operator is a good example of this.

- -channel-fx expression
+ -channel-fx expression

exchange, extract, or copy one or more image channels.

The expression consists of one or more channels, either mnemonic or numeric (e.g. red or 0, green or 1, etc.), separated by certain operation symbols as follows:

-+
<=> exchange two channels (e.g. red<=>blue)
=> copy one channel to another channel (e.g. red=>green)
= assign a constant value to a channel (e.g. red=50%)
, write new image with channels in the specified order (e.g. red, green)
; add a new output image for the next set of channel operations (e.g. red; green; blue)
| move to the next input image for the source of channel data (e.g. | gray=>alpha)
-

+

For example, to create 3 grayscale images from the red, green, and blue channels of an image, use:

-+
-channel-fx "red; green; blue"
-

+

A channel without an operation symbol implies separate (i.e, semicolon).

Here we take an sRGB image and a grayscale image and inject the grayscale image into the alpha channel:
-+
convert wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
-

+
Use a similar command to define a read mask:
-+
convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
-

+

Add -debug pixel prior to the -channel-fx option to track the channel morphology.

- -charcoal factor
+ -charcoal factor

Simulate a charcoal drawing.

- -chop geometry
+ -chop geometry

Remove pixels from the interior of an image.
@@ -992,13 +992,13 @@ sides of the image.
href="command-line-options.html#splice">-splice that was given the same geometry and -gravity settings.

- -clamp
+ -clamp

set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.

- -clip
+ -clip

Apply the clipping path if one is present.
@@ -1007,9 +1007,9 @@ href="command-line-options.html#splice">-splice that was given the same For example, in the command

-+
convert cockatoo.tif -clip -negate negated.tif
-

+

only the pixels within the clipping path are negated.

@@ -1019,7 +1019,7 @@ delegate library is not present, the option is ignored.
Use +clip to disable clipping for subsequent operations.

- -clip-mask
+ -clip-mask

Clip the image as defined by this mask.
@@ -1037,7 +1037,7 @@ operation.
Use +clip-mask to disable clipping for subsequent operations.

- -clip-path id
+ -clip-path id

Clip along a named path from the 8BIM profile.
@@ -1047,7 +1047,7 @@ operation.
Use +clip-path to disable clipping for subsequent operations.

- -clone index(s)
+ -clone index(s)

make a clone of an image (or images).
@@ -1070,7 +1070,7 @@ in the image sequence, and is thus equivalent to using a argument of
'â1'.

- -clut
+ -clut

Replace the channel values in the first image using each corresponding channel in the second image as a color lookup table.
@@ -1116,7 +1116,7 @@ of a 3D color cube.

- -coalesce
+ -coalesce

Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.
@@ -1136,7 +1136,7 @@ better than the original.

- -colorize value
+ -colorize value

Colorize the image by an amount specified by value using the color specified by the most recent -fill setting.
@@ -1147,7 +1147,7 @@ a comma-delimited list of colorization
values (e.g., -colorize 0,0,50).

- -colormap type
+ -colormap type

Define the colormap type.
@@ -1165,7 +1165,7 @@ as they are defined. However, other clients may go technicolor
when the image colormap is installed.

- -colors value
+ -colors value

Set the preferred number of colors in the image.
@@ -1181,7 +1181,7 @@ the
color reduction algorithm for more details.

- -color-matrix matrix
+ -color-matrix matrix

apply color correction to the image.
@@ -1195,7 +1195,7 @@ CMYKA images) and offsets are normalized (divide Flash offset by 255).

As an example, to add contrast to an image with offsets, try this command:

-+
convert kittens.jpg -color-matrix \
" 1.5 0.0 0.0 0.0, 0.0, -0.157 \
0.0 1.5 0.0 0.0, 0.0, -0.157 \
@@ -1203,16 +1203,16 @@ convert kittens.jpg -color-matrix \
0.0 0.0 0.0 1.0, 0.0, 0.0 \
0.0 0.0 0.0 0.0, 1.0, 0.0 \
0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
-

+

- -colorspace value
+ -colorspace value

Set the image colorspace.

Choices are:

-+
CMY CMYK Gray HCL
HCLp HSB HSI HSL
HSV HWB Lab LCHab
@@ -1221,13 +1221,13 @@ OHTA Rec601YCbCr Rec709YCbCr RGB
scRGB sRGB Transparent xyY
XYZ YCbCr YCC YDbDr
YIQ YPbPr YUV Undefined
-

+

To print a complete list of colorspaces, use -list colorspace.

For a more accurate color conversion to or from the linear RGB, CMYK, or grayscale colorspaces, use the -profile option. Note, ImageMagick assumes the sRGB colorspace if the image format does not indicate otherwise. For colorspace conversion, the gamma function is first removed to produce linear RGB.

-

Name

+
@@ -1329,8 +1329,8 @@ YIQ YPbPr YUV Undefined
Use the Undefined colorspace to identify multi-spectral images.

- -combine
- +combine colorspace
+ -combine
+ +combine colorspace

Combine one or more images into a single image.
@@ -1346,14 +1346,14 @@ href="command-line-options.html#separate">-separate, so long as the channel
Thus, in the following example, the final image should be a copy of the
original.

-+
convert original.png -channel RGB -separate sepimage.png
convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
-combine imagecopy.png
-

+

- -comment string
+ -comment string

Embed a comment in an image.
@@ -1377,42 +1377,42 @@ instead.
For example,

-+
-comment "%m:%f %wx%h" bird.miff
-

+
produces an image comment of MIFF:bird.miff 512x480 (assuming
that the image bird.miff has a width of 512 and a height of
480.

- -compare
+ -compare

mathematically and visually annotate the difference between an image and its reconstruction
This is a convert version of "compare" for two same sized images. The syntax is as follows, but other metrics are allowed.

-+
convert image.png reference.png -metric RMSE -compare \
difference.png
-

+
To get the metric value use the string format "%[distortion]".

-+
convert image.png reference.png -metric RMSE -compare -format \
"%[distortion]" info:
-

+

- -complex operator
+ -complex operator

perform complex mathematics on an image sequence

Choose from these operators:

-+
add
conjugate
divide
@@ -1420,12 +1420,12 @@ magnitude-phase
multiply
real-imaginary
subtract
-

+
Optionally specify the divide operator SNR with -define complex:snr=float.

- -compose operator
+ -compose operator

Set the type of image composition.
@@ -1450,7 +1450,7 @@ command.

- -composite
+ -composite

Perform alpha composition on two images and an optional mask
@@ -1480,7 +1480,7 @@ to 'false'.

- -compress type
+ -compress type

Use pixel compression specified by type when writing the image.
@@ -1522,7 +1522,7 @@ sampling factor to be used by JPEG, MPEG, and YUV encoders for down-sampling
the chroma channels.

- -connected-components connectivity
+ -connected-components connectivity

connected-components labeling detects connected regions in an image, choose from 4 or 8 way connectivity.
@@ -1530,7 +1530,7 @@ the chroma channels.
Use -define connected-components:verbose=true to output statistics associated with each unique label.

- -contrast
+ -contrast

Enhance or reduce the image contrast.
@@ -1542,12 +1542,12 @@ contrast.
For a more pronounced effect you can repeat the option:

-+
convert rose: -contrast -contrast rose_c2.png
-

+

- -contrast-stretch black-point
-contrast-stretch black-point{xwhite-point}{%}
+ -contrast-stretch black-point
-contrast-stretch black-point{xwhite-point}{%}

Increase the contrast in an image by stretching the range of intensity values.
@@ -1581,7 +1581,7 @@ normalization of mathematical images.

- -convolve kernel
+ -convolve kernel

Convolve an image with a user-supplied convolution kernel.
@@ -1611,13 +1611,13 @@ entry.

- -copy geometry offset
+ -copy geometry offset

copy pixels from one area of an image to another.

- -crop geometry{@}{!}
+ -crop geometry{@}{!}

Cut out one or more rectangular regions of the image.
@@ -1669,7 +1669,7 @@ you are going to write to an image format such as PNG that supports an image
offset.

- -cycle amount
+ -cycle amount

displace image colormap by amount.
@@ -1679,7 +1679,7 @@ colormap entry is shifted.

- -debug events
+ -debug events

enable debug printout.
@@ -1696,9 +1696,9 @@ a comma-separated list consisting of one or more of the following domains:

For example, to log cache and blob events, use.

-+
convert -debug "Cache,Blob" rose: rose.png
-

+
The User domain is normally empty, but developers can log user
events in their private copy of ImageMagick.
@@ -1718,7 +1718,7 @@ option.

- -decipher filename
+ -decipher filename

Decipher and restore pixels that were previously transformed by -encipher.
@@ -1731,7 +1731,7 @@ Decipher an Image.

- -deconstruct
+ -deconstruct

find areas that has changed between images
@@ -1750,7 +1750,7 @@ method 'compare-any'.

- -define key{=value}...
+ -define key{=value}...

add specific global settings generally used to control coders and image processing operations.
@@ -1781,7 +1781,7 @@ is case-dependent.
The following definitions are just some of the artifacts that are
available:

-
Conversion of RGB to Other Color Spaces
CMY
C=QuantumRangeâR

+
@@ -2254,9 +2254,9 @@ available:
the PNG file. Because the list is processed from left to right, you
can achieve this with a single define:

-+
-define png:include-chunk=none,gAMA
-

+
As a special case, if the sRGB chunk is not excluded and
the PNG encoder recognizes that the image contains the sRGB ICC profile,
@@ -2278,9 +2278,9 @@ available:
The -strip option does the equivalent of the
following for PNG output:

-+
-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date
-

+
The default behavior is to include all known PNG ancillary chunks
plus ImageMagick's private vpAg ("virtual page") chunk,
@@ -2494,20 +2494,20 @@ available:
For example, to create a postscript file that will render only the black
pixels of a bilevel image, use:

-+
convert bilevel.tif -define ps:imagemask eps3:stencil.ps
-

+
Set attributes of the image registry by prefixing the value with
registry:. For example, to set a temporary path to put work files,
use:

-+
-define registry:temporary-path=/data/tmp
-

+

- -delay ticks
-delay ticksxticks-per-second {<} {>}
+ -delay ticks
-delay ticksxticks-per-second {<} {>}

display the next image after pausing.
@@ -2528,7 +2528,7 @@ a file redirection.

- -delete indexes
+ -delete indexes

delete the images specified by index, from the image sequence.
@@ -2541,7 +2541,7 @@ a dash (e.g. 0-4). Separate indexes with a comma (e.g. 0,2). Use

- -density width
-density widthxheight
+ -density width
-density widthxheight

Set the horizontal and vertical resolution of an image for rendering to devices.
@@ -2575,7 +2575,7 @@ to the pixels. To resize the image so that it is the same size at a different
resolution, use the -resample option.

- -depth value
+ -depth value

depth of the image.
@@ -2585,13 +2585,13 @@ to specify the depth of raw images whose depth is unknown such as GRAY, RGB,
or CMYK, or to change the depth of any image after it has been read.

- -descend
+ -descend

obtain image by descending window hierarchy.

- -deskew threshold{%}
+ -deskew threshold{%}

straighten an image. A threshold of 40% works for most images.
@@ -2600,19 +2600,19 @@ or CMYK, or to change the depth of any image after it has been read.
true | false to auto crop the image.

- -despeckle
+ -despeckle

reduce the speckles within an image.

- -direction type
+ -direction type

render text right-to-left or left-to-right.

- -displace horizontal-scale{%}{!}
-displace horizontal-scalexvertical-scale{%}{!}
+ -displace horizontal-scale{%}{!}
-displace horizontal-scalexvertical-scale{%}{!}

shift image pixels as defined by a displacement map.
@@ -2672,7 +2672,7 @@ overlaid areas will not be effected.

- -display host:display[.screen]
+ -display host:display[.screen]

Specifies the X server to contact.
@@ -2681,7 +2681,7 @@ overlaid areas will not be effected.
X server. See X(1).

- -dispose method
+ -dispose method

define the GIF disposal image setting for images that are being created or read in.
@@ -2693,11 +2693,11 @@ animation is to be overlaid onto the display.
Here are the valid methods:

-
-Undefined
0: No disposal specified (equivalent to 'none').
-None
1: Do not dispose, just overlay next frame image.
-Background
2: Clear the frame area with the background color.
-Previous
3: Clear to the image prior to this frames overlay.
+
+Undefined
0: No disposal specified (equivalent to 'none').
+None
1: Do not dispose, just overlay next frame image.
+Background
2: Clear the frame area with the background color.
+Previous
3: Clear to the image prior to this frames overlay.

You can also use the numbers given above, which is what the GIF format
@@ -2712,14 +2712,14 @@ resetting the layer disposal methods of images being read in.
disposal method for images already in memory.

- -dissimilarity-threshold value
+ -dissimilarity-threshold value

maximum RMSE for subimage match (default 0.2).

- -dissolve src_percent[xdst_percent]
+ -dissolve src_percent[xdst_percent]

dissolve an image into another by the given percent.
@@ -2735,7 +2735,7 @@ are given, each image are dissolved to the percentages given.
images, you would need to use dissolve values of '50,100'.

- -distort method arguments
+ -distort method arguments

distort an image, using the given method and its required arguments.
@@ -2746,7 +2746,7 @@ and meaning of the floating point values depends on the distortion methodChoose from these distortion types:

-

bmp:alpha=true|false
include any alpha channel when writing in the BMP image format.

+
@@ -2765,13 +2765,13 @@ and meaning of the floating point values depends on the distortion method

-
- 2:
Scale Angle
- 3:
X,Y Angle
- 4:
X,Y Scale Angle
- 5:
X,Y ScaleX,ScaleY Angle
- 6:
X,Y Scale Angle NewX,NewY
- 7:
X,Y ScaleX,ScaleY Angle NewX,NewY
+
+ 2:
Scale Angle
+ 3:
X,Y Angle
+ 4:
X,Y Scale Angle
+ 5:
X,Y ScaleX,ScaleY Angle
+ 6:
X,Y Scale Angle NewX,NewY
+ 7:
X,Y ScaleX,ScaleY Angle NewX,NewY

This is actually an alternative way of specifying a 2 dimensional linear
@@ -2884,15 +2884,15 @@ and meaning of the floating point values depends on the distortion method
- arc_angle
- The angle over which to arc the image side-to-side
- rotate_angle
- Angle to rotate resulting image from vertical center
- top_radius
- Set top edge of source image at this radius
- bottom_radius
- Set bottom edge to this radius (radial scaling)
+
+ arc_angle
+ The angle over which to arc the image side-to-side
+ rotate_angle
+ Angle to rotate resulting image from vertical center
+ top_radius
+ Set top edge of source image at this radius
+ bottom_radius
+ Set bottom edge to this radius (radial scaling)

The resulting image is always resized to best fit the resulting image,
@@ -3047,11 +3047,11 @@ perspective distortion of the built-in "rose:" image. Note how spaces were
used to group the 4 sets of coordinate pairs, to make it easier to read and
understand.

-+
convert rose: -virtual-pixel black \
-distort Perspective '0,0,0,0 0,45,0,45 69,0,60,10 69,45,60,35' \
rose_3d_rotated.gif"
-

+

If more that the required number of coordinate pairs are given for
a distortion, the distortion method is 'least squares' fitted to produce the
@@ -3072,11 +3072,11 @@ images become smaller (minified) in the output, which is very common when
using 'perspective' distortion. For example here we view
a infinitely tiled 'plane' all the way to the horizon.

-+
convert -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \
-distort perspective '0,0,5,45 89,0,45,46 0,89,0,89 89,89,89,89' \
checks_tiled.jpg
-

+

Note that a infinitely tiled perspective images involving the horizon can
be very slow, because of the number of pixels that are compressed to generate
@@ -3124,13 +3124,13 @@ lookup value. This is typically only used for debugging EWA resampling.

- -distribute-cache port
+ -distribute-cache port

launch a distributed pixel cache server.

- -dither method
+ -dither method

Apply a Riemersma or Floyd-Steinberg error diffusion dither to
@@ -3165,7 +3165,7 @@ patterns, using uniform color maps, rather than specific color maps.

- -draw string
+ -draw string

Annotate an image with one or more graphic primitives.
@@ -3176,30 +3176,30 @@ operations.

The shape primitives:

-
-point
x,y
-line
x0,y0 x1,y1
-rectangle
x0,y0 x1,y1
-roundRectangle
x0,y0 x1,y1 wc,hc
-arc
x0,y0 x1,y1 a0,a1
-ellipse
x0,y0 rx,ry a0,a1
-circle
x0,y0 x1,y1
-polyline
x0,y0 ... xn,yn
-polygon
x0,y0 ... xn,yn
-bezier
x0,y0 ... xn,yn
-path
specification
-image
operator x0,y0 w,h filename
+
+point
x,y
+line
x0,y0 x1,y1
+rectangle
x0,y0 x1,y1
+roundRectangle
x0,y0 x1,y1 wc,hc
+arc
x0,y0 x1,y1 a0,a1
+ellipse
x0,y0 rx,ry a0,a1
+circle
x0,y0 x1,y1
+polyline
x0,y0 ... xn,yn
+polygon
x0,y0 ... xn,yn
+bezier
x0,y0 ... xn,yn
+path
specification
+image
operator x0,y0 w,h filename

The text primitive:

-
-text
x0,y0 string
+
+text
x0,y0 string

The text gravity primitive:

-
-gravity
NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast
+
+gravity
NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast

The text gravity primitive only affects the placement of text and does not
@@ -3209,19 +3209,19 @@ scope to the -draw option in which

The transformation primitives:

-
-rotate
degrees
-translate
dx,dy
-scale
sx,sy
-skewX
degrees
-skewY
degrees
+
+rotate
degrees
+translate
dx,dy
+scale
sx,sy
+skewX
degrees
+skewY
degrees

The pixel operation primitives:

-
-color
x0,y0 method
-matte
x0,y0 method
+
+color
x0,y0 method
+matte
x0,y0 method

The shape primitives are drawn in the color specified by the preceding

As an example, to define a circle centered at 100,100 that extends to
150,150 use:

-+
-draw 'circle 100,100 150,150'
-

+

The Bezier primitive creates a spline curve and requires three
or points to define its shape. The first and last points are the
@@ -3291,10 +3291,10 @@ to draw complex curves, it is highly recommended either to use the
path primitive or to draw multiple four-point bezier segments with
the start and end knots of each successive segment repeated. For example:

-+
-draw 'bezier 20,50 45,100 45,0 70,50'
-draw 'bezier 70,50 95,100 95,0 120,50'
-

+

A path represents an outline of an object, defined in terms of
moveto (set a new current point), lineto (draw a straight line), curveto (draw
@@ -3309,9 +3309,9 @@ href="http://www.w3.org/TR/SVG/paths.html">Paths.)
image keyword with the composite operator, image location, image size, and
filename:

-+
-draw 'image SrcOver 100,100 225,225 image.jpg'
-

+

You can use 0,0 for the image size, which means to use the actual
dimensions found in the image header. Otherwise, it is scaled to the given
@@ -3329,9 +3329,9 @@ single or double quotes.
For example, the following annotates the image with Works like
magick! for an image titled bird.miff.

-+
-draw "text 100,100 'Works like magick!' "
-

+

See the -annotate option for another convenient way
to annotate an image with text.
@@ -3362,13 +3362,13 @@ reinitialized from the initial affine matrix.
fill color (see -fill). Follow the pixel coordinate with
a method:

-+
point
replace
floodfill
filltoborder
reset
-

+

Consider the target pixel as that specified by your coordinate. The
point method recolors the target pixel. The replace
@@ -3402,7 +3402,7 @@ Vector Graphics format.

- -duplicate count,indexes
+ -duplicate count,indexes

duplicate an image one or more times.
@@ -3415,19 +3415,19 @@ a range of images with a dash (e.g. 0-4). Separate indexes with a comma (e.g.
image sequence.

- -edge radius
+ -edge radius

detect edges within an image.

- -emboss radius
+ -emboss radius

emboss an image.

- -encipher filename
+ -encipher filename

Encipher pixels for later deciphering by -decipher.
@@ -3441,24 +3441,24 @@ Decipher an Image.

- -encoding type
+ -encoding type

specify the text encoding.

Choose from

-+
AdobeCustom AdobeExpert
AdobeStandard AppleRoman
BIG5 GB2312
Latin 2 None
SJIScode Symbol
Unicode Wansung
-

+

- -endian type
+ -endian type

Specify endianness (MSB or LSB) of the image.
@@ -3469,14 +3469,14 @@ Unicode Wansung

- -enhance
+ -enhance

Apply a digital filter to enhance a noisy image.

- -equalize
+ -equalize

perform histogram equalization on the image channel-by-channel.
@@ -3494,7 +3494,7 @@ channel. Here we have ... -colorspace OHTA -channel red -equalize
-colorspace RGB ...

- -evaluate operator value
+ -evaluate operator value

Alter channel pixels by evaluating an arithmetic, relational, or logical expression.
@@ -3511,7 +3511,7 @@ a "normalized pixel" is that number divided by the maximum
normalized pixels are used, they are restored, following the other
calculations, to the full range by multiplying by QuantumRange.)

-

Method
Description
+
@@ -3636,7 +3636,7 @@ then the effective period is the half the QuantumRange.

- -evaluate-sequence operator
+ -evaluate-sequence operator

Alter channel pixels by evaluating an arithmetic, relational, or
@@ -3647,7 +3647,7 @@ href="command-line-options.html#evaluate-sequence">-evaluate-sequence operat
href="command-line-options.html#list">-list evaluate.

- -extent geometry
+ -extent geometry

Set the image size and offset.
@@ -3662,15 +3662,15 @@ specify how to compose the image with the background, use Image Geometry for complete details about the geometry argument.

- -extract geometry
+ -extract geometry

Extract the specified area from image.
@@ -3678,31 +3678,31 @@ convert input.jpg -resize 800x600 -background black -compose Copy \
This option is most useful for extracting a subregion of a very large raw
image. Note that these two commands are equivalent:

-+
convert -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
image.rgb image.png",
convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \
image.rgb image.png"
-

+
If you omit the offsets, as in

-+
convert -size 16000x16000 -depth 8 -extract 640x480 \
image.rgb image.png
-

+
the image is resized to the specified dimensions instead,
equivalent to:

-+
convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
-

+
See Image Geometry for complete details about the geometry argument.

- -family fontFamily
+ -family fontFamily

Set a font family for text.
@@ -3717,12 +3717,12 @@ href="command-line-options.html#font">-font, -style, and -weight.

- -features distance
+ -features distance

display (co-occurrence matrix) texture measure features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.

-+
Angular Second Moment Sum Entropy
Contrast Entropy
Correlation Difference Variance
@@ -3730,10 +3730,10 @@ Sum of Squares Variance Difference Entropy
Inverse Difference Moment Information Measure of Correlation 1
Sum Average Information Measure of Correlation 2
Sum Variance Maximum Correlation Coefficient
-

+

- -fft
+ -fft

implements the forward discrete Fourier transform (DFT).
@@ -3766,16 +3766,16 @@ formats that do not limit the color or compress the image. Thus, MIFF, TIF,
PFM, EXR and PNG are the recommended image formats to use. All of these
formats, except PNG support multi-frame images. So for example,

-+
convert image.png -fft fft_image.miff
-

+
generates a magnitude image as fft_image.miff[0] and a phase
image as fft_image.miff[1]. Similarly,

-+
convert image.png -fft fft_image.png
-

+
generates a magnitude image as fft_image-0.png and a phase image
as fft_image-1.png. If you prefer this representation, then you can
@@ -3800,10 +3800,10 @@ function into what is usually called the spectrum. A log function is used to
enhance the darker values more in comparison to the lighter values. This can
be done, for example, as follows:

-+
convert fft_image.miff[0] -contrast-stretch 0 \
-evaluate log 1000 fft_image_spectrum.png"
-

+
where either -contrast-stretch 0 or -auto-level is used to scale the image to full dynamic
@@ -3844,7 +3844,7 @@ href="http://www.fmwconcepts.com/imagemagick/fourier_transforms/fourier.html"

- -fill color
+ -fill color

color to use when filling a graphic primitive.
@@ -3858,18 +3858,18 @@ the parentheses from being interpreted by your shell.
For example,

-+
-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"
-

+
See -draw for further details.
To print a complete list of color names, use the -list color option.

- -filter type
+ -filter type

Use this type of filter when resizing or distorting an image.
@@ -3878,11 +3878,11 @@ the parentheses from being interpreted by your shell.
operations such as -resize and -distort. For example you can use a simple resize filter such as:

-+
Point Hermite Cubic
Box Gaussian Catrom
Triangle Quadratic Mitchell
-

+
The Bessel and Sinc filter is also provided (as well
as a faster SincFast equivalent form). However these filters are
@@ -3895,11 +3895,11 @@ function that the -filter settin
using these functions will define a 'Windowed' filter, appropriate to the
operator involved. Windowed filters include:

-+
Lanczos Hamming Parzen
Blackman Kaiser Welsh
Hanning Bartlett Bohman
-

+
Also one special self-windowing filter is also provided
Lagrange, which will automagically re-adjust its function depending
@@ -3917,7 +3917,7 @@ filter option.
use of these expert settings (see also -define and -set):-

-

+

-define filter:blur=factor
Scale the X axis of the filter (and its window). Use > 1.0 for
@@ -4032,28 +4032,28 @@ href="command-line-options.html#set" >-set):-

For example, to get a 8 lobe jinc windowed sinc filter (Genseng filter?):

-+
convert image.png \
-filter sinc \
-set filter:window=jinc \
-set filter:lobes=8 \
-resize 150% image.jpg"
-

+

Or a raw un-windowed Sinc filter with 4 lobes:

-+
convert image.png \
-set filter:filter=sinc \
-set filter:lobes=4 \
-resize 150% image.jpg"
-

+

To extract the data for a raw windowing function, combine it with
a 'Box' filter. For example the 'Welch parabolic
windowing function.

-+
convert null: -define filter:filter=Box \
-define filter:window=Welch \
-define filter:support=1.0 \
@@ -4062,7 +4062,7 @@ convert null: -define filter:filter=Box \
gnuplot
set grid
plot \"window_welch.dat\" with lines
-

+

Note that the use of expert options is provided for image processing experts
who have studied and understand how resize filters work. Without this
@@ -4072,14 +4072,14 @@ resizing.

- -flatten
+ -flatten

This is a simple alias for the -layers method "flatten".

- -flip
+ -flip

create a mirror image
@@ -4089,7 +4089,7 @@ upside-down.

- -floodfill {+-}x{+-}y color
+ -floodfill {+-}x{+-}y color

floodfill the image with color at the specified offset.
@@ -4110,7 +4110,7 @@ its 'color floodfill' drawing method.

- -flop
+ -flop

create a mirror image.
@@ -4120,7 +4120,7 @@ a vertical mirror.

- -font name
+ -font name

set the font to use when annotating images with text, or creating labels.
@@ -4139,7 +4139,7 @@ href="command-line-options.html#style">-style, and
- -foreground color
+ -foreground color

Define the foreground color for menus.", "display
@@ -4150,7 +4150,7 @@ href="command-line-options.html#fill">-fill option.
The default foreground color is black.

- -format type
+ -format type

the image format type.
@@ -4168,7 +4168,7 @@ input image filename is image.gif, the output image
filename becomes image.tiff.

- -format string
+ -format string

output formatted image characteristics.
@@ -4178,7 +4178,7 @@ Properties for an explanation on how to specify the argument to this
option.

- -frame geometry
+ -frame geometry

Surround the image with a border or beveled frame.
@@ -4210,12 +4210,12 @@ affected by the -gravity option.

- -frame
+ -frame

include the X window frame in the imported image.

- -function function parameters
+ -function function parameters

Apply a function to channel values.
@@ -4233,31 +4233,31 @@ ImageMagick 6.4.8â8.)
Here, parameters is a comma-separated list of
numerical values. The number of values varies depending on which function is selected. Choose the function from:

-+
Polynomial
Sinusoid
Arcsin
Arctan
-

+

To print a complete list of -function operators,
use -list function. Descriptions follow.

-
- Polynomial
- The Polynomial function takes an arbitrary number of parameters,
+

+ Polynomial
+ The Polynomial function takes an arbitrary number of parameters,
these being the coefficients of a polynomial, in decreasing order of degree.
That is, entering

-+
-function Polynomial a_n,a_n-1,...a₁,a₀
-

+

will invoke a polynomial function given by

-+
a_n uⁿ + a_n-1 u^n-1 + Â·Â·Â· a₁ u + a₀,
-

+

where u is pixel's original normalized channel value.

@@ -4268,7 +4268,7 @@ polynomials) of the -evaluate o
href="command-line-options.html#level">-level operator also affects channels linearly. Some
correspondences follow.

-
+
@@ -4298,32 +4298,32 @@ polynomials can be used to fit any continuous curve to any degree of accuracy
desired.
-Sinusoid
-
+
Sinusoid
+
The Sinusoid function can be used to vary the channel values
sinusoidally by setting frequency, phase shift, amplitude, and a bias. These
values are given as one to four parameters, as follows,

-+
-function Sinusoid freq,[phase,[amp,[bias]]]
-

+

where phase is in degrees. (The domain [0,1] of the function
corresponds to 0 through freqÃ360 degrees.)
The result is that if a pixel's normalized channel value is originally
u, its resulting normalized value is given by

-+
amp * sin(2*Ï* (freq * u + phase / 360)) + bias
-

+

For example, the following generates a curve that starts and ends at 0.9
(when u=0 and 1, resp.), oscillating three times between
.7â.2=.5 and .7+.2=.9.

-+
-function Sinusoid 3,-90,.2,.7
-

+

The default values of amp and bias are both .5. The default for phase
is 0.
@@ -4332,7 +4332,7 @@ is 0.
Cos of the -evaluate operator by allowing
varying amplitude, phase and bias. The correspondence is as follows.

-

-evaluate Set value
-function Polynomial value

+
@@ -4343,49 +4343,49 @@ varying amplitude, phase and bias. The correspondence is as follows.

-evaluate Sin freq
-function Sinusoid freq,0

-ArcSin
-
+
ArcSin
+
The ArcSin function generates the inverse curve of a Sinusoid,
and can be used to generate cylindrical distortion and displacement maps.
The curve can be adjusted relative to both the input values and output range
of values.

-+
-function ArcSin width,[center,[range,[bias]]]
-

+

with all values given in terms of normalized color values (0.0 for black,
1.0 for white). Defaulting to values covering the full range from 0.0 to 1.0
for bout input (width), and output (width) values. '1.0,0.5,1.0,0.5'

-+
range/Ï * asin( 2/width * ( u - center ) ) + bias
-

+

-ArcTan
-
+
ArcTan
+
The ArcTan function generates a curve that smooth crosses from
limit values at infinities, though a center using the given slope value.
All these values can be adjusted via the arguments.

-+
-function ArcTan slope,[center,[range,[bias]]]
-

+

Defaulting to '1.0,0.5,1.0,0.5'.

-+
range/Ï * atan( slope*Ï * ( u - center ) ) + bias
-

+

- -fuzz distance{%}
+ -fuzz distance{%}

Colors within this distance are considered equal.
@@ -4405,7 +4405,7 @@ appending % as a percentage of the maximum possible intensity (255,

- -fx expression
+ -fx expression

apply a mathematical expression to an image or image channels.
@@ -4420,7 +4420,7 @@ option.

- -gamma value
+ -gamma value

level of gamma correction.
@@ -4449,16 +4449,16 @@ is useful if the image is of a known gamma but not set as an image attribute
display gamma; e.g., if your image is sRGB and you want to write a PNG gAMA
chunk, use

-+
convert input.png +gamma .45455 output.png
-

+

(0.45455 is 1/2.2)

Note that gamma adjustments are also available via the -level operator.

- -gaussian-blur radius
-gaussian-blur radiusxsigma
+ -gaussian-blur radius
-gaussian-blur radiusxsigma

Blur the image with a Gaussian operator.
@@ -4493,7 +4493,7 @@ pixels which are outside the image proper are blurred into the final result.

- -geometry geometry
+ -geometry geometry

Set the preferred size and location of the image.
@@ -4501,7 +4501,7 @@ pixels which are outside the image proper are blurred into the final result.
See Image Geometry for complete details about the geometry argument.

- -gravity type
+ -gravity type

Sets the current gravity suggestion for various other settings and options.
@@ -4539,10 +4539,10 @@ that point. (In addition, the -gravi
region itself, which is centered at the pixel
coordinate (60,70). (See Image Geometry for complete details about the geometry argument.)

-+
convert image.png -gravity Center -region 10x10-40+20 \
-negate output.png
-

+

When used as an option to composite, -gravity gives the direction that the image gravitates
@@ -4554,7 +4554,7 @@ within a tile. The default gravity is Center for this purpose.

- -grayscale method
+ -grayscale method

convert image to grayscale.
@@ -4564,27 +4564,27 @@ convert the given image into a linear-grayscale image.

For example, to convert an image to (linear) Rec709Luminance grayscale, type:

-+
convert in.png -grayscale Rec709Luminance out.png
-

+

which is equivalent to:

-+
convert in.png -colorspace gray out.png
-

+

Similarly, to convert an image to (non-linear) Rec709Luma grayscale, type:

-+
convert in.png -grayscale Rec709Luma out.png
-

+

which is equivalent to:

-+
convert in.png -set colorspace RGB -colorspace gray out.png
-

+

Note that a 'colorspace' intensity method will produce the same result
regardless of the current colorpsace of the image. But a 'mathematical'
@@ -4597,14 +4597,14 @@ will not effect other operations that may use that setting.

- -green-primary x,y
+ -green-primary x,y

green chromaticity primary point.

- -hald-clut
+ -hald-clut

apply a Hald color lookup table to the image.
@@ -4614,9 +4614,9 @@ dimensions. Create it with the HALD: prefix (e.g. HALD:8). You
can apply any color transformation to the Hald image and then use this option
to apply the transform to the image.

-+
convert image.png hald.png -hald-clut transform.png
-

+

This option provides a convenient method for you to use Gimp or Photoshop
to make color corrections to the Hald CLUT image and subsequently apply them
@@ -4635,19 +4635,19 @@ mapping.

- -help
+ -help

print usage instructions.

- -highlight-color color
+ -highlight-color color

when comparing images, emphasize pixel differences with this color.

- -hough-lines widthxheight{+threshold}
+ -hough-lines widthxheight{+threshold}

identify straight lines in the image (e.g. -hough-lines 9x9+195).
@@ -4669,7 +4669,7 @@ mapping.
Use -define hough-lines:accumulator=true to return the accumulator image in addition to the lines image.

- -iconGeometry geometry
+ -iconGeometry geometry

specify the icon geometry.
@@ -4681,13 +4681,13 @@ handle negative offsets.
See Image Geometry for complete details about the geometry argument.

- -iconic
+ -iconic

start in icon mode in X Windows", 'animate', 'display

- -identify
+ -identify

identify the format and characteristics of the image.
@@ -4707,7 +4707,7 @@ amounts of image properties are displayed including image statistics, profiles,
image histogram, and others.

- -ift
+ -ift

implements the inverse discrete Fourier transform (DFT).
@@ -4723,15 +4723,15 @@ href="http://en.wikipedia.org/wiki/Fourier_transform">Fourier Transform,
For example, depending upon the image format used to store the result of
the -fft, one would use either

-+
convert fft_image.miff -ift fft_image_ift.png
-

+

or

-+
convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png
-

+

The resulting image may need to be cropped due to padding introduced when
the original image, prior to the -fft or By default the IFT is not normalized (and the FFT is). Use "-define fourier:normalize=inverse to explicitly normalize the IFT and unnormalize the FFT.

- -immutable
+ -immutable

make image immutable.

- -implode factor
+ -implode factor

implode image pixels about the center.

- -insert index
+ -insert index

insert the last image into the image sequence.
@@ -4775,7 +4775,7 @@ other words, insert the last image, at the end of the current image sequence.
Consequently this has no effect on the image sequence order.

- -intensity method
+ -intensity method

method to generate intensity value from pixel.
@@ -4790,13 +4790,13 @@ converting images to -colorspace gray.
the pixel values to linear-RGB or non-linear sRGB colorspace before
being applied to calculate the final greyscale value.

-
-Rec601Luma
0.298839R' + 0.586811G'+ 0.114350B'
-Rec601Luminance
0.298839R + 0.586811G + 0.114350B
-Rec709Luma
0.212656R' + 0.715158G' + 0.072186B'
-Rec709Luminance
0.212656R + 0.715158G + 0.072186B
-Brightness
max(R', G', B')
-Lightness
(min(R', G', B') + max(R', G', B')) / 2.0
+
+Rec601Luma
0.298839R' + 0.586811G'+ 0.114350B'
+Rec601Luminance
0.298839R + 0.586811G + 0.114350B
+Rec709Luma
0.212656R' + 0.715158G' + 0.072186B'
+Rec709Luminance
0.212656R + 0.715158G + 0.072186B
+Brightness
max(R', G', B')
+Lightness
(min(R', G', B') + max(R', G', B')) / 2.0

Note that the above R,G,B values is the image's linear-RGB values, while
@@ -4806,10 +4806,10 @@ R',G',B' are sRGB non-linear values.
current value in the images respective R,G,B channel regardless of
what that is, or what colorspace the image is currently using.

-
-Average
(R + G + B) / 3.0
-MS
(R^2 + G^2 + B^2) / 3.0
-RMS
sqrt( (R^2 + G^2 + B^2) / 3.0 )
+
+Average
(R + G + B) / 3.0
+MS
(R^2 + G^2 + B^2) / 3.0
+RMS
sqrt( (R^2 + G^2 + B^2) / 3.0 )

These methods are often used for other purposes, such as generating a
@@ -4835,7 +4835,7 @@ function.

Operators affected by the -intensity setting include:

-+
-adaptive-blur
-adaptive-sharpen
-black-threshold
@@ -4851,10 +4851,10 @@ function.
-threshold
-tint
-white-threshold
-

+

- -intent type
+ -intent type

use this type of rendering intent when managing the image color.
@@ -4868,14 +4868,14 @@ Perceptual, Relative, Saturation.
To print a complete list of rendering intents, use -list intent.

- -interlace type
+ -interlace type

the type of interlacing scheme.

Choose from:

-+
none
line
plane
@@ -4883,7 +4883,7 @@ partition
JPEG
GIF
PNG
-

+

This option is used to specify the type of interlacing scheme for raw image
formats such as RGB or YUV.
@@ -4904,7 +4904,7 @@ PNG or GIF or progressive JPEG image.
interlace.

- -interpolate type
+ -interpolate type

Set the pixel color interpolation method to use when looking up a color based on a floating point or real value.
@@ -4915,23 +4915,23 @@ image. This setting determines how the color is determined from the colors of
the pixels surrounding that point. That is how to determine the color of a
point that falls between two, or even four different colored pixels.

-
- integer
- The color of the top-left pixel (floor function)
- nearest-neighbor
- The nearest pixel to the lookup point (rounded function)
- average
- The average color of the surrounding four pixels
- bilinear
- A double linear interpolation of pixels (the default)
- mesh
- Divide area into two flat triangular interpolations
- bicubic
- Fitted bicubic-spines of surrounding 16 pixels
- spline
- Direct spline curves (colors are blurred)
- filter
- Use resize -filter settings
+
+ integer
+ The color of the top-left pixel (floor function)
+ nearest-neighbor
+ The nearest pixel to the lookup point (rounded function)
+ average
+ The average color of the surrounding four pixels
+ bilinear
+ A double linear interpolation of pixels (the default)
+ mesh
+ Divide area into two flat triangular interpolations
+ bicubic
+ Fitted bicubic-spines of surrounding 16 pixels
+ spline
+ Direct spline curves (colors are blurred)
+ filter
+ Use resize -filter settings

This most important for distortion operators such as

- -interline-spacing value
+ -interline-spacing value

the space between two text lines.

- -interword-spacing value
+ -interword-spacing value

the space between two words.

- -kerning value
+ -kerning value

the space between two letters.

- -kuwahara radius
-kuwahara radiusxsigma
+ -kuwahara radius
-kuwahara radiusxsigma

edge preserving noise reduction filter.
@@ -4972,7 +4972,7 @@ lookup for positions outside the boundaries of the image.

- -label name
+ -label name

assign a label to an image.
@@ -4992,9 +4992,9 @@ Properties for details of the percent escape codes.

For example,

-+
-label "%m:%f %wx%h" bird.miff
-

+

assigns an image label of MIFF:bird.miff 512x480 to the
"bird.miff" image and whose width is 512 and height is 480, as it
@@ -5013,7 +5013,7 @@ formatting characters are recognized.

- -lat width
-lat widthxheight{+-}offset{%}
+ -lat width
-lat widthxheight{+-}offset{%}

perform local adaptive threshold.
@@ -5031,7 +5031,7 @@ the local background color, from which to separate the foreground color.

- -layers method
+ -layers method

handle multiple images forming a set of image layers or animation frames.
@@ -5040,7 +5040,7 @@ the local background color, from which to separate the foreground color.
which may represent either a set of overlaid 'image layers', a GIF disposal
animation, or a fully-'coalesced' animation sequence.

-
+
@@ -5303,7 +5303,7 @@ settings.

- -level black_point{,white_point}{%}{,gamma}
+ -level black_point{,white_point}{%}{,gamma}

adjust the level of image channels.
@@ -5341,7 +5341,7 @@ values (0 is opaque) and not as 'alpha' values (0 is transparent).

- -level-colors {black_color}{,}{white_color}
+ -level-colors {black_color}{,}{white_color}

adjust the level of an image using the provided dash separated colors.
@@ -5371,7 +5371,7 @@ color (+ form).

- -limit type value
+ -limit type value

Set the pixel cache resource limit.
@@ -5389,13 +5389,13 @@ any limit is reached, ImageMagick fails in some fashion but attempts to take
compensating actions, if possible. For example, the following limits
memory:

-+
-limit memory 32MiB -limit map 64MiB
-

+
Use -list resource to list the current limits. For example, our system shows these limits:

-+
-> identify -list resource
Resource limits:
Width: 100MP
@@ -5408,7 +5408,7 @@ Resource limits:
Thread: 12
Throttle: 0
Time: unlimited
-

+
Requests for pixel storage to keep intermediate images are satisfied by one
of three resource categories: in-memory pool, memory-mapped files pool, and
@@ -5441,9 +5441,9 @@ example, assume you have a web interface that processes images uploaded from
the Internet. To assure ImageMagick does not exceed 10MiB of memory you can
simply set the area limit to 10MiB:

-+
-limit area 10MB
-

+
Now whenever a large image is processed, the pixels are automagically
cached to disk instead of memory. This of course implies that large images
@@ -5452,9 +5452,9 @@ be an order of magnitude faster than on disk. Because your web site users
might inadvertently upload a huge image to process, you should set a disk
limit as well:

-+
-limit area 10MB -limit disk 500MB
-

+
Here ImageMagick stops processing if an image requires more than 500MB of disk storage.

@@ -5479,7 +5479,7 @@ Storage and Resource Requirements on the Architecture page.

- -linear-stretch black-point
-linear-stretch black-point{xwhite-point}{%}
+ -linear-stretch black-point
-linear-stretch black-point{xwhite-point}{%}

Linear with saturation stretch.
@@ -5504,13 +5504,13 @@ normalization of mathematical images.

- -linewidth
+ -linewidth

the line width for subsequent draw operations.

- -liquid-rescale geometry
+ -liquid-rescale geometry

rescale image with seam-carving.
@@ -5518,12 +5518,12 @@ normalization of mathematical images.
See Image Geometry for complete details about the geometry argument.

- -list type
+ -list type

Print a list of supported arguments for various options or settings. Choose from these list types:

-+
Align
Alpha
Boolean
@@ -5594,18 +5594,18 @@ Type
Units
Validate
VirtualPixel
-

+
These lists vary depending on your version of ImageMagick. Use "-list
list" to get a complete listing of all the "-list" arguments
available:

-+
identify -list list
-

+

- -log string
+ -log string

Specify format for debug log.
@@ -5616,31 +5616,31 @@ href="command-line-options.html#debug">-debug option is active.
You can display the following components by embedding special format
characters:

-
-%d
domain
-%e
event
-%f
function
-%l
line
-%m
module
-%p
process ID
-%r
real CPU time
-%t
wall clock time
-%u
user CPU time
-%%
percent sign
-\n
newline
-\r
carriage return
+
+%d
domain
+%e
event
+%f
function
+%l
line
+%m
module
+%p
process ID
+%r
real CPU time
+%t
wall clock time
+%u
user CPU time
+%%
percent sign
+\n
newline
+\r
carriage return

For example:

-+
convert -debug coders -log "%u %m:%l %e" in.gif out.png
-

+

The default behavior is to print all of the components.

- -loop iterations
+ -loop iterations

add Netscape loop extension to your GIF animation.
@@ -5650,34 +5650,34 @@ otherwise the animation repeats itself up to iterations
times.

- -lowlight-color color
+ -lowlight-color color

when comparing images, de-emphasize pixel differences with this color.

- -magnify
+ -magnify

double the size of the image with pixel art scaling.

- -map type
+ -map type

Display image using this type.

Choose from these Standard Colormap types:

-+
best
default
gray
red
green
blue
-

+

The X server must support the Standard
Colormap you choose, otherwise an error occurs. Use list as
@@ -5686,25 +5686,25 @@ the type and display searches the list of colormap types in

- -map components
+ -map components

pixel map.

Here are the valid components of a map:

-
-r
red pixel component
-g
green pixel component
-b
blue pixel component
-a
alpha pixel component (0 is transparent)
-o
opacity pixel component (0 is opaque)
-i
grayscale intensity pixel component
-c
cyan pixel component
-m
magenta pixel component
-y
yellow pixel component
-k
black pixel component
-p
pad component (always 0)
+
+r
red pixel component
+g
green pixel component
+b
blue pixel component
+a
alpha pixel component (0 is transparent)
+o
opacity pixel component (0 is opaque)
+i
grayscale intensity pixel component
+c
cyan pixel component
+m
magenta pixel component
+y
yellow pixel component
+k
black pixel component
+p
pad component (always 0)

You can specify as many of these components as needed in any order (e.g.
@@ -5712,7 +5712,7 @@ bgr). The components can repeat as well (e.g. rgbr).

- -mattecolor color
+ -mattecolor color

Specify the color to be used with the -frame option.
@@ -5723,7 +5723,7 @@ bgr). The components can repeat as well (e.g. rgbr).
style="background-color: #bdbdbd;">this shade of gray.

- -maximum
+ -maximum

return the maximum intensity of an image sequence.
@@ -5734,7 +5734,7 @@ style="background-color: #bdbdbd;">this shade of gray.
name.

- -median geometry
+ -median geometry

apply a median filter to the image.
@@ -5745,7 +5745,7 @@ name.
name.

- -mean-shift widthxheight{+distance{%}
+ -mean-shift widthxheight{+distance{%}

image noise removal and color reduction/segmentation (e.g. -mean-shift 7x7+10%).
@@ -5755,24 +5755,24 @@ name.
The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the radius=sqrt((width-1)(height-1)/4) surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x,y centroid from those coordinates and a new mean. This new x,y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.

- -metric type
+ -metric type

Output to STDERR a measure of the differences between images according to the type given metric.

Choose from:

-
-AE
absolute error count, number of different pixels (-fuzz effected)
-FUZZ
mean color distance
-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 (normalized peak absolute)
-PHASH
perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with -define phash:colorspaces=colorspace,colorspace,...
-PSNR
peak signal to noise ratio
-RMSE
root mean squared (normalized root mean squared)
+
+AE
absolute error count, number of different pixels (-fuzz effected)
+FUZZ
mean color distance
+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 (normalized peak absolute)
+PHASH
perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with -define phash:colorspaces=colorspace,colorspace,...
+PSNR
peak signal to noise ratio
+RMSE
root mean squared (normalized root mean squared)

Control the 'AE', or absolute count of pixels that are different,
@@ -5791,7 +5791,7 @@ metric option.

- -minimum
+ -minimum

return the minimum intensity of an image sequence.
@@ -5804,13 +5804,13 @@ name.

- -mode geometry
+ -mode geometry

make each pixel the \'predominant color\' of the neighborhood.'

- -mode value
+ -mode value

Mode of operation.
@@ -5824,7 +5824,7 @@ ImageMagick installation.

- -modulate brightness[,saturation,hue]
+ -modulate brightness[,saturation,hue]

Vary the brightness, saturation, and hue of an image.
@@ -5856,32 +5856,32 @@ href="command-line-options.html#modulate">-modulate 120,90.
>option:modulate:colorspace' to specify which colorspace to
modulate. Choose from HCL, HCLp, HSB, HSI, HSL (the default), HSV, HWB, or LCH (LCHuv). For example,

-+
convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png
-

+

- -moments
+ -moments

report image moments and perceptual hash.

- -monitor
+ -monitor

monitor progress.

- -monochrome
+ -monochrome

transform the image to black and white.

- -morph frames
+ -morph frames

morphs an image sequence.
@@ -5894,8 +5894,8 @@ argument determine how many images to interpolate between each image.

- -morphology
- -morphology method kernel
+ -morphology
+ -morphology method kernel

apply a morphology method to the image.
@@ -5906,14 +5906,14 @@ Morphology.

- -mosaic
+ -mosaic

an simple alias for the -layers method "mosaic"

- -motion-blur radius
-motion-blur radiusxsigma+angle
+ -motion-blur radius
-motion-blur radiusxsigma+angle

simulate motion blur.
@@ -5930,12 +5930,12 @@ pixels which are outside the image proper are blurred into the final result.

- -name
+ -name

name an image.

- -negate
+ -negate

replace each pixel with its complementary color.
@@ -5945,7 +5945,7 @@ black, yellow becomes blue, etc. Use

- -noise geometry

+
-noise geometry

+noise type

@@ -5966,7 +5966,7 @@ which should be used in preference.
Use +noise followed by a noise type to add noise to an image. Choose from these noise
types:

-+
Gaussian
Impulse
Laplacian
@@ -5974,7 +5974,7 @@ Multiplicative
Poisson
Random
Uniform
-

+

The amount of noise added can be controlled by the -attenuate setting. If unset the value is
@@ -5990,7 +5990,7 @@ added to an image.

- -normalize
+ -normalize

Increase the contrast in an image by stretching the range of intensity values.
@@ -6017,7 +6017,7 @@ that is better suited to mathematically generated images.

- -opaque color
+ -opaque color

change this color to the fill color within the image.
@@ -6040,7 +6040,7 @@ href="command-line-options.html#channel">-channel to enable alpha channel ha

- -ordered-dither threshold_map{,level...}
+ -ordered-dither threshold_map{,level...}

dither the image using a pre-defined ordered dither threshold map specified, and a uniform color map with the
@@ -6048,7 +6048,7 @@ given number of levels per color channel.

You can choose from these standard threshold maps:

-+
threshold 1x1 Threshold 1x1 (non-dither)
checks 2x1 Checkerboard 2x1 (dither)
o2x2 2x2 Ordered 2x2 (dispersed)
@@ -6068,7 +6068,7 @@ c6x6b c6x6 Circles 6x6 (black)
c6x6w Circles 6x6 (white)
c7x7b c7x7 Circles 7x7 (black)
c7x7w Circles 7x7 (white)
-

+

The threshold generated a simple 50% threshold of the image.
This could be used with level to do the equivalent of

- -orient image orientation
+ -orient image orientation

specify orientation of a digital camera image.

Choose from these orientations:

-+
bottom-left right-top
bottom-right top-left
left-bottom top-right
left-top undefined
right-bottom
-

+

To print a complete list of orientations, use the -list
orientation option.

- -page geometry

+
-page geometry

-page media[offset][{^!<>}]

+page

@@ -6136,45 +6136,45 @@ href="command-line-options.html#page">-page Letter+43+43).
Use media as shorthand to specify the dimensions (widthxheight) of the PostScript page in dots per inch or a TEXT page in pixels.
The choices for a PostScript page are:

-
- 11x17
792 x 1224
- Ledger
1224 x 792
- Legal
612 x 1008
- Letter
612 x 792
- LetterSmall
612 x 792
- ArchE
2592 x 3456
- ArchD
1728 x 2592
- ArchC
1296 x 1728
- ArchB
864 x 1296
- ArchA
648 x 864
- A0
2380 x 3368
- A1
1684 x 2380
- A2
1190 x 1684
- A3
842 x 1190
- A4
595 x 842
- A4Small
595 x 842
- A5
421 x 595
- A6
297 x 421
- A7
210 x 297
- A8
148 x 210
- A9
105 x 148
- A10
74 x 105
- B0
2836 x 4008
- B1
2004 x 2836
- B2
1418 x 2004
- B3
1002 x 1418
- B4
709 x 1002
- B5
501 x 709
- C0
2600 x 3677
- C1
1837 x 2600
- C2
1298 x 1837
- C3
918 x 1298
- C4
649 x 918
- C5
459 x 649
- C6
323 x 459
- Flsa
612 x 936
- Flse
612 x 936
- HalfLetter
396 x 612
+
+ 11x17
792 x 1224
+ Ledger
1224 x 792
+ Legal
612 x 1008
+ Letter
612 x 792
+ LetterSmall
612 x 792
+ ArchE
2592 x 3456
+ ArchD
1728 x 2592
+ ArchC
1296 x 1728
+ ArchB
864 x 1296
+ ArchA
648 x 864
+ A0
2380 x 3368
+ A1
1684 x 2380
+ A2
1190 x 1684
+ A3
842 x 1190
+ A4
595 x 842
+ A4Small
595 x 842
+ A5
421 x 595
+ A6
297 x 421
+ A7
210 x 297
+ A8
148 x 210
+ A9
105 x 148
+ A10
74 x 105
+ B0
2836 x 4008
+ B1
2004 x 2836
+ B2
1418 x 2004
+ B3
1002 x 1418
+ B4
709 x 1002
+ B5
501 x 709
+ C0
2600 x 3677
+ C1
1837 x 2600
+ C2
1298 x 1837
+ C3
918 x 1298
+ C4
649 x 918
+ C5
459 x 649
+ C6
323 x 459
+ Flsa
612 x 936
+ Flse
612 x 936
+ HalfLetter
396 x 612

This option is also used to place subimages when writing to a multi-image
@@ -6205,7 +6205,7 @@ present with a value other than NorthWest.
Use +page to remove the page settings for an image.

- -paint radius
+ -paint radius

simulate an oil painting.
@@ -6214,12 +6214,12 @@ present with a value other than NorthWest.
neighborhood whose width is specified with radius.

- -path path
+ -path path

write images to this path on disk.

- -pause seconds
+ -pause seconds

Pause between animation loops
@@ -6227,7 +6227,7 @@ neighborhood whose width is specified with radius.
Pause for the specified number of seconds before repeating the animation.

- -pause seconds
+ -pause seconds

Pause between snapshots.
@@ -6235,25 +6235,25 @@ neighborhood whose width is specified with radius.
Pause for the specified number of seconds before taking the next snapshot.

- -perceptible epsilon
+ -perceptible epsilon

set each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.

- -ping
+ -ping

efficiently determine image characteristics.

- -pointsize value
+ -pointsize value

pointsize of the PostScript, OPTION1, or TrueType font.

- -polaroid angle
+ -polaroid angle

simulate a Polaroid picture.
@@ -6261,7 +6261,7 @@ neighborhood whose width is specified with radius.
Use +polaroid to rotate the image at a random angle between -15 and +15 degrees.

- -poly "wt,exp ..."
+ -poly "wt,exp ..."

combines multiple images according to a weighted sum of polynomials; one floating point weight (coefficient) and one floating point polynomial exponent (power) for each image expressed as comma separated pairs.
@@ -6284,7 +6284,7 @@ neighborhood whose width is specified with radius.

- -posterize levels
+ -posterize levels

reduce the image to a limited number of color levels per channel.
@@ -6293,13 +6293,13 @@ neighborhood whose width is specified with radius.
visible effect.

- -precision value
+ -precision value

set the maximum number of significant digits to be printed.

- -preview type
+ -preview type

image preview type.
@@ -6308,7 +6308,7 @@ visible effect.
convert file.png -preview Gamma Preview:gamma.png). Choose from
these previews:

-+
AddNoise
Blur
Brightness
@@ -6338,20 +6338,20 @@ Spread
Swirl
Threshold
Wave
-

+

To print a complete list of previews, use the -list preview option.

The default preview is JPEG.

- -print string
+ -print string

interpret string and print to console.

- -process command
+ -process command

process the image with a custom image filter.
@@ -6362,7 +6362,7 @@ argN" where module is the name of the module to invoke (e.g.
pass to the process module.

- -profile filename

+
-profile filename

+profile profile_name

@@ -6388,9 +6388,9 @@ used. Instead, simply write the file to an image format such as APP1, 8BIM,
For example, to extract the Exif data (which is stored in JPEG files in the
APP1 profile), use.

-+
convert cockatoo.jpg profile.exif
-

+

It is important to note that results may depend on whether or not the
original image already has an included profile. Also, keep in mind that

-
+
convert CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
-

+

Furthermore, since ICC profiles are not necessarily symmetric, extra
conversion steps can yield unwanted results. CMYK profiles are often very
@@ -6409,7 +6409,7 @@ asymmetric since they involve 3â>4 and 4â>3 channel mapping.

- -quality value
+ -quality value

JPEG/MIFF/PNG compression level.
@@ -6441,12 +6441,12 @@ compression.
If filter-type is 4 or less, the specified PNG filter-type is used for
all scanlines:

-
-0
none
-1
sub
-2
up
-3
average
-4
Paeth
+
+0
none
+1
sub
+2
up
+3
average
+4
Paeth

If filter-type is 5, adaptive filtering is used when quality is greater
@@ -6486,7 +6486,7 @@ the PNG specification.
For the BPG image format, quality/2 is the actual BPG compression level (range from 0 to 51).

- -quantize colorspace
+ -quantize colorspace

reduce colors using this colorspace.
@@ -6499,13 +6499,13 @@ GIF, and PNG8.

- -quiet
+ -quiet

suppress all warning messages. Error messages are still reported.

- -radial-blur angle
+ -radial-blur angle

Blur around the center of the image.
@@ -6519,7 +6519,7 @@ pixels which are outside the image proper are blurred into the final result.

- -raise thickness
+ -raise thickness

Lighten or darken image edges.
@@ -6531,13 +6531,13 @@ a raised effect, otherwise use +raise<
href="command-line-options.html#raise">-raise does not alter the dimensions of the image.

- -random-threshold lowxhigh
+ -random-threshold lowxhigh

Apply a random threshold to the image.

- -read-mask
+
-read-mask
filename

@@ -6553,13 +6553,13 @@ grayscale values causing blended updates of the image the mask is attached to.
but with strict boolean masking.

- -red-primary x,y
+ -red-primary x,y

Set the red chromaticity primary point.

- -regard-warnings
+ -regard-warnings

Pay attention to warning messages.
@@ -6568,7 +6568,7 @@ but with strict boolean masking.
as errors.

- -remap filename
+ -remap filename

Reduce the number of colors in an image to the colors used by this image.
@@ -6600,7 +6600,7 @@ reduce the number of colors in an animated image sequence.
Note, the remap image colormap has at most 8-bits of precision. Deeper color maps are automagically coalesced with other colors to meet this requirement.

- -region geometry
+ -region geometry

Set a region in which subsequent operations apply.
@@ -6613,7 +6613,7 @@ in the same manner as in -crop.
Use +region to remove any previously set regions.

- -remote
+ -remote

perform a remote operation.
@@ -6625,7 +6625,7 @@ running simultaneously, use the wind
specify which application to control.

- -render
+ -render

render vector operations.
@@ -6634,7 +6634,7 @@ specify which application to control.
This useful when saving the result to vector formats such as MVG or SVG.

--repage geometry
+-repage geometry

Adjust the canvas and offset information of the image.
@@ -6661,7 +6661,7 @@ directly assign virtual canvas meta-data.

- -resample horizontalxvertical
+ -resample horizontalxvertical

Resample image to specified horizontal and vertical resolution.
@@ -6682,7 +6682,7 @@ continue to treat the image using its former resolution, ignoring the image
resolution specified in the standard file header.

- -resize geometry
+ -resize geometry

Resize an image.
@@ -6699,26 +6699,26 @@ filter.
coding. If your image is gamma-corrected, you can remove the nonlinear gamma
correction, apply the transform, then restore it like this:

-+
convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
-quality 92 passport.jpg
-

+

- -respect-parentheses
+ -respect-parentheses

settings remain in effect until parenthesis boundary.

- -reverse
+ -reverse

Reverse the order of images in the current image list.

- -roll {+-}x{+-}y
+ -roll {+-}x{+-}y

roll an image vertically or horizontally by the amount given.
@@ -6728,7 +6728,7 @@ A negative y offset rolls the image bottom-to-top.

- -rotate degrees{<}{>}
+ -rotate degrees{<}{>}

Apply Paeth image rotation (using shear operations) to the image.
@@ -6749,7 +6749,7 @@ filled with the background color.

- -sample geometry
+ -sample geometry

minify / magnify the image with pixel subsampling and pixel replication, respectively.
@@ -6786,7 +6786,7 @@ sampling sub-region.

- -sampling-factor horizontal-factorxvertical-factor
+ -sampling-factor horizontal-factorxvertical-factor

sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.
@@ -6800,7 +6800,7 @@ href="command-line-options.html#sampling-factor">-sampling-factor 4:2:2 to s
downsampling method.

- -scale geometry
+ -scale geometry

minify / magnify the image with pixel block averaging and pixel replication, respectively.
@@ -6822,7 +6822,7 @@ light conditions.

- -scene value
+ -scene value

set scene number.
@@ -6830,7 +6830,7 @@ light conditions.
This option sets the scene number of an image or the first image in an image sequence.

- -screen
+ -screen

specify the screen to capture.
@@ -6842,13 +6842,13 @@ specified window, and more importantly, you can capture menus or other popups
that are independent windows but appear over the specified window.

- -seed
+ -seed

seed a new sequence of pseudo-random numbers

- -segment cluster-thresholdxsmoothing-threshold
+ -segment cluster-thresholdxsmoothing-threshold

segment the colors of an image.
@@ -6868,7 +6868,7 @@ of the color clusters is returned.

- -selective-blur radius
-selective-blur radiusxsigma{+threshold}
+ -selective-blur radius
-selective-blur radiusxsigma{+threshold}

Selectively blur pixels within a contrast threshold.
@@ -6877,13 +6877,13 @@ of the color clusters is returned.
contrast. The threshold may be expressed as a fraction of QuantumRange or as a percentage.

- -separate
+ -separate

separate an image channel into a grayscale image. Specify the channel with -channel.

- -sepia-tone percent-threshold
+ -sepia-tone percent-threshold

simulate a sepia-toned photo.
@@ -6898,8 +6898,8 @@ tone.

- -set key value
- +set key
+ -set key value
+ +set key

sets image attributes and properties for images in the current image sequence.
@@ -6928,20 +6928,20 @@ using the options -comment, Format Percent
Escapes expanded) to images as they are read in. For example:

-+
-> convert rose: -set comment 'Rose is a rose is a rose is a rose' rose.png
identify -format %c rose.png
Rose is a rose is a rose is a rose
-

+

The set value can also make use of Format and Print Image
Properties in the defined value. For example:

-+
-> convert rose: -set origsize '%wx%h' -resize 50% \
-format 'Old size = %[origsize] New size = %wx%h' info:
Old size = 70x46 New size = 35x23
-

+

Other well known 'properties' that are available include:
'date:create' and 'date:modify' and
@@ -6957,17 +6957,17 @@ attribute.
This option can also associate a colorspace or profile with your image.
For example,

-+
convert image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd
-

+

Some 'properties' must be defined in a specific way to be used. For
example only 'properties' prefixed with "filename:" can be used to
modify the output filename of an image. For example

-+
convert rose: -set filename:mysize '%wx%h' 'rose_%[filename:mysize].png'
-

+

If the setting value is prefixed with "option:" the setting will
be saved as a global "Artifact" exactly as if it was set using the

-
+
convert rose: -set option:rosesize '%wx%h' -delete 0 \
label:'%[rosesize]' label_size_of_rose.gif"
-

+

Note that Format Percent Escapes will only match
a 'artifact' if the given key does not match an existing
@@ -6993,9 +6993,9 @@ previously-formatted ancillary chunks into the output PNG file, using
the commandline option as shown below or by setting the profile via a
programming interface:

-+
convert in.png -set profile PNG-chunk-x:<filename> out.png
-

+

where x is a location flag and
filename is a file containing the chunk
@@ -7009,13 +7009,13 @@ of the same type, then add a short unique string after the "x" to prevent
subsequent profiles from overwriting the preceding ones, e.g.,

-+
convert in.png -set profile PNG-chunk-b01:file01 \
-profile PNG-chunk-b02:file02 out.png
-

+

- -shade azimuthxelevation
+ -shade azimuthxelevation

shade the image using a distant light source.
@@ -7025,13 +7025,13 @@ the position of the light source. Use
the shading results as a grayscale image.

- -shadow percent-opacity{xsigma}{+-}x{+-}y{%}
+ -shadow percent-opacity{xsigma}{+-}x{+-}y{%}

simulate an image shadow.

- -shared-memory

@@ -7043,7 +7043,7 @@ and the display must support the MIT-SHM extension.
Otherwise, this option is ignored. The default is True.

- -sharpen radius
-sharpen radiusxsigma
+ -sharpen radius
-sharpen radiusxsigma

sharpen the image.
@@ -7051,7 +7051,7 @@ Otherwise, this option is ignored. The default is True.
Use a Gaussian operator of the given radius and standard deviation (sigma).

- -shave geometry
+ -shave geometry

Shave pixels from the image edges.
@@ -7064,7 +7064,7 @@ Offsets are ignored.
See Image Geometry for complete details about the geometry argument.

- -shear Xdegrees[xYdegrees]
+ -shear Xdegrees[xYdegrees]

Shear the image along the x-axis and/or y-axis.
@@ -7089,21 +7089,21 @@ important to note, since horizontal and vertical shears do not
commute, i.e., the order matters in a sequence of shears. For
example, the following two commands are not equivalent.

-+
convert logo: -shear 20x0 -shear 0x60 logo-sheared.png
convert logo: -shear 0x60 -shear 20x0 logo-sheared.png
-

+

The first of the two commands above is equivalent to the following, except
for the amount of empty space created; the command that follows generates
a smaller image, and so is a better choice in terms of time and space.

-+
convert logo: -shear 20x60 logo-sheared.png
-

+

- -sigmoidal-contrast contrastxmid-point
+ -sigmoidal-contrast contrastxmid-point

increase the contrast without saturating highlights or shadows.
@@ -7131,7 +7131,7 @@ effects) of a true threshold, but with tapered gray-levels around the threshold
mid-point.

- -silent
+ -silent

@@ -7140,7 +7140,7 @@ effects) of a true threshold, but with tapered gray-levels around the threshold
by the import tool.

- -similarity-threshold value
+ -similarity-threshold value

minimum RMSE for subimage match.
@@ -7148,7 +7148,7 @@ by the import tool.
If this setting is used, then the search will stop as soon as it finds a match whose metric is less than or equal to the value. A partially filled second output image will result. Using a value of zero, will cause the search to stop at the first perfect match it finds. If this setting is left off, then the search will proceed to completion or as limited by -dissimilarity-threshold.

- -size width[xheight][+offset]
+ -size width[xheight][+offset]

set the width and height of the image.
@@ -7162,16 +7162,16 @@ image or tell the number of colors in a MAP image file, (e.g. -size

For Photo CD images, choose from these sizes:

-+
192x128
384x256
768x512
1536x1024
3072x2048
-

+

- -sketch radius
-sketch radiusxsigma+angle
+ -sketch radius
-sketch radiusxsigma+angle

simulate a pencil sketch.
@@ -7181,7 +7181,7 @@ angle given is the angle toward which the image is sketched. That is the
direction people would consider the object is coming from.

- -smush offset
+ -smush offset

appends an image sequence together ignoring transparency.
@@ -7195,7 +7195,7 @@ direction people would consider the object is coming from.
For zero offset and transparent images, the non-transparent parts of the two images will be aligned as close as possible without overlapping.

- -snaps value
+ -snaps value

Set the number of screen snapshots.
@@ -7203,7 +7203,7 @@ direction people would consider the object is coming from.
Use this option to grab more than one image from the X server screen, to create an animation sequence.

- -solarize percent-threshold
+ -solarize percent-threshold

negate all pixels above the threshold level.
@@ -7214,32 +7214,32 @@ direction people would consider the object is coming from.
exposing a photographic film to light during the development process.

- -sparse-color method 'x,y color ...'
+ -sparse-color method 'x,y color ...'

color the given image using the specified points of color, and filling the other intervening colors using the given methods.

-
- barycentric
- three point triangle of color given 3 points.
+
+ barycentric
+ three point triangle of color given 3 points.
Giving only 2 points will form a linear gradient between those points.
The gradient generated extends beyond the triangle created by those
3 points.
- bilinear
- Like barycentric but for 4 points. Less than 4 points
+
bilinear
+ Like barycentric but for 4 points. Less than 4 points
fall back to barycentric.
- voronoi
- Simply map each pixel to the to nearest color point
+
voronoi
+ Simply map each pixel to the to nearest color point
given. The result are polygonal 'cells' of solid color.
- manhatten
- Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.
- shepards
- Colors points biased on the ratio of inverse distance
+
manhatten
+ Like voronoi, but resulting polygonal 'cells' are mapped to a fixed coordinate system.
+ shepards
+ Colors points biased on the ratio of inverse distance
squared. Generating spots of color in a sea of the average of
colors.
- inverse
- Colors points biased on the ratio of inverse distance.
+
inverse
+ Colors points biased on the ratio of inverse distance.
This generates sharper points of color rather than rounded spots of
'shepards' Generating spots of color in a sea of the
average of colors.
@@ -7267,7 +7267,7 @@ default value.

- -splice geometry
+ -splice geometry

Splice the current background color into the image.
@@ -7289,7 +7289,7 @@ href="command-line-options.html#gravity">-gravity is later used with

- -spread amount
+ -spread amount

displace image pixels by a random amount.
@@ -7301,26 +7301,26 @@ blend.
The lookup is controlled by the -interpolate setting.

- -statistic type geometry
+ -statistic type geometry

replace each pixel with corresponding statistic from the neighborhood.

Choose from these statistic types:
-
-Gradient
maximum difference (max - min) value in neighborhood
-Maximum
maximum value per channel in neighborhood
-Minimum
minimum value per channel in neighborhood
-Mean
average value per channel in neighborhood
-Median
median value per channel in neighborhood
-Mode
mode (most frequent) value per channel in neighborhood
-Nonpeak
value just before or after the median value per channel in neighborhood
-RMS
root mean square value per channel in neighborhood
-StandardDeviation
standard deviation value per channel in neighborhood
+
+Gradient
maximum difference (max - min) value in neighborhood
+Maximum
maximum value per channel in neighborhood
+Minimum
minimum value per channel in neighborhood
+Mean
average value per channel in neighborhood
+Median
median value per channel in neighborhood
+Mode
mode (most frequent) value per channel in neighborhood
+Nonpeak
value just before or after the median value per channel in neighborhood
+RMS
root mean square value per channel in neighborhood
+StandardDeviation
standard deviation value per channel in neighborhood

- -stegano offset
+ -stegano offset

hide watermark within an image.
@@ -7331,7 +7331,7 @@ this information to recover the steganographic image (e.g. display -size
320x256+35 stegano:image.png).

- -stereo +x{+y}
+ -stereo +x{+y}

composite two images to create a red / cyan stereo anaglyph.
@@ -7339,26 +7339,26 @@ this information to recover the steganographic image (e.g. display -size
The left side of the stereo pair (second image) is saved as the red channel of the output image. The right side (first image) is saved as the green and blue channels. Red-green stereo glasses are required to properly view the stereo image.

- -storage-type type
+ -storage-type type

pixel storage type. Here are the valid types:

-
-char
unsigned characters
-double
doubles
-float
floats
-integer
integers
-long
longs
-quantum
pixels in the native depth of your ImageMagick distribution
-short
unsigned shorts
+
+char
unsigned characters
+double
doubles
+float
floats
+integer
integers
+long
longs
+quantum
pixels in the native depth of your ImageMagick distribution
+short
unsigned shorts

Float and double types are normalized from 0.0 to 1.0 otherwise the pixels
values range from 0 to the maximum value the storage type can support.

- -stretch fontStretch
+ -stretch fontStretch

Set a type of stretch style for fonts.
@@ -7366,7 +7366,7 @@ values range from 0 to the maximum value the storage type can support.
This setting suggests a type of stretch that ImageMagick should try to
apply to the currently selected font family. Select fontStretch from the following.

-+
Any
Condensed
Expanded
@@ -7377,7 +7377,7 @@ SemiCondensed
SemiExpanded
UltraCondensed
UltraExpanded
-

+

To print a complete list of stretch types, use -list
stretch.
@@ -7387,13 +7387,13 @@ href="command-line-options.html#font">-font, -style, and -weight.

- -strip
+ -strip

strip the image of any profiles, comments or these PNG chunks: bKGD,cHRM,EXIF,gAMA,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date.

- -stroke color
+ -stroke color

color to use when stroking a graphic primitive.
@@ -7403,7 +7403,7 @@ href="command-line-options.html#style">-style, and -draw for further details.

- -strokewidth value
+ -strokewidth value

set the stroke width.
@@ -7411,7 +7411,7 @@ href="command-line-options.html#style">-style, and -draw for further details.

- -style fontStyle
+ -style fontStyle

Set a font style for text.
@@ -7420,19 +7420,19 @@ href="command-line-options.html#style">-style, and -font, -family, -stretch, and -weight.

- -subimage-search
+ -subimage-search

search for subimage.
@@ -7456,7 +7456,7 @@ sub-image the faster this search is.

- -swap index,index
+ -swap index,index

Swap the positions of two images in the image sequence.
@@ -7466,7 +7466,7 @@ images in the current image sequence. Use
- -swirl degrees
+ -swirl degrees

swirl image pixels about the center.
@@ -7474,7 +7474,7 @@ the last two images in the sequence.
Degrees defines the tightness of the swirl.

- -synchronize
+ -synchronize

synchronize image to storage device.
@@ -7485,13 +7485,13 @@ valid image file in the event of a system crash and early reporting if there
is not enough disk space for the image pixel cache.

- -taint
+ -taint

Mark the image as modified.

- -text-font name
+ -text-font name

font for writing fixed-width text.
@@ -7504,13 +7504,13 @@ OPTION1 font. For example, Courier.ttf is a TrueType font and
x:fixed is OPTION1.

- -texture filename
+ -texture filename

name of texture to tile onto the image background.

- -threshold value{%}
+ -threshold value{%}

\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/command-line-processing.html b/www/command-line-processing.html
index c5d933039..0c409d687 100644
--- a/www/command-line-processing.html
+++ b/www/command-line-processing.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The Anatomy of the Command-line â¢ Input Filename â¢ Command-line Options â¢ Output Filename

The ImageMagick command-line tools can be as simple as this:

-+
magick image.jpg image.png
-

+

Or it can be complex with a plethora of options, as in the following:

-+
magick label.gif +matte \
$ +clone -shade 110x90 -normalize -negate +clone -compose Plus -composite $ \
$ -clone 0 -shade 110x50 -normalize -channel BG -fx 0 +channel -matte $ \
-delete 0 +swap -compose Multiply -composite button.gif");
-

+

This example command is long enough that the command must be written across several lines, so we formatted it for clarity by inserting backslashes (\). The backslash is the Unix line-continuation character. In the Windows shell, use a carat character (^) for line-continuation. We use the Unix style on these web pages, as above. Sometimes, however, the lines are wrapped by your browser if the browser window is small enough, but the command-lines, shown in white, are still intended to be typed as one line. Line continuation characters need not be entered. The parentheses that are escaped above using the backslash are not escaped in Windows. There are some other differences between Windows and Unix (involving quotation marks, for instance), but we'll discuss some of those issues later, as they arise.

@@ -94,7 +94,7 @@ magick label.gif +matte \

Given the complexity of the rendering, you might be surprised it is accomplished by a single command-line:

-+
magick -size 320x90 canvas:none -stroke snow4 -size 1x90 -tile gradient:white-snow4 \
-draw 'roundrectangle 16, 5, 304, 85 20,40' +tile -fill snow \
-draw 'roundrectangle 264, 5, 304, 85 20,40' -tile gradient:chartreuse-green \
@@ -107,13 +107,13 @@ magick -size 320x90 canvas:none -stroke snow4 -size 1x90 -tile gradient:white-sn
-background firebrick3 -shadow 80x3+3+3 \) +swap -background none -layers merge \) \
-insert 0 -gravity center -append -background white -gravity center -extent 320x200 \
cylinder_shaded.png
-

+

In the next sections we dissect the anatomy of the ImageMagick command-line. Hopefully, after carefully reading and better understanding how the command-line works, you should be able to accomplish complex image-processing tasks without resorting to the sometimes daunting program interfaces.

See Examples of ImageMagick Usage for additional help when using ImageMagick from the command-line.

-The Anatomy of the Command-line
+The Anatomy of the Command-line
The ImageMagick command-line consists of

@@ -134,7 +134,7 @@ magick -size 320x90 canvas:none -stroke snow4 -size 1x90 -tile gradient:white-sn

You can find a detailed explanation of each of the constituent parts of the command-line in the sections that follow.

-Input Filename
+Input Filename

ImageMagick extends the concept of an input filename to include:

@@ -155,9 +155,9 @@ magick -size 320x90 canvas:none -stroke snow4 -size 1x90 -tile gradient:white-sn
In Unix shells, certain characters such as the asterisk (*) and question mark (?) automagically cause lists of filenames to be generated based on pattern matches. This feature is known as globbing. ImageMagick supports filename globbing for systems, such as Windows, that does not natively support it. For example, suppose you want to convert 1.jpg, 2.jpg, 3.jpg, 4.jpg, and 5.jpg in your current directory to a GIF animation. You can conveniently refer to all of the JPEG files with this command:

-+
magick *.jpg images.gif
-

+

Explicit Image Format
Images are stored in a myriad of image formats including
@@ -176,56 +176,56 @@ values. ImageMagick has no way to automagically determine the image format
so we explicitly set one:

-+
magick -size 640x480 -depth 8 rgb:image image.png
-

+

Built-in Images and Patterns

ImageMagick has a number of built-in images and patterns. To utilize the checkerboard pattern, for example, use:

-+
magick -size 640x480 pattern:checkerboard checkerboard.png
-

+

STDIN, STDOUT, and file descriptors
Unix and Windows permit the output of one command to be piped to the input of another. ImageMagick permits image data to be read and written from the standard streams STDIN (standard in) and STDOUT (standard out), respectively, using a pseudo-filename of -. In this example we pipe the output of
convert to the display program:

-+
magick logo: gif:- | display gif:-
-

+

The second explicit format "gif:" is optional in the preceding example. The GIF image format has a unique signature within the image so ImageMagick's display command can readily recognize the format as GIF. The convert program also accepts STDIN as input in this way:

-+
magick rose: gif:- | magick - -resize "200%" bigrose.jpg'
-

+

Other pipes can be accessed via their file descriptors (as of version 6.4.9-3). The file descriptors 0, 1, and 2 are reserved for the standard streams STDIN, STDOUT, and STDERR, respectively, but a pipe associated with a file descriptor number N>2 can be accessed using the pseudonym fd:N. (The pseudonyms fd:0 and fd:1 can be used for STDIN and STDOUT.) The next example shows how to append image data piped from files with descriptors 3 and 4 and direct the result to the file with descriptor number 5.

-+
magick fd:3 fd:4 -append fd:5
-

+

When needed, explicit image formats can be given as mentioned earlier, as in the following.

-+
magick gif:fd:3 jpg:fd:4 -append tif:fd:5
-

+

Selecting Frames
Some images formats contain more than one image frame. Perhaps you only want the first image, or the last, or some number of images in-between. You can specify which image frames to read by appending the image filename with the frame range enclosed in brackets. Here our image (an animated GIF) contains more than one frame but we only want the first:

-+
magick 'images.gif[0]' image.png
-

+

Unix shells generally interpret brackets so we enclosed the filename in quotes above.
In a Windows command shell the brackets are not interpreted but using quotes doesn't hurt. However, in most cases the roles of single-quotes and double-quotes are reversed with respect to Unix and Windows, so Windows users should usually try double-quotes where we display single-quotes, and vice versa.
@@ -234,16 +234,16 @@ In a Windows command shell the brackets are not interpreted but using quotes doe

You can read more than one image from a sequence with a frame range. For example, you can extract the first four frames of an image sequence:

-+
magick 'images.gif[0-3]' images.mng
-

+

Finally, you can read more than one image from a sequence, out-of-order. The next command gets the third image in the sequence, followed by the second, and then the fourth:

-+
magick 'images.gif[3,2,4]' images.mng
-

+

Notice that in the last two commands, a single image is written. The output in this case, where the image type is MNG, is a multi-frame file because the MNG format supports multiple frames. Had the output format been JPG, which only supports single frames, the output would have consisted of separate frames. More about that below, in the section about the Output Filename.

@@ -252,49 +252,49 @@ magick 'images.gif[3,2,4]' images.mng
Raw images are a sequence of color intensities without additional meta information such as width, height, or image signature. With raw image formats, you must specify the image width and height but you can also specify a region of the image to read. In our example, the image is in the raw 8-bit RGB format and is 6000 pixels wide and 4000 pixels high. However, we only want a region of 600 by 400 near the center of the image:

-+
magick -size 6000x4000 -depth 8 'rgb:image[600x400+1900+2900]' image.jpg
-

+

You can get the same results with the ‑extract option:

-+
magick -size 6000x4000 -depth 8 -extract 600x400+1900+2900 rgb:image image.jpg
-

+

Inline Image Resize
It is sometimes convenient to resize an image as they are read. Suppose you have hundreds of large JPEG images you want to convert to a sequence of PNG thumbails:

-+
magick '*.jpg' -resize 120x120 thumbnail%03d.png
-

+

Here all the images are read and subsequently
resized. It is faster and less resource intensive to resize each image it
is read:

-+
magick '*.jpg[120x120]' thumbnail%03d.png
-

+

Inline Image Crop
It is sometimes convenient to crop an image as they are read. Suppose you have hundreds of large JPEG images you want to convert to a sequence of PNG thumbails:

-+
magick '*.jpg' -crop 120x120+10+5 thumbnail%03d.png
-

+

Here all the images are read and subsequently cropped. It is faster and less resource-intensive to crop each image as it is read:

-+
magick '*.jpg[120x120+10+5]' thumbnail%03d.png
-

+

Filename References
@@ -303,23 +303,23 @@ magick '*.jpg[120x120+10+5]' thumbnail%03d.png
The first is with '@' which reads image filenames separated by white space from the specified file. Assume the file myimages.txt consists of a list of filenames, like so:

-+
frame001.jpg
frame002.jpg
frame003.jpg
-

+

We then expect this command:

-+
magick @myimages.txt mymovie.gif
-

+

to read the images frame001.jpg, frame002.jpg, and frame003.jpg and convert them to a GIF image sequence.
If the image path includes one or more spaces, enclose the path in quotes:
-+
'my title.jpg'
-

+

Some ImageMagick command-line options may exceed the capabilities of
@@ -333,29 +333,29 @@ the @ (e.g. @mypoly.txt).
embedding a formatting character in the filename with a scene range. Consider
the filename image-%d.jpg[1-5]. The command

-+
magick image-%d.jpg[1-5]
-

+

causes ImageMagick to attempt to read images with these filenames:

-+
image-1.jpg
image-2.jpg
image-3.jpg
image-4.jpg
image-5.jpg
-

+

Stream Buffering
By default, the input stream is buffered. To ensure information on the source file or terminal is read as soon as its available, set the buffer size to 0:

-+
magick logo: gif:- | display -define stream:buffer-size=0 gif:-
-

+

-Command-line Options
+Command-line Options

You can direct the behavior of ImageMagick utilities with these command-line options. The behavior of an option falls into one of these categories:

@@ -381,9 +381,9 @@ is reset or the command-line terminates. The image settings include:
In this example, -channel applies to each of the images, since, as we mentioned, settings persist:

-+
magick -channel RGB wand.png wizard.png images.png
-

+

Image Operator

@@ -401,9 +401,9 @@ include:

In this example, -negate negates the wand image but not the wizard:

-+
magick wand.png -negate wizard.png images.png
-

+

Image Channel Operator
Operate directly on image channels:
@@ -420,9 +420,9 @@ these image sequence operators:
‑append â¢ ‑affinity â¢ ‑average â¢ ‑clut â¢ ‑coalesce â¢ ‑combine â¢ ‑compare â¢ ‑complex â¢ ‑composite â¢ ‑copy â¢ ‑crop â¢ ‑debug â¢ ‑deconstruct â¢ ‑delete â¢ ‑evaluate‑sequence â¢ ‑fft â¢ ‑flatten â¢ ‑fx â¢ ‑hald‑clut â¢ ‑ift â¢ ‑identify â¢ ‑insert â¢ ‑layers â¢ ‑limit â¢ ‑map â¢ ‑maximum â¢ ‑minimum â¢ ‑morph â¢ ‑mosaic â¢ ‑optimize â¢ ‑print â¢ ‑process â¢ ‑quiet â¢ ‑swap â¢ ‑write
In this example, -append appends three images into one:

-+
magick mikayla.png picnic.png beach.png -append vacation.png
-

+

Image Geometry

@@ -446,7 +446,7 @@ setting for more specifics.

-

Method

+
@@ -513,13 +513,13 @@ setting for more specifics.
This fine image is 640 pixels wide and 480 pixels high. We say its dimensions are 640x480. When we give dimensions of an image, the width (the horizontal dimension) always precedes the height (the vertical dimension). This will be true when we speak of coordinates or offsets into an image, which will always be xâvalue followed by y. Just think of your high school algebra classes and the xyâplane. (Well, almost: our yâaxis will always go downward!)

-+
magick logo: -resize '200%' bigWiz.png
magick logo: -resize '200x50%' longShortWiz.png
magick logo: -resize '100x200' notThinWiz.png
magick logo: -resize '100x200^' biggerNotThinWiz.png
magick logo: -resize '100x200!' dochThinWiz.png
-

+
The first of the four commands is simpleâit stretches both the width and height of the input image by 200% in each direction; it magnifies the whole thing by a factor of two. The second command specifies different percentages for each direction, stretching the width to 200% and squashing the height to 50%. The resulting image (in this example) has dimensions 1280x240. Notice that the percent symbol needn't be repeated; the following are equivalent: 200x50%, 200%x50, 200%x50%.

@@ -535,12 +535,12 @@ magick logo: -resize '100x200!' dochThinWiz.png
Here are a few more examples:

-+
magick logo: -resize '100' wiz1.png
magick logo: -resize 'x200' wiz2.png
magick logo: -resize '100x200>' wiz3.png
magick logo: -resize '100x200<' wiz4.png
-

+
If only one dimension is given it is taken to be the width. When only the width is specified, as in the first example above, the width is accepted as given and the height is chosen to maintain the aspect ratio of the input image. Similarly, if only the height is specified, as in the second example above, the height is accepted and the width is chosen to maintain the aspect ratio.

@@ -549,9 +549,9 @@ magick logo: -resize '100x200<' wiz4.png

Finally, use @ to specify the maximum area in pixels of an image, again while attempting to preserve aspect ratio. (Pixels take only integer values, so some approximation is always at work.) In the following example, an area of 10000 pixels is requested. The resulting file has dimensions 115x86, which has 9890 pixels.

-+
magick logo: -resize '10000@' wiz10000.png
-

+
In all the examples above and below, we have enclosed the geometry arguments within quotation marks. Doing so is optional in many cases, but not always. We must enclose the geometry specifications in quotation marks when using < or > to prevent these characters from being interpreted by the shell as file redirection. On Windows systems, the carat ^ needs to be within quotes, else it is ignored. To be safe, one should probably maintain a habit of enclosing all geometry arguments in quotes, as we have here.

@@ -562,11 +562,11 @@ Here are some examples to illustrate the use of offsets in geome
‑region option. This option allows many other options to modify the pixels within a specified rectangular subregion of an image. As such, it needs to be given the width and height of that region, and also an offset into the image, which is a pair of coordinates that indicate the location of the region within the larger image. Below, in the first example, we specify a region of size 100x200 to be located at the xyâcoordinates x=10, y=20. Let's use the usual algebraic notation (x,y)=(10,20), for convenience.

-+
magick logo: -region '100x200+10+20' -negate wizNeg1.png
magick logo: -region '100x200-10+20' -negate wizNeg2.png
magick logo: -gravity center -region '100x200-10+20' -negate wizNeg3.png
-

+

Note that offsets always require +/â signs. The offset is not actually a true location within the image; its coordinates must be added to some other location. Let's refer to that as the current location. In the first two examples above, though, that location is the upper-left hand corner of the image, which has coordinates (0,0). (That is the default situation when there are no other directives given to change it.) The first example above puts the 100x200 rectangle's own upper-left corner at (10,20).

@@ -580,9 +580,9 @@ magick logo: -gravity center -region '100x200-10+20' -negate wizNeg3.png

In school, your teacher probably permitted you to work on problems on a scrap of paper and then copy the results to your test paper. An image stack is similar. It permits you to work on an image or image sequence in isolation and subsequently introduce the results back into the command-line. The image stack is delineated with parenthesis. Image operators only affect images in the current stack. For example, we can limit the image rotation to just the wizard image like this:

-+
magick wand.gif $ wizard.gif -rotate 30 $ +append images.gif
-

+

Notice again that the parentheses are escaped by preceding them with
@@ -600,7 +600,7 @@ above.

The arguments to these operators are indexes into the image sequence by number, starting with zero, for the first image, and so on. However if you give a negative index, the images are indexed from the end (last image added). That is, an index of -1 is the last image in the current image sequence, -2 gives the second-to-last, and so on.

-Output Filename
+Output Filename

ImageMagick extends the concept of an output filename to include:

@@ -616,18 +616,18 @@ above.
Images can be stored in a mryiad of image formats including the better known JPEG, PNG, TIFF and others. ImageMagick must know the desired format of the image before it is written. ImageMagick leverages the filename extension to determine the format. For example, image.jpg tells ImageMagick to write the image in the JPEG format. In some cases the filename does not identify the image format. In these cases, the image is written in the format it was originally read unless an explicit image format is specified. For example, suppose we want to write our image to a filename of image in the raw red, green, and blue intensity format:

-+
magick image.jpg rgb:image
-

+

Standard Out
Unix permits the output of one command to be piped to another. ImageMagick permits piping one command to another with a filename of -. In this example we pipe the output of convert to the display program:

-+
magick logo: gif:- | display gif:-
-

+

Here the explicit format is optional. The GIF image format has a signature that uniquely identifies it so ImageMagick can readily recognize the format as GIF.

@@ -635,39 +635,39 @@ magick logo: gif:- | display gif:-
Optionally, use an embedded formatting character to write a sequential image list. Suppose our output filename is image-%d.jpg and our image list includes 3 images. You can expect these images files to be written:

-+
image-0.jpg
image-1.jpg
image-2.jpg
-

+

Or retrieve image properties to modify the image filename. For example, the command

-+
magick rose: -set filename:area '%wx%h' 'rose-%[filename:area].png'
-

+

writes an image with this filename:

-+
rose-70x46.png
-

+

Finally to convert multiple JPEG images to individual PDF pages, use:

-+
magick *.jpg +adjoin page-%d.pdf
-

+

Stream Buffering

By default, the output stream is buffered. To ensure information appears on the destination file or terminal as soon as written, set the buffer size to 0:

-+
magick -define stream:buffer-size=0 logo: gif:- | display gif:-
-

+

Donate â¢
@@ -688,4 +688,4 @@ magick -define stream:buffer-size=0 logo: gif:- | display gif:-

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/command-line-tools.html b/www/command-line-tools.html
index dc30712e4..d41243316 100644
--- a/www/command-line-tools.html
+++ b/www/command-line-tools.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

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.
@@ -64,28 +64,28 @@

Here is 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 magick program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to create, edit, compose, or convert images from the command-line.

-
- magick
convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
- magick-script
use this scripting language interpreter to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
+
+ magick
convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
+ magick-script
use this scripting language interpreter to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

We also support tools for compatibility with ImageMagick version 6:
-
- animate
animate an image sequence on any X server.
- compare
mathematically and visually annotate the difference between an image and its reconstruction.
- composite
overlap one image over another.
- conjure
interpret and execute scripts written in the Magick Scripting Language (MSL).
- convert
convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
- display
display an image or image sequence on any X server.
- identify
describe the format and characteristics of one or more image files.
- import
save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
- mogrify
resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert writes to a different image file.
- montage
create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more.
- stream
a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.
+
+ animate
animate an image sequence on any X server.
+ compare
mathematically and visually annotate the difference between an image and its reconstruction.
+ composite
overlap one image over another.
+ conjure
interpret and execute scripts written in the Magick Scripting Language (MSL).
+ convert
convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
+ display
display an image or image sequence on any X server.
+ identify
describe the format and characteristics of one or more image files.
+ import
save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
+ mogrify
resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert writes to a different image file.
+ montage
create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more.
+ stream
a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

If these tools are not available, you can simply append them to the magick tool like this:
-+
magick convert logo: logo.jpg
-

+

@@ -107,4 +107,4 @@ magick convert logo: logo.jpg

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/compare.html b/www/compare.html
index 320732f76..c81a7cd90 100644
--- a/www/compare.html
+++ b/www/compare.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the compare program to mathematically and visually annotate the difference between an image and its reconstruction. See Command Line Processing for advice on how to structure your compare command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the compare command here to illustrate its usefulness and ease of use. To get started, lets compare an image to one thats been sharpened:

-+
magick convert rose.jpg -sharpen 0x1 reconstruct.jpg
magick compare rose.jpg reconstruct.jpg difference.png
magick compare -compose src rose.jpg reconstruct.jpg difference.png
-

+

@@ -82,7 +82,7 @@ magick compare -compose src rose.jpg reconstruct.jpg difference.png

In addition to the visual interpretation of the difference in an image and its reconstruction, we report a mathematical measure of the difference:

-+
-> magick compare -verbose -metric mae rose.jpg reconstruct.jpg difference.png
Image: rose.jpg
Channel distortion: MAE
@@ -90,37 +90,37 @@ Image: rose.jpg
green: 1853.99 (0.0282901)
blue: 2008.67 (0.0306503)
all: 1536.39 (0.0234439)
-

+
Or, if you just want the red channel distortion, use this command:

-+
-> magick compare -channel red -metric PSNR rose.jpg reconstruct.jpg difference.png
19.63
-

+

Or, if you just want the overall image distortion, use this command:

-+
-> magick compare -metric PSNR rose.jpg reconstruct.jpg difference.png
28.31
-

+

If the reconstructed image is a subimage of the image, the compare program returns the best match offset. In addition, it returns a similarity image such that an exact match location is completely white and if none of the pixels match, black, otherwise some gray level in-between:

-+
-> magick compare -metric RMSE -subimage-search logo.png wizard.jpg similarity.gif
85.05 (0.00129778) @ 353,157
-

+

You can find additional examples of using compare in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

The compare program returns 2 on error otherwise 0 if the images are similar or 1 if they are dissimilar.

-Option Summary
+Option Summary

The compare command recognizes these options. Click on an option to get more details about how that option works.

-

+
@@ -415,4 +415,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/compose.html b/www/compose.html
index b390421a0..fab1d8542 100644
--- a/www/compose.html
+++ b/www/compose.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

This page descibed the Image composition methods that is used to define how
@@ -93,7 +93,7 @@ floating-point mathematics rather than simple boolean operations.

The following alpha blending (Duff-Porter) compose methods are available:

-

Option

+
@@ -198,7 +198,7 @@ the rest of the image outside the overlaid area.
The following mathematical composition methods are also available.

-

Method

+
@@ -307,7 +307,7 @@ methods.
The following lighting composition methods are also available.

-

Method

+
@@ -411,7 +411,7 @@ methods.
Also included are these special purpose compose methods:

-

Method

+
@@ -456,9 +456,9 @@ but not always, the same name as the composite 'method' they use, and replaces
the normal use of the -compose
setting in the "composite" command. For example...

-+
composite ... -blend 50x50 ...
-

+
As of IM v6.5.3-4 the "convert" command can now also supply
these extra arguments to its

-

Method

+

diff --git a/www/composite.html b/www/composite.html
index 5968d29dd..47aeebdd6 100644
--- a/www/composite.html
+++ b/www/composite.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the composite program to overlap one image over another. See Command Line Processing for advice on how to structure your composite command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the composite command here to illustrate its usefulness and ease of use. To get started, lets overlay a smiley face over a rose:

-+
magick composite -gravity center smile.gif rose: rose-over.png
-

+

@@ -79,12 +79,12 @@ magick composite -gravity center smile.gif rose: rose-over.png

You can create three-dimensional effect with the Atop:

-+
magick convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
magick convert -size 70x70 canvas:none -draw 'circle 35,35 35,20' -negate \
-channel A -gaussian-blur 0x8 white-highlight.png
magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
-

+

@@ -96,11 +96,11 @@ magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.p

You can find additional examples of using composite in Examples of ImageMagick Usage. You can find out more about them and the mathematics by looking at SVG Alpha Compositing

-Option Summary
+Option Summary

The composite command recognizes these options. Click on an option to get more details about how that option works.

-

Method
+
@@ -526,4 +526,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/conjure.html b/www/conjure.html
index 1957e52ef..3dc5cab29 100644
--- a/www/conjure.html
+++ b/www/conjure.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary â¢ Magick Scripting Language (MSL)

The conjure program gives you the ability to perform custom image processing tasks from a script written in the Magick Scripting Language (MSL). MSL is XML-based and consists of action statements with attributes. Actions include reading an image, processing an image, getting attributes from an image, writing an image, and more. An attribute is a key/value pair that modifies the behavior of an action. See Command Line Processing for advice on how to structure your conjure command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the conjure command here to illustrate its usefulness and ease of use. To get started, here is simple conjure command:

-+
magick conjure -dimensions 400x400 msl:incantation.msl
-

+

The MSL script incantation.msl used above is here:

-+
<?xml version="1.0" encoding="UTF-8"?>
<image>
<read filename="image.gif" />
@@ -81,11 +81,11 @@ magick conjure -dimensions 400x400 msl:incantation.msl
<print output="Image sized from %[base-width]x%[base-height] to %[resize-width]x%[resize-height].\n" />
<write filename="image.png" />
</image>
-

+

In this example, a family stayed home for their vacation but as far as their friends are concerned they went to a beautiful beach in the Caribbean:

-+
<?xml version="1.0" encoding="UTF-8"?>
<group>
<image id="family">
@@ -103,21 +103,21 @@ magick conjure -dimensions 400x400 msl:incantation.msl
</image>
<write filename="family-vacation.png"/>
</group>
-

+

Here we display the width in pixels of text for a particular font and pointsize.

-+
<?xml version="1.0" encoding="UTF-8"?>
<image>
<query-font-metrics text="ImageMagick" font="helvetica" pointsize="48" />
<print output="Text width is %[msl:font-metrics.width] pixels.\n" />
</image>
-

+

The query-font-metrics tag supports these properties:

-+
msl:font-metrics.pixels_per_em.x
msl:font-metrics.pixels_per_em.y
msl:font-metrics.ascent
@@ -131,7 +131,7 @@ msl:font-metrics.bounds.x2
msl:font-metrics.bounds.y2
msl:font-metrics.origin.x
msl:font-metrics.origin.y
-

+

MSL supports most methods and attributes discussed in the Perl API for ImageMagick.

@@ -141,11 +141,11 @@ msl:font-metrics.origin.y
You can find additional examples of using conjure in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The conjure command recognizes these options. Click on an option to get more details about how that option works.

-

Option

+
@@ -200,9 +200,9 @@ msl:font-metrics.origin.y

Option

-Magick Scripting Language
+Magick Scripting Language
The conjure command recognizes these MSL elements. Any element with a strike-thru is not supported yet.
-
+
@@ -1138,4 +1138,4 @@ fill="color name", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray,

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/connected-components.html b/www/connected-components.html
index 42429ab75..c2963b9ee 100644
--- a/www/connected-components.html
+++ b/www/connected-components.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Connected-component labeling (alternatively connected-component analysis, blob extraction, region labeling, blob discovery, or region extraction) uniquely labels connected components in an image. The labeling process scans the image, pixel-by-pixel from top-left to bottom-right, in order to identify connected pixel regions, i.e. regions of adjacent pixels which share the same set of intensity values. For example, let's find the objects in this image:

To identify the objects in this image, use this command:
-+
convert objects.gif -connected-components 4 -auto-level -depth 8 objects.png
-

+
The detected objects are uniquely labeled. Use auto leveling to visualize the detected objects:

Object statistics is useful to review. To display them, use this command:
-+
convert objects.gif -define connected-components:verbose=true -connected-components 4 objects.png
-

+
Five objects were detected in the source image with these statistics:
-+
Objects (id: bounding-box centroid area mean-color):
0: 256x171+0+0 119.2,80.8 33117 srgb(0,0,0)
2: 120x135+104+18 159.5,106.5 8690 srgb(255,255,255)
3: 50x36+129+44 154.2,63.4 1529 srgb(0,0,0)
4: 21x23+0+45 8.8,55.9 409 srgb(255,255,255)
1: 4x10+252+0 253.9,4.1 31 srgb(255,255,255)
-

+
Use -connected-components 8 to visit 8 neighbors rather than 4. By default, neighbor colors must be exact to be part of a unique object. Use the -fuzz option to include pixels as part of an object that are close in color.
You might want to eliminate small objects by merging them with their larger neighbors. If so, use this command:
-+
convert objects.gif -define connected-components:area-threshold=410 -connected-components 4 \
-auto-level objects.jpg
-

+
Here are the expected results. Notice, how the small objects are now merged with the background.

Notice how two of the objects were merged leaving three remaining objects:
-+
Objects (id: bounding-box centroid area mean-color):
0: 256x171+0+0 118.0,80.4 33557 srgb(0,0,0)
2: 120x135+104+18 159.5,106.5 8690 srgb(255,255,255)
3: 50x36+129+44 154.2,63.4 1529 srgb(0,0,0)
-

+
By default, the labeled image is grayscale. You can instead replace the object color in the labeled image with the mean-color from the source image. Simply add this setting, -define connected-components:mean-color=true, to your command line.
You may want to remove certain objects by making them transparent. Use -define connected-components:remove=list-of-ids (e.g. -define connected-components:remove=2,4-5). Or use -define connected-components:keep=list-of-ids to keep these objects and make all others transparent.

@@ -121,4 +121,4 @@ Objects (id: bounding-box centroid area mean-color):

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/contact.html b/www/contact.html
index 28a358b64..709d78166 100644
--- a/www/contact.html
+++ b/www/contact.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Post here for any of the issues listed below. You can expect a response from our team if your issue is a sponsorship, license, security, or paid support issue. If you require a response for any other issue, post to the ImageMagick public forums. You can also post bug reports to the issues forum. Note, we do not offer sponsored links nor do we respond to solicitations.

- Contact the Wizards
+ Contact the Wizards
Enter this code,
040d70, in the Authenticate field and fill in the remaining fields. Press Send to forward your message to the ImageMagick wizards:

-

Magick Scripting Language (MSL)

+
diff --git a/www/convert.html b/www/convert.html
index 7c678de16..906b1f254 100644
--- a/www/convert.html
+++ b/www/convert.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Use the convert program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

We list a few examples of the convert command here to illustrate its usefulness and ease of use. To get started, lets convert an image in the JPEG format to PNG:

-+
magick convert rose.jpg rose.png
-

+

Next, we reduce the image size before it is written to the PNG format:

-+
magick convert rose.jpg -resize 50% rose.png
-

+

@@ -83,11 +83,11 @@ magick convert rose.jpg -resize 50% rose.png

You can combine multiple image-processing operations to produce complex results:

-+
magick convert -size 320x85 canvas:none -font Bookman-DemiItalic -pointsize 72 \
-draw "text 25,60 \'Magick\'" -channel RGBA -blur 0x6 -fill darkred -stroke magenta \
-draw "text 20,55 \'Magick\'" fuzzy-magick.png
-

+

@@ -95,20 +95,20 @@ magick convert -size 320x85 canvas:none -font Bookman-DemiItalic -pointsize 72 \

or here we resize an image with improved quality:

-+
magick convert input.png -colorspace RGB +sigmoidal-contrast 11.6933 \
-define filter:filter=Sinc -define filter:window=Jinc -define filter:lobes=3 \
-resize 400% -sigmoidal-contrast 11.6933 -colorspace sRGB output.png');
-

+

You can find additional examples of using convert in Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The convert command recognizes these options. Click on an option to get more details about how that option works.

-

Authenticate

+
@@ -1322,4 +1322,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/develop.html b/www/develop.html
index c4dcd8123..89ec1d038 100644
--- a/www/develop.html
+++ b/www/develop.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick includes a number of ready-made interfaces. This makes it possible to modify or create images automagically and dynamically utilizing your favorite development platform.

-
- Ada
+
+ Ada

-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
+ C

-Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.
+Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.

- Ch
+ 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+
+ COM+

-Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.
+Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.

- C++
+ 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.

- GO
- GoImagick is a set of Go bindings to ImageMagick's MagickWand and MagickCore C APIs.
+ GO
+ GoImagick is a set of Go bindings to ImageMagick's MagickWand and MagickCore C APIs.

- Java
+ 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.

- Julia
+ Julia

-JuliaIO provides an object-oriented Julia interface to ImageMagick.
+JuliaIO provides an object-oriented Julia interface to ImageMagick.

- LabVIEW
+ LabVIEW

-LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.
+LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.

- Lisp
+ Lisp

-CL-Magick provides a Common Lisp interface to the ImageMagick library.
+CL-Magick provides a Common Lisp interface to the ImageMagick library.

- Lua
+ Lua

-Lua bindings to ImageMagick for LuaJIT using FFI.
-Lua bindings to ImageMagick for Lua using pure-C.
+Lua bindings to ImageMagick for LuaJIT using FFI.
+Lua bindings to ImageMagick for Lua using pure-C.

- Neko
+ 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
+ .NET

-Use Magick.NET to convert, compose, and edit images from Windows .NET.
+Use Magick.NET to convert, compose, and edit images from Windows .NET.

-ImageMagickApp is a .NET application written in C# that utilizes the ImageMagick command line to allow conversion of multiple image formats to different formats.
+ImageMagickApp is a .NET application written in C# that utilizes the ImageMagick command line to allow conversion of multiple image formats to different formats.

- Pascal
+ 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
+ Perl

-Use PerlMagick to convert, compose, and edit images from the Perl language.
+Use PerlMagick to convert, compose, and edit images from the Perl language.

- PHP
+ 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
+ Python

-Wand is a ctypes-based ImagedMagick binding library for Python.
-PythonMagick is an object-oriented Python interface to ImageMagick.
-PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.
-Scilab Image Processing toolbox utilizes ImageMagick to do imaging tasks such as filtering, blurring, edge detection, thresholding, histogram manipulation, segmentation, mathematical morphology, color image processing, etc..
+Wand is a ctypes-based ImagedMagick binding library for Python.
+PythonMagick is an object-oriented Python interface to ImageMagick.
+PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.
+Scilab Image Processing toolbox utilizes ImageMagick to do imaging tasks such as filtering, blurring, edge detection, thresholding, histogram manipulation, segmentation, mathematical morphology, color image processing, etc..

- REALbasic
+ 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
+ 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.

- Rust
+ Rust

-RustWand is a MagickWand bindings for the Rust language.
+RustWand is a MagickWand bindings for the Rust language.

-Tcl/Tk
+Tcl/Tk

-TclMagick a native Tcl-extension to the ImageMagick MagickWand API.
+TclMagick a native Tcl-extension to the ImageMagick MagickWand API.

- XML RPC
+ XML RPC

-RemoteMagick is an XML-RPC web service that creates image thumbnails.
+RemoteMagick is an XML-RPC web service that creates image thumbnails.

@@ -186,4 +186,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/display.html b/www/display.html
index ac32a7285..1b635ea9e 100644
--- a/www/display.html
+++ b/www/display.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the display program to display an image or image sequence on any X server. See Command Line Processing for advice on how to structure your display command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the display command here to illustrate its usefulness and ease of use. To get started, lets display an image in the JPEG format:

-+
magick display rose.jpg
-

+

To tile a slate texture onto the root window, use:

-+
magick display -size 1280x1024 -window root slate.png
-

+

To display a visual image directory of all your JPEG images, use:

-+
magick display 'vid:*.jpg'
-

+

The display program defaults to the X screen resolution. To display vecotr formats at their intended size, override the default resolution:

-+
magick display -density 72 drawing.svg
-

+

You can find additional examples of using display in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The display command recognizes these options. Click on an option to get more details about how that option works.

-

-adaptive-blur geometry
adaptively blur pixels; decrease effect near edges

+
@@ -568,4 +568,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/distribute-pixel-cache.html b/www/distribute-pixel-cache.html
index 57bcc01fe..236a850da 100644
--- a/www/distribute-pixel-cache.html
+++ b/www/distribute-pixel-cache.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

A distributed pixel cache is an extension of the traditional pixel cache available on a single host. The distributed pixel cache may span multiple servers so that it can grow in size and transactional capacity to support very large images or large image sequences. Start up the pixel cache server on one or more hosts. When you read or operate on an image and the local pixel cache resources are exhausted, ImageMagick contacts one or more of these remote pixel servers to store or retrieve pixels.
For really large images or large image sequences, or if there is limited resources on your host, you can utilize a distributed pixel cache on one or more remote hosts. Here we create two distributed pixel caches and utilize them from our desktop:
-+
convert -distribute-cache 6668 & # start on 192.168.100.50
convert -distribute-cache 6668 & # start on 192.168.100.51
convert -limit memory 1GiB -limit map 2GiB -limit disk 4GiB \
-define registry:cache:hosts=192.168.100.50:6668,192.168.100.51:6668 \
myhugeimage.jpg -sharpen 5x2 myhugeimage.png
-

+
For large image sequences, the servers are contacted in a round-robin fashion to distribute the load over multiple distributed pixel caches (assuming you have a host list rather than a single host). In our example, some modest resources are available on the desktop as defined by the -limit option. For smaller images, they are allocated on the desktop up to the specified limits.
Your image processing tasks are likely to perform slower when utilizing a distributed pixel cache due to pixels shuffling between the client and the server over a network. Algorithms that access virtual pixels (e.g. -sharpen) are noticeably slower, up to 3 times slower, than algorithms that only access authentic pixels (e.g. -negate) due to increased network traffic.
A client can only contact a compatible distributed pixel cache server. Compatibility requires the same ImageMagick library interface, quantum depth, HDRI status, OS word size, and endianness. The distributed pixel cache checks these attributes and exits if these requirements are not met.
@@ -89,4 +89,4 @@ convert -limit memory 1GiB -limit map 2GiB -limit disk 4GiB \

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/download.html b/www/download.html
index ce8dc5ee2..eec2cefa4 100644
--- a/www/download.html
+++ b/www/download.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Unix Binary Release â¢ Mac OS X Binary Release â¢ iOS Binary Release â¢ Windows Binary Release

You can install ImageMagick from source. However, if you don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable. Before you download, you may want to review recent changes to the ImageMagick distribution.

-Unix Binary Release
+ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world.
+
+Unix Binary Release

These are the Unix variations that we support. If your system is not on the list, try installing from source. Although ImageMagick runs fine on a single core computer, it automagically runs in parallel on dual and quad-core systems reducing run times considerably.

-

Option

+
@@ -76,16 +78,16 @@

-
-
-
+
+
+
-
-
-
+
+
+

@@ -122,59 +124,59 @@

ImageMagick RPM's are self-installing. Simply type the following command and you're ready to start using ImageMagick:

- rpm -Uvh ImageMagick-7.0.5-10.x86_64.rpm
You'll need the libraries as well:
- rpm -Uvh ImageMagick-libs-7.0.5-10.x86_64.rpm
+ rpm -Uvh ImageMagick-7.0.6-0.x86_64.rpm
You'll need the libraries as well:
+ rpm -Uvh ImageMagick-libs-7.0.6-0.x86_64.rpm
For other systems, create (or choose) a directory to install the package into and change to that directory, for example:

-+
cd $HOME
-

+
Next, extract the contents of the package. For example:

-+
tar xvzf ImageMagick.tar.gz
-

+
Set the MAGICK_HOME environment variable to the path where you extracted the ImageMagick files. For example:

- export MAGICK_HOME="$HOME/ImageMagick-7.0.5"
+ export MAGICK_HOME="$HOME/ImageMagick-7.0.6"
If the bin subdirectory of the extracted package is not already in your executable search path, add it to your PATH environment variable. For example:

-+
export PATH="$MAGICK_HOME/bin:$PATH
-

+
On Linux and Solaris machines add $MAGICK_HOME/lib to the LD_LIBRARY_PATH environment variable:

-+
LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+$LD_LIBRARY_PATH:}$MAGICK_HOME/lib
export LD_LIBRARY_PATH
-

+
Finally, to verify ImageMagick is working properly, type the following on the command line:

-+
magick logo: logo.gif
identify logo.gif
display logo.gif
-

+
Congratulations, you have a working ImageMagick distribution under Unix or Linux and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

-Mac OS X Binary Release
+Mac OS X Binary Release
We recommend MacPorts which custom builds ImageMagick in your environment (some users prefer Homebrew). Download MacPorts and type:

-+
sudo port install ImageMagick
-

+
The port command downloads ImageMagick and many of its delegate libraries (e.g. JPEG, PNG, Freetype, etc.) and configures, builds, and installs ImageMagick automagically. Alternatively, you can download the ImageMagick Mac OS X distribution we provide:

-

Version

ImageMagick-7.0.5-10.x86_64.rpm download download ImageMagick-7.0.6-0.x86_64.rpm download download
Redhat / CentOS 7.1 x86_64 RPM

ImageMagick-libs-7.0.5-10.x86_64.rpm download download ImageMagick-libs-7.0.6-0.x86_64.rpm download download
Redhat / CentOS 7.1 x86_64 RPM

+
@@ -195,39 +197,39 @@ sudo port install ImageMagick

Create (or choose) a directory to install the package into and change to that directory, for example:

-+
cd $HOME
-

+
Next, extract the contents of the package. For example:

-+
tar xvzf ImageMagick-x86_64-apple-darwin15.2.0.tar.gz
-

+
Set the MAGICK_HOME environment variable to the path where you extracted the ImageMagick files. For example:

- export MAGICK_HOME="$HOME/ImageMagick-7.0.5"
+ export MAGICK_HOME="$HOME/ImageMagick-7.0.6"
If the bin subdirectory of the extracted package is not already in your executable search path, add it to your PATH environment variable. For example:

-+
export PATH="$MAGICK_HOME/bin:$PATH"
-

+
Set the DYLD_LIBRARY_PATH environment variable:

-+
export DYLD_LIBRARY_PATH="$MAGICK_HOME/lib/"
-

+
Finally, to verify ImageMagick is working properly, type the following on the command line:

-+
magick logo: logo.gif
identify logo.gif
display logo.gif
-

+
Note, the display program requires the X11 server available on your Mac OS X installation DVD. Once that is installed, you will also need to export DISPLAY=:0.

@@ -235,7 +237,7 @@ display logo.gif

Congratulations, you have a working ImageMagick distribution under Mac OS X and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

-iOS Binary Release
+iOS Binary Release
~Claudio provides iOS builds of ImageMagick.

@@ -255,10 +257,10 @@ display logo.gif
ImageMagick compiling script for iOS OS and iOS Simulator
To run the script:
-+
./imagemagick_compile.sh VERSION
-

-where VERSION is the version of ImageMagick you want to compile (i.e.: 7.0.5-10, svn, ...)
+
+where VERSION is the version of ImageMagick you want to compile (i.e.: 7.0.6-0, svn, ...)
This script compiles ImageMagick as a static library to be included in iOS projects and adds support for

@@ -288,7 +290,7 @@ display logo.gif

A sample project is available for download. It is not updated too often, but it does give an idea of all the settings and some ways to play around with ImageMagick in an iOS application.

-Windows Binary Release
+Windows Binary Release

ImageMagick runs on Windows 10 (x86 & x64), Windows 8 (x86 & x64), Windows 7 (x86 & x64), Windows Server 2012, Windows XP (x86) with Service Pack 3, Windows Vista (x86 & x64) with Service Pack 2, Windows Server 2003 (x86 & x64) with Service Pack 2 (verify MSXML6 is present), Windows Server 2003 R2 (x86 & x64), Windows Server 2008 (x86 & x64) with Service Pack 2, and Windows Server 2008 R2 (x64).

@@ -297,7 +299,7 @@ display logo.gif
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. Unless you have a Windows 32-bit OS, we recommend this version of ImageMagick for 64-bit Windows:

-

Version

+
@@ -307,9 +309,9 @@ display logo.gif

-
-
-
+
+
+

Version

ImageMagick-7.0.5-10-Q16-x64-dll.exe download download ImageMagick-7.0.6-0-Q16-x64-dll.exe download download
Win64 dynamic at 16 bits-per-pixel component

@@ -317,7 +319,7 @@ display logo.gif
Or choose from these alternate Windows binary distributions:

-
+
@@ -327,93 +329,93 @@ display logo.gif

-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+
-
-
-
+
+
+

Version

ImageMagick-7.0.5-10-Q16-x64-static.exe download download ImageMagick-7.0.6-0-Q16-x64-static.exe download download
Win64 static at 16 bits-per-pixel component

ImageMagick-7.0.5-10-Q8-x64-dll.exe download download ImageMagick-7.0.6-0-Q8-x64-dll.exe download download
Win64 dynamic at 8 bits-per-pixel component

ImageMagick-7.0.5-10-Q8-x64-static.exe download download ImageMagick-7.0.6-0-Q8-x64-static.exe download download
Win64 static at 8 bits-per-pixel component

ImageMagick-7.0.5-10-Q16-HDRI-x64-dll.exe download download ImageMagick-7.0.6-0-Q16-HDRI-x64-dll.exe download download
Win64 dynamic at 16 bits-per-pixel component with high dynamic-range imaging enabled

ImageMagick-7.0.5-10-Q16-HDRI-x64-static.exe download download ImageMagick-7.0.6-0-Q16-HDRI-x64-static.exe download download
Win64 static at 16 bits-per-pixel component with high dynamic-range imaging enabled

ImageMagick-7.0.5-10-Q16-x86-dll.exe download download ImageMagick-7.0.6-0-Q16-x86-dll.exe download download
Win32 dynamic at 16 bits-per-pixel component

ImageMagick-7.0.5-10-Q16-x86-static.exe download download ImageMagick-7.0.6-0-Q16-x86-static.exe download download
Win32 static at 16 bits-per-pixel component

ImageMagick-7.0.5-10-Q8-x86-dll.exe download download ImageMagick-7.0.6-0-Q8-x86-dll.exe download download
Win32 dynamic at 8 bits-per-pixel component

ImageMagick-7.0.5-10-Q8-x86-static.exe download download ImageMagick-7.0.6-0-Q8-x86-static.exe download download
Win32 static at 8 bits-per-pixel component

ImageMagick-7.0.5-10-Q16-HDRI-x86-dll.exe download download ImageMagick-7.0.6-0-Q16-HDRI-x86-dll.exe download download
Win32 dynamic at 16 bits-per-pixel component with high dynamic-range imaging enabled

ImageMagick-7.0.5-10-Q16-HDRI-x86-static.exe download download ImageMagick-7.0.6-0-Q16-HDRI-x86-static.exe download download
Win32 static at 16 bits-per-pixel component with high dynamic-range imaging enabled

ImageMagick-7.0.5-10-portable-Q16-x86.zip download download ImageMagick-7.0.6-0-portable-Q16-x86.zip download download
Portable Win32 static at 16 bits-per-pixel component. Just copy to your host and run (no installer, no Windows registry entries).

ImageMagick-7.0.5-10-portable-Q16-x64.zip download download ImageMagick-7.0.6-0-portable-Q16-x64.zip download download
Portable Win64 static at 16 bits-per-pixel component. Just copy to your host and run (no installer, no Windows registry entries).

@@ -422,24 +424,24 @@ display logo.gif

To verify ImageMagick is working properly, type the following in an Command Prompt window:

-+
magick logo: logo.gif
magick identify logo.gif
magick logo.gif win:
-

+

If you have any problems, you likely need vcomp120.dll. To install it, download Visual C++ 2013 Redistributable Package.

Note, use a double quote (") rather than a single quote (') for the ImageMagick command line under Windows:

-+
magick "e:/myimages/image.png" "e:/myimages/image.jpg"
-

+
Use two double quotes for VBScript scripts:
-+
Set objShell = wscript.createobject("wscript.shell")
objShell.Exec("magick ""e:/myimages/image.png"" ""e:/myimages/image.jpg""")
-

+

Congratulations, you have a working ImageMagick distribution under Windows and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

@@ -464,4 +466,4 @@ objShell.Exec("magick ""e:/myimages/image.png"" ""e:/myimages/image.jpg""")

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/escape.html b/www/escape.html
index c9ad4421c..77e745751 100644
--- a/www/escape.html
+++ b/www/escape.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

There are copious amounts of extra data associated with images (metadata), beyond the actual image pixels. This metadata can be useful, either for display, or for various calculations, or in modifying the behavior of later image processing operations. You can utilize percent escapes in a number of options, for example in -format or in montage -label, to print various properties and other settings associated with an image.

@@ -95,7 +95,7 @@

-Percent Escape Handling
+Percent Escape Handling

If you request a percent escape such as %[key] the setting
is looked for in the following order until the first match has been
@@ -126,20 +126,20 @@ insensitive manner.
free-form string tables directly, allowing you to override the above sequence,
and avoid accessing an attribute or property of the same name.

-+
%[artifact:setting]
%[option:setting]
-

+

-Single Letter Attribute Percent Escapes
+Single Letter Attribute Percent Escapes

Here are common single letter escapes (short form) is used to report the most
common attributes and properties of an image, such as: the image filename
filename, type, width, height.

-
+
@@ -333,10 +333,10 @@ filename, type, width, height.
Here is a sample command and its output for an image with filename
bird.miff and whose width is 512 and height is 480.

-+
-> identify -format "%m:%f %wx%h" bird.miff
MIFF:bird.miff 512x480
-

+
Note that all single letter percent escapes can also be used using long
form (from IM version 6.7.6-9, see next). For example %[f] is
@@ -351,13 +351,13 @@ is after a number. For example, 10%x10 does not expand the

Also be warned that calculated attributes can take some time to generate,
especially for large images.

-Long Form Attribute Percent Escapes
+Long Form Attribute Percent Escapes
In addition to the above specific and calculated attributes are recognized
when enclosed in braces (long form):

-

\n
newline

+
@@ -544,7 +544,7 @@ when enclosed in braces (long form):

%[base]
base filename, no suffixes (as %t)

-Properties
+Properties

All other long forms of percent escapes (not single letter long form) are
handled in a case insensitive manner. Such escapes will will attempt to look
@@ -572,7 +572,7 @@ href="command-line-options.html#set" >-set.
images when write, if the image file format allows.

-Artifacts and Options
+Artifacts and Options

The previous percent escapes are associated with the primary Attributes and
Properties. Which is the original and primary focus of such percent escapes.
@@ -631,56 +631,56 @@ Options, only per-image Artifacts.
Artifact.

-Glob-Pattern Listing of Properties, Artifacts and Options
+Glob-Pattern Listing of Properties, Artifacts and Options

The setting can contain a glob pattern. As such you can
now list all free-form string properties, artifacts, and options, (but not
specific image attributes) using...

-+
convert ... \
-print "__Properties__\n%[*]" \
-print "__Artifacts__\n%[artifact:*]" \
-print "__Options__\n%[option:*]" \
...
-

+

The format of glob patterns are very specific and as such is generally
only used to list specific settings, such as when debugging, rather than being
used for image processing use.

-Calculated Percent Escape Prefixes
+Calculated Percent Escape Prefixes

There are some special prefixes (before the first ':') which performs
calculations based on the user provided string that follows that prefix. For
example you can do a numerical calculation use %[fx:...] to
evaluate the given FX expressions:

-+
%[fx:expression]
-

+

Use pixel: or hex: to evaluate a pixel color as defined by the FX
expression:

-+
%[pixel:expression]
-

+

-Specific Profile Percent Escape Prefixes
+Specific Profile Percent Escape Prefixes

You can also use the following special formatting syntax to print EXIF
mage meta-data that was included in the image read in:

-+
%[EXIF:tag]
-

+

Choose tag from the following:

-+
* (print all EXIF tags, in keyword=data format)
! (print all EXIF tags, in tag_number data format)
#hhhh (print data for EXIF tag #hhhh)
@@ -766,7 +766,7 @@ ExposureIndex
SensingMethod
FileSource
SceneType
-

+

Surround the format specification with quotation marks to prevent your
shell from misinterpreting any spaces and square brackets.
@@ -774,9 +774,9 @@ shell from misinterpreting any spaces and square brackets.
The following special formatting syntax can be used to print IPTC
information contained in the file:

-+
%[IPTC:dataset:record]
-

+

Select dataset and record from the following:

@@ -866,7 +866,7 @@ ObjectData Record

Post ObjectData Descriptor Record
9:10 Confirmed ObjectData Size
-
+

Donate â¢
@@ -887,4 +887,4 @@ Post ObjectData Descriptor Record

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/examples.html b/www/examples.html
index 5cbacc6e9..6b6c86496 100644
--- a/www/examples.html
+++ b/www/examples.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Here are a few examples of what you can do with an image using ImageMagick from the command line, a program interface, or script. You can generate this image yourself with this PerlMagick script, examples.pl.

-
+

Donate â¢
@@ -80,4 +80,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/exception.html b/www/exception.html
index e6868a443..7485f68d5 100644
--- a/www/exception.html
+++ b/www/exception.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick returns a status of 0 whenever a command or algorithm successfully complete without complaint. A warning code generally is typically just a notice that something unusual occurred but the command or algorithm still completed and most likely the results are still usable. An error means the command or algorithm could not complete as expected and any results are unreliable. A fatal error means the command or algorithm could not complete and the process exits prematurely and no results are returned.

-
+
@@ -269,4 +269,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/export.html b/www/export.html
index e86b40e3c..d18e7d9ac 100644
--- a/www/export.html
+++ b/www/export.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick Studio LLC is a limited liability corporation based in the United States of America. All of our products are developed via online collaboration in public forums and distributed from a central server within the U.S. Therefore, U.S. export laws and regulations apply to our distributions and remain in force as products and technology are re-exported to different parties and places around the world. Information on export control classifications and associated restrictions may be required for exporting, re-exporting, record keeping, bundling/embedding of ImageMagick products, encryption reporting, and shipping documentation. More information on U.S. Export Regulations can be found at the U. S. Bureau of Industry and Security.

@@ -80,4 +80,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/formats.html b/www/formats.html
index 543b706f3..af83333a2 100644
--- a/www/formats.html
+++ b/www/formats.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

A Word about Colorspaces â¢ Supported Formats â¢ Pseudo Formats â¢ Built-in Images â¢ Built-in Patterns â¢ Embedded Profiles

@@ -63,13 +63,13 @@

To get a complete listing of which image formats are supported on your system, type

-+
identify -list format
-

+

On some platforms, ImageMagick automagically processes these extensions: .gz for Zip compression, .Z for Unix compression, .bz2 for block compression, and .pgp for PGP encryption. For example, a PNM image called image.pnm.gz is automagically uncompressed.

-A Word about Colorspaces
+A Word about Colorspaces
A majority of the image formats assume an sRGB
colorspace (e.g. JPEG, PNG, etc.). A few support only linear RGB (e.g. EXR,
DPX, CIN, HDR) or only linear GRAY (e.g. PGM). A few formats support CMYK.
@@ -77,19 +77,19 @@ Then there is the occasional format that also supports LAB (that is CieLAB)
(e.g. TIFF, PSD, JPG, JP2). To determine the colorspace of your image, use
this command:

-+
-> identify -verbose image.jpg
Image: image.jpg
Format: JPEG (Joint Photographic Experts Group JFIF format)
...
Colorspace: sRGB
-

+

OR use the appropriate percent escape
-+
-> convert image.jpg -print "%[colorspace]\n" null:
sRGB
-

+

When processing an image, be aware of the colorspace. Many image
@@ -98,18 +98,18 @@ satisfactory results processing in the sRGB colorspace, you may get improved
results in linear RGB (essentially sRGB with the gamma function removed). For
example,

-+
convert image.jpg -colorspace RGB -resize 50% -colorspace sRGB resize.jpg
-

+

As of IM 6.7.8-2 one can properly work in LAB colorspace whether or not
Imagemagick is HDRI-enabled. Essentually the A and
B channels are stored with a 50% gray bias, to allow it to handle the
negatives required by the format.

-+
convert lab.tif -resize 50% resize.jpg
-

+

Again, it may not make sense for some image processing operators to work
directly in LAB space, but ImageMagick permits it and generally returns
@@ -121,18 +121,18 @@ colorspace some other linear colorspace, before apply your processing
operator. Afterward you can transform back to the LAB colorspace. For
example,

-+
convert lab.tif -colorspace RGB -resize 50% -colorspace Lab resize.jpg
-

+

-Supported Image Formats
+Supported Image Formats

ImageMagick supports reading over 100 major file formats (not
including sub-formats). The following table provides a summary of
the supported image formats.

-

ImageMagick Error and Warning Codes

+
@@ -630,11 +630,11 @@ the supported image formats.
+
@@ -1213,12 +1213,12 @@ convert $ -size 15x15 canvas:black canvas:white -append $ \

Tag
RW
Magick Persistent Registry
This format permits you to write to and read images from memory. The image persists until the program exits. For example, let's use the MPR to create a checkerboard:
-+
convert $ -size 15x15 canvas:black canvas:white -append $ \
$ +clone -flip $ +append -write mpr:checkers +delete \
-size 240x240 tile:mpr:checkers board.png
-

-Pseudo-image Formats
+Pseudo-image Formats

ImageMagick supports a number of image format specifications which refer to images prepared via an algorithm, or input/output targets. The following table lists these pseudo-image formats:

-
+
@@ -1439,12 +1439,12 @@ convert $ -size 15x15 canvas:black canvas:white -append $ \

Tag
Mode

-Built-in Images
+Built-in Images

ImageMagick includes a number of built-in (embedded) images which may be referenced as if they were an image file. The magick: format tag may be used via the syntax magick:name to request an embedded image (e.g. magick:logo). For backwards compatibility, the image specifications GRANITE:, LOGO:, NETSCAPE:, and ROSE: may also be used to request images with those names.

-
+
@@ -1489,12 +1489,12 @@ convert $ -size 15x15 canvas:black canvas:white -append $ \

Tag
Mode

-Built-in Patterns
+Built-in Patterns

ImageMagick includes a number of built-in (embedded) patterns which may be referenced as if they were an image file. The pattern: format tag may be used via the syntax pattern:name to request an embedded pattern (e.g. pattern:checkerboard). The pattern size is controlled with the -size command line option.

-
+
@@ -1881,12 +1881,12 @@ convert $ -size 15x15 canvas:black canvas:white -append $ \

Tag
Mode

-Embedded Image Profiles
+Embedded Image Profiles

ImageMagick provides a number of format identifiers which are used to add, remove, and save embedded profiles for images which can support embedded profiles. Image types which may contain embedded profiles are TIFF, JPEG, and PDF.

-
+
@@ -1967,4 +1967,4 @@ convert $ -size 15x15 canvas:black canvas:white -append $ \

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/fx.html b/www/fx.html
index 8e1c465eb..0f635ff1b 100644
--- a/www/fx.html
+++ b/www/fx.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The Fx Special Effects Image Operator â¢ The Anatomy of an Fx Expression

@@ -74,9 +74,9 @@

The expression can be simple:

-+
convert -size 64x64 canvas:black -channel blue -fx "1/2" fx_navy.png
-

+

Here, we convert a black to a navy blue image:

@@ -88,11 +88,11 @@ convert -size 64x64 canvas:black -channel blue -fx "1/2" fx_navy.png

Or the expression can be complex:

-+
convert rose.jpg \
-fx "(1.0/(1.0+exp(10.0*(0.5-u)))-0.006693)*1.0092503" \
rose-sigmoidal.png'
-

+

This expression results in a high contrast version of the image:

@@ -104,11 +104,11 @@ convert rose.jpg \

The expression can include variable assignments. Assignments, in most cases, reduce the complexity of an expression and permit some operations that might not be possible any other way. For example, lets create a radial gradient:

-+
convert -size 70x70 canvas: \
-fx "Xi=i-w/2; Yj=j-h/2; 1.2*(0.5-hypot(Xi,Yj)/70.0)+0.5"
radial-gradient.png'
-

+

The command above returns this image:

@@ -118,45 +118,45 @@ convert -size 70x70 canvas: \

This FX expression adds random noise to an image:

-+
convert photo.jpg -fx \'iso=32; rone=rand(); rtwo=rand(); \
myn=sqrt(-2*ln(rone))*cos(2*Pi*rtwo); myntwo=sqrt(-2*ln(rtwo))* \
cos(2*Pi*rone); pnoise=sqrt(p)*myn*sqrt(iso)* \
channel(4.28,3.86,6.68,0)/255; max(0,p+pnoise)\' noisy.png
-

+

See Using FX, The Special Effects Image Operator for more examples.

The next section discusses the Fx expression language.

-The Anatomy of an Fx Expression
+The Anatomy of an Fx Expression

The Fx Expression Language

The formal Fx expression language is defined here:

-
- numbers:
- integer, floating point, scientific notation (+/- required, e.g. 3.81469e-06), International System number postfixes (.e.g KB, Mib, GB, etc.)
- constants:
- E (Euler's number), Epsilon, QuantumRange, QuantumScale, Opaque, Phi (golden ratio), Pi, Transparent
- Fx operators (in order of precedence):
- ^ (power), unary -, *, /, % (modulo), +, -,
+
+ numbers:
+ integer, floating point, scientific notation (+/- required, e.g. 3.81469e-06), International System number postfixes (.e.g KB, Mib, GB, etc.)
+ constants:
+ E (Euler's number), Epsilon, QuantumRange, QuantumScale, Opaque, Phi (golden ratio), Pi, Transparent
+ Fx operators (in order of precedence):
+ ^ (power), unary -, *, /, % (modulo), +, -,
<<, >>, <, <=, >, >=, ==, !=,
& (bitwise AND), | (bitwise OR),
&& (logical AND), || (logical OR),
~ (logical NOT), ?: (ternary conditional)
- math functions:
- abs(), acos(), acosh(), airy(), alt(), asin(), asinh(), atan(), atanh(), atan2(), ceil(), clamp(), cos(), cosh(), debug(), drc(), erf(), exp(), floor(), gauss(), gcd(), hypot(), int(), isnan(), j0(), j1(), jinc(), ln(), log(), logtwo(), max(), min(), mod(), not(), pow(), rand(), round(), sign(), sin(), sinc(), sinh(), sqrt(), squish(), tan(), tanh(), trunc()
- channel functions:
- channel(r,g,b,a), channel(c,m,y,k,a)
- color names:
- red, cyan, black, etc.
- color functions:
- srgb(), srgba(), rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla(), etc.
- color hex values:
- #ccc, #cbfed0, #b9e1cc00, etc.
- symbols:

+ math functions:
+ abs(), acos(), acosh(), airy(), alt(), asin(), asinh(), atan(), atanh(), atan2(), ceil(), clamp(), cos(), cosh(), debug(), drc(), erf(), exp(), floor(), gauss(), gcd(), hypot(), int(), isnan(), j0(), j1(), jinc(), ln(), log(), logtwo(), max(), min(), mod(), not(), pow(), rand(), round(), sign(), sin(), sinc(), sinh(), sqrt(), squish(), tan(), tanh(), trunc()
+ channel functions:
+ channel(r,g,b,a), channel(c,m,y,k,a)
+ color names:
+ red, cyan, black, etc.
+ color functions:
+ srgb(), srgba(), rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla(), etc.
+ color hex values:
+ #ccc, #cbfed0, #b9e1cc00, etc.
+ symbols:

u=> first image in list
v=> second image in list
s=> current image in list (for %[fx:] otherwise = u)
@@ -172,15 +172,15 @@ convert photo.jpg -fx \'iso=32; rone=rand(); rtwo=rand(); \
z=> channel depth

r=> red value (from RGBA), of a specific or current pixel
- g=> green ''
- b=> blue ''
- a=> alpha ''
- o=> opacity ''
+ g=> green
+ b=> blue
+ a=> alpha
+ o=> opacity

c=> cyan value of CMYK color of pixel
- y=> yellow ''
- m=> magenta ''
- k=> black ''
+ y=> yellow
+ m=> magenta
+ k=> black

intensity=> pixel intensity

@@ -204,104 +204,104 @@ convert photo.jpg -fx \'iso=32; rone=rand(); rtwo=rand(); \
standard_deviation=> image standard deviation
kurtosis=> image kurtosis
skewness=> image skewness (add a channel specifier to compute a statistic for that channel, e.g. depth.r)
- iterators:
- while()
+ iterators:
+ while()

The Fx Expression

An Fx expression may include any combination of the following:
-
- x ^ y
exponentiation (x^y)
- ( ... )
grouping
- x * y
multiplication (the asterisk * is optional, for example, 2u or 2(x+y) are acceptable)
- x / y
division
- x % y
modulo
- x + y
addition
- x - y
subtraction
- x << y
left shift
- x >> y
right shift
- x < y
boolean relation, return value 1.0 if x < y, otherwise 0.0
- x <= y
boolean relation, return value 1.0 if x <= y, otherwise 0.0
- x > y
boolean relation, return value 1.0 if x > y, otherwise 0.0
- x >= y
boolean relation, return value 1.0 if x >= y, otherwise 0.0
- x == y
boolean relation, return value 1.0 if x == y, otherwise 0.0
- x != y
boolean relation, return value 1.0 if x != y, otherwise 0.0
- x & y
binary AND
- x | y
binary OR
- x && y
logical AND connective, return value 1.0 if x > 0 and y > 0, otherwise 0.0
- x || y
logical OR connective (inclusive), return value 1.0 if x > 0 or y > 0 (or both), otherwise 0.0
- ~x
logical NOT operator, return value 1.0 if not x > 0, otherwise 0.0
- +x
unary plus, return 1.0*value
- -x
unary minus, return -1.0*value
- x ? y
z: ternary conditional expression, return value y if x != 0, otherwise z; only one ternary conditional permitted per statement
- x = y
assignment; assignment variables are restricted to letter combinations only (e.g. Xi not X1)
- x ; y
statement separator
- phi
constant (1.618034...)
- pi
constant (3.14159265359...)
- e
constant (2.71828...)
- QuantumRange
constant maximum pixel value (255 for Q8, 65535 for Q16)
- QuantumScale
constant 1.0/QuantumRange
- intensity
pixel intensity; equivalent to 0.299*red+0.587*green+0.114*blue
- hue
pixel hue
- saturation
pixel saturation
- lightness
pixel lightness; equivalent to 0.5*max(red,green,blue) + 0.5*min(red,green,blue)
- luminance
pixel luminance; equivalent to 0.212656*red + 0.715158*green + 0.072186*blue
- red, green, blue, etc.
color names
- #ccc, #cbfed0, #b9e1cc00, etc.
color hex values
- rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla()
color functions
- s, t, u, v, n, i, j, w, h, z, r, g, b, a, o, c, y, m, k
symbols
- abs(x)
absolute value function
- acos(x)
arc cosine function
- acosh(x)
inverse hyperbolic cosine function
- airy(x)
Airy function (max=1, min=0); airy(x)=[jinc(x)]²=[2*j1(pi*x)/(pi*x)]²
- alt(x)
sign alternation function (return 1.0 if int(x) is even, -1.0 if int(x) is odd)
- asin(x)
arc sine function
- asinh(x)
inverse hyperbolic sine function
- atan(x)
arc tangent function
- atanh(x)
inverse hyperbolic tangent function
- atan2(x,y)
arc tangent function of two variables
- ceil(x)
smallest integral value not less than argument
- channel(r,g,b,a)
select numeric argument based on current channel
- channel(c,m,y,k,a)
select numeric argument based on current channel
- clamp(x)
clamp value
- cos(x)
cosine function
- cosh(x)
hyperbolic cosine function
- debug(x)
print x (useful for debugging your expression)
- drc(x,y)
dynamic range compression (knee curve); drc(x,y)=(x)/(y*(x-1)+1); -1<y<1
- erf(x)
error function
- exp(x)
natural exponential function (e^x)
- floor(x)
largest integral value not greater than argument
- gauss(x)
gaussian function; gauss(x)=exp(-x*x/2)/sqrt(2*pi)
- gcd(x,y)
greatest common denominator
- hypot(x,y)
the square root of x²+y²
- int(x)
greatest integer function (return greatest integer less than or equal to x)
- isnan(x)
return 1.0 if x is NAN, 0.0 otherwise
- j0(x)
Bessel functions of x of the first kind of order 0
- j1(x)
Bessel functions of x of the first kind of order 1
- jinc(x)
jinc function (max=1, min=-0.1323); jinc(x)=2*j1(pi*x)/(pi**x)
- ln(x)
natural logarithm function
- log(x)
logarithm base 10
- logtwo(x)
logarithm base 2
- ln(x)
natural logarithm
- max(x, y)
maximum of x and y
- min(x, y)
minimum of x and y
- mod(x, y)
floating-point remainder function
- not(x)
return 1.0 if x is zero, 0.0 otherwise
- pow(x,y)
power function (x^y)
- rand()
value uniformly distributed over the interval [0.0, 1.0) with a 2 to the 128th-1 period
- round()
round to integral value, regardless of rounding direction
- sign(x)
return -1.0 if x is less than 0.0 otherwise 1.0
- sin(x)
sine function
- sinc(x)
sinc function (max=1, min=-0.21); sinc(x)=sin(pi*x)/(pi*x)
- squish(x)
squish function; squish(x)=1.0/(1.0+exp(-x))
- sinh(x)
hyperbolic sine function
- sqrt(x)
square root function
- tan(x)
tangent function
- tanh(x)
hyperbolic tangent function
- trunc(x)
round to integer, towards zero
- while(condition,expression)
iterate while the condition is not equal to 0
+
+ x ^ y
exponentiation (x^y)
+ ( ... )
grouping
+ x * y
multiplication (the asterisk * is optional, for example, 2u or 2(x+y) are acceptable)
+ x / y
division
+ x % y
modulo
+ x + y
addition
+ x - y
subtraction
+ x << y
left shift
+ x >> y
right shift
+ x < y
boolean relation, return value 1.0 if x < y, otherwise 0.0
+ x <= y
boolean relation, return value 1.0 if x <= y, otherwise 0.0
+ x > y
boolean relation, return value 1.0 if x > y, otherwise 0.0
+ x >= y
boolean relation, return value 1.0 if x >= y, otherwise 0.0
+ x == y
boolean relation, return value 1.0 if x == y, otherwise 0.0
+ x != y
boolean relation, return value 1.0 if x != y, otherwise 0.0
+ x & y
binary AND
+ x | y
binary OR
+ x && y
logical AND connective, return value 1.0 if x > 0 and y > 0, otherwise 0.0
+ x || y
logical OR connective (inclusive), return value 1.0 if x > 0 or y > 0 (or both), otherwise 0.0
+ ~x
logical NOT operator, return value 1.0 if not x > 0, otherwise 0.0
+ +x
unary plus, return 1.0*value
+ -x
unary minus, return -1.0*value
+ x ? y : z
ternary conditional expression, return value y if x != 0, otherwise z; only one ternary conditional permitted per statement
+ x = y
assignment; assignment variables are restricted to letter combinations only (e.g. Xi not X1)
+ x ; y
statement separator
+ phi
constant (1.618034...)
+ pi
constant (3.14159265359...)
+ e
constant (2.71828...)
+ QuantumRange
constant maximum pixel value (255 for Q8, 65535 for Q16)
+ QuantumScale
constant 1.0/QuantumRange
+ intensity
pixel intensity whose value respects the -intensity option.
+ hue
pixel hue
+ saturation
pixel saturation
+ lightness
pixel lightness; equivalent to 0.5*max(red,green,blue) + 0.5*min(red,green,blue)
+ luminance
pixel luminance; equivalent to 0.212656*red + 0.715158*green + 0.072186*blue
+ red, green, blue, etc.
color names
+ #ccc, #cbfed0, #b9e1cc00, etc.
color hex values
+ rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla()
color functions
+ s, t, u, v, n, i, j, w, h, z, r, g, b, a, o, c, y, m, k
symbols
+ abs(x)
absolute value function
+ acos(x)
arc cosine function
+ acosh(x)
inverse hyperbolic cosine function
+ airy(x)
Airy function (max=1, min=0); airy(x)=[jinc(x)]²=[2*j1(pi*x)/(pi*x)]²
+ alt(x)
sign alternation function (return 1.0 if int(x) is even, -1.0 if int(x) is odd)
+ asin(x)
arc sine function
+ asinh(x)
inverse hyperbolic sine function
+ atan(x)
arc tangent function
+ atanh(x)
inverse hyperbolic tangent function
+ atan2(x,y)
arc tangent function of two variables
+ ceil(x)
smallest integral value not less than argument
+ channel(r,g,b,a)
select numeric argument based on current channel
+ channel(c,m,y,k,a)
select numeric argument based on current channel
+ clamp(x)
clamp value
+ cos(x)
cosine function
+ cosh(x)
hyperbolic cosine function
+ debug(x)
print x (useful for debugging your expression)
+ drc(x,y)
dynamic range compression (knee curve); drc(x,y)=(x)/(y*(x-1)+1); -1<y<1
+ erf(x)
error function
+ exp(x)
natural exponential function (e^x)
+ floor(x)
largest integral value not greater than argument
+ gauss(x)
gaussian function; gauss(x)=exp(-x*x/2)/sqrt(2*pi)
+ gcd(x,y)
greatest common denominator
+ hypot(x,y)
the square root of x²+y²
+ int(x)
greatest integer function (return greatest integer less than or equal to x)
+ isnan(x)
return 1.0 if x is NAN, 0.0 otherwise
+ j0(x)
Bessel functions of x of the first kind of order 0
+ j1(x)
Bessel functions of x of the first kind of order 1
+ jinc(x)
jinc function (max=1, min=-0.1323); jinc(x)=2*j1(pi*x)/(pi**x)
+ ln(x)
natural logarithm function
+ log(x)
logarithm base 10
+ logtwo(x)
logarithm base 2
+ ln(x)
natural logarithm
+ max(x, y)
maximum of x and y
+ min(x, y)
minimum of x and y
+ mod(x, y)
floating-point remainder function
+ not(x)
return 1.0 if x is zero, 0.0 otherwise
+ pow(x,y)
power function (x^y)
+ rand()
value uniformly distributed over the interval [0.0, 1.0) with a 2 to the 128th-1 period
+ round()
round to integral value, regardless of rounding direction
+ sign(x)
return -1.0 if x is less than 0.0 otherwise 1.0
+ sin(x)
sine function
+ sinc(x)
sinc function (max=1, min=-0.21); sinc(x)=sin(pi*x)/(pi*x)
+ squish(x)
squish function; squish(x)=1.0/(1.0+exp(-x))
+ sinh(x)
hyperbolic sine function
+ sqrt(x)
square root function
+ tan(x)
tangent function
+ tanh(x)
hyperbolic tangent function
+ trunc(x)
round to integer, towards zero
+ while(condition,expression)
iterate while the condition is not equal to 0

The expression semantics include these rules:
@@ -324,17 +324,17 @@ convert photo.jpg -fx \'iso=32; rone=rand(); rtwo=rand(); \

As an example, we form an image by averaging the first image and third images (the second (index 1) image is ignored and just junked):

-+
convert image1.jpg image2.jpg image3.jpg -fx "(u+u[2])/2.0" image.jpg
-

+

By default, the image to which p, r, g, b, a, etc., are applied is the current image s in the image list. This is equivalent to u except when used in an escape sequence %[fx:...].

It is important to note the special role played by the first image. This is the only image in the image sequence that is modified, other images are used only for their data. As an illustrative example, consider the following, and note that the setting -channel red instructs -fx to modify only the red channel; nothing in the green or blue channels will change. It is instructive to ponder why the result is not symmetric.

-+
convert -channel red logo: -flop logo: -resize "20%" -fx "(u+v)/2" image.jpg
-

+

@@ -350,17 +350,17 @@ convert -channel red logo: -flop logo: -resize "20%" -fx "(u+v)/2" image.jpg

The pixels are processed one at a time, but a different pixel of an image can be specified using a pixel index represented by p. For example,

-+
p[-1].g green value of pixel to the immediate left of the current pixel
p[-1,-1].r red value of the pixel diagonally left and up from current pixel
-

+

To specify an absolute position, use braces, rather than brackets.

-+
p{0,0}.r red value of the pixel in the upper left corner of the image
p{12,34}.b blue pixel value at column number 12, row 34 of the image
-

+

Integer values of the position retrieve the color of the pixel referenced, while non-integer position values return a blended color according to the current -interpolate setting.

@@ -370,9 +370,9 @@ p{12,34}.b blue pixel value at column number 12, row 34 of the image

Use the -channel setting to specify the output channel of the result. If no output channel is given, the result is set over all channels except the opacity channel. For example, to replace the red channel of alpha.png with the average of the green channels from the images alpha.png and beta.png, use:

-+
convert alpha.png beta.png -channel red -fx "(u.g+v.g)/2" gamma.png
-

+

Results
@@ -384,19 +384,19 @@ convert alpha.png beta.png -channel red -fx "(u.g+v.g)/2" gamma.png

For use with -format, the value-escape %[fx:] is evaluated just once for each image in the current image sequence. As each image in the sequence is being evaluated, s and t successively refer to the current image and its index, while i and j are set to zero, and the current channel set to red (-channel is ignored). An example:

-+
convert canvas:'rgb(25%,50%,75%)' rose: -colorspace rgb \
-format 'Red channel of NW corner of image #%[fx:t] is %[fx:s]' info:
Red channel of NW corner of image #0 is 0.453758
Red channel of NW corner of image #1 is 0.184588
-

+

Here we use the image indexes to rotate each image differently, and use -set with the image index to set a different pause delay on the first image in the animation:

-+
convert rose: -duplicate 29 -virtual-pixel Gray -distort SRT '%[fx:360.0*t/n]' \
-set delay '%[fx:t == 0 ? 240 : 10]' -loop 0 rose.gif"
-

+

The color-escape %[pixel:] or %[hex:] is evaluated once per image and per color channel in that image (-channel is ignored), The values generated are then converted into a color string (a named color or hex color value). The symbols i and j are set to zero, and s and t refer to each successively current image and index.

@@ -420,4 +420,4 @@ convert rose: -duplicate 29 -virtual-pixel Gray -distort SRT '%[fx:360.0*t/n]' \

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/gradient.html b/www/gradient.html
index 43952cd93..c13afb5e7 100644
--- a/www/gradient.html
+++ b/www/gradient.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

An image gradient creates a gradual blend between two colors formed into a shape that is linear, circular, or ellipical.

For a linear gradient, the operator is either:

-+
gradient:
gradient:color1-color2
-

+

The for a radial gradient, the operator is either:

-+
radial-gradient:
radial-gradient:color1-color2
-

+

In the above, color1 is the fromColor and color2 is the toColor, as described in more detail below. The default is white for color1 and black for color2, i.e., white-black.

@@ -82,23 +82,23 @@ radial-gradient:color1-color2

Here is an example linear gradient:

-+
convert -size 256x256 gradient: linear_gradient.png
convert -size 256x256 gradient:white-black linear_gradient.png
-

+

If you want a radial gradient, try:

-+
convert -size 256x256 radial-gradient: radial_gradient.png
convert -size 256x256 radial-gradient:white-black radial_gradient.png
-

+

As of IM 6.9.2.5, gradients have been enhanced through the use of several -defines.

-

Tag

+

-define gradient:vector=x1,y1, x2,y2
Specifies the direction of the linear gradient going from vector1
@@ -141,7 +141,7 @@ convert -size 256x256 radial-gradient:white-black radial_gradient.png

We also support two convenience defines for setting the linear gradient direction and the radial gradient shape.

-
+

-define gradient:direction={NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast}
Specifies the direction of the linear gradient towards the
@@ -168,56 +168,56 @@ convert -size 256x256 radial-gradient:white-black radial_gradient.png

The default linear gradient may also be generated in any of the following ways (or by reversing the direction and swapping color1 and color2):

-+
convert -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png
convert -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png
-

+

The equivalent of

-+
convert -size 128x256 gradient: -rotate 90 linear_gradient_east.png
-

+

can be generate by either of the following (or by reversing the direction and swapping color1 and color2):

-+
convert -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png
convert -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png
-

+

Examples of radial gradients going from black in the center to white at the boundary for the cases of "maximum/circle/default", "minimum", "diagonal", "ellipse" and 45 degree rotated ellipse, respectively, follow below.

-+
convert -size 256x128 radial-gradient:black-white radial_gradient_maximum.png
convert -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png
-

+

-+
convert -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png
convert -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png
-

+

-+
convert -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png
-

+

-+
convert -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png
convert -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png
-

+

-+
convert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png
-

+

@@ -241,4 +241,4 @@ convert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 ra

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/high-dynamic-range.html b/www/high-dynamic-range.html
index 5f2eb4dd5..9dbf682a2 100644
--- a/www/high-dynamic-range.html
+++ b/www/high-dynamic-range.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

High dynamic-range imaging (HDRI) permits a far greater dynamic range of exposures (i.e. a large difference between light and dark areas) than standard digital imaging techniques. HDRI accurately represents the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows. The HDR imaging approach includes:
@@ -67,7 +67,7 @@
apply tone-mapping for specific display

-Enabling HDRI in ImageMagick
+Enabling HDRI in ImageMagick

By default, image pixels in ImageMagick version 7 are stored in a floating-point representation that range from 0 to the quantum depth, which is typically 16-bits (Q16). With HDRI enabled, the pixels can include negative values as well as values that exceed the quantum depth. A majority of digital image formats do not support HDRI, and for those images any pixels outside the quantum range are clamped before they are stored.

@@ -75,18 +75,18 @@

To disable the HDRI version of ImageMagick, use this Unix/Linux command:

-+
./configure --disable-hdri
-

+

Under Windows, uncomment the MAGICKCORE_HDRI_SUPPORT definition in the magick-baseconfig.h configuration file and build.

To verify HDRI is properly configured, look for "HDRI" as a feature:

-+
identify -version
Features: HDRI
-

+

Donate â¢
@@ -107,4 +107,4 @@ Features: HDRI

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/history.html b/www/history.html
index 373ed8705..aec4442f2 100644
--- a/www/history.html
+++ b/www/history.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

-
-I swear by my life and my love of it that I will never live for the sake of another man, nor ask another man to live for mine.
-- John Galt in "Atlas Shrugged", by Ayn Rand
+
+I swear by my life and my love of it that I will never live for the sake of another man, nor ask another man to live for mine.
-- John Galt in "Atlas Shrugged", by Ayn Rand

ImageMagick started with a request from my DuPont supervisor, Dr. David Pensak, to display computer-generated images on a monitor only capable of showing 256 unique colors simultaneously.

@@ -97,4 +97,4 @@ I swear by my life and my love of it that I will never live for the sake of anot

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/identify.html b/www/identify.html
index 032fb4c8d..9a186271c 100644
--- a/www/identify.html
+++ b/www/identify.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

The identify program describes the format and characteristics of one or more image files. It also reports if an image is incomplete or corrupt. The information returned includes the image number, the file name, the width and height of the image, whether the image is colormapped or not, the number of colors in the image, the number of bytes in the image, the format of the image (JPEG, PNM, etc.), and finally the number of seconds it took to read and process the image. Many more attributes are available with the verbose option. See Command Line Processing for advice on how to structure your identify command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the identify command here to illustrate its usefulness and ease of use. To get started, lets identify an image in the JPEG format:

-+
-> magick identify rose.jpg
rose.jpg JPEG 70x46 70x46+0+0 8-bit sRGB 2.36KB 0.000u 0:00.000
-

+

Next, we look at the same image in greater detail:

--> magick identify -verbose rose.jpg
+-> magick identify -verbose rose.jpg
Image: rose.jpg
Format: JPEG (Joint Photographic Experts Group JFIF format)
Mime type: images/jpeg
@@ -154,41 +154,41 @@ Image: rose.jpg
User time: 0.000u
Elapsed time: 0:01.000
Version: ImageMagick 7.0.4-8 Q16 x86_64 http://www.imagemagick.org
-

+

To get the print size in inches of an image at 72 DPI, use:

-+
-> magick identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png
8.5 x 11 inches
-

+

The depth and dimensions of a raw image must be specified on the command line:

-+
-> magick identify -depth 8 -size 640x480 image.raw
image.raw RGB 640x480 sRGB 9kb 0.000u 0:01
-

+

Here we display the image texture features, moments, perceptual hash, and the number of unique colors in the image:

-+
-> magick identify -verbose -features 1 -moments -unique image.png
-

+

Here is a special define that outputs the location of the minimum or maximum pixel of the image:

-+
magick identify -precision 5 -define identify:locate=maximum -define identify:limit=3 image.png
-

+

You can find additional examples of using identify in Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The identify command recognizes these options. Click on an option to get more details about how that option works.

-
+
@@ -429,4 +429,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/import.html b/www/import.html
index c9e5cd775..5992e7af8 100644
--- a/www/import.html
+++ b/www/import.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the import program to capture some or all of an X server screen and save the image to a file. See Command Line Processing for advice on how to structure your import command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the import command here to illustrate its usefulness and ease of use. To get started, lets import an image in the JPEG format:

-+
magick import rose.jpg
-

+

To capture the entire X server screen in the Postscript image format:

-+
magick import -window root screen.ps
-

+

You can find additional examples of using import in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The import command recognizes these options. Click on an option to get more details about how that option works.

-

Option

+
@@ -427,4 +427,4 @@ magick import -window root screen.ps

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/index.html b/www/index.html
index 614462d8c..e9f16e7ef 100644
--- a/www/index.html
+++ b/www/index.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Features and Capabilities â¢ News â¢ Community

-
+

Use ImageMagick^® to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and BÃ©zier curves.

The functionality of ImageMagick is typically utilized from the command-line or you can use the features from programs written in your favorite language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), JuliaIO (Julia), L-Magick (Lisp), Lua (LuaJIT), NMagick (Neko/haXe), Magick.NET (.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.
@@ -68,16 +68,16 @@ Use ImageMagick^{ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to help prevent security vulnerabilities.

-The current release is ImageMagick 7.0.5-10. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.
+The current release is ImageMagick 7.0.6-0. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.

The authoritative ImageMagick web site is https://www.imagemagick.org. The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick. We maintain a source code mirror at GitLab and GitHub.

We continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org.

-Features and Capabilities
+Features and Capabilities
Here are just a few examples of what ImageMagick can do for you:

-}

Option

+
@@ -209,15 +209,15 @@ Use ImageMagick^{Examples of ImageMagick Usage shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With Magick.NET, use ImageMagick without having to install ImageMagick on your server or desktop.
+Examples of ImageMagick Usage shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With Magick.NET, use ImageMagick without having to install ImageMagick on your server or desktop.

-News
+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.

-Community
+Community
To join the ImageMagick community, try the discourse server. You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions. If you want to contribute image processing algorithms, other enhancements, or bug fixes, open an issue.

@@ -239,4 +239,4 @@ Use ImageMagick^{-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Install from Unix Source â¢ Install from Windows Source

Chances are, ImageMagick is already installed on your computer if you are using some flavor of Unix, and its likely not installed if you are using some form of Windows. In either case, you can type the following to find out:

-+
identify -version
-

+

If the identify program executes and identifies itself as ImageMagick, you may not need to install ImageMagick from source unless you want to add support for additional image formats or upgrade to a newer version. You also have the option of installing a pre-compiled binary release. However, if you still want to install from source, choose a platform, Unix or Windows. Before installing from source, you may want to review recent changes to the ImageMagick distribution.

The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick. We maintain a source code mirror at GitHub. We test and deploy ImageMagick with Travis CI and AppVeyor.

-Install from Unix Source
+Install from Unix Source

ImageMagick builds on a variety of Unix and Unix-like operating systems including Linux, Solaris, FreeBSD, Mac OS X, and others. A compiler is required and fortunately almost all modern Unix systems have one. Download ImageMagick.tar.gz from www.imagemagick.org or a mirrors and verify its message digest.

Unpack the distribution with this command:

-+
tar xvzf ImageMagick.tar.gz
-

+

Next configure and compile ImageMagick:

- cd ImageMagick-7.0.5
./configure
make
+ cd ImageMagick-7.0.6
./configure
make
If ImageMagick configured and compiled without complaint, you are ready to install it on your system. Administrator privileges are required to install. To install, type

-+
sudo make install
-

+

You may need to configure the dynamic linker run-time bindings:

-+
sudo ldconfig /usr/local/lib
-

+

Finally, verify the ImageMagick install worked properly, type

-+
/usr/local/bin/convert logo: logo.gif
-

+

For a more comprehensive test, run the ImageMagick validation suite. Ghostscript is a prerequisite, otherwise the EPS, PS, and PDF tests will fail.

-+
make check
-

+

Congratulations, you have a working ImageMagick distribution and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you don't have administrator privileges and what if you don't want to install ImageMagick in the default /../usr/local folder? You will find the answer to these questions, and more, in Advanced Unix Source Installation.

-Install from Windows Source
+Install from Windows Source

Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

@@ -118,29 +118,29 @@ make check

You can unpack the distribution with WinZip or type the following from any MS-DOS Command Prompt window:

-+
unzip ImageMagick-windows.zip
-

+

-Next, launch your Visual Studio IDE and choose Open->Project. Select the configure workspace from the ImageMagick-7.0.5/VisualMagick/configure folder and press Open. Choose Build->Build Solution
+
Next, launch your Visual Studio IDE and choose Open->Project. Select the configure workspace from the ImageMagick-7.0.6/VisualMagick/configure folder and press Open. Choose Build->Build Solution
to compile the program and on completion run the program.

-
+

-Press Next and click on the multi-threaded static build. If you are using the Visual Studio 6.0 IDE, make sure no check is next to the Generate Visual Studio 7 format option. Now press, on Next twice and finally Finish. The configuration utility just created a workspace required to build ImageMagick from source. Choose Open->Project and select the VisualStaticMT workspace from the ImageMagick-7.0.5/VisualMagick/ folder. Finally, choose Build->Build Solution to compile and build the ImageMagick distribution.
+Press Next and click on the multi-threaded static build. If you are using the Visual Studio 6.0 IDE, make sure no check is next to the Generate Visual Studio 7 format option. Now press, on Next twice and finally Finish. The configuration utility just created a workspace required to build ImageMagick from source. Choose Open->Project and select the VisualStaticMT workspace from the ImageMagick-7.0.6/VisualMagick/ folder. Finally, choose Build->Build Solution to compile and build the ImageMagick distribution.

To verify ImageMagick is working properly, launch a MS-DOS Command Prompt window and type

- cd ImageMagick-7.0.5
convert logo: image.jpg
+ cd ImageMagick-7.0.6
convert logo: image.jpg
For a more comprehensive test, run the ImageMagick validation suite:

-+
validate
-

+

Congratulations, you have a working ImageMagick distribution under Windows and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

-The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you want to install ImageMagick in a place other than the ImageMagick-7.0.5/VisualMagick/bin folder? Or perhaps you want to build and install the ImageMagickObject COM+ component. You will find the answer to these questions, and more, in Advanced Windows Source Installation.
+The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you want to install ImageMagick in a place other than the ImageMagick-7.0.6/VisualMagick/bin folder? Or perhaps you want to build and install the ImageMagickObject COM+ component. You will find the answer to these questions, and more, in Advanced Windows Source Installation.

@@ -162,4 +162,4 @@ validate

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/jp2.html b/www/jp2.html
index 31ed7339c..cf7bb438f 100644
--- a/www/jp2.html
+++ b/www/jp2.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick's JPEG-2000 image formats, JP2 and JPC, accept a plethora of encoding options as detailed below. As an example, suppose you are interested in these options:
@@ -69,50 +69,50 @@

Use this command to convert a JPEG-2000 image to the PNG image format:

-+
convert wizard.jp2 wizard.png
-

+

Let's convert a JPEG image to a lossless JPEG-2000 image:

-+
convert wizard.jpg -quality 0 wizard.jp2
-

+

Here we extract an area from the image:

-+
convert 'wizard.jp2[640x480+0+0]' wizard.png
-

+

Extract a particular tile from the image:

-+
convert 'wizard.jp2[2]' wizard.png
-

+

Specify a subsampling factor:

-+
convert wizard.png -colorspace YUV -sampling-factor 2,2 wizard.jp2
-

+

Save a tiled JPEG-2000 image:

-+
convert wizard.png 'wizard.png[512x512]'
-

+

Write a digital Cinema 4K profile compliant codestream:

-+
convert wizard.png -resize 4096x2160! -depth 12 wizard.jp2
-

+

Here is a complete list of JPEG-2000 decoding options:

-}}

Animation
create a GIF animation sequence from a group of images.
+
@@ -126,7 +126,7 @@ convert wizard.png -resize 4096x2160! -depth 12 wizard.jp2
Here is a complete list of JPEG-2000 encoding options:

-

jp2:quality-layers=x
set the maximum number of quality layers to decode.

+
@@ -164,4 +164,4 @@ convert wizard.png -resize 4096x2160! -depth 12 wizard.jp2

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/license.html b/www/license.html
index 3cf1c8d3c..754f24e27 100644
--- a/www/license.html
+++ b/www/license.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Terms and Conditions for Use, Reproduction, and Distribution â¢ How to Apply the License to your Work

@@ -106,7 +106,7 @@

-Terms and Conditions for Use, Reproduction, and Distribution
+Terms and Conditions for Use, Reproduction, and Distribution

The legally binding and authoritative terms and conditions for use, reproduction, and distribution of ImageMagick follow:

@@ -163,11 +163,11 @@
9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

-How to Apply the License to your Work
+How to Apply the License to your Work

To apply the ImageMagick License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information (don't include the brackets). The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

-+
Copyright [yyyy] [name of copyright owner]

Licensed under the ImageMagick License (the "License"); you may not use
@@ -181,7 +181,7 @@
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
-

+

@@ -203,4 +203,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/links.html b/www/links.html
index bdea97fd3..4d9b0e667 100644
--- a/www/links.html
+++ b/www/links.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Use ImageMagick on the Web â¢ Command-line Tutorials â¢ Program Interface Tutorials â¢ ImageMagick Techniques â¢ Installation Tutorials â¢ ImageMagick Topics â¢ ImageMagick Book Review â¢ Web Site Mirrors â¢ Image Bank â¢ Other Projects

Listed here are a number of external web sites that are related to ImageMagick. ImageMagick Studio does not maintain or endorse these sites, excepting the Wizard's Toolkit site, but we feel they are a helpfull adjunct to this web site.

-Use ImageMagick on the Web
+Use ImageMagick on the Web

- JqMagick
- Magick Studio
+ JqMagick
+ Magick Studio

-Command-line Tutorials
+Command-line Tutorials

- Examples of ImageMagick Usage
- Efficient Image Resizing With ImageMagick
- ImageMagick, Part One
- ImageMagick, Part Two
- More Graphics from the Command Line
+ Examples of ImageMagick Usage
+ Efficient Image Resizing With ImageMagick
+ ImageMagick, Part One
+ ImageMagick, Part Two
+ More Graphics from the Command Line

-Program Interface Tutorials
+Program Interface Tutorials

- Create Mosaic Images with Perl and ImageMagick
- Create Dynamic Images with ImageMagick
- How to compile ImageMagick for PHP by hand
- MagickWand Examples in C
- PHP Extensions: MagickWand for PHP
- PHP ImageMagick MagickWand Examples
- RVG - Ruby Vector Graphics
- Security Images with PHP and ImageMagick
- Basic Uses of ImageMagick With PHP
+ Create Mosaic Images with Perl and ImageMagick
+ Create Dynamic Images with ImageMagick
+ How to compile ImageMagick for PHP by hand
+ MagickWand Examples in C
+ PHP Extensions: MagickWand for PHP
+ PHP ImageMagick MagickWand Examples
+ RVG - Ruby Vector Graphics
+ Security Images with PHP and ImageMagick
+ Basic Uses of ImageMagick With PHP

-Installation Tutorials
+Installation Tutorials

- ImageMagick Installer for Mac OS X
- ImageMagick on iPhone
- Scripts and Instructions to Compile ImageMagick as a iOS Static Library
- Installing ImageMagick from Source on Ubuntu
+ ImageMagick Installer for Mac OS X
+ ImageMagick on iPhone
+ Scripts and Instructions to Compile ImageMagick as a iOS Static Library
+ Installing ImageMagick from Source on Ubuntu

-ImageMagick Techniques
+ImageMagick Techniques

- Accelerated Template Matching Using Local Statistics And Fourier Transforms
- Digital Image Filtering
+ Accelerated Template Matching Using Local Statistics And Fourier Transforms
+ Digital Image Filtering

-ImageMagick Topics
+ImageMagick Topics

- FreeBSD port
- Free Software Foundation
- Hyperscale Image Resizing
- NetBSD
- SourceForge
- WikiPedia
+ FreeBSD port
+ Free Software Foundation
+ Hyperscale Image Resizing
+ NetBSD
+ SourceForge
+ WikiPedia

-ImageMagick Book Review
+ImageMagick Book Review

- Book review: ImageMagick Tricks
- The Definitive Guide To ImageMagick
+ Book review: ImageMagick Tricks
+ The Definitive Guide To ImageMagick

-ImageMagick Web Site Mirrors
+ImageMagick Web Site Mirrors

- Denmark
- http://imagemagick.europnews.de
- United States
- https://www.imagemagick.org
+ Denmark
+ http://imagemagick.europnews.de
+ United States
+ https://www.imagemagick.org

-Image Bank
+Image Bank

- Image Bank: a small digital test image bank
+ Image Bank: a small digital test image bank

-Other Projects
+Other Projects

- ImageMagick API on the Android Platform
- ImageMagick API on the iOS / iPhone Platform
- Wizard's Toolkit
- Computational Simulation of Multi-Body Interactions with O(n) Scaling
+ ImageMagick API on the Android Platform
+ ImageMagick API on the iOS / iPhone Platform
+ Wizard's Toolkit
+ Computational Simulation of Multi-Body Interactions with O(n) Scaling

@@ -163,4 +163,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick++.html b/www/magick++.html
index a9b45ea54..f06e0ad5c 100644
--- a/www/magick++.html
+++ b/www/magick++.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Documentation â¢ Obtaining Magick++ â¢ Installation â¢ Reporting Bugs

@@ -80,24 +80,24 @@ PerlMagick. STL-compatible template versions of ImageMagick's
list-style operations are provided so that operations may be
performed on multiple images stored in STL containers.

-Documentation
+Documentation

Detailed documentation is
provided for all Magick++ classes, class methods, and template
functions which comprise the API. 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.
-Obtaining Magick++
+Obtaining Magick++

Magick++ is included as part of ImageMagick
source releases and may be retrieved via ftp
or GIT.

-Installation
+Installation

Once you have the Magick++ sources available, follow these detailed
installation instructions for UNIX and
Windows.

-Usage
+Usage
A helper script named Magick++-config is installed
under Unix which assists with recalling compilation options required
to compile and link programs which use Magick++. For example, the
@@ -105,31 +105,31 @@ following command compiles and links the source file demo.cpp
to produce the executable demo (notice that quotes are
backward quotes):

-+
c++ `Magick++-config --cxxflags --cppflags` -O2 -o demo demo.cpp \
`Magick++-config --ldflags --libs`
-

+
Set the PKG_CONFIG_PATH environment variable if ImageMagick is not in your default system path:

-+
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
-

+

Windows users may get started by manually editing a project file
for one of the Magick++ demo programs.

Note, under Windows (and possibly the Mac) it may be necessary to initialize the ImageMagick library prior to using the Magick++ library. This initialization is performed by passing the path to the ImageMagick DLLs (assumed to be in the same directory as your program) to the InitializeMagick() function call. This is commonly performed by providing the path to your program (argv[0]) as shown in the following example:
-+
int main( int argc, char ** argv) {
InitializeMagick(*argv);
...
-

+
This initialization step is not required under Unix, Linux,
Cygwin, or any other operating environment that supports the notion
of installing ImageMagick in a known location.
Here is a example program that utilizes the Magick++ API to get you started, magick++.cpp. It reads an image, crops it, and writes it to disk in the PNG image format.

-+
#include <Magick++.h>
#include <iostream>

@@ -161,8 +161,8 @@ int main(int argc,char **argv)
}
return 0;
}
-

-Reporting Bugs
+
+Reporting Bugs

Questions regarding usage should be directed to or to report any bugs go to
Magick++ bug tracking forum.
@@ -187,4 +187,4 @@ int main(int argc,char **argv)

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick-core.html b/www/magick-core.html
index a8021511a..d598438a9 100644
--- a/www/magick-core.html
+++ b/www/magick-core.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The MagickCore API is a low-level interface between the C programming language and the ImageMagick image processing libraries and is recommended for wizard-level programmers only. Unlike the MagickWand C API which uses only a few opaque types and accessors, with MagickCore you almost exlusively access the structure members directly. A description of the MagickCore public methods are found here:
@@ -117,19 +117,19 @@

After you write your MagickCore program, compile it like this:

-+
cc -o core core.c `pkg-config --cflags --libs MagickWand`
-

+

Set the PKG_CONFIG_PATH environment variable if ImageMagick is not in your default system path:

-+
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
-

+

Here is a example program that utilizes the MagickCore API to get you started, core.c. It reads a GIF image, creates a thumbnail, and writes it to disk in the PNG image format.

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
@@ -191,10 +191,10 @@ int main(int argc,char **argv)
exception=DestroyExceptionInfo(exception);
MagickCoreTerminus();
return(0);
-}

+}
Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <MagickCore/MagickCore.h>
@@ -310,7 +310,7 @@ int main(int argc,char **argv)
image_info=DestroyImageInfo(image_info);
MagickCoreTerminus();
return(0);
-}

+}

Donate â¢
@@ -331,4 +331,4 @@ int main(int argc,char **argv)

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick-script.html b/www/magick-script.html
index 1c9db4c9b..48a1bfd17 100644
--- a/www/magick-script.html
+++ b/www/magick-script.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Use the magick-script scripting language to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

@@ -64,17 +64,17 @@
#!/bin/env magick-script
-size 100x100 xc:red ( rose: -rotate -90 ) +append -write show:
-
+

You can find additional examples of using magick-script in Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The magick command recognizes these options. Click on an option to get more details about how that option works.

-

jp2:number-resolutions=x
number of resolutions to encode.

+
@@ -1282,4 +1282,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick-vector-graphics.html b/www/magick-vector-graphics.html
index 24fd4d49c..942bd4199 100644
--- a/www/magick-vector-graphics.html
+++ b/www/magick-vector-graphics.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

MVG Overview â¢ Drawing Primitives

This specification defines the features and syntax for Magick Vector Graphics (MVG), a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick. You can use the language to draw from the
command line, from an MVG file, from an SVG -- Scalable Vector Graphics file or from one of the ImageMagick program interfaces. Use this command, for example, to render an arc:

-+
convert -size 100x60 canvas:skyblue -fill white -stroke black \
-draw "path 'M 30,40 A 30,20 20 0,0 70,20 A 30,20 20 1,0 30,40 Z '" \
arc.png
-

+

and here is the result:

@@ -76,7 +76,7 @@ convert -size 100x60 canvas:skyblue -fill white -stroke black \

When the drawing gets sufficiently complex, we recommend you assemble the graphic primitives into a MVG file. For our example, we use piechart.mvg:

-push graphic-context
+push graphic-context
viewbox 0 0 624 369
affine 0.283636 0 0 0.283846 -0 -0
push graphic-context
@@ -226,13 +226,13 @@ convert -size 100x60 canvas:skyblue -fill white -stroke black \
pop graphic-context
pop graphic-context
pop graphic-context
-

+

to render a pie chart with this command:

-+
convert mvg:piechart.mvg piechart.png
-

+

which produces this rendering:

@@ -242,16 +242,16 @@ convert mvg:piechart.mvg piechart.png

However, in general, MVG is sufficiently difficult to work with that you probably want to use a program to generate your graphics in the SVG format. ImageMagick automagically converts SVG to MVG and renders your image, for example, we render piechart.svg with this command:

-+
convert mvg:piechart.svg piechart.jpg
-

+

to produce the same pie chart we created with the MVG language.

Drawing is available from many of the ImageMagick program interfaces as well. ImageMagick converts the drawing API calls to MVG and renders it. Here is example code written in the MagickWand language:

-(void) PushDrawingWand(draw_wand);
+(void) PushDrawingWand(draw_wand);
{
const PointInfo points[6] =
{
@@ -276,34 +276,34 @@ convert mvg:piechart.svg piechart.jpg
DrawPolygon(draw_wand,6,points);
}
(void) PopDrawingWand(draw_wand);
-

+

-MVG Overview
+MVG Overview

MVG ignores all white-space between commands. This allows multiple MVG commands per line. It is common convention to terminate each MVG command with a new line to make MVG easier to edit and read. This syntax description uses indentation in MVG sequences to aid with understanding. Indentation is supported but is not required.

Metafile wrapper syntax (to support stand-alone MVG files):

-+
push graphic-context
viewbox 0 0 width height
[ any other MVG commands ]
pop graphic-context
-

+

Pattern syntax (saving and restoring context):

-+
push pattern id x,y width,height
push graphic-context
[ drawing commands ]
pop graphic-context
pop pattern
-

+

an example is (%s is a identifier string):

-+
push defs
push pattern %s 10,10 20,20
push graphic-context
@@ -316,31 +316,31 @@ push defs
pop graphic-context
pop pattern
pop defs
-

+

For image tiling use:

-+
push pattern id x,y width,height
image Copy ...
pop pattern
-

+

Note you can use the pattern for either the fill or stroke like:

-+
stroke url(#%s)
-

+

or

-+
fill url(#%s)
-

+

The clip path defines a clipping area, where only the contained area to be drawn upon. Areas outside of the clipping areare masked.

-+
push defs
push clip-path %s
push graphic-context
@@ -349,14 +349,14 @@ push defs
pop clip-path
pop defs
clip-path url(#%s)
-

+

-Drawing Primitives
+Drawing Primitives

Here is a complete description of the MVG drawing primitives:

-

-adaptive-blur geometry
adaptively blur pixels; decrease effect near edges

+
@@ -388,32 +388,32 @@ clip-path url(#%s)

+evenodd
+nonzero
+objectBoundingBox
+reset
+underline
@@ -430,8 +430,8 @@ underline
+evenodd
+nonzero
@@ -448,7 +448,7 @@ nonzero
+ultra-expanded
+oblique
+900
+objectBoundingBox
+SouthEast
@@ -696,11 +696,11 @@ SouthEast
+reset
@@ -817,16 +817,16 @@ reset
+square
+round
@@ -881,4 +881,4 @@ round
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick-wand.html b/www/magick-wand.html
index 28081884a..2cf7e99c3 100644
--- a/www/magick-wand.html
+++ b/www/magick-wand.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The MagickWand API is the recommended interface between the C programming language and the ImageMagick image processing libraries. Unlike the MagickCore C API, MagickWand uses only a few opaque types. Accessors are available to set or get important wand properties. A description of the MagickWand public methods are found here:
@@ -75,19 +75,19 @@

After you write your MagickWand program, compile it like this:

-+
cc -o wand wand.c `pkg-config --cflags --libs MagickWand`
-

+

Set the PKG_CONFIG_PATH environment variable if ImageMagick is not in your default system path:

-+
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
-

+

Here is a example program that utilizes the MagickWand API to get you started, wand.c. It reads an image, creates a thumbnail, and writes the result to disk.

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <wand/MagickWand.h>

@@ -142,11 +142,11 @@ int main(int argc,char **argv)
MagickWandTerminus();
return(0);
}
-

+

Here is another program that shows one way to get and set image pixels with the MagickWand API, contrast.c. It reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk.

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <wand/MagickWand.h>
@@ -252,10 +252,10 @@ int main(int argc,char **argv)
MagickWandTerminus();
return(0);
}
-

+
Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

-#include <stdio.h>
+#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <wand/MagickWand.h>
@@ -361,7 +361,7 @@ int main(int argc,char **argv)
MagickWandTerminus();
return(0);
}
-

+
MagickWand Examples in C illustrates how to use the ImageMagick MagickWand API. Each example is presented as a C function, complete with headers, so that it can be copied to a file and then included in your own C project.

@@ -383,4 +383,4 @@ int main(int argc,char **argv)

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/magick.html b/www/magick.html
index 70e6b3977..48aed10d2 100644
--- a/www/magick.html
+++ b/www/magick.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Use the magick program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

We list a few examples of the magick command here to illustrate its usefulness and ease of use. To get started, lets convert an image in the JPEG format to PNG:

-+
magick rose.jpg rose.png
-

+

Next, we reduce the image size before it is written to the PNG format:

-+
magick rose.jpg -resize 50% rose.png
-

+

@@ -83,11 +83,11 @@ magick rose.jpg -resize 50% rose.png

You can combine multiple image-processing operations to produce complex results:

-+
magick -size 320x85 canvas:none -font Bookman-DemiItalic -pointsize 72 \
-draw "text 25,60 \'Magick\'" -channel RGBA -blur 0x6 -fill darkred -stroke magenta \
-draw "text 20,55 \'Magick\'" fuzzy-magick.png
-

+

@@ -95,28 +95,28 @@ magick -size 320x85 canvas:none -font Bookman-DemiItalic -pointsize 72 \

or here we resize an image with improved quality:

-+
magick input.png -colorspace RGB +sigmoidal-contrast 11.6933 \
-define filter:filter=Sinc -define filter:window=Jinc -define filter:lobes=3 \
-resize 400% -sigmoidal-contrast 11.6933 -colorspace sRGB output.png');
-

+

Utilize other command-line tools from the magick tool. To invoke this functionality, simply create a symbolic link to the magick tool or specify the tool you want to use as the first argument. These two methods are equivalent:

-+
ln -s magick convert
convert rose.jpg rose.png
magick convert rose.jpg rose.png
-

+

You can find additional examples of using magick in Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The magick command recognizes these options. Click on an option to get more details about how that option works.

-

Primitive
Description

clip-rule rule
Choose from these rule types:
-evenodd
-nonzero

clip-units units
Choose from these unit types:
-userSpace
+userSpace
userSpaceOnUse
-objectBoundingBox

color x,y method
Choose from these method types:
-point
+point
replace
floodfill
filltoborder
-reset

decorate type
Choose from these types of decorations:
-none
+none
line-through
overline
-underline

ellipse center_x,center_y radius_x,radius_y arc_start,arc_stop

fill-rule rule
Choose from these rule types:
-evenodd
-nonzero

font name

font-stretch type
Choose from these stretch types:
-all
+all
normal
ultra-condensed
extra-condensed
@@ -457,20 +457,20 @@ semi-condensed
semi-expanded
expanded
extra-expanded
-ultra-expanded

font-style style
Choose from these styles:
-all
+all
normal
italic
-oblique

font-weight weight
Choose from these weights:
-all
+all
normal
bold
100
@@ -481,19 +481,19 @@ bold
600
700
800
-900

gradient-units units
Choose from these units:
-userSpace
+userSpace
userSpaceOnUse
-objectBoundingBox

gravity type
Choose from these gravity types:
-NorthWest
+NorthWest
North
NorthEast
West
@@ -501,7 +501,7 @@ Center
East
SouthWest
South
-SouthEast

image compose x,y width,height 'filename'

matte x,y method
Choose from these methods:
-point
+point
replace
floodfill
filltoborder
-reset

offset offset

stroke-linecap type
Choose from these cap types:
-butt
+butt
round
-square

stroke-linejoin type
Choose from these join types:
-bevel
+bevel
miter
-round

stroke-miterlimit limit

+
@@ -1324,4 +1324,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/miff.html b/www/miff.html
index 1c7239e06..1aa613a4d 100644
--- a/www/miff.html
+++ b/www/miff.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

MIFF Header â¢ MIFF Binary Data

The Magick Image File Format (MIFF) is ImageMagick's own platform-independent format for storing bitmap images. It has an advantage over other image formats in that it stores all metadata known to ImageMagick (e.g. image color profiles, comments, author, copyright, etc.), whereas, other formats may only support a small portion of available metadata or none at all. A MIFF image file consist of two sections. The first section is a header composed of keys describing the image in text form. The next section is the binary image data. We discuss these sections in detail below.

-MIFF Header
+MIFF Header

The MIFF header is composed entirely of ISO-8859-1 characters. The fields in the header are key and value combination in the key = value format, with each key and value separated by an equal sign (=). Each key = value combination is delimited by at least one control or whitespace character. Comments may appear in the header section and are always delimited by braces. The MIFF header always ends with a colon (:) character, followed by a ctrl-Z character. It is also common to proceed the colon with a formfeed and a newline character. The formfeed prevents the listing of binary data when using the more Unix program, whereas, the ctrl-Z has the same effect with the type command on the Windows command line.
@@ -69,7 +69,7 @@
The following is a partial list of key = value combinations that are typically be found in a MIFF file:

-

-adaptive-blur geometry
adaptively blur pixels; decrease effect near edges

+
@@ -114,10 +114,10 @@

@@ -194,7 +194,7 @@

Other key value pairs are permitted. If a value contains whitespace it must be enclosed with braces as illustrated here:

-+
id=ImageMagick
class=PseudoClass colors=256 matte=False
columns=1280 rows=1024 depth=8
@@ -202,7 +202,7 @@ compression=RLE
colorspace=RGB
copyright={Â© 1999-2017 ImageMagick Studio LLC}
⋮
-

+
Note that key = value combinations may be separated by newlines or spaces and may occur in any order within the header. Comments (within braces) may appear anywhere before the colon.

@@ -212,7 +212,7 @@ copyright={Â© 1999-2017 ImageMagick Studio LLC}

The header is separated from the image data by a : character immediately followed by a newline.

-MIFF Binary Data
+MIFF Binary Data
Next comes the binary image data itself. How the image data is formatted depends upon the class of the image as specified (or not specified) by the value of the class key in the header.

@@ -245,4 +245,4 @@ or fewer colors in the image, each byte of image data contains an index value. I

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/mirror.html b/www/mirror.html
index c37deeb40..8af0c96d0 100644
--- a/www/mirror.html
+++ b/www/mirror.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world listed below. ImageMagick stable and development source releases are also available from Git. Before you download, you may want to review recent changes to the ImageMagick distribution. The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick.
-The latest release of ImageMagick is version 7.0.5-10.
-
- Germany
- http://mirror.checkdomain.de/imagemagick/
- ftp://mirror.checkdomain.de/imagemagick/
- Japan
- ftp://ftp.kddlabs.co.jp/graphics/ImageMagick/
- ftp://ftp.u-aizu.ac.jp/pub/graphics/images/ImageMagick/imagemagick.org
- Netherlands
- ftp://ftp.nluug.nl/pub/ImageMagick
- http://ftp.nluug.nl/ImageMagick/
- Poland
- ftp://sunsite.icm.edu.pl/packages/ImageMagick/
- ftp://ftp.tpnet.pl/pub/graphics/ImageMagick/
- rsync://ftp.tpnet.pl/pub/graphics/ImageMagick/
- Sweden
- http://ftp.acc.umu.se/mirror/imagemagick.org/ftp/
- rsync://ftp.acc.umu.se/mirror/imagemagick.org/ftp/
- South Africa
- http://imagemagick.afri.cc/
- United States
- https://www.imagemagick.org/download
- http://transloadit.imagemagick.org/download
- ftp://transloadit.imagemagick.org/pub/ImageMagick (ftp)
- ftp://ftp.fifi.org/pub/ImageMagick/ (ftp)
- http://git.imagemagick.org/repos/ImageMagick (Git)
- https://github.com/ImageMagick/ImageMagick (Git Mirror)
- Select Binaries
- http://www.macports.org/ports.html?by=name&substr=imagemagick (Mac OS X)
- http://hpux.connect.org.uk/hppd/hpux/X11/Viewers/ (HP-UX 10.20 and 11.00)
- Rsync Mirrors
- rsync://rsync.is.co.za/IS-Mirror/mirror.imagemagick.org/
- rsync://rsync.fifi.org/ImageMagick
- rsync://mirror.imagemagick.org/magick_html/ (Web site mirror)
- rsync://mirror.imagemagick.org/magick_ftp/ (FTP mirror)
+The latest release of ImageMagick is version 7.0.6-0.
+
+ Germany
+ http://mirror.checkdomain.de/imagemagick/
+ ftp://mirror.checkdomain.de/imagemagick/
+ Japan
+ ftp://ftp.kddlabs.co.jp/graphics/ImageMagick/
+ ftp://ftp.u-aizu.ac.jp/pub/graphics/images/ImageMagick/imagemagick.org
+ Netherlands
+ ftp://ftp.nluug.nl/pub/ImageMagick
+ http://ftp.nluug.nl/ImageMagick/
+ Poland
+ ftp://sunsite.icm.edu.pl/packages/ImageMagick/
+ ftp://ftp.tpnet.pl/pub/graphics/ImageMagick/
+ rsync://ftp.tpnet.pl/pub/graphics/ImageMagick/
+ Sweden
+ http://ftp.acc.umu.se/mirror/imagemagick.org/ftp/
+ rsync://ftp.acc.umu.se/mirror/imagemagick.org/ftp/
+ South Africa
+ http://imagemagick.afri.cc/
+ United States
+ https://www.imagemagick.org/download
+ http://transloadit.imagemagick.org/download
+ ftp://transloadit.imagemagick.org/pub/ImageMagick (ftp)
+ ftp://ftp.fifi.org/pub/ImageMagick/ (ftp)
+ http://git.imagemagick.org/repos/ImageMagick (Git)
+ https://github.com/ImageMagick/ImageMagick (Git Mirror)
+ Select Binaries
+ http://www.macports.org/ports.html?by=name&substr=imagemagick (Mac OS X)
+ http://hpux.connect.org.uk/hppd/hpux/X11/Viewers/ (HP-UX 10.20 and 11.00)
+ Rsync Mirrors
+ rsync://rsync.is.co.za/IS-Mirror/mirror.imagemagick.org/
+ rsync://rsync.fifi.org/ImageMagick
+ rsync://mirror.imagemagick.org/magick_html/ (Web site mirror)
+ rsync://mirror.imagemagick.org/magick_ftp/ (FTP mirror)

If you want to add a new mirror, please contact us.

@@ -115,4 +115,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/mogrify.html b/www/mogrify.html
index 80c47dc56..08d446f2b 100644
--- a/www/mogrify.html
+++ b/www/mogrify.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the mogrify program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert except that the original image file is overwritten (unless you change the file suffix with the -format option) with any changes you request. See Command Line Processing for advice on how to structure your mogrify command or see below for sample usages of the command.

-Example Usage
+Example Usage

We list a few examples of the mogrify command here to illustrate its usefulness and ease of use. To get started, let's reduce the size of our
rose:

-+
magick mogrify -resize 50% rose.jpg
-

+

@@ -82,26 +82,26 @@ magick mogrify -resize 50% rose.jpg

You can resize all your JPEG images in a folder to a maximum dimension of 256x256 with this command:

-+
magick mogrify -resize 256x256 *.jpg
-

+

Finally, we convert all our PNG images in a folder to the JPEG format:

-+
magick mogrify -format jpg *.png
-

+

Here image files 1.png, 2.png, etc., are left untouched and files 1.jpg, 2.jpg, etc., are created. They are copies of their respective PNG images except are stored in the JPEG image format.

You can find additional examples of using mogrify in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The mogrify command recognizes these options. Click on an option to get more details about how that option works.

-

background-color = color
dispose = value
layer disposal method. Here are the valid values:

- 0. No disposal specified.
- 1. Do not dispose between frames.
- 2. Overwrite frame with background color from header.
- 3. Overwrite with previous frame.
+ 0. No disposal specified.
+ 1. Do not dispose between frames.
+ 2. Overwrite frame with background color from header.
+ 3. Overwrite with previous frame.

+
@@ -1297,4 +1297,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/montage.html b/www/montage.html
index e6a7cd7b4..9a6e1c0f0 100644
--- a/www/montage.html
+++ b/www/montage.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Use the montage program to create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more. See Command Line Processing for advice on how to structure your montage command or see below for example usages of the command.

-Example Usage
+Example Usage

We list a few examples of the montage command here to illustrate its usefulness and ease of use. To get started, let's montage two images into a single composite:

-+
magick montage -background '#336699' -geometry +4+4 rose.jpg red-ball.png montage.jpg
-

+

@@ -84,9 +84,9 @@ magick montage -background '#336699' -geometry +4+4 rose.jpg red-ball.png montag

Ok, let's add some decorations:

-+
magick montage -label %f -frame 5 -background '#336699' -geometry +4+4 rose.jpg red-ball.png frame.jpg
-

+

@@ -103,11 +103,11 @@ magick montage -label %f -frame 5 -background '#336699' -geometry +4+4 rose.jpg

You can find additional examples of using montage at Examples of ImageMagick Usage and Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-Option Summary
+Option Summary

The montage command recognizes these options. Click on an option to get more details about how that option works.

-

Option

+
@@ -638,4 +638,4 @@ transparent, extract, background, or shape the alpha channel
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/motion-picture.html b/www/motion-picture.html
index 251dbdb2b..54e986df3 100644
--- a/www/motion-picture.html
+++ b/www/motion-picture.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

-Log Format â¢ DPX properties â¢ DPX Settings
+Log Format â¢ DPX Properties â¢ DPX Settings

DPX (SMPTE 268M-2003) - This format is used in Motion Picture and Effects industry that makes particular use of the extensive header information and the format's flexibility in being able to handle high dynamic range and logarithmic color values at a variety of bit depths using RGB or YCbCr pixel descriptions. It is based on, but largely supersedes, Kodak's Cineon format that has more a more film specific header.

@@ -71,7 +71,7 @@

The header can contain Film and/or Television specific data related to a production. For example the television header can contain a SMPTE time code so that shots exported as a DPX sequence from a production's edit can be easily replaced once any effects have been added. The film header holds information about the reel of film the frames originated from and various camera settings that were used while filming. All these details usually stay with the images as they are passed between post-production companies.

-Log Format
+Log Format

The color values for each pixel are often stored logarithmically (particularly if the sequence is destined to be transferred back on to film) which more naturally reflects the density of how color information is stored in the emulsion on the original film. When viewed without alteration logarithmic files appear to have very low contrast (leftmost image), and so require a 'look up table' to translate the logarithmic image to something that resembles what you might see if the image was transferred back to film and projected in a cinema (rightmost image). Apart from making the image linear (like most typical computer images) and adjusting the gamma level this table sets where the black and white point lies.

@@ -89,11 +89,11 @@

-DPX Properties
+DPX Properties

ImageMagick supports these DPX properties:

-dpx:file.copyright
+dpx:file.copyright
dpx:file.creator
dpx:file.filename
dpx:file.project
@@ -139,40 +139,40 @@ dpx:television.video_signal
dpx:television.white_level
dpx:user.id
dpx:user.data
-

+

Look for any user data as the dpx:user-data image profile.

To determine which properties are associated with your DPX image, use this command for example:

-+
identify -verbose bluebells.dpx
-

+

To identify a particular property, try this:

-+
identify -format "%[dpx:television.time.code]" bluebells.dpx
-

+

Finally, to set a property:

-+
convert bluebells.dpx -define dpx:television.time.code=10:00:02:15 bluebells-001.dpx
-

+

-DPX Settings
+DPX Settings

Use -set to specify the image or film gamma or black and white points. For example use:

-+
-set gamma 1.7
-set film-gamma 0.6
-set reference-black 95
-set reference-white 685
-set profile dpx:user.data
-

+

@@ -194,4 +194,4 @@ convert bluebells.dpx -define dpx:television.time.code=10:00:02:15 bluebells-001

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/opencl.html b/www/opencl.html
index 651dd6d63..cdee1eb2c 100644
--- a/www/opencl.html
+++ b/www/opencl.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The following is a list of image operators that have been OpenCL-accelerated:
-+
blur
charcoal
contrast
@@ -80,28 +80,28 @@ radial-blur
resize
sketch
unsharp
-

+
When the OpenCL acceleration is invoked for the first time, ImageMagick conducts a series of tests to configure the OpenCL environment according to the system hardware; therefore, it is normal to experience a higher latency the first time you use an accelerated option. The OpenCL kernels are embedded inside ImageMagick in source format. During the initial setup, ImageMagick discovers all the available OpenCL devices and compiles the kernels for each of these targets. ImageMagick also runs several performance tests internally to determine the preferred device to use. The compiled kernel code and the performance test results are stored into the cache directory so that the data can be reused by subsequent invocations of the OpenCL path. By default, the OpenCL cached data is stored in $HOME/.cache/ImageMagick on Linux and on MacOSX or in %LOCALAPPDATA%\.cache\ImageMagick on Windows. To change the cache directory, set the IMAGEMAGICK_OPENCL_CACHE_DIR environment variable. ImageMagick is able to detect hardware changes, driver updates, and new kernel sources and re-run the setup and the calibration test. You can also force ImageMagick to re-run the process by removing the content from the cache directory.
If ImageMagick includes OpenCL support, the OpenCL path is enable by default. You can disable it, simply set the environment variable MAGICK_OCL_DEVICE to OFF. You could also force the OpenCL path to use a particular class of devices by setting it to GPU or CPU.
In addition to the environment variables just mentioned, ImageMagick provides a set of APIs that allow developers to gain a finer grain control of the OpenCL acceleration. For example, use the InitImageMagickOpenCL) function to turn off OpenCL:
-+
InitImageMagickOpenCL(MAGICK_OPENCL_OFF, NULL, NULL, exception);
-

+
Use InitImageMagickOpenCL() to find out which OpenCL device are automagically selected by ImageMagick:
-+
cl_device_id selectedDevice; // OpenCL device used by ImageMagick
InitImageMagickOpenCL(MAGICK_OPENCL_DEVICE_SELECT_AUTO, NULL, (void*)&selectedDevice, exception);
-

+

Or you could request ImageMagick to use a specific OpenCL device:
-+
cl_device_id myDevices[4];
cl_uint numDevices;
// Get all the available OpenCL devices from the runtime
clGetDeviceIDs(myPlatform, CL_DEVICE_TYPE_ALL, 4, myDevices, &numDevices);
// ask ImageMagick to use the 3rd device
InitImageMagickOpenCL(MAGICK_OPENCL_DEVICE_SELECT_USER, (void*)(myDevices+2), NULL, exception);
-

+

Donate â¢
@@ -122,4 +122,4 @@ InitImageMagickOpenCL(MAGICK_OPENCL_DEVICE_SELECT_USER, (void*)(myDevices+2), NU

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/openmp.html b/www/openmp.html
index 64640214a..c67d99cc0 100644
--- a/www/openmp.html
+++ b/www/openmp.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips and OpenMP. OpenMP, is an API specification for parallel programming. If your compiler supports OpenMP (e.g. gcc, Visual Studio 2005) directives, ImageMagick automatically includes support. To verify, look for the OpenMP feature of ImageMagick with this command:
-+
-> identify -version
Version: ImageMagick 7.0.3-2 2016-10-14 Q16 https://www.imagemagick.org
Copyright: Â© 1999-2017 ImageMagick Studio LLC
Features: OpenMP
-

+
With OpenMP enabled, most ImageMagick algorithms execute on all the cores on your system in parallel. ImageMagick typically divides the work so that each thread processes four rows of pixels. As rows are completed, OpenMP assigns more chunks of pixel rows to each thread until the algorithm completes. For example, if you have a quad-core system, and attempt to resize an image, the resizing takes place on 4 cores (8 if hyperthreading is enabled).
The Perils of Parallel Execution
It can be difficult to predict behavior in a parallel environment. Performance might depend on a number of factors including the compiler, the version of the OpenMP library, the processor type, the number of cores, the amount of memory, whether hyperthreading is enabled, the mix of applications that are executing concurrently with ImageMagick, or the particular image-processing algorithm you utilize. The only way to be certain of the optimal performance, in terms of the number of threads, is to benchmark. ImageMagick includes progressive threading when benchmarking a command and returns the elapsed time and efficiency for one or more threads. This can help you identify how many threads are the most efficient in your environment. Here is an example benchmark for threads 1-8:

-+
-> convert -bench 40 model.png -sharpen 0x1 null:
Performance[1]: 40i 0.712ips 1.000e 14.000u 0:14.040
Performance[2]: 40i 1.362ips 0.657e 14.550u 0:07.340
@@ -79,7 +79,7 @@ Performance[5]: 40i 3.236ips 0.820e 14.970u 0:03.090
Performance[6]: 40i 3.802ips 0.842e 15.280u 0:02.630
Performance[7]: 40i 4.274ips 0.857e 15.540u 0:02.340
Performance[8]: 40i 4.831ips 0.872e 15.680u 0:02.070
-

+
Better performance correlates with higher values of IPS (iterations-per-second). In our example, 8 cores are optimal. However, in certain cases it might be optimal to set the number of threads to 1 (e.g. -limit thread 1) or to disable OpenMP completely. To disable this feature, add --disable-openmp to your configure script command line then rebuild and re-install ImageMagick.

@@ -101,4 +101,4 @@ Performance[8]: 40i 4.831ips 0.872e 15.680u 0:02.070

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/perl-magick.html b/www/perl-magick.html
index ef2918f67..3b0b9b28b 100644
--- a/www/perl-magick.html
+++ b/www/perl-magick.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Installation â¢ Overview â¢ Example Script â¢ Read or Write an Image â¢ Manipulate an Image â¢ Set an Image Attribute â¢ Get an Image Attribute â¢ Compare an Image to its Reconstruction â¢ Create an Image Montage â¢ Working with Blobs â¢ Direct-access to Image Pixels â¢ Miscellaneous Methods â¢ Handling Exceptionsâ¢ Constant

@@ -66,45 +66,45 @@

You can try PerlMagick from your Web browser at the ImageMagick Studio. Or, you can see examples of select PerlMagick functions.

-Installation
+Installation

UNIX

Is PerlMagick available from your system RPM repository? For example, on our CentOS system, we install PerlMagick thusly:

-+
yum install ImageMagick-perl
-

+

If not, you must install PerlMagick from the ImageMagick source distribution. Download the latest source release.

Unpack the distribution with this command:

-+
tar xvzf ImageMagick.tar.gz
-

+

Next configure and compile ImageMagick:

- cd ImageMagick-7.0.5 ./configure -with-perl make
+ cd ImageMagick-7.0.6 ./configure -with-perl make
If ImageMagick / PerlMagick configured and compiled without complaint, you are ready to install it on your system. Administrator privileges are required to install. To install, type

-+
sudo make install
-

+

You may need to configure the dynamic linker run-time bindings:

-+
sudo ldconfig /usr/local/lib
-

+

Finally, verify the PerlMagick install worked properly, type

-+
perl -MImage::Magick -le 'print Image::Magick->QuantumDepth'
-

+

Congratulations, you have a working ImageMagick distribution and you are ready to use PerlMagick to convert, compose, or edit your images.

@@ -114,12 +114,12 @@ perl -MImage::Magick -le 'print Image::Magick->QuantumDepth'

Next, type

-+
cd PerlMagick
perl Makefile.nt
nmake
nmake install
-

+

See the PerlMagick Windows HowTo page for further installation instructions.

@@ -127,76 +127,76 @@ nmake install

To verify a correct installation, type

-+
make test
-

+

Use nmake test under Windows. There are a few demonstration scripts available to exercise many of the functions PerlMagick can perform. Type

-+
cd demo
make
-

+

You are now ready to utilize the PerlMagick methods from within your Perl scripts.

-Overview
+Overview

Any script that wants to use PerlMagick methods must first define the methods within its namespace and instantiate an image object. Do this with:

-+
use Image::Magick;

$image = Image::Magick->new;
-

+

PerlMagick is quantum aware. You can request a specific quantum depth when you instantiate an image object:

-+
use Image::Magick::Q16;

$image = Image::Magick::Q16->new;
-

+

The new() method takes the same parameters as SetAttribute . For example,

-+
$image = Image::Magick->new(size=>'384x256');
-

+

Next you will want to read an image or image sequence, manipulate it, and then display or write it. The input and output methods for PerlMagick are defined in Read or Write an Image. See Set an Image Attribute for methods that affect the way an image is read or written. Refer to Manipulate an Image for a list of methods to transform an image. Get an Image Attribute describes how to retrieve an attribute for an image. Refer to Create an Image Montage for details about tiling your images as thumbnails on a background. Finally, some methods do not neatly fit into any of the categories just mentioned. Review Miscellaneous Methods for a list of these methods.

Once you are finished with a PerlMagick object you should consider destroying it. Each image in an image sequence is stored in virtual memory. This can potentially add up to mebibytes of memory. Upon destroying a PerlMagick object, the memory is returned for use by other Perl methods. The recommended way to destroy an object is with undef:

-+
undef $image;
-

+

To delete all the images but retain the Image::Magick object use

-+
@$image = ();
-

+

and finally, to delete a single image from a multi-image sequence, use

-+
undef $image->[$x];
-

+

The next section illustrates how to use various PerlMagick methods to manipulate an image sequence.

Some of the PerlMagick methods require external programs such as Ghostscript. This may require an explicit path in your PATH environment variable to work properly. For example (in Unix),

-+
$ENV{PATH}' . "='/../bin:/usr/bin:/usr/local/bin';
-

+

-Example Script
+Example Script

Here is an example script to get you started:

-+
#!/usr/local/bin/perl
use Image::Magick;

my($image, $x);

@@ -207,11 +207,11 @@ $x = $image->Crop(geometry=>'100x100+100+100');
warn "$x" if "$x";

$x = $image->Write('x.png');
warn "$x" if "$x";
-

+

The script reads three images, crops them, and writes a single image as a GIF animation sequence. In many cases you may want to access individual images of a sequence. The next example illustrates how this done:

-#!/usr/local/bin/perl
+#!/usr/local/bin/perl
use Image::Magick;

my($image, $p, $q);

$image = new Image::Magick;
@@ -229,60 +229,60 @@ $p->Draw(stroke=>'red', primitive=>'rectangle', points=>20,20 100,10
$q = $p->Montage();
undef $image;
$q->Write('x.miff');
-

+

Suppose you want to start out with a 100 by 100 pixel white canvas with a red pixel in the center. Try

-+
$image = Image::Magick->new;
$image->Set(size=>'100x100');
$image->ReadImage('canvas:white');
$image->Set('pixel[49,49]'=>'red');
-

+

Here we reduce the intensity of the red component at (1,1) by half:

-+
@pixels = $image->GetPixel(x=>1,y=>1);
$pixels[0]*=0.5;
$image->SetPixel(x=>1,y=>1,color=>\@pixels);
-

+

Or suppose you want to convert your color image to grayscale:

-+
$image->Quantize(colorspace=>'gray');
-

+

Let's annotate an image with a Taipai TrueType font:

-+
$text = 'Works like magick!';
$image->Annotate(font=>'kai.ttf', pointsize=>40, fill=>'green', text=>$text);
-

+

Perhaps you want to extract all the pixel intensities from an image and write them to STDOUT:

-+
@pixels = $image->GetPixels(map=>'I', height=>$height, width=>$width, normalize=>true);
binmode STDOUT;
print pack('B*',join('',@pixels));
-

+

Other clever things you can do with a PerlMagick objects include

-+
$i = $#$p"+1"; # return the number of images associated with object p
push(@$q, @$p); # push the images from object p onto object q
@$p = (); # delete the images but not the object p
$p->Convolve([1, 2, 1, 2, 4, 2, 1, 2, 1]); # 3x3 Gaussian kernel
-

+

- Read or Write an Image
+ Read or Write an Image

Use the methods listed below to either read, write, or display an image or image sequence:

-

Option

+@@ -331,59 +331,59 @@ $p->Convolve([1, 2, 1, 2, 4, 2, 1, 2, 1]); # 3x3 Gaussian kernel

For convenience, methods Write(), Display(), and Animate() can take any parameter that SetAttribute knows about. For example,

-+
$image->Write(filename=>'image.png', compression=>'None');
-

+
Use - as the filename to method Read() to read from standard in or to method Write() to write to standard out:

-+
binmode STDOUT;
$image->Write('png:-');
-

+
To read an image in the GIF format from a PERL filehandle, use:

-+
$image = Image::Magick->new;
open(IMAGE, 'image.gif');
$image->Read(file=>\*IMAGE);
close(IMAGE);
-

+
To write an image in the PNG format to a PERL filehandle, use:

-+
$filename = "image.png";
open(IMAGE, ">$filename");
$image->Write(file=>\*IMAGE, filename=>$filename);
close(IMAGE);
-

+
Note, reading from or writing to a Perl filehandle may fail under Windows due to different versions of the C-runtime libraries between ImageMagick and the ActiveState Perl distributions or if one of the DLL's is linked with the /MT option. See Potential Errors Passing CRT Objects Across DLL Boundaries for an explanation.
If %0Nd, %0No, or %0Nx appears in the filename, it is interpreted as a printf format specification and the specification is replaced with the specified decimal, octal, or hexadecimal encoding of the scene number. For example,

-+
image%03d.miff
-

+
converts files image000.miff, image001.miff, etc.
You can optionally add Image to any method name. For example, ReadImage() is an alias for method Read().

-Manipulate an Image
+Manipulate an Image
Once you create an image with, for example, method ReadImage() you may want to operate on it. Below is a list of all the image manipulations methods available to you with PerlMagick. There are examples of select PerlMagick methods. Here is an example call to an image manipulation method:

-+
$image->Crop(geometry=>'100x100+10+20');
$image->[$x]->Frame("100x200");
-

+
And here is a list of other image manipulation methods you can call:

-
Read or Write Methods

+
@@ -1237,28 +1237,28 @@ fill=>color name, channel=>{All, Default,

You can specify @filename in both Annotate() and Draw(). This reads the text or graphic primitive instructions from a file on disk. For example,

-+
image->Draw(fill=>'red', primitive=>'rectangle',
points=>'20,20 100,100 40,40 200,200 60,60 300,300');
-

+
Is equivalent to

-+
$image->Draw(fill=>'red', primitive=>'@draw.txt');
-

+
Where draw.txt is a file on disk that contains this:

-+
rectangle 20, 20 100, 100
rectangle 40, 40 200, 200
rectangle 60, 60 300, 300
-

+
The text parameter for methods, Annotate(), Comment(), Draw(), and Label() can include the image filename, type, width, height, or other image attribute by embedding these special format characters:

-%b file size
+%b file size
%c comment
%d directory
%e filename extension
@@ -1294,13 +1294,13 @@ rectangle 60, 60 300, 300
%% a percent sign
\n newline
\r carriage return
-

+
For example,

-+
text=>"%m:%f %wx%h"
-

+
produces an annotation of MIFF:bird.miff 512x480 for an image titled bird.miff and whose width is 512 and height is 480.

@@ -1308,14 +1308,14 @@ text=>"%m:%f %wx%h"

Most of the attributes listed above have an analog in convert. See the documentation for a more detailed description of these attributes.

-Set an Image Attribute
+Set an Image Attribute
Use method Set() to set an image attribute. For example,

-+
$image->Set(dither=>'True');
$image->[$x]->Set(delay=>3);
-

+
Where this example uses 'True' and this document says '{True, False}',
you can use the case-insensitive strings 'True' and 'False', or you
@@ -1325,7 +1325,7 @@ can use the integers 1 and 0.
And here is a list of all the image attributes you can set:

-
Image Manipulation Methods

+
@@ -1722,18 +1722,18 @@ can use the integers 1 and 0.
Most of the attributes listed above have an analog in
convert. See the documentation for a more detailed description of these attributes.

-Get an Image Attribute
+Get an Image Attribute
Use method Get() to get an image attribute. For example,

-+
($a, $b, $c) = $image->Get('colorspace', 'magick', 'adjoin');
$width = $image->[3]->Get('columns');
-

+
In addition to all the attributes listed in Set an Image Attribute , you can get these additional attributes:

-
Image Attributes

+
@@ -1995,11 +1995,11 @@ $width = $image->[3]->Get('columns');
Most of the attributes listed above have an analog in
convert. See the documentation for a more detailed description of these attributes.

-Compare an Image to its Reconstruction
+Compare an Image to its Reconstruction
Mathematically and visually annotate the difference between an image and its reconstruction with the Compare() method. The method supports these parameters:

-
Image Attributes

+
@@ -2036,7 +2036,7 @@ $width = $image->[3]->Get('columns');

In this example, we compare the ImageMagick logo to a sharpened reconstruction:

-+
use Image::Magick;

$logo=Image::Magick->New();
@@ -2047,21 +2047,21 @@ $sharp->Sharpen('0x1');
$difference=$logo->Compare(image=>$sharp, metric=>'rmse');
print $difference->Get('error'), "\n";
$difference->Display();
-

+
In addition to the reported root mean squared error of around 0.024, a difference image is displayed so you can visually identify the difference between the images.

-Create an Image Montage
+Create an Image Montage
Use method Montage() to create a composite image by combining several separate images. The images are tiled on the composite image with the name of the image optionally appearing just below the individual tile. For example,

-+
$image->Montage(geometry=>'160x160', tile=>'2x2', texture=>'granite:');
-

+
And here is a list of Montage() parameters you can set:

-
Compare Parameters

+
@@ -2182,13 +2182,13 @@ South, SouthEastMost of the attributes listed above have an analog in montage. See the documentation for a more detailed description of these attributes.

-Working with Blobs
+Working with Blobs
A blob contains data that directly represent a particular image
format in memory instead of on disk. PerlMagick supports
blobs in any of these image formats and provides methods to convert a blob to or from a particular image format.

-
Montage Parameters

+
@@ -2216,27 +2216,27 @@ blobs in any of these image formats and provides meth

ImageToBlob() returns the image data in their respective formats. You can then print it, save it to an ODBC database, write it to a file, or pipe it to a display program:

-+
@blobs = $image->ImageToBlob();
open(DISPLAY,"| display -") || die;
binmode DISPLAY;
print DISPLAY $blobs[0];
close DISPLAY;
-

+
Method BlobToImage() returns an image or image sequence converted from the supplied blob:

-+
@blob=$db->GetImage();
$image=Image::Magick->new(magick=>'jpg');
$image->BlobToImage(@blob);
-

+

-Direct-access to Image Pixels
+Direct-access to Image Pixels
Use these methods to obtain direct access to the image pixels:

-
Blob Methods

+
@@ -2278,66 +2278,66 @@ $image->BlobToImage(@blob);

Direct-access to Image Pixels

-Miscellaneous Methods
+Miscellaneous Methods

The Append() method append a set of images. For example,

-+
$p = $image->Append(stack=>{true,false});
-

+

appends all the images associated with object $image. By default, images are stacked left-to-right. Set stack to True to stack them top-to-bottom.

The Clone() method copies a set of images. For example,

-+
$q = $p->Clone();
-

+

copies all the images from object $p to $q. You can use this method for single or multi-image sequences.

The ComplexImages() method performs complex mathematics on an image sequence. For example,

-+
$p = $image->ComplexImages('conjugate');
-

+

The EvaluateImages() method applies an arithmetic, logical or relational expression to a set of images. For example,

-+
$p = $image->EvaluateImages('mean');
-

+

averages all the images associated with object $image.

The Features() method returns features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance. The features include the angular second momentum, contrast, correlation, sum of squares: variance, inverse difference moment, sum average, sum varience, sum entropy, entropy, difference variance, difference entropy, information measures of correlation 1, information measures of correlation 2, and maximum correlation coefficient. Values in RGB, CMYK, RGBA, or CMYKA order (depending on the image type).

-+
@features = $image->Features(1);
-

+

Finally, the Transform() method accepts a fully-qualified geometry specification for cropping or resizing one or more images. For example,

-+
$p = $images->Transform(crop=>'100x100+10+60');
-

+

The Flatten() method flattens a set of images and returns it. For example,

-+
$p = $images->Flatten(background=>'none');
$p->Write('flatten.png');
-

+

The sequence of images is replaced by a single image created by composing each image after the first over the first image.

The Fx() method applies a mathematical expression to a set of images and returns the results. For example,

-+
$p = $image->Fx(expression=>'(g+b)/2.0',channel=>'red');
$p->Write('fx.miff');
-

+

replaces the red channel with the average of the green and blue channels.

@@ -2347,9 +2347,9 @@ $p->Write('fx.miff');

The Morph() method morphs a set of images. Both the image pixels and size are linearly interpolated to give the appearance of a meta-morphosis from one image to the next:

-+
$p = $image->Morph(frames=>integer);
-

+

where frames is the number of in-between images to generate. The default is 1.

@@ -2357,46 +2357,46 @@ $p = $image->Morph(frames=>integer);

Method Mogrify() is a single entry point for the image manipulation methods (Manipulate an Image). The parameters are the name of a method followed by any parameters the method may require. For example, these calls are equivalent:

-+
$image->Crop('340x256+0+0');
$image->Mogrify('crop', '340x256+0+0');
-

+

Method MogrifyRegion() applies a transform to a region of the image. It is similar to Mogrify() but begins with the region geometry. For example, suppose you want to brighten a 100x100 region of your image at location (40, 50):

-+
$image->MogrifyRegion('100x100+40+50', 'modulate', brightness=>50);
-

+

Ping() is a convenience method that returns information about an image without having to read the image into memory. It returns the width, height, file size in bytes, and the file format of the image. You can specify more than one filename but only one filehandle:

-+
($width, $height, $size, $format) = $image->Ping('logo.png');
($width, $height, $size, $format) = $image->Ping(file=>\*IMAGE);
($width, $height, $size, $format) = $image->Ping(blob=>$blob);
-

+

This a more efficient and less memory intensive way to query if an image exists and what its characteristics are.

Poly() builds a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs):

-+
$p = $image->Poly([0.5,1.0,0.25,2.0,1.0,1.0]);
-

+

PreviewImage() tiles 9 thumbnails of the specified image with an image processing operation applied at varying strengths. This may be helpful pin-pointing an appropriate parameter for a particular image processing operation. Choose from these operations: Rotate, Shear, Roll, Hue, Saturation, Brightness, Gamma, Spiff, Dull, Grayscale, Quantize, Despeckle, ReduceNoise, AddNoise, Sharpen, Blur, Threshold, EdgeDetect, Spread, Solarize, Shade, Raise, Segment, Swirl, Implode, Wave, OilPaint, CharcoalDrawing, JPEG. Here is an example:

-+
$preview = $image->Preview('Gamma');
$preview->Display();
-

+

To have full control over text positioning you need font metric information. Use

-+
($x_ppem, $y_ppem, $ascender, $descender, $width, $height, $max_advance) =
$image->QueryFontMetrics(parameters);
-

+

Where parameters is any parameter of the Annotate method. The return values are:

@@ -2420,120 +2420,120 @@ $preview->Display();

Call QueryColor() with no parameters to return a list of known colors names or specify one or more color names to get these attributes: red, green, blue, and opacity value.

-+
@colors = $image->QueryColor();
($red, $green, $blue, $opacity) = $image->QueryColor('cyan');
($red, $green, $blue, $opacity) = $image->QueryColor('#716bae');
-

+

QueryColorname() accepts a color value and returns its respective name or hex value;

-+
$name = $image->QueryColorname('rgba(80,60,0,0)');
-

+

Call QueryFont() with no parameters to return a list of known fonts or specify one or more font names to get these attributes: font name, description, family, style, stretch, weight, encoding, foundry, format, metrics, and glyphs values.

-+
@fonts = $image->QueryFont();
$weight = ($image->QueryFont('Helvetica'))[5];
-

+

Call QueryFormat() with no parameters to return a list of known image formats or specify one or more format names to get these attributes: adjoin, blob support, raw, decoder, encoder, description, and module.

-+
@formats = $image->QueryFormat();
($adjoin, $blob_support, $raw, $decoder, $encoder, $description, $module) =
$image->QueryFormat('gif');
-

+

Call MagickToMime() with the image format name to get its MIME type such as images/tiff from tif.

-+
$mime = $image->MagickToMime('tif');
-

+

Use RemoteCommand() to send a command to an already running display or animate application. The only parameter is the name of the image file to display or animate.

-+
$image->RemoteCommand('image.jpg');
-

+

The Smush() method smushes a set of images together. For example,

-+
$p = $image->Smush(stack=>{true,false},offset=>integer);
-

+

smushes together all the images associated with object $image. By default, images are smushed left-to-right. Set stack to True to smushed them top-to-bottom.

Statistics() returns the image statistics for each channel in the image. The returned values are an array of depth, minima, maxima, mean, standard deviation, kurtosis, skewness, and entropy values in RGB, CMYK, RGBA, or CMYKA order (depending on the image type).

-+
@statistics = $image->Statistics();
-

+

Finally, the Transform() method accepts a fully-qualified geometry specification for cropping or resizing one or more images. For example,

-+
$p = $image->Transform(crop=>'100x100+0+0');
-

+

You can optionally add Image to any method name above. For example, PingImage() is an alias for method Ping().

-Handling Exceptions
+Handling Exceptions

All PerlMagick methods return an undefined string context upon success. If any problems occur, the error is returned as a string with an embedded numeric status code. A status code less than 400 is a warning. This means that the operation did not complete but was recoverable to some degree. A numeric code greater or equal to 400 is an error and indicates the operation failed completely. Here is how exceptions are returned for the different methods:

Methods which return a number (e.g. Read(), Write()):

-+
$x = $image->Read(...);
warn "$x" if "$x"; # print the error message
$x =~ /(\d+)/;
print $1; # print the error number
print 0+$x; # print the number of images read
-

+

Methods which operate on an image (e.g. Resize(), Crop()):

-+
$x = $image->Crop(...);
warn "$x" if "$x"; # print the error message
$x =~ /(\d+)/;
print $1; # print the error number
-

+

Methods which return images (EvaluateSequence(), Montage(), Clone()) should be checked for errors this way:

-+
$x = $image->Montage(...);
warn "$x" if !ref($x); # print the error message
$x =~ /(\d+)/;
print $1; # print the error number
-

+

Here is an example error message:

-+
Error 400: Memory allocation failed
-

+

Review the complete list of error and warning codes.

The following illustrates how you can use a numeric status code:

-+
$x = $image->Read('rose.png');
$x =~ /(\d+)/;
die "unable to continue" if ($1 == ResourceLimitError);
-

+

-Constants
+Constants

PerlMagick includes these constants:

-BlobError
+BlobError
BlobWarning
CacheError
CacheWarning
@@ -2575,13 +2575,13 @@ TypeWarning
WarningException
XServerError
XServerWarning
-

+

You can access them like this:

-+
Image::Magick->QuantumDepth
-

+

@@ -2603,4 +2603,4 @@ Image::Magick->QuantumDepth

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/porting.html b/www/porting.html
index 8d230c050..ed6972b5d 100644
--- a/www/porting.html
+++ b/www/porting.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick Version 7 â¢ High Dynamic Range Imaging â¢ Pixel Channels â¢ Alpha â¢ Grayscale â¢ Masks â¢ MagickCore API â¢ Header Files â¢ Deprecated Features Removed â¢ Command-line Interface â¢ Version 7 Change Summary
@@ -80,10 +80,10 @@ options, and more global use of 'image properties' (more commonly known as

Once ImageMagick version 7 is released, we will continue to support and enhance version 6 for a minimum of 10 years.

-High Dynamic Range Imaging
+High Dynamic Range Imaging
ImageMagick version 7 enables high dynamic range imaging (HDRI) by default. HDRI accurately represents the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows. In addition, image processing results are more accurate. The disadvantage is it requires more memory and may result in slower processing times. If you see differences in the results of your version 6 command-line with version 7, it is likely due to HDRI. You may need to add -clamp to your command-line to constrain pixels to the 0 .. QuantumRange range, or disable HDRI when you build ImageMagick version 7. To disable HDRI (recommended for smart phone builds such as iOS or production sites where performance is a premium), simply add --disable-hdri to the configure script command line when building ImageMagick.

-Pixel Channels
+Pixel Channels
A pixel is comprised of one or more color values, or channels (e.g. red pixel channel).
Prior versions of ImageMagick (4-6), support 4 to 5 pixel channels (RGBA or CMYKA). The first 4 channels are accessed with the PixelPacket data structure. The structure includes 4 members of type Quantum (typically 16-bits) of red, green, blue, and opacity. The black channel or colormap indexes are supported by a separate method and structure, IndexPacket. As an example, here is a code snippet from ImageMagick version 6 that negates the color components (but not the alpha component) of the image pixels:

@@ -204,7 +204,7 @@ options, and more global use of 'image properties' (more commonly known as
Pixel Accessors
You can access pixel channel as array elements (e.g. pixel[1]) or use convenience accessors to get or set pixel channels:

-+
GetPixela() SetPixela()
GetPixelAlpha() SetPixelAlpha()
GetPixelb() SetPixelb()
@@ -225,24 +225,24 @@ GetPixelOpacity() SetPixelOpacity()
GetPixelRed() SetPixelRed()
GetPixelYellow() SetPixelYellow()
GetPixelY() SetPixelY()
-

+

You can find these accessors defined in the header file, MagickCore/pixel-accessor.h

Pixel Traits
Each pixel channel includes one or more of these traits:
-
-Undefined
-no traits associated with this pixel channel
-Copy
-do not update this pixel channel, just copy it
-Update
-update this pixel channel
-Blend
-blend this pixel channel with the alpha mask if it's enabled
+
+Undefined
+no traits associated with this pixel channel
+Copy
+do not update this pixel channel, just copy it
+Update
+update this pixel channel
+Blend
+blend this pixel channel with the alpha mask if it's enabled

We provide these methods to set and get pixel traits:
-+
GetPixelAlphaTraits() SetPixelAlphaTraits()
GetPixelBlackTraits() SetPixelBlackTraits()
GetPixelBlueTraits() SetPixelBlueTraits()
@@ -256,66 +256,66 @@ GetPixelMagentaTraits() SetPixelMagentaTraits()
GetPixelRedTraits() SetPixelRedTraits()
GetPixelYellowTraits() SetPixelYellowTraits()
GetPixelYTraits() SetPixelYTraits()
-

+
For convenience you can set the active trait for a set of pixel channels with a channel mask and this method:
-+
SetImageChannelMask()
-

+

Previously MagickCore methods had channel analogs, for example, NegateImage() and NegateImageChannels(). The channel analog methods are no longer necessary because the pixel channel traits specify whether to act on a particular pixel channel or whether to blend with the alpha mask. For example, instead of
-+
NegateImageChannel(image,channel);
-

+
we use:
-+
channel_mask=SetImageChannelMask(image,channel);
NegateImage(image,exception);
(void) SetImageChannelMask(image,channel_mask);
-

+

Pixel User Channels
In version 7, we introduce pixel user channels. Traditionally we utilize 4 channels, red, green, blue, and alpha. For CMYK we also have a black channel. User channels are designed to contain whatever additional channel information that makes sense for your application. Some examples include extra channels in TIFF or PSD images or perhaps you require a channel with infrared information for the pixel. You can associate traits with the user channels so that they when they are acted upon by an image processing algorithm (e.g. blur) the pixels are copied, acted upon by the algorithm, or even blended with the alpha channel if that makes sense.
Pixel Metacontent
In version 7, we introduce pixel metacontent. Metacontent is content about content. So rather than being the content itself, it's something that describes or is associated with the content. Here the content is a pixel. The pixel metacontent is for your exclusive use (internally the data is just copied, it is not modified) and is accessed with these MagickCore API methods:
-+
SetImageMetacontentExtent()
GetImageMetacontentExtent()
GetVirtualMetacontent()
GetAuthenticMetacontent()
GetCacheViewAuthenticMetacontent()
GetCacheViewVirtualMetacontent()
-

+

-Alpha
+Alpha
We support alpha now, previously opacity. With alpha, a value of 0 means that the pixel does not have any coverage information and is transparent; i.e. there was no color contribution from any geometry because the geometry did not overlap this pixel. A value of QuantumRange means that the pixel is opaque because the geometry completely overlapped the pixel. As a consequence, in version 7, the PixelInfo structure member alpha has replaced the previous opacity member. Another consequence is the alpha part of a sRGB value in hexadecimal notation is now reversed (e.g. #0000 is fully transparent).
-Colorspace
+Colorspace
The Rec601Luma and Rec709Luma colorspaces are no longer supported. Instead, specify the gray colorspace and choose from these intensity options:
-+
Rec601Luma
Rec601Luminance
Rec709Luma
Rec709Luminance
-

+
For example,
-+
convert myImage.png -intensity Rec709Luminance -colorspace gray myImage.jpg
-

+

-Grayscale
+Grayscale
Previously, grayscale images were Rec601Luminance and consumed 4 channels: red, green, blue, and alpha. With version 7, grayscale consumes only 1 channel requiring far less resources as a result.

-Masks
+Masks
Version 7 supports masks for most image operators. Black pixels in a read mask ignores corresponding pixel in an image whereas black pixels in a write mask protects the corresponding pixel in the image. From the command-line, you can associate a mask with an image with the -read-mask and -write-mask options. This polarity is the reverse of masks in version 6 of ImageMagick. For convenience, we continue to support the -mask option in version 7 to match the behavior of version 6.
In this example, we compute the distortion of a masked reconstructed image:
-+
compare -metric rmse -read-mask hat_mask.png hat.png wizard.png difference.png
-

+
Here we protect certain pixels from change:
-+
convert rose: -write-mask rose_bg_mask.png -modulate 110,100,33.3 +mask rose_blue.png
-

+

-MagickCore API
+MagickCore API
Here are a list of changes to the MagickCore API:

Almost all image processing algorithms are now channel aware.
@@ -329,29 +329,29 @@ convert rose: -write-mask rose_bg_mask.png -modulate 110,100,33.3 +mask rose_bl
The ChannelMoments structure member I is now invariant. I conflicts with the complex.h header.
We added a length parameter to FormatMagickSize() to permit variable length buffers.

-MagickWand API
+MagickWand API
Here are a list of changes to the MagickWand API:

The DrawMatte() method is now called DrawAlpha().
The MagickSetImageBias() and MagickSetImageClipMask() methods are no longer supported.

-Header Files
+Header Files
Prior versions of ImageMagick (4-6) reference the ImageMagick header files as magick/ and wand/. ImageMagick 7 instead uses MagickCore/ and MagickWand/ respectively. For example,
-#include <MagickCore/MagickCore.h>
-#include <MagickWand/MagickWand.h>
+#include <MagickCore/MagickCore.h>
+#include <MagickWand/MagickWand.h>

-Deprecated Features Removed
+Deprecated Features Removed
All deprecated features from ImageMagick version 6 are removed in version 7. These include the Magick-config and Wand-config configuration utilities. Instead use:

-MagickCore-config
+MagickCore-config
MagickWand-config
-

+
The FilterImage() method has been removed. Use ConvolveImage() instead.

In addition, all deprecated MagickCore and MagickWand methods are no longer available in version 7.

-Shell API or Command-line Interface
+Shell API or Command-line Interface

As mentioned the primary focus of the changes to the Shell API or Command
Line Interface is the abstraction so that not only can options be
@@ -397,16 +397,16 @@ be applied to expand the one channel into separate RGB (or other) channels.

Command Changes
Here are a list of changes to the ImageMagick commands:
-
-magick
-The "magick" command is the new primary command of the Shell
+
+magick
+The "magick" command is the new primary command of the Shell
API, replacing the old "convert" command. This allows you to
create a 'magick script' of the form "#!/path/to/command/magick
-script", or pipe options into a command "magick -script
-, as abackground process.

-magick-script
-This the same as "magick", (only command name is different)
+
magick-script
+This the same as "magick", (only command name is different)
but which has an implicit "-script" option. This allows you to
use it in an "env" style script form. That is a magick script
starts with the 'she-bang' line of "#!/usr/bin/env
@@ -414,27 +414,27 @@ be applied to expand the one channel into separate RGB (or other) channels.
on the users command "PATH". This is required to get around
a "one argument she-bang bug" that is common on most UNIX systems
(including Linux, but not MacOSX).

-animate, compare, composite, conjure, convert, display, identify, import, mogrify, montage, stream
-To reduce the footprint of the command-line utilities, these utilities are symbolic links to the magick utility. You can also invoke them from the magick utility, for example, use magick convert logo: logo.png to invoke the convert utility.
+
animate, compare, composite, conjure, convert, display, identify, import, mogrify, montage, stream
+To reduce the footprint of the command-line utilities, these utilities are symbolic links to the magick utility. You can also invoke them from the magick utility, for example, use magick convert logo: logo.png to invoke the convert utility.

Behavioral Changes
Image settings are applied to each image on the command line. To associate a setting with a particular image, use parenthesis to remove ambiguity. In this example we assign a unique page offset to each image:
-+
convert $ -page +10+20 first.png $ $ -page +100+200 second.png $ ...
-

+

By default, image operations such as convolution blends alpha with each channel. To convolve each channel independently, deactivate the alpha channel as follows:
-+
convert ... -alpha discrete -blur 0x1 ...
-

+
To remove the alpha values from your image, use -alpha off.
Some options have changed in ImageMagick version 7. These include:

--channel
-the default is to update the RGBA channels, previously, in IMv6, the default was RGB. If you get results that differ from IMv6, you may need to specify -channel RGB on your command line (e.g. -level-colors option).
-+combine
-This option now requires an argument, the image colorspace (e.g. +combine sRGB).
+-channel
+the default is to update the RGBA channels, previously, in IMv6, the default was RGB. If you get results that differ from IMv6, you may need to specify -channel RGB on your command line (e.g. -level-colors option).
++combine
+This option now requires an argument, the image colorspace (e.g. +combine sRGB).

New Options
@@ -442,132 +442,132 @@ convert ... -alpha discrete -blur 0x1 ...
to the "magick" command, or to use in "magick"
scripts.

-
-{ ... }
-Save (and restore) the current image settings (internally known as the
+
+{ ... }
+Save (and restore) the current image settings (internally known as the
"image_info" structure). This is automatically done with parenthesis (EG:
'(' and ')') is "-regard-parenthesis" has
been set, just as in IMv6. Caution is advised to prevent un-balanced
braces errors.

---
-End of options, to be used in IMv7 "mogrify" command to
+
--
+End of options, to be used in IMv7 "mogrify" command to
explicitly separate the operations to be applied and the images that
are to be processed 'in-place'. (not yet implemented). However if
not provided, "-read" can still be used to differentiate
secondary image reads (for use in things like alpha composition) from
the 'in-place' image being processed.

-In other commands (such as "magick") it is equivalent to a explicit
+
In other commands (such as "magick") it is equivalent to a explicit
"-read" (see below) of the next option as a image (as it was in
IMv6).

--alpha discrete
-treat the alpha channel independently (do not blend).
+-alpha discrete
+treat the alpha channel independently (do not blend).

--channel-fx expression
-
+
-channel-fx expression
+
exchange, extract, or copy one or more image channels.

The expression consists of one or more channels, either mnemonic or numeric (e.g. red or 0, green or 1, etc.), separated by certain operation symbols as follows:

-+
<=> exchange two channels (e.g. red<=>blue)
=> copy one channel to another channel (e.g. red=>green)
= assign a constant value to a channel (e.g. red=50%)
, write new image with channels in the specified order (e.g. red, green)
; add a new output image for the next set of channel operations (e.g. red; green; blue)
| move to the next input image for the source of channel data (e.g. | gray=>alpha)
-

+

For example, to create 3 grayscale images from the red, green, and blue channels of an image, use:

-+
-channel-fx "red; green; blue"
-

+

A channel without an operation symbol implies separate (i.e, semicolon).

Here we take an sRGB image and a grayscale image and inject the grayscale image into the alpha channel:
-+
convert wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png
-

+
Use a similar command to define a read mask:
-+
convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
-

+

Add -debug pixel prior to the -channel-fx option to track the channel morphology.

--exit
-Stop processing at this point. No further options will be processed after
+
-exit
+Stop processing at this point. No further options will be processed after
this option. Can be used in a script to force the "magick"
command to exit, without actually closing the pipeline that it is
processing options from.

-May also be used as a 'final' option on the "magick" command
+
May also be used as a 'final' option on the "magick" command
line, instead of a implicit output image, to completely prevent any image
write. ASIDE: even the "NULL:" coder requires at least one
image, for it to 'not write'! This option does not require any images at
all.

--read {image}
-Explicit read of an image, rather than an implicit read. This allows you
+
-read {image}
+Explicit read of an image, rather than an implicit read. This allows you
to read from filenames that start with an 'option' character, and which
otherwise could be mistaken as an option (unknown or otherwise). This will
eventually be used in "mogrify" to allow the reading of
secondary images, and allow the use of image list operations within that
command.

--read-mask
-prevent updates to image pixels specified by the mask
+-read-mask
+prevent updates to image pixels specified by the mask

--region
-supported in ImageMagick 7.0.2-6 and above
+-region
+supported in ImageMagick 7.0.2-6 and above

--script {file}
-In "magick", stop the processing of command line arguments as
+
-script {file}
+In "magick", stop the processing of command line arguments as
image operations, and read all further options from the given file or
pipeline.
--write-mask
-prevent pixels from being written.
+-write-mask
+prevent pixels from being written.

Changed Options
These options are known to have changed, in some way.
-
--bias
-The option is no longer recognized. Use -define convolve:bias=value instead.
--draw
-The matte primitive is now alpha (e.g. -draw 'alpha 0,0 floodfill').
--negate
-currently negates all channels, including alpha if present. As such you
+
+-bias
+The option is no longer recognized. Use -define convolve:bias=value instead.
+-draw
+The matte primitive is now alpha (e.g. -draw 'alpha 0,0 floodfill').
+-negate
+currently negates all channels, including alpha if present. As such you
may need to use the -channel option to prevent alpha negation.

Deprecated warning given, but will work (for now)
-
--affine
-Replaced by -draw "affine ...". (see transform)
--average
-Replaced by -evaluate-sequence Mean.
--box
-Replaced by -undercolor.
--deconstruct
-Replaced by -layers CompareAny.
--gaussian
-Replaced by -gaussian-blur.
--/+map
-Replaced by -/+remap.
--/+mask
-Replaced by -/+read-mask, -/+write-mask.
--/+matte
-Replaced by -alpha Set/Off.
--transform
-Replaced by -distort Affine "...".
+
+-affine
+Replaced by -draw "affine ...". (see transform)
+-average
+Replaced by -evaluate-sequence Mean.
+-box
+Replaced by -undercolor.
+-deconstruct
+Replaced by -layers CompareAny.
+-gaussian
+Replaced by -gaussian-blur.
+-/+map
+Replaced by -/+remap.
+-/+mask
+Replaced by -/+read-mask, -/+write-mask.
+-/+matte
+Replaced by -alpha Set/Off.
+-transform
+Replaced by -distort Affine "...".

Deprecated warning given, and ignored (for now)
@@ -575,32 +575,32 @@ convert wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
deprecated, and does nothing. It does not even have associated code. For
example "+annotate", "+resize", "+clut", and "+draw" .

-
--affinity
-Replaced by -remap.
--maximum
-Replaced by -evaluate-sequence Max.
--median
-Replaced by -evaluate-sequence Median.
--minimum
-Replaced by -evaluate-sequence Min.
--recolor
-Replaced by -color-matrix.
+
+-affinity
+Replaced by -remap.
+-maximum
+Replaced by -evaluate-sequence Max.
+-median
+Replaced by -evaluate-sequence Median.
+-minimum
+Replaced by -evaluate-sequence Min.
+-recolor
+Replaced by -color-matrix.

Removed / Replaced Options ("no such option" error and abort)

-
--interpolate filter
-remove slow and useless interpolation method
--origin
-old option, unknown meaning.
--pen
-Replaced by -fill.
--passphrase
-old option, unknown meaning
+
+-interpolate filter
+remove slow and useless interpolation method
+-origin
+old option, unknown meaning.
+-pen
+Replaced by -fill.
+-passphrase
+old option, unknown meaning

-Version 7 Change Summary
+Version 7 Change Summary
Changes from ImageMagick version 6 to version 7 are summarized here:
High Dynamic Range Imaging

@@ -664,4 +664,4 @@ example "+annotate", "+resize", "+clut", and "+draw" .

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/quantize.html b/www/quantize.html
index ca3e5ae9c..f82c32ee3 100644
--- a/www/quantize.html
+++ b/www/quantize.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Algorithm Description â¢ Measuring Color Reduction Error

This document describes how ImageMagick performs color reduction on an image. To fully understand what follows, you should have a knowledge of basic imaging techniques and the tree data structure and terminology.

-Algorithm Description
+Algorithm Description

For purposes of color allocation, an image is a set of n pixels, where each pixel is a point in RGB space. RGB space is a 3-dimensional vector space, and each pixel, p(i), is defined by an ordered triple of red, green, and blue coordinates, (r(i), g(i), b(i)).

@@ -85,14 +85,14 @@

Classification begins by initializing a color description tree of sufficient depth to represent each possible input color in a leaf. However, it is impractical to generate a fully-formed color description tree in the classification phase for realistic values of Cmax. If color components in the input image are quantized to k-bit precision, so that Cmax = 2^k-1, the tree would need k levels below the root node to allow representing each possible input color in a leaf. This becomes prohibitive because the tree's total number of nodes:

-+
total nodes = 1+Sum(8^i), i=1,k

For k=8,
nodes = 1 + (8^1+8^2+....+8^8)
= 1 + 8(8^8 - 1)/(8 - 1)
= 19,173,961
-

+

Therefore, to avoid building a fully populated tree, ImageMagick:

@@ -101,37 +101,37 @@ nodes = 1 + (8^1+8^2+....+8^8)
chooses a maximum depth for the tree as a function of the desired number of colors in the output image (currently the base-two logarithm of Cmax).

-+
For Cmax=255,
maximum tree depth = log₂(256)
= 8
-

+

A tree of this depth generally allows the best representation of the source image with the fastest computational speed and the least amount of memory. However, the default depth is inappropriate for some images. Therefore, the caller can request a specific tree depth.

For each pixel in the input image, classification scans downward from the root of the color description tree. At each level of the tree, it identifies the single node which represents a cube in RGB space containing the pixels' color. It updates the following data for each such node:

-
-n1
- number of pixels whose color is contained in the RGB cube which this node represents;
-n2
- number of pixels whose color is not represented in a node at lower depth in the tree; initially, n2=0 for all nodes except leaves of the tree.
-Sr,Sg,Sb
- sums of the red, green, and blue component values for all pixels not classified at a lower depth. The combination of these sums and n2 will ultimately characterize the mean color of a set of pixels represented by this node.
-E
- the distance squared in RGB space between each pixel contained within a node and the nodes' center. This represents the quantization error for a node.
+
+n1
+ number of pixels whose color is contained in the RGB cube which this node represents;
+n2
+ number of pixels whose color is not represented in a node at lower depth in the tree; initially, n2=0 for all nodes except leaves of the tree.
+Sr,Sg,Sb
+ sums of the red, green, and blue component values for all pixels not classified at a lower depth. The combination of these sums and n2 will ultimately characterize the mean color of a set of pixels represented by this node.
+E
+ the distance squared in RGB space between each pixel contained within a node and the nodes' center. This represents the quantization error for a node.

Reduction

Reduction repeatedly prunes the tree until the number of nodes with n2 > 0 is less than or equal to the maximum number of colors allowed in the output image. On any given iteration over the tree, it selects those nodes whose E value is minimal for pruning and merges their color statistics upward. It uses a pruning threshold, Ep, to govern node selection as follows:

-+
Ep = 0
while number of nodes with (n2 > 0) > required maximum number of colors
prune all nodes such that E <= Ep
Set Ep to minimum E in remaining nodes
-

+

This has the effect of minimizing any quantization error when merging two nodes together.

@@ -156,7 +156,7 @@ while number of nodes with (n2 > 0) > required maximum number of colors

Empirical evidence suggests that the distances in color spaces such as YUV, or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Here the algorithm is as described except each pixel is a point in the alternate color space. For convenience, the color components are normalized to the range 0 to a maximum value, Cmax. The color reduction can then proceed as described.

-Measuring Color Reduction Error
+Measuring Color Reduction Error

Depending on the image, the color reduction error may be obvious or invisible. Images with high spatial frequencies (such as hair or grass) will show error much less than pictures with large smoothly shaded areas (such as faces). This because the high-frequency contour edges introduced by the color reduction process are masked by the high frequencies in the image.

@@ -167,7 +167,7 @@ while number of nodes with (n2 > 0) > required maximum number of colors
These errors are measured and printed when the -colors and -verbose options are specified on the convert command line:

-
+
diff --git a/www/resources.html b/www/resources.html
index ad0bb8a59..d9da90436 100644
--- a/www/resources.html
+++ b/www/resources.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Configuration Files â¢ Modules â¢ Fonts â¢ Environment Variables

ImageMagick depends on a number of external resources including configuration files, loadable modules, fonts, and environment variables.

-Configuration Files
+Configuration Files

ImageMagick depends on a number of external configuration files detailed here:

-
-coder.xml
- Associate an image format with the specified coder module.
+
+coder.xml
+ Associate an image format with the specified coder module.

ImageMagick has a number of coder modules to support the reading and/or writing of an image format (e.g. JPEG). Some coder modules support more than one associated image format and the mapping between an associated format and its respective coder module is defined in this configuration file. For example, the PNG coder module not only supports the PNG image format, but the JNG and MNG formats as well.

-colors.xml
- Associate a color name with its red, green, blue, and alpha intensities.
+
colors.xml
+ Associate a color name with its red, green, blue, and alpha intensities.

A number of command line options require a color parameter. It is often convenient to refer to a color by name (e.g. white) rather than by hex value (e.g. #fff). This file maps a color name to its equivalent red, green, blue, and alpha intensities (e.g. for white, red = 255, green = 255, blue = 255, and alpha = 0).

-configure.xml
- Set ImageMagick build parameters and system-wide environment variables (e.g. MAGICK_TEMPORARY_PATH).
+
configure.xml
+ Set ImageMagick build parameters and system-wide environment variables (e.g. MAGICK_TEMPORARY_PATH).
As ImageMagick is built, a number of build parameters are saved to this configuration file. They include the version, release date, dependent delegate libraries, and quantum depth among others.

-delegates.xml
- Associate delegate programs with certain image formats.
+
delegates.xml
+ Associate delegate programs with certain image formats.

ImageMagick relies on a number of delegate programs to support certain image formats such as ufraw-batch to read raw camera formats or Ghostscript to read Postscript images. Use this configuration file to map an input or output format to an external delegate program.

-english.xml
- Associate message tags with English translations.
+english.xml
+ Associate message tags with English translations.

-francais.xml
- Associate message tags with French translations.
+francais.xml
+ Associate message tags with French translations.

-locale.xml
- Associate message tags with a translation for your locale.
+
locale.xml
+ Associate message tags with a translation for your locale.

ImageMagick has a number of informational, warning, and error messages that are represented as tags. Tags are short descriptions of a message such as
FileNotFound or MemoryAllocationFailed. This configuration file lists locales that have a translation for each tag recognized by ImageMagick. Currently only English and French translations are available in the english.xml and francais.xml configuration files.

-log.xml
- Configure logging parameters.
+
log.xml
+ Configure logging parameters.
ImageMagick is capable of spewing copious amounts of informational or debugging statements. Use this file to configure how the information will appear in a log message and where you want the logging messages posted.

-magic.xml
- Associate an image format with a unique identifier.
+
magic.xml
+ Associate an image format with a unique identifier.
Many image formats have identifiers that uniquely identify a particular image format. For example, the GIF image format always begins with GIF8 as the first 4 characters of the image. ImageMagick uses this information to quickly determine the type of image it is dealing with when it reads an image.

-mime.xml
- Associate an internet media type with a unique identifier.
+
mime.xml
+ Associate an internet media type with a unique identifier.
Many files and data streams have identifiers that uniquely identify a
particular internet media type. For example, files in the "Corel Draw
drawing" format (mime type="application/vnd.corel-draw") are associated with
@@ -123,65 +123,65 @@ when available, to attempt to quickly determine the internet media type of a
file or data stream.

-policy.xml
- Configure ImageMagick policies.
- By default any coder, delegate, filter, or file path is permitted. Use a policy to deny access to, for example, the MPEG video delegate, or permit reading images from a file system but deny writing to that same file system. Or use the resource policy to set resource limits. Policies are useful for multi-user servers that want to limit the overall impact ImageMagick has on the system. For example, to limit the maximum image size in memory to 100MB:
+
policy.xml
+ Configure ImageMagick policies.
+ By default any coder, delegate, filter, or file path is permitted. Use a policy to deny access to, for example, the MPEG video delegate, or permit reading images from a file system but deny writing to that same file system. Or use the resource policy to set resource limits. Policies are useful for multi-user servers that want to limit the overall impact ImageMagick has on the system. For example, to limit the maximum image size in memory to 100MP:

--<policy domain="resource" name="area" value="100KP"/>
-
+
+<policy domain="resource" name="area" value="100MP"/>
+

Any image larger than this area limit is cached to disk rather than memory.

Use width to limit the maximum width of an image in pixels. Exceed this limit and an exception is thrown and processing stops.

-+
<policy domain="resource" name="width" value="8KP"/>
-

+

To limit the elapsed time of any ImageMagick command to 5 minutes, use this policy:

-+
<policy domain="resource" name="time" value="300"/>
-

+
Define arguments for the memory, map, and disk resources with SI prefixes (.e.g 100MB). In addition, resource policies are maximums for each instance of ImageMagick (e.g. policy memory limit 1GB, the -limit 2GB option exceeds policy maximum so memory limit is 1GB).

-quantization-table.xml
- Custom JPEG quantization tables. Activate with -define:q-table=quantization-table.xml.
+quantization-table.xml
+ Custom JPEG quantization tables. Activate with -define:q-table=quantization-table.xml.

-thresholds.xml
- Set threshold maps for ordered posterized dither.
+thresholds.xml
+ Set threshold maps for ordered posterized dither.

-type.xml
- Configure fonts.
+
type.xml
+ Configure fonts.
Define the font name, family, foundry, style, format, metrics, and glyphs for any font you want to use within ImageMagick.

-type-ghostscript.xml
- Configure Ghostscript fonts.
+
type-ghostscript.xml
+ Configure Ghostscript fonts.
The Ghostscript package includes a number of fonts that can be accessed with ImageMagick.

-type-windows.xml
- Associate names with Windows font glyphs.
+type-windows.xml
+ Associate names with Windows font glyphs.

Under Unix and Linux, ImageMagick searches for each of the configuration files listed above by looking in the locations given below, in order, and loads them if found:

-+
$MAGICK_CONFIGURE_PATH
$PREFIX/etc/ImageMagick-7
$PREFIX/share/ImageMagick-7
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick
<client path>/etc/ImageMagick
-

+

The environmental variable $PREFIX is the default install path (e.g. /usr/local). The client path is the execution path of your ImageMagick client (e.g. /usr/local) .

For the Unix or Linux pre-compiled uninstalled binary distributions, the configuration load order is:

-+
$MAGICK_CONFIGURE_PATH
$MAGICK_HOME/etc/ImageMagick-7
$MAGICK_HOME/share/ImageMagick-7
@@ -190,79 +190,79 @@ $XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick/
<client path>/etc/ImageMagick
<current directory>
-

+

Under Windows, ImageMagick searches for these configuration files in the following order, and loads them if found:

-+
$MAGICK_CONFIGURE_PATH
<windows registry>
$PREFIX/config
$USERPROFILE/.config/ImageMagick
<client path>
-

+

-Above, $PREFIX is the default install path, typically c:\\Program Files\\ImageMagick-7.0.5.
+Above, $PREFIX is the default install path, typically c:\\Program Files\\ImageMagick-7.0.6.

For an uninstalled Windows installation, the configuration load order is:

-+
$MAGICK_CONFIGURE_PATH
$MAGICK_HOME
$USERPROFILE/.config/ImageMagick
client path
<current directory>
-

+

If a configuration file cannot not be found, ImageMagick relies on built-in default values.

-Modules
+Modules

Coders
An image coder (i.e. encoder / decoder) is responsible for registering, optionally classifying, optionally reading, optionally writing, and unregistering one image format (e.g. PNG, GIF, JPEG, etc.). ImageMagick searches for coders in the following order and it uses the first match found:

--$MAGICK_HOME/lib/ImageMagick-7.0.5/modules-Q16/coders
-<client path>/../lib/ImageMagick-7.0.5/modules-Q16/coders
-$MAGICK_HOME/lib/ImageMagick-7.0.5/modules-Q16/coders
-$MAGICK_HOME/share/ImageMagick-7.0.5/modules-Q16/coders
+
+$MAGICK_HOME/lib/ImageMagick-7.0.6/modules-Q16/coders
+<client path>/../lib/ImageMagick-7.0.6/modules-Q16/coders
+$MAGICK_HOME/lib/ImageMagick-7.0.6/modules-Q16/coders
+$MAGICK_HOME/share/ImageMagick-7.0.6/modules-Q16/coders
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick
-<client path>/lib/ImageMagick-7.0.5/modules-Q16/coders
-

+<client path>/lib/ImageMagick-7.0.6/modules-Q16/coders
+

Filters
ImageMagick provides a convenient mechanism for adding your own custom image processing algorithms. ImageMagick searches for filters in the following order and it uses the first match found:
--$MAGICK_HOME/lib/ImageMagick-7.0.5/modules-Q16/filters
-<client path>/../lib/ImageMagick-7.0.5/modules-Q16/filters
-$MAGICK_HOME/lib/ImageMagick-7.0.5/modules-Q16/filters
-$MAGICK_HOME/share/ImageMagick-7.0.5/modules-Q16/filters
+
+$MAGICK_HOME/lib/ImageMagick-7.0.6/modules-Q16/filters
+<client path>/../lib/ImageMagick-7.0.6/modules-Q16/filters
+$MAGICK_HOME/lib/ImageMagick-7.0.6/modules-Q16/filters
+$MAGICK_HOME/share/ImageMagick-7.0.6/modules-Q16/filters
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick
-<client path>/lib/ImageMagick-7.0.5/modules-Q16/filters
-

+<client path>/lib/ImageMagick-7.0.6/modules-Q16/filters
+

-Fonts
+Fonts

ImageMagick is able to load raw TrueType and Postscript font files. It searches for the font configuration file, type.xml, in the following order, and loads them if found:

-+
$MAGICK_CONFIGURE_PATH
-$MAGICK_HOME/etc/ImageMagick/-7.0.5
-$MAGICK_HOME/share/ImageMagick-7.0.5
+$MAGICK_HOME/etc/ImageMagick/-7.0.6
+$MAGICK_HOME/share/ImageMagick-7.0.6
$XDG_CACHE_HOME/ImageMagick
$HOME/.config/ImageMagick
<client path>/etc/ImageMagick
$MAGICK_FONT_PATH
-

+

-Environment Variables
+Environment Variables

Environment variables recognized by ImageMagick include:

-

mean error per pixel
is the mean error for any single pixel in the image.

+
@@ -383,4 +383,4 @@ $MAGICK_FONT_PATH

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/search.html b/www/search.html
index 62b4ccd2e..d8926de2b 100644
--- a/www/search.html
+++ b/www/search.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

diff --git a/www/security-policy.html b/www/security-policy.html
index 7d73a265d..05d5d73a1 100644
--- a/www/security-policy.html
+++ b/www/security-policy.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Security Policy â¢ Zero Configuration Security Policy â¢ Other Security Considerations

@@ -64,7 +64,7 @@

As an example, suppose you download an image from the internet and unbeknownst to you its been crafted to generate a 20000 by 20000 pixel image. ImageMagick attempts to allocate enough resources (memory, disk) and your system will likely deny the resource request and exit. However, its also possible that your computer might be temporarily sluggish or unavailable or ImageMagick may abort. To prevent such a scenario, you can set limits in the policy.xml configuration file. You may ask why ImageMagick does not already include reasonable limits? Simply because what is reasonable in your environment, might not be reasonable to someone else. For example, you may have ImageMagick sandboxed where security is not a concern, whereas another user may use ImageMagick to process images on their publically accessible website. Or ImageMagick is running on a host with 1TB of memory whereas another ImageMagick instance is running on an iPhone. By policy, permitting giga-pixel image processing on the large memory host makes sense, not so much for the resource constrained iPhone. If you utilize ImageMagick from a public website, you may want to increase security by preventing usage of the MVG or HTTPS coders. Only you can decide what are reasonable limits taking in consideration your environment. We provide this policy with reasonable limits and encourage you to modify it to suit your local environment:

-+
<policymap>
<policy domain="resource" name="temporary-path" value="/tmp"/>
<policy domain="resource" name="memory" value="256MiB"/>
@@ -83,37 +83,37 @@
<policy domain="delegate" rights="none" pattern="HTTPS" />
<policy domain="path" rights="none" pattern="@*"/>
</policymap>
-

+

Since we process multiple simultaneous sessions, we do not want any one session consuming all the available memory.With this policy, large images are cached to disk. If the image is too large and exceeds the pixel cache disk limit, the program exits. In addition, we place a time limit to prevent any run-away processing tasks. If any one image has a width or height that exceeds 8192 pixels, an exception is thrown and processing stops. As of ImageMagick 7.0.1-8 and 6.9.4-6, you can prevent the use of any delegate or all delegates (set the pattern to "*"). Note, prior to these releases, use a domain of coder to prevent delegate usage (e.g. domain="coder" rights="none" pattern="HTTPS"). The policy also prevents indirect reads. If you want to, for example, read text from a file (e.g. caption:@myCaption.txt), you'll need to disable the path policy.

Here is what you can expect when you restrict the HTTPS coder, for example:

-+
$ convert https://www.imagemagick.org/images/wizard.png wizard.jpg
convert: not authorized `HTTPS'
convert: unable to open file: No such file or directory
convert: no images defined `wizard.jpg'
-

+

As of ImageMagick version 7.0.4-7, you can conveniently deny access to all delegates and coders except for a small subset of proven web-safe image types. For example,

-+
<policy domain="delegate" rights="none" pattern="*" />
<policy domain="coder" rights="none" pattern="*" />
<policy domain="coder" rights="read | write" pattern="{GIF,JPEG,PNG,WEBP}" />
-

+

As of ImageMagick 7.0.5-5, you can allocate the pixel cache and some internal buffers with anonymous memory mapping rather than from heap. As a consequence, the pixels are initialized to zero. You can also securely delete any temporary files for increased security. The value is the number of times to shred (replace its content with random data) before deleting a temporary file. For example,
-+
<policy domain="system" name="memory-map" value="anonymous"/>
<policy domain="cache" name="memory-map" value="anonymous"/>
<policy domain="system" name="shred" value="1"/>
-

+

You can verify your policy changes are in effect with this command:

-+
-> identify -list policy
Path: ImageMagick/policy.xml
Policy: Resource
@@ -159,24 +159,27 @@ Path: ImageMagick/policy.xml
Path: [built-in]
Policy: Undefined
rights: None
-

+
Notice the Cache policy is not listed due to the stealth property.

+As of ImageMagick 7.0.6-0, you can programmatically set the ImageMagick security policy with SetMagickSecurityPolicy() (MagickCore) or MagickSetSecurityPolicy() (MagickWand).
+
For additional details about resource limits and the policy configuration file, read Resources and Architecture.

-Zero Configuration Security Policy
+Zero Configuration Security Policy

A zero configuration build of ImageMagick does not permit external configuration files. To define your security policy, you must instead edit the MagickCore/policy-private.h source module, add your policy statements, and then build the ImageMagick distribution. Here is an example zero configuration security policy:

-+
static const char
*ZeroConfigurationPolicy = \
"<policymap> \
<policy domain=\"coder\" rights=\"none\" pattern=\"MVG\"/> \
</policymap>";
-

+
+

-Other Security Considerations
+Other Security Considerations

If you spot a security flaw in ImageMagick, contact us and select Security Issue as the issue. Alternatively, post your concern to GitHub. Be sure to include how to reproduce the security flaw and a link to any images needed to reproduce the flaw.

@@ -209,4 +212,4 @@ static const char

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/sitemap.html b/www/sitemap.html
index e8345ebdf..e7db919e4 100644
--- a/www/sitemap.html
+++ b/www/sitemap.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick Overview â¢ Download ImageMagick â¢ Install ImageMagick â¢ Command-line Tools â¢ Program Interfaces â¢ Image Formats â¢ Getting Help â¢ Support ImageMagick â¢ Miscellaneous Topics

Use this ImageMagick sitemap to quickly jump to one of the areas of interest listed below. If you can't find what you want on this page, try our site search.

-ImageMagick Overview
+ImageMagick Overview

Introduction: convert, edit, or compose images from the command-line or program interface.
@@ -79,7 +79,7 @@
History: how ImageMagick was conceived and developed.

-Download ImageMagick
+Download ImageMagick

Download ImageMagick: ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors.
@@ -93,7 +93,7 @@

-Install ImageMagick
+Install ImageMagick

You can install ImageMagick from source. However, if you don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable.

@@ -102,7 +102,7 @@
Install ImageMagickObject COM+ component: install the Windows ImageMagick COM+ component.

-Command-line Tools
+Command-line Tools

Command-line tools: overview of the ImageMagick commands.

@@ -124,7 +124,7 @@
Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations.

-Program Interfaces
+Program Interfaces

Program interfaces: application programming interfaces.
@@ -148,7 +148,7 @@

-Image Formats
+Image Formats

Supported image formats: annotated list of all image formats that ImageMagick can read and/or write.
Motion picture digital images: use SMPTE DPX Version 2.0 to process images used by the motion picture (film and high-definition) industry.
@@ -157,7 +157,7 @@
Magick Image File Format: MIFF is ImageMagick's own platform-independent format for storing bitmap images.

-Getting Help
+Getting Help

Definitive Guide to ImageMagick: this book explains ImageMagick in a practical, learn-by-example fashion.
@@ -166,14 +166,14 @@
Contact the Wizards: for bug reports (only if you do not want to sign up to the discourse server), a source or documentation patch, a security or license issue, or if you want to be a sponsor of the ImageMagick project.

-Support ImageMagick
+Support ImageMagick

Report bugs and vulnerabilities: our highest priority is to fix security defects and bug reports, usually within 48 hours of your report. The bug discourse server requires that you register. If you do not want to register, you can contact the ImageMagick developers with a convenient web form.
Sponsor ImageMagick: contribute bug fixes, enhancements, hardware, funds, etc. to ensure the ImageMagick project thrives.

-Miscellaneous Topics
+Miscellaneous Topics

Animation: create a GIF animation sequence from a group of images.
@@ -214,7 +214,7 @@
Transparency: render portions of an image invisible.
Virtual pixel support: convenient access to pixels outside the image region.

-ImageMagick Legacy
+ImageMagick Legacy
We continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org

@@ -237,4 +237,4 @@

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/stream.html b/www/stream.html
index d43d26225..8e2afaf3c 100644
--- a/www/stream.html
+++ b/www/stream.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Example Usage â¢ Option Summary

Stream is a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

-Example Usage
+Example Usage

We list a few examples of the stream command here to illustrate its usefulness and ease of use. To get started, lets stream the red, green, blue components of a 640x480 JPEG image to disk as unsigned characters:

-+
magick stream -map rgb -storage-type char image.jpg pixels.dat
magick display -depth 8 -size 640x480 rgb:pixels.dat
-

+

Here we extract a 100x100 region from a TIFF image in the grayscale format as doubles:

-+
magick stream -map i -storage-type double -extract 100x100+30+40 image.tif gray.raw
-

+

You can also associate the region to extract with the image filename:

-+
magick stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw
-

+

-Option Summary
+Option Summary

The stream command recognizes these options. Click on an option to get more details about how that option works.

-

HOME
Set path to search for configuration files in $HOME/.config/ImageMagick if the directory exists.

+
@@ -272,4 +272,4 @@ magick stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/subversion.html b/www/subversion.html
index 93752b1cc..10090af9d 100644
--- a/www/subversion.html
+++ b/www/subversion.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+
-
+
-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

The ImageMagick stable and development source releases are available from Subversion. This a convenient way for developers to download the ImageMagick source, fix bugs, or add new features.

To retrieve, or check out ImageMagick stable, use this command:

- svn co https://subversion.imagemagick.org/subversion/ImageMagick/branches/ImageMagick-7.0.5 ImageMagick-7.0.5
+ svn co https://subversion.imagemagick.org/subversion/ImageMagick/branches/ImageMagick-7.0.6 ImageMagick-7.0.6
To retrieve, or check out ImageMagick development, use this command:

-+
svn co https://subversion.imagemagick.org/subversion/ImageMagick/trunk ImageMagick
-

+

To update the sources within a previously checked out directory, execute:

-+
svn update
-

+

and only the files which have changed are updated.

@@ -96,4 +96,4 @@ svn update

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/support.html b/www/support.html
index b76971f71..870101be3 100644
--- a/www/support.html
+++ b/www/support.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

Contribute a Bug Fix or Enhancement â¢ Support the ImageMagick Project

@@ -65,16 +65,16 @@
We want to thank the following sponsors of the ImageMagick project, including:

- We manage everything so you don't have to

- Enabling today. Inspiring tomorrow.

- The world's most versatile file uploading and processing service

- BoundForHealth – Change Course. Cure disease. Be well.

+ We manage everything so you don't have to

+ Enabling today. Inspiring tomorrow.

+ The world's most versatile file uploading and processing service

+ BoundForHealth – Change Course. Cure disease. Be well.

-Contribute a Bug Fix or Enhancement
+Contribute a Bug Fix or Enhancement
Post any ImageMagick patches to the Issues forum if you think you have found and fixed a bug or security vulnerability. Post to the Developers forum if you want to propose an enhancement for discussion.

-Support the ImageMagick Project
+Support the ImageMagick Project

ImageMagick has been available for free since the early 1990's. It has consistently been one of the most comprehensive free image processing packages available, but, unlike competing packages, it continues to be supported and enhanced. Today, ImageMagick is more comprehensive and better supported than ever.
ImageMagick has enjoyed considerable support from commercial users. Since ImageMagick is not restricted from use in commercial or proprietary applications, it is used to support thousands of commercial web sites and is used in professional digital image and movie studios as well as publishing shops. It is also used as a component of a number of commercial applications. Many of these commercial users have made contributions to ImageMagick, large and small, often anonymous, but always appreciated.
@@ -110,24 +110,23 @@
Flattr is a microdonation system. You donate a small amount every month and
click Flattr buttons on worthy sites to share the donation among those sites, similar to a tip jar (for more details see Wikipedia's Flattr article).

-
-
+

Litecoin
Our Litecoin Address is: LcZLAmym4EMvUPc9koagkccRLYQbsgGwmj. Or you can reference the below QR code:

-
+

Check
Check, in USD funds, made payable to
ImageMagick Studio LLC, and send to:

-+
ImageMagick Studio LLC
P.O. Box 40
Landenberg, PA 19350
USA
-

+

@@ -155,4 +154,4 @@ USA

-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/www/webp.html b/www/webp.html
index 7f1d2f817..54f3c9ea0 100644
--- a/www/webp.html
+++ b/www/webp.html
@@ -25,14 +25,13 @@

-
-
-
+
+
+

-
+

-

(adsbygoogle = window.adsbygoogle || []).push({});

-
- Home
- Download
- Tools
- Command-line
- Resources
- Develop
- Search
- Community
+
+ Home
+ Download
+ Tools
+ Command-line
+ Resources
+ Develop
+ Search
+ Community

+

ImageMagick's WebP image format accepts a plethora of encoding options as detailed below. As an example, suppose you are interested in these options:

@@ -66,14 +66,14 @@

Use this command:

-+
convert wizard.png -quality 50 -define webp:lossless=true wizard.webp
-

+

Here is a complete list of WebP encoding options:

-

Option

+
@@ -182,4 +182,4 @@ convert wizard.png -quality 50 -define webp:lossless=true wizard.webp

-
\ No newline at end of file
+
\ No newline at end of file

alpha-compression=value
encode the alpha plane: 0 = none, 1 = compressed.}