Viz Artist

Version 3.10 | Published May 03, 2018 ©

Lens File Editor

The Lens File Editor is used to create and change lens files used by the Tracking Hub for virtual sets. Use the Lens File Editor to calibrate lenses by adjusting the field of view, lens distortion and nodal points for the cameras in use for a virtual studio set.

This section contains information on the following topics:

Lens File Editor Workspace

images/download/attachments/27789874/onairmode_lens_file_editor.png

The Lens File Editor workspace consists of two areas; the visualization area (1) and control area (2). The size of the Lens File Editor window can be adjusted by dragging the arrow symbol in the lower right corner of the window frame.

images/download/attachments/27789874/onairmode_lens_file_editor_controls.png

The control area is organized in several sections, for ease of use. Information on the current modes and selected properties is displayed in the far left side of the control area (A) at all times. To the right of this section, the different modes (B) can be set:

  • Cursor Visible/off (B): When in Cursor mode and Cursor is set to Visible, a cross-hair with guiding lines will appear in the visualization area.

  • Cursor mode/Tracking mode (B): Use guiding cross-hairs if set to Cursor mode, or use tracking position data received from the tracking system when in Tracking mode.

  • ProbMode On/Off (B): If ProbMode is set to On when in free aspect ratio mode, the FoV Y value will update automatically according to changes to the FoV X value.

The next section (C) is used to select which parameter will be displayed in the visualization area (1):

  • K1/K2 (C): Click to display the current adjustments to the distortion values K1 and K2, respectively. The K1 and K2 values are used to correct for lens distortion.

  • FoVX/FoVY (C): The Field of View controls are used to define the field of view for the selected camera, for the X and Y planes, respectively.

  • Cx/Cy (C): The center shifts when zooming out due to imperfect mount of lens on camera body. Corrections to the center shift are derived from the values given here for the X and Y planes, respectively.

  • Nodal (C): Click to display the configured nodal point for the current lens setup. The Nodal point changes when changing zoom and focus, and can change with as much as up to 20 centimeters for most broadcast lenses.

The middle section (D) is used to change the resolution and zoom level in the visualization area, as well as saving and loading lens files:

  • S+/S- (D): Increase or decrease the value resolution of the visualization area (1).

  • Z+/Z- (D): Zoom in to or out of the visualization area (1).

  • Save/Load File (D): Save the current setup to a new lens file or load a previous setup.

The next three sections (E, F and G) display the numeric representations of the current field of view, lens distortion, nodal point and linear scaling. The values are automatically updating when adjustments are made to the splines within the visualization area. Values can also be manipulated directly by clicking and holding the value to be adjusted, then dragging the mouse left or right to adjust the value up or down, respectively:

  • FovY/FovX: Displays the current Field of View values for the X and Y planes.

  • K1/K2: Displays the current lens distortion values.

  • Nodal: Displays the current nodal point value.

  • Sc Y W: Displays the linear scaling Wide value for the Y axis, for field of view adjustments.

  • Sc X W: Displays the linear scaling Wide value for the X axis, for field of view adjustments.

  • Sc Y N: Displays the linear scaling Near value for the Y axis, for field of view adjustments.

  • Sc X N: Displays the linear scaling Near value for the X axis, for field of view adjustments.

The far right section (H) is used to select the aspect ratio for the current lens:

  • NONE: Free aspect ratio.

  • 16x9 y: Set aspect ratio to 16:9

  • 16x 9 x: Set aspect ratio to 16:9

  • 4x3: Set the aspect ratio to 4:3

Lens File Editor Contextual Menu

Click and hold the right mouse button anywhere in the visualization area of the Lens File Editor to bring up the contextual menu. Select an option by moving the mouse cursor and release the button.

images/download/attachments/27789874/onairmode_lens_file_editor_contextual_menu.png

  • Select Camera: Up to 16 cameras can be configured in the same lens file. Select which camera to modify settings for.

  • Parameter: Select which parameter to display in the visualization area:

    • K1, K2: Display splines for the lens distortion parameters.

    • FovX, FovY: Display splines for the field of view parameters.

    • CenterX, CenterY: Display splines for the center shift parameters.

    • Nodal: Display splines for the nodal point parameter.

  • Display Mode: Select the display mode for the visualization area:

    • Triangulation: The default view.

    • Grid: Display a grid overlay.

    • Cut Focus: Displays lines to check the curve quality.

    • Cut Zoom: Displays lines to check the curve quality.

      Note: The visualization area will not be automatically updated if making changes to parameters while Display Mode is in Cut Focus or Cut Zoom mode

  • Merge From: Copy settings from another previously configured camera (1-16).

  • Create: Create a new raw lens with 3x3, 5x5, 7x7 or 9x9 reference points. Vizrt recommends starting with a 3x3 configuration, then using the Insert option to add more reference points first after successful 3x3 calibration.

  • Insert: Insert more reference points. Available insertions are:

    • 5x5

    • 7x7

    • 9x9

To Create a New Lens

  1. In Viz Artist, click the On Air button.

  2. Click the Show Lens File Calibration Editor button.

  3. Right click in the visualization area and select Create, then 3x3.

  4. Select a parameter to bring up the spline editor for adjustments.