foxbox/apps/plugins/xworld

This is the original readme from the "Fabother World" sources; the Rockbox port's
readme is in README.rockbox.

Franklin Wei

=================================================================================

This is "Fabother World": an Another World (Out Of This World in North America) interpreter codebase. This work is based on:

- Piotr Padkowski's newRaw interpreter which was based on
- Gregory Montoir's reverse engineering of
- Eric Chahi's assembly code.

I cleaned up a lot of the code, removing cryptic hexadecimal notation
with meaningful macros name. I also cleanup a lot of the code so it has a 
C/C++ philosophy instead of an assembly structure.

I also created a Visual Studio 2010 project.

TODO:

Create a MacOS X project.
Add a different rendering path OpenGL support.

Fabien Sanglard


raw README
Release version: 0.1.1 (May 15 2004)
-------------------------------------------------------------------------------

About:
------

raw is a re-implementation of the engine used in the game Another World. This 
game, released under the name Out Of This World in non-European countries, was 
written by Eric Chahi at the beginning of the '90s. More information can be 
found here : http://www.mobygames.com/game/sheet/p,2/gameId,564/.

Please be aware that, currently, this implementation may contains bugs and 
non-implemented features that make it impossible to finish the game.

Supported Versions:
-------------------

Currently, only the english PC DOS version is supported ("Out of this World").

Compiling:
----------

Tweak the Makefile if needed and type make (only gcc3 has been tested so far).
The SDL and zlib libraries are required.

Running:
--------

You will need the original files, here is the required list :
    BANK*
    MEMLIST.BIN
	
To start the game, you can either :
- put the game's datafiles in the same directory as the executable
- use the --datapath command line option to specify the datafiles directory

Here are the various in game hotkeys :
    Arrow Keys      allow you to move Lester
    Enter/Space     allow you run/shoot with your gun
    C               allow to enter a code to jump at a specific level
    P               pause the game
    Alt X           exit the game
    Ctrl S          save game state
    Ctrl L          load game state
    Ctrl + and -    change game state slot
    Ctrl F          toggle fast mode
    Alt Enter       toggle windowed/fullscreen mode
    Alt + and -     change scaler factor

Credits:
--------

Eric Chahi, obviously, for making this great game.

Contact:
--------

Gregory Montoir, cyx@users.sourceforge.net