                              TclMagick
                              =========

TclMagick install instructions.

===============
Unix platforms:
===============

Installing TclMagick in a separate directory from ImageMagick or
GraphicsMagick.

0) If there is no configure script (you are fetching from CVS, for
   instance), try running the genconf.sh script.  It runs aclocal,
   autoconf, and automake --add-missing, in that order.

1) Run the ./configure script.  The following arguments are
   recommended:

./configure \
  --with-tcl=/usr/lib/tcl8.6/ \
  --with-tk=/usr/lib/tk8.6/ \
  --with-magick=/usr/local/bin/GraphicsMagickWand-config \

Others that might very well be helpful are --enable-shared.

The --with-tcl option tells the configure script where to find Tcl - or
more accurately, the tclConfig.sh file that configure uses to find
important information about how to compile Tcl extensions.  If this option
is not specified, the file may (but might not) be found automatically.

The --with-tk option tells the configure script where to find Tk, - or
more accurately, the tkConfig.sh file that configure uses to find
important information about how to compile Tcl/Tk extensions. If this
option is not specified, the file may (but might not) be found
automatically.

The --with-magick option is used to tell the configure script where to
get information about the GraphicsMagick or ImageMagick install. If the
--with-magick option is not specified, then the PATH is searched for
GraphicsMagickWand-config (default for GraphicsMagick), and if that is
not found, then the PATH is searched for MagickWand-config (default for
ImageMagick).

2) Run make - this should build the libraries.


=================
Windows platform:
=================

* ImageMagick(IM) or GraphicsMagick(GM) should be installed on your system:
  - Check the "Install development headers and library ..." option.
  - After installation the computer needs a restart to update the PATH environment.
  - Windows also needs Ghostscript installed for fond rendering.

* Unzip the TclMagick sources

* Compile TclMagick using MS Visual C++ 6.0
  - Open the VC++ workspace in the TclMagick\win directory
  - Change the include path and library path to your IM/GM directory:
        Project settings - All configurations - C/C++ - preprocessor
        Project settings - All configurations - Linker - input
  - Compile the project, the compiled DLL's are in
        Debug\TclMagick.dll
        Release\TclMagick.dll

* Run the test-suite
  - Change to the TclMagick\tests directory
  - By default the debug version is used: Debug\TclMagick.dll
  - Run the three test-*.tcl scripts
    Resulting images are written to the TclMagick\tmp directory

* Use TclMagick
  As a library package:
      - Copy the pkgIndex.tcl and TclMagick.dll files to your Tcl-library
      - Load the library with
                package require TclMagick
  By directly loadind the DLL:
      - Copy the TclMagick.dll to your desired destination
      - Load the library with
                load TclMagick.dll
