atari800.sdl(1)

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

-axlon <n>

Use Atari 800 Axlon memory expansion: <n> k total RAM

-axlon0f

Use Axlon shadow at 0x0fc0-0x0fff

-mosaic <n>

Use 400/800 Mosaic memory expansion: <n> k total RAM

-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

-1400

Emulate the Atari 1400XL

-xld

Emulate the Atari 1450XLD

-bb

Emulate the CSS Black Box

-mio

Emulate the ICD MIO board

-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:, P: and R: 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

rdevice [<dev>]

Enable R: device. If <dev> is specified then it's used as host serial device name (e.g. /dev/ttyS0 on linux). If there is no <dev> specified then R: is directed to network.

-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

-directmouse

Use mouse's absolute position

-cx85 <num>

Emulate CX85 numeric keypad on port <num>

-grabmouse

SDL only, prevent mouse pointer from leaving the window

-record <filename>

Record all input events to <filename>. Can be used for gaming contests (highest score etc).

-playback <filename>

Playback input events from <filename>. Watch an expert play the game.

-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)

-paletten/p <filename>

Read Atari NTSC/PAL colors from ACT file

-blackn/p <num>

Set NTSC/PAL black level 0-255

-whiten/p <num>

Set NTSC/PAL white level 0-255

-colorsn/p <num>

Set NTSC/PAL color intensity

-genpaln/p

Generate artifical NTSC/PAL palette

-colshiftn/p <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.

-showspeed

Show percentage of actual speed

-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.

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)

-joyswap

Swap joysticks

Java NestedVM

-scale <n>

Scale width and height by <n>

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.

-ntscemu

Emulate NTSC composite video (640x480x16 only) This includes NTSC TV artifacts. "-artif" is not needed in this mode and will not work. This mode does not use a palette. The video signal is emulated instead. Palette options such as -genpaln have no effect in this mode. The following items are for -ntscemu only:

-ntsc_hue <n>

Set NTSC hue -1..1 (like TV Tint control)

-ntsc_sat <n>

Set NTSC saturation (like TV Colour control)

-ntsc_cont <n>

Set NTSC contrast (also called white level)

-ntsc_bright <n>

Set NTSC brightness (also called black level)

-ntsc_sharp <n>

Set NTSC sharpness

-ntsc_burst <n>

Set NTSC burst phase (artificating colours) (CTIA?) Drol, Choplifter, Ultima: 0.70

-ntsc_gauss <n>

Set NTSC Gaussian factor (can affect artifacting colours, sharpness and ghosting)

-ntsc_gamma <n>

Set NTSC gamma adjustment

-ntsc_ramp <n>

Set NTSC saturation ramp factor (amount by which bright colours become desaturated or washed out)

-scanlines <n>

Set scanlines percentage (ntscemu only)

-scanlinesnoint

Disable scanlines interpolation (ntscemu only)

-proto80

Emulate a prototype 80 column board for the 1090

-xep80

Emulate the XEP80

-xep80port <n>

Use XEP80 on joystick port <n>

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

-sio

Show SIO monitor

-x11bug

Enable debug code in atari_x11.c

-keypad

Keypad mode

Basic

No function keys or Alt+letter shortcuts. Use Ctrl+C to enter the monitor. Controllers not supported in this version.

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.

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

`

Atari/Inverse key

LSUPER

Atari/Inverse key (unusable under Windows)

RSUPER

CapsToggle (+Shift = CapsLock)

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)

LAlt+M

Grab mouse (prevents mouse pointer from leaving the window)

These keys work with the NTSC composite video emualtion (-ntscemu): (This interface should be considered experimental and is subject to change)

LAlt+1

Decrease NTSC sharpness

LAlt+2

Increase NTSC sharpness

LAlt+3

Decrease NTSC saturation (like TV Colour control)

LAlt+4

Increase NTSC saturation

LAlt+5

Decrease NTSC brightness (also called black level)

LAlt+6

Increase NTSC brightness

LAlt+7

Decrease NTSC contrast (also called white level)

LAlt+8

Increase NTSC contrast

LAlt+9

Decrease NTSC burst phase (use this to change artifacting colours)

LAlt+0

Increase NTSC burst phase

LAlt+-

Decrease NTSC Gaussian factor (ghosting, sharpness, artif colours)

LAlt+=

Increase NTSC Gaussian factor (ghosting, sharpness, artif colours)

LAlt+[

Decrease scanlines percentage (NTSC mode only)

LAlt+]

Increase scanlines percentage (NTSC mode only)

LAlt+;

Decrease NTSC hue (like TV Tint control)

LAlt+'

Increase NTSC hue (like TV Tint control)

LAlt+Ins

Decrease NTSC saturation ramp(reduce saturation for bright colours)

LAlt+Ins

Increase NTSC saturation ramp(reduce saturation for bright colours)

LAlt+Shift+X

Enable/disable XEP80 screen (use with -xep80)

Apart from standard joysticks (handled by the SDL) up to two keyboard joysticks are supported. The keys used for joystick directions and the trigger can be freely defined in the config UI (Controller Config -> Define layout). Keyboard joystick emulation can be enabled/disabled in the Controller Config. By default, joy 0 is enabled and joy 1 is disabled (to not steal normal AWDS keys in the emulator).

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.