Object Tracker User Guide

Version 1.0 | Published June 09, 2022 ©

Tracking Hub Configuration

General

You need at least Tracking Hub Version 1.5 installed. Copy the file xml_objectTracker.xml into the Tracking Hub XMLTracker directory (typically in C:\ProgramData\vizrt\VizTH\XMLTracker) After this operation restart the Tracking Hub.

Create a Configuration from Scratch

images/download/attachments/95389020/thsourcerig.png

Create a new Tracking System and configure it as seen above.

  • Set the Protocol to xmltracking.

  • Set the Connection to UDP.

  • Set the Port to 7100 (representing the first tracking object), use port 7101 for the second tracker and so forth).

  • Set XMLFile to xml_objecttracker.xml in the drop down menu.

Services Rig

Under Services select Add Object to create a new Object Service.

images/download/attachments/95389020/addobject.png

Rename the service tracking1 (for the first tracker, use tracker2 and so forth for any additional trackers). This is the name that is used in the Shared Memory on Viz Engine and in the scene to reference the tracker.

images/download/attachments/95389020/renameservicerig.png

Connect the tracking service to the newly created Object Service like this:

images/download/attachments/95389020/rigconnect.png

Map the tracking parameters as follows:

  • tsX_height: Tilt

  • tsX_width: Pan

  • tsX_quality: Roll

  • tsX_posx: PosX

  • tsX_posy: PosY

  • tsX_valid: PosZ

In the Services column, add an Object Service.

images/download/attachments/95389020/addobjectservice.png

Configure the Object Service

Click the + symbol under the Rig label and select the rig from the middle column (for example, tracking1).

images/download/attachments/95389020/servicerig.png

Select as IP the Viz Engine destination, tracking port should be the shared memory UDP communication port as it is configured on the Viz Engine, command port of the engine (typically 6100).

images/download/attachments/95389020/engineshmudp.png

Viz Engine’s Shared Memory configuration, pick any free port number (e.g. 6102).