---
name: "atari800.svgalib"
section: "1"
platform: "linux"
package: "atari800"
version: "1.2.2-1woody3"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/atari800"
---

# atari800.svgalib(1)

Atari 800 Emulator, Version 0.8.1

Part of [atari800(1)](/atari800/1.md).

## NAME

atari800 - Atari 800 Emulator, Version 0.8.1

## SYNOPSIS

**atari800** \[options\] \[diskfiles...\]

## DESCRIPTION

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

### Options

- **-a**

  **Use Atari OS/A.**

- **-b**

  **Use Atari OS/B.**

- **-xl**

  **Emulate Atari 800 XL.**

- **-xe**

  **Emulate Atari 130 XE - but Antic accesses the same bank the CPU is using.**

- **-5200**

  **Emulate Atari 5200 - Games controller emulation has not been implemented yet!**

- **-config filename**

  **Specify an alternative configuration filename.**

- **-configure**

  **Starts emulator in run-time configuration mode.**

- **-nobasic**

  **Used to disable Basic when starting the emulator in XL/XE mode.** **Simulates the Option key being held down during system boot.**

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

- **-xcolpf1**

  **Enables Extended Use of COLPF1 register as used by Antic Modes 2, 3 and** **f. This option allows two different colours to be displayed in these** **modes - i.e. Not one colour and two luminances.**

- **-rom filename**

  **Path to file containing a standard 8K ROM cartridge.**

- **-rom16 filename**

  **Path to file containing a standard 16K ROM cartridge.**

- **-ags32 filename**

  **Path to file containing 32K ROM cartridge for the Atari 5200 Games System.**

- **-oss filename**

  **Path to file containing OSS super-cartridge.**

- **-db filename**

  **Path to file containing DB super-cartridge.**

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

  **Path to file containing Atari XL/XE Operating System.** **Used to override paths defined at compile time.**

- **-5200\_rom**

  **Path to file containing Atari 5200 Games System ROM.** **Used to override paths defined at compile time.**

- **-basic\_rom**

  **Path to file containing Atari BASIC ROM.** **Used to override paths defined at compile time.**

- **-c**

  **Enable RAM between $c000 and $d000.**

- **-v**

  **Print emulator version.**

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

### SVGALIB Options

- **-sound**

  **Enable sound using the Network Audio System.**

- **-interlace**

  **Enable screen interlace option**

### X Window Options

- **-private\_cmap**

  **Tells the Emulator to use its own private colormap.**

- **-small**

  **Runs the emulator in a small window where each Atari 800 pixel is** **represented by one X Window pixel.**

- **-large**

  **Runs the emulator in a large window where each Atari 800 pixel is** **represented by a 2x2 X Window rectange. This mode is selected by** **default.**

- **-huge**

  **Runs the emulator in a huge window where each Atari 800 pixel is** **represented by a 3x3 X Window rectange.**

- **-clip\_x number-of-pixels**

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

- **-sound**

  **Enable sound using the Network Audio System.**

### Amiga Options

- **-ocs**

  **Used for OCS based Amigas. It has not been tested on a real OCS** **based computer and there could be problems with regard to Workbench** **versions.**

- **-ecs**

  **Used for ECS based Amigas. It has not been tested on a real ECS** **based computer and there could be problems with regard to Workbench** **versions.**

- **-aga**

  **Used for AGA based Amigas. It has been tested on an Amiga 1200 with** **68030 + 4Mb Fast RAM.**

- **-grey**

  **Produce a grey scale display.**

- **-colour**

  **Produce a full colour on AGA machines and up to 32 simultaneous** **colours on OCS and ECS machines.**

- **-wb**

  **Runs the emulator in a Workbench Window. Use a screen mode with** **a minimum of 16 colours for best results.**

### Curses Options

- **-left**

  **Use columns 0 to 39.**

- **-central**

  **Use columns 20 to 59.**

- **-right**

  **Use columns 40 to 79.**

- **-wide1**

  **Use columns 0 to 79. In this mode only the even character positions** **are used. The odd locations are filled with spaces.**

- **-wide2**

  **Use columns 0 to 79. This mode is similar to -wide1 except that** **the spaces are in reverse video if the previous character was also** **in reverse video.**

## FILES

- */usr/local/lib/atari/atariosa.rom*

  Atari O/S A

- */usr/local/lib/atari/atariosb.rom*

  Atari O/S B

- */usr/local/lib/atari/atarixl.rom*

  Atari 800 XL O/S

- */usr/local/lib/atari/atari5200.rom*

  Atari 5200 O/S

- */usr/local/lib/atari/ataribas.rom*

  Atari Basic

## BUGS

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