README for Drill Jumbo Space
============================
Installing the Drill Jumbo Space
--------------------------------
After you have downloaded Digital Spaces and Drill Jumbo Space (see 
http://www.digitalspaces.net/projects/drilljumbo/ ), you should take the following steps:

Install Digital Spaces - Double click on the DigitalSpaces-0.6.1-443-PythonBundled.exe file
Use the default options, click Next until installation is complete.

Install Drill Jumbo - Double click on the DrillJumboVersion3.exe file. Use the default options, 
click Next until installation is complete.

Launch Digital Spaces - Double click the Launch Digital Spaces icon on the desktop, or click the 
Launch Digital Spaces icon in Program Files -> Digital Spaces.

Select a rendering system - For most systems, Direct3D is best. From the "Rendering Subsystem" box,
 select "Direct3D9 Rendering Subsystem". The default options are usually sufficient. Click OK.

Digital Spaces will launch, and present the Drill Jumbo Space.

Moving the viewpoint
--------------------
The Forward and Back arrow keys move the camera forward and backward
The Left and Right arrow keys rotate the camera left and right
PgUp tilts the camera up
PgDown tilts the camera down

Moving the vehicle
------------------
W	Forward
A	Turn Left
D	Turn Right
S	Reverse
E	Brake

These keys are laid out in an triangle on the left of your keyboard
 W E
A S D

Using the GUI
-------------
The arrow cursor on the GUI is controlled with the mouse. The GUI uses standard concepts like buttons
and lists.

Controlling the arms
--------------------
On the right of the screen is a list of the joints making up the arms.
For example:
	Right Boom - Left/Right
	Right Boom - Up/Down
	Right Boom - Extend/Retract
	Right Wrist - Up/Down
	Right Wrist - Left/Right
	Right Wrist - Twist
	
As you see, joints form logical groups (such as Right Boom).
Below this list, there are two buttons "Assign to vertical axis" and "Assign to horizontal axis".
These buttons assign the currently highlighted entry in the list of joints.

Below these buttons are five "radio" buttons, arranged in a + pattern.
When you assign a joint to the Vertical axis (the name will be shown to the left of the + arrangement),
the buttons in the top and bottom positions will affect this joint.
When you assign a joint to the Horizontal axis (the name will be shown to the right of the + arrangement),
the buttons in the left and right positions will affect this joint.
The center position will stop movement.
Assigning a joint to both axis will usually cause it to be locked in place.

This demonstration model is simple and allows you to assign any joint to either axis, 
however to make it easier to use, we recommend assigning Left/Right joints to the horizontal axis, and
up/down joints to the vertical axis.

Adjusting the shadows
---------------------
The keys 1, 2, 3, 4 (although not the number pad) will select the type of shadows being used in the scene.
	1 - Stencil Modulative - Crisp but dark
	2 - Stencil Additive - Crisp, more colour accurate then 1
	3 - Texture Modulative - Least accurate, but fast
	4 - No shadows