			      TclMagick
			      =========

TclMagick install instructions.

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

Installing TclMagick in a separate directory from ImageMagick.

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.  Be sure to
   use recent versions of the autotools (1.8 works for me, 1.4
   doesn't).

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

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

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

--with-tcl tells it where to find Tcl - or more accurately, the
tclConfig.sh file that configure uses to find important information
about how to compile Tcl.  The directory where tkConfig.sh resides is
indicated with --with-tk.  The --with-magick option is necessary to
tell the configure script where to get information about the ImageMagick
install.

2) Run make - this should build the libraries.


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

* ImageMagick(IM) 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
 
