Skip to content

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

Lens & Camera card in FIZ Source + Lens File mode: FIZ source, lens file and the focus, iris, zoom gauges

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)

The lens file slots of the Lens page

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

Lens & Camera card in Lens Source mode, the lens coming from OpenTrackIO

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.

The CalibFX calibration board, Board A, standing on the floor and turned at an angle: a white plate with rounded corners, AprilTag markers of three sizes, the large ones around the edge and the smallest in the centre, and the CalibFX logo in the top left corner
The CalibFX calibration board (Board A)
CalibFX Lens
CalibFX Lens