ImageMagick: Application Program Interfaces

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,

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

+ +

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: G2F implements an Ada 95 binding to a subset of the low-level MagickCore library.
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.
Ch: ChMagick is a Ch binding to the MagickCore and MagickWand API. Ch is an embeddable C/C++ interpreter for cross-platform scripting.
COM+: Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.
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.
GO: GoImagick is a set of Go bindings to ImageMagick's MagickWand and MagickCore C APIs.
Java: JMagick provides an object-oriented Java interface to ImageMagick. Im4java is a pure-java interface to the ImageMagick command-line.
LabVIEW: LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.
Lisp: CL-Magick provides a Common Lisp interface to the ImageMagick library.
Lua: Lua bindings to ImageMagick for LuaJIT using FFI.
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: 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.
Pascal: PascalMagick a Pascal binding for the MagickWand API and also the low-level MagickCore library. It works with Free Pascal / Lazarus and Delphi.
Perl: Use PerlMagick to convert, compose, and edit images from the Perl language.
PHP: 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.; 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: 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.
REALbasic: The MBS Realbasic ImageMagick is a plugin that utilizes the power of ImageMagick from within the RealBasic environment.
Ruby: RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.; 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.; QuickMagick is a gem for easily accessing ImageMagick command line tools from Ruby programs.
Rust: RustWand is a MagickWand bindings for the Rust language.
Tcl/Tk: TclMagick a native Tcl-extension to the ImageMagick MagickWand API.
XML RPC: RemoteMagick is an XML-RPC web service that creates image thumbnails.

+ +

+ + + +

DefineImageProperty

DefineImageProperty() associates an assignment string of the form "key=value" with an artifact or options. It is equivelent to SetImageProperty().

DefineImageProperty() associates an assignment string of the form "key=value" with an artifact or options. It is equivelent to SetImageProperty()

The XShearImage

The XShearImage() and YShearImage() methods are based on the paper "A Fast Algorithm for General Raster Rotatation" by Alan W. Paeth, Graphics Interface '86 (Vancouver). ShearRotateImage() is adapted from a similar method based on the Paeth paper written by Michael Halle of the Spatial Imaging Group, MIT Media Lab.

The XShearImage() and YShearImage() methods are based on the paper "A Fast Algorithm for General Raster Rotation" by Alan W. Paeth, Graphics Interface '86 (Vancouver). ShearRotateImage() is adapted from a similar method based on the Paeth paper written by Michael Halle of the Spatial Imaging Group, MIT Media Lab.

DeskewImage

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:

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

+ +

Unix Binary Release â¢ Mac OS X Binary Release â¢ iOS Binary Release â¢ Windows Binary Release

+ +

You can install ImageMagick from source. However, if 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

+ +

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.

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Version	HTTP	FTP	Description
ImageMagick-7.0.0-0.x86_64.rpm	download	download	Redhat / CentOS 7.1 x86_64 RPM
ImageMagick-7.0.0-0.i386.rpm	download	download	Redhat / CentOS 5.11 i386 RPM
ImageMagick RPM's	download	download	Development, Perl, C++, and documentation RPM's.
ImageMagick-sparc-sun-solaris2.10.tar.gz	download	download	Solaris Sparc 2.10
ImageMagick-i686-pc-cygwin.tar.gz	download	download	Cygwin
ImageMagick-i686-pc-mingw32.tar.gz	download	download	MinGW

+ +

Verify its message digest.

+ +

ImageMagick RPM's are self-installing. Simply type the following command and you're ready to start using ImageMagick:

+ +

 rpm -Uvh ImageMagick-7.0.0-0.i386.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.0"

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:

+ +

+convert 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

+ +

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	HTTP	FTP	Description
ImageMagick-x86_64-apple-darwin15.2.0.tar.gz	download	download	Mac OS X El Capitan

+ +

Verify its message digest.

+ +

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.0"

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:

+ +

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

+ +

The best way to deal with all the exports is to put them at the end of your .profile file

+ +

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

+ +

~Claudio provides iOS builds of ImageMagick.

+ +

Download iOS Distribution

+ +

You can download the iOS distribution directly from ImageMagick's repository.

+ +

There are always 2 packages for the compiled ImageMagick:

+ +

iOSMagick-VERSION-libs.zip
iOSMagick-VERSION.zip

+ +

The first one includes headers and compiled libraries that have been used to compile ImageMagick. Most users would need this one.

+ +

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.0-0, svn, ...)

+ +

This script compiles ImageMagick as a static library to be included in iOS projects and adds support for

png
jpeg
tiff

+ +

Upon successful compilation a folder called IMPORT_ME is created on your ~/Desktop. You can import it into your XCode project.

+ +

XCode project settings

+ +

After including everything into XCode please also make sure to have these settings (Build tab of the project information):

Other Linker Flags: -lMagickCore-Q16 -lMagickWand-Q16 -ljpeg -lpng -lbz2 -lz
Header Search Paths: $(SRCROOT) - make it Recursive
Library Search Paths: $(SRCROOT) - make it Recursive

+ +

On the lower left click on the small-wheel and select: Add User-Defined Setting

Key: OTHER_CFLAGS
Value: -Dmacintosh=1

