ETC - ColorSource AV
Module currently in beta. (Released v0.8.12).
This module allows control of playback, selection levels of the ETC ColorSource 20 AV & ColorSource 40 AV lighting consoles through their OSC API.
The ColorSource AV's onboard faders can be used as direct channel controls or as playback faders. For preprogrammed shows, ColorSource consoles include comprehensive cue stack functionality and allow the additional faders as submasters, group masters, or a grandmaster. The full OSC API has been implemented into this Ctrl Suite Module.
| Module Rating | |
|---|---|
| Quality of API | 2/3 |
| Implementation | 3/3 |
| Status | Early |
See the Modules Overview article for information about how Module Ratings are calculated.
Module Settings
- ColorSource AV Patch - Select an OSC patch (IP address) from the Module Settings.
Process Block
After creating a ETC ColorSource module, a block will be generated for it within Ctrl Suite's Process Editor for integration as part of a process flow.
Create a Process node or edit an existing one to use the block's full functionality.
Endpoints
The endpoints this module supports include:
| Endpoints | Option 1 | Option 2 | Notes |
|---|---|---|---|
| Cues | - | - | - |
| Next Cue | - | - | Runs the next cue. |
| Go To Cue | Cue Number [1..1000] | - | Goes to the specified cue in the cue list (Integer). |
| Go Back One Cue | - | - | Runs the previous cue. |
| Selection | - | - | - |
| Pause Playback | - | - | Pauses an active cue change. |
| Select Channel | Channel [1..10000] | - | Exclusively select a specific channel (Integer). |
| Add Channel To Selection | Channel [1..10000] | - | Add a specific channel to the current selection (Integer). |
| Subtract Channel From Selection | Channel [1..10000] | - | Remove a specific channel to the current selection (Integer). |
| Select Thru Channel | Channel [1..10000] | - | Select every channel from the last channel selected 'thru' to the specific channel selected (Integer). |
| Select Location Group | Location Group Number [0..1000] | - | Selects all channels in the location group (Integer). |
| Select Tag Group | Tag Group Number [0..1000] | - | Selects all channels in the tag group. (Integer). |
| Attribute Controls | - | - | - |
| Selected Channel Level | Level [0..255] | - | Sets the selected channel to the specified level. |
| Level Wheel | Level [0..255] | - | increases or redules the selected channel's level by the specified ammount. |
| Pan Wheel | Pan [0..100] | - | Steps the selected channel's pan value by the specified ammount. |
| Tilt Wheel | Tilt [0..100] | - | Steps the selected channel's tilt value by the specified ammount. |
| Pan Tilt | Pan [0..100] | Tilt [0..100] | Steps the selected channel's pan and tilt values by the user defined value. |
| Set Color | Hue [0..360] | Saturation [0..100] | Sets the selected channel's color to the user defined hue and saturation values (Integer). |
| Color Chip Select | Chip [1..999999] | - | Sets the selected channel's color to the color chip value defined (Integer). |
| Playback Controls | |||
| Activate Playback | Playback [1..1000] | - | Activates the specified playback. |
| Execute Playback | Playback [1..1000] | - | Executes the specified playback (Integer). |
| Playback Bump Button | Playback [1..1000] | Button state [Press/Release] | Sets the specified state for a user specified bump button. |
| Playback Level | Playback [1..1000] | Level [0..1] | Sets the level of a playback to a user defined value (Playback = Integer, Level = Float). |
| Jump Pages Forward | Number of Pages [1..10] | - | Jumps the current playback page forward by a user defined value (use 1 for next page) (Integer). |
| Jump Pages Back | Number of Pages [-1..-10] | - | Jumps the current playback page back by a user defined value (use [-1] for previous page). |
| Console Keys | - | - | - |
| Record Snapshot Key | - | - | Records a snapshot of the active state in a memory. |
| Record Next Cue Key | - | - | Records the active state into the next cue. |
| Clear All Key | - | - | Clears all the selections, active channels, playbacks and cues. |
| Clear Playbacks Key | - | - | Clears the active playbacks. |
| Clear Cues Key | - | - | Clears the active cue. |
| Clear Channels Key | - | - | Clears the active channels. |
| Clear Selection Key | - | - | Clears the user's selected channels. |
| Toggle Blackout Key | - | - | Toggles the blackout state. |
| Toggle Audio Mute Key | - | - | Toggles audio mute. |
| Toggle Video Output Key | - | - | Toggles video output. |
| Toggle Media Play / Pause Key | - | - | Pauses or plays media. |
| Toggle Ind1 Key | - | - | Toggles Ind1. |
| Toggle Ind2 Key | - | - | Toggles Ind2. |
Note: Ctrl Suite's ETC ColorSource AV OSC API implementation is unidirectional only.
Colour Picker Interface Component
The ETC ColorSource AV Colour Picker module can be found within the Add Components view when creating interfaces. This allows end users of the system to interact with the colour of the ETC ColorSource AV in real time through Ctrl Player user interfaces. Use this as an alternative to controling colour through sliders.
Once this colour picker UI component has been added, navigate to its Settings and link it to an ETC ColorSource AV module for it to begin controlling the output colour.
Troubleshooting:
- Ensure that the ETC ColorSource AV OSC input port matches the OSC port defined in Ctrl Suites OSC patch.
- Some variable fields of the ColorSource AV require OSC arguments to be formatted as Integers. If using a slider on a Ctrl Suite Interface to control a variable field of the ColorSource AV, navigate to its Settings and ensure the output is set to the correct range and is defined as an Integer. (Failing to do so could cause the output to flicker).
- Ensure you are using the ETC ColorSource AV console instead of the standard ColorSource. (The standard ColorSource AV does not support OSC).
Additional Resources
- When using OSC, ON LX reccomends the use of a wired network as opposed to WiFi wherever possible, for further advice surrounding UDP based protocols see this article.