--------------------------------------------------------------------------
        RenderWare(tm) v3.1 Demonstration Program (win): Dice
--------------------------------------------------------------------------

PURPOSE

The DICE demo features a simple game of Yahtzee that (a) uses rigid-body 
dynamics to simulate how the dice move and respond to collisions, and
(b) uses the RenderWare 3D graphics API to setup and render the geometry 
and lighting contained in the game. More importantly, RenderWare is used 
as our first line of attack for detecting collisions between the dice 
and the dice table, and between the dice themselves.

The dice table geometry is contained in a BSP structure specifically 
aimed at very fast collision detection with other (non-BSP) objects 
moving in the world defined by the BSP. Also, because objects are tied 
to the world by location, it is very simple and efficient to perform 
collision detection between these moving objects.

In this demo, RenderWare's intersection schemes are used as a first-level, 
coarse-grained collision detection process. For collisions between the 
dice and the table, this amounts to finding intersections of the dice 
bounding-spheres with the table triangles. When an intersection is 
found, a second-level (application-specific) test is performed that 
determines if any of the die's vertices are in collision with the 
supplied collision triangle or triangles. Similarly, for collisions 
between the dice, bounding-sphere tests are performed, but the process 
stops there and a collision response is calculated that assumes the 
colliding bodies act like hard spheres.

You have three rolls of the dice to achieve a winning combination. Roll 
the dice by clicking with the right mouse button. Once the dice have 
settled you can choose to save some before you roll again. Do this by 
picking the dice with the right mouse button while the shift button is 
pressed. In preview mode, which  can be toggled on and off with
the menu, whenever the mouse cursor moves over a die its face value is 
displayed close by. Preview mode is useful for those occasions when the 
dice are bunched together on the table and it is not obvious which one 
will be picked when you click that mouse button - remember, there's no 
undo - or for those camera angles (see below) where the dice values are 
hard to see.

--------------------------------------------------------------------------
GENERAL CONTROLS

Left mouse button        - Select one of the dice.

Right mouse button       - Roll the dice.

CTRL +
Left mouse button drag   - Point the camera in a different direction.

CTRL +
Right mouse button drag  - Translate the camera forwards and backwards.

SPACE                    - Toggle menu/help/plain mode.

ESC                      - Exit the application.

--------------------------------------------------------------------------
MENU OPTIONS

PRESET VIEW             - Select a preset camera view.

DIE PREVIEW             - Toggle die value preview.

FIELD OF VIEW           - Changes the horizontal field-of-view of the 
                          camera (degrees).

FPS                     - Allows the user to read the number of frames per
                          second being rendered (updated every second).

--------------------------------------------------------------------------
MENU CONTROLS

CURSOR UP and DOWN      - Select menu item.

CURSOR LEFT and RIGHT   - Modify menu item value or execute associated 
                          command.

Menu shortcut keys      - Modify menu item value or execute associated 
                          command.

Left mouse button drag  - Modify floating point value (if applicable) 
                          otherwise do what you would do in general 
                          controls.

--------------------------------------------------------------------------
HELP CONTROLS

CURSOR UP and DOWN      - Scroll a line at a time (autorepeat available).

PAGE UP and DOWN        - Scroll a page at a time.

Mouse Wheel scroll      - Scroll up or down the page using the mouse wheel
                          (if available).

--------------------------------------------------------------------------
This demonstration program is copyright Criterion Software Limited 2000. 
Criterion Software grants you a license to use it only in the form as 
supplied. You may not disassemble, decompile or reverse engineer this 
demonstration program.

This demonstration program is provided as is with no warranties of any
kind. Criterion Software will not, under any circumstances, be liable for
any lost revenue or other damages arising from the use of this
demonstration program.

RenderWare is a registered trademark of Canon Inc.
Other trademarks acknowledged.
--------------------------------------------------------------------------
