@(#)$Header: README,v 1.2 89/09/20 13:32:52 chip Rel $
$Log:	README,v $
# Revision 1.2  89/09/20  13:32:52  13:32:52  chip (Chip Chapin)
# Public release 1.3.
# 
# Revision 1.1  89/09/20  12:49:50  12:49:50  chip (Chip Chapin)
# Initial revision
# 

Xtiff displays TIFF images in X11 windows.  There is a man page
which explains the program's operation.  Instructions for building it
from source are given below.

Xtiff has been tested on Hewlett Packard 9000/800 series systems
running HP-UX 3.0 and using 9000/300 series workstations as display
servers.  It has also been tested running directly on the workstations
under HP-UX 6.5.  Porting to other systems should be relatively
straightforward.  The author would like to hear about any problems
that are encountered. 

The program is known to work with both 6-plane and 8-plane color
displays; other configurations are likely to have problems.


ACKNOWLEDGEMENTS

This is a heavily derivative program, as I have taken pains to point
out in the man page and source code, and really owes its existence to
the work of three other people (whom I have never met): Sam Leffler,
John Bradley, and Patrick Naughton.  Xtiff simply fuses the two
programs "sgigt", which displays TIFF files on SGI boxes, and "xgif",
which displays GIF images in X11 windows.

Thanks to Sam Leffler for the TIFF library and for sgigt.c.  Thanks to
John Bradley for xgif.c.  Bradley, in turn, acknowledges Patrick
Naughton for writing "gif2ras", which he adapted.


BUILDING Xtiff...

To build xtiff, you need to have already compiled Sam Leffler's TIFF
library.  Xtiff needs the two header files tiff.h and tiffio.h,
which may either be in a standard location or in the directory
"../libtiff".  To link xtiff, the makefile expects to find
"../libtiff/libtiff.a".  This can be achieved by creating a directory
for xtiff, perhaps called "xtiff", at the same level as the
libtiff directory, which you should already have.

If you don't already have libtiff, you can get it from <SOMEWHERE on
HP Internet>...

If you have not yet unpacked the distribution file "xtiff.tar.Z", do
so now by (1) putting it in its own directory and (2) issuing the
command:

	zcat xtiff.tar.Z | tar xvf -
	
Now build the program by simply typing:

	make

If the compile and link goes smoothly, you will have an executable
named "xtiff".  To install xtiff in /usr/local/X11, and its man page
in /usr/local/man/man1.Z, you can execute:

	make install

as root.


AVAILABLE IMAGE FILES...

A modest collection of TIFF image files is available for testing
purposes via the HP Internet, on hpcllz2 in Cupertino.  They may be
retrieved both by ninstall and ftp.

To get them by ninstall (only OLD ninstall is supported at present):

	ninstall (or ninstall.old) -vh hpcllz2 xtiff.images
	
They will install into a [possibly new] directory "Images" in your
current working directory.

To get them by anonymous ftp:

	Host: hpcllz2
	User: anonymous
	Password: YourName@host
	Path: pub/xtiff/Images/*
	Mode: BINARY

Chip Chapin
Hewlett Packard Company
chip@hpda.hp.com
408/447-5735

