Important Changes Compared to Previous Versions

• Activation of lens distortion does not depend on other settings, such as render_scale or entering Virtual Studio mode.

• You can explicitly select the algorithm and parameter source per camera, also in Viz Artist. There is an auto mode, which attempts to determinate the correct algorithm and parameter mode based on the available data.

• Now called Lens Distortion instead of Lens Deformation.

• render_scale is now correctly applied to FieldOfView. There is no longer a jump when enabling or disabling post processing (PP) in the Scene Editor.

• Previous versions rejected distortion values if the distortion was too strong, if pixels from the outside of the rendered area would have been moved inside the visible area. The render_scale defines how much of the border around the visible area should be rendered, to be able to “move” parts from outside to the inside - think of the barrel distortion! If distortion values were too high, and non-available pixels from the outside would have been distorted into the screen, it simply used the last valid distortion parameters instead. This could lead to confusion, as the distortion did not use the real values. Now, the distortion uses the values provided, even if some invisible areas show up on the borders. If you see unexpected black or transparent areas around the border, consider increasing the render_scale. You can do this by editing the entry for render_scale in the configuration file. The default value is 0, but you can change it as an example to 1.2 or even higher.

• New distortion algorithms:

  • Radial: A classic algorithm.

  • Stype and Trackmen: Implemented according to specifications from tracking data providers.

Distortion Algorithms

• Distortion Mode

  • Inactive: Does not use a distortion algorithm.

  • Auto: Automatically selects one of the algorithms below, depending on available data.

  • Internal: The internal distortion algorithm used in 3.8.x, when reading data from lens file. It uses a forward calculation, using a mesh with the undistorted render result applied as texture. The result then gets distorted by moving the vertices of the mesh. To calculate the distorted position of each vertex, the inverse formula as proposed in the Brown-Conrady model is used in an iterative approach. The distortion is normalized to the resolution.

  • Libero: The distortion algorithm used in 3.8.x when connected to Viz Libero or Viz Arena.

  • Xpecto: The distortion algorithm used in 3.8.x with external data, similar to the Internal approach but normalized to the chipsize.

  • Radial: Radial lens distortion, based on the Brown-Conrady model. See https://en.wikipedia.org/wiki/Distortion_(optics)#Software_correction.

  • Stype: Lens distortion as expected by Stype, based on the Brown-Conrady model. This method uses a backward calculation, rendering a full screen rectangle with modified texture coordinates, so that we look up in the undistorted texture for each pixel in the final output (distorted space).

  • Trackmen: Lens distortion as expected by Trackmen, based on the Brown-Conrady model. This method uses a similar approach like Stype.

Parameter Providers

• Parameter Mode

  • Auto: Automatically selects one of the providers below, depending on the received data.

  • Lensfile: Reads zoom/focus from external and calculates all other parameters from lens file.

  • Libero: Reads K1/K2 from Viz Arena or Viz Libero.

  • Manual: Uses parameter from the configuration settings.

  • Tracking Hub/VIZIO: Reads parameters from Tracking Hub or VizIO (legacy)

Configuration File Flags