QLab
Hardware and software requirements
Galileo GALAXY processor booted into Spacemap Mode – requires firmware version included with Compass software version 4.9, or later which matches the version of the Spacemap Go app in use. This can be real hardware (required to pass audio) or a Virtual GALAXY running in Compass.
Computer running the latest OS and QLab versions.
Network Switch – AVB capable, Avnu-certified.
Spacemap Go receives OSC commands via port 38033 and QLab receives OSC commands via port 53000.
Connection steps: hardware (not virtual GALAXY)
The Apple computer and the GALAXY processor must be on the same network.
The Apple computer running QLab must be within the same IPv4 range and subnet as the Spacemap Go System IPv4 address, GALAXY processor(s), and iPad.
In the Spacemap Go app on the iPad, tap SETTINGS VIEW (bottom), then SYSTEM SETTINGS > EXTERNAL DEVICE CONTROL.
SYSTEM IP CONFIGURATION > IPv4 ADDRESS: Enter a system IPv4 address, in the same subnet of the computer running QLab.
Note
Spacemap Go uses this IPv4 address as the master IPv4 address of the system. Following that address, a contiguous range of IPv4 addresses for each Spacemap Go GALAXY processor is automatically assigned. These addresses are independent of the IPv4 addresses listed in Compass software on the PROCESSORS > SETTINGS > NETWORK tab.
Ensure the range of IPv4 addresses is available on the network. Do not use or allow the Spacemap system to create duplicate IPv4 addresses on the network.
SYSTEM IP CONFIGURATION > SUBNET MASK: Enter a system subnet mask, usually, 255.255.255.0.
GENERAL PURPOSE OSC > IPv4 ADDRESS: leave set to the default, (any).
Note
When an IPv4 address is entered, QLab will only listen for commands from the device with that IPv4 address.
GENERAL PURPOSE OSC > PORT: Leave the port set to default (0). In the instance that an event in SMG needs to trigger a QLab event, set the port number to 53000 – the default Rx (receiving) port used by QLab.
GENERAL PURPOSE OSC: toggle the ENABLE slider to ON
Settings, External Device Connection – System and General Purpose OSC IP Settings
Set the IPv4 address of the computer running QLab to be in the same IPv4 address range as the Spacemap Go system.
Setting IPv4 address of Apple computer
Note
If an IPv4 address was entered in the GENERAL PURPOSE OSC field, use that IPv4 address to set the QLab Alias IPv4 address (Spacemap Go targets this address).
Set the network settings in QLab: under NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface, type in the Spacemap Go system IP address and port number 38033.
QLab Settings with GALAXY Hardware
Connection steps: Virtual GALAXY processor(s)
Virtual GALAXY processors running on the same computer as QLab
GENERAL PURPOSE OSC: toggle the ENABLE slider to ON. Use the default values for all other settings.
In QLab: NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface. Enter
localhostor127.0.0.1in the Destination Address field. Enter38033in the Port field.QLab Network Settings
Virtual GALAXY processors NOT running on the same computer as QLab
The Spacemap Go SYSTEM IP ADDRESS is not necessary in this instance. The Virtual GALAXY will respond to the Compass computer IPv4 address.
GENERAL PURPOSE OSC > IPv4 ADDRESS: Enter the IPv4 address of the Compass computer.
GENERAL PURPOSE OSC > PORT: Leave the port set to default, (0). In the instance that an event in SMG needs to trigger a QLab event, set the port number to 53000 – the default Rx (receiving) port used by QLab.
GENERAL PURPOSE OSC: toggle the ENABLE slider to ON.
In QLab: NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface, enter the IPv4 address of the Compass computer running the Virtual Galaxy. Enter
38033in the port field.
QLab Settings with GALAXY Hardware
Virtual GALAXY processors not running on the same computer as QLab
The Spacemap Go SYSTEM IP ADDRESS is not necessary in this instance. The Virtual GALAXY will respond to the Compass computer IPv4 address.
GENERAL PURPOSE OSC > IPv4 ADDRESS: Enter the IPv4 address of the Compass computer.
GENERAL PURPOSE OSC > PORT: Leave the port set to default (0). In the instance that an event in SMG needs to trigger a QLab event, set the port number to 53000 – the default Rx (receiving) port used by QLab.
GENERAL PURPOSE OSC: toggle the ENABLE slider to ON.
In QLab: NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface, and enter the IPv4 address of the Compass computer running the Virtual Galaxy. Enter 38033 in the port field.
QLab Settings with GALAXY Hardware
Virtual GALAXY processors running on the same computer as QLab
GENERAL PURPOSE OSC: toggle the ENABLE slider to ON. Use the default values for all other settings.
In QLab: NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface. Enter
localhostor127.0.0.1in the Destination Address field. Enter38033in the Port field.
QLab Network Settings
General purpose OSC commands
The table below lists the general purpose OSC commands that a Spacemap Go system will respond to.
Command | String | Value | Example(s) |
|---|---|---|---|
Spacemap Go Channel | /channel | ||
X and Y Value of the Panner Position within a Spacemap | /channel/1-32/position (1st Argument is X, 2nd Argument is Y) | -1000 to 1000 | /channel/1/position 125 300 (X Position is 125, Y Position is 300) |
Control Channel Level | /channel/1-32/level | -90 to +10 -90 = -90 dB +10 = +10 dB | /channel/1/level 0 (Set Channel 1 Level to 0 dB) /channel/1/level -6 (Set Channel 1 Level to -6 dB) |
Control Channel Mute | /channel/1-32/mute | 0 = OFF 1 = ON | /channel/1/mute 0 (Unmute Channel 1) /channel/1/mute 1 (Mute Channel 1) |
Crossfade Value Between Two Spacemaps on a Channel | /channel/1-32/crossfade | -100 to 100 -100=Left Map 100% 100=Right Map 100% | /channel/1/crossfade -100 /channel/1/crossfade 0 /channel/1/crossfade 100 |
Control Channel Spread | /channel/1-32/spread | 0 to 100 0 = 0% 100 = 100% | /channel/1/spread 14 (Sets the Spread to 14%) NOTE: Spread is Logarithmic, 14% is Optimal for Most Cases |
Play Trajectory | /channel/1-32/trajectory/status | play | /channel/1/trajectory/status play |
Pause Trajectory | /channel/1-32/trajectory/status | pause | /channel/1/trajectory/status pause |
Stop and Restart Trajectory from Start Point | /channel/1-32/trajectory/status | stop | /channel/1/trajectory/status stop |
Control Mix Level | /mix/level | -90 to +10 -90 = -90 dB +10 = +10 dB | /mix/level 0 (Mix Level = 0 dB) /mix/level -6 (Mix Level = -6 dB) |
Control Mix Mute | /mix/mute | 0 = OFF 1 = ON | /mix/mute 0 (Unmute the Mix) /mix/mute 1 (Mute the Mix) |
Control System Trim Level | /system/level | -90 to +10 -90 = -90 dB +10 = +10 dB | /system/level 0 (System Trim Level = 0 dB) /system/level -6 (System Trim Level = -6 dB) |
Recall Channel Snapshot | /recall/channel | Use the External Recall ID Value Found for Each Snapshot to Recall | /recall/channel 3003 (Recalls the Channel Snapshot with the External Recall ID of 3003) |
Recall Mix Snapshot | /recall/mix | Use the External Recall ID Value Found for Each Snapshot to Recall | /recall/mix 2002 (Recalls the Mix Snapshot with the External Recall ID of 2002) |
Recall System Snapshot | /recall/system | Use the External Recall ID Value Found for Each Snapshot to Recall | /recall/system 1001 (Recalls the System Snapshot with the External Recall ID of 1001) |
Translating QLab regular expressions into channel range commands
Channel Range Values | QLab Regular Expression Values | Example Range Cues |
|---|---|---|
Channels 1-9 | [1-9] | /channel/[1-9]/position: #x# #y# |
Channels 10-19 | 1[0-9] | /channel/1[0-9]/position: #x# #y# |
Channels 20-29 | 2[0-9] | /channel/2[0-9]/position: #x# #y# |
Channels 10-19 | 1[0-9] | /channel/1[0-9]/position: #x# #y# |