Hand Engine changelog

What's new in Hand Engine

Hand Engine software changelog

Hotfix

Hand Engine Update 1.5.1

New version

Hand Engine 1.5.1

Previous version

Hand Engine 1.5.0

Deprecated versions

Hand Engine 1.5.0

Operating system

Windows 10, 64bit

Meaning of icons

+added, ^changed, !note, #fixed, -removed

Requirement

**Batch Processing functionality requires a glove and dongle firmware update (glove firmware v01.00.19 and dongle firmware version v01.01.00). Both versions are included in Launcher firmware bundle version 1.3.

New Firmware Update Process via Launcher (Open Beta)

How to Update Your Mocap Pro Glove and USB Dongle Firmware via the StretchSense Launcher

Legacy Firmware Update Process

Glove Firmware Update Process

Dongle Firmware Update Process

1. Introduction

This document describes the minor changes and bug fixes included in software update 1.5.1 for Hand Engine

2. Minor Changes

+ Directly after completing a batch process, the Hand Engine UI is Reset.

3. Bug Fixes

# Fixed an issue when trying to batch export files locally recorded on the PC resulting in an error message “Cannot read property ‘calibration’ of undefined” error. Files previously recorded in 1.5.0 will be able to be batch exported in 1.5.1.

5. Known Issues

Attempting to Restore Session after Batch processing can lead to an infinite loading screen requiring a restart of Hand Engine (Ctrl + R)

Moderate update

Hand Engine Update 1.5.0

Previous version

Hand Engine Animator 1.4.0, Hand Engine Studio 1.4.0

Deprecated versions

Hand Engine Animator 1.2.1, Hand Engine Studio 1.2.1

Operating system

Windows 10, 64bit

Meaning of icons

+added, ^changed, !note, #fixed, -removed

Requirement

**Batch Processing functionality requires a glove and dongle firmware update (glove firmware v01.00.19 and dongle firmware version v01.01.00). Both versions are included in Launcher firmware bundle version 1.3.

New Firmware Update Process via Launcher (Open Beta)

How to Update Your Mocap Pro Glove and USB Dongle Firmware via the StretchSense Launcher

Legacy Firmware Update Process

Glove Firmware Update Process

Dongle Firmware Update Process

1. Introduction

This document describes the new features, improvements and bug fixes included in software update 1.5.0 for Hand Engine

2. Main Features and Improvements

Batch Processing: Automation of raw CSV files export to FBX**

+ Raw files recorded locally on your PC or recorded directly onto your gloves via SD card can be batch processed by Hand Engine into FBX files. Navigate to File>Batch Processing to access the Batch Processing tool in Hand Engine

! Only files recorded using 1.5.0 with the latest firmware can be batch processed (glove firmware v01.00.19 and dongle firmware version v01.01.00)

^ In a file structure change for files recorded locally on your PC, the default recording directory is changed to C:\Users\Public\Documents\StretchSense\Hand Engine\Captures

^ In a file structure change for files recorded on an SD Card the default recording directory is changed to D:\StretchSense\Hand Engine\Captures

^ For both the files recorded to the PC and the SD card, when a recording is created, a date folder is created in The Captures folder. Every recording on that date produces a Take folder. The Take folder includes all files recorded for that take including FBX files, raw CSV files, calibration files and meta files for each performer for each active glove during that take (see below for details)

! File name changes in detail (PC):

  • P1: Files prefixed with P1 relate to Performer 1. If you recorded with more than one performer during a take, the files will have the prefix P2, P3, etc.

  • P1L.FBX and P1R.FBX: left hand only FBX and right hand only FBX respectively, as recorded in Hand Engine.

  • P1FullBody.FBX: left and right hand data recorded onto a single full-body skeleton, as recorded in Hand Engine.

  • P1L.CAL and P1R.CAL: left hand calibration data and right hand calibration data respectively.

  • P1L.CSV and P1R.CSV: left hand raw data and right hand raw data respectively.

  • P1LMeta.JSON and P1RMeta.JSON: left hand metadata and right hand Metadata data respectively, includes information about time and date of take and all settings used.

! File name changes in detail (SD Card):

  • P1LSD.CSV/P1RSD.CSV: Left hand raw data and right hand raw data respectively, recorded on the SD card onboard the glove (only data for that glove is recorded)

  • P1LMetaSD.JSON/P1RMetaSD.JSON: Left hand metadata and right hand metadata respectively, recorded on the SD card onboard the glove (only data for that glove is recorded)

! For detailed information on Batch Processing please refer to the KnowledgeBase how-to-guide on Batch Processing

Express Model Performance Upgrade

+ 25% performance gain in the number of poses that can be reliably recreated with an Express calibration

+ Thumb performance improvement with reduced clipping

Preview Feature: Calibration Tuning with Additive Poses in Hybrid Mode

+ In Hybrid Mode, captured pose calibrations can now be added to Express calibrations. Using this method, Hybrid Mode can be used to fine tune Express calibrations

