1. StretchSense Knowledge Base
  2. Migrating from HE 1.5.3 to HE 2?

Migrating from Hand Engine 1.5.3 to 2.X

This document highlights the main changes between Hand Engine 1.5.3 and 2.X to be aware of before migrating to the latest version.

1. Mocap Glove Supported

 
 

Hand Engine

SuperSplay

Fidelity

1.5.3

:check_mark:

:cross_mark:

2.X

:check_mark:

:check_mark:

 
Hand Engine 1.5.3 or lower does not support the Mocap Pro Fidelity gloves.

2. Minimum Firmware Requirements

Hand Engine 1.5.3

 

SuperSplay 

Fidelity 

Glove

01.01.00

:cross_mark: - NA

Dongle

01.01.02

:cross_mark: - NA

 

Hand Engine 2.X 

 

 

SuperSplay 

Fidelity

Glove

01.01.05

01.00.02

Dongle

01.01.04

01.01.04

 

3. Calibration

 

Hand Engine

Pose Calibration Timer (a)*

Group Calibration

(b)*

Live → Pose Switch (c)*

Express Calibration Tutorial Video (d)*

Export Performer

(e)*

Cut/Copy/

Rename Poses (f)*

1.5.3

:check_mark:

:check_mark:

:check_mark:

:check_mark:

:check_mark:

:check_mark:

2.X 

:cross_mark:

:cross_mark:

:cross_mark:

:cross_mark:

:cross_mark:

:cross_mark:

 
a) Hand Engine 2.X does not support the pose calibration timer present in HE 1.5.3 (see example below). In HE 2.X the user will need to click on the Capture Pose button manually for each pose to be added. 

HE 1.5.3:

b) Hand Engine 2.X does not support the Group calibration timer present in HE 1.5.3 (see example below).
Due to the new interface changes, the calibration for each hand will need to be done separately.

HE 1.5.3:

c) Hand Engine 2.X does not require a Live -> Pose switch present in HE 1.5.3 (see example below).

HE 1.5.3:
Once the poses are captured the user will need to go into the Hand Training tab, select their preferred calibration settings and then click on Train to be able to see the live hand motion.

HE 2.X:
 
d) The Tutorial button for the Express Calibration from HE 1.5.3  is no longer present in HE 2.X, the video can still be found in our Knowledge Base User Guide article.
HE 1.5.3:
 
e) Hand Engine 2.X does not support the Export Performer feature present in HE 1.5.3 (see example below).
HE 1.5.3:
The current solution in HE 2.X is to go into Advanced Calibration -> Hand Training -> Export Calibration. The user will need to export the calibration for each hand separately.

HE 2.X:

f) Hand Engine 2.X does not support the pose Cut, Copy, Paste and Rename features present in HE 1.5.3 (see example below).
HE 1.5.3:
In HE 2.X the Pose Editor tool has been introduced, which is a complete redesign of the custom pose creation process from HE 1.5.3. The Pose Editor tool can be accessed via Windows -> Pose Editor, further instructions on how to operate the tool can be found in our Knowledge Base User Guide article.
HE 2.X:

4. Recording / Playback

 

Hand Engine

Global File Playback (a)*

FBX Record Target (Hands or Full Body only)

FBX Start Key Data (timecode or frame 0) (b)*

1.5.3

:check_mark:

:check_mark:

:cross_mark:

2.X 

:cross_mark:

:check_mark:

:warning: (saves both FBXs at the same time)

:check_mark:

:warning: (in HE, Windows → Settings)

 
a) Hand Engine 2.X does not support the Global File Playback feature present in HE 1.5.3 (see example below).
HE 1.5.3:
In HE 2.X, the recorded files will begin the playback as soon as the raw data file is loaded in Hand Engine. This means that the left and right hands will end up out of sync by the time the last hand data is loaded. 
NOTE: Our Developers are currently working on improvements to the playback feature.
 
b) In Hand Engine 2.X the user is now able to select when to start the keyframe for the recorded data (see example below).  In HE 1.5.3 the keyframe starts at timecode by default.
HE 2.X:

5. Recorded Files

IMPORTANT: If your pipeline relies on a naming convention of a recorded file from Hand Engine, please refer to the following updates.

 

Hand Engine

Calibration File

Meta File

GlobalMeta File

1.5.3

P1L_PerformerName.cal

P1R_PerformerName.cal

P1LMeta_PerformerName.json

P1RMeta_PerformerName.json

:check_mark:

2.X 

Cal_P1L_PerformerName.json

Cal_P1R_PerformerName.json

P1L_PerformerNameMeta.json

P1R_PerformerNameMeta.json

:cross_mark:


No change to the CSV and FBX file naming convention.

6. 3rd Party Integration

Remote Trigger

 

Hand Engine

Use Remote Trigger

System Take Location (a)*

Automatically Updates to Default

UDP Port of Selected Source

1.5.3

:check_mark:

:cross_mark:

2.X 

:cross_mark:

:check_mark:

 

a) Hand Engine 2.X does not support the Use Remote Trigger System Take Location feature present in HE 1.5.3 (see example below).


 This feature has been removed from HE 2.X due to a large number of issues related to directory edit/access permissions.