Object Tracker User Guide

Version 1.1 | Published November 15, 2022 ©

Tracking Data

The tracking data arrives from the Viz Tracking Hub through the VizCommunication shared memory map.

images/download/attachments/105109836/trackingdataengine.png

The prefixes are given by the rig names in Tracking Hub, in this sample tracking1 and tracking2.

  • PX and PY are normalized coordinates in the range [-0.5, 0.5], where 0.0 represents the center of the screen.

  • PZ is 0 when there is no tracking and 1 when tracking is valid.

  • RX is the height of the bounding box and can be used to position the graphics. This value a normalized percent value of the image width (a value of 0.1 means 10% of the screen width).

  • RY is the width of the bounding box and can be used to position the graphics. This value a normalized percent value of the image height (a value of 0.1 means 10% of the screen height).

    Note: The bounding box values RX and RY are more heavily filtered and might lag a little bit. The values might be 0 in some cases, for example when manual or simple tracking is active.

  • RZ gives an indication over tracking quality, 1.0 is the best quality. When the quality drops below 0.5 or less the quality begins to become critical and tracking might be lost soon.