MAN page from Mandriva 2009 atari800-common-2.1.0-1plf2009.0.x86_64.rpm
ATARI800
Section: User Commands (1)
Updated: March 26, 2009
Index
NAME
atari800 - Atari 800 Emulator, Version 2.1.0
SYNOPSIS
atari800 [options] [files...]
DESCRIPTION
atari800 emulates the Atari 800, Atari 800 XL, Atari 130 XE andAtari 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 preventsthe patch from being applied so that the OS accesses the serial porthardware directly. This option will probably never be needed sinceprograms that access the serial hardware should work even if the OShas 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 devicename (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 optionwhich specifies how many emulated screen updates are required beforethe actual screen is updated. This value effects the speed of theemulation: A higher value results in faster CPU emulation but aless 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 defaultatari000.png, atari001.png etc. filenames. Hashes are replaced withraising numbers. Existing files are overwritten only if all the filesdefined 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 positionsare used. The odd locations are filled with spaces.
- -wide2
- Use columns 0 to 79. This mode is similar to -wide1
except thatthe spaces are in reverse video if the previous character was alsoin 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 240x320screen)
- -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 willnot work. This mode does not use a palette. The video signal is emulatedinstead. 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 andghosting)
- -ntsc_gamma <n>
- Set NTSC gamma adjustment
- -ntsc_ramp <n>
- Set NTSC saturation ramp factor (amount by which bright colours becomedesaturated 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 isrepresented by one X Window pixel
- -large
- Runs the emulator in a large window where each Atari 800 pixel isrepresented by a 2x2 X Window rectange. This mode is selected bydefault.
- -huge
- Runs the emulator in a huge window where each Atari 800 pixel isrepresented 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 analogcontroller 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 characterscan be typed. Control characters are displayed on the screenwith 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 numerickeypad 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 joysticksare supported. The keys used for joystick directions and the trigger can befreely 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 normalAWDS 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 ofthe screen. The mouse button acts as the trigger. On Linux, standardjoysticks 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.
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- Options
- Curses Options
- Falcon Options
- Java NestedVM
- SDL Options
- X11 Options
- KEYBOARD, JOYSTICK AND OTHER CONTROLLERS
- Basic
- Curses
- Falcon
- SDL
- X11
- FILES
- BUGS
This document was created byman2html,using the manual pages.
