1ATARI800(1) General Commands Manual ATARI800(1)
2
6 atari800 - emulator of Atari 8-bit computers and the 5200 console
7
10 atari800 [option]... [file]...
11
14 atari800 emulates the Atari 8-bit computer systems including the 400,
15 800, 1200XL, 600XL, 800XL, 65XE, 130XE, 800XE and the XE Game System,
16 and also the Atari 5200 SuperSystem console.
17
20 -help Print complete and up-to-date list of command line switches
21 -v Print emulator version
23 -verbose
25 Display framerate when exiting
26 -config filename
28 Specify an alternative configuration filename
29 -autosave-config
31 Automatically save the current configuration on emulator exit.
32 -no-autosave-config
34 Don't save the current configuration on emulator exit (the
35 default).
36 -osa_rom filename
39 Path to file containing Atari Rev.A Operating System.
40 -osb_rom filename
42 Path to file containing Atari Rev.B Operating System.
43 -xlxe_rom filename
45 Path to file containing Atari XL/XE Operating System.
46 -5200_rom filename
48 Path to file containing Atari 5200 Games System ROM.
49 -basic_rom filename
51 Path to file containing Atari BASIC ROM. Used to override paths
52 defined at compile time.
53 -800-rev auto|a-ntsc|a-pal|b-ntsc|custom|altirra
56 Select operating system revision for Atari 800:
57 auto The default. Use the most appropriate from the available
59 ones.
60 a-ntsc Use OS rev. A NTSC from early NTSC 400/800 units.
61 a-pal Use OS rev. A PAL from PAL 400/800 units.
62 b-ntsc Use OS rev. B NTSC from late NTSC 400/800 units.
63 custom Use a custom OS.
64 altirra
65 Use AltirraOS that is included in the emulator.
66 -xl-rev auto|10|11|1|2|3a|3b|5|3|4|59|59a|custom|altirra
68 Select operating system revision for Atari XL/XE:
69 auto The default. Use the most appropriate from the available
71 ones.
72 10 Use OS AA000000 rev. 10 from early 1200XL units.
73 11 Use OS AA000001 rev. 11 from late 1200XL units.
74 1 Use OS BB000000 rev. 1 from the 600XL.
75 2 Use OS BB000001 rev. 2 from the 800XL and early
76 65XE/130XE units.
77 3a Use prototype OS BB000002 rev. 3 from 1400XL/1450XLD
78 units (also known as 1540OS3.V0 and 1450R3V0.ROM).
79 3b Use prototype OS BB000002 rev. 3 ver. 4 from
80 1400XL/1450XLD units (also known as os1450.128 and
81 1450R3VX.ROM).
82 5 Use prototype OS CC000001 rev. 4 (also known as Rev. 5),
83 for which sources are available at
84 <http://www.atariage.com/forums/topic/78579-a800ossrc/page__view__find‐
85 post__p__961535>.
86 3 Use OS BB000001 rev. 3 from late 65XE/130XE units.
87 4 Use OS BB000001 rev. 4 from the XEGS.
88 59 Use OS BB000001 rev. 59 from the Arabic 65XE.
89 59a Use OS BB000001 rev. 59 from Kevin Savetz' Arabic 65XE:
90 <http://www.savetz.com/vintagecomputers/arabic65xe/>.
91 custom Use a custom OS.
92 altirra
93 Use AltirraOS that is included in the emulator.
94 -5200-rev auto|orig|a|custom|altirra
96 Select BIOS revision for Atari 5200:
97 auto The default. Use the most appropriate from the available
99 ones.
100 orig Use BIOS from 4-port and early 2-port 5200 units.
101 a Use BIOS rev. A from late 2-port 5200 units.
102 custom Use a custom BIOS.
103 altirra
104 Use Altirra BIOS that is included in the emulator.
105 -basic-rev auto|a|b|c|custom|altirra
107 Select BASIC revision:
108 auto The default. Use the most appropriate from the available
110 ones.
111 a Use BASIC rev. A.
112 b Use BASIC rev. B from early 600XL/800XL units.
113 c Use BASIC rev. C from late 600XL/800XL and all XE units.
114 custom Use a custom BASIC.
115 altirra
116 Use Altirra BASIC that is included in the emulator.
117 -xegame-rev auto|orig|custom
119 Select XEGS builtin game version:
120 auto The default. Use the most appropriate from the available
122 ones.
123 orig Use the original Missile Command game.
124 custom Use a custom game ROM.
125 -atari Emulate Atari 400/800
128 -1200 Emulate Atari 1200XL
130 -xl Emulate Atari 800XL
132 -xe Emulate Atari 130XE
134 -320xe Emulate Atari 320XE (Compy-Shop)
136 -rambo Emulate Atari 320XE (Rambo)
138 -xegs Emulate Atari XEGS
140 -5200 Emulate Atari 5200
142 -c Enable RAM between 0xc000 and 0xcfff in Atari 800
144 -axlon n
147 Use Atari 800 Axlon memory expansion: n k total RAM
148 -axlon0f
150 Use Axlon shadow at 0x0fc0-0x0fff
151 -mosaic n
153 Use 400/800 Mosaic memory expansion: n k total RAM
154 -mapram
156 Enable the MapRAM memory expansion. Works only when emulating an
157 Atari XL/XE machine.
158 -no-mapram
160 Disable the MapRAM memory expansion.
161 -pal Emulate PAL TV mode
164 -ntsc Emulate NTSC TV mode
166 -nobasic
169 Used to disable Basic when starting the emulator in XL/XE mode.
170 Simulates the Option key being held down during system boot.
171 -basic Turn on Atari BASIC ROM
173 -cart filename
176 Insert cartridge (CART or raw format)
177 -cart-type 0..70
179 Select type of the cartridge inserted with the -cart option.
180 When inserting a raw ROM image its type cannot be detected auto‐
181 maticcaly, and must be provided with this option. Setting to 0
182 means disabling the cartridge, and any other number indicates a
183 specific cartridge type:
184 1 Standard 8 KB cartridge
185 2 Standard 16 KB cartridge
186 3 OSS two chip 16 KB cartridge (034M)
187 4 Standard 32 KB 5200 cartridge
188 5 DB 32 KB cartridge
189 6 Two chip 16 KB 5200 cartridge
190 7 Bounty Bob Strikes Back 40 KB 5200 cartridge
191 8 64 KB Williams cartridge
192 9 Express 64 KB cartridge
193 10 Diamond 64 KB cartridge
194 11 SpartaDos X 64 KB cartridge
195 12 XEGS 32 KB cartridge
196 13 XEGS 64 KB cartridge (banks 0-7)
197 14 XEGS 128 KB cartridge
198 15 OSS one chip 16 KB cartridge
199 16 One chip 16 KB 5200 cartridge
200 17 Decoded Atrax 128 KB cartridge
201 18 Bounty Bob Strikes Back 40 KB cartridge
202 19 Standard 8 KB 5200 cartridge
203 20 Standard 4 KB 5200 cartridge
204 21 Right slot 8 KB cartridge
205 22 32 KB Williams cartridge
206 23 XEGS 256 KB cartridge
207 24 XEGS 512 KB cartridge
208 25 XEGS 1 MB cartridge
209 26 MegaCart 16 KB cartridge
210 27 MegaCart 32 KB cartridge
211 28 MegaCart 64 KB cartridge
212 29 MegaCart 128 KB cartridge
213 30 MegaCart 256 KB cartridge
214 31 MegaCart 512 KB cartridge
215 32 MegaCart 1 MB cartridge
216 33 Switchable XEGS 32 KB cartridge
217 34 Switchable XEGS 64 KB cartridge
218 35 Switchable XEGS 128 KB cartridge
219 36 Switchable XEGS 256 KB cartridge
220 37 Switchable XEGS 512 KB cartridge
221 38 Switchable XEGS 1 MB cartridge
222 39 Phoenix 8 KB cartridge
223 40 Blizzard 16 KB cartridge
224 41 Atarimax 128 KB Flash cartridge
225 42 Atarimax 1 MB Flash cartridge
226 43 SpartaDos X 128 KB cartridge
227 44 OSS 8 KB cartridge
228 45 OSS two chip 16 KB cartridge (043M)
229 46 Blizzard 4 KB cartridge
230 47 AST 32 KB cartridge
231 48 Atrax SDX 64 KB cartridge
232 49 Atrax SDX 128 KB cartridge
233 50 Turbosoft 64 KB cartridge
234 51 Turbosoft 128 KB cartridge
235 52 Ultracart 32 KB cartridge
236 53 Low bank 8 KB cartridge
237 54 SIC! 128 KB cartridge
238 55 SIC! 256 KB cartridge
239 56 SIC! 512 KB cartridge
240 57 Standard 2 KB cartridge
241 58 Standard 4 KB cartridge
242 59 Right slot 4 KB cartridge
243 60 Blizzard 32 KB cartridge
244 61 MegaMax 2 MB cartridge
245 62 The!Cart 128 MB cartridge
246 63 Flash MegaCart 4 MB cartridge
247 64 MegaCart 2 MB cartridge
248 65 The!Cart 32 MB cartridge
249 66 The!Cart 64 MB cartridge
250 67 XEGS 64 KB cartridge (banks 8-15)
251 68 Atrax 128 KB cartridge
252 69 aDawliah 32 KB cartridge
253 70 aDawliah 64 KB cartridge
254 If this option is not given, the user will be asked to choose the car‐
255 tridge type when the emulator starts.
256 -cart2 filename
258 Insert piggyback cartridge (CART or raw format). This works
259 only if the first cartridge is a pass-through (currently only
260 SpartaDOS X 64KB and 128KB types).
261 -cart2-type 0..70
263 Select type of the cartridge inserted with the -cart2 option.
264 When inserting a raw ROM image its type cannot be detected auto‐
265 matically, and must be provided with this option. The available
266 values are the same as for the -cart-type option above.
267 -cart-autoreboot
269 Automatically reboot after cartridge inserting/removing (this is
270 the default setting). This does not apply to the piggyback car‐
271 tridge - inserting or removing it never causes automatic reboot.
272 -no-cart-autoreboot
274 Disable automatic reboot after cartridge inserting/removing.
275 -run filename
278 Run Atari program (EXE, COM, XEX, BAS, LST)
279 -state filename
281 Load saved-state file
282 -tape filename
284 Attach cassette image (CAS format or raw file)
285 -boottape filename
287 Attach cassette image and boot it
288 -tape-readonly
290 Set the attached cassette image as read-only.
291 -1400 Emulate the Atari 1400XL
295 -xld Emulate the Atari 1450XLD
297 -bb Emulate the CSS Black Box
299 -mio Emulate the ICD MIO board
301 -nopatch
304 Normally the OS is patched giving very fast I/O. This options
305 prevents the patch from being applied so that the OS accesses
306 the serial port hardware directly. This option will probably
307 never be needed since programs that access the serial hardware
308 should work even if the OS has been patched.
309 -nopatchall
311 Don't patch OS at all, H:, P: and R: devices won't work
312 -H1 path
315 Set path for H1: device
316 -H2 path
318 Set path for H2: device
319 -H3 path
321 Set path for H3: device
322 -H4 path
324 Set path for H4: device
325 -Hpath path
327 Set path for Atari executables on the H: device
328 -hreadonly
330 Enable read-only mode for H: device
331 -hreadwrite
333 Disable read-only mode for H: device
334 -devbug
336 Put debugging messages for H: and P: devices in log file
337 -rtime Enable R-Time 8 emulation
340 -nortime
342 Disable R-Time 8 emulation
343 -rdevice [dev]
346 Enable R: device. If dev is specified then it's used as host
347 serial device name (e.g. /dev/ttyS0 on linux). If there is no
348 dev specified then R: is directed to network.
349 -mouse off
352 Do not use mouse
353 -mouse pad
355 Emulate paddles
356 -mouse touch
358 Emulate Atari Touch Tablet
359 -mouse koala
361 Emulate Koala Pad
362 -mouse pen
364 Emulate Light Pen
365 -mouse gun
367 Emulate Light Gun
368 -mouse amiga
370 Emulate Amiga mouse
371 -mouse st
373 Emulate Atari ST mouse
374 -mouse trak
376 Emulate Atari Trak-Ball
377 -mouse joy
379 Emulate joystick using mouse
380 -mouseport num
382 Set mouse port 1-4 (default 1)
383 -mousespeed num
385 Set mouse speed 1-9 (default 3)
386 -multijoy
388 Emulate MultiJoy4 interface
389 -directmouse
391 Use mouse's absolute position
392 -cx85 num
394 Emulate CX85 numeric keypad on port num
395 -grabmouse
397 SDL only, prevent mouse pointer from leaving the window
398 -record filename
401 Record all input events to filename. Can be used for gaming con‐
402 tests (highest score etc).
403 -playback filename
405 Playback input events from filename. Watch an expert play the
406 game.
407 -refresh
410 Controls screen refresh rate. A numerical value follows this
411 option which specifies how many emulated screen updates are
412 required before the actual screen is updated. This value
413 effects the speed of the emulation: A higher value results in
414 faster CPU emulation but a less frequently updated screen.
415 -ntsc-artif mode, -pal-artif mode
418 Set emulation mode of video artifacts in NTSC or PAL, respec‐
419 tively. The available values for mode are:
420 none Disable video artifacts.
421 ntsc-old
422 Simple emulation of NTSC composite video artifacts. Fast
423 but inaccurate.
424 ntsc-new
425 Improved emulation of NTSC artifacts. May look better
426 than ntsc-old.
427 ntsc-full
428 Full emulation of NTSC artifacts. Rather slow and avail‐
429 able only in 16- and 32-bit video modes.
430 pal-simple
431 Simple emulation of PAL chroma blending, without compos‐
432 ite artifacts. Fast but inaccurate.
433 pal-blend
434 Accurate emulation of PAL chroma blending, without com‐
435 posite artifacts. Available only in 16- and 32-bit video
436 modes.
437 -artif mode
439 Set artifacting mode 0-4 (0 = disable). Only for tv effects
440 ntsc-old and ntsc-new.
441 -colors-preset standard|deep-black|vibrant
444 Use one of predefined colour adjustments
445 -saturation n
447 Set screen color saturation (like TV Colour control)
448 -ntsc-saturation n, -pal-saturation n
450 Set saturation only for NTSC or PAL, respectively
451 -contrast n
453 Set screen contrast (also called white level)
454 -ntsc-contrast n, -pal-contrast -fIn
456 Set contrast only for NTSC or PAL, respectively
457 -brightness n
459 Set screen brightness (also called black level)
460 -ntsc-brightness n, -pal-brightness n
462 Set brightness only for NTSC or PAL, respectively
463 -gamma n
465 Set screen gamma correction
466 -ntsc-gamma n, -pal-gamma n
468 Set gamma adjustment only for NTSC or PAL, respectively
469 -tint n
471 Set tint -1..1.
472 -ntsc-tint n, -pal-tint n
474 Set tint only for NTSC or PAL, respectively
475 -ntsc-colordelay n
477 Set GTIA color delay for NTSC system. This emulates adjusting
478 the potentiometer existing at the bottom of Atari computers,
479 which adjusts hues of colors produced by the computer.
480 -pal-colordelay n
482 Set GTIA color delay for PAL system.
483 -paletten filename, -palettep filename
486 Read Atari NTSC/PAL colors from ACT file
487 -paletten-adjust, -palettep-adjust
489 Apply colour adjustments (brightness, contrast etc.) to the
490 loaded NTSC/PAL palette (by default the loaded palette is dis‐
491 played unmodified).
492 -screenshots pattern
495 Set filename pattern for screenshots. Use to override the
496 default atari000.png, atari001.png etc. filenames. Hashes are
497 replaced with raising numbers. Existing files are overwritten
498 only if all the files defined by the pattern exist.
499 -showspeed
502 Show percentage of actual speed
503 -sound Enable sound
506 -nosound
508 Disable sound
509 -dsprate freq
511 Set sound output frequency in Hz. The default is 44100 Hz.
512 -audio16
514 Set sound output format to 16-bit
515 -audio8
517 Set sound output format to 8-bit
518 -snd-buflen ms
520 Set length of the hardware sound buffer in milliseconds. Set‐
521 ting to 0 (the default) causes the length to be set automati‐
522 cally. Higher values increase sound latency. Automatic setting
523 should be OK in most cases.
524 -snddelay ms
526 Set sound latency in milliseconds. Increase it if you experi‐
527 ence gaps of silence during sound playback.
528 Curses Options
531 -left Use columns 0 to 39
532 -central
534 Use columns 20 to 59
535 -right Use columns 40 to 79
537 -wide1 Use columns 0 to 79. In this mode only the even character posi‐
539 tions are used. The odd locations are filled with spaces.
540 -wide2 Use columns 0 to 79. This mode is similar to -wide1 except that
542 the spaces are in reverse video if the previous character was
543 also in reverse video.
544 Falcon Options
547 -interlace x
548 Generate Falcon screen only every x frame
549 -videl Direct VIDEL programming (Falcon/VGA only)
551 -double
553 Double the screen size on NOVA
554 -delta Delta screen output (differences only)
556 -joyswap
558 Swap joysticks
559 Java NestedVM Options
562 -scale n
563 Scale width and height by n
564 SDL Options
567 -fullscreen
568 Start in fullscreen mode. The default resolution is 336x240 and
569 can be later changed.
570 -windowed
572 Start in a window (the default).
573 -rotate90
575 Rotate display (useful for devices with 240x320 screen).
576 -no-rotate90
578 Don't rotate display (the default).
579 -fs-width number-of-pixels
581 Host horizontal resolution for fullscreen.
582 -fs-height number-of-pixels
584 Host vertical resolution for fullscreen.
585 -win-width number-of-pixels
587 Set horizontal size of the window. The window can be later
588 resized manually.
589 -win-height number-of-pixels
591 Set vertical size of the window. The window can be later
592 resized nanually.
593 -bpp number-of-bits
595 Sets image color depth when OpenGL acceleration is disabled.
596 Accepted values are: 0 (use desktop depth; this is the default),
597 8, 16 and 32. Depending on the type of graphics hardware, the
598 fullscreen setting and current desktop bit depth, either of the
599 values might give the best performance. Note that with bit
600 depth set to 16 emulation of colors is slightly less accurate.
601 -vsync Synchronize the display with the monitor's vertical retrace, to
603 remove image tearing artifacts. This improves display quality,
604 but may be not available depending on the current wideo mode
605 (fullscreen/windowed), the chosen SDL_VIDEODRIVER and type of
606 graphics hardware. Synchronization is available for some SDL
607 videodrivers (directx, dga) but not for others. In OpenGL this
608 option has no effect - vertical synchronization must be instead
609 enabled in the video hardware driver's settings, if available.
610 -no-vsync
612 Disable synchronization with monitor's vertical retrace (the
613 default).
614 -horiz-area narrow|tv|full|number
616 Set amount of visible screen horizontally:
617 narrow Shows 320 pixels.
619 tv The default. Shows area visible on a standard TV (336
620 pixels).
621 full Shows full overscan area (384 pixels).
622 number An exact horizontal size can be set by providing a number
623 between 160 and 384.
624 -vertical-area short|tv|full|number
626 Set amount of visible screen vertically:
627 short Shows 200 pixels.
629 tv The default. Shows area visible on a typical TV (224 or
630 240 pixels, depending on current TV system).
631 full Shows full overscan area, which can be up to 300 pixels
632 in case of the XEP80.
633 number An exact number of visible scanlines can be set by pro‐
634 viding a number between 100 and 300.
635 Note that when displaying output of an XEP80 or Austin Franklin 80 col‐
637 umn card, the tv setting will crop the top and bottom parts of text
638 area, just like a real TV does - in such case setting the option to
639 full would be more appriopriate.
640 -horiz-shift number
642 When the visible horizontal area is not set to full, this option
643 specifies the screen's area that will be visible. Values higher
644 than 0 will cause showing more of the right side of the screen,
645 while values lower than 0 will cause showing more of the left
646 side. The default is 0 (no shift). -vert-shift number Analogi‐
647 cally to -horiz-shift: when the visible vertical area is not set
648 to full, this option specifies the screen's area that will be
649 visible. Values higher than 0 will cause showing more of the
650 bottom part of the screen, while values lower than 0 will cause
651 showing more of the top part. The default is 0 (no shift).
652 -stretch none|integral|full|number
654 Choose method of stretching the image to fit the screen/window
655 area:
656 none The image won't be stretched at all.
658 integral
659 The default. The image will fit the screen/window but
660 will be stretched only by an integral multiplier. This
661 setting allows for nice output when using scanlines in
662 low screen resolutions.
663 full The screen will fit the entire screen/window area. This
664 setting looks best in high screen resolutions.
665 number A custom multiplier (floating point number) can be also
666 provided to precisely set the amount of stretching.
667 -fit-screen width|heightWhen -stretch is set to integral or full, this
669 parameter
670 controls how the stretching is performed with relation to win‐
671 dow/screen size:
672 width Fits the image's width while allowing it to be cropped
674 vertically.
675 height Fits the image's height while allowing it to be cropped
676 horizontally.
677 both The default. Fit both the image's width and height,
678 avoiding cropping.
679 -image-aspect none|square-pixels|real
681 Choose how the image's aspect ratio should be maintained when
682 stretching:
683 none Causes the image to be stretched without restriction to
685 fit the screen/window area fully.
686 square-pixels
687 The default. Causes the image to be stretched by the
688 same amount horizontally and vertically, maintaining
689 square pixels. In low screen resolutions this setting
690 may produce the nicest result.
691 real Recreates the aspect ratio of a real TV display (pixels
692 are not square), but only if the -host-aspect-ratio
693 option is set correctly.
694 -host-aspect-ratio auto|x:y
696 Set the aspect ratio of the host monitor on which the emulator's
697 display is placed. Allowed values are auto for autodetection,
698 or ratios like 4:3, 16:9, 1.25:1 ... This value is used to
699 properly maintain image's aspect ratio when having -image-aspect
700 set to real. The default value is auto. Note that host aspect
701 ratio detection works as expected only if the desktop resolution
702 matches aspect ratio of the display device (in other words, dis‐
703 play pixels are square). If, for example, desktop resolution is
704 800x600 on a 16:9 monitor, autodetection will fail and host
705 aspect ratio will have to be set manually, by measuring physical
706 width and height of the monitor and setting the parameter to
707 width:height.
708 -80column
710 Shows output of an 80 column hardware, when it is available (the
711 default). This parameter has effect only if an 80 column hard‐
712 ware is activated, using one of the parameters -af80, -proto80
713 or -af80.
714 -no-80column
716 Deactivates showing output of an 80 column hardware.
717 -nojoystick
721 Do not initialize SDL joysticks
722 -joy0 path-to-device
724 Define path to device used in LPTjoy 0. Available on linux-ia32
725 only.
726 -joy1 path-to-device
728 Define path to device used in LPTjoy 1. Available on linux-ia32
729 only.
730 -ntsc-filter-preset composite|svideo|rgb|monochrome
733 Use one of predefined NTSC filter adjustments.
734 -ntsc-sharpness n
736 Set sharpness of the NTSC filter.
737 -ntsc-resolution n
739 Set resolution of the NTSC filter.
740 -ntsc-artifacts n
742 Set artifacts of the NTSC filter.
743 -ntsc-fringing n
745 Set fringing of the NTSC filter.
746 -ntsc-bleed n
748 Set bleed of the NTSC filter.
749 -ntsc-burstphase n
751 Set burst phase of the NTSC filter. This changes colors of
752 artifacts. The best values are 0, 0.5, 1, 1.5.
753 -scanlines n
755 Set visibility of scanlines (0..100). Scanlines are only visi‐
756 ble when the screen's or window's vertical size is at least 480
757 (more precisely, at least twice the number of scanlines given in
758 -vert-area).
759 -scanlinesint
761 Enable scanlines interpolation (looks nicer).
762 -no-scanlinesint
764 Disable scanlines interpolation (in software modes may give bet‐
765 ter performance).
766 -video-accel
768 Use OpenGL hardware acceleration for displaying and stretching
769 of the emulator's display. Using OpenGL improves performance.
770 -no-video-accel
772 Don't use OpenGL hardware acceleration (the default).
773 -pixel-format bgr16|rgb16|bgra32|argb32
775 Choose format of texture data when OpenGL acceleration is
776 enabled. Depending on the type of the graphics hardware, either
777 of the values might give the best performance. Note that with
778 pixel format set to bgr16 or rgb16, emulation of colors is
779 slightly less accurate.
780 -pbo Use Pixel Buffer Objects when OpenGL acceleration is enabled
782 (the default). PBOs are available on newer graphics hardware
783 and when used, substantially improve emulator's performance.
784 However in rare cases (some Intel on-board chips) using PBOs may
785 actually descrease perfromance.
786 -no-pbo
788 Don't use Pixel Buffer Objects when OpenGL acceleration is used.
789 -bilinear-filter
791 Enable bilinear filtering of the screen in OpenGL modes.
792 -no-bilinear-filter
794 Disable bilinear filtering in OpenGL modes (the default).
795 -opengl-lib path
797 Provide a custom OpenGL shared library. If not given, Atari800
798 will use a default system-specific library (typically
799 opengl32.dll or libGL.so).
800 -proto80
802 Emulate a prototype 80 column board for the 1090
803 -xep80 Emulate the XEP80
805 -xep80port n
807 Use XEP80 on joystick port n
808 -af80 Emulate the Austin Franklin 80 column daughterboard for Atari
810 800.
811 -volume 0..100
813 Sets global volume of Atari 800.
814 X11 Options
818 -small Run the emulator in a small window where each Atari 800 pixel is
819 represented by one X Window pixel
820 -large Runs the emulator in a large window where each Atari 800 pixel
822 is represented by a 2x2 X Window rectangle. This mode is
823 selected by default.
824 -huge Runs the emulator in a huge window where each Atari 800 pixel is
826 represented by a 3x3 X Window rectangle.
827 -clip_x number-of-pixels
829 Set left offset for clipping
830 -clip_width number-of-pixels
832 Set the width of the clipping-area
833 -clip_y number-of-pixels
835 Set top offset for clipping
836 -clip_height number-of-pixels
838 Set the height of the clipping-area
839 -private_cmap
841 Use private colormap
842 -sio Show SIO monitor
844 -x11bug
846 Enable debug code in atari_x11.c
847 -keypad
850 Keypad mode
851
854 F1 Built in user interface
855 F2 Option key
856 F3 Select key
857 F4 Start key
858 F5 Reset key ("warm reset")
859 Shift+F5 Reboot ("cold reset")
860 F6 Help key (XL/XE only)
861 F7 Break key
862 F8 Enter monitor
863 F9 Exit emulator
864 F10 Save screenshot
865 Shift+F10 Save interlaced screenshot
866 Alt+R Run Atari program
867 Alt+D Disk management
868 Alt+C Cartridge management
869 Alt+Y Select system
870 Alt+O Sound settings
871 Alt+W Sound recording start/stop
872 Alt+S Save state file
873 Alt+L Load state file
874 Alt+A About the emulator
875 Insert Insert line (Atari Shift+'>')
876 Ctrl+Insert Insert character (Atari Ctrl+'>')
877 Shift+Ctrl+Insert Shift+Ctrl+'>'
878 Delete Delete line (Atari Shift+Backspace)
879 Shift+Backspace Delete line (Atari Shift+Backspace)
880 Ctrl+Delete Delete character (Atari Ctrl+Backspace)
881 Ctrl+Backspace Delete character (Atari Ctrl+Backspace)
882 Shift+Ctrl+Delete Shift+Ctrl+Backspace
883 Shift+Ctrl+Backspace Shift+Ctrl+Backspace
884 Home Clear (Atari Shift+'<')
885 Ctrl+Home Ctrl+'<' (also clears screen)
886 Shift+Ctrl+Home Shift+Ctrl+'<'
887 ~ Inverse video
888 Up Up (Atari Ctrl+'-')
889 Down Down (Atari Ctrl+'=')
890 Left Left (Atari ctrl+'+')
891 Right Right (Atari ctrl+'*')
892 Ctrl+Up -
893 Ctrl+Down =
894 Ctrl+Left +
895 Ctrl+Right *
896 Shift+Up _ (Atari Shift+'-')
897 Shift+Down | (Atari Shift+'=')
898 Shift+Left (Atari Shift+'+')
899 Shift+Right ^ (Atari Shift+'*')
900 Shift+Ctrl+Up Shift+Ctrl+-
901 Shift+Ctrl+Down Shift+Ctrl+=
902 Ctrl+\ Ctrl+Esc (Workaround for Windows)
903 Shift+Ctrl+\ Shift+Ctrl+Esc (Workaround for Windows)
904 CX85 Keypad (if enabled):
906 host keypad 0123456789-. 0123456789-.
907 host keypad NO
908 host keypad Ctrl+/ ESCAPE
909 host keypad * DELETE
910 host keypad + YES
911 host keypad Enter +ENTER
912 Paddles, Atari touch tablet, Koala pad, light pen, light gun, ST/Amiga
914 mouse, Atari trak-ball, joystick and Atari 5200 analog controller are
915 emulated using mouse on ports that support it. See the options above
916 for how to enable mouse.
917 Basic
919 No function keys or Alt+letter shortcuts. Use Ctrl+C to enter the mon‐
920 itor. Controllers not supported in this version.
921 Curses
923 F10 (Save screenshot) does not work in the default CURSES_BASIC build.
924 Shift+F5 and Shift+F10 don't work at all. Avoid Ctrl + C, H, J, M, Q,
925 S and Z. The remaining control characters can be typed. Control char‐
926 acters are displayed on the screen with the associated upper case char‐
927 acter in bold.
928 Controllers not supported in this version.
930 Falcon
932 Help Help key (XL/XE)
933 Joystick 0 is operated by the numeric keypad (make sure that the
935 numeric keypad has been enabled).
936 7 8 9
938 \|/
939 4 5 6
940 /|\
941 1 2 3
942 And 0 is the fire key.
944 Mouse not supported in this version.
946 SDL
948 ` Atari/Inverse key
949 LSUPER Atari/Inverse key (unusable under Windows)
950 RSUPER CapsToggle (+Shift = CapsLock)
951 LAlt+F Switch fullscreen/windowed display.
953 LAlt+G Switch visible horizontal area. See -horiz-area.
954 LAlt+J Swap keyboard_emulated joysticks
955 LAlt+M Grab mouse (prevents mouse pointer from leaving the win‐
956 dow)
957 LAlt+LShift+1 Decrease tint (also called hue)
959 LAlt+1 Increase hue
960 LAlt+LShift+2 Decrease saturation (like TV Colour control)
961 LAlt+2 Increase saturation
962 LAlt+LShift+3 Decrease contrast (also called white level)
963 LAlt+3 Increase contrast
964 LAlt+LShift+4 Decrease brightness (also called black level)
965 LAlt+4 Increase brightness
966 LAlt+LShift+5 Decrease gamma adjustment
967 LAlt+5 Increase gamma adjustment
968 LAlt+LShift+6 Decrease color delay (Atari color adjustment potentiome‐
969 ter)
970 LAlt+6 Increase color delay
971 The following keys work only when the NTSC filter is enabled
973 (-ntsc-artif set to ntsc-full):
974 LAlt+LShift+7 Decrease sharpness
975 LAlt+7 Increase sharpness
976 LAlt+LShift+8 Decrease resolution
977 LAlt+8 Increase resolution
978 LAlt+LShift+9 Decrease artifacts
979 LAlt+9 Increase artifacts
980 LAlt+LShift+0 Decrease fringing
981 LAlt+0 Increase fringing
982 LAlt+LShift+- Decrease bleed
983 LAlt+- Increase bleed
984 LAlt+LShift+= Decrease NTSC burst phase (use this to change
985 artifacting colours)
986 LAlt+= Increase NTSC burst phase
987 LAlt+LShift+[ Decrease scanlines visibility
989 LAlt+[ Increase scanlines visibility
990 LAlt+] Toggle NTSC composite/S-Video/RGB/monochrome settings
991 LAlt+Shift+X Enable/disable output of a 80 column hardware (use with
994 -xep80, -proto80 or -af80).
995 Apart from standard joysticks (handled by the SDL) up to two keyboard
998 joysticks are supported. The keys used for joystick directions and the
999 trigger can be freely defined in the config UI (Controller Config ->
1000 Define layout). Keyboard joystick emulation can be enabled/disabled in
1001 the Controller Config. By default, joy 0 is enabled and joy 1 is dis‐
1002 abled (to not steal normal AWDS keys in the emulator).
1003 X11
1005 Alt Atari key (either Alt key will work)
1006 Joystick 0 is operated by the mouse position relative to the center of
1008 the screen. The mouse button acts as the trigger. On Linux, standard
1009 joysticks are also supported.
1010
1014 /usr/share/atari800/ATARIOSA.ROM
1015 Atari O/S A
1016 /usr/share/atari800/ATARIOSB.ROM
1018 Atari O/S B
1019 /usr/share/atari800/ATARIXL.ROM
1021 Atari 800XL O/S
1022 /usr/share/atari800/ATARI5200.ROM
1024 Atari 5200 O/S
1025 /usr/share/atari800/ATARIBAS.ROM
1027 Atari Basic
1028
1031 See the BUGS file.
1032Atari800 4.2.0 2019-12-28 ATARI800(1)