Difference between revisions of "CWASA Release Notes"
John.Glauert (talk | contribs) (Created page with ' Home >> JASigning ---- == JASigning 0.9.5g == These are the main differences between this version and JASigning 0.9.5.f: * '...') |
John.Glauert (talk | contribs) (Ported from 095g version) |
||
Line 1: | Line 1: | ||
− | [[Main Page| Home]] >> [[JASigning]] | + | [[Main Page|Home]] >> [[JASigning]] |
---- | ---- | ||
== JASigning 0.9.5g == | == JASigning 0.9.5g == | ||
Line 32: | Line 32: | ||
* '''Improved HamNoSys/XML Input Error Handling''': Recovery from HamNoSys and XML errors in SiGML input texts is now robust - i.e. it should no longer be necessary to re-launch a JASigning application or applet after feeding erroneous SiGML input to it. | * '''Improved HamNoSys/XML Input Error Handling''': Recovery from HamNoSys and XML errors in SiGML input texts is now robust - i.e. it should no longer be necessary to re-launch a JASigning application or applet after feeding erroneous SiGML input to it. | ||
+ | |||
+ | == JASigning 0.9.5e (2009-12) == | ||
+ | |||
+ | These are the main differences between this version and | ||
+ | [[#JASigning_0.9.5d_(2008-12)|JASigning 0.9.5.d]]: | ||
+ | |||
+ | * Support for Windows Vista. | ||
+ | |||
+ | * Support for genuine offline running of a JASigning JNLP application once it has been run and cached from the server for the first time. | ||
+ | |||
+ | * Improved quality and range of HamNoSys 4 non-manuals for all avatars. | ||
+ | |||
+ | * Improvements in the [http://vhg.cmp.uea.ac.uk/tech/jas/095e/jnlp/SiGMLServiceClientApp.jnlp SiGML Client/Editor] application's UI: the editor supports UNDO/REDO (Ctl-Z/Ctl-Shift-Z), and handles unsaved edits in a more forgiving way. | ||
+ | |||
+ | * Support in the [http://vhg.cmp.uea.ac.uk/tech/jas/095e/index.html#html-applets SiGML Player Applet (SPA)] for "piped" SiGML input, that is, for SiGML input that is supplied one sign at a time over an extended period, for example, in response to input from the user. | ||
+ | |||
+ | * Support in the [http://vhg.cmp.uea.ac.uk/tech/jas/095e/jnlp/SiGMLURLApp.jnlp SiGML URL Player] application for the saving of CAS animation data to a file on the client system, and support for the incorporation of CAS data into a SiGML stream using the <tt><signing_ref></tt> SiGML element. | ||
+ | |||
+ | * Support for explicit user control of the frame-dropping policy, intended for use in the case where the frame rate is too high for the graphics hardware. | ||
+ | |||
+ | * Definition of standard HTML frames, with associated scripts, to run the [http://vhg.cmp.uea.ac.uk/tech/jas/095e/index.html#html-applets SiGML Player Applet (SPA)] either with a standard GUI or with a customised one. | ||
+ | |||
+ | Note, however, that the usual [http://en.wikipedia.org/wiki/Same_origin_policy same origin policy] means that unfortunately it is not possible to deploy a JASigning applet on some other host simply by linking to the standard SPA frame definition on this one. | ||
+ | |||
+ | == JASigning 0.9.5d (2008-12) == | ||
+ | |||
+ | These are the main differences between this version and | ||
+ | [[#JASigning_0.9.5c_(2008-07)|JASigning 0.9.5.c]]: | ||
+ | |||
+ | * The two LiveConnect applets have been replaced by a single [http://vhg.cmp.uea.ac.uk/tech/jas/095d/SiGML-Player-Applet.html SiGML Player Applet], which accepts either form of SiGML sequence specification recognised by its two predecessors, that is, a SiGML URL or an explicit SiGML text. It provides feedback to the HTML GUI via Javascript calls. <br> The applet controls its signing avatar panel via its own event dispatch thread (EDT), which responds to two classes of event: GUI events coming from the user via the HTML/Javascript [https://developer.mozilla.org/en-US/docs/JavaScript/Guide/LiveConnect_Overview LiveConnect] interface, and call-back events generated by the avatar panel itself. The EDT generates an acknowledgement for each event it receives and at present it processes events serially, that is, it will not accept a new event until it has generated the acknowledgement for its predecessor. <br> The EDT is thus a potential bottleneck, but the JASigning avatar panel component is intended to operate with enough asynchronous concurrency for this not to be a problem in practice. <br> This event-based architecture should make it a relatively straightforward matter to enhance the applet while maintaining its robustness: a new operation can be introduced by making appropriate exensions to the applet's Event enumeration, and adding code to the EDT specifying how each new event is to be processed. <br> The applet has a boolean option controlling the generation of event logging output on the Java console. <br> (The LC-SiGML-Player and LC-SiGML-URL-Player applet classes are still included in the <code>use-jarp</code> library, but this release does not provide any HTML demos for them.) | ||
+ | |||
+ | * JASigning now allocates a local workspace for itself in a directory called <code>.jasigning</code> in the user's home directory. | ||
+ | |||
+ | * If the user wishes to define a default JA options set, that is, one common to all JASigning applications, then the file defining these options (<code>jadefaults.properties</code>) should be placed in the user's <code>.jasigning</code> directory. In the absence of this file, a standard JA default options file (which typically is empty) is read from the JASigning installation server instead. | ||
+ | |||
+ | * For an avatar with Cacheable access, the locally cached copy is now held in the user's JASigning workspace (<code>.jasigning</code> directory) rather than in the JNLP Persistence Service cache, as before. This means that avatars with Cacheable access can now be used by JASigning HTML applets (which do not have access to the JNLP cache). As a result, Cacheable access is probably now the most satisfactory avatar access mode in most contexts. | ||
+ | |||
+ | * JASigning now supports a standard installation-wide set of avatar configuration options. | ||
+ | ** The properties that may be defined in this set are: | ||
+ | *** <code>avatar.id</code> | ||
+ | *** <code>avatar.id.list</code> | ||
+ | *** <code>direct.files.avatar.list</code> | ||
+ | *** <code>cacheable.avatars.list</code> | ||
+ | *** <code>avatar.config.base.uri</code> | ||
+ | *** <code>avatar.jar.base.uri</code> | ||
+ | ** together possibly with appropriate entries, each for an individual avatar, AV, in one of the forms: | ||
+ | *** <code>avatar.direct.base.uri.AV</code> (if AV has Direct Files access) | ||
+ | *** <code>avatar.jar.uri.AV</code> (if AV has Cacheable access) | ||
+ | ** (See the previous release's [[#JASigning_0.9.5c_(2008-07)|change list]] for descriptions of these options.) | ||
+ | ** The built-in JA options set does not now include settings for any of these options, but the standard JA options set may still include definitions for them through the JA default options and/or the application/applet-specific options. | ||
+ | ** Definitions of avatar options in the JA options set supplement and override the installation's standard avatar configurataion options. Thus, for example, the installation may define a basic set of avatars and standard locations for their definition files, while a particular application may define additions to the installation's standard avatar set, together with locations for these extra avatars, and possibly also non-standard locations for avatars in the installation's original set. | ||
+ | |||
+ | * The SiGML Editor/Client application now uses the Preferences mechanism to remember the location of its SiGML folder from one invocation to the next. When first used the application prompts the user to choose the required folder via a standard file dialog. | ||
+ | |||
+ | * The behavour of the Frame Number spinner component used in the JASigning applications has been reworked and should now be more robust - for example, in the case where SiGML animation generation is streamed (i.e. asynchronous). | ||
+ | |||
+ | * The [http://vhg.cmp.uea.ac.uk/tech/jas/095d/jnlp/SiGMLServicePlayer.jnlp SiGML Service Player] application now supports streamed animation generation, that is, it should be possible (with the appropriate option setting) for that application to play the animation for earlier signs in a SiGML sequence while animation data is still being generated for later signs in the sequence, or even while waiting for later signs to be delivered from the remote source. | ||
+ | |||
+ | == JASigning 0.9.5c (2008-07) == | ||
+ | |||
+ | These are the main differences between this version and | ||
+ | [[#JASigning_0.9.5b_(2008-02)|JASigning 0.9.5.b]]: | ||
+ | |||
+ | * Support for the [https://jogamp.org/applet-launcher/www/ JNLP Applet Launcher] (JAL), which allows an applet in a web browser to be launched without any prior download of supporting native libraries and avatar definitions.<br> (And which despite its name appears not to use the JNLP APIs, but just the JNLP XML file format.)<br> All the remaining changes are consequences of this one. | ||
+ | |||
+ | * No "JASigning Applet Support" installation on the client system, nor explicit offers to install local avatar definitions, if appropriate, when a JASigning JNLP application is launched. Instead all cacheing of native libraries on the client depends on the Java Web Start cacheing mechanisms, or, in the case of an HTML applet, on the JAL's own cacheing mechanisms (whose activities are recorded on the Java console log, for those who are interested). The treatment of avatar data files is described below. | ||
+ | |||
+ | * Hence this version has no need of the system-wide JA_HOME preferences setting. In previous versions JA_HOME usually identified the installation directory on the client system. In this version JA_HOME is effectively a fixed internal setting, forced to point to the remote JASigning base directory on the server. | ||
+ | |||
+ | * Applet-specific properties may now be set via <code><param></code> entries in the HTML <code><applet></code> element (or in a JNLP <code><applet-desc></code> element), the parameter name in each case being simply the the name of the preference setting it represents.<br> One consequence of this is that applet-specific properties files are no longer necessary, although they are still supported, for the time being, anyway. Another consequence is that the special <code>avatar</code> parameter of previous versions must now for consistency be named <code>avatar.id</code> | ||
+ | |||
+ | * There are now three possible access methods for an avatar's data files: | ||
+ | ** '''ClassPath''' Access: the folder of data files for the given avatar is packaged in a JAR file together with a Java access class (details below) whose sole purpose is to provide a resource base against which the avatar files can be accessed by a Java class loader. <br> Provided this avatar access JAR is placed on the classpath of a JASigning application or applet the avatar is automatically accessible - and will benefit from Java's standard client-side caching mechanisms.<br> The drawback of this method is that on first use, the user is forced to wait while every JAR of this kind is downloaded into the Java client-side cache before the application or applet can start. This is the default access method. (And it is also used to access the <code>COMMON/config.xml</code> file.) | ||
+ | ** '''Direct Files''' Access: this is essentially the access method used in previous versions, that is, the avatar data files are obtained via a base URL for the folder containing these files - but in previous versions that was typically a <code>file:</code> URL on the client, whereas now it will typically be a remote <code>http:</code> URL. | ||
+ | ** '''Cacheable''' Access: this is similar to the first access method in that the avatar data files are packaged with an access class in a JAR file. But in this case the JAR is not put on the Java classpath; instead JASigning downloads it only on demand and places it in the client's JNLP cache, from whence a temporary copy is taken and dynamically loaded. (Using the JNLP cache for this purpose seems to be a mistake since JNLP is not available to HTML applets, so at present this access method is available <em>only</em> to JNLP applications and applets. But using a custom-built cache instead of the JNLP cache - as JAL does -- would not be difficult to implement and JASigning may well change to do this in the near future.) <br>The access class for a given avatar, <code>marc</code> say, is a miniscule Java class called <code>marc.Access</code> whose compiled class file <code>Access.class</code> is placed in the <code>marc</code> avatar data folder. The Java code for this class is simply: | ||
+ | |||
+ | package marc; public final class Access{} | ||
+ | |||
+ | * There are a number of new properties/preferences settings to control the avatar access mechanisms, and several of the old setttings take on a more prominent role. As noted above, an HTML applet can now control these settings by means of <code><param></code> entries in the relevant HTML <code><applet></code> element. | ||
+ | ** <code>avatar.id</code>: The name of the avatar to be loaded initially. | ||
+ | ** <code>avatar.id.list</code>: Colon-separated list of avatars available to the application/applet, e.g. <code>anna:marc</code>.<br> (Since there is no longer an installation folder in the file system, JASigning is no longer able to determine this list for itself by inspecting its <code>agconfig</code> subfolder.) | ||
+ | ** <code>direct.files.avatar.list</code>: Colon-separated list of avatars using the Direct Files access method.<br> May be omitted (or explicitly <code>null</code>, or explicitly empty) if the list is empty. | ||
+ | ** <code>cacheable.avatar.list</code>: Colon-separated list of avatars using the Cacheable access method.<br> May be omitted (or explicitly <code>null</code>, or explicitly empty) if the list is empty. | ||
+ | ** <code>avatar.config.base.uri</code>: The default base location for the data folders of avatars in the Direct Files list. | ||
+ | ** <code>direct.files.base.uri.AVATAR</code>: Assuming <code>AVATAR</code> appears in the Direct Files avatar list, an entry of this form explicitly specifies the URL of its avatar data folder, overriding the default location implicit in the <code>avatar.config.base.uri</code> setting. | ||
+ | ** <code>avatar.jar.uri.AVATAR</code>: Assuming <code>AVATAR</code> appears in the Cacheable avatar list, an entry of this form specifies the URL of its access JAR file. | ||
+ | : Clearly, the <code>avatar.id.list</code> should include the <code>avatar.id</code> value, and should contain as sublists both the <code>direct.files.avatar.list</code> and <code>cacheable.avatar.list</code> values. | ||
+ | |||
+ | * As well as the various client-side cacheing mechanisms, this version of JASigning currently caches all avatar data in memory for the remainder of the session once loaded. This could amount to a good few Mb if many avatars are used, but probably not enough to be a problem in most environments. | ||
+ | |||
+ | * At present this version of JASigning makes no attempt to set the Java Applet runtime parameters for the user, since the separate installer which used to do this is is no longer used. | ||
+ | |||
+ | == JASigning 0.9.5b (2008-02) == | ||
+ | |||
+ | [[JASigning]] is a software system for scripted performance of sign language | ||
+ | animations by a virtual human, or avatar. The scripting language used to define | ||
+ | these animations is SiGML (Signing Gesture Markup Language). | ||
+ | |||
+ | SiGML is an XML application language, derived from | ||
+ | [http://www.sign-lang.uni-hamburg.de/Projects/HamNoSys.html HamNoSys], | ||
+ | the sign language notation system developed at the University of Hamburg. | ||
+ | |||
+ | [[JASigning]] is based on work undertaken at UEA in conjunction with our | ||
+ | partners in the | ||
+ | [[ViSiCAST]] and | ||
+ | [[eSIGN]] projects. | ||
+ | It is an alternative to the | ||
+ | [http://www.sign-lang.uni-hamburg.de/eSIGN/Software.html Avatar Plugin] | ||
+ | software released at the end of the eSIGN project. One important difference | ||
+ | is that [[JASigning]] runs on Mac OS X as well as Windows. | ||
+ | |||
+ | [[JASigning]] is a combination of | ||
+ | [http://java.sun.com/ Java] software with supporting native libraries. | ||
+ | So, use of [[JASigning]] requires that the | ||
+ | [http://www.java.com/en/download/index.jsp Java runtime] | ||
+ | software, version 5 or later, is installed on the client system. | ||
+ | Java is pre-installed on all Mac OS X systems, and on many Windows systems. | ||
+ | |||
+ | The standard method of accessing a [[JASigning]] application or | ||
+ | applet is via | ||
+ | [http://java.sun.com/products/javawebstart/ Java Web Start] | ||
+ | using JNLP, the Java Network Launch Protocol. | ||
---- | ---- | ||
− | [[Main Page| Home]] >> [[JASigning]] | + | [[Main Page|Home]] >> [[JASigning]] |
Revision as of 15:20, 15 May 2013
JASigning 0.9.5g
These are the main differences between this version and JASigning 0.9.5.f:
- Improvements to SiGML Processing: SiGMLInLib, the component which performs conversions from H-SiGML (HNS SiGML) to G-SiGML (Gestural SiGML), and also from G-SiGML back to H-SiGML or HamNoSys, performs these conversions consistently with one another, and some errors in the conversion from H- to G-SiGML have been fixed. CAS (animation) data is now output in a more compact format. CAS input and output are consistent, so re-exporting a previously imported CAS file generally produces a result whose format matches that of the original.
- Improved CAS Input and Output: CAS (animation) data is now output in a more compact format. CAS input and output are consistent, so re-exporting a previously imported CAS file generally produces a result whose format matches that of the original.
- Improved Handling of Apps' Initial Options: The initial option settings for a JASigning app are now handled more flexibly. In particular, different JNLP variants of the same underlying JASigning app can now use distinct initial options settings without confusion. Initial options properties files are cached on the client to support offline operation.
JASigning 0.9.5f (2010-07)
These are the main differences between this version and JASigning 0.9.5.e:
- Ambient Motion: Some of the avatars, including the standard avatar Anna, are now capable of ambient motion, both when idle and when signing. This feature is demonstrated in some of the applications and applets. As yet the facilities for detailed control of this feature are quite limited, but both JASigning applications include menu items allowing ambient motion to be switched on and off.
- Video Generation: JASigning now has an experimental video generation facility. Because it depends on an externally provided video processing software library, this facility depends on a supporting video generation service application (running on the client system), which must be downloaded separately. For details on the download and use of the video generation service application, see the JASigning Video Generator page.
- Security Certificate: The JASigning software components are now signed with a certificate issued by GlobalSign (to our School's consulting company, SYS Consulting Ltd.). While this gives stronger assurances about the software's authenticity than previously, it has one possible drawback for those running the software on Mac OS X: there is a bug/issue in the Mac OS X Java implementation which requires the system to be online when a JASigning application is launched, in order that the OCSP security checks can be made (even though the application is marked as suitable for offline execution). This means that on Mac OS X the JASigning applications can not be launched while completely offline. (Although going offline once the application is successfully launched is not a problem.) The only way we can see of circumventing this problem is for us to provide an alternative, self-signed, copy of the software, which is not subject to this limitation (but which is correspondingly less secure). This self-signed version can be found at the URL obtained by inserting an extra step "ss/" into the path just before the version tag: http://vhg.cmp.uea.ac.uk/tech/jas/ss/std/
- Java Security Checks: JASigning has been adjusted to take account of the fussier security régime introduced into the Java releases of recent months. In particular, the JASigning applications and applets should no longer give rise to Java security messages about "mixtures of signed and unsigned components".
- Platform Independent Applet: The main SiGML Player Applet and its variants are now launched as JNLP Applets on platforms that support this mechanism, falling back to the use of the JNLP Applet Launcher on those that don't.
- Windows Support: Although our testing is relatively limited, JASigning apparently runs successfully on Windows 7. But users of Windows XP should note that on that platform JASigning applications and applets (apart from the SiGML Service Client) now (since 2010-03) require prior installation of the freely available Microsoft Visual Studio C++ 2008 Redistributable Package - which may well be present already on many Windows XP systems.
- 64-bit Support: Support for 64-bit operation on versions of Windows, Mac OS X and the Java runtime that support this.
- Improved HamNoSys/XML Input Error Handling: Recovery from HamNoSys and XML errors in SiGML input texts is now robust - i.e. it should no longer be necessary to re-launch a JASigning application or applet after feeding erroneous SiGML input to it.
JASigning 0.9.5e (2009-12)
These are the main differences between this version and JASigning 0.9.5.d:
- Support for Windows Vista.
- Support for genuine offline running of a JASigning JNLP application once it has been run and cached from the server for the first time.
- Improved quality and range of HamNoSys 4 non-manuals for all avatars.
- Improvements in the SiGML Client/Editor application's UI: the editor supports UNDO/REDO (Ctl-Z/Ctl-Shift-Z), and handles unsaved edits in a more forgiving way.
- Support in the SiGML Player Applet (SPA) for "piped" SiGML input, that is, for SiGML input that is supplied one sign at a time over an extended period, for example, in response to input from the user.
- Support in the SiGML URL Player application for the saving of CAS animation data to a file on the client system, and support for the incorporation of CAS data into a SiGML stream using the <signing_ref> SiGML element.
- Support for explicit user control of the frame-dropping policy, intended for use in the case where the frame rate is too high for the graphics hardware.
- Definition of standard HTML frames, with associated scripts, to run the SiGML Player Applet (SPA) either with a standard GUI or with a customised one.
Note, however, that the usual same origin policy means that unfortunately it is not possible to deploy a JASigning applet on some other host simply by linking to the standard SPA frame definition on this one.
JASigning 0.9.5d (2008-12)
These are the main differences between this version and JASigning 0.9.5.c:
- The two LiveConnect applets have been replaced by a single SiGML Player Applet, which accepts either form of SiGML sequence specification recognised by its two predecessors, that is, a SiGML URL or an explicit SiGML text. It provides feedback to the HTML GUI via Javascript calls.
The applet controls its signing avatar panel via its own event dispatch thread (EDT), which responds to two classes of event: GUI events coming from the user via the HTML/Javascript LiveConnect interface, and call-back events generated by the avatar panel itself. The EDT generates an acknowledgement for each event it receives and at present it processes events serially, that is, it will not accept a new event until it has generated the acknowledgement for its predecessor.
The EDT is thus a potential bottleneck, but the JASigning avatar panel component is intended to operate with enough asynchronous concurrency for this not to be a problem in practice.
This event-based architecture should make it a relatively straightforward matter to enhance the applet while maintaining its robustness: a new operation can be introduced by making appropriate exensions to the applet's Event enumeration, and adding code to the EDT specifying how each new event is to be processed.
The applet has a boolean option controlling the generation of event logging output on the Java console.
(The LC-SiGML-Player and LC-SiGML-URL-Player applet classes are still included in theuse-jarp
library, but this release does not provide any HTML demos for them.)
- JASigning now allocates a local workspace for itself in a directory called
.jasigning
in the user's home directory.
- If the user wishes to define a default JA options set, that is, one common to all JASigning applications, then the file defining these options (
jadefaults.properties
) should be placed in the user's.jasigning
directory. In the absence of this file, a standard JA default options file (which typically is empty) is read from the JASigning installation server instead.
- For an avatar with Cacheable access, the locally cached copy is now held in the user's JASigning workspace (
.jasigning
directory) rather than in the JNLP Persistence Service cache, as before. This means that avatars with Cacheable access can now be used by JASigning HTML applets (which do not have access to the JNLP cache). As a result, Cacheable access is probably now the most satisfactory avatar access mode in most contexts.
- JASigning now supports a standard installation-wide set of avatar configuration options.
- The properties that may be defined in this set are:
avatar.id
avatar.id.list
direct.files.avatar.list
cacheable.avatars.list
avatar.config.base.uri
avatar.jar.base.uri
- together possibly with appropriate entries, each for an individual avatar, AV, in one of the forms:
avatar.direct.base.uri.AV
(if AV has Direct Files access)avatar.jar.uri.AV
(if AV has Cacheable access)
- (See the previous release's change list for descriptions of these options.)
- The built-in JA options set does not now include settings for any of these options, but the standard JA options set may still include definitions for them through the JA default options and/or the application/applet-specific options.
- Definitions of avatar options in the JA options set supplement and override the installation's standard avatar configurataion options. Thus, for example, the installation may define a basic set of avatars and standard locations for their definition files, while a particular application may define additions to the installation's standard avatar set, together with locations for these extra avatars, and possibly also non-standard locations for avatars in the installation's original set.
- The properties that may be defined in this set are:
- The SiGML Editor/Client application now uses the Preferences mechanism to remember the location of its SiGML folder from one invocation to the next. When first used the application prompts the user to choose the required folder via a standard file dialog.
- The behavour of the Frame Number spinner component used in the JASigning applications has been reworked and should now be more robust - for example, in the case where SiGML animation generation is streamed (i.e. asynchronous).
- The SiGML Service Player application now supports streamed animation generation, that is, it should be possible (with the appropriate option setting) for that application to play the animation for earlier signs in a SiGML sequence while animation data is still being generated for later signs in the sequence, or even while waiting for later signs to be delivered from the remote source.
JASigning 0.9.5c (2008-07)
These are the main differences between this version and JASigning 0.9.5.b:
- Support for the JNLP Applet Launcher (JAL), which allows an applet in a web browser to be launched without any prior download of supporting native libraries and avatar definitions.
(And which despite its name appears not to use the JNLP APIs, but just the JNLP XML file format.)
All the remaining changes are consequences of this one.
- No "JASigning Applet Support" installation on the client system, nor explicit offers to install local avatar definitions, if appropriate, when a JASigning JNLP application is launched. Instead all cacheing of native libraries on the client depends on the Java Web Start cacheing mechanisms, or, in the case of an HTML applet, on the JAL's own cacheing mechanisms (whose activities are recorded on the Java console log, for those who are interested). The treatment of avatar data files is described below.
- Hence this version has no need of the system-wide JA_HOME preferences setting. In previous versions JA_HOME usually identified the installation directory on the client system. In this version JA_HOME is effectively a fixed internal setting, forced to point to the remote JASigning base directory on the server.
- Applet-specific properties may now be set via
<param>
entries in the HTML<applet>
element (or in a JNLP<applet-desc>
element), the parameter name in each case being simply the the name of the preference setting it represents.
One consequence of this is that applet-specific properties files are no longer necessary, although they are still supported, for the time being, anyway. Another consequence is that the specialavatar
parameter of previous versions must now for consistency be namedavatar.id
- There are now three possible access methods for an avatar's data files:
- ClassPath Access: the folder of data files for the given avatar is packaged in a JAR file together with a Java access class (details below) whose sole purpose is to provide a resource base against which the avatar files can be accessed by a Java class loader.
Provided this avatar access JAR is placed on the classpath of a JASigning application or applet the avatar is automatically accessible - and will benefit from Java's standard client-side caching mechanisms.
The drawback of this method is that on first use, the user is forced to wait while every JAR of this kind is downloaded into the Java client-side cache before the application or applet can start. This is the default access method. (And it is also used to access theCOMMON/config.xml
file.) - Direct Files Access: this is essentially the access method used in previous versions, that is, the avatar data files are obtained via a base URL for the folder containing these files - but in previous versions that was typically a
file:
URL on the client, whereas now it will typically be a remotehttp:
URL. - Cacheable Access: this is similar to the first access method in that the avatar data files are packaged with an access class in a JAR file. But in this case the JAR is not put on the Java classpath; instead JASigning downloads it only on demand and places it in the client's JNLP cache, from whence a temporary copy is taken and dynamically loaded. (Using the JNLP cache for this purpose seems to be a mistake since JNLP is not available to HTML applets, so at present this access method is available only to JNLP applications and applets. But using a custom-built cache instead of the JNLP cache - as JAL does -- would not be difficult to implement and JASigning may well change to do this in the near future.)
The access class for a given avatar,marc
say, is a miniscule Java class calledmarc.Access
whose compiled class fileAccess.class
is placed in themarc
avatar data folder. The Java code for this class is simply:
- ClassPath Access: the folder of data files for the given avatar is packaged in a JAR file together with a Java access class (details below) whose sole purpose is to provide a resource base against which the avatar files can be accessed by a Java class loader.
package marc; public final class Access{}
- There are a number of new properties/preferences settings to control the avatar access mechanisms, and several of the old setttings take on a more prominent role. As noted above, an HTML applet can now control these settings by means of
<param>
entries in the relevant HTML<applet>
element.avatar.id
: The name of the avatar to be loaded initially.avatar.id.list
: Colon-separated list of avatars available to the application/applet, e.g.anna:marc
.
(Since there is no longer an installation folder in the file system, JASigning is no longer able to determine this list for itself by inspecting itsagconfig
subfolder.)direct.files.avatar.list
: Colon-separated list of avatars using the Direct Files access method.
May be omitted (or explicitlynull
, or explicitly empty) if the list is empty.cacheable.avatar.list
: Colon-separated list of avatars using the Cacheable access method.
May be omitted (or explicitlynull
, or explicitly empty) if the list is empty.avatar.config.base.uri
: The default base location for the data folders of avatars in the Direct Files list.direct.files.base.uri.AVATAR
: AssumingAVATAR
appears in the Direct Files avatar list, an entry of this form explicitly specifies the URL of its avatar data folder, overriding the default location implicit in theavatar.config.base.uri
setting.avatar.jar.uri.AVATAR
: AssumingAVATAR
appears in the Cacheable avatar list, an entry of this form specifies the URL of its access JAR file.
- Clearly, the
avatar.id.list
should include theavatar.id
value, and should contain as sublists both thedirect.files.avatar.list
andcacheable.avatar.list
values.
- As well as the various client-side cacheing mechanisms, this version of JASigning currently caches all avatar data in memory for the remainder of the session once loaded. This could amount to a good few Mb if many avatars are used, but probably not enough to be a problem in most environments.
- At present this version of JASigning makes no attempt to set the Java Applet runtime parameters for the user, since the separate installer which used to do this is is no longer used.
JASigning 0.9.5b (2008-02)
JASigning is a software system for scripted performance of sign language animations by a virtual human, or avatar. The scripting language used to define these animations is SiGML (Signing Gesture Markup Language).
SiGML is an XML application language, derived from HamNoSys, the sign language notation system developed at the University of Hamburg.
JASigning is based on work undertaken at UEA in conjunction with our partners in the ViSiCAST and eSIGN projects. It is an alternative to the Avatar Plugin software released at the end of the eSIGN project. One important difference is that JASigning runs on Mac OS X as well as Windows.
JASigning is a combination of Java software with supporting native libraries. So, use of JASigning requires that the Java runtime software, version 5 or later, is installed on the client system. Java is pre-installed on all Mac OS X systems, and on many Windows systems.
The standard method of accessing a JASigning application or applet is via Java Web Start using JNLP, the Java Network Launch Protocol.