![[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.3 ! root 5: .TH "HATARI" "1" "2006-08-22" "Hatari" ""
1.1 root 6: .\" Please adjust this date whenever revising the manpage.
7:
8: .SH "NAME"
1.1.1.3 ! root 9: hatari \- Atari ST(e) emulator
1.1 root 10: .SH "SYNOPSIS"
11: .B hatari
12: .RI [options]
13: .RI [diskimage]
14: .SH "DESCRIPTION"
1.1.1.3 ! root 15: Hatari is an Atari ST(e) emulator for Linux, FreeBSD, BeOS and other
! 16: Systems which are supported by the SDL library.
1.1 root 17: .PP
1.1.1.3 ! root 18: With hatari one can run games, demos or applications written for Atari
! 19: ST or Atari STE. It supports the commonly used *.st and *.msa disk
! 20: images and hard disk emulation.
1.1 root 21: .PP
1.1.1.3 ! root 22: To run the emulator a TOS ROM image is needed. EmuTOS, a free
! 23: implementation of TOS is shipped with hatari. Since it is not yet
! 24: fully compatible with the original TOS some programs won't run
! 25: correctly with this. Because of this it is recommended to use a TOS
! 26: ROM from a real Atari.
1.1 root 27: .SH "OPTIONS"
28: .TP
29: .B \-h, \-\-help
1.1.1.2 root 30: print command line options and terminate
1.1 root 31: .TP
32: .B \-v, \-\-version
1.1.1.2 root 33: print version information and terminate
1.1 root 34: .TP
35: .B \-m, \-\-mono
1.1.1.2 root 36: start the emulated Atari ST in monochrome resolution
1.1 root 37: .TP
38: .B \-f, \-\-fullscreen
1.1.1.2 root 39: start the emulator in fullscreen mode
40: .TP
41: .B \-w, \-\-window
42: start the emulator in window mode
1.1 root 43: .TP
1.1.1.3 ! root 44: .B \-j, \-\-joystick <port>
! 45: emulate ST joystick in <port> 0 or 1 with keyboard
1.1 root 46: .TP
47: .B \-\-nosound
1.1.1.2 root 48: disable sound (makes emulation faster)
1.1 root 49: .TP
50: .B \-\-frameskip
1.1.1.2 root 51: drop every second frame (accelerates emulation)
1.1 root 52: .TP
53: .B \-D, \-\-debug
1.1.1.2 root 54: activate the simple builtin debugger
1.1 root 55: .TP
56: .B \-\-slowfdc
1.1.1.2 root 57: slow down FDC emulation (needed to make some games and demos work)
1.1 root 58: .TP
59: .B \-d, \-\-harddrive <dir>
1.1.1.2 root 60: use <dir> as an emulated hard disk
1.1 root 61: .TP
62: .B \-\-hdimage <imagefile>
63: emulate hard disk with an image file
64: .TP
65: .B \-\-tos <imagefile>
66: specify TOS ROM image to use
67: .TP
1.1.1.2 root 68: .B \-\-cartridge <imagefile>
1.1.1.3 ! root 69: use ROM cartridge image <file> (only works if GEMDOS HD emulation and
! 70: extended VDI resolution are disabled)
1.1.1.2 root 71: .TP
1.1.1.3 ! root 72: .B \-s, \-\-memsize x
1.1 root 73: set amount of emulated RAM
74: .br
1.1.1.3 ! root 75: x=0 for 512K, and x=1, x=2 or x=4 for 1, 2 or 4 MB
1.1 root 76: .TP
1.1.1.3 ! root 77: .B \-\-cpulevel x
1.1 root 78: specify CPU (680x0) to use (TOS 2.06 only!!)
79: .TP
1.1.1.3 ! root 80: .B \-\-compatible
1.1 root 81: use a more compatible but slower 68000 CPU mode
82: .TP
1.1.1.3 ! root 83: .B \-\-blitter
1.1 root 84: enable blitter emulation
85: .TP
1.1.1.3 ! root 86: .B \-\-vdi
1.1 root 87: use extended VDI resolution
88: .TP
1.1.1.3 ! root 89: .B \-\-printer
1.1 root 90: enable experimental printer support
91: .TP
1.1.1.3 ! root 92: .B \-\-midi <filename>
1.1 root 93: enable experimental MIDI output to the mentioned file
94: .TP
1.1.1.3 ! root 95: .B \-\-rs232 <filename>
1.1 root 96: enable experimental RS232 emulation via the mentioned file/device
97: .TP
98: .B \-c, \-\-configfile <filename>
1.1.1.2 root 99: use the mentioned file as configuration file instead of ~/.hatari.cfg
1.1.1.3 ! root 100: .TP
! 101: .B \-\-machine <x>
! 102: select machine type (x = st or ste)
! 103: .TP
! 104: .B \-\-keymap <file>
! 105: load keyboard mapping from <file>
1.1 root 106:
107: .SH "COMMANDS"
1.1.1.3 ! root 108: The shortcut keys can be configured in the configuration file.
! 109: The default settings are:
1.1 root 110: .TP
111: .B AltGr + a
112: record animation
113: .TP
114: .B AltGr + g
115: grab a screenshot
116: .TP
117: .B AltGr + i
118: boss key: leave full screen mode and iconify window
119: .TP
120: .B AltGr + j
121: activate joystick emulation via cursor keys
122: .TP
123: .B AltGr + m
124: (un-)lock the mouse into the window
125: .TP
126: .B AltGr + r
127: (warm) reset the ST
128: .TP
129: .B AltGr + c
130: coldreset the ST (same as the original power switch)
131: .TP
132: .B AltGr + s
133: enable/disable sound
134: .TP
135: .B AltGr + q
136: quit the emulator
137: .TP
138: .B AltGr + x
139: toggle normal/max speed
140: .TP
141: .B AltGr + y
142: enable/disable sound recording
143: .TP
144: .B F11
145: toggle between fullscreen and windowed mode
146: .TP
147: .B F12
148: activate the hatari command GUI
149: .br
150: You may need to hold SHIFT down while in windowed mode.
151: .TP
152: .B Pause
1.1.1.2 root 153: will go to the debugger if it was activated with the -\-debug option
1.1 root 154:
155: .SH Emulated Atari ST keyboard
1.1.1.3 ! root 156: All other keys on the keyboard act as the normal Atari ST keys so
! 157: pressing SPACE on your PC will result in an emulated press of the
! 158: SPACE key on the ST. The following keys have special meanings:
1.1 root 159: .TP
160: .B Alt
161: will act as the ST's ALTERNATE key
162: .TP
163: .B left Ctrl
164: will act as the ST's CONTROL key
165: .TP
166: .B Page Up
167: will emulate the ST's HELP key
168: .TP
169: .B Page Down
170: will emulate the ST's UNDO key
171: .PP
172: .B AltGr
173: will act as
174: .B Alternate
1.1.1.3 ! root 175: as well as long as you do not press it together with a Hatari hotkey
! 176: combination.
1.1 root 177:
178: The
179: .B right Ctrl
1.1.1.3 ! root 180: key is used as the fire button of the emulated joystick when you turn
! 181: on joystick emulation via keyboard.
1.1 root 182:
1.1.1.3 ! root 183: The cursor keys will act as the cursor keys on the Atari ST as long as
! 184: joystick emulation via keyboard has been turned off.
1.1 root 185:
186: .SH "SEE ALSO"
187: The main program documentation, usually in /usr/share/doc/.
188: .PP
189: The homepage of hatari: http://hatari.sourceforge.net
190:
1.1.1.3 ! root 191: .SH "FILES"
! 192: .TP
! 193: /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
! 194: the global configuration file of Hatari
! 195: .TP
! 196: ~/.hatari.cfg
! 197: the user's personal Hatari configuration file
! 198: .TP
! 199: tos.img
! 200: The TOS ROM image will be loaded from the data directory of Hatari unless it
! 201: is specified on the command line or the configuration file.
! 202:
1.1 root 203: .SH "AUTHOR"
1.1.1.3 ! root 204: This manual page was written by Marco Herrn <[email protected]>, for the
! 205: Debian project and later modified by Thomas Huth to suit the latest
1.1 root 206: version of Hatari.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.