In this article:
Introduction
Track OSC
Enable OSC
Add OSC Tracks to your Act's Timeline
Add OSC Cues to an OSC Track in your Act's Timeline
Introduction
Track OSC is the use of OSC Tracks for adding and triggering OSC Cues from an Act's Timeline. Using Track OSC in CuePilot is a powerful way for CuePilot to control even more devices. OSC Tracks use OSC Schemas designed to control a specific device. There is a range of built in OSC Schemas and you can expand on that functionality by importing your own custom OSC Schemas to a Project. CuePilot only sends OSC messages, it does not receive OSC messages from other devices or API's.
Track OSC
OSC Tracks enable sending commands/messages as they are defined in an OSC Schema. When you add an OSC Track you decide which OSC Schema to use. The commands/messages are added as an OSC Cue in an OSC Track in the Timeline and they consist of an OSC address and arguments that can be specified. An example could be:
/cue/{cue_number}/start {volume}, {pan}
The parameters, i.e the address and arguments - can be viewed and edited by selecting the Cue and adjusting it in the Edit dialog.
An OSC Schema includes supported commands and its parameters. Each command is described and defined and includes fields for adjusting parameters which are limited to the valid range for each editable element - both in the address and in the arguments. As an example {volume} in this OSC Schema might be definite to be input as a number in the range of 0 to 1, with 0 = 0% volume, to 1 = 100% volume.
Enable OSC
- In Setup > OSC, change the Status from Disabled to Enabled.
- With OSC enabled, you can set which Interface and Interface IP that your computer is to use to send the OSC commands from. If you're only connected to a network using one interface, i.e. only via ethernet, then you can leave your Interface as Default and CuePilot will send commands from that Interface IP address.
If your device is connected to more than one type of network interface, i.e. connected via ethernet as well as Wi-Fi, then you will need to switch from Default to Set Manually to tell CuePilot which interface to use, otherwise CuePilot will default to your system's default. Once Set Manually enter the desired Interface IP. With OSC enabled you will see an OSC icon in the status bar.
Click here to learn more about Networking...
Add OSC Tracks to your Act's Timeline
Open your Act, and then in the Tracks List, under Add Track select Add OSC Track.
Give the OSC Track a Label, to help tell them apart, for example, 'Disguise'.
Enter the IP address of the device/system that is to receive the OSC commands.
Define the Port that the OSC commands are sent on.
Choose an OSC Schema for this OSC Track from the installed OSC Schemas, for example, 'Disguise'.
Learn more about: Custom OSC Schemas in CuePilot....
Add OSC Cues to an OSC Track in your Act's Timeline
As an example, let's add OSC commands to black out the big screen, and then turn it back on, so that it is not seen during a wide shot. With the disguise OSC Track added to our timeline, we're ready to add some OSC cues.
With the OSC Track selected, the Add Buttons will show you the commands that are available as part of the selected OSC Schema.
Move the Playhead in the Timeline to where you want to black out the big screen. Select a command to add a Cue to the timeline at the position of the Playhead, i.e. 'Brightness'.
Press the Enter/Return key, or double click on the Cue to open its Edit dialog and set the possible parameters of the Cue.
Here you could change the Command to any commands supported by that OSC Schema. We have already selected 'Brightness' but you could change a command using this drop-down menu. Different commands will have different parameters.
Give the Cue a name, i.e. 'Blackout the Big Screen'.
Enter the Value of the command that corresponds to the device actioning it. Shown below will be a description of the command and also an example of how the value needs to be entered. i.e. for Disguise's brightness command the value of the brightness is entered as a number from 0.00 to 1.00, where 0.00 is no brightness and 1.00 is full brightness. We want to black out the screen so let's set the brightness to be 0.00.
Now that this has been set, let's move the play head to where we want to turn the screen back on, add another OSC Cue for Brightness, give it a name, i.e. 'Brightness 100% on Big Screen' and set its corresponding parameters.
Learn more:
OSC in CuePilot...
Custom OSC Schemas in CuePilot...
Networking...