Skip to content

FreeD source

The FreeD6 source receives FreeD D1 packets over the network, from a PTZ camera, a robotic head, a slider or any tracking system that sends FreeD. It has three inputs, each on its own UDP port (40000, 40001 and 40002 by default), so RigFX can combine up to three FreeD systems in one rig (a PTZ on a slider, for example).

What it publishes

Each input publishes a pose and the lens encoders:

Input 3D pose13 channel FIZ channel Default port
Input 1 source/freed/0/pose source/freed/0/fiz 40000
Input 2 source/freed/1/pose source/freed/1/fiz 40001
Input 3 source/freed/2/pose source/freed/2/fiz 40002
  • Pose: bind it to a node on the Rig page. RigFX converts FreeD's units and pan direction to its own axis convention. Each axis is also offered on its own (source/freed/0/pose/x … /roll), to bind only one of them, the tilt for example, to any field of a node.
  • FIZ: the raw zoom and focus encoder values the sender puts in its packets, for the FIZ source of the Lens page. Iris is not part of the FreeD protocol.

Setting up the sender

  1. Connect the sender to the same network as RigFX (Network).
  2. In its settings, send FreeD6 over UDP to the IP address of RigFX and the port of one input (40000 for input 1).

Source card

In Settings → Source → Freed Source:

FreeD source card

Field What it does
Buffer (frames delay) For the three inputs: how many frames to delay the FreeD6 values (0–10), to line them up with a slower source on the same rig.

Then, for each input:

Field What it does
Status LED + label, see Status states.
Port UDP port the input listens on (1–65535). Must match the sender's port.
Filter Cam ID When on, the input keeps only the packets carrying this camera ID (0–255). Use it when several FreeD6 senders share one port.
Enable Turns the input on and off. The inputs are off on a new unit.
Lens auto range How the Lens page turns this input's raw zoom and focus into a 0–1 position, see Lens range. On by default. Reset forgets the learned range.
Zoom / Focus / Iris Min and max raw value of each lens axis. With Lens auto range on, zoom and focus show the range learned from the sender and only iris is edited.
Timing When the input is enabled: the packet rate and when packets arrive after the sync pulse. Phase view › opens the Phase View.

Lens range

FreeD6 sends zoom and focus as raw numbers with no fixed scale, so RigFX needs the value at each end stop to know where the lens is.

  • Lens auto range on: RigFX learns zoom and focus from the lowest and highest values it receives. The learned range is not saved: after each power-up, run zoom and focus from one end stop to the other before shooting. Until then the lens reads only part of its travel.
  • Lens auto range off: enter the raw values the sender puts out at each end stop. They are saved, stay valid after a power-up and show as Cal Min / Max on the Lens page. To find them, turn the lens to each end stop and read the raw value on the Lens page.

Iris always uses the range entered here. Cal Min / Max on the Lens page take priority over both.

Status states

LED Label Meaning
Off Disconnected The input is disabled.
Amber No Data Enabled, but no FreeD6 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 of this input.
  • With Filter Cam ID on, check that the camera ID matches the sender's.
  • 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 offset and are used one frame late. Raise the Phase Offset in Settings → Sync until they land before it (Phase View).
Focus or zoom reads 0 or a wrong value after a power-up
  • With Lens auto range on, run zoom and focus from one end stop to the other, or turn it off and enter the range (Lens range).
An axis turns the wrong way in the 3D view
  • On the Rig page, bind the axes one by one and toggle Negate on the one that is reversed.