Commands For GameFlow Script		-		J.Gosling 1997
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sequence Commands
~~~~~~~~~~~~~~~~~
Defined in LEVELS:, DEMOS:, CREDITS: & FRONTEND: parts of
the script.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

STARTLEVEL:

Defines the point in a level sequence when the level is
actually loaded and played.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

PICTURE: [filename] [seconds]

Displays a picture for a number of seconds.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

FMV: [filename] [value]

Plays a FMV sequence with a 'frigfactor' value?

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ENDSEQ:

Marks the end of a sequence.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

LIST_START:

Defines the start of a list of commands which will be
cut short if the user presses a key/button.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

LIST_END:

Defines the end of a list of commands which will be cut
short if the user presses a key/button.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Demo Commands
~~~~~~~~~~~~~
Defined in [SETUP] part of script.

The following commands should only be used for making demos.
Their default values are set for normal release versions.



LOCKOUT_MAINRING

Stops the user from accessing the passport ring in-game.
Useful for demos only.  Default is unlocked.

eg.
'LOCKOUT_MAINRING:'

Values set;-
gameflow.lockout_mainring = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DISABLE_SCREENSIZING

Disables screen sizing keys and operations.  Default is 
enabled.

eg.
'DISABLE_SCREENSIZING:'

Values set;-
gameflow.screensizing_disabled = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DISABLE_LOADSAVE

Disables load/save operations.  Default is enabled.

eg.
'DISABLE_LOADSAVE:'

Values set;-
gameflow.disable_loadsave = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ENABLE_DOZY_CHEAT

Enables a simplified cheatmode check.  Default is disabled

eg.
'ENABLE_DOZY_CHEAT:'

Values set;-
gameflow.allow_dozy_cheat = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DISABLE_CHEATMODE_CHECK

Disables release version of the cheat mode check. Default
is enabled.

eg.
'DISABLE_CHEATMODE_CHECK:'

Values set;-
gameflow.cheatmodecheck_disabled = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_ONDEMO_END [option]

Sets the operation to be performed when a recorded demo
ends.  Default is EXIT_TO_TITLE on PC and EXIT_TO_FRONT on
PSX.

eg.
'SET_ONDEMO_END STARTDEMO:' will start another recorded
demo when one ends.

Values set;-
gameflow.on_demo_end = [option];

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_ONDEMO_INTERRUPT [option]

Sets the operation to be performed if a recorded demo is
interrupted by a key/button press. Default is EXIT_TO_TITLE

eg.
'SET_ONDEMO_INTERRUPT: STARTGAME|3' will go load a start
the third level.

Values set;-
gameflow.on_demo_interrupt = [option];

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ENABLE_NOINPUT_TIMEOUT

Enables timeouts in-game if idle. Used for show demos.
Default in disabled.

eg.
'ENABLE_NOINPUT_TIMEOUT:' Oh yes.

Values set;-
gameflow.noinput_timeout = 1;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_NOINPUT_TIME [seconds]

Sets how long to stand if there is no user input.  Normally
used on consoles for going into attract demo mode when idle
in title ring sequence.  Also used for show demos when idle
in-game if 'ENABLE_NOINPUT_TIMEOUT' is set.

eg.
'SET_NOINPUT_TIME: 30' will set timeout to 30 seconds

Values set;-
gameflow.noinput_time = [seconds]*30;

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_ONDEATH_INGAME [option]

Set what operation is called for if Lara dies in-game.
Default is EXIT_TO_TITLE.

eg.
'SET_ONDEATH_INGAME: STARTDEMO' will go into demo mode if 
Lara dies in-game.

Values set;-
gameflow.ondeath_ingame = [option]

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_ONDEATH_DEMOMODE [option]

Set what opration is called for if Lara dies in recorded
demo.  Default is EXIT_TO_TITLE.

eg.
'SET_ONDEATH_DEMOMODE: STARTDEMO' will play another demo if
Lara dies.

Values set;-
gameflow.ondeath_demo_mode = [option];

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ENABLE_SINGLELEVEL [level no.]

Enables and sets single level mode for demos.

eg.
'ENABLE_SINGLELEVEL: 3' will only allow level 3 to be
played. Default is disabled.

Values set;-
gameflow.singlelevel_enabled = [level no.]

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SET_FIRSTOPTION [option]

Enables another operation to be performed before the title
ring sequence.

eg.
'SET_FIRSTOPTION: STARTDEMO' plays demos before title ring.

Default is 'EXIT_TO_TITLE'.

Values set;-
gameflow.firstOption = [option];

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

REPLACE_TITLE [option]

Replaces the normal title ring with another operation.

eg. 
REPLACE_TITLE: STARTDEMO
Plays demos instead.  Useful only in cover/show demos
of course.  Default is none.

Values set;-
gameflow.title_enabled = 0;
gameflow.title_replace = [option];
