DOCUMENTATION

IPW is described in the following document (hereinafter referred to as
The Documentation):

	%T The Image Processing Workbench
	%A James Frew
	%C Santa Barbara, CA
	%I University of California
	%D July 1990
	%R Ph.D. dissertation

If you obtained IPW on tape or other physical media, then you should
also have received a paper copy of The Documentation.

If you obtained IPW electronically, then you should also have obtained
a PostScript version of The Documentation, which may be rendered on any
PostScript device supporting the Apple LaserWriter Plus font set (it is
about 300 pages long).

FEATURES ADDED TO V1.0 IPW SINCE THE EARLY BETA RELEASE

- Code for swapping the byte order of multi-byte pixel images has been
  incorporated into the "pixio" layer of IPW.  This allows images
  written on bigendian machines (e.g., Suns) to be transparently read
  on littleendian machines (e.g., Decstations) and vice versa.  This
  feature was documented but not yet implemented in previous releases
  of IPW.

	NOTE:  If your code bypasses the "pixio" layer's pvread/write
	or fpvread/write functions and accesses pixels at the "uio"
	uread/write layer you'll need to add a line of code before any
	bihdup() or bihmake() calls.  The supported IPW commands flip,
	window, and transpose needed this modification; look at
	src/bin/transpose/transpose.c for an example.

- The following programs have been renamed to reflect The
  Documentation:

	beta release program name:		v1.0 name:
	-------------------------		---------
	pspic					ipw2ps
	hdspic					ipw2hds

 - Programs "pbm2ipw" and "ipwfile" have been added - see below.



UNDOCUMENTED FEATURES

This distribution of IPW differs from The Documentation as follows.

 - The arguments to program "mksath" are different.

 - Programs "ipw2xim" and "ipw2sun" have been deleted.

 - Programs "ipw2pbm" and "pbm2ipw" have been added.  These programs
   converts IPW images to and from the PGM and PPM formats supported by
   Jef Poskanzer's "Portable Bitmap Library", which are in turn
   supported by most image viewing tools that run under the X Window
   System (e.g., "xloadimage" and "xv").  The PBMPLUS package is
   available at most archive sites (e.g., gatekeeper.dec.com) and makes
   an excellent companion to IPW; PBMPLUS provides image conversion
   routines for most any image format and utilities for editing and
   annotating images.

 - Program "ipwfile" has been added.  This program quickly returns
   basic image dimensions and is useful in shell scripts.

 - Function "hdralloc" returns an error value, instead of exiting on
   error as documented.

 - Linearly-quantized images consisting entirely of a single pixel
   value cannot be WRITTEN.

 - More than 2 linear-quantization breakpoints are not yet supported
   for OUTPUT images.