Pixel Map Editor Panel

The Pixel Map Editor lets you design the layout of LED pixels and configure their DMX addressing.

Interface

Canvas

The main editing area shows:

• Pixel positions in 2D
• Color preview of current output
• Selection highlighting
• Grid overlay (optional)

Toolbar

• Select - Select pixels
• Draw - Add new pixels
• Erase - Remove pixels
• Pan - Navigate the canvas
• Zoom - Adjust view scale

Creating Pixel Maps

New Map

1. Go to Pixel Map List
2. Click + to create new
3. Set dimensions (width × height)
4. The empty map opens in the editor

Drawing Pixels

1. Select the Draw tool
2. Click to add single pixels
3. Drag to draw continuous lines
4. Hold Shift for straight lines

Predefined Shapes

Add common arrangements:

1. Arrange > Line - Horizontal or vertical strip
2. Arrange > Grid - Rectangular matrix
3. Arrange > Circle - Circular arrangement
4. Arrange > Custom - Import from file

Selecting Pixels

Selection Tools

• Click - Select single pixel
• Shift + Click - Add to selection
• Drag - Rectangular selection
• Cmd + A - Select all

Selection Actions

With pixels selected:

• Move - Drag to reposition
• Delete - Remove pixels
• Address - Set DMX addresses
• Group - Create a group

DMX Addressing

Auto Address

Assign addresses automatically:

1. Select pixels to address
2. Click Auto Address
3. Set starting universe and address
4. Choose addressing mode:
   • Sequential - Left to right, top to bottom
   • Snake - Alternating direction per row
   • Column - Top to bottom, left to right
5. Click Apply

Manual Address

Set specific addresses:

1. Select a pixel
2. In Properties, set Universe and Address
3. Each pixel needs 3 channels (RGB) by default

Address Display

Show addresses on canvas:

1. Enable View > Show Addresses
2. Each pixel shows its address
3. Helps verify correct patching

Pixel Properties

When pixels are selected:

Position

• X, Y - Canvas position
• Edit numerically for precise placement

Addressing

• Universe - DMX universe (1-based)
• Address - Starting channel
• Channels - Number of channels (usually 3 for RGB)

Channel Order

Set the channel order:

• RGB - Red, Green, Blue
• GRB - Green, Red, Blue (WS2812)
• BGR - Blue, Green, Red
• Custom orders available

Working with Strips

LED strips often use snake wiring:

Snake Mode

1. Select all strip pixels
2. Enable Snake in addressing
3. Odd rows address left-to-right
4. Even rows address right-to-left

Strip Direction

Set the physical direction:

1. Select the strip
2. Set Start Corner (where the data begins)
3. Addressing follows the physical layout

Groups

Organize pixels into groups:

Create Group

1. Select pixels
2. Right-click, Create Group
3. Name the group
4. Groups can be addressed together

Nested Groups

Groups can contain other groups for complex layouts.

Import/Export

Import Layout

Load pixel positions:

1. File > Import Pixel Map
2. Select CSV or JSON file
3. Positions are imported

Export Layout

Save for external use:

1. File > Export Pixel Map
2. Choose format
3. Includes positions and addresses

Related Panels

• Pixel Map List - Manage all maps
• Address Space - DMX overview