+ By first creating an Express calibration as a base for your continuous movement, the user can then add individual poses by ticking the Blend checkbox for each pose they wish to add. Users can check, uncheck or delete poses as they wish. To apply the changes, users must then click the Hybrid button in the Output section. Without this step, the changes will not be applied

Hand Engine Animator and Studio consolidated into a single Hand Engine license type from 1.5.0 onwards

+ From 1.5 onwards our two license types, Hand Engine Animator and Studio, are consolidated into one, simplifying our licensing model for customers. Previously, Hand Engine Animator license allowed for two pairs of gloves and Hand Engine Studio allowed six pairs of gloves

+ With the new license, you will be able to pick how many pairs of gloves you would like, between two and six pairs. This change provides you with more flexibility

+ For Hand Engine Animator users, the change will be applied in the background and it will not have any impact on their Hand Engine experience

+ For Hand Engine Studio users, you will have already been provided with an updated Hand Engine license on your StretchSense account for use with Hand Engine 1.5 or later. Your existing Hand Engine Studio license can still be used to access older versions of Hand Engine Studio

3. Other Minor Changes

+ A confirmation prompt has been added for when users choose to delete a performer or profile, providing the option to confirm or cancel the decision to permanently delete a profile or performer

^ File, Settings and Help menu UI text contrast has been improved

^ Remapping wizard text instructions have been updated

^ License activation page now directs users to support@stretchsense.com rather than sales@stretchsense.com

Due to file structure changes, the ability to customize the Take Name Format in Settings>Preferences for the files being saved has been removed

4. Bug Fixes

# Fixed an issue when importing a performer from a JSON file and the right hand calibration would not work, giving an error message saying: “Please create an Performer, profile and connect your gloves before Calibrating”

# When loading the .csv file to export to FBX without adding the Performer and Profile, the error message “Device not trained yet” has changed to “Please make sure the Performer, Profile, and Output mode are selected before exporting to FBX”

# During playback from .csv file without the Performer and Profile, the error message “{“status”:”Device source not currently set to file mode”}” has changed to “Please select the Performer and Profile before playback is triggered”

5. Known Issues

Batch Exporting left and right raw files to Full Body FBX can on rare occasions lead to data being written on only one hand

If any remote system sends duplicate start trigger commands the system will create multiple folders with same take name but will write to only one folder

Clicking the scan button does not auto-assign a COMPORT. After clicking scan the user must first select the COMPORT they would like to use from the dropdown list then click the ‘on’ switch

When manually exporting, recorded CSV files will use the Take Name set in Hand Engine rather than the Take Name used in the CSV file name

Moderate update

Hand Engine Update 1.4.0

Previous version

Hand Engine Animator 1.3.0, Hand Engine Studio 1.3.0

Deprecated versions

Hand Engine Animator 1.2.0, Hand Engine Studio 1.2.0

Operating system

Windows 10, 64bit

Meaning of icons

+added, ^changed, !note, #fixed, -removed

Requirement

FBX functionality requires latest firmware version for glove (v1.0.17) and dongle (v1.0.12)

New Firmware Update Process via Launcher (Open Beta)

How to Update Your Mocap Pro Glove and USB Dongle Firmware via the StretchSense Launcher

Legacy Firmware Update Process

Glove Firmware Update Process

Dongle Firmware Update Process

1. Introduction

This section describes the new features, improvements and bug fixes included in software update 1.4.0 for Hand Engine. Update Hand Engine by logging in and downloading the installer files from your account.

2. Major Enhancements and Features

+Hand Engine User Interface now arranged by performer, not by glove
  • Hand Engine Interface improved to simplify performer setup
  • Pairs of gloves now appear under a single performer panel to simplify workflow

  • Users are presented with a more focused setup view. This includes performer setup, left and right glove connection, express calibration and streaming options

  • Additional controls are accessible via the expandable “Advanced Calibration Options” button. Additional options include Captured Poses, Blend, Pose and Hybrid Mode Settings, Glove Timecode and SD Card Options

  • Profiles for left and right hands are auto-populated upon creating a Performer

  • A sensor indicator was added per device. This allows users to monitor multiple active performers simultaneously (provides summed sensor output from all sensors in active glove)

  • <p”>Scene and Object Tab hidden from default view. “Edit Pose” button available to access bone hierarchy and local rotations</p”>
+ Express Calibration tutorial video has been included in-software to guide users through the Express Calibration process

3. Other Features

+Connection type selectors for USB, File and Network have been replaced with SVG Icons

+Actor replaced by Performer in all instances

+Character section replaced with Left and Right groups

+Remap feature moved into Streaming section

+Preview button replaced with Live/Pose toggle in Hand Engine Viewport

+Serial and firmware info can be found by hovering over the “Information/i” icon on each device panel

+Ability to choose to export Left Device Calibration Profile or Right Device Calibration Profile. Located under File>Export Calibration Left and File>Export Calibration Right

