Atari 800 Emulator for Unix, Amiga, MS-DOS and Falcon, Version 1.2.4
--------------------------------------------------------------------

    Copyright (C) 1995 David Firth. E-Mail: david@signus.demon.co.uk
    Copyright (C) 1998-2002 Atari800 Development Team.
                            E-mail: atari800-users@lists.sourceforge.net

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 1, or (at your option)
    any later version.

This is the version 1.2.4 of my Atari 800, 800XL, 130XE and 5200 emulator
for Unix, Amiga, MS-DOS, Atari TT/Falcon, SDL and WinCE. My main objective
is to create a freely distributable portable emulator (i.e. with source
code available). It can be configured to run in the following ways :-

	1. BASIC mode
	2. CURSES Mode
	3. SVGALIB for Linux Systems
	4. X Window + Optional XVIEW or MOTIF User Interface
	5. CBM Amiga
 	6. MS-DOS
	7. Atari Falcon/TT and compatible machines
	8. MS Windows 9x
	9. SDL
	10. WinCE

The basic mode is only useful for running programs such as MAC65,
Atari Basic etc. I have had this version running on Linux,
SunOS 4.1.3, Solaris 2.4, Silicon Graphics, VAX/VMS, CBM Amiga
(Dice C and GNU C) and the HP-UX 9000/380.

The CURSES mode is similar to the basic mode, but it also enables full
screen editing capability. Some computer don't seem to support curses
fully - SunOS 4.1.3, VAX/VMS, LINUX (but ncurses is OK).

The SVGALIB version runs at a reasonable speed. The screen dimensions
are limited to 320x240.

The X Window version supports graphics and has an optional XVIEW
user interface. The Linux X Window version can be built with
joystick support (If joystick module is installed in the kernel).

The Amiga version supports graphics but currently lacks Paddle support.

The MS-DOS version supports 320x200, 320x240 and even 320x480 interlaced
graphics, sound (SoundBlaster compatible sound cards, 8bit),
keyboard, one joystick connected to game port and up to three additional
digital joysticks connected to parallel (printer) ports.

The Atari Falcon030/040 version supports 320x240 and 336x240 Falcon/TT
8-bit planes graphics modes, NOVA graphics cards, DMA sound and both
joysticks (old CX-40, Atari800 compatible - not the new paddle-like ones).

The SDL version should compile on Unix, Win32, BeOS, etc... It's optimized for
8, 16 and 32 color depth. Of course it will work fastest in 8bit. If you use it
in XFree86 - please set "Depth=8" in XF86Config to gain maximum speed. 

From version 0.7.0 all versions supporting bitmapped graphics have
a User Interface implemented on the emulators "screen". The User
Interface is enter by pressing F1 at any time. ESC is used to return
to the previous screen.

---------------------------------------------------------------------------

Features
--------

Note: Not all features are supported on all platforms.

o Atari 400, 800, 600 XL, 800XL, 130XE, 5200 Games System.

o 130XE compatible memory expansions: 320K, 576K, 1088K.

o Optional 4K RAM between 0xc000 and 0xcfff in 400/800 mode.

o Cycle-exact 6502 emulation, all unofficial instructions.

o Cycle-exact NMI interrupts, scanline-based POKEY interrupts.

o Scanline-based ANTIC emulation, all display modes, precise timing.

o Player/Missile Graphics, exact priority control and collision detection.

o Exact POKEY shift registers (sound and random number generator).

o 8 disk drives, emulated at computer-to-drive communication
  and fast patched SIO levels.

o ATR, XFD, DCM, ATR.GZ and XFD.GZ disk images.

o Direct loading of Atari executable files.

o 32 cartridge types, raw and CART format.

o Cassette player, raw and CAS images.

o Printer support.

o Files can be stored directly on your host computer via the H: device.

o Current emulation state can be saved in a state file.

o Sound support on Unix using "/dev/dsp".

o Stereo (two POKEYs) emulation.

o Joystick controller using numeric keypad.

o Real joystick support.

o Paddles, Atari touch tablet, Koala pad, light pen, light gun,
  ST/Amiga mouse, Atari trak-ball, joystick and Atari 5200 analog
  controller emulated using mouse.

o R-Time 8 emulation using host computer clock.

o Atari palette read from a file or calculated basing on user-defined
  parameters.

o Screen snapshots (normal and interlaced) to PCX files.

o Sound output may be written to WAV files.

o User interface on all versions supporting bitmapped graphics.
