hatari man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

HATARI(1)							     HATARI(1)

NAME
       hatari - Atari ST(e) emulator

SYNOPSIS
       hatari [options] [diskimage]

DESCRIPTION
       Hatari  is  an  Atari ST(e) emulator for Linux, FreeBSD, BeOS and other
       Systems which are supported by the SDL library.

       With hatari one can run games, demos or applications written for	 Atari
       ST  or  Atari  STE.  It	supports the commonly used *.st and *.msa disk
       images and hard disk emulation.

       To run the emulator a TOS ROM image is needed. EmuTOS, a free implemen‐
       tation of TOS is shipped with hatari. Since it is not yet fully compat‐
       ible with the original TOS some programs won't run correctly with this.
       Because of this it is recommended to use a TOS ROM from a real Atari.

OPTIONS
       Hatari options are split into several categories:

General options
       -h, --help
	      Print command line options and terminate

       -v, --version
	      Print version information and terminate

       --confirm-quit <bool>
	      Whether Hatari confirms quitting

       -c, --configfile <filename>
	      use   the	 mentioned  file  as  configuration  file  instead  of
	      ~/.hatari.cfg

Display options
       -m, --mono
	      Start in monochrome mode instead of color

       --monitor <x>
	      Select monitor type (x = mono/rgb/vga/tv)

       -f, --fullscreen
	      Start the emulator in fullscreen mode

       -w, --window
	      Start the emulator in window mode

       -z, --zoom <x>
	      Zoom low resolution (1=no, 2=yes)

       --frameskips <x>
	      Skip <x> frames after each displayed frame to accelerate	emula‐
	      tion (0 <= x <= 8)

       --borders <bool>
	      Show screen borders (for overscan demos etc)

       --spec512 <x>
	      Hatari  uses  this  threshold  to decide when to render a screen
	      with the slower but more accurate Spectrum512 screen  conversion
	      functions (0 <= x <= 512, 0=disable)

       --bpp <bool>
	      Force  given  internal  bitdepth	(x=8/16/32, x=0 for autodetec‐
	      tion).  8-bit color depth may be useful for older host computers

VDI options
       --vdi-planes <x>
	      Use extended VDI resolution with bit depth <x> (x = 1, 2 or 4)

       --vdi-width <w>
	      Use extended VDI resolution with width <w> (384 <= w <= 1024)

       --vdi-height <h>
	      Use extended VDI resolution with height <h> (200 < h <= 768)

Devices options
       -j, --joystick <port>
	      Emulate joystick with cursor keys in given port (0-5)

       --printer <file>
	      Enable printer support and write data to <file>

       --midi <filename>
	      Enable experimental MIDI output to the mentioned file

       --rs232 <filename>
	      Enable  experimental   RS232   emulation	 via   the   mentioned
	      file/device

Disk options
       -d, --harddrive <dir>
	      Use <dir> as an emulated hard disk

       --acsi <file>
	      Emulate ACSI hard disk with an image <file>

       --slowfdc <bool>
	      slow  down  FDC  emulation  (needed to make some games and demos
	      work)

Memory options
       -s, --memsize <x>
	      Set amount of emulated RAM, x = 1 to 14 MiB, or 0 for 512 KiB

       -t, --tos <imagefile>
	      Specify TOS ROM image to use

       --cartridge <imagefile>
	      Use ROM cartridge image <file> (only works if GEMDOS  HD	emula‐
	      tion and extended VDI resolution are disabled)

       --memstate <file>
	      Load memory snap-shot <file>

CPU options
       --cpulevel <x>
	      Specify  CPU  (680x0)  to	 use (use x >= 1 with EmuTOS or TOS >=
	      2.06 only!)

       --cpuclock <x>
	      Set the CPU clock (8, 16 or 32 Mhz)

       --compatible <bool>
	      Use a more compatible but slower 68000 CPU mode

Misc system options
       --machine <x>
	      select machine type (x = st, ste, tt or falcon)

       --blitter <bool>
	      Enable blitter emulation

       --dsp <x>
	      Falcon DSP emulation (x = none, dummy or emu)

       --sound <x>
	      Sound quality (off/low/med/hi (off=faster))

       --keymap <file>
	      load keyboard mapping from <file>

Debug options
       -D, --debug <bool>
	      activate the simple builtin debugger

       --log <file>
	      Save log to <file> (can also be "stdout" or "stderr")

       --trace <trace1,...>
	      Activate debug traces, see --trace help for tracing options

COMMANDS
       The shortcut keys can be configured in  the  configuration  file.   The
       default settings are:

       AltGr + a
	      record animation

       AltGr + g
	      grab a screenshot

       AltGr + i
	      boss key: leave full screen mode and iconify window

       AltGr + j
	      activate joystick emulation via cursor keys

       AltGr + m
	      (un-)lock the mouse into the window

       AltGr + r
	      (warm) reset the ST

       AltGr + c
	      coldreset the ST (same as the original power switch)

       AltGr + s
	      enable/disable sound

       AltGr + q
	      quit the emulator

       AltGr + x
	      toggle normal/max speed

       AltGr + y
	      enable/disable sound recording

       AltGr + k
	      save memory snapshot

       AltGr + l
	      load memory snapshot

       F11    toggle between fullscreen and windowed mode

       F12    activate the hatari command GUI
	      You may need to hold SHIFT down while in windowed mode.

       Pause  will  go	to  the	 debugger if it was activated with the --debug
	      option

Emulated Atari ST keyboard
       All other keys on the keyboard act as  the  normal  Atari  ST  keys  so
       pressing SPACE on your PC will result in an emulated press of the SPACE
       key on the ST. The following keys have special meanings:

       Alt    will act as the ST's ALTERNATE key

       left Ctrl
	      will act as the ST's CONTROL key

       Page Up
	      will emulate the ST's HELP key

       Page Down
	      will emulate the ST's UNDO key

       AltGr will act as Alternate as well as long as  you  do	not  press  it
       together with a Hatari hotkey combination.

       The  right Ctrl key is used as the fire button of the emulated joystick
       when you turn on joystick emulation via keyboard.

       The cursor keys will act as the cursor keys on the Atari ST as long  as
       joystick emulation via keyboard has been turned off.

SEE ALSO
       The main program documentation, usually in /usr/share/doc/.

       The homepage of hatari: http://hatari.sourceforge.net

FILES
       /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
	      the global configuration file of Hatari

       ~/.hatari.cfg
	      the user's personal Hatari configuration file

       tos.img
	      The  TOS	ROM  image  will  be loaded from the data directory of
	      Hatari unless it is specified on the command line or the config‐
	      uration file.

AUTHOR
       This  manual page was written by Marco Herrn <marco@mherrn.de>, for the
       Debian project and later modified by Thomas Huth	 to  suit  the	latest
       version of Hatari.

Hatari				  2008-03-14			     HATARI(1)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net