Position Map Editor Panel

The Position Map Editor lets you design the spatial layout of fixtures in a position mapping. You can position, rotate, and scale fixtures in a 3D viewport.

Interface

Fixture List

A side panel lists all project fixtures sorted by universe and address. Fixtures already in the current mapping can be selected and transformed. Click an unmapped fixture to add it to the mapping. Use Shift+Click to select multiple mapped fixtures.

3D Viewport

The main editing area shows:

• Fixture positions in 3D space
• Transform gizmos for moving, scaling, and rotating fixtures
• Configurable grid overlay
• Gizmo viewcube for orientation

Toolbar

• Axis Selector - Choose the active axis (X, Y, Z) for alignment and rotation operations
• Rotate - Rotate the entire mapping 90 degrees around the selected axis
• Align Start / Center / End - Align selected fixtures along the chosen axis
• Distribute - Distribute selected fixtures evenly along the chosen axis (requires 3+ selected)
• Match Scale - Apply the active fixture's scale to all selected fixtures
• Snap - Toggle snap to grid
• Transform Mode - Switch between Translate, Scale, and Rotate modes
• Labels - Toggle fixture label visibility
• Grid Cells - Configure the number of grid cells
• Camera - Switch between Perspective and Orthographic views

Adding Fixtures to a Mapping

From the Position Map List

1. Go to the Position Map List panel to create or select a mapping
2. The selected mapping becomes the active mapping in the editor

Adding Fixtures

Drag fixtures from the Project Fixtures panel into the 3D viewport. Fixtures are placed at the drop position on the grid.

Selecting Fixtures

Selection

• Click a fixture to select it
• Shift + Click to add to selection
• The active fixture is highlighted in orange, additional selected fixtures in yellow

Transform

With fixtures selected, use the transform gizmo to move, scale, or rotate them. Switch transform mode using the toolbar toggle or keyboard shortcuts.

Alignment and Distribution

When multiple fixtures are selected, you can use the toolbar to align or distribute them along the active axis:

• Align Start - Align fixtures to the minimum position on the active axis
• Align Center - Align fixtures to the center position on the active axis
• Align End - Align fixtures to the maximum position on the active axis
• Distribute - Space fixtures evenly along the active axis (requires 3 or more selected)
• Match Scale - Apply the active fixture's scale to all other selected fixtures

Keyboard Shortcuts

Related Panels

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