$Id: README,v 2.1 90/08/01 11:36:51 salem Exp $

		   HDF Image Format Conversion Utilities

		      by Jim Salem (salem@think.com)
		       Thinking Machines Corporation


This software is in the public domain.  Please redistribute freely and keep
this README file and author notices with the rest of the software.

Contents ::

hdf2tiff	- converts HDF images to TIFF images
tiff2hdf	- converts TIFF images to HDF images
hdf2ras		- converts HDF images to Sun Rasterfile images
ras2hdf		- converts Sun Rasterfile images to HDF images

------------------------------------------------------------------------------
Formats:
 Rasterfile	- Sun specific file format for 8 and 24 bit images
 HDF		- NCSA 8 bit raster image format (used by ximage,
		  xdataslice, etc.)
  		- NCSA is the National Center for Supercomputing Applications
 TIFF		- General purpose tagged image format (Aldus and Microsoft)

------------------------------------------------------------------------------
Compatibility ::

These programs support HDF 8 bit raster images (i.e. those written using
the DFR8 series of routines.)  They have been tested on ::
  Sun 3 and Sun4  (OS4.0.3)
  VAX Ultrix 3.1  (TIFF conversion only)

The HDF library version was 2.90.
The TIFF library version was 2.2.
Later versions and some earlier versions should work as well.

------------------------------------------------------------------------------
Building ::

With the given source code and Makefile, you'll need to install the HDF
include files in /usr/include/hdf, and the TIFF include files in
/usr/include/tiff.

The TIFF library is accessed as -ltiff and the HDF library is accessed as
-ldf.  To compile the Rasterfile conversion code you must have the Sun
pixrect library available.

make 		- Makes all the converters
make <name>	- Makes the converter named <name>

------------------------------------------------------------------------------
Enhancements ::

Here are a few enhancement you can make at home.  [Mail the new versions to
me and I will integrate them into the standard version.]

- Support HDF 24 bit images
- Integrate the machine independent version of the pixrect library that PBM
   uses
- Add a PPM or PGM converter (part of the PBM family)
- Manual pages

------------------------------------------------------------------------------
Availability ::

This software is available via anonymous FTP from think.com (131.239.2.1).
Transfer the file hdf_convert.shar.Z and use uncompress to restore the shar
script hdf_convert.shar.  Typing /bin/sh hdf_convert.shar will restore the
files making up the conversion utilities.

------------------------------------------------------------------------------
Contact:

Jim Salem
Thinking Machines Corporation
245 First St.
Cambridge MA 02154
(617) 876-1111
salem@think.com

------------------------------------------------------------------------------
------------------------------------------------------------------------------

HDF and TIFF availability ::

I've enclosed the portions of HDF and TIFF README files that state where to
get those libraries. 


			     HDF Availability

This document describes how to obtain a version of HDF for your system.   
Other information, including hints on using HDF, descriptions of  the 
files that comprise the distribution, and instructions on how to to 
create a library, can be found in other README files in this directory. 

There are two ways of obtaining HDF, depending on whether you are 
accessing this system by remote login or anonymous ftp.
Accordingly, this document contains the following sections:

	Obtaining HDF using anonymous ftp
	Obtaining HDF using remote login

If you have any questions, problems or suggestions, you can contact us 
via Email at mfolk@ncsa.uiuc.edu or likkai@ncsa.uiuc.edu,  or by writing 
to Mike Folk, Software Development, NCSA, 605 East Springfield Ave., 
Champaign, IL 61820, or call 217 244 0647.


************************************************************************
	Obtaining HDF using anonymous ftp
************************************************************************

Login to zaphod.ncsa.uiuc.edu (128.174.20.50), with a login name of 
"anonymous". Give your real name as password.  Move to the directory 
"HDF" by issuing the command "cd HDF" to ftp.  Now you are ready to 
transfer files.  There are two ways to do this:

1. You may use the command "get hdf.tar" to download a "tar" format 
file.  (Be sure to set file transfer mode to binary with the command 
"binary".)   Unpacking hdf.tar with the Unix "tar" utility on your 
system will produce a tree of subdirectories similar to the ones in this 
directory.    These files are described in README.SRC.  They must be
compiled according to the instructions in that section.  (NOTE: this tar
file is very large, as it contains source files for several systems, plus
all of the documentation.  If space is dear, consider using the method
described in the next paragraph.) 

2. As an alternative to "tar", you may download the files you require 
directly.  Use "cd src" to move to the directory containing source 
files. Then, move to the directory for your system.  For instance, if 
you are on an Alliant system, use "cd alliant".  Then use the command 
"mget *".  This will prompt you for each of the source files, asking if 
you want to download them. Answer "y" to each.  This will produce the 
source files for that system in your directory.  Compile these files 
according to the instructions in the file README.SRC.

To obtain the documentation enter "cd ../../doc" to move to the 
directory containing the documentation.  There are two subdirectories, 
with "ascii" providing the documentation in readable form, and "word" 
providing it in Macintosh Microsoft Word format. Each subdirectory has 
two subdirectories, containing the user documentation (NCSA_HDF) and the 
technical specification (HDF_Specs), respectively.  The Word files must 
be downloaded in binary mode with Macbinary mode enabled.  The ascii 
files may be downloaded in ascii mode.  

Mac users may download the file hdf.sit, which is HDF for the Mac in 
StuffIt format.  This is an archive containing all the files necessary 
to install HDF on a Mac.  This must be downloaded in binary mode, using 
the MacBinary option on NCSA Telnet.  Alternatively, the file 
hdf.sit.hqx may be downloaded in ascii (normal) mode.  This is a StuffIt 
file further encoded with BinHex.



**********************************************************************
		Obtaining HDF using remote login 
**********************************************************************

If you have an account on the NCSA Suns, you may download HDF in this way.
To obtain a copy of HDF for a particular system, login to zaphod.ncsa.uiuc.edu,
cd to the directory /sdg/ftp/HDF and use the "transfer" script.

Usage: transfer systemtype hostname [directory]

where systemtype is "unicos", "sun", "alliant", "iris4", "mac", 
"vms" or "pc", hostname is the ftp name of the host you want to transfer 
the files to, and directory is the directory on the target system in 
which you want the files to be placed.

Transfer will create the source files appropriate for the system type, 
then open an ftp connection to the target machine and ask you to login.  
When you do, it will automatically copy the required files to the target 
system in the directory you specified.  It will also deposit all the 
documentation, in Macintosh Microsoft Word format if transferring to a 
Macintosh, in ascii format otherwise.  It will deposit all the files in 
the same directory, as contrasted to using the "tar" approach outlined 
in the section on anonymous ftp, which will create a tree of 
subdirectories.


------------------------------------------------------------------------------

			     TIFF Availability

Tue Apr 17 17:57:27 PDT 1990

How To Obtain This Software (in case all you get is this file)

The software is available for public ftp on
    ucbvax.berkeley.edu		pub/tiff/tiff.tar.Z
	(128.132.130.12)
    uunet.uu.net		graphics/tiff.tar.Z
	(192.48.96.2)

For example,
    ftp -n ucbvax.berkeley.edu
    ....
    user anonymous
    ... <type in password>
    cd pub/tiff
    binary
    get tiff.tar.Z

The software comes in a compressed tar file.  To extract the
information:
    uncompress tiff.tar.Z	(creates new file tiff.tar)
    tar xf tiff.tar		(extract individual files in current directory)

There is also companion compression tar file, tiffpics.tar.Z
that has sample TIFF image files.  These are mostly useful in
testing the software if/when you port it to an unsupported system.
