![[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 [Previous NeXT emulator] / previous / python-ui|
Return to hatariui.1 CVS log | Up to [Previous NeXT emulator] / previous / 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) ! 5: .TH "hatariui" "1" "2010-05-30" "Hatari" "Hatari UI" ! 6: .SH "NAME" ! 7: hatariui \- Python/Gtk UI for Hatari ! 8: .SH "SYNOPSIS" ! 9: .B hatariui | hatariui.py ! 10: .RI [options] ! 11: .RI [diskimage] ! 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 ! 17: fast-forward etc. functionality, but these are fully configurable ! 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 ! 20: supports some options that the Hatari's built-in SDL UI doesn't. ! 21: .PP ! 22: Besides the UI configurability, some of the other advantages it has ! 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), ! 25: support for UTF-8 (in file names) and in general blending better to ! 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 ! 35: is actually a shell script wrapper for the hatariui.py Python script. ! 36: It's used to run the Python script with suitable options for default ! 37: usage and to set up the correct installation directory for the rest ! 38: of the Hatari UI Python scripts and data files. ! 39: .PP ! 40: Options below are actually for hatariui.py script. If you want to ! 41: change options given for it, modify the hatariui shell script or ! 42: make your own based on the installed one. ! 43: .\" following command line helps in updating the options: ! 44: .\" hatariui.py --help|sed -e 's/^\t\+/.TP\n.B /' -e 's/\t\+/\n/g' >> hatariui.1 ! 45: .SH "OPTIONS" ! 46: .TP ! 47: .B -h, --help ! 48: Hatari UI command line help ! 49: .TP ! 50: .B -n, --nomenu ! 51: Omit menubar from the window ! 52: .TP ! 53: .B -e, --embed ! 54: Embed Hatari window (to middle of controls) ! 55: .TP ! 56: .B -f, --fullscreen ! 57: Start in fullscreen ! 58: .TP ! 59: .B -l, --left <controls> ! 60: Add a toolbar at left ! 61: .TP ! 62: .B -r, --right <controls> ! 63: Add a toolbar at right ! 64: .TP ! 65: .B -t, --top <controls> ! 66: Add a toolbar at top ! 67: .TP ! 68: .B -b, --bottom <controls> ! 69: Add a toolbar at bottom ! 70: .TP ! 71: .B -p, --panel <name>,<controls> ! 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. ! 75: Panels are separate windows and you can has as many of them as you wish. ! 76: For each panel you need to add a control with the name of the panel ! 77: (see "MyPanel" in examples). ! 78: .PP ! 79: Following controls can are available for toolbars and panels: ! 80: .TP ! 81: .B | ! 82: Separator between controls ! 83: .TP ! 84: .B > ! 85: Next toolbar in panel windows ! 86: .TP ! 87: .B compatibility ! 88: Hatari compatibility list ! 89: .TP ! 90: .B harddisk ! 91: Hard disk images and directories ! 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 ! 103: Display settings ! 104: .TP ! 105: .B authors ! 106: Hatari authors ! 107: .TP ! 108: .B forward ! 109: Whether to fast forward Hatari (needs fast machine) ! 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 ! 130: Floppy images ! 131: .TP ! 132: .B device ! 133: Toggle Midi, Printer, RS232 peripherals ! 134: .TP ! 135: .B load ! 136: Load emulation snapshot ! 137: .TP ! 138: .B lconfig ! 139: Load configuration ! 140: .TP ! 141: .B path ! 142: Device & save file paths ! 143: .TP ! 144: .B machine ! 145: Hatari st/e/tt/falcon configuration ! 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 ! 157: Joystick settings ! 158: .TP ! 159: .B trace ! 160: Hatari tracing setup ! 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 ! 178: Simulate text input and mouse clicks ! 179: .TP ! 180: .B sound ! 181: Sound settings ! 182: .TP ! 183: .B changes ! 184: Latest Hatari changes ! 185: .TP ! 186: .B run ! 187: (Re-)run Hatari ! 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> ! 196: Synthetize string or single key <code> ! 197: .PP ! 198: If no options are given, the UI uses basic controls. ! 199: .SH "EXAMPLES" ! 200: Example on how to add top, right and bottom toolbars and a separate ! 201: "MyPanel" panel window: ! 202: .nf ! 203: hatariui.py --embed \\ ! 204: -t "about,run,pause,quit" \\ ! 205: -p "MyPanel,Macro=Test,Undo=97,Help=98,>,F1=59,F2=60,>,close" \\ ! 206: -r "paste,debug,trace,machine,MyPanel" \\ ! 207: -b "sound,|,fastforward,|,fullscreen" ! 208: .fi ! 209: .PP ! 210: For more examples on Hatari UI options usage, see the hatariui shell ! 211: script. ! 212: .SH "SEE ALSO" ! 213: .IR hatari ! 214: .SH "COPYRIGHT" ! 215: Hatari UI is written by Eero Tamminen <[email protected]>. ! 216: .PP ! 217: This program is free software; you can redistribute it and/or modify ! 218: it under the terms of the GNU General Public License as published by ! 219: the Free Software Foundation; either version 2 of the License, or (at ! 220: your option) any later version. ! 221: .PP ! 222: This program is distributed in the hope that it will be useful, but ! 223: WITHOUT ANY WARRANTY; without even the implied warranty of ! 224: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ! 225: 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.