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

PURPOSE

The SKYDOME application may be used to generate a RenderWare model of a 
skydome using realistic clear-sky colors. The algorithm used to calculate
physically-based sky colors was developed by Preetham et al[1], which is
the result of a large-scale simulation of the multiple-scattering of 
sunlight in the Earth's atmosphere as seen by an observer on the surface
of the Earth. The results of this simulation were then condensed into an 
analytical form with three main dependencies: (a) the position of the Sun 
in the sky, (b) the direction in the sky the observer is looking, and (c) 
the turbidity of the atmosphere (a measure of the prevailing haziness of 
the air). In analytical form the algorithm is very fast to evaluate and is 
used here in real-time to calculate the sky color at each vertex of the 
skydome, leaving the Gouraud shading to 'fill' in the rest.

The application can be interacted with in the following principal ways:

(A) Edit the skydome by changing the number of vertices and triangles 
    defining the dome's geometry. The greater the number of triangles 
    the better the visual result. Use the 'wire mesh' mode to visualize
    how finely the skydome has been tessellated.

(B) Edit the position of the Sun on the skydome using the mouse. This 
    can done in real-time, though be prepared for a slight delay if the 
    skydome geometry has been highly tessellated! Each time the Sun is
    moved the colors of the whole skydome have to be recalculated. Best
    results will be obtained if the position of the Sun coincides with
    a skydome vertex.

(C) Preview the appearance of the skydome as it would be seen if saved 
    and imported into another 'practical' application. In this mode the
    camera is placed at the center of the skydome, which can then be 
    pointed in any direction to observe any part of the sky. A lens-flare
    effect has been added for camera views directed towards the Sun, both
    for realism and as an aid to pin-point the position of the Sun in the
    sky (not always obvious due to the discrete nature of geometry).

(D) Edit the exposure value used to render each frame. The exposure is
    introduced to provide a quick 'n' dirty way of transforming the 
    real-world color values produced by the algorithm to RGB colors
    for display on a monitor screen.

Reference:

[1] Preetham A J, Shirley P, and Smits B, 
    "A Practical Analytic Model for Daylight", 
    Proceedings of SIGGRAPH 1999. In Computer Graphics Proceedings,
    Annual Conference Series, 1999, ACM SIGGRAPH, pp. 91-100.

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

Left mouse button   - In 'preview' mode, change the camera's view 
                      direction. Otherwise, rotate the skydome.

Right mouse button  - In 'preview' mode, change the camera's horizontal
                      field-of-view (degrees). Otherwise, translate the
                      skydome to and from the camera.
CTRL+
Left mouse button   - Change the position of the Sun in the sky.

SPACE               - Toggle menu/help/plain mode.

ESC                 - Exit the application.

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

RESOLUTION       - Choose the skydome's tessellation resolution. This 
                   number specifies the number of intervals in elevation.
                   The number of intervals in azimuth is four times this.
                   (Elevation <--> Latitude, Azimuth <--> Longitude.)

TESSELLATE       - Re-tessellate the skydome using the currently
                   selected resolution.

EXPOSURE         - Choose an exposure value which is used to convert the
                   real-world sky colors to RGB colors.

PREVIEW          - Move the camera to the center of the skydome to give
                   a view of the sky as it would be seen 'in situ'.

SKY              - Toggle the display of skydome colors.

GROUND           - Toggle display of the ground plane.
                   (Not available in 'preview' mode - the ground plane is 
                   not visible from the center of the skydome).

WIRE MESH        - Toggle display of a wire-mesh approximation of the 
                   elevation/azimuth grid. In terms of the geometry of
                   the skydome, each displayed quad contains two triangles.

NORMAL           - Toggle display of the vertex normals.
                   (Not available in 'preview' mode - the normals aren't 
                   visible from the center of the skydome as they point 
                   directly at the camera).

LENS EFFECT      - Toggle display of the lens-flare effect.
                   ('Preview' mode only.)

CAMERA SPIN      - Toggle camera rotational momentum.
                   ('Preview' mode only.)

SAVE DOME        - Save a copy of the skydome clump to a RenderWare DFF 
                   binary file.

DISPLAY DATA     - Toggle all on-screen information (direction of the Sun,
                   camera orientation, numbers of vertices and triangles).
                   Menu not included.

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 2001. 
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.
--------------------------------------------------------------------------
