To Add and Configure a Tracking System

1. Click .

2. Type a Name for the configuration.

3. Select which protocol to use to receive data from the tracking system:

   • FreeD (see Description of the FreeD protocol)

   • RTHead

   • XML Tracking: A special feature, a self-definable protocol for special solutions

   • Motion Analysis

   • mo-sys

   • Trackman

   • Vicon

   • Libero

   • CanonLens (Zoom and Focus driver for canon lenses)

   • Spidercam

   • Flair

   • Thoma

   • Stype A5

   • Stype HF

     Note: If changing the protocol of an already configured tracking system, the default configuration parameters for the new protocol will be read by the system.

4. Select a connection type. Depending on the tracking system select the connection type:

   • Serial: If serial is selected, also select a Comport (in the Comport box, all available comports are shown). If the default baud rate is not used, enter the correct one in the baudrate field

   • TCP/IP: Type in the Host IP to use (possible port as well)

   • UDP: Type in a Port number to use

5. Right-click on the Tracking Systems box and select Connect (connect to the tracking system).

   

   The Tracking Hub now connects to the selected Tracking System. Observe the colors on the bottom of the symbol:

   • Green: Connection is done and data receiving in time

   • Orange: If the color becomes orange, after a few seconds, connection is done and data receiving, but not in time

   • Red: If the color becomes red, possible connection failure or data is not received.

6. Go to Configure a Rig.

To Analyze Tracking System Time

1. Right-click on the Tracking System that is to be analyzed and select Analyze Timing.

   

   This adds a new element to the Services panel, called TrackingTiming.

2. Click on the TrackingTiming Service element. In the Properties panel, make sure that:

   • The IP of the local PC is inserted, and

   • The service is set to Active.

To Analyze a Service Time

1. Right-click on the Service System that is to be analyzed and select Analyze Time.

   

   This adds a new element to the Services panel, called TrackingTiming.

2. Click on the TrackingTiming Service element. In the Properties panel, make sure that:

   • Make sure the IP of the local PC is inserted, and

   • The service is set to Active.

To View Timing Information

1. In the Configuration Panel, click the View Timing Analysis button .
   In a Timing panel with a correct data stream:

• Purple line: Shows the time when the Tracking Hub has inserted a data package from the tracking system into the data pool

• Green line: Shows the time when the communication part of the Tracking Hub starts to read from the data pool

• Red Dot: Indicates data sent to a Viz Engine has stopped

Upper Section

In the upper section, the first line is the timing of live tracking data.

These timestamps are shown:

Sync:

• Start RX: Start time, when data is received from the tracking system

• End RX: End time, when data stops from the tracking system

• Start Ins: Start time, when Tracking Hub inserts received data into the parameter pool

• End Ins: End time, when Tracking Hub has finalized inserting data
  Orange Dot: Sync Timestamp

Blue: The time between Start RX and End RX

Purple Line: The time between Start Ins and End Ins

Line 2: Shows when the live tracking data is processed and sent to the Viz Engine.

• Start Calc: The start time. When tracking data is calculated and prepared for a Viz Engine, this time is defined from send delay. After this delay has passed the Tracking Hub starts with this procedure for calculation and sending data

• End Calc: The end time. When tracking data preparation is finished

• End Send: Time when data has been send to the Viz Engine
  Green Line: Time between Start Calc and End Calc

Red Dot: End Send Timestamp

Lower Section

The lower part shows the last ten second history of the timing. Three timestamps are shown.

• End Ins: As time, when receiving is finished (purple (1))

• Start Calc: When data processing starts (green (2))

• End Send: When Tracking Hub work is finished for this field (red (3))
  To get the optimal timing, the Start Calc time must be later than the End Ins time, for every field. To achieve this, the send delay has to be adjusted correctly.

The white line shows the delay. This line should be the absolute border between End Ins (purple line) and Start Calc (green line). To change the delay, use drag and drop to move the white line.

If the delay can not be adjusted correctly, this can be for several reasons, for example, tracking data is received too late.

This doesn't matter so much, because in normal production you need more the one field tracking delay.

Re-using Lens Ranges from Older Version Lens Files

The lens range in Tracking Hub is from 0 to 1. For setups used with software preceding the Tracking Hub, such as Viz IO, the lens files may have used lens ranges specified slightly differently, such as from 0.01 to 0.99. The Tracking Hub is capable of adapting to such a lens range. To achieve this, the lenserange parameter in the studio configuration file needs to be entered manually.

To Modify a Rig

1. Right-click on a Tracking System. Select Connect to a rig.

2. The Tracking parameter routing window opens.

   

   • The Tracking System panel shows all the parameters that can be tracked

   • The Rig panel shows the Rig connections

3. If a Tracking System parameter does not equal a Viz Engine parameter, a Viz Engine parameter can be modified to adapt to the Tracking System parameter. Click on a Viz Engine parameter and drag to its new position, as required. If a red cross shows, after a parameter has been modified, it means that the connection is still valid, but the connection is now a cross-over connection and not a straight one.

   

4. In the Offset column, define an offset to each parameter. The values are given in cm or degree ( value with dot). The values are stored when the field loses focus.

5. In the Delay column, enter how many fields sending of the parameter should be delayed.

6. Click on a box under Connected to connect a parameter through the Rig.

7. Click OK.

No Tracking Parameters

If the Tracking parameter panel empty, there are no tracking parameters delivered from the tracking system.

1. Check what the icon of the tracking system shows (disconnected or connected, color, etc.)

2. Check all connectors until the required connections show in the Tracking Parameters panel.

3. Go to To Modify a Rig