Instructions

This document will take you through the steps of setting up a trigger for remote recording in the Hand Engine software via Command Prompt.

Requirements

  • StretchSense HandEngine 1.1.1 and higher: Log in to your account page on My account - StretchSense  or email support@stretchsense.com for details

  • Operating System: Windows 10

  • Python knowledge

  • Python Start/Stop recording scripts (triggering Hand Engine recording only):

    Animator Version - Click Here
    Studio Version - Click Here
  • Python Start/stop recording scripts (triggering Hand Engine and Vicon Shogun Recording simultaneously)

    Animator Version - Click Here

    Studio Version - Click Here


Setting up the trigger for remote recording in Hand Engine

  1. Launch Hand Engine, connect your gloves, and load your calibration.


    Image Placeholder

     

  2. Open Command Prompt, type cd, and paste the file location where the scripts are saved.

  3. Type in the following command line and hit Enter to start recording in Hand Engine. If successful, you will see a red pulsing light next to Recording.

    python start_capture_HE_Only.py --port=3000 --name="TakeName" --host="127.0.0.1"

    NOTE:
    a) The port and host can be changed to where Hand Engine is running (you can check them in the Hand Engine URL in the browser). If you don’t specify the host and port then the default (127.0.0.1 & 3000) will be used.

    b) The “TakeName” part can be changed to how you would like the take to called.
    Image Placeholder

     
  4. To stop recording, type the following command line and hit Enter. If successful, you will see the red light next to Recording turned off. The scrips will run checks for every glove tab in Hand Engine.

    python stop_capture_HE_Only.py --port=3000 --host="127.0.0.1"

    Image Placeholder

     

  5. The recording location can be found under Settings > Browse Recordings.

    Image Placeholder


Setting up the trigger for remote recording in Hand Engine and Vicon Shogun simultaneously

  1. Find and apply the remote recording trigger Python scripts which can be downloaded here:

    Hand Engine Animator Version - Click Here
    Hand Engine Studio Version - Click Here
    
  2. Place these script files in the following path: 

    C:\Program Files\Vicon\ShogunLive[Version Number]\SDK\ShogunLiveAPI\sample_scripts

  3. From here you can follow the Open Command Prompt, type cd, and paste the file location where the scripts are saved, for example: 

    C:\Program Files\Vicon\ShogunLive[Version Number]\SDK\ShogunLiveAPI\sample_scripts

  4. Type in the following command and hit Enter to start recording in Hand Engine. If successful, you will see a red pulsing light next to Recording in Hand Engine. In Vicon a Capture will be Started.

    python start_capture.py --port=3000 --name="TakeName" --host="127.0.0.1" 

    NOTE:
    a)
    The port and host can be changed to where Hand Engine is running (you can check them in the Hand Engine URL in the browser). If you don’t specify the host and port then the default (127.0.0.1 & 3000) will be used.

    b) The “TakeName” part can be changed to how you would like the take to called.


  5. To stop recording in HE and Vicon Shogun, type the following command line and hit Enter. If successful, you will see the red light next to Recording turned off. The scrips will run checks for every glove connected in Hand Engine. 

    python stop_capture.py --port=3000 --host="127.0.0.1"

  6. The recording location for Hand Engine takes can be found under Settings > Browse Recordings.


Disclaimer, Intellectual Property, and Licensing




Revision Summary

Revision

Date

Notes

3

2021.06.14

Added script for HE and Vicon Shogun simultaneous trigger and detailed steps.

2

2021.05.13

Added script for HE trigger only, screenshots and detailed steps.

1

2021.03.25

Initial version.