        RenderWare(tm) v1.3 MS Windows 3.1 RollerCoaster Demo
        =====================================================

----------------------------------------------------------------------------
This demonstration program is copyright Criterion Software Limited 1994. 
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.


This demonstration program may not be redistributed for commercial purposes
without the prior consent of Criterion Software Ltd. If this demonstration
program is redistributed this file must be included, unmodified in the
distribution.

RenderWare is a trademark of Canon Inc.
----------------------------------------------------------------------------

This directory contains an MS Windows 3.1 demonstration program which
simulates a ride on a rollercoaster.

Installation
============

Create a new directory for the demonstration program somewhere on your
hard drive. Make this directory the current directory. Unzip the
demonstration archive as follows:

    pkunzip -d rwroller.zip

The demonstration program assumes that the scripts and textures it
needs can be found in two sub-directories (called "SCRIPTS" and
"TEXTURES" respectively) of the directory in which the demonstration
executable is located. The directory in which the executable is
placed must contains the "SCRIPTS" and "TEXTURES" sub-directories.
Furthermore, the four sample rollercoaster definition files
(track1.rrc, track2.rrc, track3.rrc and track4.rrc) and the data
file rwroller.pal should be in the same directory as RWROLLER.EXE.


Running the Demonstration
=========================

To execute the demonstration use the Run... menu from either
the Program or File Manager or double click on the executable's
icon in the File Manager window.


Microsoft's WinG API
====================

This demonstration includes support for the beta of Microsoft's
WinG API. WinG provides fast screen updates under Windows. This
demonstration will make use of WinG by default. If you do not
have WinG installed on your system you can prevent the
demonstration from using it by specifying the command line
argument -g when executing the rollercoaster demonstration.
If you are using WinG the "Options" menu item
"Stretch output..." will be enabled selecting this option
will make the demonstration render at a lower resolution and
stretch the output to fit the window. This will increase
performance at the expense of quality.


The Demonstration
=================

The rollercoaster demonstration allows you to ride one of four
sample "virtual" rollercoasters and furthermore, due to the
real-time nature of RenderWare's 3D, you can interactively design
a new rollercoaster. You can also choose different camera views
of the ride.

The Demonstration Controls
==========================

Most of the demonstration's functionality is controlled by a series
of menus. These menus are as follows:

The File Menu
-------------

    New     - Discard the current rollercoaster and replace it with
              a default rollercoaster (an entirely flat rollercoaster
              following a circular path).

    Open    - Brings up a (fully interactive, real-time) menu of
              the four sample coasters. Simply click on one of the
              rollercoasters to ride that coaster. Furthermore, by
              clicking on the More... button a standard Windows
              open file dialog is displayed from which you may select
              a rollercoaster previously designed and saved
              (rollercoaster definition files have the extension .rrc).

    Save    - Saves the current rollercoaster. If the rollercoaster
              has not previously been loaded from a file you will be
              prompted for a file name.

    Save As - Saves the current rollercoaster under a new file name.
              The standard Windows save file dialog will be displayed.

The Edit Menu
-------------

    Description - Edit the current descriptive string for the
                  rollercoaster. The descriptive string is displayed
                  in the window title when the rollercoaster is being
                  ridden.

    Side view   - Switch to a side view of the rollercoaster. In
                  this mode the rollercoaster can be edited.

                  Moving the mouse horizontally while holding the
                  left mouse button down pans the camera around the
                  rollercoaster. Moving the mouse vertically while
                  holding the left mouse button down zooms the
                  camera toward and away from the rollercoaster.

                  If you hold the SHIFT key and the left button
                  while dragging the mouse the camera will change
                  in altitude.

                  You will notice a number of yellow cones resting
                  on the rollercoaster's track. These yellow cones
                  control the path taken by the rollercoaster. By
                  clicking on a yellow cone and dragging the mouse
                  button you can change the position of the yellow
                  cone. When the cone is released the rollercoaster
                  will be rebuilt to reflect the new position of
                  the cone. If you switch back to riding the
                  rollercoaster using the Ride item of the Viewpoint
                  menu you will begin to ride the new track.

    Top view    - Switch to a top view of the rollercoaster. In this
                  mode you are floating above the coaster looking
                  down on it. In this mode the rollercoaster can be
                  edited.

                  Moving the mouse horizontally while holding the
                  left mouse button down moves the camera
                  horizontally over the rollercoaster. Moving the
                  mouse vertically while holding the left mouse
                  button down moves the camera vertically over the
                  rollercoaster.

                  If you hold the SHIFT key and the left button
                  while dragging the mouse the camera will change
                  in altitude.

                  You will notice a number of yellow cones resting
                  on the rollercoaster's track. These yellow cones
                  control the path taken by the rollercoaster. By
                  clicking on a yellow cone and dragging the mouse
                  button you can change the position of the yellow
                  cone. When the cone is released the rollercoaster
                  will be rebuilt to reflect the new position of
                  the cone. If you switch back to riding the
                  rollercoaster using the Ride item of the Viewpoint
                  menu you will begin to ride the new track.

The Viewpoint Menu
------------------

    Ride        - Switch to a camera mode where you are riding the
                  in the rollercoaster's car. Use this mode for
                  maximum effect!

    Trail       - Switch to a camera mode where the camera is behind
                  the rollercoaster's car.

    Lead        - Switch to a camera mode where the camera leads
                  the rollercoaster's car and points back toward the
                  car.

    Spotter     - Switch to a camera mode where the camera circles the
                  moving rollercoaster car.

The Options Menu
----------------

    Stretch output - This option is only available if using Microsoft's
                     WinG API. See the section on WinG in this document
                     for more information.

    Show car       - Shows or hides the rollercoaster car.

The Help Menu
-------------

    About...       - Displays an about box for this demonstration.

    

       ==========================================================

