sourCEntral - mobile manpages

pdf

ATARI800

NAME

atari800 − Atari 800 Emulator, Version 2.0.3

SYNOPSIS

atari800 [options] [files...]

DESCRIPTION

atari800 emulates the Atari 800, Atari 800 XL, Atari 130 XE and Atari 5200 Games System.

Options

-help

Print complete and up-to-date list of command line switches

-v

Print emulator version

-verbose

Display framerate when exiting

-config filename

Specify an alternative configuration filename

-osa_rom filename

Path to file containing Atari Rev.A Operating System. Used to override paths defined at compile time.

-osb_rom filename

Path to file containing Atari Rev.B Operating System. Used to override paths defined at compile time.

-xlxe_rom filename

Path to file containing Atari XL/XE Operating System. Used to override paths defined at compile time.

-5200_rom filename

Path to file containing Atari 5200 Games System ROM. Used to override paths defined at compile time.

-basic_rom filename

Path to file containing Atari BASIC ROM. Used to override paths defined at compile time.

-atari

Emulate Atari 800

-xl

Emulate Atari 800 XL

-xe

Emulate Atari 130 XE

-320xe

Emulate Atari 320 XE (Compy Shop)

-rambo

Emulate Atari 320 XE (Rambo)

-5200

Emulate Atari 5200

-emuos

Use EmuOS

-a

Use Atari OS/A for Atari 800

-b

Use Atari OS/B for Atari 800

-c

Enable RAM between 0xc000 and 0xcfff in Atari 800

-pal

Emulate PAL TV mode

-ntsc

Emulate NTSC TV mode

-nobasic

Used to disable Basic when starting the emulator in XL/XE mode. Simulates the Option key being held down during system boot.

-basic

Turn on Atari BASIC ROM

-cart <filename>

Insert cartridge (CART or raw format)

-run <filename>

Run Atari program (EXE, COM, XEX, BAS, LST)

-state <filename>

Load saved-state file

-tape <filename>

Attach cassette image (CAS format or raw file)

-boottape <filename>

Attach cassette image and boot it

-nopatch

Normally the OS is patched giving very fast I/O. This options prevents the patch from being applied so that the OS accesses the serial port hardware directly. This option will probably never be needed since programs that access the serial hardware should work even if the OS has been patched.

-nopatchall

Don’t patch OS at all, H: and P: devices won’t work

-H1 <path>

Set path for H1: device

-H2 <path>

Set path for H2: device

-H3 <path>

Set path for H3: device

-H4 <path>

Set path for H4: device

-Hpath <path>

Set path for Atari executables on the H: device

-hreadonly

Enable read-only mode for H: device

-hreadwrite

Disable read-only mode for H: device

-devbug

Put debugging messages for H: and P: devices in log file

-rtime

Enable R-Time 8 emulation

-nortime

Disable R-Time 8 emulation

-mouse off

Do not use mouse

-mouse pad

Emulate paddles

-mouse touch

Emulate Atari Touch Tablet

-mouse koala

Emulate Koala Pad

-mouse pen

Emulate Light Pen

-mouse gun

Emulate Light Gun

-mouse amiga

Emulate Amiga mouse

-mouse st

Emulate Atari ST mouse

-mouse trak

Emulate Atari Trak-Ball

-mouse joy

Emulate joystick using mouse

-mouseport <num>

Set mouse port 1-4 (default 1)

-mousespeed <num>

Set mouse speed 1-9 (default 3)

-multijoy

Emulate MultiJoy4 interface

-refresh

Controls screen refresh rate. A numerical value follows this option which specifies how many emulated screen updates are required before the actual screen is updated. This value effects the speed of the emulation: A higher value results in faster CPU emulation but a less frequently updated screen.

-artif <mode>

Set artifacting mode 0-4 (0 = disable)

-palette <filename>

Read Atari colors from ACT file

-black <num>

Set black level 0-255

-while <num>

Set white level 0-255

-colors <num>

Set color intensity

-genpal

Generate artifical palette

-colshift <num>

Set color shift (-genpal only)

-screenshots <pattern>

Set filename pattern for screenshots. Use to override the default atari000.png, atari001.png etc. filenames. Hashes are replaced with raising numbers. Existing files are overwritten only if all the files defined by the pattern exist.

-sound

Enable sound

-nosound

Disable sound

-dsprate <freq>

Set mixing frequency (Hz)

-snddelay <time>

Set sound delay (milliseconds)

Curses Options

-left

Use columns 0 to 39

-central

Use columns 20 to 59

-right

Use columns 40 to 79

-wide1

Use columns 0 to 79. In this mode only the even character positions are used. The odd locations are filled with spaces.

-wide2

Use columns 0 to 79. This mode is similar to -wide1 except that the spaces are in reverse video if the previous character was also in reverse video.

DOS/VGA Options
-interlace

Generate screen with interlace

-video <mode>

0=320x200, 1=320x240, 2=320x480 interlaced with black lines, 3=320x480 interlaced with darker lines

-novesa

Do not use VESA 2 video modes

-vretrace

Use vertical retrace control

-LPTjoy1

Read joystick connected to LPT1

-LPTjoy2

Read joystick connected to LPT2

-LPTjoy3

Read joystick connected to LPT3

-joyswap

Swap joysticks

