Rechercher une page de manuel
hatari
Langue: en
Version: 2008-09-28 (fedora - 04/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
hatari - Atari ST/STE/TT/Falcon emulatorSYNOPSIS
hatari [options] [diskimage]DESCRIPTION
Hatari is an Atari ST/STE/TT/Falcon 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. TT and Falcon support is experimental. Hatari 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 implementation of TOS is shipped with hatari. Since it is not yet fully compatible 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 given file as configuration file instead of ~/.hatari/hatari.cfg
- --fast-forward <bool>
- On fast machine helps skipping (fast forwarding) Hatari output
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 emulation (0=disabled, >4 uses automatic frameskip with given value as maximum)
- --borders <bool>
- Show screen borders (for overscan demos, ST(e) color mode specific etc)
- --statusbar <bool>
- Show statusbar (with floppy leds etc etc)
- --drive-led <bool>
- Show overlay drive led when statusbar isn't shown
- --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 internal bitdepth (x = 8/15/16/32, 0=disable)
VDI options
- --vdi <bool>
- Whether to use VDI screen mode
- --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)
- --joy<port> <type>
- Set joystick type (none/keys/real) for given port
- --printer <file>
- Enable printer support and write data to <file>
- --midi-in <filename>
- Enable MIDI support and write MIDI data to <file>
- --midi-out <filename>
- Enable MIDI support and read MIDI data from <file>
- --rs232-in <filename>
- Enable serial port support and use <file> as the input device
- --rs232-out <filename>
- Enable serial port support and use <file> as the output device
Disk options
- --disk-a <file>
- Set disk image for floppy drive A
- --disk-b <file>
- Set disk image for floppy drive B
- -d, --harddrive <dir>
- Emulate an ST harddrive (<dir> = root directory)
- --acsi <file>
- Emulate an ACSI hard disk with an image <file>
- --ide <file>
- Emulate an IDE hard disk with an image <file>
- --slowfdc <bool>
- slow down FDC emulation (deprecated)
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 emulation 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 (ST only)
- --dsp <x>
- Falcon DSP emulation (x = none, dummy or emu, Falcon only)
- --sound <x>
- Sound quality (off/low/med/hi, off=faster)
- -k, --keymap <file>
- load keyboard mapping from <file>
Debug options
- -D, --debug <bool>
- Enable Hatari debugger console interface
- --bios-intercept
- Enable Bios/XBios interception
- --trace <trace1,...>
- Activate debug traces, see --trace help for available tracing options
- --control-socket <file>
- Hatari reads options from given socket at run-time
- --log-file <file>
- Save log output to <file> (default=stderr)
- --log-level <x>
- Log output level (x=debug/todo/info/warn/error/fatal)
- --alert-level <x>
- Show dialog for log messages above given level
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 (same as the reset button)
- AltGr + c
- cold reset the ST (same as the power switch)
- AltGr + d
- open dialog to select/change disk A
- 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 options 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. Otherwise pauses the emulation.
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.berlios.de/
FILES AND DIRECTORIES
- /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
- The global configuration file of Hatari.
- ~/.hatari/
- The (default) directory for user's personal Hatari files; hatari.cfg (configuration file), hatari.nvram (NVRAM content file), hatari.sav (Hatari memory state snapshot file which Hatari can load/save automatically when it starts/exits), hatari.prn (printer output file), hatari.wav (recorded sound output in WAV format), hatari.ym (recorded sound output in YM format).
- /usr/share/hatari/ (or /usr/local/share/hatari/)
- The global data directory of Hatari.
- 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 configuration file.
AUTHOR
This manual page was written by Marco Herrn <marco@mherrn.de> for the Debian project and later modified by Thomas Huth and Eero Tamminen to suit the latest version of Hatari.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre