--------------------------------------------------------------------------
      RenderWare(tm) v3.1 Demonstration Program (sky): Particles1
--------------------------------------------------------------------------

PURPOSE

The PRTCLS1 example illustrates the following:

(1) How to load an exported particle clump and include it in a world.
    There are various different particle clumps which can be loaded,
    including smoke, fire and water examples.

(2) How to create and manipulate the properties of a particle clump in
    RenderWare. The example provides a comprehensive interface such that
    all the properties of a particle system can be changed interactively.
  
--------------------------------------------------------------------------
GENERAL CONTROLS

Left analogue stick      - Rotates the particle emitter.

Right analogue stick     - Translates the particle emitter towards and away
                           from the camera.
                          
SELECT button            - Toggle menu/help/plain mode.

START+SELECT             - Quit the application.

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

PARTICLE SYSTEM         - Allows the user to load a particle system or
                          create their own.

PARTICLE TEXTURE        - Changes the texture used for each particle in 
                          the system. The textures that have been provided
                          demonstrate various different shapes of particle.

PARTICLE NUMBER         - Changes the number of particles in the system.

EMITTER WIDTH, HEIGHT   - Changes the size of the (rectangular) emitter.

EMITTER ANGLE           - Changes the angle of through which particles are
                          emitted.

PARTICLE SIZE, 
ASPECT-RATIO            - Allows the user to change the size of the
                          rectangle representing each individual particle.

PARTICLE GROWTH         - Changes how much the particle size will change
                          during their life span. If greater than one the
                          particles will get larger the further away they
                          are from the emitter. If the value lies between
                          zero and one the particle will decrease in size
                          as they move away from the emitter.

FLIGHT TIME             - Allows the user to change the length of time the
                          particles exists for after it leaves the emitter.

MINIMUM, MAXIMUM SPEED  - Allows the user to control the initial speed of 
                          the particles in the system.

DAMPING                 - Controls how quickly the outer particles move 
                          with respect to the inner particles. A value of
                          one means that all the particles are moving at
                          the same speed; greater than one results in the
                          outside ones moving slower than the inside ones.

FORCE-X, -Y, -Z         - Allows the user to adjust the individual
                          components of the vector which represents any
                          forces acting on the particles after they have
                          left the emitter.

START COLOR, ALPHA      - Allows the user to change the starting color and
                          alpha of the particles.

END COLOR, ALPHA        - Allows the user to change the final color and 
                          alpha of the particles.

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

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

DPAD UP and DOWN        - Select menu item.

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

Left analogue stick     - Modify floating point value (if applicable) 
                          otherwise do what you would do in general 
                          controls.

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

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

LEFT SHOULDER #1 and #2  - Scroll a page at a time.

--------------------------------------------------------------------------
VIDEO MODE SELECTION

The command-line option '-vms' can be used to enable a simple video 
selection screen, which appears before the application starts running. 
Use the UP and DOWN DPAD buttons to highlight the required video
mode and press START to make the selection. Note there are several pages
of video modes; use the LEFT SHOULDER buttons to move from page to page.

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