DMX Mapping Window
Last updated 12 June 2026
DMX Mapping Window
The DMX Mapping window is a visual pixel-mapping editor for ArtNet outputs. It displays the output's pixel grid and shows which pixels are mapped to which Art-Net universes and DMX channels. Use it to inspect, create, and edit pixel-to-universe mappings for LED fixtures and Art-Net devices.
[USER-ACTION-REQUIRED: Attach a screenshot of the DMX Mapping window showing a populated grid with the minimap and nav overlay visible]
Opening the window
Open the DMX Mapping window in either of two ways:
The window remembers the last ArtNet output you viewed, per user. If no ArtNet output is selected, the window shows an output selector dropdown.
Grid
Grid settings and controls
The grid represents the ArtNet output's pixel space. Each cell is one output pixel. The grid dimensions match the output's width and height.
|
Setting
|
Description
|
Values / Range
|
|
Cell colour
|
Each mapped pixel is colour-coded by its assigned Art-Net universe. Unmapped pixels are dark grey.
|
Automatic hue per universe
|
|
Channel numbers
|
At the highest zoom level, each cell displays its DMX start channel number for the currently selected universe.
|
1–512 (visible at full zoom only)
|
|
Rulers
|
Column numbers along the top and row numbers along the left edge. Show the first and last visible index.
|
1-based
|
|
Grid lines
|
Visible when cells are large enough (6 px or more on screen). Hidden automatically at small zoom levels.
|
Automatic
|
Navigation
Navigation controls
|
Control
|
Description
|
Values / Range
|
|
Mouse wheel
|
Zoom in and out, anchored at the cursor position. At maximum zoom, wheel scrolling pans the grid toward the cursor.
|
Scroll up = zoom in, scroll down = zoom out
|
|
Middle-mouse drag
|
Pan the grid. Drag direction moves the view in that direction.
|
Free drag
|
|
Fit button (nav overlay)
|
Top button of the three-button overlay in the top-right area (below the minimap). Zooms out to fit the entire grid in the window.
|
Click
|
|
Zoom button (nav overlay)
|
Middle button of the nav overlay. Click and drag vertically to zoom (drag up = zoom in, drag down = zoom out). Zooms about the view centre.
|
Drag
|
|
Pan button (nav overlay)
|
Bottom button of the nav overlay. Click and drag to pan the view.
|
Drag
|
|
Minimap
|
A small overview in the top-right corner shows the entire grid. A white rectangle marks the currently visible portion. Click or drag the minimap to reposition the view. Mouse wheel over the minimap zooms about the view centre.
|
Click or drag
|
Live Data Overlay
Live data overlay
Enable the Live data checkbox (top of the window, next to the output selector) to colour each mapped pixel by the actual DMX RGB values currently being sent. The minimap also reflects live data when this mode is active.
The data refreshes every frame. If the send thread is busy, the previous frame's snapshot is kept, so the UI never stalls.
Selection and Editing
Selection and editing controls
|
Action
|
Description
|
Details
|
|
Left-click
|
Select a single pixel. If the pixel is mapped, its universe becomes the selected universe automatically.
|
Universe auto-select syncs with the Inspector's Selected Universe dropdown
|
|
Left-click + drag
|
Select a horizontal or vertical line of pixels. The selection locks to whichever axis you drag further along.
|
Selection is always a single row or column, never a rectangle
|
|
Hover tooltip
|
Shows the pixel's grid coordinates. For mapped pixels, also shows the universe number and DMX channel.
|
Format: X:N Y:N / Universe N Ch N. During drag, shows pixel count.
|
|
Inspector sync
|
When the selection covers a single mapping entry, the corresponding entry in the Inspector's Pixel Mappings list is highlighted and scrolled into view.
|
Automatic
|
Context menu actions
Right-click on the grid to open a context menu. The available actions depend on whether the clicked pixel is mapped or unmapped, and whether an active selection exists.
|
Menu Item
|
Description
|
Condition
|
|
Add pixel mapping
|
Creates a new pixel mapping entry for the selected universe using the current selection's position, direction, and pixel count. DMX address auto-increments from existing entries.
|
Right-click on unmapped pixel within a selection
|
|
Delete mapping
|
Removes the mapping entry that covers the selected pixel(s). If a selection spans multiple entries, all intersecting entries are removed.
|
Right-click on a mapped pixel
|
|
Locate submenu
|
Light up specific pixels on the physical fixture to identify them. Options: Locate selected (highlights the selected pixels), Locate row, Locate column. "Dim other pixels during locate" dims non-located pixels for contrast.
|
Output must be routed (connected). Locate row/column require a single-pixel selection.
|
|
Skip DMX address
|
Marks the DMX start channel(s) of the selected pixel(s) as skipped. Skipped channels are omitted from the Art-Net output.
|
Selection on mapped pixels
|
|
Re-Enable DMX address
|
Removes a skip from a previously skipped DMX address. Shows a submenu listing all currently skipped addresses for the selected universe.
|
Selected universe has skipped addresses
|
|
Stop Locating
|
Stops the active locate operation and restores normal output.
|
Inside the Locate submenu; active only during locate
|
ArtNet Output Selector
Output selector
A dropdown at the top-left of the grid lets you switch between ArtNet outputs without leaving the DMX Mapping window. Selecting an output here also activates the Outputs panel and selects that output in the Inspector, so both views stay in sync.
When the window first opens, it restores the last ArtNet output you viewed (saved per user across sessions).
Inspector: DMX Mapping Section
Inspector controls for ArtNet outputs
When an ArtNet output is selected, the Inspector shows a DMX Mapping section with universe and pixel mapping controls. These are the same data the grid window visualizes.
File operations
|
Setting
|
Description
|
Values / Range
|
|
Import CSV
|
Import a pixel mapping from a CSV file.
|
Button
|
|
Export CSV
|
Export the current pixel mapping to a CSV file.
|
Button
|
|
Save Pixelmask
|
Save a pixel mask image based on the current mapping.
|
Button
|
Universe management
|
Setting
|
Description
|
Values / Range
|
|
Add Universe
|
Add a new Art-Net universe. The IP address is copied from the previous highest universe. The new universe is auto-selected.
|
Button. Universe range: 1–32768.
|
|
Selected Universe
|
Choose which universe to view and edit. Keyboard Up/Down arrows cycle through universes when focused.
|
Dropdown
|
|
Edit Universe
|
Change the universe number. If the target number is already taken, it skips to the next available number in the same direction.
|
Integer input, 1–32768
|
|
IP
|
Set the destination IP address for this universe's Art-Net packets.
|
IPv4 address (default: 127.0.0.1)
|
|
Remove Selected Universe
|
Delete the currently selected universe and all its pixel mappings.
|
Button
|
Pixel Mappings
The Pixel Mappings collapsible section lists all mapping entries for the selected universe. Each entry maps a line of output pixels to consecutive DMX channels.
|
Setting
|
Description
|
Values / Range
|
|
X
|
Start position X coordinate in the output grid.
|
1 to output width
|
|
Y
|
Start position Y coordinate in the output grid.
|
1 to output height
|
|
Pixel
|
Number of pixels mapped from the start position in the selected direction.
|
0+
|
|
Direction
|
Direction the pixel run extends from the start position.
|
Up / Down / Left / Right
|
|
DMX address
|
DMX start channel for the first pixel of this mapping entry. Each pixel consumes 3 channels (RGB).
|
1–512
|
|
Skip addresses
|
Comma-separated list of DMX start channels to skip within this entry. Skipped channels are omitted from the output.
|
Comma-separated integers (1–512)
|
|
Add pixel to DMX mapping
|
Add a new mapping entry. Position and direction are based on the previous entry. DMX address auto-increments.
|
Button
|
|
Remove
|
Remove this mapping entry.
|
Button (per entry)
|
Undo Support
All universe and pixel mapping edits are fully undoable. Adding, editing, renumbering, or removing universes and mapping entries can each be undone and redone as a single step. Changes made in both the grid window (via context menu) and the Inspector fields are tracked by the same undo history.
Tips
-
Use the grid window's drag-to-select to create new mappings visually. Drag a horizontal or vertical line, then right-click and choose Add pixel mapping. The direction and pixel count are set from your selection automatically.
-
Import a CSV file for large or complex installations rather than building mappings pixel by pixel. Export to CSV to share or back up mappings.
-
Enable Live data to verify that the right content reaches the right fixture. Each pixel shows its actual RGB colour as sent over Art-Net.
-
The Locate feature is invaluable for commissioning. Right-click a pixel, row, or column and choose Locate to light it up on the physical fixture. Enable Dim other pixels during locate for maximum contrast.
-
Left-clicking a mapped pixel auto-selects its universe in both the grid window and the Inspector. This is the fastest way to identify which universe a specific pixel belongs to.
How to Set Up ArtNet and sACN Pixel Output — step-by-step guide to creating ArtNet and sACN pixel outputs.
Play a Video on a Segmented LED Screen — how to play content on a segmented LED screen.
How to Preview LED Content in the Scene View (LED Simulation) — LED simulation preview in the Scene View.
Outputs — Outputs reference page.