| 79 | | Patrick Hartling <patrick@vrjuggler.org> |
|---|
| | 79 | key_sym_2_0.xsl |
|---|
| | 80 | --------------- |
|---|
| | 81 | |
|---|
| | 82 | An XSLT stylesheet that provides assistance in migrating from VR Juggler |
|---|
| | 83 | 2.0 to 2.1 and beyond. VRJConfig has a bug where it will not automatically |
|---|
| | 84 | replace numeric values with symbolic values when the config definition |
|---|
| | 85 | uses value enumeration. For new configurations, it uses the symbolic |
|---|
| | 86 | value, but if a configuration has been migrated forward repeatedly, it may |
|---|
| | 87 | contain numeric values. In the case of keyboard keys, mouse buttons, and |
|---|
| | 88 | mouse motions, the numeric values changed during VR Juggler 2.1 |
|---|
| | 89 | development, and as a result, VR Juggler 2.0 configurations using |
|---|
| | 90 | keyboard/mouse input may not behave as expected with VR Juggler 2.1 and |
|---|
| | 91 | newer. To help work around this, this transform can be applied to VR |
|---|
| | 92 | Juggler 2.0 configurations to replace the numeric key/mouse values with |
|---|
| | 93 | the symbolic values so that they will migrate forward seamlessly. |
|---|
| | 94 | |
|---|
| | 95 | To use this stylesheet with the xsltproc command, run xsltproc as |
|---|
| | 96 | follows: |
|---|
| | 97 | |
|---|
| | 98 | xsltproc -o <output>.jconf key_sym_2_0.xsl <input>.jconf |
|---|
| | 99 | |
|---|
| | 100 | To use it with Xalan, run the xalan wrapper (shell script or batch |
|---|
| | 101 | file) as follows: |
|---|
| | 102 | |
|---|
| | 103 | xalan -in <input>.jconf -out <output>.jconf -xsl key_sym_2_0.xsl |
|---|
| | 104 | |
|---|
| | 105 | Fill in your input filename and output filename appropriately. |
|---|
| | 106 | |
|---|
| | 107 | In general, this transform should be applied to all VR Juggler 2.0 |
|---|
| | 108 | configuration files that contain key_modifier_pair, input_window, and |
|---|
| | 109 | display_window config elements. After applying the transform, the 2.0 |
|---|
| | 110 | configuration files will continue to work with VR Juggler 2.0, and they |
|---|
| | 111 | will be ready for migration to VR Juggler 2.2 using VRJConfig. |
|---|
| | 112 | |
|---|
| | 113 | Patrick Hartling <patrick@infiscape.com> |
|---|
