1 This file documents how to use the binary distribution packages built by
2 ImageMagick Studio LLC, and found in the ImageMagick 'binaries' subdirectory
3 of ImageMagick ftp sites. Those who want to build ImageMagick from source
4 code should refer to the file README.txt in the ImageMagick source package
5 or http://www.imagemagick.org/script/install-source.php on the web.
7 Unix/Linux/Darwin/Mac OS X/Cygwin/MinGW Install:
9 Download the appropriate binary from
11 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries
13 Create (or choose) a directory to install the package into and change to that
14 directory, for example:
18 Extract the contents of the package using the command
20 gzip -dc /path/to/package.tar.gz | tar -xf -
22 If the 'bin' subdirectory of the extracted package is not already in your
23 executable search path, add it to your PATH environment variable. For
26 export PATH; PATH="$HOME/ImageMagick/bin:$PATH"
28 Set the MAGICK_HOME environment variable to the path where you extracted the
29 ImageMagick files. For example
31 export MAGICK_HOME="$HOME/ImageMagick-6.5.7"
33 On Linux and Solaris machines set the LD_LIBRARY_PATH environment variable:
35 export LD_LIBRARY_PATH="$HOME/ImageMagick-6.5.7/lib"
37 On Mac OS X (Darwin) machines set the DYLD_LIBRARY_PATH environment variable:
39 export DYLD_LIBRARY_PATH="$HOME/ImageMagick-6.5.7/lib"
41 Now, test ImageMagick to see if it is working
43 convert logo: logo.gif
46 To install PerlMagick type
48 cd ImageMagick-6.5.7/PerlMagick
53 Additional Information
55 Environment Variables:
57 In addition to the MAGICK_HOME environment variable defined above, you may
58 find these variables useful:
60 MAGICK_TMPDIR path to store temporary files
61 LD_LIBRARY_PATH path to libMagick.so and other libraries
65 ImageMagick depends on a number of external configuration files which
66 include colors.xml, delegates.xml, magic.xml, coder.xml, and others.
67 ImageMagick searches for configuration files in the following order, and
70 $MAGICK_CONFIGURE_PATH
71 $MAGICK_HOME/lib/ImageMagick-6.5.7/config
72 $MAGICK_HOME/share/ImageMagick-6.5.7/config
74 <client path>/lib/ImageMagick-6.5.7/
79 ImageMagick is able to load raw TrueType and Postscript font files. It
80 searches for the font configuration file, type.xml, in the following
81 order, and loads them if found:
83 $MAGICK_CONFIGURE_PATH
84 $MAGICK_HOME/lib/ImageMagick-6.5.7/config
85 $MAGICK_HOME/share/ImageMagick-6.5.7/config
87 <client path>/lib/ImageMagick-6.5.7/
93 ImageMagick's file format support is usually provided in the form of
94 loadable modules. It searches for loadable modules in the following order
95 and it uses the first match found:
98 $MAGICK_HOME/lib/ImageMagick-6.5.7/modules-Q16/coders/
100 <client path>/../lib/ImageMagick-6.5.7/modules-Q16/coders/
101 $MAGICK_HOME/lib/ImageMagick-6.5.7/modules-Q16/coders
102 $MAGICK_HOME/share/ImageMagick-6.5.7/modules-Q16/coders
104 <client path>/lib/ImageMagick-6.5.7/modules-Q16/coders
107 Windows Vista, XP, and NT Install:
111 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-6.5.7-0-Q16-windows-dll.exe
112 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-6.5.7-0-Q16-windows-static.exe
113 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-6.5.7-0-Q8-windows-dll.exe
114 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-6.5.7-0-Q8-windows-static.exe
116 and execute it (or "open" it from your browser) to start the installation
119 Once ImageMagick is installed, Select Start->Programs->Command Prompt. In
120 the Command Prompt window type
122 convert logo: logo.gif
125 If you have an X11 server, from the Command Prompt window type
134 unzip ImageMagick.zip
135 set default [.imagemagick]
137 identify -verbose logo: