.TH ATARI800 1 "2023-12-29" "Atari800 5.2.0"

.SH NAME
atari800 \- emulator of Atari 8-bit computers and the 5200 console

.SH SYNOPSIS
.B atari800
.RI [ option "]... [" file ]...

.SH DESCRIPTION
.B atari800
emulates the Atari 8-bit computer systems including the 400, 800, 1200XL,
600XL, 800XL, 65XE, 130XE, 800XE and the XE Game System, and also the Atari
5200 SuperSystem console.

.SH OPTIONS

.TP
.B \-help
Print complete and up-to-date list of command line switches
.TP
.B \-v
Print emulator version
.TP
.B \-verbose
Display framerate when exiting
.TP
.BI \-config\  filename
Specify an alternative configuration filename
.TP
.B \-autosave\-config
Automatically save the current configuration on emulator exit.
.TP
.B \-no\-autosave\-config
Don't save the current configuration on emulator exit (the default).

.TP
.BI \-osa_rom\  filename
Path to file containing Atari Rev.A Operating System.
.TP
.BI \-osb_rom\  filename
Path to file containing Atari Rev.B Operating System.
.TP
.BI \-xlxe_rom\  filename
Path to file containing Atari XL/XE Operating System.
.TP
.BI \-5200_rom\  filename
Path to file containing Atari 5200 Games System ROM.
.TP
.BI \-basic_rom\  filename
Path to file containing Atari BASIC ROM.
Used to override paths defined at compile time.

.TP
\fB\-800\-rev auto\fR|\fBa\-ntsc\fR|\fBa\-pal\fR|\fBb\-ntsc\fR|\fBcustom\fR|\fBaltirra\fR
Select operating system revision for Atari 800:
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the most appropriate from the available ones.
.TP
.B a\-ntsc
Use OS rev. A NTSC from early NTSC 400/800 units.
.TP
.B a\-pal
Use OS rev. A PAL from PAL 400/800 units.
.TP
.B b\-ntsc
Use OS rev. B NTSC from late NTSC 400/800 units.
.TP
.B custom
Use a custom OS.
.TP
.B altirra
Use AltirraOS that is included in the emulator.
.PD
.RE
.TP
\fB\-xl\-rev auto\fR|\fB10\fR|\fB11\fR|\fB1\fR|\fB2\fR|\fB3a\fR|\fB3b\fR|\fB5\fR|\fB3\fR|\fB4\fR|\fB59\fR|\fB59a\fR|\fBcustom\fR|\fBaltirra\fR
Select operating system revision for Atari XL/XE:
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the most appropriate from the available ones.
.TP
.B 10
Use OS AA000000 rev. 10 from early 1200XL units.
.TP
.B 11
Use OS AA000001 rev. 11 from late 1200XL units.
.TP
.B 1
Use OS BB000000 rev. 1 from the 600XL.
.TP
.B 2
Use OS BB000001 rev. 2 from the 800XL and early 65XE/130XE units.
.TP
.B 3a
Use prototype OS BB000002 rev. 3 from 1400XL/1450XLD units (also known as 1540OS3.V0 and 1450R3V0.ROM).
.TP
.B 3b
Use prototype OS BB000002 rev. 3 ver. 4 from 1400XL/1450XLD units (also known as os1450.128 and 1450R3VX.ROM).
.TP
.B 5
Use prototype OS CC000001 rev. 4 (also known as Rev. 5), for which sources are
available at <http://www.atariage.com/forums/topic/78579-a800ossrc/page__view__findpost__p__961535>.
.TP
.B 3
Use OS BB000001 rev. 3 from late 65XE/130XE units.
.TP
.B 4
Use OS BB000001 rev. 4 from the XEGS.
.TP
.B 59
Use OS BB000001 rev. 59 from the Arabic 65XE.
.TP
.B 59a
Use OS BB000001 rev. 59 from Kevin Savetz' Arabic 65XE: <http://www.savetz.com/vintagecomputers/arabic65xe/>.
.TP
.B custom
Use a custom OS.
.TP
.B altirra
Use AltirraOS that is included in the emulator.
.PD
.RE
.TP
\fB\-5200\-rev auto\fR|\fBorig\fR|\fBa\fR|\fBcustom\fR|\fBaltirra\fR
Select BIOS revision for Atari 5200:
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the most appropriate from the available ones.
.TP
.B orig
Use BIOS from 4-port and early 2\-port 5200 units.
.TP
.B a
Use BIOS rev. A from late 2\-port 5200 units.
.TP
.B custom
Use a custom BIOS.
.TP
.B altirra
Use Altirra BIOS that is included in the emulator.
.PD
.RE
.TP
\fB\-basic\-rev auto\fR|\fBa\fR|\fBb\fR|\fBc\fR|\fBcustom\fR|\fBaltirra\fR
Select BASIC revision:
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the most appropriate from the available ones.
.TP
.B a
Use BASIC rev. A.
.TP
.B b
Use BASIC rev. B from early 600XL/800XL units.
.TP
.B c
Use BASIC rev. C from late 600XL/800XL and all XE units.
.TP
.B custom
Use a custom BASIC.
.TP
.B altirra
Use Altirra BASIC that is included in the emulator.
.PD
.RE
.TP
\fB\-xegame\-rev auto\fR|\fBorig\fR|\fBcustom\fR
Select XEGS builtin game version:
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the most appropriate from the available ones.
.TP
.B orig
Use the original Missile Command game.
.TP
.B custom
Use a custom game ROM.
.PD
.RE

.TP
.B \-atari
Emulate Atari 400/800
.TP
.B \-1200
Emulate Atari 1200XL
.TP
.B \-xl
Emulate Atari 800XL
.TP
.B \-xe
Emulate Atari 130XE
.TP
.B \-320xe
Emulate Atari 320XE (Compy-Shop)
.TP
.B \-rambo
Emulate Atari 320XE (Rambo)
.TP
.B \-576xe
Emulate Atari 576XE
.TP
.B \-1088xe
Emulate Atari 1088XE
.TP
.B \-xegs
Emulate Atari XEGS
.TP
.B \-5200
Emulate Atari 5200
.TP
.B \-c
Enable RAM between 0xc000 and 0xcfff in Atari 800

.TP
.BI \-axlon\  n
Use Atari 800 Axlon memory expansion: \fIn\fR k total RAM
.TP
.B \-axlon0f
Use Axlon shadow at 0x0fc0-0x0fff
.TP
.BI \-mosaic\  n
Use 400/800 Mosaic memory expansion: \fIn\fR k total RAM
.TP
.B \-mapram
Enable the MapRAM memory expansion. Works only when emulating an Atari XL/XE machine.
.TP
.B \-no-mapram
Disable the MapRAM memory expansion.

.TP
.B \-pal
Emulate PAL TV mode
.TP
.B \-ntsc
Emulate NTSC TV mode

.TP
.B \-nobasic
Used to disable Basic when starting the emulator in XL/XE mode.
Simulates the Option key being held down during system boot.
.TP
.B \-basic
Turn on Atari BASIC ROM

.TP
.BI \-cart\  filename
Insert cartridge (CART or raw format)
.TP
.BR "\-cart\-type 0 .. 160"
Select type of the cartridge inserted with the \fB\-cart\fR option.
When inserting a raw ROM image its type cannot be detected automaticcaly,
and must be provided with this option.
Setting to \fB0\fR means disabling the cartridge, and any other number
indicates a specific cartridge type:
.RS
.PP
.PD 0
.TP
.B 1
Standard 8 KB cartridge
.TP
.B 2
Standard 16 KB cartridge
.TP
.B 3
OSS two chip 16 KB cartridge (034M)
.TP
.B 4
Standard 32 KB 5200 cartridge
.TP
.B 5
DB 32 KB cartridge
.TP
.B 6
Two chip 16 KB 5200 cartridge
.TP
.B 7
Bounty Bob Strikes Back 40 KB 5200 cartridge
.TP
.B 8
64 KB Williams cartridge
.TP
.B 9
Express 64 KB cartridge
.TP
.B 10
Diamond 64 KB cartridge
.TP
.B 11
SpartaDos X 64 KB cartridge
.TP
.B 12
XEGS 32 KB cartridge
.TP
.B 13
XEGS 64 KB cartridge (banks 0-7)
.TP
.B 14
XEGS 128 KB cartridge
.TP
.B 15
OSS one chip 16 KB cartridge
.TP
.B 16
One chip 16 KB 5200 cartridge
.TP
.B 17
Decoded Atrax 128 KB cartridge
.TP
.B 18
Bounty Bob Strikes Back 40 KB cartridge
.TP
.B 19
Standard 8 KB 5200 cartridge
.TP
.B 20
Standard 4 KB 5200 cartridge
.TP
.B 21
Right slot 8 KB cartridge
.TP
.B 22
32 KB Williams cartridge
.TP
.B 23
XEGS 256 KB cartridge
.TP
.B 24
XEGS 512 KB cartridge
.TP
.B 25
XEGS 1 MB cartridge
.TP
.B 26
MegaCart 16 KB cartridge
.TP
.B 27
MegaCart 32 KB cartridge
.TP
.B 28
MegaCart 64 KB cartridge
.TP
.B 29
MegaCart 128 KB cartridge
.TP
.B 30
MegaCart 256 KB cartridge
.TP
.B 31
MegaCart 512 KB cartridge
.TP
.B 32
MegaCart 1 MB cartridge
.TP
.B 33
Switchable XEGS 32 KB cartridge
.TP
.B 34
Switchable XEGS 64 KB cartridge
.TP
.B 35
Switchable XEGS 128 KB cartridge
.TP
.B 36
Switchable XEGS 256 KB cartridge
.TP
.B 37
Switchable XEGS 512 KB cartridge
.TP
.B 38
Switchable XEGS 1 MB cartridge
.TP
.B 39
Phoenix 8 KB cartridge
.TP
.B 40
Blizzard 16 KB cartridge
.TP
.B 41
Atarimax 128 KB Flash cartridge
.TP
.B 42
Atarimax 1 MB Flash cartridge (old)
.TP
.B 43
SpartaDos X 128 KB cartridge
.TP
.B 44
OSS 8 KB cartridge
.TP
.B 45
OSS two chip 16 KB cartridge (043M)
.TP
.B 46
Blizzard 4 KB cartridge
.TP
.B 47
AST 32 KB cartridge
.TP
.B 48
Atrax SDX 64 KB cartridge
.TP
.B 49
Atrax SDX 128 KB cartridge
.TP
.B 50
Turbosoft 64 KB cartridge
.TP
.B 51
Turbosoft 128 KB cartridge
.TP
.B 52
Ultracart 32 KB cartridge
.TP
.B 53
Low bank 8 KB cartridge
.TP
.B 54
SIC! 128 KB cartridge
.TP
.B 55
SIC! 256 KB cartridge
.TP
.B 56
SIC! 512 KB cartridge
.TP
.B 57
Standard 2 KB cartridge
.TP
.B 58
Standard 4 KB cartridge
.TP
.B 59
Right slot 4 KB cartridge
.TP
.B 60
Blizzard 32 KB cartridge
.TP
.B 61
MegaMax 2 MB cartridge
.TP
.B 62
The!Cart 128 MB cartridge
.TP
.B 63
Flash MegaCart 4 MB cartridge
.TP
.B 64
MegaCart 2 MB cartridge
.TP
.B 65
The!Cart 32 MB cartridge
.TP
.B 66
The!Cart 64 MB cartridge
.TP
.B 67
XEGS 64 KB cartridge (banks 8-15)
.TP
.B 68
Atrax 128 KB cartridge
.TP
.B 69
aDawliah 32 KB cartridge
.TP
.B 70
aDawliah 64 KB cartridge
.TP
.B 71
Super Cart 64 KB 5200 cartridge (32K banks)
.TP
.B 72
Super Cart 128 KB 5200 cartridge (32K banks)
.TP
.B 73
Super Cart 256 KB 5200 cartridge (32K banks)
.TP
.B 74
Super Cart 512 KB 5200 cartridge (32K banks)
.TP
.B 75
Atarimax 1 MB Flash cartridge (new)
.TP
.B 76-93
Reserved
.TP
.B 94
Ram-Cart 64 KB cartridge
.TP
.B 95
Ram-Cart 128 KB cartridge
.TP
.B 96
Double Ram-Cart 2x128/256 KB cartridge
.TP
.B 97
Ram-Cart 1 MB cartridge
.TP
.B 98
Ram-Cart 2 MB cartridge
.TP
.B 99
Ram-Cart 4 MB cartridge
.TP
.B 100
Ram-Cart 8 MB cartridge
.TP
.B 101
Ram-Cart 16 MB cartridge
.TP
.B 102
Ram-Cart 32 MB cartridge
.TP
.B 103
SiDiCar 32 KB cartridge
.TP
.B 104-160
Reserved
.PD
.PP
If this option is not given, the user will be asked to choose the cartridge
type when the emulator starts.
.RE
.TP
.BI \-cart2\  filename
Insert piggyback cartridge (CART or raw format).
This works only if the first cartridge is a pass-through (currently only
SpartaDOS X 64KB and 128KB types).
.TP
.BR "\-cart2\-type 0 .. 160"
Select type of the cartridge inserted with the \fB-cart2\fR option.
When inserting a raw ROM image its type cannot be detected automatically,
and must be provided with this option.
The available values are the same as for the \fB\-cart\-type\fR option above.
.TP
.B \-cart\-autoreboot
Automatically reboot after cartridge inserting/removing (this is the default
setting).
This does not apply to the piggyback cartridge - inserting or removing it
never causes automatic reboot.
.TP
.B \-no\-cart\-autoreboot
Disable automatic reboot after cartridge inserting/removing.

.TP
.BI \-run\  filename
Run Atari program (EXE, COM, XEX, BAS, LST)
.TP
.BI \-state\  filename
Load saved-state file
.TP
.BI \-tape\  filename
Attach cassette image (CAS format or raw file)
.TP
.BI \-boottape\  filename
Attach cassette image and boot it
.TP
.B \-tape\-readonly
Set the attached cassette image as read-only. 


.TP
.B \-1400
Emulate the Atari 1400XL
.TP
.B \-xld
Emulate the Atari 1450XLD
.TP
.B \-bb
Emulate the CSS Black Box
.TP
.B \-mio
Emulate the ICD MIO board

.TP
.B \-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.
.TP
.B \-nopatchall
Don't patch OS at all, H:, P: and R: devices won't work

.TP
.BI \-H1\  path
Set path for H1: device
.TP
.BI \-H2\  path
Set path for H2: device
.TP
.BI \-H3\  path
Set path for H3: device
.TP
.BI \-H4\  path
Set path for H4: device
.TP
.BI \-Hpath\  path
Set path for Atari executables on the H: device
.TP
.B \-hreadonly
Enable read-only mode for H: device
.TP
.B \-hreadwrite
Disable read-only mode for H: device
.TP
.B \-devbug
Put debugging messages for H: and P: devices in log file

.TP
.B \-rtime
Enable R-Time 8 emulation
.TP
.B \-nortime
Disable R-Time 8 emulation

.TP
\fB\-rdevice\fR [\fIdev\fR]
Enable R: device.
If \fIdev\fR is specified then it's used as host serial device name (e.g.
\fI/dev/ttyS0\fR on linux).
If there is no \fIdev\fR specified then R: is directed to network.

.TP
.B \-mouse off
Do not use mouse
.TP
.B \-mouse pad
Emulate paddles
.TP
.B \-mouse touch
Emulate Atari Touch Tablet
.TP
.B \-mouse koala
Emulate Koala Pad
.TP
.B \-mouse pen
Emulate Light Pen
.TP
.B \-mouse gun
Emulate Light Gun
.TP
.B \-mouse amiga
Emulate Amiga mouse
.TP
.B \-mouse st
Emulate Atari ST mouse
.TP
.B \-mouse trak
Emulate Atari Trak-Ball
.TP
.B \-mouse joy
Emulate joystick using mouse
.TP
.BI \-mouseport\  num
Set mouse port 1-4 (default 1)
.TP
.BI \-mousespeed\  num
Set mouse speed 1-9 (default 3)
.TP
.B \-multijoy
Emulate MultiJoy4 interface
.TP
.B \-directmouse
Use mouse's absolute position
.TP
.BI \-cx85\  num
Emulate CX85 numeric keypad on port \fInum\fR
.TP
.B \-grabmouse
SDL only, prevent mouse pointer from leaving the window

.TP
.BI \-record\  filename
Record all input events to \fIfilename\fR. Can be used for gaming contests
(highest score etc).
.TP
.BI \-playback\  filename
Playback input events from \fIfilename\fR. Watch an expert play the game.
.TP
.B \-playbacknoexit
Don't exit the emulator after playback finishes.

.TP
.B \-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.

.TP
\fB\-ntsc\-artif \fImode\fR, \fB\-pal\-artif \fImode\fR
Set emulation mode of video artifacts in NTSC or PAL, respectively. The
available values for \fImode\fR are:
.RS
.PD 0
.TP
.B none
Disable video artifacts.
.TP
.B ntsc-old
Simple emulation of NTSC composite video artifacts. Fast but inaccurate.
.TP
.B ntsc-new
Improved emulation of NTSC artifacts. May look better than \fBntsc\-old\fR.
.TP
.B ntsc-full
Full emulation of NTSC artifacts. Rather slow and available only in 16-
and 32-bit video modes.
.TP
.B pal-simple
Simple emulation of PAL chroma blending, without composite artifacts. Fast but
inaccurate.
.TP
.B pal-blend
Accurate emulation of PAL chroma blending, without composite artifacts.
Available only in 16- and 32-bit video modes.
.PD
.RE
.TP
.BI \-artif\  mode
Set artifacting mode 0-4 (0 = disable). Only for tv effects \fBntsc\-old\fR and \fBntsc\-new\fR.

.TP
.BR "\-colors\-preset standard" | "deep\-black" | vibrant
Use one of predefined colour adjustments
.TP
.BI \-saturation\  n
Set screen color saturation (like TV Colour control)
.TP
\fB\-ntsc\-saturation \fIn\fR, \fB\-pal\-saturation \fIn\fR
Set saturation only for NTSC or PAL, respectively
.TP
.BI \-contrast\  n
Set screen contrast (also called white level)
.TP
\fB\-ntsc\-contrast \fIn\fR, \fB\-pal\-contrast \-fIn\fR
Set contrast only for NTSC or PAL, respectively
.TP
.BI \-brightness\  n
Set screen brightness (also called black level)
.TP
\fB\-ntsc\-brightness \fIn\fR, \fB\-pal\-brightness \fIn\fR
Set brightness only for NTSC or PAL, respectively
.TP
.BI \-gamma\  n
Set screen gamma correction
.TP
\fB\-ntsc\-gamma \fIn\fR, \fB\-pal\-gamma \fIn\fR
Set gamma adjustment only for NTSC or PAL, respectively
.TP
.BI \-tint\  n
Set tint -1..1.
.TP
\fB\-ntsc\-tint \fIn\fR, \fB\-pal\-tint \fIn\fR
Set tint only for NTSC or PAL, respectively
.TP
.BI \-ntsc-colordelay\  n
Set GTIA color delay for NTSC system.
This emulates adjusting the potentiometer existing at the bottom of Atari
computers, which adjusts hues of colors produced by the computer.
.TP
.BI \-pal\-colordelay\  n
Set GTIA color delay for PAL system.

.TP
\fB\-paletten \fIfilename\fR, \fB\-palettep \fIfilename\fR
Read Atari NTSC/PAL colors from ACT file
.TP
.BR \-paletten\-adjust ,\  \-palettep\-adjust
Apply colour adjustments (brightness, contrast etc.) to the loaded NTSC/PAL
palette (by default the loaded palette is displayed unmodified).

.TP
.BI \-screenshots\  pattern
Set filename pattern for screenshots.
Use to override the default pattern of \fIatari###.png\fR which produces
\fIatari000.png\fR, \fIatari001.png\fR etc. filenames.
Hashes are replaced with raising numbers.
Existing files are overwritten only if all the files defined by the pattern
exist.

.TP
.B \-showspeed
Show percentage of actual speed

.TP
.B \-sound
Enable sound
.TP
.B \-nosound
Disable sound
.TP
.BI \-dsprate\  freq
Set sound output frequency in Hz.
The default is 44100 Hz.
.TP
.B \-stereo
Enable stereo sound
.TP
.B \-nostereo
Disable stereo sound
.TP
.B \-audio16
Set sound output format to 16-bit
.TP
.B \-audio8
Set sound output format to 8-bit
.TP
.BI \-aname\  pattern
Set filename pattern for audio recordings.
Use to override the default pattern of \fIatari###.wav\fR which produces
\fIatari000.wav\fR, \fIatari001.wav\fR etc. filenames.
Hashes are replaced with raising numbers.

Note that WAV format files can support all audio codecs, including MP3,
but many programs assume WAV files contain only PCM audio.

If MP3 support was enabled when compiling the emulator, and MP3 audio is
selected using the \fB\-acodec mp3\fR option below, the default pattern
will be \fIatari###.mp3\fR to save in MP3 format files.
.TP
\fB\-acodec auto\fR|\fBpcm\fR|\fBmp3\fR|\fBmulaw\fR|\fBpcm_mulaw\fR|\fBadpcm\fR|\fBadpcm_ima_wav\fR|\fBadpcm_yahama\fR|\fBadpcm_ms\fR
Select the audio codec used when saving to AVI or WAV files. Some codecs are
lossy, meaning they reduce storage space while attempting to sound as close as
possible to the original audio.

.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the codec that provides the best audio quality, which is PCM.
.TP
.B pcm
Use uncompressed pulse-code modulated (PCM) samples. Lossless. Produces very
large audio files.
.TP
.B mp3
Use MP3 encoding. Lossy; only available with 16-bit audio, and provides the best
possible quality of all the lossy codecs while also using the least storage space.
This codec is only available if MP3 support is enabled when compiling the emulator.
.TP
.B mulaw
Use mu-law encoding. Lossy; only available with 16-bit audio, and provides 2x
reduction in size from PCM samples. Comparible acoustic quality to a 192kbps MP3 file.
.TP
.B pcm_mulaw
Sames as \fBmulaw\fR, included to match ffmpeg codec name.
.TP
.B adpcm
Use the best adaptive dynamic pulse-code modulated (ADPCM) codec. Lossy; all
ADCPM codecs provide 4x reduction in size over PCM samples. Comparible
acoustic quality to a 64kbps MP3 file.
.TP
.B adpcm_ima_wav
Use the DVI IMA ADPCM algorithm. This seems to perform better on POKEY waveforms
than other ADPCM algorithms and will be used when \fBadpcm\fR is selected.
.TP
.B adpcm_yamaha
Use the Yamaha ADPCM algorithm.
.TP
.B adpcm_ms
Use the Microsoft ADPCM algorithm.
.PD
.RE
.TP
.BI \-ab\  kbps
Set the bitrate in kbps of the MP3 codec. The default is 128, and can range
between 8 and 320. Higher numbers mean better quality at the cost of increased
file size.
.TP
.BI \-ar\  freq
Set the output sample rate in Hz of the MP3 codec. The default is the same
sample rate as set by the \fB-dsprate\fR option. Only a limited set of choices
are available: 8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100 and 48000.
As with bitrate, higher numbers mean better quality and larger files.
.TP
.BI \-aq\  num
Set the MP3 audio compression algorithm quality 0-9 (default 4). 0 means reduced
quality but fast, 9 uses the slowest algorithms to try to increase quality.
Does not affect storage space.
.TP
.BI \-snd\-buflen\  ms
Set length of the hardware sound buffer in milliseconds.
Setting to 0 (the default) causes the length to be set automatically.
Higher values increase sound latency.
Automatic setting should be OK in most cases.
.TP
.BI \-snddelay\  ms
Set sound latency in milliseconds. 
Increase it if you experience gaps of silence during sound playback.

.TP
.BI \-vname\  pattern
Set filename pattern for video recordings.
Use to override the default pattern of \fIatari###.avi\fR which produces
\fIatari000.avi\fR, \fIatari001.avi\fR etc. filenames.
Hashes are replaced with raising numbers.
.TP
\fB\-vcodec auto\fR|\fBrle\fR|\fBmsrle\fR|\fBpng\fR|\fBzmbv\fR|\fBuzmbv\fR
Select the video codec used to store image frames in AVI video recordings.
All video codecs use lossless compression.
.PP
.RS
.PD 0
.TP
.B auto
The default.
Use the codec that provides the best average compression ratio which is \fBzmbv\fR
if available, otherwise \fBrle\fR.
.TP
.B rle
Use run-length encoding (RLE) for very good compression of video frames. This codec is
always available.
.TP
.B msrle
Sames as \fBrle\fR, included to match ffmpeg codec name.
.TP
.B png
Use PNG image compression for moderate compression of video frames. This codec is only
available if PNG support was compiled into the emulator.
.TP
.B zmbv
Use Zip Motion Blocks Video (ZMBV) for the best compression of video frames.
This codec is only available if support for the zlib compression library was
compiled into the emulator.
.TP
.B uzmbv
Uncompressed Zip Motion Blocks Video is only available when compiled without the
zlib compression library.
.PD
.RE
.TP
.B \-showstats
Show elapsed recording time and file size on screen during recording of video or audio.
.TP
.B \-no-showstats
Don't show multimedia statistics during recording of video or audio
.TP
.BI \-keyint\  num
Set the keyframe interval to one keyframe every \fInum\fR frames (default is 50
for PAL, 60 for NTSC). The RLE and ZMBV codecs use keyframes and inter-frames, which
encode full frames and differences between frames, respectively. Inter-frames
are typically much smaller than full frames, but most video players can only
seek to keyframes.
.TP
.BI \-compression-level\  num
Set compression level 0-9 (default 6) PNG or zlib compression used in the
emulator. Zero means no compression and larger numbers correspond to higher
compression and smaller image sizes, at the cost of increased time to generate
the compressed image. This affects both screenshots and the video codec.


.SS Curses Options

.TP
.B \-left
Use columns 0 to 39
.TP
.B \-central
Use columns 20 to 59
.TP
.B \-right
Use columns 40 to 79
.TP
.B \-wide1
Use columns 0 to 79.
In this mode only the even character positions are used.
The odd locations are filled with spaces.
.TP
.B \-wide2
Use columns 0 to 79.
This mode is similar to \fB-wide1\fP except that the spaces are in reverse
video if the previous character was also in reverse video.

.SS Falcon Options

.TP
.BI \-interlace\  x
Generate Falcon screen only every \fIx\fR frame
.TP
.B \-videl
Direct VIDEL programming (Falcon/VGA only)
.TP
.B \-double
Double the screen size on NOVA
.TP
.B \-delta
Delta screen output (differences only)
.TP
.B \-joyswap
Swap joysticks

.SS Java NestedVM Options

.TP
.BI \-scale\  n
Scale width and height by \fIn\fR

.SS SDL Options

.TP
.B \-fullscreen
Start in fullscreen mode.
The default resolution is 336x240 and can be later changed.
.TP
.B \-windowed
Start in a window (the default).
.TP
.B \-rotate90
Rotate display (useful for devices with 240x320 screen).
.TP
.B \-no\-rotate90
Don't rotate display (the default).
.TP
.BI \-fs\-width\ number\-of\-pixels
Host horizontal resolution for fullscreen.
.TP
.BI \-fs\-height\  number\-of\-pixels
Host vertical resolution for fullscreen.
.TP
.BI \-win\-width\  number\-of\-pixels
Set horizontal size of the window.
The window can be later resized manually.
.TP
.BI \-win\-height\  number\-of\-pixels
Set vertical size of the window.
The window can be later resized nanually.
.TP
.BI \-bpp\ number\-of\-bits
Sets image color depth when OpenGL acceleration is disabled.
Accepted values are: \fB0\fR (use desktop depth; this is the default),
\fB8\fR, \fB16\fR and \fB32\fR.
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.
.TP
.B \-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 \fBSDL_VIDEODRIVER\fR
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.
.TP
.B \-no\-vsync
Disable synchronization with monitor's vertical retrace (the default).
.TP
\fB\-horiz\-area narrow\fR|\fBtv\fR|\fBfull\fR|\fInumber\fR
Set amount of visible screen horizontally:
.PP
.RS
.PD 0
.TP
.B narrow
Shows 320 pixels.
.TP
.B tv
The default.
Shows area visible on a standard TV (336 pixels).
.TP
.B full
Shows full overscan area (384 pixels).
.TP
.I number
An exact horizontal size can be set by providing a \fInumber\fR between 160
and 384.
.PD
.RE
.TP
\fB\-vertical\-area short\fR|\fBtv\fR|\fBfull\fR|\fInumber\fR
Set amount of visible screen vertically:
.PP
.RS
.PD 0
.TP
.B short
Shows 200 pixels.
.TP
.B tv
The default.
Shows area visible on a typical TV (224 or 240 pixels, depending on current TV
system).
.TP
.B full
Shows full overscan area, which can be up to 300 pixels in case of the XEP80.
.TP
.I number
An exact number of visible scanlines can be set by providing a \fInumber\fR
between 100 and 300.
.PD
.PP
Note that when displaying output of an XEP80 or Austin Franklin 80 column
card, the \fBtv\fR setting will crop the top and bottom parts of text area,
just like a real TV does - in such case setting the option to \fBfull\fR would
be more appriopriate.
.RE
.TP
.BI \-horiz\-shift\  number
When the visible horizontal area is not set to \fBfull\fR, 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).
.BI \-vert\-shift\  number
Analogically to \fB-horiz-shift\fR: when the visible vertical area is not set
to \fBfull\fR, 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).
.TP
\fB\-stretch none\fR|\fBintegral\fR|\fBfull\fR|\fInumber\fR
Choose method of stretching the image to fit the screen/window area:
.PP
.RS
.PD 0
.TP
.B none
The image won't be stretched at all.
.TP
.B integral
The default.
The image will fit the screen/window but will be stretched only by an integral
multiplier.
This setting allows for nice output when using scanlines in low screen
resolutions.
.TP
.B full
The screen will fit the entire screen/window area.
This setting looks best in high screen resolutions.
.TP
.I number
A custom multiplier (floating point number) can be also provided to precisely
set the amount of stretching.
.PD
.RE
.TP
\fB\-fit\-screen width\fR|\fBheight\R|\fBboth\fR
When \fB-stretch\fR is set to \fIintegral\fR or \fIfull\fR, this parameter
controls how the stretching is performed with relation to window/screen size:
.PP
.RS
.PD 0
.TP
.B width
Fits the image's width while allowing it to be cropped vertically.
.TP
.B height
Fits the image's height while allowing it to be cropped horizontally.
.TP
.B both
The default.
Fit both the image's width and height, avoiding cropping.
.PD
.RE
.TP
\fB\-image\-aspect none\fR|\fBsquare\-pixels\fR|\fBreal\fR
Choose how the image's aspect ratio should be maintained when stretching:
.PP
.RS
.PD 0
.TP
.B none
Causes the image to be stretched without restriction to fit the screen/window
area fully.
.TP
.B square\-pixels
The default.
Causes the image to be stretched by the same amount horizontally and
vertically, maintaining square pixels.
In low screen resolutions this setting may produce the nicest result.
.TP
.B real
Recreates the aspect ratio of a real TV display (pixels are not square), but
only if the \fB\-host\-aspect\-ratio\fR option is set correctly.
.PD
.RE
.TP
\fB\-host\-aspect\-ratio auto\fR|\fIx\fB:\fIy\fR
Set the aspect ratio of the host monitor on which the emulator's display is
placed.
Allowed values are \fBauto\fR for autodetection, or ratios like \fB4:3\fR,
\fB16:9\fR, \fB1.25:1\fR ...
This value is used to properly maintain image's aspect ratio when having
\fB\-image\-aspect\fR set to \fBreal\fR.
The default value is \fBauto\fR.
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 \fIwidth\fB:\fIheight\fR.
.TP
.B \-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 \fB\-af80\fR, \fB\-proto80\fR or \fB\-af80\fR.
.TP
.B \-no\-80column
Deactivates showing output of an 80 column hardware.


.TP
.B \-nojoystick
Do not initialize SDL joysticks
.TP
.B \-joy0hat
Use hat of joystick 0 rather than the axis for joystick movement.
.TP
.B \-joy1hat
Use hat of joystick 1 rather than the axis for joystick movement.
.TP
.B \-joy2hat
Use hat of joystick 2 rather than the axis for joystick movement.
.TP
.B \-joy3hat
Use hat of joystick 3 rather than the axis for joystick movement.
.TP
.BI \-joy0\  path\-to\-device
Define path to device used in LPTjoy 0. Available on linux-ia32 only.
.TP
.BI \-joy1\  path\-to\-device
Define path to device used in LPTjoy 1. Available on linux-ia32 only.

.TP
\fB\-ntsc\-filter\-preset composite\fR|\fBsvideo\fR|\fBrgb\fR|\fBmonochrome\fR
Use one of predefined NTSC filter adjustments.
.TP
.BI \-ntsc\-sharpness\  n
Set sharpness of the NTSC filter.
.TP
.BI \-ntsc\-resolution\  n
Set resolution of the NTSC filter.
.TP
.BI \-ntsc\-artifacts\  n
Set artifacts of the NTSC filter.
.TP
.BI \-ntsc\-fringing\  n
Set fringing of the NTSC filter.
.TP
.BI \-ntsc\-bleed\  n
Set bleed of the NTSC filter.
.TP
.BI \-ntsc\-burstphase\  n
Set burst phase of the NTSC filter.
This changes colors of artifacts.
The best values are \fB0\fR, \fB0.5\fR, \fB1\fR, \fB1.5\fR.
.TP
.BI \-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
\fB\-vert\-area\fR).
.TP
.B \-scanlinesint
Enable scanlines interpolation (looks nicer).
.TP
.B \-no\-scanlinesint
Disable scanlines interpolation (in software modes may give better performance).
.TP
.B \-video\-accel
Use OpenGL hardware acceleration for displaying and stretching of the emulator's
display.
Using OpenGL improves performance.
.TP
.B \-no\-video\-accel
Don't use OpenGL hardware acceleration (the default).
.TP
\fB\-pixel\-format bgr16\fR|\fBrgb16\fR|\fBbgra32\fR|\fBargb32\fR
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 \fBbgr16\fR or \fBrgb16\fR, emulation of
colors is slightly less accurate.
.TP
.B \-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.
.TP
.B \-no\-pbo
Don't use Pixel Buffer Objects when OpenGL acceleration is used.
.TP
.B \-bilinear\-filter
Enable bilinear filtering of the screen in OpenGL modes.
.TP
.B \-no\-bilinear\-filter
Disable bilinear filtering in OpenGL modes (the default).
.TP
.BI \-opengl\-lib\  path
Provide a custom OpenGL shared library.
If not given, Atari800 will use a default system-specific library (typically
\fIopengl32.dll\fR or \fIlibGL.so\fR).
.TP
.B \-proto80
Emulate a prototype 80 column board for the 1090
.TP
.B \-xep80
Emulate the XEP80
.TP
.BI \-xep80port\ n
Use XEP80 on joystick port \fIn\fR
.TP
.B \-af80
Emulate the Austin Franklin 80 column daughterboard for Atari 800.
.TP
.B \-volume 0..100
Sets global volume of Atari 800.


.SS X11 Options

.TP
.B \-small
Run the emulator in a small window where each Atari 800 pixel is
represented by one X Window pixel
.TP
.B \-large
Runs the emulator in a large window where each Atari 800 pixel is
represented by a 2x2 X Window rectangle. This mode is selected by
default.
.TP
.B \-huge
Runs the emulator in a huge window where each Atari 800 pixel is
represented by a 3x3 X Window rectangle.
.TP
.BI \-clip_x\  number\-of\-pixels
Set left offset for clipping
.TP
.BI \-clip_width\  number\-of\-pixels
Set the width of the clipping-area
.TP
.BI \-clip_y\  number\-of\-pixels
Set top offset for clipping
.TP
.BI \-clip_height\  number\-of\-pixels
Set the height of the clipping-area
.TP
.B \-private_cmap
Use private colormap
.TP
.B \-sio
Show SIO monitor
.TP
.B \-x11bug
Enable debug code in \fIatari_x11.c\fR

.TP
.B \-keypad
Keypad mode

.PD 0

.SH KEYBOARD, JOYSTICK AND OTHER CONTROLLERS

.TP 22
.B F1
Built in user interface
.TP
.B F2
Option key
.TP
.B F3
Select key
.TP
.B F4
Start key
.TP
.B F5
Reset key ("warm reset")
.TP
.BR Shift + F5
Reboot ("cold reset")
.TP
.B F6
Help key (XL/XE only)
.TP
.B F7
Break key
.TP
.B F8
Enter monitor
.TP
.B F9
Exit emulator
.TP
.B F10
Save screenshot
.TP
.BR Shift + F10
Save interlaced screenshot
.TP
.BR Alt + R
Run Atari program
.TP
.BR Alt + D
Disk management
.TP
.BR Alt + C
Cartridge management
.TP
.BR Alt + Y
Select system
.TP
.BR Alt + O
Sound settings
.TP
.BR Alt + W
Sound recording start/stop
.TP
.BR Alt + V
Video recording start/stop
.TP
.BR Alt + S
Save state file
.TP
.BR Alt + L
Load state file
.TP
.BR Alt + A
About the emulator
.TP
.B Shift + Insert
Insert line (Atari Shift+'>')
.TP
.BR Insert
Insert character (Atari Ctrl+'>')
.TP
.BR Shift + Ctrl + Insert
Shift+Ctrl+'>'
.TP
.B Shift + Delete
Delete line (Atari Shift+Backspace)
.TP
.BR Shift + Backspace
Delete line (Atari Shift+Backspace)
.TP
.BR Delete
Delete character (Atari Ctrl+Backspace)
.TP
.BR Ctrl + Backspace
Delete character (Atari Ctrl+Backspace)
.TP
.BR Shift + Ctrl + Delete
Shift+Ctrl+Backspace
.TP
.BR Shift + Ctrl + Backspace
Shift+Ctrl+Backspace
.TP
.B Home
Clear (Atari Shift+'<')
.TP
.BR Ctrl + Home
Ctrl+'<' (also clears screen)
.TP
.BR Shift + Ctrl + Home
Shift+Ctrl+'<'
.TP
.B ~
Inverse video
.TP
.B Up
Up (Atari Ctrl+'-')
.TP
.B Down
Down (Atari Ctrl+'=')
.TP
.B Left
Left (Atari ctrl+'+')
.TP
.B Right
Right (Atari ctrl+'*')
.TP
.BR Ctrl + Up
-
.TP
.BR Ctrl + Down
=
.TP
.BR Ctrl + Left
+
.TP
.BR Ctrl + Right
*
.TP
.BR Shift + Up
_ (Atari Shift+'-')
.TP
.BR Shift + Down
| (Atari Shift+'=')
.TP
.BR Shift + Left
\ (Atari Shift+'+')
.TP
.BR Shift + Right
^ (Atari Shift+'*')
.TP
.BR Shift + Ctrl + Up
Shift+Ctrl+-
.TP
.BR Shift + Ctrl + Down
Shift+Ctrl+=
.TP
\fBCtrl\fR+\fB\\\fR
Ctrl+Esc  (Workaround for Windows)
.TP
\fBShift\fR+\fBCtrl\fR+\fB\\\fR
Shift+Ctrl+Esc (Workaround for Windows)

.SS CX85 Keypad (if enabled):
.TP 25
.RB "host keypad " 0123456789- .
0123456789-.
.TP
.RB "host keypad " \/
NO
.TP
.RB "host keypad " Ctrl + /
ESCAPE
.TP
.RB "host keypad " *
DELETE
.TP
.RB "host keypad " +
YES
.TP
.RB "host keypad " Enter
+ENTER

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

.SS Basic

No function keys or \fBAlt\fR+\fIletter\fR shortcuts.
Use \fBCtrl\fR+\fBC\fR to enter the monitor.
Controllers not supported in this version.

.SS Curses

\fBF10\fR (Save screenshot) does not work in the default CURSES_BASIC build.
\fBShift\fR+\fBF5\fR and \fBShift\fR+\fBF10\fR don't work at all.
Avoid \fBCtrl\fR + \fBC\fR, \fBH\fR, \fBJ\fR, \fBM\fR, \fBQ\fR, \fBS\fR and
\fBZ\fR.
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.

.SS Falcon

.TP
.B Help
Help key (XL/XE)

.PP
Joystick 0 is operated by the numeric keypad (make sure that the numeric
keypad has been enabled).

        \fB7\fR \fB8\fR \fB9\fR
         \\|/
        \fB4\fR \fB5\fR \fB6\fR
         /|\\
        \fB1\fR \fB2\fR \fB3\fR

        And \fB0\fR is the fire key.

Mouse not supported in this version.

.SS SDL

