/ImageMagick.jl

Thin Wrapper for the library ImageMagick

Primary LanguageJuliaOtherNOASSERTION

ImageMagick

Build Status Build status Coverage Status codecov.io

This package was split off from Images.jl to make image I/O more modular.

Installation

Add the package with

Pkg.add("ImageMagick")

Usage

ImageMagick will be used as needed if you've said

using FileIO

in your session or module. You should not generally say using ImageMagick. See FileIO for further details.

It's worth pointing out that packages such as Images load FileIO.

Troubleshooting

OSX

ImageMagick seems to experience trouble frequently on OSX. If QuartzImageIO works for you, it may be an easier solution.

If you do want to fix your ImageMagick installation, before asking for help please try the following sequence:

using Homebrew
Homebrew.rm("imagemagick")
Homebrew.update()
Homebrew.add("imagemagick")
Pkg.build("ImageMagick")

In particular this may fix the error ERROR: no encode delegate for this image format 'MIFF'.

You may also find debugging Homebrew useful.

Manual installation on Windows

If automatic installation fails, get the current version from http://www.imagemagick.org/script/binary-releases.php#windows (e.g. ImageMagick-6.8.8-7-Q16-x86-dll.exe) and make sure that the "Install development headers and libraries for C and C++" checkbox is selected. You may choose to let the installer add the installation directory to the system path or provide it separately. In the later case you may add it to your .juliarc.jl file as (for example) push!(Base.DL_LOAD_PATH, "C:/programs/ImageMagick-6.8.8"). Alternatively, you can set your MAGICK_HOME environment variable.

When manual intervention is necessary, you need to restart Julia for the necessary changes to take effect.

Linux

ImageMagick.jl automatically searches for an installed version of libMagickWand. Use the environment variable MAGICK_HOME to add to the search path. Use ImageMagick.libversion to see what version it found. Version 6.7+ (up to but not including 7.0) are the most supported versions, in particular for multipage TIFFs.

The environment variable MAGICK_THREAD_LIMIT can be used to throttle multithreading.