Albion for the GP2X
Version 1.0.1

Installation
------------

Albion version 1.38 required for installation (English version prefered, but other languages should also work)

Simple instructions:
1) install Albion on your PC (using DOSBox for instance)
2) copy the ALBION subdirectory from CD onto harddisk (into the Albion directory tree)
3) in file SETUP.INI change the path (SOURCE_PATH) from CD to the copied directory on disk (using relative path)
4) copy the files from this archive into the install directory
5) copy it all onto SD card
6) run Albion.gpe on GP2X

Example (Detailed instructions):
1) install Albion on your PC (using DOSBox for instance)
    - create directory C:\Games
    - in dosbox: mount C:\Games as C:, mount cdrom as D:
    - in dosbox: install Albion into C:\ALBION

2) copy the ALBION subdirectory from CD onto harddisk (into the Albion directory tree)
    - create directory C:\Games\ALBION\ALBIONCD (that's C:\ALBION\ALBIONCD in dosbox) (the directory name must be DOS name - uppercase, at most 8 characters, no spaces, ...)
    - copy the content of directory cdrom:\ALBION into C:\Games\ALBION\ALBIONCD

3) in file SETUP.INI change the path (SOURCE_PATH) from CD to the copied directory on disk (using relative path)
    - in file C:\Games\ALBION\SETUP.INI find line which begins with SOURCE_PATH=
    - replace it with line SOURCE_PATH=ALBIONCD\

4) copy the files from this archive into the install directory
    - copy files from this archive (smk_play.exe, SR-Main.exe,
      Albion.gpe, Albion_LH.gpe, Albion_RH.gpe, Albion.png,
      Albion_LH.png, Albion_RH.png, Albion.cfg, Albion_LH.cfg,
      Albion_RH.cfg) to C:\Games\ALBION

5) copy it all onto SD card
    - copy the directory C:\Games\ALBION onto SD card

6) F100 USERS (non-touchscreen):

    - run Albion.gpe on GP2X

   F200 RIGHT-HANDED USERS:

    - run Albion_RH.cfg

   F200 LEFT-HANDED USERS:

    - run Albion_LH.cfg


Example\List-Demo.txt - list of files (after installation) - demo version
Example\List-Full.txt - list of files (after installation) - full version
Example\SETUP-Demo.INI - example SETUP.INI (after installation) - demo version
Example\SETUP-Full.INI - example SETUP.INI (after installation) - full version


Music
-------------
To get music you will need to install the timidity instruments by downloading
http://www.libsdl.org/projects/SDL_mixer/timidity/timidity.tar.gz
and either:
a) Extract it to the root of your SD card.
or
b) Extract it elsewhere on your SD card.
Then copy timidity.cfg to the albion directory and add this line at the start
dir /mnt/sd/path/to/timidity/
where path/to/timidity/ is the path to the timidity directory on your SD card.
You can use different timidity instruments, but these were the only ones tested.


Configuration
-------------

The Albion for GP2X supports multiple configuration files.
The configuration file to be used depends on the launch script.
Three launch scripts and configuration files are provided by default.
One is for F100 users or F200 users not wanting to use the touchscreen.
The other two are for left and right-handed F200 touchscreen users.

Some controls are not remappable.

See the files Albion.cfg, Albion_LH.cfg, and Albion_RH.cfg for more details.


Controls
--------

During intro/credits video:

X or Start: skip video
Vol+: volume up
Vol-: volume down


F100 CONTROLS:

In game:

L: switch between mouse and keyboard mode

Mouse mode:
Stick: move mouse
R+Stick: move mouse - double speed

Keyboard mode:
Stick: up/down/left/right arrow
R+Stick: ctrl+up/down/left/right arrow   [configurable]

Both modes:
B: left mouse click   [configurable]
X: right mouse click   [configurable]
Y: y   [configurable]
R+A: backspace   [configurable]
A: toggle scaling   [configurable]
Select: tab (display map)   [configurable]
R+Select: virtual keyboard   [configurable]

Vol+: volume up   [configurable]
Vol-: volume down   [configurable]

