Create mappings - Digital Twin XR

A mapping defines which XR walls or parts of your LED wall are rendered on which output.

The step of creating mappings should be done after bodies were generated, either using a manual or a digital twin.

Once you have information about the LED body sizes and resolutions, you can decide:

• How many outputs you need

• Which scale mode to use

Create mapping: LED wall smaller than single output

When your LED wall has a lower resolution than a single Pixotope output, you can create a straightforward one-to-one mapping.

Example LED Wall Configuration

Consider an LED wall with 9 × 5 panels. If each panel has a resolution of 384 × 384 pixels, the total wall resolution would be 3456 × 1920 pixels.

In the Digital Twin actor, LED panels (XR walls) are named starting from the bottom left panel of the LED body.

Create single mapping

Since the resolution of this LED wall (3456 × 1920) is smaller than a single Pixotope UHD output (3840 × 2160), you can create a single mapping with these steps:

1. Open the Details panel of the Digital Twin XR Actor

2. Click "Create Single Mapping"

   

   
   

3. Body: Select the LED Body you want to creating a mapping for

   • Keep All Columns and All Rows selected

4. Output: Select the routed output the mapping should be applied to

5. Graphics Scale: Choose "Pixel Perfect"

   • this ensures pixel-to-pixel display on the LED

6. Click "Create the mapping"

A single mapping is created and the Output Channel of all XR walls is set to the output selected above.

Verify output

After creating the mapping, your XR output will display the texture with the following characteristics:

• The XR texture will occupy only part of the output (3456 × 1920 pixels)

• The unused portion of the output will appear black

• The LED processor needs to extract the relevant pixels and display them on the physical LED wall

Display mode: XR	Display mode: Identify

Create mapping: LED wall larger than single output

Example LED Wall Configuration

Consider an LED wall with 11 × 6 panels. If each panel has a resolution of 384 × 384 pixels, the total wall resolution would be 4224 × 2304 pixels. This exceeds the size of UHD.

For larger LED walls with resolutions exceeding a single Pixotope output, you have 2 options:

Option 1: Scale to Fit

1. Open the Details panel of the Digital Twin XR Actor

2. Click "Create Single Mapping"

   

   
   

3. Body: Select the LED Body you want to creating a mapping for

   • Keep All Columns and All Rows selected

4. Output: Select the routed output the mapping should be applied to

   • This "squeezes" the entire wall resolution into a single output

5. Graphics Scale: Choose "Scale to Fit"

   • This removes the Not enough space warning

     

     
     

6. Click "Create the mapping"

Verify output

After creating the mapping, your XR output will display the texture with the following characteristics:

• The XR texture takes up the entire output image

• It reduces the XR engines at the cost of resolution loss

  • In our example we lost 14.77% resolution

• Depending on the aspect ratio difference, the output image can look squeezed compare to the pixel perfect output

  • Don’t worry! The texture will be stretched back to the normal size when displayed on the LED wall

Option 2: Pixel Perfect with Multiple Outputs

For best quality

• Divide your LED body into pieces that can each fit within an output

For optimal performance

• Distribute pixels evenly across outputs to balance rendering load

  • Uneven distribution can cause frame drops on heavily loaded machines

  • Note: This can be ignored if all outputs come from the same machine

Manual division

Example division

Example mapping layout

Alternative mapping layout

You can also make pixel perfect mappings in other layouts.

OR

For every single mapping, it starts with opening the Create Single Mapping dialog

1. Open the Details panel of the Digital Twin XR Actor

2. Click "Create Single Mapping"

   

   
   

3. Body: Select the LED Body you want to creating a mapping for

4. Set the columns, rows and offset based on your mapping layout

4. Output: Select the routed output the mapping should be applied to

5. Graphics Scale: Choose "Pixel Perfect"

6. Click "Create the mapping"

7. Repeat for each mapping

Now we have both XR output mapped with XR texture. Let’s see how they look.

Automatic division

Create all mappings

You can create all mappings at once.

1. Open the Details panel of the Digital Twin XR Actor

2. Click "Create All Mappings"

   

    

   

   
   

    

3. Select the LED Body you want to creating a mapping for

   • All Bodies is selected by default

4. Select a routed output to specify the mapping size

   • The graphics scale is fixed to Pixel Perfect

5. Enable Split Mapping Evenly to balance the distribution of rows and columns between mappings

   • By default a single mapping would cover as many rows as possible

6. Enable Auto Route Mappings to automatically assign outputs of machines to the output channel of the created XR walls/mappings

   • To change this later see Select output machines below

7. Click "Create mapping"

Select output machines

In a multi-machine setup you can specify which mapping should be rendered by which machine.

From Director

1. Go to the "XR wall settings" tab in PRODUCTION > Adjust > XR

2. Select the mapping/XR walls to specify the machine and output for

3. Choose the correct output from Output destination > Outputs

   

From Editor

1. Expand the details of a specific mapping and click on "Select XR walls"

   • The detail view switches to the XR walls related to this mapping

     

      

2. Select the correct output from Output channel

   

Identify your mappings

To check that your mappings have been setup and output correctly.

In Editor

1. Expand Display Mode

2. Choose "Identify" for the XR Wall Texture

In Director

1. Go to PRODUCTION > XR > General

2. Choose "Identify" for the Display mode for digital/manual twin