Home | History | Annotate | Download | only in ImageMagick 
      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 http://www.imagemagick.org/script/install-source.php.
      5 
      6 Unix/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 
    106 Windows 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 
    129 VMS Install:
    130 
    131   Type
    132 
    133       unzip ImageMagick.zip
    134       set default [.imagemagick]
    135       @make
    136       identify -verbose logo:
    137