OutcaST/wiz
------------
Atari ST emulation in your pocket!
Jeff Mitchell

For more details and future updates, hit up the OutcaST website here:
http://www.codejedi.com/outcast

Now available for GP2x Wiz, GP2x, GP32, Palm OS, Sony PSP, and others!

For additional documentation, see the manual for the GP32 version, which
shares many similarities in usage.

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

In brief:
	1) Unzip package somewhere; keep files together.
	2) Make ROMS\atari-st directory on your SD card (Sorry for hardcoding that)
	3) Stick TOS.ROM in that directory
	4) Stick .ST or .MSA disk images ("roms") in that path, or subdirectories of it

Example:
	If your SD is drive F in windows, then you could..
	F:\outcast	<- unzip and stick everything in there if you like
	F:\roms\atari-st	<- stick TOS.ROM there (you can get tos102.img etc and rename it)
	F:\roms\atari-st\gau\whatever.st	<- fine for disk images, it can search subdirectories

Application:

  Unzip package into a directory of your chosing on the SD card; keep the files
  together, but can be anywhere.

ROMS (Atari ST Disk Images):

  1) Create a directory on your SD card: /roms/atari-st - all lowercase! Sorry for
  hard coding that path, but for now it always starts looking there, so you should
  create it. This is where it will look for the operating system of the ST!

  2) Copy .ST and .MSA disk images to this location; .zip versions of these files
  should be okay as well (though I'm not sure if they work in the first alpha
  of the emulator :)

  * You can create subdirectories of the roms/atari-st folder so you can organize
  within that path, but you still have to keep everything (for now) in /roms/atari-st
  somewhere.

TOS Operating System ROM:

  The Atari ST has an operating system - one of the first GUI OSes, that
  predated MSWindows by a long mile. This file could be of various versions
  so we're looking for TOS 1.02 (sometimes called 1.20) ideally, best the
  American or UK versions. TOS 1.04 (1.40) may work, as should 1.0 .. but
  1.02 is the best. It might be called TOS.ROM or TOS.IMG or any number
  of variations... but for our needs, call it TOS.ROM and drop it into
  your /roms/atari-st folder on your SD card.

  To summarize -- look for an Atari ST "TOS" file, usually you can locate
  something like "tos102.img" or whatever. Just rename it to "TOS.ROM" and
  drop it into /roms/atari-st on your SD and you're good.

Features
--------

Things should be working very well by now, though with a few oddities.

Load/save states working
Chipmusic working pretty well
Disk menu working
Frameskip menu working
Throttle menu working
Virtual keybord working
etc..
Runs fast :)

Things are good :)

Controls
--------
Controls vary by control mode; some things to note..

Menus:
Joystick up/down - move selection bar up and down
Joystick left/right - page selection bar up and down
X - usually means cancel, though varies by menu
B - usually means select option, though can vary
Read the menus and screens for details.

Gameplay:

Default control mode is "Both" Joystick and Mouse at the same time; works
pretty well in most cases, but you may need to fine tune into other modes.

In both-mode, Wiz joystick operates mouse and joystick simultaneously, while
X is fire and A/B are left/right mouse buttons.

In joystick mode, only the joystick is operated and thus X is fire.

In mouse mode, only the mouse is operated and thus A/B are left/right click.

In cursor mode, the gp2x joystick and shoulder buttons operate the ST
cursor keys -- handy for games like Captive and Dungeon Master.

Custom mode is not yet built.

SELECT brings up and dismisses the virtual keyboard; use it for entering
keys or typing into the ST. "X" type hit a key on keyboard.

START toggles the main runtime options menu.. very handy!

------
ENJOY!
------

