![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to README 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 README CVS log | Up to [HATARI the Atari ST Emulator] / hatari / python-ui |
1.1 root 1: Hatari UI
2: ---------
3:
4: Hatari UI is an out-of-process user interface for the Hatari Atari
5: ST/STe/TT/Falcon emulator and its built-in debugger which can
6: (optionally) embed the Hatari emulator window.
7:
8: Having the UI in another process allows doing it with a higher level
1.1.1.2 root 9: language while avoiding adding GUI toolkit dependencies to Hatari
1.1 root 10: itself. The UI is done with PyGtk i.e. in Python language, using the
11: Gtk widget set.
12:
13: The main points of this new UI over the Hatari internal one are its
14: configurability and providing a GUI for the (console based) debugger
15: included with the Hatari emulator.
16:
17: Note: this is an additional UI, the built-in Hatari SDL UI isn't being
18: replaced or going anywhere!
19:
20:
21: Requirements
22: ------------
23:
24: My guess at the required versions for the dependencies are:
1.1.1.5 ! root 25: - Python >= 2.6
1.1.1.3 root 26: - PyGtk >= 2.12 (on Debian/Ubuntu PyGtk is in python-gtk2 package)
1.1 root 27:
1.1.1.2 root 28: Hatari UI is included with the Hatari sources:
1.1.1.4 root 29: http://hg.tuxfamily.org/mercurialroot/hatari/hatari/file/tip/python-ui
1.1.1.2 root 30:
1.1.1.5 ! root 31: Hatari UI has been tested on several Linux versions. I would assume
! 32: it to work also on other unix systems such as Apple OSX. It won't work
! 33: on Windows as the required Windows socket support is missing from the
! 34: Hatari emulator.
1.1 root 35:
36: Embedding the Hatari emulator window is currently supported only for
37: systems using an X window system (from libSDL sources it would seem
38: that Windows would also support window embedding, but support for that
1.1.1.3 root 39: would need to be added both to Hatari and Hatari UI because SDL's
40: own embedding disables all keyboard events in SDL program).
1.1 root 41:
42:
43: Running
44: -------
45:
46: Being a Python program, Hatari UI doesn't need to be built.
47: You can just run it from where you extracted it (or checked
1.1.1.5 ! root 48: it out of TuxFamily HG repo) by calling its wrapper script:
1.1 root 49: /path/to/script/hatariui
50:
51: Or you can run just the debugger:
52: /path/to/script/debugui.py
53:
1.1.1.2 root 54: But you can also install it to system along with Hatari:
1.1 root 55: make install
56:
57:
58: Notes
59: -----
60:
1.1.1.2 root 61: Hatari UI runs a Hatari version found on $PATH. If you want
62: to use a version of Hatari that hasn't been installed, you
63: need to modify the search path, for example like this:
1.1.1.5 ! root 64: PATH=../build/src:$PATH hatariui
1.1.1.2 root 65:
1.1 root 66: If UI is started without the embedding option, the actions
67: (in menus and toolbars) have also shortcuts. They cannot
68: be used when Hatari window is embedded because then those
69: shortcuts couldn't be used with Hatari.
70:
71:
72: URL: http://koti.mbnet.fi/tammat/hatari/hatari-ui.shtml
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.