5. User Interface
This section last updated: $Date: 2003/01/31 21:49:21 $The User Interface is a Java/Swing application. You require the JRE 1.3 to run it, available from http://java.sun.com. It will not work with JRE 1.4 at present, because of an issue with JAXP.
For Linux, enter the following commands to run the UI:
cd /usr/src/doors-0.1.1/bin ./ui.sh |
For Win32, unpack the archive as c:\doors-0.1.1 and create a new shortcut with the following properties:
Program | Cmd line: c:\doors-0.1.1\bin\ui.bat
Program | Working: c:\doors-0.1.1\bin\
Memory | Initial environment: 1024
If all goes well, the GUI should appear.
 | If you do not have Internet access, the UI will throw a HostNotFound exception when trying to display the default URL (http://doors.sourceforge.net/music). In this case you must configure your local webserver (or FTP server) to serve the sample music included with the Doors distribution. (Ie. create a symbollic link in your webserver's document root directory which points to /usr/src/doors-0.1.1/music) Type this URL into the UI's URL box to access the content. |
| The UI is a Java/Swing application and will be sluggish when running on anything less than a 300 MHz machine. The solution would be to port it to native code. Furthermore, if you're playing media from http://doors.sourceforge.net/music then there will short delays during interaction, while the XML and content is downloaded from the webserver. During these delays the User Interface stops responding. The solution is to improve the use of threads in the User Interface code, although one workaround is to serve the music from your own local webserver. |
Invoking the UI should produce the following log messages:
UserInterfaceServer: Setting name of this User Interface to 'hostname/UserInterface' UserInterfaceServer: Connecting to Controller by broadcast request... IorClient: Looking for IOR at 255.255.255.255:17125... IorClient: ...found IOR! UserInterfaceServer: ...connected to Controller! UserInterfaceServer: Setting Schedule View refresh period to 100 ms UserInterfaceServer: Creating UserInterface... UserInterfaceServer: Registering hostname/UserInterface with Controller UserInterface: setTempo(132.0, 0.0) |
The Controller should also output the following:
Controller: registerDevice(hostname/UserInterface) |
Where hostname is the name of the machine the UI was started on.