X-COM: UFO Defense for the GP2X
Version 1.0.2

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

X-COM: UFO Defense version 1.4 required for installation

Simple instructions:
1) install X-COM: UFO Defense on your PC (using DOSBox for instance)
2) copy the files from this archive into the install directory
3) copy it all onto SD card
4) run xcom1.gpe on GP2X

Example (Detailed instructions):
1) install X-COM: UFO Defense 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 X-COM: UFO Defense into C:\UFO

2) copy the files from this archive into the install directory
    - copy files from this archive (SR-Intro.exe, xcom1.gpe
      xcom1_rh.gpe, xcom1_lh.gpe, xcom1.png, xcom1_rh.png,
      xcom1_lh.png, Ufo.cfg, Ufo_F200RH.cfg, Ufo_F200LH.cfg
      UFOEXE\SR-Geoscape.exe, UFO2EXE\SR-Tactical.exe) to C:\Games\UFO

   FOR CLARIFICATION:
   See Example\List.txt - list of files (after installation)

3) copy it all onto SD card
    - copy the directory C:\Games\UFO onto SD card

4) F100 USERS (non-touchscreen):

    - run xcom1.gpe on GP2X

   F200 RIGHT-HANDED USERS:

    - run xcom1_rh.gpe

   F200 LEFT-HANDED USERS:

    - run xcom1_lh.gpe



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 UFO 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 X-COM 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.

See the files Ufo.cfg, Ufo_F200LH.cfg, and Ufo_F200RH.cfg for more details.
 
Some controls are not remappable.  An example of these are the buttons used
for scrolling and rotating.


Controls
--------

During intro video:

A,B,X,Y,Start,Select: skip video
Vol+: volume up
Vol-: volume down


In game:


F100 USERS:

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

Both modes:
B: left mouse click   [configurable]
R+B: enter   [configurable]
X: right mouse click   [configurable]
Y: y key   [configurable]
A: backspace   [configurable]
R+Select: virtual keyboard   [configurable]
Start: pause/unpause game
L+R+Start: immediate exit (without saving anything)
Vol +/-: volume up/down	[configurable]
L+Vol +/-: Geoscape zoom, Battlescape up/down level
L+Stick: Rotate Geoscape, Scroll Battlescape
Select: Geoscape set time to 5 secs, Battlescape select next soldier   [configurable]
L+Select: Geoscape set time to 1 day, Battlescape deselect current soldier   [configurable]

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


F200 RIGHT-HANDED TOUCHSCREEN USERS:

Mouse mode:
Stylus: move mouse

Both modes:
Vol+: left mouse click   [configurable]
Vol-: right mouse click   [configurable]
B: enter   [configurable]
Y: y key   [configurable]
A: backspace   [configurable]
X: virtual keyboard   [configurable]
Start: pause/unpause game
L+R+Start: immediate exit (without saving anything)
L+Vol +/-: volume up/down	[configurable]
DPAD: Rotate Geoscape, Scroll Battlescape
L+Up/Down: Geoscape zoom, Battlescape up/down level
Select: Geoscape set time to 5 secs, Battlescape select next soldier   [configurable]
L+Select: Geoscape set time to 1 day, Battlescape deselect current soldier   [configurable]

Virtual keyboard:
Stylus: move
Vol+: select  
L+R+Start: immediate exit (without saving anything)


F200 LEFT-HANDED TOUCHSCREEN USERS:

Mouse mode:
Stylus: move mouse

Both modes:
Select: left mouse click   [configurable]
Start: right mouse click   [configurable]
Right: enter   [configurable]
Up: y key   [configurable]
Left: backspace   [configurable]
Down: virtual keyboard   [configurable]
L+Down: pause/unpause game
L+R+Start: immediate exit (without saving anything)
Vol +/-: volume up/down	[configurable]
A/B/X/Y: Rotate Geoscape, Scroll Battlescape
R+X/Y: Geoscape zoom, Battlescape up/down level

Virtual keyboard:
Stylus: move
Select: select  
L+R+Start: immediate exit (without saving anything)


Changes
-------

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


v1.0.1 (2009-01-24)
+ Battlescape "Select next soldier" and "Deselect current soldier" macros
+ Geoscape "Set time to 5 secs" and "Set time to 1 day" macros
* added a fix for the "Difficulty bug"
* when the display is in original mode (not stretched), it's vertically centered on screen
* minor bug fixes


v1.0.0 (2009-01-10)
* renamed configuration file UFO.cfg to Ufo.cfg
+ working intro
+ added a sync call after saving a game
+ working sound
+ working music

changes by Senor Quack:
+ F200 touchscreen support for both left and right-handed users.
+ Battlescape scrolling and geoscape rotation macros.
+ Battlescape "View Level Up/Down" macros.
+ Geoscape "Zoom In/Out" macros.
* More flexible button remapping.
* Few minor bug fixes:   Cursor movement no longer sticks 
     when game is paused and cursor is moving.
+ Made sample and music volumes independantly adjustable
+ Added direct adjustment of GP2X volume through /dev/mixer


alpha 1 (2008-12-07)
first public version
