Pixel Map (for non planar LED)

Last updated 13 November 2026

Mapping individual content pixels to specific output pixels. A pixel map is a PFM image that tells Backstage, for every pixel of a display output, which pixel of the content it shows.

This stage is for LED screens where the physical pixel count and positions vary across the surface — curved panels, faceted walls, domes, and any screen that is not a regular flat grid. A flat LED wall or monitor with a standard pixel layout does not need a pixel map.

A display and its output must exist before you load a pixel map. Create them first: Create a Display.

Content is unwrapped to the output first. The display surface’s Pixel Map Raster setting decides how the content is unwrapped onto the output. The pixel map is applied after that unwrap, distributing the resulting pixels to the physical LEDs. See Pin a Pixel Map Raster Mapping on a Display to choose which mapping drives the unwrap.

Do this in order

  1. Load the pixel map — import the PFM file onto the display output so Backstage knows which content pixel feeds each physical LED.

    PFM Pixel Map for Display Output

  2. Correct panels, seams and pixels — optional — fine-tune the geometry and brightness of individual LED panels, seams and pixels when the loaded pixel map still shows visible artefacts.

    LED Panel Correction

Done when: content appears correctly distributed across the physical LED positions, and any visible seams or panel shifts have been corrected.

Create a Display — create the display surface and output that the pixel map is loaded into

Pin a Pixel Map Raster Mapping on a Display — choose which mapping’s unwrap defines how content is laid out on the output, before the pixel map is applied

Ask the documentation