blob: cd26745e4e2ad488064bc64b488f5544ab3547e1 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001This 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
Cristy64599592016-11-04 22:32:09 -04004code should refer to https://www.imagemagick.org/script/install-source.php.
cristy3ed852e2009-09-05 21:47:34 +00005
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
Cristy8dc95552016-06-12 14:02:29 -040030 export MAGICK_HOME="$HOME/ImageMagick-7.0.2"
cristy3ed852e2009-09-05 21:47:34 +000031
32 On Linux and Solaris machines set the LD_LIBRARY_PATH environment variable:
33
Cristy8dc95552016-06-12 14:02:29 -040034 export LD_LIBRARY_PATH="$HOME/ImageMagick-7.0.2/lib"
cristy3ed852e2009-09-05 21:47:34 +000035
36 On Mac OS X (Darwin) machines set the DYLD_LIBRARY_PATH environment variable:
37
Cristy8dc95552016-06-12 14:02:29 -040038 export DYLD_LIBRARY_PATH="$HOME/ImageMagick-7.0.2/lib"
cristy3ed852e2009-09-05 21:47:34 +000039
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
Cristy8dc95552016-06-12 14:02:29 -040047 cd ImageMagick-7.0.2/PerlMagick
cristy3ed852e2009-09-05 21:47:34 +000048 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
cristy5d3be3b2011-04-01 14:40:46 +000070 $MAGICK_HOME/etc/ImageMagick
Cristy8dc95552016-06-12 14:02:29 -040071 $MAGICK_HOME/share/ImageMagick-7.0.2/config
cristy9f3b4fc2014-02-08 14:56:20 +000072 $HOME/.config/ImageMagick/
cristyed6fae02011-04-01 14:32:17 +000073 <client path>/etc/ImageMagick/
cristy3ed852e2009-09-05 21:47:34 +000074 <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
cristy5d3be3b2011-04-01 14:40:46 +000083 $MAGICK_HOME/etc/ImageMagick
Cristy8dc95552016-06-12 14:02:29 -040084 $MAGICK_HOME/share/ImageMagick-7.0.2/config
cristy9f3b4fc2014-02-08 14:56:20 +000085 $HOME/.config/ImageMagick/
cristyed6fae02011-04-01 14:32:17 +000086 <client path>/etc/ImageMagick/
cristy3ed852e2009-09-05 21:47:34 +000087 <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>/
cristyed6fae02011-04-01 14:32:17 +000097 $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders/
cristy9f3b4fc2014-02-08 14:56:20 +000098 $HOME/.config/ImageMagick/
cristyed6fae02011-04-01 14:32:17 +000099 <client path>/../etc/ImageMagick/modules-Q16/coders/
100 $MAGICK_HOME/etc/ImageMagick/modules-Q16/coders
Cristy8dc95552016-06-12 14:02:29 -0400101 $MAGICK_HOME/share/ImageMagick-7.0.2/modules-Q16/coders
cristy9f3b4fc2014-02-08 14:56:20 +0000102 $HOME/.config/ImageMagick/
cristyed6fae02011-04-01 14:32:17 +0000103 <client path>/etc/ImageMagick/modules-Q16/coders
cristy3ed852e2009-09-05 21:47:34 +0000104 <current directory>/
105
106Windows Vista, XP, and NT Install:
107
108 Download one of
109
Cristy8dc95552016-06-12 14:02:29 -0400110 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
cristy3ed852e2009-09-05 21:47:34 +0000114
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: