1This file documents how to use the binary distribution packages built by
2ImageMagick Studio LLC, and found in the ImageMagick 'binaries' subdirectory
3of ImageMagick ftp sites.  Those who want to build ImageMagick from source
4code should refer to http://www.imagemagick.org/script/install-source.php.
5
6Unix/Linux/Darwin/Mac OS X/Cygwin/MinGW Install:
7
8  Download the appropriate binary from
9
10     ftp://ftp.imagemagick.org/pub/ImageMagick/binaries
11
12  Create (or choose) a directory to install the package into and change to that
13  directory, for example:
14
15     cd $HOME
16
17  Extract the contents of the package using the command
18
19     gzip -dc /path/to/package.tar.gz | tar -xf -
20
21  If the 'bin' subdirectory of the extracted package is not already in your
22  executable search path, add it to your PATH environment variable.  For
23  example
24
25     export PATH; PATH="$HOME/ImageMagick/bin:$PATH"
26
27  Set the MAGICK_HOME environment variable to the path where you extracted the
28  ImageMagick files. For example
29
30     export MAGICK_HOME="$HOME/ImageMagick-7.0.2"
31
32  On Linux and Solaris machines set the LD_LIBRARY_PATH environment variable:
33
34     export LD_LIBRARY_PATH="$HOME/ImageMagick-7.0.2/lib"
35
36  On Mac OS X (Darwin) machines set the DYLD_LIBRARY_PATH environment variable:
37
38     export DYLD_LIBRARY_PATH="$HOME/ImageMagick-7.0.2/lib"
39
40  Now, test ImageMagick to see if it is working
41
42     convert logo: logo.gif
43     display logo.gif
44
45  To install PerlMagick type
46
47      cd ImageMagick-7.0.2/PerlMagick
48      perl Makefile.PL
49      make
50      make install
51
52  Additional Information
53
54    Environment Variables:
55
56      In addition to the MAGICK_HOME environment variable defined above, you may
57      find these variables useful:
58
59        MAGICK_TMPDIR           path to store temporary files
60        LD_LIBRARY_PATH         path to libMagick.so and other libraries
61
62    Configuration Files
63
64      ImageMagick depends on a number of external configuration files which
65      include colors.xml, delegates.xml, magic.xml, coder.xml, and others.
66      ImageMagick searches for configuration files in the following order, and
67      loads them if found:
68
69          $MAGICK_CONFIGURE_PATH
70          $MAGICK_HOME/etc/ImageMagick
71          $MAGICK_HOME/share/ImageMagick-7.0.2/config
72          $HOME/.config/ImageMagick/
73          <client path>/etc/ImageMagick/
74          <current directory>/
75
76    Font Files
77
78      ImageMagick is able to load raw TrueType and Postscript font files.  It
79      searches for the font configuration file, type.xml, in the following
80      order, and loads them if found:
81
82          $MAGICK_CONFIGURE_PATH
83          $MAGICK_HOME/etc/ImageMagick
84          $MAGICK_HOME/share/ImageMagick-7.0.2/config
85          $HOME/.config/ImageMagick/
86          <client path>/etc/ImageMagick/
87          <current directory>/
88          $MAGICK_FONT_PATH
89
90    Module Files
91
92      ImageMagick's file format support is usually provided in the form of
93      loadable modules. It searches for loadable modules in the following order
94      and it uses the first match found:
95
96          <current directory>/
97          $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders/
98          $HOME/.config/ImageMagick/
99          <client path>/../etc/ImageMagick/modules-Q16/coders/
100          $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders
101          $MAGICK_HOME/share/ImageMagick-7.0.2/modules-Q16/coders
102          $HOME/.config/ImageMagick/
103          <client path>/etc/ImageMagick/modules-Q16/coders
104          <current directory>/
105
106Windows Vista, XP, and NT Install:
107
108  Download one of
109
110      ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-7.0.2-0-Q16-windows-dll.exe
111      ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-7.0.2-0-Q16-windows-static.exe
112      ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-7.0.2-0-Q8-windows-dll.exe
113      ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-7.0.2-0-Q8-windows-static.exe
114
115  and execute it (or "open" it from your browser) to start the installation
116  program.
117
118  Once ImageMagick is installed, Select Start->Programs->Command Prompt.  In
119  the Command Prompt window type
120
121      convert logo: logo.gif
122      imdisplay logo.gif
123
124  If you have an X11 server, from the Command Prompt window type
125
126      set DISPLAY=:0
127      display
128
129VMS Install:
130
131  Type
132
133      unzip ImageMagick.zip
134      set default [.imagemagick]
135      @make
136      identify -verbose logo:
137