Lens
The Lens page is where you turn raw FIZ encoder values into resolved lens parameters that your render engine can use, or select a lens source that is already resolved.
Modes
The Mode selector on the Lens & Camera card picks one of two modes. Which one you need depends on where the lens calibration lives: the three cases are drawn in Reference → Lens pipeline.
| Mode | What RigFX does | Use when |
|---|---|---|
| FIZ Source + Lens File | Reads FIZ5 from a source and, if a lens file is chosen, evaluates it on the unit to get the optical values. | Your lens has encoders (servo unit, follow-focus, FreeD6), with or without a RigFX lens file. |
| Lens Source | Takes the lens as an upstream source sends it, already calibrated (OpenTrackIO11, Canon CV). | Your camera or an upstream tool provides the calibrated lens. |
Mode: FIZ Source + Lens File
The card shows the FIZ source and the lens file side by side, and one gauge per ring: the normalised value (0–1) with the raw encoder count under it, and below each gauge the optical value the lens file gives for it (focus distance, f-stop, focal length).
FIZ source
FIZ5 stands for Focus, Iris, Zoom encoders — the raw position of each ring on the lens.
FIZ data on its own tells you nothing about the optical properties of the lens, but it can drive a lens file to resolve the actual optical values.
On the lens card you select a FIZ source. It can be:
- Lens FIZ source (
source/lensfiz/fiz) — the lens plugged into the lens panel: on its source card you pick a Canon, Fujinon or Angénieux servo, an /i1 lens (Cooke, Zeiss, Fujinon), a cmotion or Preston follow-focus system, or the two external encoders (zoom and focus by default, any ring you choose). - FreeD source (
source/freed/0/fiz…) — FreeD carries focus and zoom encoders. Iris is not part of the FreeD6 protocol. - The FIZ of other inputs your firmware has (OpenTrackIO11, Kuper, Filmotechnic encoders).
In Advanced you can override the min/max encoder values (Cal Min, Cal Max) to get the full 0–1 normalised range: for a source whose encoders don't cover the ring's travel over 0–65535. The Lens FIZ source always does, external encoders included.
Sending FreeD: the FIZ source is enough
FreeD6 carries the raw zoom and focus encoder values, not optical values: the render engine applies its own lens calibration. For a FreeD output, choose the FIZ source and leave the lens file empty: the card then shows No lens file selected with a warning, which is expected here. This is Pipeline 1 — lens file on the render engine.
Choose a lens file when you send OpenTrackIO11 and want RigFX to resolve the lens itself (Pipeline 2).
Lens files
Up to 8 slots are available for lens calibration files. Lens calibration files use the .mrxlens extension and must be smaller than 20 KB each.
These lens files are produced with the CalibFX Lens solution. Each file contains data about the lens + camera combination:
- focal length
- focus distance
- aperture (f-stop)
- entrance pupil offset
- projection offset (center shift)
- distortion parameters (radial and tangential)
Click Load on an empty slot to upload. Slots persist across reboots.
On the lens card you can then pick one of the filled slots. At runtime the FIZ encoders drive the lens file mapping to dynamically retrieve the optical data of the lens.
Mode: Lens Source
In this mode you pick a source that directly provides calibrated lens data: OpenTrackIO11 (for example a Sony FR7) or Canon CV. Both publish all the fields of a calibrated lens, so RigFX passes them through as-is, with the rig pose added, to an OpenTrackIO11 output. This is Pipeline 3 — lens data from the lens itself. No lens file is used.
Advanced settings
In both modes, unfolding Advanced Settings shows all resolved parameters of the lens. Each parameter can be overridden — click the small pencil icon at the corner of the field. An orange frame appears around the field while the override is active. The override stays on until you click the pencil again.
Notes
About distortion
RigFX uses the OpenTrackIO11 convention for the distortion model: Brown-Conrady D-U (distort-to-undistort direction), with radial coefficients in units of mm⁻², mm⁻⁴ and mm⁻⁶.
Lens profile with CalibFX Lens
A lens file is only as good as the calibration behind it. To profile your own lens and camera, we recommend CalibFX Lens: film the CalibFX calibration board with your camera and lens at different zoom and focus positions, and CalibFX Lens solves the lens (focal length, focus distance, Entrance pupil, projection offset, distortion) and exports the .mrxlens file that you load in a slot of the Lens files above.




