#
# @(#)README 1.2 86/10/07 SMI
#

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

... THIS DOCUMENT IS NOT GUARANTEED TO BE UP TO DATE, USE WITH A GRAIN OF
    SALT.  After all, these are only demos.

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

... All of the demos will run on all surfaces unless specifically noted.
    This incudes: all -1 monochrome and color frame buffers,
    as well as Graphics Processor surfaces, 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". For example, to run
    the suncube demo on the cgone monitor, started from the b/w monitor,
    issue the command:

            suncube -d /dev/cgone0.

    The -d option is not supported by all demos.

... Some programs that do not use the mouse or keyboard for input can also
    be run with a "-q" option which allows the program to quickly terminate.
    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 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. (except for demos that mask off
    input running in shelltools).

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

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

	Displays a rotating view of the world.  This demo must be executed
	in the directory containing the frames (sequence of raster images
	of the globe).  If the frame.x files are in demo/globeframes then
	run the demo as follows:
		cd demo/globeframes
		../cframedemo

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.

goban
	Please consult Readme.goban .

maze
	This demo has no user interaction.  It simply creates a random
	maze and tries a depth first solution.  If used for a lockscreen
	remember to run in nice mode, since this demo eats cpu cycles.

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 and middle buttons of the mouse on the left
		   grid to set the x-y orientation. Click the middle button
		   on the right grid to set the 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, or type "q" to exit.

show file1 [file2 ...]

	Displays images in a window or on a raw screen.  Image files must be
	in Sun's standard raster file format (see /usr/include/rasterfile.h).
	Sample files are contained in the directory /usr/demo/COLORPIX.
	Running "show COLORPIX/*" from /usr/demo will continuously cycle
	through all the sample images.

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.

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

In addition to the demos in this directory, there is a GP1 directory
which contains two subdirectories: VIEWPORT and DEV_GP1 which contain
example application interface packages built on top of the GP command
interface along with associated demos. Refer to the README files in
those diretories.
