

                        ******* !ScummVM *******
                       	  SCUMM Interpreter
                             version 0.3
                             
                           original version
                          by Ludvig Strigeus

                      RISC OS port by David McEwen 
			      13/11/2001


Whats New
---------
   Everything


Known Issues
------------

   Will only work on machines which can handle a definable 256 colour palette
   
   Sound is only present in some games (DOTT & Sam and Max). This is the same with all versions
   of the interpreter.

	                          
Introduction
------------

This is an adventure game interpreter for the SCUMM system. The SCUMM system was created by
LucasArts when they wrote Maniac Mansion and was used in various games after that. It was
used to create some notable classics such as the Monkey Island series and Day of the Tentacle.
This interpreter does a pretty stunning job of playing a good portion of the games. At the 
moment the iMUSE system (context sensitive music) isn't supported, however there is sound 
support for spme games.

How do I use it ?
-----------------

Keys
----

The SCUMM system is mainly mouse driven and is thus fairly intuitive.
There are some special keys :

Select & Adjust -> skip cutscene
Ctrl-F -> fast version
Ctrl-G -> stupidly fast version (won't draw anything)
Ctrl-Z -> Quit

Shift+ <number 0-9> -> saves game into relevant slot

Ctrl+ <number 0-9> -> loads game from relevant slot

ATM the nice gui load/save system isn't function in this port... nor is the debugger


WITH FRONTEND
-------------

Basic Usage
-----------
*NOTE*
You will need to use a file system that supports more than 10 characters in a file name. 
Something like the new RISC OS 4 format or !RAFS will suffice.

Copy the games into the Games folder within !ScummVM.  This should be done in the following manner :

eg. Monkey Island 1 (CD version)
Inside Games create a folder called monkey then copy in the monkey/000 and monkey/001 files

For Day of the Tentacle & Sam and Max you should copy over the monster/sou file.

The folders required for each game are :

Monkey Island 1 -> monkey
Monkey Island 2 -> monkey2
Indiana Jones 4 -> atlantis
Indiana Jones 4 Demo -> playfate
Day of the Tentacle -> tentacle
Day of the Tentacle Demo -> dottdemo
Sam and Max -> samnmax
Sam and Max Demo -> snmdemo


If you want to modify some other settings more specfically for your system you can...
!ScummVM reads its settings from a human readable file contained within the app called gamedat.
Each game is set out like this :

[game]
name = 
year = 
rom = 
type = 
wimpslot = 

Name -> this is the name displayed in the Name box in the main window
Year -> Year the game was made
Rom -> gamename to look for (you shouldn't change this)
Type -> tells the f/e what type of rom set it is. 
	0 -> SCUMM (also do not change)
Wimpslot -> how much wimsplot is allocated before running each game.

The standard wimpslot values are quite generous as not all data is currently used, so you may
be able to run games happily with smaller settings.


WITHOUT FRONTEND
----------------

If you want to do it the hard way ;-)

You have to ensure that you have got the ScummVM exe in the same folder as the game or you
have set up the path to the exe and have the CSD set to the game folder.

Now type ScummVM <ganename>

It is recommended that you redirect output to a log file as it spews out a lot of text. You can
do this by tagging >log on the end of the above command.

Arguments:

	-b<num> -> enables to jump to room number <num>


PROBLEMS
--------

If you have a crash please tell me! Give me as much info as you can, otherwise it won't be 
fixed. It may be useful to provide the log file (which will be in the game folder) to help me 
track it down or pass it on to the main developers. Sorry, but I'm not psychic...
 


COMMENTS
--------


Any comments about RISC OS version:
email : david@acornemus.freeserve.co.uk (Home)
	davidm@argonaut.com (Work)
Website : http://www.acornemus.freeserve.co.uk

main ScummVM website: http://sourceforge.net/projects/scummvm

Thanks
------

Ludvig Strigeus for writing a brilliant open source interpreter!
Lionel Ullmer for tracking down some nastly alignment issues
Claudio Matsuoka for being a helpful and nice guy to chat to
Andreas Dehmel for Digital Renderer
Anyone else that has controbuted in some way to getting this RISC OS build to work.
and of course LucasArts for the games!
