![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to hatari.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [HATARI the Atari ST Emulator] / hatari / doc|
Return to hatari.1 CVS log | Up to [HATARI the Atari ST Emulator] / hatari / doc |
1.1 root 1: .\" Hey, EMACS: -*- nroff -*-
2: .\" First parameter, NAME, should be all caps
3: .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4: .\" other parameters are allowed: see man(7), man(1)
1.1.1.13 root 5: .TH "HATARI" "1" "2014-05-08" "Hatari" ""
1.1 root 6: .\" Please adjust this date whenever revising the manpage.
7:
8: .SH "NAME"
1.1.1.5 root 9: hatari \- Atari ST/STE/TT/Falcon emulator
1.1.1.14! root 10:
1.1 root 11: .SH "SYNOPSIS"
12: .B hatari
13: .RI [options]
1.1.1.9 root 14: .RI [directory|diskimage|program]
1.1.1.14! root 15:
1.1 root 16: .SH "DESCRIPTION"
1.1.1.5 root 17: Hatari is an Atari ST/STE/TT/Falcon emulator for Linux, FreeBSD, BeOS and
18: other Systems which are supported by the SDL library.
1.1 root 19: .PP
1.1.1.3 root 20: With hatari one can run games, demos or applications written for Atari
1.1.1.8 root 21: ST, STE or Falcon. Atari TT support is experimental. Hatari supports
1.1.1.5 root 22: the commonly used *.st and *.msa disk images and hard disk emulation.
1.1 root 23: .PP
1.1.1.3 root 24: To run the emulator a TOS ROM image is needed. EmuTOS, a free
25: implementation of TOS is shipped with hatari. Since it is not yet
1.1.1.9 root 26: fully compatible with the original TOS, some programs won't run
27: correctly with it. Because of this it is recommended to use a TOS
1.1.1.3 root 28: ROM from a real Atari.
1.1.1.9 root 29: .PP
30: As an argument one can give either a name of a directory that should
31: be emulated as a virtual GEMDOS hard disk, a floppy disk image or an
32: Atari program that should be autostarted. In the last case the
33: program's directory will be used as the C: drive from where this
34: program will be started.
35: .PP
36: Booting will be done from the disk image or directory that's given
37: last on the command line as an option or the argument (and which
1.1.1.13 root 38: corresponds to A: or C:). If you want to give floppy image name with
39: an autostarting program name, give it with --disk-a option before the
40: program name.
1.1.1.14! root 41:
1.1 root 42: .SH "OPTIONS"
1.1.1.4 root 43: Hatari options are split into several categories:
1.1.1.14! root 44:
1.1.1.4 root 45: .SH "General options"
1.1 root 46: .TP
47: .B \-h, \-\-help
1.1.1.4 root 48: Print command line options and terminate
1.1 root 49: .TP
50: .B \-v, \-\-version
1.1.1.4 root 51: Print version information and terminate
52: .TP
1.1.1.12 root 53: .B \-\-confirm\-quit <bool>
1.1.1.4 root 54: Whether Hatari confirms quitting
55: .TP
56: .B \-c, \-\-configfile <filename>
1.1.1.12 root 57: Read additional configuration values from <file>, these
58: override values read from the global and user configuration
59: files
1.1.1.9 root 60: .TP
61: .B \-k, \-\-keymap <file>
1.1.1.12 root 62: Load keyboard mapping from <file>
1.1.1.5 root 63: .TP
1.1.1.12 root 64: .B \-\-fast\-forward <bool>
1.1.1.5 root 65: On fast machine helps skipping (fast forwarding) Hatari output
1.1.1.14! root 66:
1.1.1.9 root 67: .SH "Common display options"
1.1 root 68: .TP
69: .B \-m, \-\-mono
1.1.1.4 root 70: Start in monochrome mode instead of color
71: .TP
72: .B \-\-monitor <x>
73: Select monitor type (x = mono/rgb/vga/tv)
1.1 root 74: .TP
75: .B \-f, \-\-fullscreen
1.1.1.4 root 76: Start the emulator in fullscreen mode
1.1.1.2 root 77: .TP
78: .B \-w, \-\-window
1.1.1.13 root 79: Start the emulator in windowed mode
1.1 root 80: .TP
1.1.1.7 root 81: .B \-\-grab
1.1.1.13 root 82: Grab mouse (also) in windowed mode
83: .TP
84: .B \-\-borders <bool>
85: Show ST/STE/Falcon screen borders (for low/med resolution overscan demos)
1.1.1.7 root 86: .TP
1.1.1.4 root 87: .B \-\-frameskips <x>
88: Skip <x> frames after each displayed frame to accelerate emulation
1.1.1.5 root 89: (0=disabled, >4 uses automatic frameskip with given value as maximum)
1.1.1.13 root 90: .TP
91: .B \-\-slowdown <x>
92: Slow down emulation by factor of x (used as multiplier for VBL wait time)
1.1.1.14! root 93: .TP
! 94: .B \-\-mousewarp <bool>
! 95: To keep host mouse better in sync with Atari mouse pointer, center it
! 96: to Hatari window on cold reset and resolution changes
! 97: .TP
1.1.1.5 root 98: .B \-\-statusbar <bool>
99: Show statusbar (with floppy leds etc etc)
100: .TP
1.1.1.12 root 101: .B \-\-drive\-led <bool>
1.1.1.5 root 102: Show overlay drive led when statusbar isn't shown
1.1.1.4 root 103: .TP
1.1.1.13 root 104: .B \-\-max\-width <x>
105: Preferred / maximum window width for borders / zooming
106: .TP
107: .B \-\-max\-height <x>
108: Preferred / maximum window height for borders / zooming
109: .TP
1.1.1.9 root 110: .B \-\-bpp <bool>
111: Force internal bitdepth (x = 8/15/16/32, 0=disable)
1.1.1.14! root 112:
1.1.1.9 root 113: .SH "ST/STE specific display options"
114: .TP
1.1.1.12 root 115: .B \-\-desktop\-st <bool>
1.1.1.10 root 116: Whether fullscreen mode uses desktop resolution to avoid: messing
117: multi-screen setups, several seconds delay needed by LCD monitors
118: resolution switching and the resulting sound break. As Hatari ST/E
119: display code doesn't support zooming (except low-rez doubling), it
120: doesn't get scaled (by Hatari or monitor) when this is enabled.
121: Therefore this is mainly useful only if you suffer from the described
122: effects, but still want to grab mouse and remove other distractions
123: from the screen just by toggling fullscreen mode. (disabled by default)
124: .TP
1.1.1.4 root 125: .B \-\-spec512 <x>
126: Hatari uses this threshold to decide when to render a screen with
127: the slower but more accurate Spectrum512 screen conversion functions
128: (0 <= x <= 512, 0=disable)
1.1.1.9 root 129: .TP
130: .B \-z, \-\-zoom <x>
131: Zoom (double) low resolution (1=no, 2=yes)
1.1.1.14! root 132:
1.1.1.13 root 133: .SH "TT/Falcon specific display options"
1.1.1.9 root 134: Zooming to sizes specified below is internally done using integer scaling
135: factors. This means that different Atari resolutions may show up with
136: different sizes, but they are never blurry.
137: .TP
138: .B \-\-desktop <bool>
139: Whether to use desktop resolution on fullscreen to avoid issues
140: related to resolution switching. Otherwise fullscreen will use
1.1.1.10 root 141: a resolution that is closest to the Hatari window size.
142: (enabled by default)
1.1.1.4 root 143: .TP
1.1.1.12 root 144: .B \-\-force\-max <bool>
1.1.1.10 root 145: Hatari window size is forced to specified maximum size and black borders
146: used when Atari resolution doesn't scale evenly to it. This is most
147: useful when recording videos of Falcon demos that change their
148: resolution. (disabled by default)
149: .TP
1.1.1.9 root 150: .B \-\-aspect <bool>
151: Whether to do monitor aspect ratio correction (enabled by default)
1.1.1.14! root 152:
1.1.1.4 root 153: .SH "VDI options"
1.1.1.10 root 154: .TP
1.1.1.5 root 155: .B \-\-vdi <bool>
1.1.1.14! root 156: Whether to use VDI screen mode. Doesn't work with TOS v4.
! 157: TOS v3 memory detection isn't compatible with larger VDI modes
! 158: (i.e. you need to skip the detection at boot)
1.1.1.10 root 159: .TP
1.1.1.4 root 160: .B \-\-vdi\-planes <x>
161: Use extended VDI resolution with bit depth <x> (x = 1, 2 or 4)
1.1.1.10 root 162: .TP
1.1.1.4 root 163: .B \-\-vdi\-width <w>
1.1.1.8 root 164: Use extended VDI resolution with width <w> (320 < w <= 1280)
1.1.1.10 root 165: .TP
1.1.1.4 root 166: .B \-\-vdi\-height <h>
1.1.1.8 root 167: Use extended VDI resolution with height <h> (200 < h <= 960)
1.1.1.14! root 168:
1.1.1.9 root 169: .SH "Screen capture options"
170: .TP
171: .B \-\-crop <bool>
172: Remove statusbar from the screen captures
1.1.1.8 root 173: .TP
174: .B \-\-avirecord
1.1.1.14! root 175: Start AVI recording. Note: recording will automatically
! 176: stop when emulation resolution changes.
1.1.1.8 root 177: .TP
1.1.1.12 root 178: .B \-\-avi\-vcodec <x>
1.1.1.14! root 179: Select AVI video codec (x = bmp/png). PNG compression can
! 180: be \fImuch\fP slower than using the uncompressed BMP format,
! 181: but uncompressed video content takes huge amount of space.
! 182: .TP
! 183: .B \-\-png\-level <x>
! 184: Select PNG compression level for AVI video (x = 0-9).
! 185: Both compression efficiency and speed depend on the compressed
! 186: screen content. Highest compression level (9) can be \fIreally\fP
! 187: slow with some content. Levels 3-6 should compress nearly as well
! 188: with clearly smaller CPU overhead.
1.1.1.8 root 189: .TP
1.1.1.12 root 190: .B \-\-avi\-fps <x>
1.1.1.14! root 191: Force AVI frame rate (x = 50/60/71/...)
1.1.1.8 root 192: .TP
1.1.1.12 root 193: .B \-\-avi\-file <file>
1.1.1.14! root 194: Use <file> to record AVI
! 195:
1.1.1.4 root 196: .SH "Devices options"
1.1 root 197: .TP
1.1.1.4 root 198: .B \-j, \-\-joystick <port>
199: Emulate joystick with cursor keys in given port (0-5)
1.1 root 200: .TP
1.1.1.5 root 201: .B \-\-joy<port> <type>
202: Set joystick type (none/keys/real) for given port
203: .TP
1.1.1.4 root 204: .B \-\-printer <file>
205: Enable printer support and write data to <file>
1.1.1.2 root 206: .TP
1.1.1.12 root 207: .B \-\-midi\-in <filename>
1.1.1.6 root 208: Enable MIDI support and write MIDI data to <file>
1.1 root 209: .TP
1.1.1.12 root 210: .B \-\-midi\-out <filename>
1.1.1.6 root 211: Enable MIDI support and read MIDI data from <file>
212: .TP
1.1.1.12 root 213: .B \-\-rs232\-in <filename>
1.1.1.6 root 214: Enable serial port support and use <file> as the input device
215: .TP
1.1.1.12 root 216: .B \-\-rs232\-out <filename>
1.1.1.6 root 217: Enable serial port support and use <file> as the output device
1.1.1.14! root 218:
! 219: .SH "Floppy drive options"
1.1.1.5 root 220: .TP
1.1.1.13 root 221: .B \-\-drive\-a <bool>
222: Enable/disable drive A (default is on)
223: .TP
224: .B \-\-drive\-b <bool>
225: Enable/disable drive B (default is on)
226: .TP
227: .B \-\-drive\-a\-heads <x>
228: Set number of heads for drive A (1=single sided, 2=double sided)
229: .TP
230: .B \-\-drive\-b\-heads <x>
231: Set number of heads for drive B (1=single sided, 2=double sided)
232: .TP
1.1.1.12 root 233: .B \-\-disk\-a <file>
1.1.1.5 root 234: Set disk image for floppy drive A
235: .TP
1.1.1.12 root 236: .B \-\-disk\-b <file>
1.1.1.5 root 237: Set disk image for floppy drive B
1.1.1.14! root 238: .TP
! 239: .B \-\-fastfdc <bool>
! 240: speed up FDC emulation (can cause incompatibilities)
1.1.1.8 root 241: .TP
1.1.1.12 root 242: .B \-\-protect\-floppy <x>
1.1.1.8 root 243: Write protect floppy image contents (on/off/auto). With "auto" option
1.1.1.13 root 244: write protection is according to the disk image file attributes
1.1.1.14! root 245:
! 246: .SH "Hard drive options"
! 247: .TP
! 248: .B \-d, \-\-harddrive <dir>
! 249: Emulate harddrive partition(s) with <dir> contents. If directory
! 250: contains only single letter (C-Z) subdirectories, each of these
! 251: subdirectories will be treated as a separate partition, otherwise the
! 252: given directory itself will be assigned to drive "C:". In the multiple
! 253: partition case, the letters used as the subdirectory names will
! 254: determine to which drives/partitions they're assigned. If <dir> is
! 255: an empty string, then harddrive's emulation is disabled
1.1.1.8 root 256: .TP
1.1.1.12 root 257: .B \-\-protect\-hd <x>
1.1.1.8 root 258: Write protect harddrive <dir> contents (on/off/auto). With "auto" option
259: the protection can be controlled by setting individual files attributes
260: as it disables the file attribute modifications for the GEMDOS hard disk
1.1.1.13 root 261: emulation
1.1.1.12 root 262: .TP
263: .B \-\-gemdos\-case <x>
264: Specify whether new dir/filenames are forced to be in upper or lower case
1.1.1.13 root 265: with the GEMDOS HD emulation. Off/upper/lower, off by default
1.1.1.10 root 266: .TP
1.1.1.14! root 267: .B \-\-gemdos\-conv <bool>
! 268: Whether GEMDOS file names with 8-bit (non-ASCII) characters are
! 269: converted between Atari and host character sets. On Linux, host file
! 270: name character set is assumed to be UTF-8. This option is disabled by
! 271: default, in case you've transferred files from Atari machine without
! 272: proper file name conversion (e.g. by zipping them on Atari and
! 273: unzipping on PC).
! 274: .TP
! 275: .B \-\-acsi <id>=<file>
! 276: Emulate an ACSI hard disk with given BUS ID (0-7) using image <file>.
! 277: If just filename is given, it's assigned to BUS ID 0.
1.1.1.5 root 278: .TP
1.1.1.8 root 279: .B \-\-ide\-master <file>
280: Emulate an IDE master hard disk with an image <file>
281: .TP
282: .B \-\-ide\-slave <file>
283: Emulate an IDE slave hard disk with an image <file>
1.1.1.14! root 284:
1.1.1.4 root 285: .SH "Memory options"
1.1 root 286: .TP
1.1.1.10 root 287: .B \-\-memstate <file>
288: Load memory snap-shot <file>
289: .TP
1.1.1.4 root 290: .B \-s, \-\-memsize <x>
1.1.1.14! root 291: Set amount of emulated ST RAM, x = 1 to 14 MiB, or 0 for 512 KiB
! 292: .TP
! 293: .B \-s, \-\-ttram <x>
! 294: Set amount of emulated TT RAM, x = 0 to 256 MiB (in 4MB steps)
! 295:
1.1.1.10 root 296: .SH "ROM options"
1.1 root 297: .TP
1.1.1.4 root 298: .B \-t, \-\-tos <imagefile>
299: Specify TOS ROM image to use
1.1 root 300: .TP
1.1.1.12 root 301: .B \-\-patch\-tos <bool>
1.1.1.10 root 302: Use this option to enable/disable TOS ROM patching. Experts only! Leave
303: this enabled unless you know what you are doing!
304: .TP
1.1.1.4 root 305: .B \-\-cartridge <imagefile>
306: Use ROM cartridge image <file> (only works if GEMDOS HD emulation and
307: extended VDI resolution are disabled)
1.1.1.14! root 308:
1.1.1.4 root 309: .SH "CPU options"
310: .TP
311: .B \-\-cpulevel <x>
312: Specify CPU (680x0) to use (use x >= 1 with EmuTOS or TOS >= 2.06 only!)
313: .TP
314: .B \-\-cpuclock <x>
315: Set the CPU clock (8, 16 or 32 Mhz)
316: .TP
317: .B \-\-compatible <bool>
1.1.1.9 root 318: Use a more compatible, but slower 68000 CPU mode with
319: better prefetch accuracy and cycle counting
1.1.1.14! root 320:
1.1.1.4 root 321: .SH "Misc system options"
1.1.1.3 root 322: .TP
323: .B \-\-machine <x>
1.1.1.9 root 324: Select machine type (x = st, ste, tt or falcon)
1.1.1.4 root 325: .TP
326: .B \-\-blitter <bool>
1.1.1.5 root 327: Enable blitter emulation (ST only)
1.1.1.4 root 328: .TP
329: .B \-\-dsp <x>
1.1.1.5 root 330: Falcon DSP emulation (x = none, dummy or emu, Falcon only)
1.1.1.4 root 331: .TP
1.1.1.12 root 332: .B \-\-timer\-d <bool>
1.1.1.10 root 333: Patch redundantly high Timer-D frequency set by TOS. This about doubles
334: Hatari speed (for ST/e emulation) as the original Timer-D frequency causes
335: most of the interrupts.
336: .TP
1.1.1.12 root 337: .B \-\-fast\-boot <bool>
1.1.1.10 root 338: Patch TOS and initialize the so-called "memvalid" system variables to by-pass
339: the memory test of TOS, so that the system boots faster.
340: .TP
341: .B \-\-rtc <bool>
342: Enable real-time clock
1.1.1.14! root 343:
1.1.1.10 root 344: .SH "Sound options"
345: .TP
1.1.1.9 root 346: .B \-\-mic <bool>
347: Enable/disable (Falcon only) microphone
348: .TP
1.1.1.4 root 349: .B \-\-sound <x>
1.1.1.7 root 350: Sound frequency: 6000-50066. "off" disables the sound and speeds up
351: the emulation. To prevent extra sound artifacts, the frequency should be
352: selected so that it either matches evenly with the STE/TT/Falcon sound
353: DMA (6258, 12517, 250033, 50066 Hz) or your sound card frequencies
354: (11025, 22050, 44100 or 6000...48000 Hz). Check what your sound card
355: supports.
1.1.1.8 root 356: .TP
1.1.1.12 root 357: .B \-\-sound\-buffer\-size <x>
1.1.1.9 root 358: SDL's sound buffer size: 10-100, or 0 to use default buffer size.
1.1.1.8 root 359: By default Hatari uses an SDL buffer size of 1024 samples, which
360: gives approximatively 20-30 ms of sound depending on the chosen sound
361: frequency. Under some OS or with not fully supported sound card, this
362: default setting can cause a bigger delay at lower frequency (nearly 0.5 sec).
363: In that case, you can use this option to force the size of the sound
364: buffer to a fixed number of milliseconds of sound (using 20 is often
365: a good choice if you have such problems). Most users will not need this option.
1.1.1.9 root 366: .TP
1.1.1.12 root 367: .B \-\-sound\-sync <bool>
368: The emulation rate is nudged by +100 or 0 or \-100 micro-seconds on occasion.
1.1.1.11 root 369: This prevents the sound buffer from overflowing (long latency and
370: lost samples) or underflowing (short latency and repeated samples).
371: The emulation rate smoothly deviates by a maximum of 0.58% until
372: synchronized, while the emulator continuously generates every sound
373: sample and the crystal controlled sound system consumes every sample.
374: .br
375: (on|off, off=default)
376: .TP
1.1.1.12 root 377: .B \-\-ym\-mixing <x>
1.1.1.9 root 378: Select a method for mixing the three YM2149 voice volumes together.
1.1.1.10 root 379: "model" uses a mathematical model of the YM voices,
1.1.1.9 root 380: "table" uses a lookup table of audio output voltage values measured
381: on STF and "linear" just averages the 3 YM voices.
1.1.1.14! root 382:
1.1.1.4 root 383: .SH "Debug options"
1.1.1.14! root 384: .TP
! 385: .B \-W, \-\-wincon
! 386: Open console window (Windows only)
1.1.1.4 root 387: .TP
1.1.1.7 root 388: .B \-D, \-\-debug
389: Toggle whether CPU exceptions invoke the debugger
1.1.1.5 root 390: .TP
1.1.1.13 root 391: .B \-\-debug\-except <flags>
392: Specify which exceptions invoke debugger, see
393: .B \-\-debug\-except help
394: for available (comma separated) exception flags.
1.1.1.12 root 395: .TP
1.1.1.13 root 396: .B \-\-bios\-intercept
397: Toggle XBios command parsing. Allows Atari programs to use all Hatari
398: functionality and change Hatari state through Hatari specifit
399: XBios(255) calls. XBios(20) printscreen calls produce also Hatari
400: screenshots.
401: .TP
1.1.1.12 root 402: .B \-\-conout <device>
403: Enable console (xconout vector functions) output redirection for given
404: <device> to host terminal. Device 2 is for the (CON:) VT52 console,
405: which vector function catches also EmuTOS panic messages and MiNT
406: console output, not just normal BIOS console output.
407: .TP
408: .B \-\-disasm <x>
409: Set disassembly options. 'uae' and 'ext' select the dissasembly engine
410: to use, bitmask sets output options for the external disassembly engine
411: and 'help' lists them.
412: .TP
413: .B \-\-natfeats <bool>
414: Enable/disable (basic) Native Features support.
415: E.g. EmuTOS uses it for debug output.
1.1.1.4 root 416: .TP
1.1.1.13 root 417: .B \-\-trace <flags>
1.1.1.5 root 418: Activate debug traces, see
419: .B \-\-trace help
1.1.1.13 root 420: for available (comma separated) tracing flags
1.1.1.5 root 421: .TP
1.1.1.12 root 422: .B \-\-trace\-file <file>
1.1.1.8 root 423: Save trace output to <file> (default=stderr)
424: .TP
425: .B \-\-parse <file>
426: Parse/execute debugger commands from <file>
427: .TP
428: .B \-\-saveconfig
429: Save Hatari configuration and exit. Hatari UI needs Hatari configuration
430: file to start, this can be used to create it automatically.
431: .TP
1.1.1.12 root 432: .B \-\-no\-parachute
1.1.1.8 root 433: Disable SDL parachute to get Hatari core dumps. SDL parachute is enabled
434: by default to restore video mode in case Hatari terminates abnormally
435: while using non-standard screen resolution.
436: .TP
1.1.1.12 root 437: .B \-\-control\-socket <file>
1.1.1.5 root 438: Hatari reads options from given socket at run-time
439: .TP
1.1.1.12 root 440: .B \-\-log\-file <file>
1.1.1.5 root 441: Save log output to <file> (default=stderr)
442: .TP
1.1.1.12 root 443: .B \-\-log\-level <x>
1.1.1.5 root 444: Log output level (x=debug/todo/info/warn/error/fatal)
445: .TP
1.1.1.12 root 446: .B \-\-alert\-level <x>
1.1.1.5 root 447: Show dialog for log messages above given level
1.1.1.7 root 448: .TP
1.1.1.12 root 449: .B \-\-run\-vbls <x>
1.1.1.7 root 450: Exit after X VBLs
1.1.1.14! root 451:
! 452: .SH "INPUT HANDLING"
! 453: Hatari provides special input handling for different purposes.
! 454:
! 455: .SH "Emulated Atari ST joystick"
! 456: Joystick can be emulated either with keyboard or any real joystick
! 457: supported by your kernel / SDL library. First joystick button
! 458: acts as FIRE, second as SPACE key.
! 459:
! 460: .SH "Emulated Atari ST mouse"
! 461: Middle button mouse click is interpreted as double click, this
! 462: is especially useful in Fast Forward mode.
! 463: .PP
! 464: Mouse scrollwheel will act as cursor up and down keys.
! 465:
! 466: .SH "Emulated Atari ST keyboard"
! 467: Keys on the keyboard act as the normal Atari ST keys so pressing SPACE
! 468: on your PC will result in an emulated press of the SPACE key on the
! 469: ST. How the PC keys are mapped to Atari key codes, can be changed
! 470: with keyboard config file (-k option).
! 471: .PP
! 472: The following keys have special meanings:
! 473: .TP
! 474: .B Alt
! 475: will act as the ST's ALTERNATE key
! 476: .TP
! 477: .B left Ctrl
! 478: will act as the ST's CONTROL key
! 479: .TP
! 480: .B Page Up
! 481: will emulate the ST's HELP key
! 482: .TP
! 483: .B Page Down
! 484: will emulate the ST's UNDO key
! 485: .PP
! 486: .B AltGr
! 487: will act as
! 488: .B Alternate
! 489: as well as long as you do not press it together with a Hatari hotkey
! 490: combination.
! 491: .PP
! 492: The
! 493: .B right Ctrl
! 494: key is used as the fire button of the emulated joystick when you turn
! 495: on joystick emulation via keyboard.
! 496: .PP
! 497: The cursor keys will act as the cursor keys on the Atari ST as long as
! 498: joystick emulation via keyboard has been turned off.
! 499:
! 500: .SH "Keyboard shortcuts during emulation"
1.1.1.3 root 501: The shortcut keys can be configured in the configuration file.
502: The default settings are:
1.1 root 503: .TP
504: .B AltGr + a
505: record animation
506: .TP
507: .B AltGr + g
508: grab a screenshot
509: .TP
510: .B AltGr + i
511: boss key: leave full screen mode and iconify window
512: .TP
513: .B AltGr + m
514: (un-)lock the mouse into the window
515: .TP
516: .B AltGr + r
1.1.1.5 root 517: warm reset the ST (same as the reset button)
1.1 root 518: .TP
519: .B AltGr + c
1.1.1.5 root 520: cold reset the ST (same as the power switch)
521: .TP
522: .B AltGr + d
523: open dialog to select/change disk A
1.1 root 524: .TP
525: .B AltGr + s
526: enable/disable sound
527: .TP
528: .B AltGr + q
529: quit the emulator
530: .TP
531: .B AltGr + x
532: toggle normal/max speed
533: .TP
534: .B AltGr + y
535: enable/disable sound recording
536: .TP
1.1.1.4 root 537: .B AltGr + k
538: save memory snapshot
539: .TP
540: .B AltGr + l
541: load memory snapshot
542: .TP
1.1.1.14! root 543: .B AltGr + j
! 544: toggle joystick emulation via cursor keys
! 545: .TP
! 546: .B AltGr + F1
! 547: switch joystick type on joy port 0
! 548: .TP
! 549: .B AltGr + F2
! 550: switch joystick type on joy port 1
! 551: .TP
! 552: .B AltGr + F3
! 553: switch joystick type for joypad A
! 554: .TP
! 555: .B AltGr + F4
! 556: switch joystick type for joypad B
! 557: .TP
1.1 root 558: .B F11
559: toggle between fullscreen and windowed mode
560: .TP
561: .B F12
1.1.1.5 root 562: activate the hatari options GUI
1.1 root 563: .br
564: You may need to hold SHIFT down while in windowed mode.
565: .TP
566: .B Pause
1.1.1.7 root 567: Pauses the emulation
568: .TP
569: .B AltGr + Pause
570: Invokes the internal Hatari debugger
1.1 root 571:
1.1.1.14! root 572: .SH "Keyboard shortcuts for the SDL GUI"
! 573: There are multiple ways to interact with the SDL GUI.
! 574: .PP
! 575: TAB and cursor keys change focus between UI elements. Additionally
! 576: Home key moves focus to first item, End key to last one. Initially
! 577: focus is on default UI element, but focus changes are remembered
! 578: between dialog invocations. Enter and Space invoke focused item. UI
! 579: elements with underlined characters can be invoked directly with Alt +
! 580: key with that character. Alt + arrow keys will act on arrow buttons.
! 581: .PP
! 582: Most importantly:
1.1 root 583: .TP
1.1.1.14! root 584: .B Options GUI main view
! 585: Enter accepts configuration, ESC cancels it.
1.1 root 586: .TP
1.1.1.14! root 587: .B Options GUI dialogs
! 588: Enter (or End+Enter if focus was moved) returns back to main view.
1.1 root 589: .TP
1.1.1.14! root 590: .B Fileselector
! 591: Page up and down keys scroll the file list. Enter on focused file
! 592: name selects it. Enter on OK button accepts the selected file. ESC
! 593: cancels the dialog/selection.
1.1 root 594: .TP
1.1.1.14! root 595: .B Alert dialogs
! 596: Enter accepts and ESC cancels the dialog.
1.1 root 597:
598: .SH "SEE ALSO"
599: The main program documentation, usually in /usr/share/doc/.
1.1.1.9 root 600: Among other things it contains an extensive usage manual,
1.1.1.14! root 601: software compatibility list and release notes.
1.1 root 602: .PP
1.1.1.10 root 603: The homepage of hatari: http://hatari.tuxfamily.org/
1.1.1.9 root 604: .PP
605: Other Hatari programs and utilities:
606: .br
607: .IR hmsa (1),
608: .IR zip2st (1),
1.1.1.14! root 609: .IR atari\-convert\-dir (1),
! 610: .IR atari\-hd\-image (1),
1.1.1.9 root 611: .IR hatariui (1),
1.1.1.13 root 612: .IR hconsole (1),
613: .IR gst2ascii (1),
614: .IR hatari_profile (1)
1.1.1.14! root 615:
1.1.1.5 root 616: .SH "FILES AND DIRECTORIES"
1.1.1.3 root 617: .TP
618: /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
1.1.1.5 root 619: The global configuration file of Hatari.
620: .TP
621: ~/.hatari/
622: The (default) directory for user's personal Hatari files;
623: .B hatari.cfg
624: (configuration file),
625: .B hatari.nvram
626: (NVRAM content file),
627: .B hatari.sav
628: (Hatari memory state snapshot file which Hatari can load/save automatically
629: when it starts/exits),
630: .B hatari.prn
631: (printer output file),
632: .B hatari.wav
633: (recorded sound output in WAV format),
634: .B hatari.ym
635: (recorded sound output in YM format).
1.1.1.3 root 636: .TP
1.1.1.5 root 637: /usr/share/hatari/ (or /usr/local/share/hatari/)
638: The global data directory of Hatari.
1.1.1.3 root 639: .TP
640: tos.img
641: The TOS ROM image will be loaded from the data directory of Hatari unless it
642: is specified on the command line or the configuration file.
643:
1.1 root 644: .SH "AUTHOR"
1.1.1.5 root 645: This manual page was written by Marco Herrn <[email protected]> for the
646: Debian project and later modified by Thomas Huth and Eero Tamminen to
647: suit the latest version of Hatari.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.