What the integration gives you
The Resolume integration is optional. Once connected, the app reads the composition name and resolution, layers, columns and clips from Resolume, and takes the screen geometry from Advanced Output presets (XML files). The image reaches the app over NDI, Syphon or Spout.
Everything is in the Resolume panel (⌘ 9, or ⌥ 9 in the browser), arranged in working order: Connection, Live Matching and Advanced Output File (XML).
Connecting through the Web Server
- In Resolume, open Preferences → Webserver and turn on the server. The default port is 8080.
- In StageDesigner, open the
Resolumepanel,Connectionsection. - In the
Addressfield, enter 127.0.0.1 when Resolume runs on the same computer, or the network IP address of the computer running Resolume. - Check the
Portand clickConnect(Enter in the address field also connects). The status changes toConnectedwith the Resolume name and version.
Connect automatically- Connects to Resolume when the project opens.
Refresh composition data- Fetches the name, layers, columns and clips again.
Disconnect- Ends the connection.
CompositionName,Layers,Columns,Clips,Outputs,Slices.Live sources- Status of NDI and Syphon (macOS) or Spout (Windows).
The same form is in the Resolume Connection tab that sticks out from the bottom of the window on the right. A dot on the tab shows the connection status, and once connected the composition name appears next to it. Clicking slides the panel out, Esc or a click outside hides it.
Once connected, the app refreshes the composition every few seconds, so column changes in Resolume show up in the project without manual refreshing.
Smart import: live matching
Once connected, the Live Matching section searches the Advanced Output presets in the default Resolume folders (in Documents: Resolume Arena or Resolume Avenue, subfolders Presets/Advanced Output) and matches them to the playing composition. It looks at matching resolution, name similarity and how recent the file is.
- When the match is certain, the preset loads on its own. You see its name and the
loaded automaticallytag. - When no preset matches, a warning appears. Save the layout in Advanced Output (Save) or load the file in the section below.
- When the loaded preset has a different composition resolution than the one playing in Resolume, a warning says the layout may be out of date.
- The app detects the Resolume video source (Syphon, Spout or NDI) and assigns it to the screens automatically.
Comparing the preset with the scene gives these buttons and tags:
Insert screens (N)- Inserts only the slices that are not in the scene yet, in the Advanced Output layout and with the source connected.
Update (N)- Applies the new preset geometry and slices to existing screens. The screen positions in the scene stay the same.
in scene- Slices that already have an unchanged screen.
deleted in Resolume- Screens whose slice has disappeared from the preset.
Every dozen or so seconds the app checks whether the preset has been saved again, and if so, reloads it in the background. The Rescan presets and match again icon forces a scan right away.
Advanced Output File (XML)
The Advanced Output File (XML) section also works without a connection and in the browser. The Recently saved in Resolume list shows presets from the Resolume folders, and the load button lets you pick a file manually.
After loading, the outputs and slices appear as tiles with resolution, aspect ratio and approximate size in meters. Click selects a slice, dragging a tile onto the scene creates a screen at the drop point. The Add to scene button on a tile inserts the screen immediately.
Importing a whole preset is also in the menu:
The Import Screens from Resolume (Advanced Output) window turns each slice into a screen. Choose the Preset (or Choose file…), the Video Source for all screens and the Enabled slices only toggle. The Add N screens to scene button adds the screens, and Replace all screens… deletes the existing screens and their source assignments (the operation can be undone).
Slice on an existing screen
In the screen Inspector, set Source type to Resolume Arena. Without a connection, use the Advanced Output (XML file) group:
- In the
Filefield, choose a saved preset. - In the
Full output signalfield, choose the NDI, Syphon or Spout source with the full Resolume output image. - In the
Slicefield, choose a slice or click it on the map in theSlice mapping previewgroup. The app crops the signal to the slice region, and the screen name and aspect ratio are set automatically.
The mapping preview shows the composition size, the slice, its position, the UV range and Cropped live image. A screen with a slice has a Slice from Resolume file group in the Video Source section, with the XML file name, slice, output and resolution.
The context menu of such a screen has the Refresh from Resolume, Change slice…, Next column and Previous column commands.
Column control
When the connection works and the composition has columns, a Resolume column bar appears at the bottom of the window. A column tile shows the name, the number of clips and a LIVE tag on the active column. Clicking a tile triggers the column in Resolume.
- The bar has collapsed, compact and expanded modes, plus an option to hide at the edge.
- The arrows at the ends of the bar and the mouse wheel scroll the columns. The previous and next column (LIVE) buttons switch the active column.
Skip redskips columns marked red in Resolume. The color is read directly from Resolume.- The sync and refresh buttons reconnect and fetch the composition again.
In presentation mode the bar turns into a floating operator console with an option to hide after 5 s of inactivity. The client watches the 3D scene while you run the show from one window.
