#ident "%W%" %G%
 
/**************************************************************************
# Copyright (C) 1994 Kubota Graphics Corp.
# 
# Permission to use, copy, modify, and distribute this material for
# any purpose and without fee is hereby granted, provided that the
# above copyright notice and this permission notice appear in all
# copies, and that the name of Kubota Graphics not be used in
# advertising or publicity pertaining to this material.  Kubota
# Graphics Corporation MAKES NO REPRESENTATIONS ABOUT THE ACCURACY
# OR SUITABILITY OF THIS MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED
# "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE AND KUBOTA GRAPHICS CORPORATION DISCLAIMS ALL WARRANTIES,
# EXPRESS OR IMPLIED.
**************************************************************************/
 
/* #ident	"@(#)Readme	1.5"	3/7/89 */

See also Chapter 9 on Testing Dore in the Dore Implementation and Porting Guide.

		Demonstration Programs for the SunView-CXP Configuration
		--------------------------------------------------------

The example programs use the same main program and the same default interaction
controls.  The source code for these reside in the directory dui.
Other directories contain code and data that is specific to an example program.
To run one of the examples, cd to its directory and type runme.

Each example program creates its own graphics window, and responds to control
characters typed in that window, followed by a <cr>.
The following controls are common to most of the demos:

	A		toggle animation
	a|a[x|y|z]	toggle rotation around axis(axes)
	b r,g,b		set background color to r,g,b
	c		toggle backface culling
	C[012]		select color map
				0: compression of rgb into 3, 3, and 2 bits
				1: grey scale
				2: 8 color intensity rams 
	d		rotate through display representations:
				surface, point, wireframe
	h		toggle specular highlights
	S number	set level of subdivision of patches, spheres, etc.
	s		toggle shading style:
				flat, gouraud
	q, x		quit
	help		print list similar to this one
	debug		toggle debug
	DRx number	rotate by the specified number of degrees in x
	DRy number	rotate by the specified number of degrees in y
	DRz number	rotate by the specified number of degrees in z
	Dz number	zoom		
	Dtx number	translate in x
	Dty number	translate in y
	Dtz number	translate in z
	Dl number	change light intensity to the specified number
	
The example programs are:

breath
	A breathing cube bounces around in a box.  The breathing is accomplished
	by recomputing the geometry of the model for each time step.  After 
	computing the new geometry, the Dore model is recreated and displayed.
	Special control characters for this program:
		B		toggle cube breathe
		P		toggle cube bounce
		C		toggle cage visibility


flag
  	This program simulates a flag waving in the wind.  It is a constraint 
	based model, simulating the flag as a network of point masses connected 
	by springs, and simulating the wind as an applied force.  There is also 
	a gravitational force and the force applied by the flag pole at the two
  	attachment points.
	Special control characters for this program:
		f		release flag
		1		release top of flag
		2		release bottom
		* number 	wind direction 
		W number	wind speed (between 0. and 1.)

lwave
	This program demonstrates the wave equation applied to an L-shaped
	membrane.  Each time step of the solution is calculated and displayed
	interactively.  This involves solving a series of simultaneous
	differential equations for each time step.
	Special control characters for this program:
		LM number	mode (between 1.0 and 12.0)
		LH number    	height (between -1.0 and 1.0)
		LP number	phase (between -1.0 and 1.0)
		W number	speed (beween -1000.0 and 1000.0)

trunk
  	An octopus tentacle gropes around the screen like a palm frond
  	blowing in the wind.  Experience the thrill of controlling this beast.
	Special control characters for this program:
 		Ux number	x bend (between 0. and 1.)
 		Uy number	y bend		"
 		Uz number	z bend		" 
		Us number	speed (between 0. and 6.)



		Making the Example Programs
		---------------------------

The makefile in this directory makes all the example programs.  
Edit the makefile to set the variables:
	DORE_LOC -- the location of the dore directory
	DORE_OBJTYPE -- the machine object type
	DORE_LIBRARY -- set to dore.o or libdore.a

and then type
	make all

It is assumed that the dore.o or libdore.a is in DORE_LOC/dore/lib/DORE_OBJTYPE.
If this is not the case, the value of DORE in the makefiles in the 
subdirectories containing the demo code, must be changed.