+ +

Sample project

+ +

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

+ +

ImageMagick runs on 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).

+ +

The amount of memory can be an important factor, especially if you intend to work on large images. A minimum of 512 MB of RAM is recommended, but the more RAM the better. Although ImageMagick runs well on a single core computer, it automagically runs in parallel on multi-core systems reducing run times considerably.

+ +

The Windows version of ImageMagick is self-installing. Simply click on the appropriate version below and it will launch itself and ask you a few installation questions. Versions with Q8 in the name are 8 bits-per-pixel component (e.g. 8-bit red, 8-bit green, etc.), whereas, Q16 in the filename are 16 bits-per-pixel component. A Q16 version permits you to read or write 16-bit images without losing precision but requires twice as much resources as the Q8 version. Versions with dll in the filename include ImageMagick libraries as dynamic link libraries. Unless you have a Windows 32-bit OS, we recommend this version of ImageMagick for 64-bit Windows:

+ +

+ + + + + + + + + + + + + + + +

Version	HTTP	FTP	Description
ImageMagick-7.0.0-0-Q16-x64-dll.exe	download	download	Win64 dynamic at 16 bits-per-pixel

+ +

Or choose from these alternate Windows binary distributions:

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Version	HTTP	FTP	Description
ImageMagick-7.0.0-0-Q16-x64-static.exe	download	download	Win64 static at 16 bits-per-pixel
ImageMagick-7.0.0-0-Q8-x64-dll.exe	download	download	Win64 dynamic at 8 bits-per-pixel
ImageMagick-7.0.0-0-Q8-x64-static.exe	download	download	Win64 static at 8 bits-per-pixel
ImageMagick-7.0.0-0-Q16-HDRI-x64-dll.exe	download	download	Win64 dynamic at 16 bits-per-pixel with high dynamic-range imaging enabled
ImageMagick-7.0.0-0-Q16-HDRI-x64-static.exe	download	download	Win64 static at 16 bits-per-pixel with high dynamic-range imaging enabled
ImageMagick-7.0.0-0-Q16-x86-dll.exe	download	download	Win32 dynamic at 16 bits-per-pixel
ImageMagick-7.0.0-0-Q16-x86-static.exe	download	download	Win32 static at 16 bits-per-pixel
ImageMagick-7.0.0-0-Q8-x86-dll.exe	download	download	Win32 dynamic at 8 bits-per-pixel
ImageMagick-7.0.0-0-Q8-x86-static.exe	download	download	Win32 static at 8 bits-per-pixel
ImageMagick-7.0.0-0-Q16-HDRI-x86-dll.exe	download	download	Win32 dynamic at 16 bits-per-pixel with high dynamic-range imaging enabled
ImageMagick-7.0.0-0-Q16-HDRI-x86-static.exe	download	download	Win32 static at 16 bits-per-pixel with high dynamic-range imaging enabled
ImageMagick-7.0.0-0-portable-Q16-x86.zip	download	download	Portable Win32 static at 16 bits-per-pixel. Just copy to your host and run (no installer, no Windows registry entries).
ImageMagick-7.0.0-0-portable-Q16-x64.zip	download	download	Portable Win64 static at 16 bits-per-pixel. Just copy to your host and run (no installer, no Windows registry entries).

+ +

Verify its message digest.

+ +

To verify ImageMagick is working properly, type the following in an Command Prompt window:

+ +

+convert logo: logo.gif
+identify logo.gif
+imdisplay
+

+ +

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:

+ +

+convert "e:/myimages/image.png" "e:/myimages/image.jpg"
+

Use two double quotes for VBScript scripts:

+Set objShell = wscript.createobject("wscript.shell")
+objShell.Exec("convert ""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.

+ +

+ + +

+ + + +

Download & Unpack

Linux-specific Build instructions

Dealing with Unexpected Problems

BlobToImage

CustomStreamToImage

AcquireImage

SetImageAlpha

SetImageBackgroundColor

SetImageInfoFile

SetImageInfoCustomStream

SetImageAlpha

SetImageInfoFile

AcquireKernelInfo

AcquireKernelBuiltIn

CloneKernelInfo

DefineImageProperty

The XShearImage

DeskewImage

Access the Pixel Cache

Unix Binary Release

Mac OS X Binary Release

iOS Binary Release

Download iOS Distribution

ImageMagick compiling script for iOS OS and iOS Simulator

XCode project settings

Sample project

Windows Binary Release

-channel-fx `expression`

-charcoal `factor`

-chop `geometry`

-combine

Image Channel Operator

Image Sequence Operator

Enabling HDRI in ImageMagick

Features and Capabilities

Download & Unpack

Linux-specific Build instructions

Dealing with Unexpected Problems

Access the Pixel Cache

Unix Binary Release

Mac OS X Binary Release

iOS Binary Release

Download iOS Distribution

ImageMagick compiling script for iOS OS and iOS Simulator

XCode project settings

Sample project

Windows Binary Release

-channel-fx expression

-charcoal factor

-chop geometry

-combine

Image Channel Operator

Image Sequence Operator

Enabling HDRI in ImageMagick

Features and Capabilities

-channel-fx `expression`

-charcoal `factor`

-chop `geometry`