Multi-Panel Boards and Sync

Board Groups

LedBoardGroup lets multiple physical boards behave like one large display. It composes a master texture, slices that texture per child board, and lets each child keep its own material, emitter presentation, and defects. Horizontal, Vertical, Grid, Radial, and Spatial layouts are supported. Regular layouts can add gap pixels for bezels; Spatial layout uses the boards' actual physical gaps. Advanced group setups can use a LedLayoutAsset for the group master canvas, while individual boards use Source Assets, LED Compositions, and Playlists.

Spatial Layout

Choose Spatial when panels are offset, separated by physical gaps, or arranged as a honeycomb. Place the child boards in the group's local display plane and face them in the same direction as the group. Each board receives the part of the shared canvas beneath its position and size, so the image stays aligned across the installation.

Inactive panels retain their space in the canvas, keeping the remaining panels aligned. Moving a panel updates its content slice. Use flat or hexagonal boards for predictable mapping: a rotated or curved panel is mapped through its rectangular bounds and can show stretched content. Gap Pixels is ignored in Spatial layout.

Sync Groups

Boards with the same sync group ID read from a shared clock. LedSyncManager and LedSyncDriver coordinate clocks in play mode and editor mode. Use sync groups when separate boards need matching playlist timing, synchronized animation, scrolling text, blinking text, temporal defects, or coordinated replay timing. Compatible Board Timing or Group Timing settings keep the group phase predictable.

LED Studio Window

Open Tools > LED Studio > LED Studio Window to inspect scene boards. The window includes board discovery, sync group inspection, playlist playback controls, and live preview surfaces. In play mode, it can force-refresh boards, nudge or reset sync group time, and jump between playlist entries.

UI Toolkit Board Elements

Runtime UI can display a board through LedBoardElement. Add the element to UXML and use LedBoardElementBinder to bind it to an authoritative LedBoardController. Presentation mode renders the board through the LED presentation material for UI preview; Logical Output mode shows the raw composed board texture for debugging or custom UI. Auto-refresh, refresh rate, scale mode, tint, and placeholder text are configurable from UXML or C#. When a document contains multiple LED board elements, give each element a unique UXML name and set the binder Target Element Name so bindings do not collide.