diff options
author | Franklin Wei <frankhwei536@gmail.com> | 2014-10-13 21:00:47 -0400 |
---|---|---|
committer | Michael Giacomelli <giac2000@hotmail.com> | 2014-12-23 23:48:12 +0100 |
commit | 33cb13dee5a527ac445ea1b13d42723e4eb3e3b0 (patch) | |
tree | 3ce36ea21b53377b900049143e77e74b77ca1b0d /apps/plugins/xworld/README | |
parent | b681e932a9da797249ddc0e4ccab7ed7cf50fd41 (diff) | |
download | rockbox-33cb13dee5a527ac445ea1b13d42723e4eb3e3b0.tar.gz rockbox-33cb13dee5a527ac445ea1b13d42723e4eb3e3b0.zip |
Xworld - Another World interpreter for Rockbox
Co-conspirators: Franklin Wei, Benjamin Brown
--------------------------------------------------------------------
This work is based on:
- Fabien Sanglard's "Fabother World" based on
- Piotr Padkowski's newRaw interpreter which was based on
- Gregory Montoir's reverse engineering of
- Eric Chahi's assembly code
--------------------------------------------------------------------
Progress:
* The plugin runs pretty nicely (with sound!) on most color targets
* Keymaps for color LCD targets are complete
* The manual entry is finished
* Grayscale/monochrome support is NOT PLANNED
- the game looks horrible in grayscale! :p
--------------------------------------------------------------------
Notes:
* The original game strings were built-in to the executable, and
were copyrighted and could not be used.
* This port ships with an alternate set of strings by default, but
can load the "official" strings from a file at runtime.
--------------------------------------------------------------------
To be done (in descending order of importance):
* vertical stride compatibility <30% done>
* optimization <10% done>
Change-Id: I3155b0d97c2ac470cb8a2040f40d4139ddcebfa5
Reviewed-on: http://gerrit.rockbox.org/1077
Reviewed-by: Michael Giacomelli <giac2000@hotmail.com>
Diffstat (limited to 'apps/plugins/xworld/README')
-rw-r--r-- | apps/plugins/xworld/README | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/apps/plugins/xworld/README b/apps/plugins/xworld/README new file mode 100644 index 0000000000..3a07b1ba94 --- /dev/null +++ b/apps/plugins/xworld/README | |||
@@ -0,0 +1,86 @@ | |||
1 | This is the original readme from the "Fabother World" sources; the Rockbox port's | ||
2 | readme is in README.rockbox. | ||
3 | |||
4 | Franklin Wei | ||
5 | |||
6 | ================================================================================= | ||
7 | |||
8 | This is "Fabother World": an Another World (Out Of This World in North America) interpreter codebase. This work is based on: | ||
9 | |||
10 | - Piotr Padkowski's newRaw interpreter which was based on | ||
11 | - Gregory Montoir's reverse engineering of | ||
12 | - Eric Chahi's assembly code. | ||
13 | |||
14 | I cleaned up a lot of the code, removing cryptic hexadecimal notation | ||
15 | with meaningful macros name. I also cleanup a lot of the code so it has a | ||
16 | C/C++ philosophy instead of an assembly structure. | ||
17 | |||
18 | I also created a Visual Studio 2010 project. | ||
19 | |||
20 | TODO: | ||
21 | |||
22 | Create a MacOS X project. | ||
23 | Add a different rendering path OpenGL support. | ||
24 | |||
25 | Fabien Sanglard | ||
26 | |||
27 | |||
28 | raw README | ||
29 | Release version: 0.1.1 (May 15 2004) | ||
30 | ------------------------------------------------------------------------------- | ||
31 | |||
32 | About: | ||
33 | ------ | ||
34 | |||
35 | raw is a re-implementation of the engine used in the game Another World. This | ||
36 | game, released under the name Out Of This World in non-European countries, was | ||
37 | written by Eric Chahi at the beginning of the '90s. More information can be | ||
38 | found here : http://www.mobygames.com/game/sheet/p,2/gameId,564/. | ||
39 | |||
40 | Please be aware that, currently, this implementation may contains bugs and | ||
41 | non-implemented features that make it impossible to finish the game. | ||
42 | |||
43 | Supported Versions: | ||
44 | ------------------- | ||
45 | |||
46 | Currently, only the english PC DOS version is supported ("Out of this World"). | ||
47 | |||
48 | Compiling: | ||
49 | ---------- | ||
50 | |||
51 | Tweak the Makefile if needed and type make (only gcc3 has been tested so far). | ||
52 | The SDL and zlib libraries are required. | ||
53 | |||
54 | Running: | ||
55 | -------- | ||
56 | |||
57 | You will need the original files, here is the required list : | ||
58 | BANK* | ||
59 | MEMLIST.BIN | ||
60 | |||
61 | To start the game, you can either : | ||
62 | - put the game's datafiles in the same directory as the executable | ||
63 | - use the --datapath command line option to specify the datafiles directory | ||
64 | |||
65 | Here are the various in game hotkeys : | ||
66 | Arrow Keys allow you to move Lester | ||
67 | Enter/Space allow you run/shoot with your gun | ||
68 | C allow to enter a code to jump at a specific level | ||
69 | P pause the game | ||
70 | Alt X exit the game | ||
71 | Ctrl S save game state | ||
72 | Ctrl L load game state | ||
73 | Ctrl + and - change game state slot | ||
74 | Ctrl F toggle fast mode | ||
75 | Alt Enter toggle windowed/fullscreen mode | ||
76 | Alt + and - change scaler factor | ||
77 | |||
78 | Credits: | ||
79 | -------- | ||
80 | |||
81 | Eric Chahi, obviously, for making this great game. | ||
82 | |||
83 | Contact: | ||
84 | -------- | ||
85 | |||
86 | Gregory Montoir, cyx@users.sourceforge.net | ||