SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from PLD Atari800-common-1.2.3-1.i386.rpm

ATARI800

Section: User Commands (1)
Updated: 08 July 2002
Index 

NAME

atari800 - Atari 800 Emulator, Version 1.2.3 

SYNOPSIS

atari800 [options] [diskfiles...] 

DESCRIPTION

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

Options

-help
Print emulator version.
-v
Print emulator version.
-verbose
Display framerate when exiting
-configure
Starts emulator in run-time configuration mode.
-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.

-xl
Emulate Atari 800 XL.
-xe
Emulate Atari 130 XE - but Antic accesses the same bank the CPU is using.
-320xe
Emulate Atari 320 XE (Compy Shop)
-rambo
Emulate Atari 320 XE (Rambo)
-5200
Emulate Atari 5200 - Games controller emulation has not been implemented yet!
-emuos
Use EmuOS

-a
Use Atari OS/A.
-b
Use Atari OS/B.
-c
Enable RAM between $c000 and $d000.

-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 executable file (EXE, COM, XEX)
-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 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: 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
-hdreadonly <onoff>
Enable (1) or disable (0) read-only mode for H: device
-devbug
Put debugging messages for H: and P: devices in log file

-rtime <onoff>
Enable (1) or disable (0) 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)

-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)
-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
-colshift <num>
Set color shift
-realpal
Use palette created by Zdenek Eisenhammer
-oldpal
Use old Atari800 palette
-foxpal
Use palette created by Piotr Fusik

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

 

SVGALIB Options

-interlace
Enable screen interlace option

 

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

 

X11 Options

-small
Runs 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
Sets left offset for clipping.
-clip_width number-of-pixels
Sets the width of the clipping-area.
-clip_y number-of-pixels
Sets top offset for clipping.
-clip_height number-of-pixels
Sets the height of the clipping-area.
-private_cmap
Tells the Emulator to use its own private colormap.
-fps
Show framerate
-sio
Show SIO monitor
-x11bug
Enable debug code in atari_x11.c

-keypad
Keypad mode

 

SDL Options

-rotate90
Runs the emulator with rotated display (useful for devices with 240x320screen)
-fullscreen
Runs in fullscreen (tries to switch to 336x240 resolution)
-windowed
Runs in a window (does not change your working resolution)
-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
-nojoystick
SDL Joysticks will not be initialized
-joy0 path-to-device
Defines path to device used in LPTjoy 0. Available on linux-ia32 only.
-joy1 path-to-device
Defines path to device used in LPTjoy 1. Available on linux-ia32 only.

 

KEYBOARD, JOYSTICK & PADDLE CONTROLS

 

Curses

F1
Built in User Interface
F2
Option
F3
Select
F4
Start
F5
Warm Reset
F6
Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7
Break Key
F8
Cold Reset
F9
Exit Emulator
F10
---
F11
---
F12
---

Some control have special meaning within curses and should not be used.


    Avoid Control + C, J, M, Q, S and Z

The remaining control characters can be typed. Control characters aredisplayed on the screen with the associated upper case character in bold.

No Joystick or Paddle support in this version.

 

Falcon

F1
Built in User Interface
F2
Option
F3
Select
F4
Start
F5
Warm Reset
Shft+F5
Cold Reset
F6
Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7
Break Key
F8
Enter monitor
F9
EXIT Emulator
Help
HELP key (800XL/130XE)

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.
 At the moment it is not possible to use a Paddle with this version.

 

SVGALIB

F1
Built in User Interface
F2
Option
F3
Select
F4
Start
F5
Warm Reset
Shft+F5
Cold Reset
F6
Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7
Break Key
F8
Enter monitor
F9
Exit Emulator
F10
Save Screenshot (+Shift=interlaced screenshot)
F11
Joystick Autofire On/Off
F12
---
`
This character replaces the CAPS lock key because I have not found away of detecting it. A future solution maybe to automatically issue aCAPS lock key when a transition is made between lower and upper casekeys. i.e. If svgalib return 'a' followed by 'A' it could send 'a'

The CTRL+SHIFT keyboard combinations are implemented using the leftALT key.

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.

At the moment it is not possible to use a Paddle with the SVGALIBversion.

 

DOS/VGA

F1
Built in User Interface
F2
Option Key
F3
Select Key
F4
Start Key
F5
Warm Reset
Shft+F5
Cold Reset
F6
PIL Mode (Atari800) / Help Key (XL/XE)
F7
Switch between Emulated joysticks mode and Normal keyboard
F8
Enter monitor
F9
EXIT Emulator
F10
Save Screenshot (+Shift=interlaced screenshot)

Control-C terminates the program; to type Control-c, type ALT-c instead.` is used as the Atari-Invers key

Joysticks can be either real one connected to game port, or old 8-bitdigital CX-40 joysticks connected to parallel port or keyboard joysticks(try out JOYCFG.EXE).
 At the moment it is not possible to use a Paddle with this version.

 

X11

F1
Built in User Interface
F2
Option
F3
Select
F4
Start
F5
Warm Reset
Shft+F5
Cold Reset
F6
Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
F7
Break Key
F8
---
F9
Exit Emulator
F10
---
F11
Vertical Positioning: Scroll Screen Downwards
F12
Vertical Positioning: Scroll Screen Upwards
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.

Paddle 0 is operated by moving the mouse pointer across the window.

 

SDL

LALT+f
switching FULLSCREEN (probably doesn't work in Windows)
LALT+g
switching WIDTH_MODE (so you can set 320x240)
LALT+b
switching BLACK-AND-WHITE (feel to power of BW monitor!)
LALT+j
swapping _keyboard_emulated_ joysticks
LALT+e
switching bpp (for debug only, will be removed soon)

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

On Linux, standard joysticks are 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

A few programs cause the emulator to enter its built in debugger. Thereason for this is unknown at the moment.


 

Index

NAME
SYNOPSIS
DESCRIPTION
Options
Curses Options
Falcon Options
SVGALIB Options
DOS/VGA Options
X11 Options
SDL Options
KEYBOARD, JOYSTICK & PADDLE CONTROLS
Curses
Falcon
SVGALIB
DOS/VGA
X11
SDL
FILES
BUGS

This document was created byman2html,using the manual pages.