Terra v1.0

by Richard C. Davis
rcdavis@cs.berkeley.edu
http://www.cs.berkeley.edu/~rcdavis/terra
------------------------------------------------------------

Contents
--------
	1) What is "Terra?"
	2) How do I run it?
	3) What can I do with it?
	4) How can I tell Richard how cool/uncool this is?
	5) What would a lawyer have to say about this?



1) What is "Terra?"
-------------------
	"Terra" is a terrain generator that allows you to fly 
	through entire planets.  The name "Terra" is short for
	"Terraformer."

2) How do I run it?
-------------------
	Just type "terra" from a Windows95 or WindowsNT prompt
	or click on its icon.  If you run terra from a prompt,
	you can use two optional command line arguments.

	Option	Function
	-----------------------------------------------------
	-seed	<n>	Uses the number <n> as a random seed to 
				generate the planet
	<file.pos>	Starts in the location specified in 
				<file.pos>.  These files can be
				created by pressing "p" during a
				fly through.

3) What can I do with it?
-------------------------
	Have beaucoup fun, of course!  Here's an overview.

	Flying
	------
		Clicking with the left mouse button will fly 
			you toward the mouse cursor.
		Clicking with the right mouse button will fly 
			you backward tilting away from the mouse
			cursor.
		Clicking with the middle mouse button will  
			rotate you in place toward the mouse 
			cursor.

	Speed
	-----
		+	Speeds you up
		-	Slows you down

	Level of Detail
	---------------
		i	Increases the detail
		d 	Decreases the detail
		
	Save Current Position
	---------------------
		p	Saves the current position to the file
			"current.pos" in the current directory.
  			This file can be used as a command line 
			argument to return to this spot.

	Other Commands
	--------------
		o	Toggles on/off the orientation bars shown
			to the left and below the view window.
		r	Resets you to your starting position.
		s	Toggles the Shading mode.  Allows you to
			see the world as a wire frame.
		Esc	Exits the program



4) How can I tell Richard how cool/uncool this is?
--------------------------------------------------
	Write to me!  I'd love to hear comments, and I'd like
	to expand this, integrate it with other programs
	(anyone writing cool space exploration games?), or
	fix some of the lingering bugs if people are 
	interested.  

	Write to rcdavis@cs.berkeley.edu.


5) What would a lawyer have to say about this?
----------------------------------------------
	Probably something about how this program is 
	copyrighted by me, Richard C. Davis, and how you are 
	free to distribute it any way you like as long as
	you distribute this file with it.  In classic GNU
	spirit, I'll add that this comes with ABSOLUTELY
	NO WARRENTY!