Skip to content

OpenTrackIO source

The OpenTrackIO11 source receives an OpenTrackIO stream over the network (UDP, port 7000 by default), from a camera such as the Sony FR7 or from another tracking system. One stream can carry a pose, the lens encoders, the calibrated lens and a timecode: RigFX can use each of them.

What it publishes

Channel type Source channel Where to use it
3D pose source/opentrackio/pose A node on the Rig page (the PTZ node of the FR7 presets): the camera pose, see Pose and transforms
3D pose, one per transform source/opentrackio/tf/1, tf/2 … A node that follows one stage of the sender's rig, see Pose and transforms
FIZ source/opentrackio/fiz FIZ source of the Lens page
Lens source/opentrackio/lens Lens Source mode of the Lens page: the calibrated lens, passed through (Pipeline 3)

Its timecode can also be the unit's timecode: Sync → Timecode source.

Pose and transforms

An OpenTrackIO11 stream gives the camera pose as a list of transforms, from the studio origin to the camera: a tripod, then a head, then the camera, for example.

  • One transform, as a Sony FR7 sends: it is the camera pose, as sent.
  • Several transforms: RigFX combines them in order into the camera pose, the way it combines the nodes of its own rig. A RigFX unit whose output sends Chain transforms is read back as that unit's camera pose.

source/opentrackio/pose is this camera pose. Each transform is also offered on its own, source/opentrackio/tf/1, tf/2 … in the order of the list, so a node can follow one stage of the sender's rig (its head only, for example). The Rig page lists them under OpenTrackIO with their number and the name the sender gives them, once the stream carries two transforms or more. Transforms are taken in the order they arrive; their names are only shown.

Setting up the sender

  1. Connect the sender to the same network as RigFX (Network).
  2. In its settings, send OpenTrackIO to the IP address of RigFX and the port set on the card (7000 by default).

For a Sony FR7, see step 6 of the e-Jibo + FR7 underslung tutorial: its own position offsets stay at zero, the rig in RigFX places it.

Source card

In Settings → Source → OpenTrackIO Source:

OpenTrackIO source card

Field What it does
Buffer (frames delay) How many frames to delay the OpenTrackIO11 values (0–10), to line them up with a slower source on the same rig.
Status LED + label, see Status states.
Port UDP port RigFX listens on (1–65535, default 7000). Must match the sender's port.
Enable Turns the source on and off. The source is off on a new unit.
Transforms While packets arrive: how many transforms the stream carries, then a table of each one as sent (#, Name, X, Y, Z in metres, Pan, Tilt, Roll in degrees) and, with two or more, a Camera row: the camera pose they combine into.
Timing When the source is enabled: the packet rate and when packets arrive after the sync pulse. Phase view › opens the Phase View.

Status states

LED Label Meaning
Off Disabled The Enable toggle is off.
Amber No Data Enabled, but no OpenTrackIO11 packet is arriving.
Green Connected Packets are arriving.

Troubleshooting

Status stays at No Data
  • Check that the sender sends to the IP address of RigFX and to the port shown on the card.
  • Check that RigFX and the sender are on the same subnet.
Some packets are drawn orange in the Phase View
  • They arrive after the Phase offset12 and are used one frame late. Raise the Phase Offset in Settings → Sync until they land before it (Phase View).
The camera pose is not where the sender's camera is
  • Look at the Transforms table on the card: the Camera row is the pose RigFX uses. Each row is a transform as sent; if one of them is unexpected (a zero offset, an axis flipped), fix it in the sender.
  • To use only part of the sender's rig, bind the node to one transform (source/opentrackio/tf/N) instead of source/opentrackio/pose.
The OpenTrackIO timecode is not used
  • The status beside the Timecode source selector says why: no stream, no timecode in it, or a frame rate different from the unit's (Sync → Timecode source).