/
Visualize marker data

Visualize marker data

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

This page covers how to set up the Vicon Marker Visualizer Component in Unreal Engine. This involves adding a component to an actor and configuring the Live Link Subject Representation.

Note
If your data has high marker counts, we recommend that you do not use the Vicon Marker Visualizer Component at run time as this can impact performance

To control the look and behavior of the visualized markers, you can use additional options.

Note
When you're using Marker Data, consider the following points:

  • Props and objects tracked using the Object Tracker method do not have marker data. This is because the tracking does not reconstruct markers.
  • Object tracking is enabled in Shogun Live. For more information, see Understand object tracking in Shogun Live.
  • Subjects that have Vicon Retarget applied to them do not have marker data either and only their retarget skeleton is streamed.

Configure the Vicon Live Link Connection

  1. Set up the Live Link source by following the steps outlined in Connect to Vicon Datastream Using Live Link.
  2. After you have set up the Live Link source, select Window > Virtual Production > Live Link.
  3. Click on the new Live Link to open the settings panel.

  4. In Data Stream Settings, clear Enabled Lightweight.

  5. In the same settings panel, in Advanced, select Stream Marker Data and optionally Stream Unlabeled Marker Data.

    • Stream Marker Data: Enables marker data on all subjects and adds a new Labeled Marker Live Link subject.

    • Stream Unlabeled Marker Data: Enables unlabeled marker data as a new Unlabeled Marker Live Link subject.

Set up the Vicon Marker Visualizer Component

This section explains how to use the Vicon Marker Visualizer Component.

To ensure the markers align with data when they're visualized, you add the corresponding component to a static actor that does not move (this static actor is typically a Vicon Origin actor).

In the following instructions, the component is added to a Vicon Origin actor.

  1. Go to Window > Outliner and open an Outliner panel.

  2. In the panel, select the Vicon Origin actor.

    (tick) Tip: If you cannot see this actor, you may need to create a Vicon Origin actor. For more information, see Set up a Vicon Origin actor.

  3. When you've selected the Vicon Origin actor, in the Details panel, click Add and select Vicon Marker Visualizer Component.

    (tick) Tip: Search for Vicon when adding a component.

  4. Select the new Vicon Marker Visualizer Component and go to the Marker Visualization section.

    This section contains all settings for the Vicon Marker Visualizer Component. For details on configuring these settings, see Marker visualization reference.

  5. In Subject Name, select the subject from which to display markers.

    If you cannot see any subjects in this field, ensure marker data has been enabled in the Vicon Live Link Source settings. For more information, see Configure the Vicon Live Link Connection.

  6. To see the markers in the editor outside of Play Mode, select Show Marker in Editor.

Markers are visualized in the viewport matching the Marker Type, Marker Color, and Marker Size settings.

The following example shows markers on a prop.

The following example shows markers on a subject.

Related content