INTRODUCTION
This is a port of "STonX", an Atari ST (68000) emulator for UNIX.
It is quite fast and works very well with clean applications, and
even with some of the "hardware-banging" games, but the hardware
emulation is not perfect.

This port requires CyberGfx or Picasso96 for graphics and the AHI
system for audio (can be disabled).


INSTALLATION
Select an executable for the operating system of your choice and
copy it whereever you like:
AmigaOS3.x (68k):  stonx_68k
AmigaOS4 (PPC):    stonx_os4
MorphOS0.4+ (PPC): stonx_mos
PowerUp:           stonx_ppc
WarpOS:            stonx_wos

You might want to copy "tos.img" (not included) and "cartridge.img"
into the same directory. Otherwise you have to tell STonX where they
can be found (either by command line option or by STonXrc file).

The "atari" directory contains two demo programs.


USAGE
Please read docs/README for a complete documentation about STonX.
You may write command line options, without leading '-' and separated
by new-lines, into the file "STonXrc", which has to reside in the
same directory as the main program. Example STonXrc:
---8<---
tos TOS2.04/tos.img
cartridge cartridge/catridge.img
color
---8<---

Amiga specific options:
-directcgfx : Copy directly into frame buffer, without using OS functions.

When started for the first time you will be asked to select the
screen modes for displaying the Atari resolutions 320x200, 640x200
and 640x400. They will be saved to ENV:STonX_modes. So if you need
to change them one day, just delete this file and restart STonX.

Keyboard mapping of special Atari keys:
Insert  -> Num.Pad '0'
End     -> Num.Pad '1'
Down    -> Num.Pad '2'
PgDn    -> Num.Pad '3'
Left    -> Num.Pad '4'
ISO     -> Num.Pad '5'
Right   -> Num.Pad '6'
Home    -> Num.Pad '7'
Up      -> Num.Pad '8'
PgUp    -> Num.Pad '9'
Undo    -> Del
Help    -> Help

You can quit the emulator any time by holding down CTRL and Left-AMIGA.


SOURCE
As STonX is under GPL the full source text is included. You will
need vbcc V0.8+, GNU-make and the posix.lib linker library (Aminet
dev/c/vbcc_PosixLib.lha) to compile it.


LEGAL
STonX is published under the GNU Public License (GPL).
Please read the file COPYING for licensing informations.