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