Hi Phil, (01)
Here are the current instructions for running the Java AugTerm (in
Linux). It should run ok in Windows (keyset not supported) but the exact
instructions are slightly different and not yet documented. If you could
document what you did to make it run in Windows, I'd appreciate it. (02)
Instructions (03)
* Checkout code (04)
Sometime in the last year, SourceForge has changed the url to access
code in subversion. You can now check out code for the Java AugTerm with
the following new url: (05)
$ svn co https://augterm.svn.sourceforge.net/svnroot/augterm augterm (06)
* Compile code (07)
The code will compile under jdk1.6.x (with warnings) and jdk1.5.x (no
warnings). The build script is targeting 1.5 or newer so it won't
compile under 1.4.x or older. (08)
$ cd augterm/trunk
$ ant (09)
* Run Java AugTerm (010)
Running the java augterm will bring up a Java AugTerm console window. On
Linux (where the keyset is supported), you will see "Chord keyset is
available" on the bottom status bar in the window if the keyset is
plugged in, and it will automatically detect if the keyset is connected
or disconnected ("No chord keyset"). (011)
$ java -jar build/augterm-0.22/augterm.jar (012)
* Use Java AugTerm (013)
You must connect to an existing NLS system that is up and running on a
server. Go to AugTerm/Connect in the menu and choose the NLS host. (014)
* Eclipse development (015)
I already have the eclipse environment files checked in (.classpath and
.project) for Java AugTerm. You should be able to add that project
(augterm/trunk) to your eclipse and then eclipse will automatically
compile the source and you can work on development. (016)
* Status of Keyset Drivers (017)
- JavaKeysetDriver - this driver was written by me (Jonathan) and runs
as a pure Java driver. It only works on Linux, because it relies on the
underlying Linux joystick driver which makes all joystick information
available as a normal Linux device file (/dev/input/js0). Unfortunately,
Windows and Mac OS do not support making joystick information available
as a device file so this driver will not work on those platforms. (018)
- JavaJoystick - I have an adapter (not checked in) which works with
the JavaJoystick project (http://sourceforge.net/projects/javajoystick/)
and does work on both Linux and Windows. It does not work on Mac OS
because that project does not have support for Mac OS. I can't check in
the adapter or underlying JavaJoystick driver because of license
incompatibilities. JavaJoystick is released under Artistic License 1.0
which is incompatible with GPLv2
(http://www.fsf.org/licensing/licenses/index_html#ArtisticLicense). We
tried to contact (March 2006) the original developer of this project,
who is the copyright owner, but did not receive a reply from him. (019)
- JInput - (suggested by Phil). This looks like a good candidate but
has not been tested yet and no adapter has been written yet. (020)
- Other drivers have not yet been tested and no adapter has yet been
written. (021)
Jonathan (022)
_________________________________________________________________
Message Archives: http://chm.cim3.net/forum/nls-technical/
Shared Files: http://chm.cim3.net/file/work/project/nls-restore/
Community Portal: http://www.computerhistory.org/
To Post: mailto:nls-technical@chm.cim3.net
Community Wiki: http://chm.cim3.net/cgi-bin/wiki.pl?NLS_Restoration (023)
|