+Message displayed when user clicks Add Pose. Identifies to user which hand model was used as the pose template

+FBX Recording toggle updated from Hands Only/Full Body to Hands/Body

+If “use remote trigger system take location” is set to on in Settings>Preferences, a backup of recorded files will still be saved in the default recording location save directory set by the user

– Removed left and right hand selector from individual devices

– TCP connection removed from Network Input (only UDP connection is used for beta Wi-Fi bridge Android App)

-Snap proximity UI element removed

4. Bug Fixes

# Error message displayed when you choose a recording location save directory that does not exist

# Error message displayed when SD card not found

# Fixed white screen error in Hand Engine 1.3.0 when setting IP binding

# If “use remote trigger system take location” is set to on in Settings>Preferences and the directory doesn’t exist an error message is displayed to inform the user the save directory does not exist

5. Known Issues

Clicking the scan button does not auto-assign a COMPORT. After clicking scan the user must first select the COMPORT they would like to use from the dropdown list then click the on switch

Master timecode stream only updates when at least one glove is connected. Timecode will update as soon as a connection with the glove is re-established

Manual export of recorded CSV file will use Take Name set in Hand Engine rather than the Take Name used in the CSV file name.5

Moderate update

Hand Engine Update 1.3.0

1. Major Enhancements and Features
  • Option to export recording to full body FBX or two individual hand FBX Allows flexibility in regard to how the FBX data can be integrated into different offline workflows for merging hand and body data in third party software.
  • Migration of Hand Engine to Standalone Application Run Hand Engine without the need for a Chromium-based browser e.g. Chrome or Edge.
  • New Express calibration model New model with improved performance. Improved splay behavior during finger bend.
! This feature will require the same update to glove and dongle firmware as in Hand Engine 1.2.0.

Learn how to update your firmware:

2. Other Features
  • Preview Feature: Hand Engine streams out Pose information Pose ID, Pose Name, Pose Confidence and Active State for key Poses in Pose Detection and Hybrid Mode via TCP Stream. Updated Unreal Engine, Unity3D, MotionBuilder and Maya Plugins can receive this information:
    • Unreal Plugin 01.00.05 (please note this plugin has also been updated for UE 4.27)
    • MotionBuilder Plugin 01.00.17
    • Unity Plugin 01.00.03
    • Maya Plugin 01.00.02 Login to your account for the latest plugins.
  • Raw data files (CSV files) include column headers for joint angle information.
  • Set default Express Calibration time to 15s (for existing users this will not change the timer settings they have already set).
  • Warning pop-up when glove and dongle firmware is out of date. Warns user that recording of data may be corrupted if firmware is out of date
3. Bug Fixes
  • OptiTrack Timecode fixed when Motive and Hand Engine running on same PC.
  • UI added to set OptiTrack Local IP Address for listening to Timecode from Motive.
  • SD Card Recorded CSV Files can now be exported into an FBX via File Playback.
4. Known Issues Manual export of recorded CSV file will use Take Name set in Hand Engine rather than the Take Name used in the CSV file name.

Minor update 

Version 1.2.1 (Hotfix)

Improvements

Bug fixes

  • FBX now Exports encoded with the TakeName set in Hand Engine instead of exporting with Take001 every time
  • Captured poses are now visible not blank upon loading a session

Requirements

Requires latest firmware version for Glove (v1.0.17) and Dongle (v1.0.12)

Learn how to update your firmware:

Moderate update

Version 1.2: Improved support for optical systems, auto jam sync, Express Calibration improvements

Major improvements and features

  • Streaming Hand Engine data over the network to a computer running MVN Animate Pro or Plus (via UDP). User can set the IP address of the computer running MVN in Hand Engine.
  • New Express calibration – new model with improved performance, especially in regard to thumb and splay movement.
  • Simplified and expanded timecode synchronization for optical systems (Vicon Shogun and OptiTrack Motive).
  • Improved timecode synchronization via wireless jam sync. Gloves can be synced from within Hand Engine. Reduces drift and the need for mechanical devices like UltraSync One to be plugged into the glove.
  • FBX recording changes: adjustable frame rates that conform with industry standards.

Minor changes

  • Remapping: ability to set binding pose of target asset to L-Pose or Paddle Pose. Previously target asset had to be in L-Pose.
  • How to Guides link in Hand Engine updated to new Knowledge Base.

Bug fixes

  • Crash during trigger of multiple devices resolved (bug fix)
  • Fix to align keys with frames (bug fix).

Known issues

  • Loading a session doesn’t load user changes to Xsens Streaming IP Address, Remapping settings.
  • UI: Multicast/Unicast dropdown menu is misaligned on different sized monitors.
  • When loading a Saved Session the captured poses for the profile loaded is missing. They reappear if you change between profiles.

Requirements

Requires latest firmware version for Glove (v1.0.17) and Dongle (v1.0.12)

Learn how to update your firmware:

Previous Hand Engine release notes

Versions: