Difference between revisions of "SiGML Extensions"

From Virtual Humans
Jump to navigation Jump to search
(Document use of <time/> elements in <player_settings/>.)
(To be edited for CWASA extensions.)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Main Page]] >> [[SiGML]]
+
[[Main Page]] >> [[CWASA]]
  
 
----
 
----
 +
In progress: Revision for CWASA extensions.
 
= Player Settings =
 
= Player Settings =
 
A number of extensions to [[SiGML]] are available when using [[JASigning]] to animate SiGML data. These enable some actions of the player to be scripted with a SiGML file.
 
A number of extensions to [[SiGML]] are available when using [[JASigning]] to animate SiGML data. These enable some actions of the player to be scripted with a SiGML file.
The current extensions are provided by adding a <code><player_settings\></code> element between signs in the SiGML file. The  <code><player_settings\></code> element encloses one or more settings elements.
+
The current extensions are provided by adding a <code><player_settings\></code> element between signs in the SiGML file. The extensions act on the following sign so extensions at the end of a file will be ignored.
 +
 
 +
The  <code><player_settings\></code> element encloses one or more settings elements. If several settings elements are provided before a sign, later settings override earlier ones.
  
 
== Camera Settings ==
 
== Camera Settings ==
Line 15: Line 18:
  
 
== Sign Timing ==
 
== Sign Timing ==
The starting time for a sign can be set using a <code><time/></code> element with an attribute saying when the sign should begin, expressed in seconds since the start of the sequence. The avatar will go to a rest position until the time arrives. If the time specified has already passed, the following sign will play immediately.
+
The starting time for a sign can be set using a <code><time/></code> element with an attribute saying when the sign should begin, expressed in seconds since the start of the sequence. If the time specified has already passed, the following sign will play immediately.
 
  <player_settings>
 
  <player_settings>
 
   <time begin="3.5"/>
 
   <time begin="3.5"/>
 +
</player_settings>
 +
It is possible to provide a <code>mode</code> attribute to say whether the avatar should got to <code>"rest"</code> until the given time is reached (the default), or whether to <code>"hold"</code> the final posture of the previous sign:
 +
<player_settings>
 +
  <time begin="4.5" mode="hold"/>
 
  </player_settings>
 
  </player_settings>
  
Line 35: Line 42:
 
----
 
----
  
[[Main Page]] >> [[SiGML]]
+
[[Main Page]] >> [[CWASA]]

Latest revision as of 16:33, 30 June 2023

Main Page >> CWASA


In progress: Revision for CWASA extensions.

Player Settings

A number of extensions to SiGML are available when using JASigning to animate SiGML data. These enable some actions of the player to be scripted with a SiGML file. The current extensions are provided by adding a <player_settings\> element between signs in the SiGML file. The extensions act on the following sign so extensions at the end of a file will be ignored.

The <player_settings\> element encloses one or more settings elements. If several settings elements are provided before a sign, later settings override earlier ones.

Camera Settings

The camera location is controlled by eight parameters that can be provided in a .properties file or an app <argument/> or applet <param/>. Changes to the settings caused by use of the mouse with modifier keys are reflected on the Java Console Log and can be copied to use as initial camera settings.

The first six camera settings can be changed during the course of playing a SiGML file with <player_settings/> as in the following example:

<player_settings>
  <camera_location cx="0.00" cy="0.50" r="4.50" theta="30.0" phi="40.0" fov="30.0"/>
</player_settings>

Sign Timing

The starting time for a sign can be set using a element with an attribute saying when the sign should begin, expressed in seconds since the start of the sequence. If the time specified has already passed, the following sign will play immediately.

<player_settings>
  

It is possible to provide a mode attribute to say whether the avatar should got to "rest" until the given time is reached (the default), or whether to "hold" the final posture of the previous sign:

<player_settings>
  

Avatar Choice

JASigning accepts commands to switch between avatars through menu choices, through messages on a special socket for the SiGML Service Player app, and through <player_settings/> in SiGML files.

<player_settings>
  <avatar name="marc"/>
</player_settings>

Ambient Motion Settings

The JASigning software accepts <player_settings/> to control the ambient motion behaviour. However, these settings refer to features of older player sofware and are ignored by JASigning at present.

<player_settings>
  <ambient_motions body="ON" head="ON" blink="ON"/>
</player_settings>

Main Page >> CWASA