Copyright (C) 2003 GraphicsMagick Group
Copyright (C) 2002 ImageMagick Studio
Copyright (C) 1999 E. I. du Pont de Nemours and Company

This program is covered by multiple licenses, which are described in
Copyright.txt. You should have received a copy of Copyright.txt with this
package; otherwise see http://www.graphicsmagick.org/www/Copyright.html.
---------------------------------------------------------------------------

This file documents how to use the binary distribution packages built by
GraphicsMagick Group, and found in the GraphicsMagick 'binaries'
subdirectory of GraphicsMagick ftp sites. Those who want to build
GraphicsMagick from source code should refer to the file README.txt in the
GraphicsMagick source package or
http://www.graphicsmagick.org/www/README.html on the web.

Unix/Linux/Darwin/Cygwin/MinGW Install:

  Download the appropriate binary from

     ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/binaries

  Create (or choose) a directory to install the package into and
  cd to that directory, for example:

     mkdir $HOME/GraphicsMagick
     cd $HOME/GraphicsMagick

  Extract the contents of the package using the command

     gzip -dc /path/to/package.tar.gz | tar -xf -

  If the 'bin' subdirectory of the extracted package is not
  already in your executable search path, add it to your
  PATH environment variable.  For example

     export PATH; PATH="$HOME/GraphicsMagick:$PATH"

  Test GraphicsMagick to see if it is working

     gm convert "LOGO:" logo.miff
     gm display logo.miff

  If an error is displayed that a file can not be found, you may need to
  set the MAGICK_HOME environment variable to the path where you
  extracted the GraphicsMagick files. For example

     export MAGICK_HOME="$HOME/GraphicsMagick"

  Additional Information

    Environment Variables:

     In addition to the MAGICK_HOME environment variable defined above,
     you may find these variables useful:

       MAGICK_DEBUG            debugging options similar to -debug arguments
       MAGICK_HOME             path to GraphicsMagick installation directory
       TMPDIR                  path to store temporary files
       LD_LIBRARY_PATH         path to libMagick.so and other libraries

    Configuration Files

      GraphicsMagick depends on a number of external configuration files
      which include colors.mgk, delegates.mgk, log.mgk, magic.mgk,
      type.mgk, and modules.mgk. GraphicsMagick searches for configuration
      files in the following order, and will use the first file found:

          <client path>/../lib/GraphicsMagick/
          $MAGICK_HOME/lib/GraphicsMagick/
          $HOME/.magick/
          <current directory>/

    Font Files

      GraphicsMagick is able to load raw TrueType and Postscript font files.
      It searches for these files in the following order and uses the
      first match found:

          <current directory>/
          $MAGICK_FONT_PATH/
          $MAGICK_HOME/
          $HOME/.magick/

    Module Files

      GraphicsMagick's file format support is usually provided in the form
      of loadable modules. It searches for loadable modules in the
      following order and it uses the first match found:

          <client path>/../lib/GraphicsMagick/modules/coders/
          $MAGICK_HOME/lib/GraphicsMagick/modules/coders/
          $HOME/.magick/
          <current directory>/

XP, Win2K, WinME, NT, Win98, Win95 Install:

  Download

      ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/binaries/GraphicsMagick-i686-pc-windows.exe

  and execute it (or "open" it from your browser) to start the installation
  program.

  Once GraphicsMagick is installed, Select Start->Programs->Command Prompt.
  In the Command Prompt window type

      gm identify -verbose logo:

  If you have an X11 server, from the Command Prompt window type

      set DISPLAY=:0
      gm display

MAC Install:

  Download

      ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/binaries/GraphicsMagick-powerpc-apple-mac9.2.sit

        or

      ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/binaries/GraphicsMagick-powerpc-apple-darwin6.0.tar.gz

  and double click on it to extract the distribution.   Move to the
  GraphicsMagick folder and double click on the convert program icon.
  Next, type

     convert -verbose logo: logo.jpg

  in the command window and choose File->Quit to exit.

VMS Install:

  Type

      unzip GraphicsMagick-1.0.zip
      set default [.graphicsmagick]
      @make
      gm identify -verbose logo:
