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.

Falcon Options¶

-interlace x

Generate Falcon screen only every x frame

-videl

Direct VIDEL programming (Falcon/VGA only)

-double

Double the screen size on NOVA

-delta

Delta screen output (differences only)

-joyswap

Swap joysticks

Java NestedVM Options¶

-scale n

Scale width and height by n

SDL Options¶

-fullscreen

Start in fullscreen mode. The default resolution is 336x240 and can be later changed.

-windowed

Start in a window (the default).

-rotate90

Rotate display (useful for devices with 240x320 screen).

-no-rotate90

Don't rotate display (the default).

-fs-width number-of-pixels

Host horizontal resolution for fullscreen.

-fs-height number-of-pixels

Host vertical resolution for fullscreen.

-win-width number-of-pixels

Set horizontal size of the window. The window can be later resized manually.

-win-height number-of-pixels

Set vertical size of the window. The window can be later resized nanually.

-bpp number-of-bits

Sets image color depth when OpenGL acceleration is disabled. Accepted values are: 0 (use desktop depth; this is the default), 8, 16 and 32. 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.

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

-no-vsync

Disable synchronization with monitor's vertical retrace (the default).

-horiz-area narrow|tv|full|number

Set amount of visible screen horizontally:

-vertical-area short|tv|full|number

Set amount of visible screen vertically:

Note that when displaying output of an XEP80 or Austin Franklin 80 column card, the tv setting will crop the top and bottom parts of text area, just like a real TV does - in such case setting the option to full would be more appriopriate.

-horiz-shift number

When the visible horizontal area is not set to full, 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). -vert-shift number Analogically to -horiz-shift: when the visible vertical area is not set to full, 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).

-stretch none|integral|full|number

Choose method of stretching the image to fit the screen/window area:

-fit-screen width|height

When -stretch is set to integral or full, this parameter controls how the stretching is performed with relation to window/screen size:

-image-aspect none|square-pixels|real

Choose how the image's aspect ratio should be maintained when stretching:

-host-aspect-ratio auto|x:y

Set the aspect ratio of the host monitor on which the emulator's display is placed. Allowed values are auto for autodetection, or ratios like 4:3, 16:9, 1.25:1 ... This value is used to properly maintain image's aspect ratio when having -image-aspect set to real. The default value is auto. 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 width:height.

-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 -af80, -proto80 or -af80.

-no-80column

Deactivates showing output of an 80 column hardware.

-nojoystick

Do not initialize SDL joysticks

-joy0 path-to-device

Define path to device used in LPTjoy 0. Available on linux-ia32 only.

-joy1 path-to-device

Define path to device used in LPTjoy 1. Available on linux-ia32 only.

-ntsc-filter-preset composite|svideo|rgb|monochrome

Use one of predefined NTSC filter adjustments.

-ntsc-sharpness n

Set sharpness of the NTSC filter.

-ntsc-resolution n

Set resolution of the NTSC filter.

-ntsc-artifacts n

Set artifacts of the NTSC filter.

-ntsc-fringing n

Set fringing of the NTSC filter.

-ntsc-bleed n

Set bleed of the NTSC filter.

-ntsc-burstphase n

Set burst phase of the NTSC filter. This changes colors of artifacts. The best values are 0, 0.5, 1, 1.5.

-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 -vert-area).

-scanlinesint

Enable scanlines interpolation (looks nicer).

-no-scanlinesint

Disable scanlines interpolation (in software modes may give better performance).

-video-accel

Use OpenGL hardware acceleration for displaying and stretching of the emulator's display. Using OpenGL improves performance.

-no-video-accel

Don't use OpenGL hardware acceleration (the default).

-pixel-format bgr16|rgb16|bgra32|argb32

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 bgr16 or rgb16, emulation of colors is slightly less accurate.

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

-no-pbo

Don't use Pixel Buffer Objects when OpenGL acceleration is used.

-bilinear-filter

Enable bilinear filtering of the screen in OpenGL modes.

-no-bilinear-filter

Disable bilinear filtering in OpenGL modes (the default).

-opengl-lib path

Provide a custom OpenGL shared library. If not given, Atari800 will use a default system-specific library (typically opengl32.dll or libGL.so).

-proto80

Emulate a prototype 80 column board for the 1090

-xep80

Emulate the XEP80

-xep80port n

Use XEP80 on joystick port n

-af80

Emulate the Austin Franklin 80 column daughterboard for Atari 800.

-volume 0..100

Sets global volume of Atari 800.

X11 Options¶

-small

Run 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 rectangle. 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 rectangle.

-clip_x number-of-pixels

Set left offset for clipping

-clip_width number-of-pixels

Set the width of the clipping-area

-clip_y number-of-pixels

Set top offset for clipping

-clip_height number-of-pixels

Set the height of the clipping-area

-private_cmap

Use private colormap

-sio

Show SIO monitor

-x11bug

Enable debug code in atari_x11.c

-keypad

Keypad mode

CX85 Keypad (if enabled):¶

host keypad 0123456789-.

0123456789-.

host keypad

NO

host keypad Ctrl+/

ESCAPE

host keypad *

DELETE

host keypad +

YES

host keypad Enter

+ENTER

Paddles, Atari touch tablet, Koala pad, light pen, light gun, ST/Amiga mouse, Atari trak-ball, joystick and Atari 5200 analog controller are emulated using mouse on ports that support it. See the options above for how to enable mouse.

Basic¶

Curses¶

Controllers not supported in this version.

Falcon¶

Help

Help key (XL/XE)

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

7 8 9 \|/ 4 5 6 /|\ 1 2 3

And 0 is the fire key.

Mouse not supported in this version.

SDL¶

`

Atari/Inverse key

LSUPER

Atari/Inverse key (unusable under Windows)

RSUPER

CapsToggle (+Shift = CapsLock)

LAlt+F

Switch fullscreen/windowed display.

LAlt+G

Switch visible horizontal area. See -horiz-area.

LAlt+J

Swap keyboard_emulated joysticks

LAlt+M

Grab mouse (prevents mouse pointer from leaving the window)

LAlt+LShift+1

Decrease tint (also called hue)

LAlt+1

Increase hue

LAlt+LShift+2

Decrease saturation (like TV Colour control)

LAlt+2

Increase saturation

LAlt+LShift+3

Decrease contrast (also called white level)

LAlt+3

Increase contrast

LAlt+LShift+4

Decrease brightness (also called black level)

LAlt+4

Increase brightness

LAlt+LShift+5

Decrease gamma adjustment

LAlt+5

Increase gamma adjustment

LAlt+LShift+6

Decrease color delay (Atari color adjustment potentiometer)

LAlt+6

Increase color delay

The following keys work only when the NTSC filter is enabled (-ntsc-artif set to ntsc-full):

LAlt+LShift+[

Decrease scanlines visibility

LAlt+[

Increase scanlines visibility

LAlt+]

Toggle NTSC composite/S-Video/RGB/monochrome settings

LAlt+Shift+X

Enable/disable output of a 80 column hardware (use with -xep80, -proto80 or -af80).

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

X11¶

Alt

Atari key (either Alt key will work)

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.