To allow Live Link to control virtual camera parameters, we need to assign a Lens File to Live Link Camera Controller.

  1. Enable Live Link source. For more details, see Connecting to Mars using the Live Link Plug-in.

    Untitled

    <aside> <img src="/icons/light-bulb_orange.svg" alt="/icons/light-bulb_orange.svg" width="40px" /> TIP: If VIVE Mars isn’t appearing in Live Link panel, please refer to Why isn’t VIVE Mars appearing in Unreal Live Link? to troubleshoot.

    </aside>

  2. If you are using an external encoder for lens curve setup please check below items, or you can skip to step 3.

    1. In order to confirm the focus data is being received, select the subject under ViveLiveLinkPlugin. Change to the View Options to Show Frame Data.

      Untitled

    2. Check Focus Distance there should be a numeric value when you rotate the focus ring with lens encoder on your camera.

      Untitled

  3. In the World Outliner panel, select CineCameraActor and apply the component LiveLinkComponentController. Assign the Rover in Subject Representation.

    Untitled

<aside> 💡 WHEN USING UNREAL 5.1 or newer versions

Enable LiveLinkCamera Plugin and restart your Engine.

Untitled

Add Livelink Controller and Lens Component for CineCameraActor.

Untitled

Select LivelinkComponentController in the Details Menu, pick a Rover that represents the movement of the camera in real world from the drop-down list of the Subject Representation.

Untitled

Under Live link Controller > Transform Role > Component to Control > Component Picker > select SceneComponent.

Untitled

<aside> <img src="/icons/light-bulb_yellow.svg" alt="/icons/light-bulb_yellow.svg" width="40px" /> Since Live Link now controls the transform of SceneComponent, please make sure the transform of CameraComponent is reset to it’s default values( 0,0,0 for position/rotation, 1,1,1 for scale).

resetCameraComponentTransform.png

</aside>

Under Camera Role apply LivelinkCameraController.

In the same detail menu scroll down to select Camera Role > Component to Control > Component Picker select CameraComponent

Untitled

To apply lens file to Camera Role, ****expand Camera Calibration of Camera Role, go Lens File Picker to add lens file (must be the same lens file as the step below).

Untitled

To apply Lens file select the Lens component. In the Details Menu go Lens File to apply your Lens. Under Evaluation Mode select Use Live Link.

image.png

<aside> 💡

For “Use Live Link” mode to work properly, you have to connect at least two FIZ Tracks (or other compatible encoders) to both Focus and Zoom port of the Rover and have properly calibrated and mapped the values of FIZ Tracks in the lens file above.

If you are using a prime lens and have connected only one FIZ Track to the Focus port of the Rover, you won’t receive any FIZ data from LiveLink, it’s a limitation of Unreal Engine. To walkaround this limitation, we have to use LiveLink FreeD instead.

  1. Enable "LiveLink FreeD" under plugin tab and restart Unreal Editor to apply changes.

image.png

  1. Duplicate(Or save as) the original lens file to a new one, freeD will normalize input focus data to range 0~1, we need to modify focus mapping to adopt that.
  2. Remember the original focus input values, divide them by the max input value in the mapping curve, then replace old data points with the new ones, you need to add new data points then delete old ones.

image.png

image.png

  1. Enable FreeD protocol on the Mars, from the Network button, enable at least one FreeD connection and type in the PC IP address of the Unreal PC, using default port 40000, if you are using a router, you can set the last mask of the PC IP address to 255 to let it broadcast to all devices connecting to the same router.

image.png

image.png

image.png

  1. Add LiveLink freeD source under livelink tab of Unreal Editor, using the actual IP address of your Unreal PC.

image.png

  1. Under freeD settings > Focus Distance Encoder Data enable "Use Manual Range" and type in the range of the encoder raw value.

image.png

  1. Select the FreeD subject under LiveLinkComponentController.

image.png

  1. Replace the lens file with remapped one for both LiveLinkComponentController and LensComponent.

  2. Under LensComponent set the evaluation mode to "Use Live link".

  3. Turn on Draw debug focus plane under CameraComponent to check if focus distance matches the evaluated value of the lens file.

    2025-08-04 15-17-42.mp4

</aside>

Under Filmback Override for Lens Details, click on Lens File

Untitled

</aside>

  1. Select LivelinkComponentController in the Details Menu, pick a Rover that represents the movement of the camera in real world from the drop-down list of the Subject Representation.

    Untitled

  2. To apply Lens file in UE 5.0, in the Details panel of CineCameraActor, select component LivelinkComponentController. In CAMERA ROLE > Camera Calibration > Lens File Picker > Lens file, select the lens file you created.

    Untitled

  3. Make sure to click on Apply Distortion in Background or foreground CG layer Details. Lens File setting will not apply automatically for Composure components.

    Untitled

https://embed.notionlytics.com/wt/ZXlKM2IzSnJjM0JoWTJWVWNtRmphMlZ5U1dRaU9pSnZjRlk0UVVOa2JFSndhemhYWmxvek1tYzVaU0lzSW5CaFoyVkpaQ0k2SWpCaVpXSmtNak01WW1FMVpEUXpOMlE1TmpOa1pqSTJNVFE0WVdReFpHWXpJbjA9