-keyboard 0

PC keyboard layout

-keyboard 1

Atari keyboard layout

Falcon Options
-interlace <x>

Generate Falcon screen only every x frame

-videl

Direct VIDEL programming (Falcon/VGA only)

-double

Double the screen size on NOVA

-delta

Delta screen output (differences only)

SDL Options
-fullscreen

Start in fullscreen mode (tries to switch to 336x240 resolution)

-windowed

Start in a window (does not change your working resolution)

-rotate90

Run the emulator with rotated display (useful for devices with 240x320 screen)

-width number-of-pixels

Host horizontal resolution for fullscreen

-height number-of-pixels

Host vertical resolution for fullscreen

-bpp number-of-bits

Host color depth for running in fullscreen

-audio16

Enable 16-bit sound output

-nojoystick

Do not initialize SDL joysticks

-joy0 path-to-device

Define path to device used in LPTjoy 0. Available on linux-ia32 only.

-joy1 path-to-device

Define path to device used in LPTjoy 1. Available on linux-ia32 only.

SVGALIB Options
-interlace

Enable screen interlace option

X11 Options

-small

Run the emulator in a small window where each Atari 800 pixel is represented by one X Window pixel

-large

Runs the emulator in a large window where each Atari 800 pixel is represented by a 2x2 X Window rectange. This mode is selected by default.

-huge

Runs the emulator in a huge window where each Atari 800 pixel is represented by a 3x3 X Window rectange

-clip_x number-of-pixels

Set left offset for clipping

-clip_width number-of-pixels

Set the width of the clipping-area

-clip_y number-of-pixels

Set top offset for clipping

-clip_height number-of-pixels

Set the height of the clipping-area

-private_cmap

Use private colormap

-fps

Show framerate

-sio

Show SIO monitor

-x11bug

Enable debug code in atari_x11.c

-keypad

Keypad mode

KEYBOARD, JOYSTICK AND OTHER CONTROLLERS

F1

Built in user interface

F2

Option key

F3

Select key

F4

Start key

F5

Reset key ("warm reset")

Shift+F5

Reboot ("cold reset")

F6

Help key (XL/XE only)

F7

Break key

F8

Enter monitor

F9

Exit emulator

F10

Save screenshot

Shift+F10

Save interlaced screenshot

Alt+R

Run Atari program

Alt+D

Disk management

Alt+C

Cartridge management

Alt+Y

Select system

Alt+O

Sound settings

Alt+W

Sound recording start/stop

Alt+S

Save state file

Alt+L

Load state file

Alt+A

About the emulator

Paddles, Atari touch tablet, Koala pad, light pen, light gun, ST/Amiga mouse, Atari trak-ball, joystick and Atari 5200 analog controller are emulated using mouse on ports that support it. See the options above for how to enable mouse.

Curses
F10 (Save screenshot) does not work in the default CURSES_BASIC build. Shift+F5 and Shift+F10 don’t work at all. Avoid Ctrl + C, H, J, M, Q, S and Z. The remaining control characters can be typed. Control characters are displayed on the screen with the associated upper case character in bold.

Controllers not supported in this version.

DOS/VGA

F7

Switch between Emulated joysticks mode and Normal keyboard

Atari/Inverse key

Joysticks can be either real one connected to game port, or old 8-bit digital CX-40 joysticks connected to parallel port or keyboard joysticks (try out JOYCFG.EXE).

Falcon

Help

Help key (XL/XE)

Joystick 0 is operated by the numeric keypad (make sure that the numeric keypad has been enabled).

7 8 9
\|/
4 5 6
/|\
1 2 3

And 0 is the fire key.

Mouse not supported in this version.

SDL

LAlt+F

Switch fullscreen (probably doesn’t work in Windows)

LAlt+G

Switch WIDTH_MODE (so you can set 320x240)

LAlt+B

Switch BLACK-AND-WHITE

LAlt+J

Swap keyboard_emulated joysticks

LAlt+E

Switch bpp (for debug only, will be removed soon)

To redefine keys for joystick emulation you must modify SDL_TRIG_* and SDL_JOY_* in atari_sdl.c, then recompile Atari800. In source you can also turn off sound or change defaults (FULLSCREEN, BW, SWAP_JOYSTICKS, WIDTH_MODE).

On Linux, standard joysticks are supported.

SVGALIB

F11

Joystick autofire on/off

Caps key

The Ctrl+Shift keyboard combinations are implemented using the left Alt key.

Joystick 0 is operated by the numeric keypad (make sure that the numeric keypad has been enabled).

7 8 9
\|/
4 5 6
/|\
1 2 3

And 0 is the fire key.

Mouse not supported in this version.

X11

Alt

Atari key (either Alt key will work)

Joystick 0 is operated by the mouse position relative to the center of the screen. The mouse button acts as the trigger. On Linux, standard joysticks are also supported.

FILES

/usr/share/atari800/ATARIOSA.ROM

Atari O/S A

/usr/share/atari800/ATARIOSB.ROM

Atari O/S B

/usr/share/atari800/ATARIXL.ROM

Atari 800 XL O/S

/usr/share/atari800/ATARI5200.ROM

Atari 5200 O/S

/usr/share/atari800/ATARIBAS.ROM

Atari Basic

BUGS

See the BUGS file.

pdf