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