TrollVM README
Last updated:		2003-03-13
Release version:	0.1.2
------------------------------------------------------------------------

About:
------

TrollVM is an interpreter that enables the users of modern high-end
computers to play arcane low-end Sierra adventure games with slightly
improved graphics and sound using a mouse as an input device.

Development is being done on Microsoft Windows XP Professional SP1 using 
Microsoft Visual C++ .NET and SDL 1.2.5a. The code is ANSI C++ compliant,
but with Win32 specific extensions.


Installation:
-------------

1. Run setup.exe to install TrollVM files.
2. Download Mickey, Troll & Winnie from http://www.allowe.com
3. Place game files in their respective folders. 

Read "files.txt" for a list of needed files for each game.


Command Line Parameters:
------------------------

trollvm [game] [options]

mickey		Run "Mickey's Space Adventure"
winnie		Run "Winnie the Pooh in the Hundred Acre Wood"

-cga		Use CGA color dithering
-single		Use original size graphics (320x200), instead of double size (640x400)
-nosound	Disable sound output
-debug		Enable Mickey's internal debug mode

Examples:

trollvm winnie -cga			Runs WTP with CGA colors.
trollvm mickey -debug		Runs MSA and activates its debug mode.

Running trollvm.exe without any parameters invokes the built-in game selection menu.


Supported Games:
----------------

The following games should be completable:

- Mickey's Space Adventure					[mickey]
- Winnie the Pooh in the Hundred Acre Wood	[winnie]

The following games will be supported, but are currently unplayable:

- Gelfling Adventure						[gelfling]
- Troll's Tale								[troll]


Known issues:
-------------

Due to the lack of any beta testers, there can be lots of bugs that can even lead to a crash.

When using Nvidia Detonator WHQL 40.72 drivers, graphics corruption will occur in double size mode.
The non-WHQL 40.91 drivers work fine.

- Gen: Some pictures are drawn incorrectly due to imperfections in the fill/brush plot functions
- MSA: All animation is missing
- MSA: [Venus] You don't need to DOWN CHASM before you can USE ROPE
- WTP: Tigger/Mist events are not triggered


Improvements over the original Sierra interpreters:
---------------------------------------------------

- 16 color graphics
- Mouse support


Keyboard:
---------

Space	Next option
Enter	Select option
C		Show inventory
F11		Switch CGA/PCjr graphics
F12		Switch normal/double size graphics


Mouse:
------

Left	press "Any Key", select option, select "Yes"
Middle	show inventory
Right	select "No", select "Back"


Thanks to:
----------

Al Lowe for programming Troll's Tale and Winnie the Pooh.
Lance Ewing for the AGI picture drawing routines.
Peter Oliphant for programming Mickey's Space Adventure.
SDL for being a great cross-platform emulator programming library.
Sierra On-Line for the games this interpreter tries to interpret.
The ScummVM team for the inspiration to create this interpreter.


Legal Disclaimer:
-----------------

Gelfling Adventure
COPYRIGHT  1984
BY SIERRA ON-LINE, INC.
AND HENSON ASSOCIATES, INC.
TM DESIGNATES A TRADEMARK OF
SIERRA ON-LINE, INC.

Mickey's Space Adventure
Copyright  1986 Walt Disney Company
TM designates trademark of Sierra.
Licensed to Tandy Corp.

Troll's Tale
Copyright  1984 Sierra On-Line Inc.

Winnie the Pooh in The Hundred Acre Wood
TM designates trademark of
Sierra On-Line, Inc.
 1985 Walt Disney Productions

No game files are distributed with the TrollVM executable.
There is NO warranty of any kind.


Contact Info:
-------------

E-mail:	trollvm@hotmail.com
