QLab

Control Using QLab

Spacemap Go Help


This page details how to connect QLab to Spacemap Go and provides examples of the various control points that QLab can control.

download Example QLab Project

This QLab example file has example Network cues for the SpaceMap Go OSC commands listed below. QLab’s 2D and 1D fade feature within a Network cue enables smooth transitions between control point values.

Hardware and Software Requirements
  • Galileo GALAXY processor booted into Spacemap Mode – requires firmware version included with Compass software version 4.8, or later. 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.
Connection Steps

Spacemap Go communicates with QLab using the standard Open Sound Control (OSC) network protocol via port 38033 on the GALAXY processor.

  • 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 System IP address of the Spacemap Go system (GALAXY processor(s) and iPad).
When using Virtual GALAXY in Compass software, the Virtual GALAXY runs on the host computer, so the localhost address will be targeted instead of the GALAXY IPv4 address.

Step 1: In Spacemap Go, tap SETTINGS VIEW (bottom), then SYSTEM SETTINGS > EXTERNAL DEVICE CONTROL.

Step 2: Enter the Spacemap System IP Configuration, Server IPv4 Address and Subnet Mask.

  • Enter the IPv4 address and Subnet Mask (255.255.255.0) of the GALAXY processor with the lowest IPv4 address (192.168.1.101).
  • Virtual GALAXY: Leave this blank.

Step 3: Enter the General Purpose OSC, External Device IPv4 Address and Receiving Port.

  • Enter the IPv4 address of the QLab computer.
  • Toggle the ENABLE button.
  • Enter Port number 38033.
  • Virtual GALAXY: Enter Address 127.0.0.1 and port 38033 or leave “Any” and “0”

Settings, External Device Connection – System and General Purpose OSC IP Settings

Step 4: Set the IPv4 address of the computer in the same IP address range as the Spacemap Go system.

Setting IPv4 address of Apple computer manually

Setting IPv4 address of Apple computer

Step 5: Verify the QLab Aliases IP address is the same as the computer IP and within the same range as the Spacemap Go system IP address.

Step 6: Set the network settings in QLab: under NETWORK > NETWORK CUE DESTINATION PATCHES, select the Spacemap Go interface, type in the Spacemap Go system IP and the port 38033.

Visual of how to set the QLab network settings.

QLab Network Settings


Example QLab Cues

Currently, Spacemap Go communicates with QLab via the control points listed below. QLab allows for 2D and 1D fades of certain Spacemap Go control points. See the examples below.

NOTE: OSC does not support integer ranges within an address. Ranges must use regular expression values. See the chart below to translate channel ranges into usable OSC ranges within an OSC message.

Channel Ranges Translated to QLab Range Cues

Translating QLab Regular Expressions into Channel Range Commands

 

Spacemap Go OSC Commands and Examples

 

Spacemap Go QLab Examples

Set Channels 1–9 to the Static Position of X=500, Y=200

/channel/[1-9]/position:1 500 200

Set Channels 1–9 to 2D Fade

NOTE: To create a 2D fade of a position, the following QLab Network Cue Settings must be made (these correspond to the screenshot below):

  • Max X = 1000
  • Max Y = 1000
  • Fade = 2D Fade
  • FPS = 10 fps
  • Value = Integers
  • Duration = desired fade time (here set to 5 seconds)

The regular OSC commands would be:

  • /channel/1-32/position:0 = the x value of a channel’s (1-32) position within Spacemap
  • /channel/1-32/position:1 = the y value of a channel’s (1-32) position within Spacemap
/channel/[1-9]/position #x# #y#

Set a Static Crossfade for Channel 1 to 100% Left Map

/channel/1/crossfade -100

Set Channels 10–19 to Crossfade from Left Map to Right Map Over 5 Seconds

NOTE: To create a crossfade between two maps on a channel, the following QLab Network Cue Settings must be made (these correspond to the screenshot below):

  • From = -100
  • To = 100
  • Type = OSC message
  • Fade = 1D
  • FPS = 10 fps
  • Value = Floats
  • Duration = desired fade time (here set to 5 seconds)
/channel/1[0-9]/crossfade #V#

Set Channel 1 Spread to 100%

/channel/1/spread 100

Set Channels 1–9 to Spread 10% Over 5 Seconds

NOTE: To define a spread rate, the following QLab Network Cue Settings must be made (these correspond to the screenshot below):

  • From = 0
  • To = 10
  • Type = OSC message
  • Fade = 1D
  • FPS = 10 fps
  • Value = Floats
  • Duration = desired fade time (here set to 5 seconds)
/channel/[1-9]/spread #V#

Set Channel 1 Level to 0 dB

/channel/1/level 0

Set Channels 1-9 Levels to Fade from 0 dB to -∞ dB Over 5 Seconds

NOTE: To create a level fade, the following QLab Network Cue Settings must be made (these correspond to the screenshot below):

  • From = 0
  • To = -99
  • Type = OSC message
  • Fade = 1D
  • FPS = 10 fps
  • Value = Integers
  • Duration = desired fade time (here set to 5 seconds)
/channel/[1-9]level #V#

Mute Channel 1

/channel/1/mute 1

Mute Channels 10–19

/channel/1[0-9]/mute 1

Mute the Mix

/mix/mute/1

Set the Mix Level to Fade to -35 dB Over 5 Seconds From 0 dB

NOTE: To create a level fade, the following QLab Network Cue Settings must be made (these correspond to the screenshot below):

  • From = 0
  • To = -35
  • Type = OSC message
  • Fade = 1D
  • FPS = 10 fps
  • Value = Integers
  • Duration = desired fade time (here set to 5 seconds)
/mix/level #V#

Recall the System Snapshot with the External Recall ID of 1036

/recall/system 1036

Recall the Mix Snapshot with the External Recall ID of 1035

/recall/mix 1035

Recall the Channel Snapshot with the External Recall ID of 1037

/recall/channel 1037

Set the System Level to -35 dB

/system/level -35

 


For personal assistance, please visit: meyersound.com/contact, select Technical Support, and use the form to create a support case.