README 7/25/91
NCSA PCShow

_______________________________________________________________________________
BEFORE YOU BEGIN

Please read the README.FIRST file - found at the root level of this server - 
for general information and instructions on unarchiving and uncompressing
files.

The README.BROCHURE also contains helpful descriptions of this and other
software offered on the ftp server.

_______________________________________________________________________________
NCSA PCSHOW

This is version 1.11 of NCSA PCShow
PC Show is a public domain program designed for displaying raster 8 binary
images and images contained in HDF files.  It will display these images on
VGA, EGA, and Number 9 Revolution 512 monitors, with future releases to
support display on Targa boards.

This software was produced at NCSA at University of Illinois at
Urbana/Champaign.  Please notify us of any bugs you have found in our software
and any suggestions you have for future releases or products.

_______________________________________________________________________________
NEW FEATURES

Future releases will contain more mouse support, Targa graphics support,
more image manipulation functions, and possibly some palette manipulation
tools included.

_______________________________________________________________________________
GENERAL NOTES

There are two copies of the executable code.  PCSh111.exe will work with or 
without a mouse used, it doesn't use any of the mouse routines and will perform 
exactly as the documentation specifies.  PCSh111m.exe calls mouse dependant 
functions, it will NOT work correctly without a mouse attached to the computer.
(The mice used for testing it were a PCSYSTEMS optical mouse and a standard IBM 
mouse.)  The mouse routines are not documented or rigorously tested, but appear 
to be fully functional for scrolling the image (click on an edge of corner) and 
for moving the color bar (click and hold down button on the color bar and move 
the mouse to re-locate the color bar).

The following files are necessary for correct program compilation with Lattice 
C 3.1:

	pcshow.c	- contains the main i/o routines
	options.c	- contains the main routines to manipulate the image
	parse.c		- contains the command parsing routine
	vga.asm		- assembly language routines for vga monitor
	ega.asm		- assembly routines for ega monitor
	no9.asm		- assembly routines for NO9 monitor
	dosio.asm	- assembly routines to access dos commands
	df.h		- HDF header file
	dfi.h		- more HDF header information
	tardev.h	- header file for future targa developement
	fcntl.h		- Lattice C routines
	stdio.h		- standard i/o routines
	stdlib.h	- more i/o routines
	time.h		- some time routines for random number seeding
	math.h		- some math routines needed for interpolating
	df.lib		- HDF library functions
	makeshow.bat	- a batch file to compile and link all the files

	pcshow.exe		- executable code for systems without a mouse
	pcshow.m.exe		- executable code for systems with a mouse
	pcshow.doc.ascii	- documentation for PC Show in ascii format

The following files will have to be provided by the user for correct
compilation and linking:

	msmouse.lib	- mouse support routines - found on the mouse support
			  disk provided with your mouse
	dos.mac 	- file provided with lattice C

There are two source files, "PCShsrcL.zip" and "PCShsrcM.zip".  Both files are
version 1.11.  "PCShsrcL.zip" is the Lattice C 3.2 source and "PCShsrcM.zip" is
the Microsoft C 5.1 source.

The sample file contains some images and palettes.  Some small hdf images are 
found in the images/hdf directory.  These are useful to test out the 
performance of PCShow after it has been compiled.  A larger raster image and 
palette are found in the images/raster directory.  This is useful for verifying 
binary images and as an example format for raw raster palettes.  Some useful 
palettes have been included in the palettes directory.

_______________________________________________________________________________
BUG NOTES

Changes in Version 1.11: several bugfixes which had to do with accessing data
on other drives or directories were fixed and some basic optimization was
performed to reduce the size of the executable.  Also the code was ported to 
Microsoft C 5.1 and that is probably where it shall stay (unless everybody
writes us hate mail about it).  Seperate directories for the Microsoft and
Lattice code are now available.

Changes in Version 1.1:due to popular demand, the capability to aminate
multiple hdf files was added.  Also it is now possible to to wildcarding
on the image names of animations in both the "single file" and the "list of
files" modes.

Changes in Version 1.01:a small bug was corrected in the uncompression
scheme for run length compressed images from the 1.0 version.  Also, a
define statement was included in all the .c files to allow compilation without
mouse support routines.  Also the batch file must be changed in the link
statement to delete the msmouse library if mouse functions aren't used.

.