OSC Commands
The OSC commands have been designed for use with ETC Eos and are not strict in how they are formatted as it is not possible to send specific 'parameters' with ETC's Send_String function in Macros or Magic Sheets.
Therefore, if you want to set a teal marker for “Director Note” for example, the following are all equivalent;
/cuecam/marker/teal/Director Note /cuecam/marker/teal Director Note /cuecam/marker/teal “Director Note” /cuecam/marker/teal [s:“Director Note”] (string parameter)
Control
/cuecam/start | Start Video Recording |
/cuecam/stop | Stop Video Recording |
/cuecam/snap | Take Cue Snap (Still Photo) |
Stop Watch
/cuecam/timer/start | Start Stopwatch |
/cuecam/timer/stop | Stop Stopwatch - Next start will be from 00:00:00 |
/cuecam/timer/pause | Pause Stopwatch - Next start will be from current time |
/cuecam/timer/reset | Reset Stopwatch to 00:00:00 |
/cuecam/timer/off | Hide Stopwatch |
Markers and Tags
See Markers for more information on how I use these, but you can ultimately do what you want with them! Tags are the 'whole recording' cousin of Markers, they aren't ephermal in the same way and can also be used to tag a filename.
/cuecam/mark [label] | Add Marker |
/cuecam/mark/[colour] label | Add Marker with specified colour |
/cuecam/tag/N | Select tag N (0-5, 0 for none) |
/cuecam/tag/TAG | Select tag by word (e.g. Performance or Dress) |
/cuecam/tag/custom/[colour] tag | Set a custom tag with specified colour |
Valid colours for both Markers and Tags are: red, magenta, orange, amber, green, teal, cyan, blue, violet. In each case they can be abbreviated to the first character e.g./cuecam/mark/m MARK would create a magenta marker.
Content
Title
/cuecam/show/title [title] | Set Show Title |
The title can incorporate a Show Number that can be manipulated by OSC. This is handy for keeping track of specific versions, rehearsals, performance numbers etc.
To use this simply include ## where you would like the show number to appear in the Title
Show Number
The Show Number, when present, can be managed in a number of ways designed to make it easy to adjust from the desk, or programatically as part of your show file (e.g. increment each time the preset is fired)
The unusual arrangement of clear and append makes little sense at first, but it allows for the easy creation of a number pad on a magic sheet.
/cuecam/show/number [number] | Set Show Number |
/cuecam/show/number/c | Clear Show Number |
/cuecam/show/number/a/[0-9] | Append Digit |
/cuecam/show/number/incr | Increment Show Number (+1) |
/cuecam/show/number/decr | Decrement Show Number (-1) |
Watermark
You can adjust the opacity of your watermark (whether text or image) by OSC, you can also directly set the content of the text watermark.
/cuecam/watermark [0-1] | Set Watermark Opacity |
/cuecam/watermark/text [watermark] | Set Watermark Text |
Configuration
Mode Toggles
Each of these options will accept 1, on, or yes as an *On* condition and 0, off, or no as an *Off* condition either as a parameter, or the end of the address (e.g. /cuecam/set/clear/on and /cuecam/set/clear 1 are equivalent)
/cuecam/set/clean [on|off] | Enable Clean Recording |
/cuecam/set/upload [on|off] | Enable Dropbox Upload |
/cuecam/set/cuesnaps [on|off] | Enable Cue Snaps |
Exposure
You can adjust the exposure of the image via OSC. This can be used to programatically adjust for much darker / lighter scenes or to remotely adjust the exposure based on the RTSP video feed. This can also be done whilst recording.
/cuecam/set/clean [-4 > 4] | Set Exposure (between -4 and 4) |
/cuecam/exposure/incr | Decrease Exposure (by 0.2) |
/cuecam/exposure/decr | Increase Exposure (by 0.2) |
/cuecam/exposure/auto | Reset exposure to Auto |
Lock
See Locking for more information, this locks and hides CueCam's user interface in operation.
/cuecam/lock | Lock CueCam |
/cuecam/unlock | Unlock CueCam |