Breadcrumbs

Create mappings

Create mappings to define which LED panels/XR walls render to which video outputs. This step connects your physical LED setup to Pixotope's rendering system.

Key Concepts

  • Mappings work identically for manual setups and digital twins

  • Mapping is a 2D process, independent of physical LED body shapes

  • Without mappings, XR and digital twin patterns won't output

Mapping example

The following example LED bodies

image-20260224-125127.png

can be output in different ways:

Render each LED body by a single machine.
image-20260225-083737.png

Split up the large LED body and render it by multiple machines.
image-20260225-083639.png

Render all LED bodies by a single machine.
image-20260225-083754.png

Prerequisites

Complete the body generation.

Learn more about how to Configure LED mapping

Create mapping

  1. Go to SETUP > Configure > LED mapping

  2. Switch to the "Pixel map" tab

    • The canvas switches to Tile mode

In Tile mode

  • single or a group of tiles can be moved individually

  • bodies are shown with their actual pixel size (any scaling from LED volume is disregarded)

  1. Click the + icon to create a new Mapping

  2. Select the mapping and change the mapping size if needed

Assign tiles to mapping

Depending on the size of the body and your mapping, select

  1. Select a whole group of tiles from a body view on top and drag it into the mapping

  2. Position it by using edge snapping or the X and Y fields of the tile group

Body tiles that appear darker, indicate that they already have been placed in one mapping.

Screenshot 2026-02-24 at 13.34.01.png

To keep them pixel perfect, do not rescale them!

Dragging whole body

Dragging group of tiles

Change tile placement

  1. Select one or more tiles of the group

  2. Drag them to a new position within the same or a different mapping

    • If not all tiles of a group were moved, the tiles are broken down into smaller groups

  3. Optionally you can change the placement and scaling of a group in the details tab on the right

Want to start from scratch? Just select and delete the tiles and drag them down from the body again.

Assign outputs to mappings

  1. Go to the Routing panel

  2. Open the media output row of the machine which should render this mapping

  3. Select the mapping using the XR Mapping dropdown

Screenshot 2026-02-24 at 13.41.48.png

Make sure that the machine has an XR render group tag.

Learn more about Render, feature and custom groups - AR, VS, AR+VS, XR

Create mapping inside Editor

Learn more how to create mappings from inside the Editor

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.

image-20250320-085736.png

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

image-20250320-085329.png
XRWall-[BodyNumber]-[ColumnNumber]-[RowNumber]
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"

    Screenshot 2025-10-29 at 10.17.08.png


  3. Add to Mapping: Leave blank (-)

  4. Give the mapping a name

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

    • Keep All Columns and All Rows selected

  6. Graphics Scale: Choose "Pixel Perfect"

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

Double check the Needed Resolution on the bottom.

  1. Click "Create mapping"

Screenshot 2025-11-06 at 15.57.38.png

A single mapping is created.

Screenshot 2025-11-03 at 15.42.40.png
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
image-20250320-091930.png
image-20250320-092637.png

Learn more about how to identify your mappings below

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.

image-20250320-093750.png

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

Option 1: Scale to Fit

  • Allows you to use a single output but sacrifices resolution quality

  • Can work well for testing or demonstrations but may not be ideal for production

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

  2. Click "Create Single Mapping"

    Screenshot 2025-10-29 at 10.17.08.png


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

    • Keep All Columns and All Rows selected

  4. Add to Mapping: Leave blank (-)

  5. Graphics Scale: Choose "Scale to Fit"

    1. Set Width and Height of the mapping

  6. Click "Create mapping"

Screenshot 2025-11-06 at 16.02.59.png
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

image-20250320-095551.png
You can see the XR texture takes the entire output image but the sphere is slightly squeezed compared to the one on the right side which is the sphere in a pixel perfect output.
Option 2: Pixel Perfect with Multiple Outputs

For best quality

  • Divide your LED body into sections 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
image-20250320-113904.png
Example mapping layout
image-20250320-114012.png
Alternative mapping layout

You can also make pixel perfect mappings in other layouts.

image-20250320-120734.png

OR

Screenshot 2023-09-29 at 13.48.02.png

For every single section, 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"

    Screenshot 2025-10-29 at 10.17.08.png


  3. Add to Mapping: Leave blank (-) for the first section

    1. For the next sections, select the mapping it should be added to

      Screenshot 2025-11-06 at 16.00.22.png


  4. Body: Select the LED Body you want to create a mapping for

  5. Set the columns, rows and offset based on your section layout

Mapping


Columns

Rows

Offset x

Offset y

Mapping 1

Section 1 (red)

0-6

0-4

0

0

Mapping 2

Section 2 (yellow)

7-10

0-4

0

0

Section 3 (blue)

0-5

5-5

1536

0

Section 4 (green)

6-10

5-5

1536

384

  1. Graphics Scale: Choose "Pixel Perfect"

  2. Click "Create mapping"

  3. Repeat for each section

Now we have both mappings with the XR texture. Let’s see how they look.

image-20250320-120550.png

Remember to correctly position and crop each part on the LED processor.

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

Screenshot 2023-07-07 at 12.48.26.png

In Director

  1. Go to PRODUCTION > XR > General

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

image-20250904-075439.png

Be sure to read from the XR machine to enable the settings in the Production page.