
                        --- contents of /usr/demo ---

This document describes the demos that are sent out as part of the 1.1 release.

... refer to the system administrator's manual for instructions on pulling
    the demos programs off the release tape(s).

... Due to space considerations on the release tapes only source and data files
    are provided.  Use the supplied Makefile in the src subdirectory to
    produce the binaries.

... The manual pages bwdemo and colordemo do not accurately reflect the
    contents of the /usr/demo directory.  This document should be referred to
    instead.

... All of the demos will run on all surfaces unless specifically noted.
    This incudes: the sun-1 monochrome monitor, the sun-2 monochrome monitor,
    the color monitor, b/w windows, and color windows.

... If run from the environment where the display is desired simply enter
    the demo name.  In order to change the display surface give the demo
    name followed by the option "-d /dev/surface". The surface names are:

		bw1dd 		sun-1 monochrome monitor
		bw2dd		sun-2 monochrome monitor
		cg1dd		color monitor

... All programs that do not use the mouse or keyboard for input can also
    be run with a "-q" option which allows the program to terminate
    quicker.  This allows several different demos to be run within a
    shell script.

... Demos running on color surfaces started from b/w windows cannot use
    mouse input so it makes no sense to run mixcolor, draw, and shaded in
    this fashion.

... to run a demo you can either "cd /usr/demo"  or  change your path to also
    look in the /usr/demo directory for binaries.

... All demos can be interrupted by ctrl-C.

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

chessgame [ -q ] [ -d /dev/surface ]

	Plays out a game of chess.  A move is made every 3 seconds.  The
	final position will remain for 5 minutes before normal termination.

draw [ -d /dev/surface ]

	A simple drawing program using mouse input. Refer to the User's 
	Manual for a complete description on how to use this demo. One
	warning, error reporting will interfere with the drawing. It is
	well advised to run this program in a graphics window.

mixcolor [ -d /dev/surface ]

	A color generator using the left button of the mouse as a pick device.
	To change the color of one of the palette boxes:

		1) pick the color you wish to change.
		2) pick the desired dial location.
		3) repeat 1 and 2 until satisfied.
		4) pick the target box(es).

	To quit pick the QUIT box.

product	[ -q ] [ -d /dev/surface ]

	Produces a slide showing a typical sun-2/120 configuration.  Will
	display the slide for 33 minutes before terminating normally.

rotcube [ -d /dev/surface ]

	Rotates a cube with increasing velocity.  Will run continuously until
	interrupted.

shaded object [ -d /dev/surface ]

	Shades objects.  Objects are located in the sub-directory DATA.
	Choose from an icosahedron, glass, soccer ball, space shuttle,
	egg, or pyramid.  This demo can take up to 30-40 seconds to
	start up with certain objects.  Mouse input is required. To run:

		1) Click the left button of the mouse on the left grid to
		   set the x-y orientation. Click the middle button on the
		   right grid to set the x-z orientation. Click the left 
		   button away from either grid to open the features menu.

		2) After selecting the desired features with the left 
		   button, click the left button away from all objects to
		   exit the features menu.

		3) Click the right button to begin drawing the object

		4) When the figure is finished click the right button again 
		   to return to the grids and menu.

showmap	[ -q ] [ -d /dev/surface ]

	Displays 10 map projections continuously until interrupted.  Each map 
	will be displayed for about 5 seconds (The maps are in the
	sub-directory MAPS).

stringart [ -q ] [ -d /dev/surface ]
		
	Will continuously display a different "work of art" every 5 seconds.
	A total of 24336 different designs are possible.  On color surfaces
	the designs will loop through the colors: red, olive, green, turquoise,
	blue, and violet.

suncube	[ -q ] [ -d /dev/surface ]

	Displays a cube with the SUN logo mapped to each face.  Will run 
	continuously until interrupted.  On color surfaces the colors of 
	the logo segments will change gradually. On monochrome surfaces the 
	logo segments will remain hollow.
