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