USAGE

3Deng	[ --server | --server=hostname | --server=IP_address ] \
	[ cavefile(.cave) ] [ scenefiles(.sce) ] [ modelfiles(.obj) ]


DESCRIPTION

3Deng is a fullscreen OpenGL application.  All of the inputs are optional.
This document describes 3Deng when compiled as the Cave Demo application.

--server	Indicates that the application is a server, which means that it
		receives navigational information from a client which is
		responsible for connecting to it over the network.

--server=host	Indicates that the application is a client, which connects to a
--server=IP	server at the given hostname or IP address.  A client should
		have one of these parameters per server to which it connects.

cavefile	Cave configuration files are used to set cave attributes and to
(.cave)		specify a cave model.

modelfiles	Model files specify models to be loaded into a scene, aside from
(.obj)		those in the scene files.

scenefiles	Scene files specify a scene, including lights, models, and
(.sce)		terrains.  They can set the field-of-view, the viewport, the fog
		state, etc.


GENERAL RUNTIME COMMANDS

Ctrl-c	toggle control mode

		The idea of control mode is that there are two sets of input.
		One set is the input that sets display properties and provides
		display adjustment.  The second set is the user input as 
		specified by a particular application.  When control mode is on,
		the following display adjustment commands are available.  It is
		on/true by default.

c	toggle cave mode

		When cave mode is on/true, the scene is rendered from the
		point of view of the viewer looking through a cave facet.  When
		cave mode is off/false, the scene is rendered for a standard
		rectangular display.

F	toggle fog
s	toggle smooth shading
n	toggle surface normal display
Ctrl-d	toggle light token display
Ctrl-l	toggle lighting
p	toggle pause
t	toggle stereo mode

f	draw surfaces as filled polygons (default)
P	draw surfaces as vertex points
w	draw surfaces as lines(wireframe)

arrow keys translate the viewer
mouse buttons translate the viewer
mouse movement rotates viewer

Esc	exit program
	--client exit envokes exit on each server


CAVE ADJUSTMENT

M < > ?		Xscale	(default = 1)
m , . /		Yscale	(default = 1)
K L : "		Xskew	(default = 0)
k l ; '		Yskew	(default = 0)

		For the above commands, the far left adjustments ( M M K k )
		make large decrements.  The near left commands ( < , L l ) make
		small decrements.  The far right commands ( ? / " ' ) make
		large increments.  The near right commands ( > . : ; ) make
		small increments.

PgUp	increment cave facet index number
PgDown	decrement cave facet index number

		Facet indeces are from zero to one less than the total number of
		facets.

S	increment base side of cave facet

Home	rotate long facet side -> bottom
End	rotate long facet side -> top (default)


STEREO ADJUSTMENT

{ [ ] }		eye spacing

		As with cave scaling and skewing above, the outer keys are large
		adjustments; the inner keys are small adjustments.