
******************************************************************
*						PolyView 1.02
*						November 11, 1990
*
*
*	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.
*
*	THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, EXPRESSED OR 
*	IMPLIED, FOR THE SOFTWARE AND/OR DOCUMENTATION PROVIDED, 
*	INCLUDING, WITHOUT LIMITATION, WARRANTY OF MERCHANTABILITY 
*	AND WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE
*
*	Comments and suggestions may be forwarded to:
*
*		Brian Calvert, Software Tools Group, NCSA,
*		605 East Springfield Ave, Champaign, IL 61820.
*		email: bcalvert@ncsa.uiuc.edu
*		Phone: (217) 244-0013
*
*	EMAIL COMMUNICATION IS PREFERRED.
*
******************************************************************


PolyView 
========

(1) 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


(2) 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.


(3) Where does it run?
	
	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.


(4) How can I get it?
	
	(a) Obtaining PolyView 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 "polyview" by issuing the command
		"cd PolyView".

		Grab the compressed tar file "polyview.0.61.tar.Z". This
		contains the makefile, source for an example, the Vset
		library, and the compiled PolyView 0.61 program.

	(b) By remote login
	 
		If you have an account on the NCSA Suns, you may download HDF
		Vset in this way.  Login to zaphod.ncsa.uiuc.edu, cd to the
		directory /sdg/ftp/polyview and copy all files in that
		directory.

(5) Documentation

	ASCII and Microsoft Word documentation are available.
	A bound, laser-printed copy of the document complete with
	illustrations may be obtained by contacting us.


(6) Files

	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.


(7) Related Items

	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.
