Skip to content

Concepts and editions

RigFX is built around four concepts. Understand these and the rest of the docs fall into place. Which firmware edition your unit runs is at the end of the page: Editions.

  1. Sources — what feeds data into the hub (FIZ5, lens, 1D motion1, 3D pose13).
  2. Camera Rig — the kinematic chain that produces a single 3D pose13.
  3. Lens — turns FIZ (focus, iris, zoom encoders) into resolved lens parameters, or passes through a lens source.
  4. Camera tracking output — merges rig + lens and streams the result.

How it all fits together

1 Sources feed pose and *1D motion*^[1](../../pages/reference/glossary.md#term-1)^ to 2 the Camera Rig, and FIZ or lens data to 3 the Lens. The rig gives the camera pose and the lens gives the lens data to 4 the tracking output, which sends *FreeD*^[6](../../pages/reference/glossary.md#term-6)^ or *OpenTrackIO*^[11](../../pages/reference/glossary.md#term-11)^ to the render engine.

1 — Sources

What feeds data into RigFX

A source is anything publishing data into the hub. Each one surfaces as a card in Source and exposes typed channels — 3D pose13, FIZ5, Lens, or 1D motion1 — that downstream stages bind to.

Which sources each firmware has, and what each one gives: Sources by firmware.

2 — Camera Rig

Kinematic chain that produces the final pose

A list of 3D pose nodes that chain transforms together. Each node binds to one of:

  • a manual value (fixed offset),
  • a 3D pose13 channel from a source,
  • a 1D motion1 channel from a source (e.g. a Cartoni encoder driving translation along an arm).

The accumulated pose at the end of the chain feeds the output stage. Build it on the Rig page.

3 — Lens

FIZ + lens file, or pass-through

The lens stage produces resolved lens parameters (focal length, focus distance, Entrance pupil4, distortion, projection offset). Two flows:

  • FIZ + lens file — bind a FIZ5 source and a .mrxlens calibration file; RigFX evaluates on-device.
  • Pass-through lens source — bind a source that already publishes resolved lens data (e.g. OpenTrackIO upstream).

Configure it on the Lens panel; see the Lens pipeline reference for the valid flows.

4 — Camera tracking output

Merges rig + lens, streams to your render engine

Up to 3 destinations simultaneously, each picking from:

  • OpenTrackIO (recommended) — full pose + resolved lens.
  • FreeD D1 (legacy) — pose + FIZ5 only on the lens side (no resolved lens data).

Configure on Output; see Lens pipeline & outputs for the protocol details.

Editions

RigFX ships in two hardware form factors, RigFX Standard and RigFX Cartoni; RigFX Cartoni adds the encoder inputs. They all run the same core firmware: every edition has the base inputs, the lens FIZ input (sync card), FreeD6, OpenTrackIO11 and Canon CV. Each firmware then adds its own specific source: Kuper, Filmotechnic, OptiTrack or Cartoni.

The RigFX Standard hardware runs the Standard, Filmotechnic, Kuper and OptiTrack firmware, whose trackers come over Ethernet. The RigFX Cartoni hardware has the same connectors plus 4 Cartoni encoder inputs and runs the Cartoni firmware.

At a glance

Each edition is one firmware, with its own name. The table gives the name of each firmware file, where X.Y.Z is the version.

Edition Firmware name
Standard rigfx-firmware-vX.Y.Z-standard.hex
Cartoni rigfx-firmware-vX.Y.Z-cartoni.hex
Filmotechnic rigfx-firmware-vX.Y.Z-filmotechnic.hex
Kuper rigfx-firmware-vX.Y.Z-kuper.hex
OptiTrack rigfx-firmware-vX.Y.Z-optitrack.hex

The Standard firmware, and so every firmware, has: Lens FIZ (sync card), FreeD (3 inputs), OpenTrackIO, Canon CV.

The firmware name of a unit is shown in the web app under System, in the Edition field, and in the RigFX Firmware Updater once a firmware file is loaded. To change it, flash the firmware file of that name (see Firmware update).

Sources by firmware

Each source gives one or more of the four channel types the rig and the lens bind to: 3D pose13, FIZ5, Lens or 1D motion1 (Sources). Inputs marked "every firmware" are in every RigFX firmware; the others come with their firmware.

Source Pose3D FIZ Lens 1D motion Firmware
Lens FIZ (sync card) ✓ every firmware
FreeD (3 inputs) ✓ ✓ every firmware
OpenTrackIO ✓ ✓ ✓ every firmware
Canon CV ✓ every firmware
Cartoni encoders (4 channels) ✓ Cartoni
Filmotechnic (Technoscope, Flight Head, 7 encoders) ✓ ✓ Filmotechnic
Kuper (Kuper, Talon, Nano, up to 16 axes) ✓ ✓ Kuper
OptiTrack (Motive, one rigid body) ✓ OptiTrack

Inputs and rig presets