
--- IMGTOOLS v0.3 ---

Imgtools is a C extension to Tk, that provides functionality to modify
Tk's photo images.

Features:
    * scale images by any factor
    * rotate images 
    * modify transparency
    * interpolation methods: nearest neighbor, linear, bicubic (the
      Catmull - Rom flavor) and lanczos.
    * create color gradients

Further information, bug reports, questions, latest releases, etc:
http://tkimgtools.sourceforge.net/

INSTALLATION
=============

To compile Imgtools you need 
    - Tcl/Tk (including headers)
    - a C compiler and make
    
The instructions below are for *nix systems.

1.  (Optional, recommended) create a separate build directory.
    
2.  Configure:

    $ ${path_to_source}/configure
    
    The usual options may be passed to configure. Run 'configure --help' for
    details.
    
    Custom configure options:
    
    --enable-debug
        if passed, compile in additional debugging tools: a debugging 
        message system, exact interpolation (calculate filter values instead
        of using cache) and cputime (a custom profiling tool).
        Enabling debug will make imgtools slower, this option is only of interest
        for debugging.
        
3.  Compile:

    $ make
    
    This will compile the extension. The compiled extension is named
    libimgtools${version}.so. Yo may [load] this file directly into 
    a Tcl interpreter.
    
3.  If you want to install the extension system-wide, run 

    # make install
    
    Your might need admin privileges for this. 
    
    For packaging, the DESTDIR variable is supported:
    
    $ make DESTDIR=/your/prefix/ install
    
UNINSTALL
==========

    No automated uninstall available, sorry.
    
    The installation of imgtools consists of only 3 files: the binary
    extension, a pkgIndex.tcl file and the manpage. Shouldn't be too 
    hard to remove them manually.
    
    
COMPILE / INSTALL ON WINDOWS
============================

    The simplest way to compile imgtools under Windows is Cygwin
    (www.cygwin.com), following the steps for Unix systems described
    above. 
    
    Compilation with other compilers (e.g. MS Visual C++) might work
    as well, but you're on your own if you want to try that ;-)
    
