ATARI800(1) General Commands Manual ATARI800(1)
NAME
atari800 - Atari 800 Emulator, Version 2.2.1
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
-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)
-colors-preset standard|deep-black|vibrant
Use one of predefined colour adjustments
-saturation <n>
Set screen color saturation (like TV Colour control)
-ntsc-saturation <n>, -pal-saturation <n>
Set saturation only for NTSC or PAL, respectively
-contrast <n>
Set screen contrast (also called white level)
-ntsc-contrast <n>, -pal-contrast <n>
Set contrast only for NTSC or PAL, respectively
-brightness <n>
Set screen brightness (also called black level)
-ntsc-brightness <n>, -pal-brightness <n>
Set brightness only for NTSC or PAL, respectively
-gamma <n>
Set screen gamma correction
-ntsc-gamma <n>, -pal-gamma <n>
Set gamma adjustment only for NTSC or PAL, respectively
-hue <n>
Set hue -1..1 (like TV Tint control). Only for NTSC.
-colordelay <n>
Set GTIA color delay. This emulates adjusting the potentiometer visible at the bottom of Atari computers, which adjusts hues of col-
ors produced by the computer. Only for NTSC.
-paletten <filename>, -palettep <filename>
Read Atari NTSC/PAL colors from ACT file
-paletten-adjust, -palettep-adjust
Apply colour adjustments (brightness, contrast etc.) to the loaded NTSC/PAL palette (by default the loaded palette is displayed
unmodified).
-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. The default resolution is 336x240 and can be later changed.
-windowed
Start in a window (the default).
-rotate90
Rotate display (useful for devices with 240x320 screen).
-no-rotate90
Don't rotate display (the default).
-fs-width <number-of-pixels>
Host horizontal resolution for fullscreen.
-fs-height <number-of-pixels>
Host vertical resolution for fullscreen.
-win-width <number-of-pixels>
Set horizontal size of the window. The window can be later resized manually.
-win-height <number-of-pixels>
Set vertical size of the window. The window can be later resized nanually.
-bpp <number-of-bits>
Sets image color depth when OpenGL acceleration is disabled. Accepted values are: 0 (use desktop depth; this is the default), 8, 16
and 32. Depending on the type of graphics hardware, the fullscreen setting and current desktop bit depth, either of the values might
give the best performance. Note that with bit depth set to 16 emulation of colors is slightly less accurate.
-vsync Synchronize the display with the monitor's vertical retrace, to remove image tearing artifacts. This improves display quality, but
may be not available depending on the current wideo mode (fullscreen/windowed), the chosen SDL_VIDEODRIVER and type of graphics
hardware. Synchronization is available for some SDL videodrivers (directx, dga) but not for others. In OpenGL this option has no
effect - vertical synchronization must be instead enabled in the video hardware driver's settings, if available.
-no-vsync
Disable synchronization with monitor's vertical retrace (the default).
-horiz-area narrow|tv|full|<number>
Set amount of visible screen horizontally. "narrow" shows 320 pixels, "tv" (the default) shows area visible on a standard TV (336
pixels), and "full" shows full overscan area (384 pixels). An exact horizontal size can be set by providing a number between 160 and
384.
-vertical-area short|tv|full|<number>
Set amount of visible screen vertically. "short" shows 200 pixels, "tv" (the default) shows area visible on a typical TV (224 or 240
pixels, depending on current TV system), and "full" shows full overscan area of 275 pixels. An exact number of visible scanlines can
be set by providing a number between 100 and 275. Note that when displaying output of an XEP80 or Austin Franklin 80 column card,
the "tv" setting will crop the top and bottom parts of text area, just like a real TV does - in such case setting the option to
"full" would be more appriopriate.
-horiz-shift <number>
When the visible horizontal area is not set to "full", this option specifies the screen's area that will be visible. Values higher
than 0 will cause showing more of the right side of the screen, while values lower than 0 will cause showing more of the left side.
The default is 0 (no shift). -vert-shift <number> Analogically to -horiz-shift: when the visible vertical area is not set to
"full", this option specifies the screen's area that will be visible. Values higher than 0 will cause showing more of the bottom
part of the screen, while values lower than 0 will cause showing more of the top part. The default is 0 (no shift).
-stretch none|integral|full|<number>
Choose method of stretching the image to fit the screen/window area. "none" means that the image won't be stretched at all; "inte-
gral" (the default) means that the image will fit the screen/window but will be stretched only by an integral multiplier. This set-
ting allows for nice output when using scanlines in low screen resolutions; "full" means that the screen will fit the entire
screen/window area. This setting looks best in high screen resolutions; A custom multiplier (floating point number) can be also pro-
vided
to precisely set the amount of stretching.
-fit-screen width|height|both
When -stretch is set to "integral" or "full", this parameter controls how the stretching is performed with relation to window/screen
size. "width" will fit the image's width while allowing it to be cropped vertically; "height" will fit the image's height while
allowing it to be cropped horizontally; "both" (the default) will fit both the image's width and height, avoiding cropping.
-image-aspect none|square-pixels|real
Choose how the image's aspect ratio should be maintained when stretching. "none" causes the image to be stretched without restric-
tion to fit the screen/window area fully; "square-pixels" (the default) causes the image to be stretched by the same amount horizon-
tally and vertically, maintaining square pixels. In low screen resolutions this setting may produce the nicest result; "real" recre-
ates the aspect ratio of a real TV display (pixels are not square), but only if the -host-aspect-ratio option is set correctly.
-host-aspect-ratio auto|<x>:<y>
Set the aspect ratio of the host monitor on which the emulator's display is placed. Allowed values are "auto" for autodetection, or
ratios like 4:3, 16:9, 1.25:1 ... This value is used to properly maintain image's aspect ratio when having -image-aspect set to
"real". The default value is "auto". Note that host aspect ratio detection works as expected only if the desktop resolution matches
aspect ratio of the display device (in other words, display pixels are square). If, for example, desktop resolution is 800x600 on a
16:9 monitor, autodetection will fail and host aspect ratio will have to be set manually, by measuring physical width and height of
the monitor and setting the parameter to <width>:<height>.
-80column
Shows output of an 80 column hardware, when it is available (the default). This parameter has effect only if an 80 column hardware
is activated, using one of the parameters -af80, -proto80 or -af80.
-no-80column
Deactivates showing output of an 80 column hardware.
-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
Activate NTSC filter. This faithfully emulates NTSC composite video artifacts. "-artif" is not needed in this mode and will not
work.
-no-ntscemu
Disable NTSC filter.
-ntsc-filter-preset composite|svideo|rgb|monochrome
Use one of predefined NTSC filter adjustments.
-ntsc-sharpness <n>
Set sharpness of the NTSC filter.
-ntsc-resolution <n>
Set resolution of the NTSC filter.
-ntsc-artifacts <n>
Set artifacts of the NTSC filter.
-ntsc-fringing <n>
Set fringing of the NTSC filter.
-ntsc-bleed <n>
Set bleed of the NTSC filter.
-ntsc-burstphase <n>
Set burst phase of the NTSC filter. This changes colors of artifacts. The best values are 0, 0.5, 1, 1.5.
-scanlines <n>
Set visibility of scanlines (0..100). Scanlines are only visible when the screen's or window's vertical size is at least 480 (more
precisely, at least twice the number of scanlines given in -vert-area).
-scanlinesint
Enable scanlines interpolation (looks nicer).
-no-scanlinesint
Disable scanlines interpolation (in software modes may give better performance).
-video-accel
Use OpenGL hardware acceleration for displaying and stretching of the emulator's display. Using OpenGL improves performance.
-no-video-accel
Don't use OpenGL hardware acceleration (the default).
-pixel-format bgr16|rgb16|bgra32|argb32
Choose format of texture data when OpenGL acceleration is enabled. Depending on the type of the graphics hardware, either of the
values might give the best performance. Note that with pixel format set to bgr16 or rgb16, emulation of colors is slightly less
accurate.
-pbo Use Pixel Buffer Objects when OpenGL acceleration is enabled (the default). PBOs are available on newer graphics hardware and when
used, substantially improve emulator's performance. However in rare cases (some Intel on-board chips) using PBOs may actually
descrease perfromance.
-no-pbo
Don't use Pixel Buffer Objects when OpenGL acceleration is used.
-bilinear-filter
Enable bilinear filtering of the screen in OpenGL modes.
-no-bilinear-filter
Disable bilinear filtering in OpenGL modes (the default).
-opengl-lib <path>
Provide a custom OpenGL shared library. If not given, Atari800 will use a default system-specific library (typically opengl32.dll or
libGL.so).
-proto80
Emulate a prototype 80 column board for the 1090
-xep80 Emulate the XEP80
-xep80port <n>
Use XEP80 on joystick port <n>
-af80 Emulate the Austin Franklin 80 column daughterboard for Atari 800.
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
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
Insert Insert line (Atari Shift+'>')
Ctrl+Insert
Insert character (Atari Ctrl+'>')
Shift+Ctrl+Insert
Shift+Ctrl+'>'
Delete Delete line (Atari Shift+Backspace)
Shift+Backspace
Delete line (Atari Shift+Backspace)
Ctrl+Delete
Delete character (Atari Ctrl+Backspace)
Ctrl+Backspace
Delete character (Atari Ctrl+Backspace)
Shift+Ctrl+Delete
Shift+Ctrl+Backspace
Shift+Ctrl+Backspace
Shift+Ctrl+Backspace
Home Clear (Atari Shift+'<')
Ctrl+Home
Ctrl+'<' (also clears screen)
Shift+Ctrl+Home
Shift+Ctrl+'<'
~ Inverse video
Up Up (Atari Ctrl+'-')
Down Down (Atari Ctrl+'=')
Left Left (Atari ctrl+'+')
Right Right (Atari ctrl+'*')
Ctrl+Up
-
Ctrl+Down
=
Ctrl+Left
+
Ctrl+Right
*
Shift+Up
_ (Atari Shift+'-')
Shift+Down
| (Atari Shift+'=')
Shift+Left
(Atari Shift+'+')
Shift+Right
^ (Atari Shift+'*')
Shift+Ctrl+Up
Shift+Ctrl+-
Shift+Ctrl+Down
Shift+Ctrl+=
Ctrl+''
Ctrl+Esc (Workaround for Windows)
Shift+Ctrl+''
Shift+Ctrl+Esc (Workaround for Windows)
CX85 Keypad (if enabled):
host keypad 0123456789-.
0123456789-.
host keypad /
NO
host keypad Ctrl+/
ESCAPE
host keypad *
DELETE
host keypad +
YES
host keypad Enter
+ENTER
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.
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/windowed display.
LAlt+G Switch visible horizontal area. See -horiz-area.
LAlt+J Swap keyboard_emulated joysticks
LAlt+M Grab mouse (prevents mouse pointer from leaving the window)
LAlt+LShift+1
Decrease hue (like TV Tint control, only NTSC)
LAlt+1 Increase hue
LAlt+LShift+2
Decrease saturation (like TV Colour control)
LAlt+2 Increase saturation
LAlt+LShift+3
Decrease contrast (also called white level)
LAlt+3 Increase contrast
LAlt+LShift+4
Decrease brightness (also called black level)
LAlt+4 Increase brightness
LAlt+LShift+5
Decrease gamma adjustment
LAlt+5 Increase gamma adjustment
LAlt+LShift+6
Decrease color delay (Atari color adjustment potentiometer, only NTSC)
LAlt+6 Increase color delay
These keys work only in the NTSC filter mode (-ntscemu):
LAlt+LShift+7
Decrease sharpness
LAlt+7 Increase sharpness
LAlt+LShift+8
Decrease resolution
LAlt+8 Increase resolution
LAlt+LShift+9
Decrease artifacts
LAlt+9 Increase artifacts
LAlt+LShift+0
Decrease fringing
LAlt+0 Increase fringing
LAlt+LShift+-
Decrease bleed
LAlt+- Increase bleed
LAlt+LShift+=
Decrease NTSC burst phase (use this to change artifacting colours)
LAlt+= Increase NTSC burst phase
LAlt+LShift+[
Decrease scanlines visibility
LAlt+[ Increase scanlines visibility
LAlt+] Toggle NTSC composite/S-Video/RGB/monochrome settings
LAlt+Shift+X
Enable/disable output of a 80 column hardware (use with -xep80, -proto80 or -af80).
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/dis-
abled 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, stan-
dard 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.
April 04, 2011 ATARI800(1)