.TP 15
.B `
Atari/Inverse key
.TP
.B LSUPER
Atari/Inverse key (unusable under Windows)
.TP
.B RSUPER
CapsToggle (+Shift = CapsLock)

.TP
.BR LAlt + F
Switch fullscreen/windowed display.
.TP
.BR LAlt + G
Switch visible horizontal area. See \fB\-horiz\-area\fR.
.TP
.BR LAlt + J
Swap \fBkeyboard_emulated\fP joysticks
.TP
.BR LAlt + M
Grab mouse (prevents mouse pointer from leaving the window)

.TP
.BR LAlt + LShift + 1
Decrease tint (also called hue)
.TP
.BR LAlt + 1
Increase hue
.TP
.BR LAlt + LShift + 2
Decrease saturation (like TV Colour control)
.TP
.BR LAlt + 2
Increase saturation
.TP
.BR LAlt + LShift + 3
Decrease contrast (also called white level)
.TP
.BR LAlt + 3
Increase contrast
.TP
.BR LAlt + LShift + 4
Decrease brightness (also called black level)
.TP
.BR LAlt + 4
Increase brightness
.TP
.BR LAlt + LShift + 5
Decrease gamma adjustment
.TP
.BR LAlt + 5
Increase gamma adjustment
.TP
.BR LAlt + LShift + 6
Decrease color delay (Atari color adjustment potentiometer)
.TP
.BR LAlt + 6
Increase color delay

.PP
The following keys work only when the NTSC filter is enabled (\fB\-ntsc\-artif\fR
set to \fBntsc\-full\fR):
.RS
.TP 15
.BR LAlt + LShift + 7
Decrease sharpness
.TP
.BR LAlt + 7
Increase sharpness
.TP
.BR LAlt + LShift + 8
Decrease resolution
.TP
.BR LAlt + 8
Increase resolution
.TP
.BR LAlt + LShift + 9
Decrease artifacts
.TP
.BR LAlt + 9
Increase artifacts
.TP
.BR LAlt + LShift + 0
Decrease fringing
.TP
.BR LAlt + 0
Increase fringing
.TP
.BR LAlt + LShift + -
Decrease bleed
.TP
.BR LAlt + -
Increase bleed
.TP
.BR LAlt + LShift + =
Decrease NTSC burst phase (use this to change artifacting colours)
.TP
.BR LAlt + =
Increase NTSC burst phase
.RE

.TP 15
.BR LAlt + LShift + [
Decrease scanlines visibility
.TP
.BR LAlt + [
Increase scanlines visibility
.TP
.BR LAlt + ]
Toggle NTSC composite/S-Video/RGB/monochrome settings


.TP
.BR LAlt + Shift + X
Enable/disable output of a 80 column hardware (use with \fB-xep80\fR,
\fB-proto80\fR or \fB-af80\fR).


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

.SS X11

.TP
.B Alt
Atari key (either Alt key will work)

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

.PD 1
.SH AUDIO RECORDING
Audio can be recorded to WAV format sound files or as the audio track of AVI
format multimedia files (described in the next section). A choice of audio
codecs is available, some using lossy compression to reduce file size as
compared to uncompressed audio. All lossy codecs require 16 bit sample sizes
using the \fB\-audio16\fR option.

The term "lossy" means the recorded sound is not bit-for-bit identical to the
output of the emulator. Each codec provides a different method to reduce size,
possibly reducing the audio quality. In practice, the audio produced by these
codecs is not perceptibly worse than lossless encoding when using sample rates
of 44.1kHz or 48kHz. However, the possibility exists that recompressing lossy
audio (for instance by uploading to YouTube) could reduce quality.
.PP
The only lossless codec provided is the pulse-code modulation (PCM) codec, which
simply stores the raw data generated by the POKEY emulation. This takes the most
space of any codec, but provides the best possible audio quality. The sample
size is specified by the \fB\-audio16\fR or \fB\-audio8\fR options. This is the
recommended codec unless extremely long recording times are desired. See the
tables in the \fBVIDEO RECORDING\fR section below.
.PP
The MP3 codec is the best choice of a lossy codec, as paramaters can be tuned
to generate high quality audio for different situations. An audio bitrate of
128kbps (the \fB-ab 128\fR option) results in high quality audio at about an
8x reduction in storage space over PCM audio. The MP3 codec is a compile-time
option, and will be included automatically if the libmp3lame library is found
during compilation.
.PP
The remaining lossy codecs should not be considered unless the MP3 codec is
not available. In most cases they produce reasonable quality, without many
audible artifacts to the casual listener. But the algorithms were originally
designed for compressing speech over telephone lines and they can produce
audio distortion in some instances.
.PP
The mu-law codec uses a logarithmic scale to convert 16 bit samples into 8 bits
of data, resulting in half the size of 16 bit PCM audio. This codec does not
work with 8 bit audio. Waveform analysis shows the acoustic quality is similar
to a 192kbps MP3 file, although the MP3 is half the size. Surprisingly,
in many cases the acoustic quality of mu-law can be better than 8 bit PCM samples
even though it takes the same storage space.
.PP
Adaptive differential pulse-code modulation (ADPCM) encodes differences between
successive 16 bit audio samples into 4 bits, therefore the
output is one quarter of the size of the PCM codec. The acoustic quality is
similar to a 64kbps MP3 file, although the MP3 is 3x smaller. Audio
distortio may be audible under certain conditions, like high volume
square waves.
.PD 1
.SH VIDEO RECORDING
.B atari800
is capable of recording the emulated video and audio to AVI format multimedia
files. A choice of lossless video codecs is available, while audio is stored
with any of the lossless or lossy codecs as described above. To record without
sound, specify the \fB\-nosound\fR option.
.PP
The most efficient video codec is the Zip Motion Block Video (ZMBV) codec. 
This codec uses keyframes and inter-frames, and achieves its high compression
because inter-frames use motion estimation when calculating differences to the
previous frame. It is a compile-time option when building the emulator, and
is the default if available. There is an uncompressed variant that is available
when compiled without zlib; see the note below.
.PP
The Run-Length Encoding (RLE) video codec also uses keyframes and inter-frames.
Its inter-frame compression is not as efficient as ZMBV, but still produces high
compression in cases where only small parts of the screen change between frames.
This codec is always available and is the default if compressed ZMBV is not
available.
.PP
The PNG video codec has moderate compression because it uses only keyframes.
It is useful in certain cases if the ZMBV codec is not available. It is a
compile-time option when building the emulator.
.PP
Uncompressed ZMBV is typically inferior to RLE and PNG and is not recommended in
general. There are a few limited instances (like detailed scrolling backgrounds)
where uncompressed ZMBV will outperform RLE or PNG, and for that reason it is
made available as the \fBuzmbv\fR codec when compiled without zlib. For testing
purposes when compiled with zlib, uncompressed ZMBV video can be generated with
the \fB-compression-level 0\fR command line argument.
.PP
Video Support:
.TS
tab(@), center, box;
l | c | c | c c c
l | c | c | cB cB cB.
Application@Type@Platform@RLE@PNG@ZMBV
_
YouTube@Website@Browser@Yes@Yes@Yes
Twitter@Website@Browser@No[1]@No[1]@No[1]
FFmpeg@Transcoder@Win/Mac/Lin@Yes@Yes@Yes
Handbrake@Transcoder@Win/Mac/Lin@Yes@Yes@Yes
VLC@Player@Win/Mac/Lin@Yes@No[2]@Yes
Windows Media Player@Player@Windows@Yes@No@No
Win 10 Movies & TV@Player@Windows@No@No@No
IINA@Player@Mac@Yes@Yes@Yes
QuickTime@Player@Mac@No@No@No
Totem (Gnome Videos)@Player@Linux@No@Yes@Yes
MPV (Celluloid)@Player@Linux@Yes@Yes@Yes
MPlayer@Player@Linux@Yes@Yes@Yes
.TE
.PP
        [1] Twitter only accepts \fBmp4\fR files using the \fBh264\fR video
            codec and the \fBaac\fR audio codec. The \fBavi\fR files produced
            by \fBatari800\fR must be transcoded with an application like
            FFmpeg or Handbrake. Videos are limited to 2 minutes and
            20 seconds.
.PP
        [2] VLC recognizes and plays PNG-encoded video, but decodes the
            video incorrectly resulting in garbled images.
.PP
Currently there is a limit of 4GB for video size. The maximum recording time for
this size limit depends on many factors. Some examples can be seen in the tables
below:
.PP
ZMBV codec (default compression level):
.TS
tab(@), center, box;
l | c | c s s s s
c | c | _ _ _ _ _
c | c | c c c c c
l | c | c c c c c
l | cB | cB cB cB cB cB.
@Average@Estimated recording time
Game@video@
@frame@mp3@mp3@ADPCM@8-bit@16-bit
@size@128 kbps@320 kbps@audio@audio@audio
_

Jumpman@0.08k@49 hr@23 hr@38 hr@21 hr@11 hr@
Miner 2049er@0.13k@43 hr@22 hr@35 hr@20 hr@11 hr@
Alley Cat@0.37k@28 hr@17 hr@24 hr@16 hr@9h 40m@
Dropzone@0.82k@17 hr@12 hr@15 hr@11 hr@7h 55m@
AtariBlast!@1.2k@12 hr@9h 55m@11 hr@9h 30m@6h 50m@
Boulder Dash@0.17k@40 hr@21 hr@33 hr@19 hr@10 hr@
.TE

.PP
RLE codec:
.TS
tab(@), center, box;
l | c | c s s s s
c | c | _ _ _ _ _
c | c | c c c c c
l | c | c c c c c
l | cB | cB cB cB cB cB.
@Average@Estimated recording time
Game@video@
@frame@mp3@mp3@ADPCM@8-bit@16-bit
@size@128 kbps@320 kbps@audio@audio@audio
_

Jumpman@0.36k@28 hr@17 hr@24 hr@16 hr@9h 45m@
Miner 2049er@0.39k@27 hr@17 hr@24 hr@15 hr@9h 35m@
Alley Cat@1.0k@14 hr@11 hr@13 hr@10 hr@7h 20m@
Dropzone@2.3k@7h 25m@6h 20m@7h 05m@6h 10m@4h 55m@
AtariBlast!@6.9k@2h 40m@2h 30m@2h 35m@2h 30m@2h 15m@
Boulder Dash@9.1k@2h 00m@1h 55m@2h 00m@1h 55m@1h 45m@
.TE

.PP
PNG codec (default compression level):
.TS
tab(@), center, box;
l | c | c s s s s
c | c | _ _ _ _ _
c | c | c c c c c
l | c | c c c c c
l | cB | cB cB cB cB cB.
@Average@Estimated recording time
Game@video@
@frame@mp3@mp3@ADPCM@8-bit@16-bit
@size@128 kbps@320 kbps@audio@audio@audio
_

Jumpman@2.4k@7h 05m@6h 10m@6h 50m@5h 55m@4h 45m@
Miner 2049er@2.2k@7h 40m@6h 35m@7h 20m@6h 20m@5h 00m@
Alley Cat@4.1k@4h 20m@4h 00m@4h 15m@3h 55m@3h 20m@
Dropzone@2.8k@6h 10m@5h 25m@6h 00m@5h 20m@4h 20m@
AtariBlast!@4.4k@4h 05m@3h 45m@4h 00m@3h 40m@3h 10m@
Boulder Dash@4.5k@4h 00m@3h 40m@3h 55m@3h 35m@3h 10m@
.TE

.PD 1

.SH FILES
.TP
.I /usr/share/atari800/ATARIOSA.ROM
Atari O/S A
.TP
.I /usr/share/atari800/ATARIOSB.ROM
Atari O/S B
.TP
.I /usr/share/atari800/ATARIXL.ROM
Atari 800XL O/S
.TP
.I /usr/share/atari800/ATARI5200.ROM
Atari 5200 O/S
.TP
.I /usr/share/atari800/ATARIBAS.ROM
Atari Basic

.SH BUGS
See the \fIBUGS\fR file.