/
Set up camera transforms and lens distortion

Set up camera transforms and lens distortion

Owned by Adaptavist ScriptRunner for Confluence Cloud (Unlicensed)
Last updated: Jan 13, 2025 by Gisela Roberts

This page covers how to set up camera transforms and lens distortion.

Prerequisites

To set up camera transforms and lens distortion, ensure you have set up and installed the following components:

  • 1 x PC with Vicon software (Shogun) installed
  • 1 x PC with Unreal Engine 5 (UE5) installed
  • The PCs are connected via LAN
  • Vicon Live Link Datastream plugin is installed and enabled on Unreal Engine 5 (see Install and set up a Live Link)
  • SDI set up in Vicon software and Unreal Engine
  • A UE5 project is open
  • A Live Link source has been created and is currently connected to UE5.

Set up camera tracking in Unreal Engine

  1. Open UE5 and open a project.
  2. In the Actor Placement panel, search for CineCamera, add it to the scene, and zero out the position of the camera.
  3. In the World Outliner, select CineCameraActor and then select Add Component.

  4. Find and add a component called Live Link Controller.

  5. Select the new LiveLinkComponentController and in the Subject Representation, select the name of the camera subject.

  6. In the Camera Role field, select Live Link Vicon Camera Controller.

  7. In the Component to Control dropdown select CameraComponent.

  8. Select CineCameraActor and in Filmback > Sensor Width/Height set the width and height to match the camera's sensor size.

The Output Log notifies you if the aspect ratio did not work for automatically setting the focal length.

Set up lens distortion on a CineCameraActor in Unreal Engine

Important
Ensure you have completed the previous section (Set up camera tracking in Unreal Engine).

  1. Select the CineCameraActor, and in the Details panel add a Lens component.

  2. In the Distortion Source drop-down, select Live Link Lens Subject.

  3. At the top of the CineCameraActor section, click Live Link Component Controller section, and in Lens Role > Component to Control, set the Component Picker to the Lens component.

  4. Select the Lens component, go to Distortion, and select the Apply Distortion checkbox.

Set up lens distortion in Composure in Unreal Engine

Important
Ensure you have completed the previous sections (Set up camera tracking in Unreal Engine and Set up lens distortion on a CineCameraActor in Unreal Engine).

On the Composure Layer tab, complete the following steps for each CG Layer.

  1. Select a CG Layer.

  2. In the Details panel, expand LensDistortion and select Apply Distortion.

  3. Set Lens Component to the CineCamera Lens created in the previous section.

For information on how to add actors to CG Layers, see Real-Time Compositing Tools in the Unreal Engine documentation.

Tip
After you have followed these steps, if the props are misaligned with their real world counterparts when you view the final composure, go back to Shogun and recalibrate the SDI. This realigns the final composure.

Related content