==================================================================
    FILE: "/home/joze/src/zimg/README"
    LAST MODIFIED: "Sun, 12 May 2002 16:40:14 CEST (joze)"
    (C) 1999 - 2002 by Johannes Zellner <johannes@zellner.org>
    $Id: README,v 1.12 2002/05/12 19:19:46 joze Exp $
    ==================================================================

    zimg -- display 2-D data of arbitrary format
    Copyright (C) 1999 - 2002  Johannes Zellner


INSTALLATION:

    UNIX:

    o first you need to have Thomas Boutell's gif driver gd (libgd).
      (for further information see http://www.boutell.com/gd/)
      in principle it is possible to compile zimg w/o the gd gif
      driver, but as many zimg options won't work then this is 
      discouraged.

    o ./configure
      you might supply the path to the gd header files with 
      --with-gd-includes=.. and the path to the gd lib `libgd.a'
      --with-gd-lib=<your/path>. Of course the usual prefix switches
      are also supported.
      Watch the configure output, if the headers are found.
      After configuring you might want to check config.h:
      all `HAVE' gd includes shoud be defined to `1'.

      use --disable-edf, if you want to disable support for
      ESRF data format (edf) files.

    o make

    o make install
      this will also install the zimg.1 man page.


    OS/2:
    o use Makefile.os2 and copy config.os2 to config.h

    DJGPP:
    o see README.DJ2 (as for OS/2: use MAKEFILE.DJ2 and CONFIG.DJ2)
    copy CONFIG.DJ2 to config.h

    for both OS/2 and DJGPP you've eventually to make modifications to
    the Makefile and the config file `by hand' as the unix configure
    script is not used.  This means basically deciding, which gd version
    you use:
    - gif gd version (e.g.: gd1.3)
	config.h:
	    #define GD_GIF_VERSION
	Makefile:
	    -lgd
    - png / jpeg gd version (e.g.: gd1.8)
	config.h:
	    /* #define GD_GIF_VERSION */
	Makefile:
	    -lgd -lpng -lz -lgd
	    (see for example MAKEFILE.DJ2)



LICENCE TERMS:

    Copyright (c) 1999 - 2002, Johannes Zellner <johannes@zellner.org>
    All rights reserved.
    
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions
    are met:
    
      * Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.
      * Redistributions in binary form must reproduce the above copyright
        notice, this list of conditions and the following disclaimer in the
        documentation and/or other materials provided with the distribution.
      * Neither the name of Johannes Zellner nor the names of contributors
        to this software may be used to endorse or promote products derived
        from this software without specific prior written permission.
        
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR
    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
    LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
    SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.



FURTHER REMARKS:

    The zimg `home page' is available at
    http://zimg.sourceforge.net/

    If you have any suggestions, or if you want to contribute to the
    code, don't hesitate to contact me. If you make modifications to
    the code, please send them to me, they might be useful for others
    too.

    Please let me know, if you use zimg, just for my personal pleasure.
    <johannes@zellner.org>