Start: pause/unpause game	[configurable]
L+R+Start: immediate exit (without saving anything)

Virtual keyboard:
Stick: move
B: select   [configurable]
L+R+Start: immediate exit (without saving anything)



F200 RIGHT-HANDED TOUCHSCREEN CONTROLS:

DPAD: up/down/left/right arrow
R+DPAD: ctrl+up/down/left/right arrow (move faster)  [configurable]
Vol-: toggle scaling   [configurable]
Vol+: left mouse click   [configurable]
L: right mouse click   [configurable]
Y: y   [configurable]
X: virtual keyboard   [configurable]
A: backspace   [configurable]
B: tab (display map)   [configurable]
Select: tab (display map)   [configurable]

L+Vol+: volume up   [configurable]
L+Vol-: volume down   [configurable]

Start: pause/unpause game	[configurable]
L+R+Start: immediate exit (without saving anything)

Virtual keyboard:
Vol+: select   [configurable]



F200 LEFT-HANDED TOUCHSCREEN CONTROLS:

A,B,X,Y: up/down/left/right arrow
L+A,B,X,Y: ctrl+up/down/left/right arrow (move faster)  [configurable]
Start: toggle scaling   [configurable]
Select: left mouse click   [configurable]
R: right mouse click   [configurable]
Up: y   [configurable]
Down: virtual keyboard   [configurable]
Left: backspace   [configurable]
Right: tab (display map)   [configurable]

Vol+: volume up   [configurable]
Vol-: volume down   [configurable]

L+Vol+: pause/unpause game	[configurable]
L+Vol-: pause/unpause game	[configurable]
L+R+Start: immediate exit (without saving anything)

Virtual keyboard:
Select: select   [configurable]


Misc
----

background sound/music effects (played using music driver) do not work


Changes
-------


v1.0.1 (2009-05-31)
* minor bug fixes
* speed optimizations


v1.0.0 (2009-03-21)
* the directory which contains the files from Albion CD, must be a subdirectory in the main Albion directory
  (or somewhere in the Albion directory tree)
* minor bug fixes
* minor optimalizations
+ added direct adjustment of GP2X volume through /dev/mixer

changes by Senor Quack:
+ Multiple configuration files supported
+ F200 touchscreen support for both left and right-handed users
* More flexible button remapping
+ Interpolated screen scaling is now togglable.  When a button is mapped to 
  this new command and is pressed, screen scaling is toggled off and the 
  middle 320 pixels of the game's internal 360-pixel-wide framebuffer are 
  blitted to the screen, allowing users to read text dialogs more easily
+ When using USB mouse/keyboard, the mouse scrollwheel toggles scaling on/off
+ New optional screen scaling for TV-out mode (see configuration files) so
  all of screen is now visible in TV mode
+ New icons


beta 3 (2008-11-15)
* bug fixes, bug fixes and more bug fixes
* minor optimizations
* internal changes


beta 2.1 (2008-07-03)
* fixed a memory leak
* fixed the option to skip intro when the config file is saved with dos/windows line breaks


beta 2 (2008-06-15)
+ working music (except background effects)
+ volume adjusting during intro video (Vol+ and Vol- buttons)
+ option to set intro volume in config file
+ option to skip intro in config file
* minor bug fixes


beta 1 (2008-03-19)
* minor bug fixes
* some internal changes
+ working sound
+ more configurable buttons (Vol+,Vol-,R+Vol+,R+Vol-)


alpha 3 (2007-12-27)
* fixed a bug when drawing a transparent wall (in 3D view)
+ added a sync call after saving a game
* turned off hw mouse cursor
+ configurable buttons (A,B,X,Y,Select,R+A,R+B,R+X,R+Y,R+Select)
* minor bug fixes


alpha 2 (2007-12-09)
* minor bug fixes (in recompilation)
* minor speed enhancements (in recompilation)
* more precise timer
+ virtual keyboard
+ ability to pause/unpause game
* interpolation bug fix
+ when TV-Out is detected (while initializing), native resolution (360x240) is used
* fixed possible deadlock when exiting via L+R+Start


alpha 1 (2007-11-30)
first public version
