README 11/11/90
PolyView

_______________________________________________________________________________
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.

_______________________________________________________________________________
POLYVIEW

Enhancements to this software are occurring rapidly. Keep looking for updates 
in this directory. Useful suggestions are likely to be implemented in new 
releases.

Portions developed at the National Center for Supercomputing Applications at 
the University of Illinois at Urbana-Champaign.

What does it do?

	PolyView displays an HDF Vset of polygons or points at a two
	or three dimensional, interactive image with optional annotation,
	which may be written to a RIS8 HDF format file.  The program
	also allows you to:

	-- change display projection
	-- render display as points, lines, or polygons
	-- choose constant or gouraud shaded polygons
	-- load and manipulate the colormap
	-- animate a series of vdata sets
	-- view a fly-by of the data using a script file


How is it used?

	The program reads HDF Vset files.  The HDF Vset 1.0 library
	is required.  The necessary code for this application is included
	in this release.

_______________________________________________________________________________
REQUIREMENTS
	
PolyView is only supported on the Silicon Graphics Personal
IRIS 4D/20G (24-bit color, 24-bit Z-buffer).  It makes extensive
use of Z-buffering.  Although it has not been tested on higher-end
IRISes, it should run on most models.  It is compiled using
shared graphics and mathematics libraries.

_______________________________________________________________________________
INSTALLATION

In order to create the example HDF Vset file, "demo.hdf", you should download 
the following files:

   makefile	md.c	df.h	dfi.h	vg.h	libdf.a	libvg.a

The makefile will compile "md" which, in turn, is used to create "demo.hdf".  
"md.c" provides example code for creating an HDF Vset file from scratch, and 
may be used as a starting point for a data filter.

Creating PolyView itself requires all of the files in the v102/src directory.  
Typing "make" without any parameters is all that is necessary to create the 
program.

For further development of Vset files it is recommended that you obtain the HDF 
Vset 1.0 code.  It is available via anonymous ftp, by remote login, or direct 
from NCSA on tape.
