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.
- Sources — what feeds data into the hub (FIZ5, lens, 1D motion1, 3D pose13).
- Camera Rig — the kinematic chain that produces a single 3D pose13.
- Lens — turns FIZ (focus, iris, zoom encoders) into resolved lens parameters, or passes through a lens source.
- Camera tracking output — merges rig + lens and streams the result.
How it all fits together
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
.mrxlenscalibration 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.
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
- Every input, with what it gives, its connector or default port and its editions: Web app → Source.
- The rig presets each edition offers: Web app → Rig → Rig presets.