Trackers - acidbubbles/vam-embody GitHub Wiki

Trackers Screen

Fields marked with a * suffix will be loaded from your profile rather than from the scene if the Use Profile toggle is on.

This module is responsible for tracking your head, hands and Vive trackers. It also integrates with Leap Motions for position and/or fingers.

The Tracker menu lets you choose between the VR headset (Head) the VR controllers (LeftHand, RightHand), and the Vive Trackers (ViveTracker1..8), if they are detected.

The concept here is to "map" a tracker (VR headset, VR controllers and vive trackers) to a control (a node on the VR person, such as the left hand, the right foot, the head, etc).

When activated, the node will be "possessed", therefore VaM will do things like On Possess Deactivate Other Controllers Listed Here, which can be surprising if you didn't expect that.

Left Column

  • Map to control (only for vive trackers) will let you select which control should the tracker be mapped to. Use Map to Closest Control and Align to Mapped Control to automatically bind them.
  • (Tracker) Enabled determines whether the tracker will actually affect the mapped controller or not. For example, if you turn that off for Head, when activating Embody, you will not be teleported, and your head will not control anything.
  • Fingers Tracking (only for hands) determines whether fingers will move when you use Grab; if you have a Leap Motion, it will also allow controlling individual fingers.
  • Position Tracking (only for hands) can be turned off you you want to animate fingers only using Leap Motion.
  • Use Leap Motion Position (only for hands) lets the Leap Motion control the hand position. When off, the VR controller will control the hand position.
  • Controls position / rotation (only for vive trackers) allows disabling rotation or position affecting the mapped control.
  • Keep physics hold strength avoids having the spring changes when activating Embody. When off, the spring will be greatly increased so movements are faithfully reproduced in VR, but if you wish to tweak this manually, turn this on.
  • Offset will move the mapped control in relation to your tracker.
  • Rotate Controller will rotate the mapped control in relation to your tracker..
  • Rotate Around Tracker allows you to move and rotate the mapped control around your VR tracker.
  • Sync to other hand (only for hands) will automatically apply all settings to the other hand.

Settings

  • Use Profile will use your saved profile when loading this scene rather than the current values. Leave this one to allow other people to load with different settings.
  • Restore Pose After Possession will restore the person's pose when deactivating Embody. Also applies to Passenger.

Utilities

  • Preview offset in 3D will display the offset (distance) between the different trackers and where the mapped control will be, it can help better visualize what the different sliders do. The preview has three small colored boxes which represent the x, y and z axis of the source tracker and the mapped control.
  • Enable Hands lets you quickly enable and disable both hands; it's a shortcut for the Enabled toggle on both hands.
  • Align All Vive Trackers is a shortcut to do Map to Closest Control and Align to Mapped Control on all vive trackers at once. You will have 5 seconds to take the model's position.
  • Map to Closest Control (only for vive trackers) will automatically assign the vive tracker to the nearest control.
  • Align to Mapped Control (only for vive trackers) will save the offset and rotation. To use it, first align the desired vive tracker to the control you want to map it to, and click this button.