![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to hatariui.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 / python-ui|
Return to hatariui.1 CVS log | Up to [HATARI the Atari ST Emulator] / hatari / python-ui |
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.5 ! root 5: .TH "hatariui" "1" "2019-01-09" "Hatari" "Hatari UI"
1.1 root 6: .SH "NAME"
7: hatariui \- Python/Gtk UI for Hatari
8: .SH "SYNOPSIS"
9: .B hatariui | hatariui.py
10: .RI [options]
1.1.1.2 root 11: .RI [directory|diskimage|program]
1.1 root 12: .SH "DESCRIPTION"
13: .I hatariui
14: is a Python/Gtk UI for Hatari which can either embed the Hatari window
15: (on X11 systems) or run in a separate window. By default it provides
16: a normal application menu and some extra button for faster access to
1.1.1.2 root 17: fast\-forward etc. functionality, but these are fully configurable
1.1 root 18: with the command line options. While it lacks support for some of
19: the Hatari configuration options that Hatari's SDL GUI has, it also
1.1.1.2 root 20: supports some options that the Hatari's built\-in SDL UI doesn't.
1.1 root 21: .PP
1.1.1.2 root 22: Besides the UI configurability, some of the other advantages hatariui has
1.1 root 23: over the SDL interface included with Hatari itself are use of a normal
24: Gtk file selector with all of its features (directory shortcuts etc),
1.1.1.2 root 25: support for UTF\-8 (in file names) and in general blending better to
1.1 root 26: the user's desktop environment.
27: .PP
28: Additionally, Hatari can run while one uses UI configuration dialogs,
29: and it can stop Hatari completely to better save the battery on mobile
30: computers. For devices without a keyboard, it offers a a text input
31: dialog and one can configure (from command line) buttons for often used
32: strings.
33: .SH "HATARIUI / HATARIUI.PY"
34: .I hatariui
1.1.1.5 ! root 35: is a shell script wrapper for the hatariui.py Python script.
1.1 root 36: It's used to run the Python script with suitable options for default
1.1.1.5 ! root 37: usage, and to set up the correct installation directory for rest
1.1 root 38: of the Hatari UI Python scripts and data files.
39: .PP
1.1.1.5 ! root 40: Options below are actually for the hatariui.py script. If you want
! 41: to change options given for it, modify the hatariui shell script or
1.1 root 42: make your own based on the installed one.
43: .\" following command line helps in updating the options:
1.1.1.2 root 44: .\" hatariui.py --help|sed -e 's/^\t\+/.TP\n.B /' -e 's/\t\+/\n/g' -e 's/-/\\-/g' >> hatariui.1
1.1 root 45: .SH "OPTIONS"
46: .TP
1.1.1.2 root 47: .B \-h, \-\-help
1.1 root 48: Hatari UI command line help
49: .TP
1.1.1.2 root 50: .B \-n, \-\-nomenu
1.1 root 51: Omit menubar from the window
52: .TP
1.1.1.2 root 53: .B \-e, \-\-embed
1.1 root 54: Embed Hatari window (to middle of controls)
55: .TP
1.1.1.2 root 56: .B \-f, \-\-fullscreen
1.1 root 57: Start in fullscreen
58: .TP
1.1.1.2 root 59: .B \-l, \-\-left <controls>
1.1 root 60: Add a toolbar at left
61: .TP
1.1.1.2 root 62: .B \-r, \-\-right <controls>
1.1 root 63: Add a toolbar at right
64: .TP
1.1.1.2 root 65: .B \-t, \-\-top <controls>
1.1 root 66: Add a toolbar at top
67: .TP
1.1.1.2 root 68: .B \-b, \-\-bottom <controls>
1.1 root 69: Add a toolbar at bottom
70: .TP
1.1.1.2 root 71: .B \-p, \-\-panel <name>,<controls>
1.1 root 72: Add a separate window with given name and controls
73: .PP
74: You can have only one toolbar on each side of the Hatari window.
1.1.1.5 ! root 75: Panels are separate windows and you can have as many of them as you wish.
! 76: For each of the panels, you need to add a button with the name of
! 77: the panel (see "MyPanel" in the Examples section).
1.1 root 78: .PP
1.1.1.5 ! root 79: Following buttons can be added to toolbars and panels:
1.1 root 80: .TP
81: .B |
1.1.1.5 ! root 82: Separator between action buttons
1.1 root 83: .TP
84: .B >
1.1.1.4 root 85: Start next toolbar row in panel windows
1.1 root 86: .TP
87: .B compatibility
88: Hatari compatibility list
89: .TP
90: .B harddisk
1.1.1.5 ! root 91: Hard disk config dialog
1.1 root 92: .TP
93: .B reset
94: Warm or cold reset Hatari
95: .TP
96: .B sconfig
97: Save configuration
98: .TP
99: .B bugs
100: Report a bug
101: .TP
102: .B display
1.1.1.5 ! root 103: Display settings dialog
1.1 root 104: .TP
105: .B authors
106: Hatari authors
107: .TP
108: .B forward
1.1.1.5 ! root 109: Toggle Hatari fast-forward
1.1 root 110: .TP
111: .B debug
112: Activate Hatari debugger
113: .TP
114: .B quit
115: Quit Hatari UI
116: .TP
117: .B hatari
118: Hatari home page
119: .TP
120: .B recanim
121: Record animation
122: .TP
123: .B recsound
124: Record YM/Wav
125: .TP
126: .B mails
127: Hatari mailing lists
128: .TP
129: .B floppy
1.1.1.5 ! root 130: Floppy image dialog
1.1 root 131: .TP
132: .B device
1.1.1.5 ! root 133: Midi / Printer / RS232 enabling dialog
1.1 root 134: .TP
135: .B load
136: Load emulation snapshot
137: .TP
138: .B lconfig
139: Load configuration
140: .TP
141: .B path
1.1.1.5 ! root 142: Path config dialog
1.1 root 143: .TP
144: .B machine
1.1.1.5 ! root 145: Hatari machine config dialog
1.1 root 146: .TP
147: .B todo
148: Hatari TODO
149: .TP
150: .B hatariui
151: Hatari UI home page
152: .TP
153: .B save
154: Save emulation snapshot
155: .TP
156: .B joystick
1.1.1.5 ! root 157: Joystick settings dialog
1.1 root 158: .TP
159: .B trace
1.1.1.5 ! root 160: Hatari tracing dialog
1.1 root 161: .TP
162: .B pause
163: Pause Hatari to save battery
164: .TP
165: .B about
166: Hatari UI information
167: .TP
168: .B release
169: Hatari release notes
170: .TP
171: .B full
172: Toggle whether Hatari is fullscreen
173: .TP
174: .B manual
175: Hatari manual
176: .TP
177: .B input
1.1.1.5 ! root 178: Text / mouse click injection dialog
1.1 root 179: .TP
180: .B sound
1.1.1.5 ! root 181: Sound settings dialog
1.1 root 182: .TP
183: .B changes
184: Latest Hatari changes
185: .TP
186: .B run
1.1.1.2 root 187: (Re\-)run Hatari
1.1 root 188: .TP
189: .B shot
190: Grab a screenshot
191: .TP
192: .B <panel name>
193: Button for the specified panel window
194: .TP
195: .B <name>=<string/code>
1.1.1.5 ! root 196: Synthetize string or single key <code>. NOTE: disable fast-forward
! 197: before injection or key-repeat will repeat each injected key!
1.1 root 198: .PP
199: If no options are given, the UI uses basic controls.
200: .SH "EXAMPLES"
201: Example on how to add top, right and bottom toolbars and a separate
202: "MyPanel" panel window:
203: .nf
1.1.1.2 root 204: hatariui.py \-\-embed \\
205: \-t "about,run,pause,quit" \\
206: \-p "MyPanel,Macro=Test,Undo=97,Help=98,>,F1=59,F2=60,>,close" \\
1.1.1.5 ! root 207: \-r "pause,debug,trace,machine,MyPanel" \\
! 208: \-b "sound,|,forward,|,full"
1.1 root 209: .fi
210: .PP
211: For more examples on Hatari UI options usage, see the hatariui shell
212: script.
213: .SH "SEE ALSO"
1.1.1.2 root 214: .IR hmsa (1),
215: .IR hatariui (1),
216: .IR hconsole (1)
1.1 root 217: .SH "COPYRIGHT"
1.1.1.3 root 218: Hatari UI is written by Eero Tamminen <oak at helsinkinet fi>.
1.1 root 219: .PP
220: This program is free software; you can redistribute it and/or modify
221: it under the terms of the GNU General Public License as published by
222: the Free Software Foundation; either version 2 of the License, or (at
223: your option) any later version.
224: .PP
225: This program is distributed in the hope that it will be useful, but
226: WITHOUT ANY WARRANTY; without even the implied warranty of
227: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
228: General Public License for more details.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.