====== 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; 
<pre>
/cuecam/marker/teal/Director Note
/cuecam/marker/teal Director Note
/cuecam/marker/teal "Director Note"
/cuecam/marker/teal [s:"Director Note"] (string parameter)
</pre>
----
===== Control =====
<table>
<tr><td [width=200]>''/cuecam/start''</td><td>Start Video Recording</td></tr>
<tr><td [width=200]>''/cuecam/stop''</td><td>Stop Video Recording</td></tr>
<tr><td [width=200]>''/cuecam/snap''</td><td>Take Cue Snap (Still Photo)</td></tr>
</table>

===== Stop Watch =====

<table>
<tr><td [width=200]>''/cuecam/timer/start''</td><td>Start Stopwatch</td></tr>
<tr><td [width=200]>''/cuecam/timer/stop''</td><td>Stop Stopwatch <small>- Next start will be from 00:00:00</small></td></tr>
<tr><td [width=200]>''/cuecam/timer/pause''</td><td>Pause Stopwatch <small>- Next start will be from current time</small></td></tr>
<tr><td [width=200]>''/cuecam/timer/reset''</td><td>Reset Stopwatch to 00:00:00</td></tr>
<tr><td [width=200]>''/cuecam/timer/off''</td><td>Hide Stopwatch</td></tr>
</table>


===== 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.

<table>
<tr><td [width=200]>''/cuecam/mark [label]''</td><td>Add Marker</td></tr>
<tr><td [width=200]>''/cuecam/mark/[colour] label''</td><td>Add Marker with specified colour</td></tr>
<tr><td [width=200]>''/cuecam/tag/N''</td><td>Select tag N (0-5, 0 for none)</td></tr>
<tr><td [width=200]>''/cuecam/tag/TAG''</td><td>Select tag by word (e.g. Performance or Dress)</td></tr>
<tr><td [width=200]>''/cuecam/tag/custom/[colour] tag''</td><td>Set a custom tag with specified colour</td></tr>
</table>
 

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 ====

The title itself can be edited by OSC as of version 1.30

<table>
<tr><td [width=200]>''/cuecam/show/title [title]''</td><td>Set Show Title</td></tr>
<tr></tr></table>



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 which is how I use it. 

<table>
<tr><td [width=200]>''/cuecam/show/number [number]''</td><td>Set Show Number</td></tr>
<tr><td [width=200]>''/cuecam/show/number/c''</td><td>Clear Show Number</td></tr>
<tr><td [width=200]>''/cuecam/show/number/a/[0-9]''</td><td>Append Digit</td></tr>
<tr><td [width=200]>''/cuecam/show/number/incr''</td><td>Increment Show Number (+1)</td></tr>
<tr><td [width=200]>''/cuecam/show/number/decr''</td><td>Decrement Show Number (-1)</td></tr>
<tr></tr></table>


===== Configuration =====

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) 

<table>
<tr><td [width=200]>''/cuecam/set/clean [on|off]''</td><td>Enable Clean Recording</td></tr>
<tr><td [width=200]>''/cuecam/set/upload [on|off]''</td><td>Enable Dropbox Upload</td></tr>
<tr><td [width=200]>''/cuecam/set/cuesnaps [on|off]''</td><td>Enable Cue Snaps</td></tr>
<tr><td [width=200]>''/cuecam/lock''</td><td>Lock CueCam (See [[Locking]])</td></tr>
<tr><td [width=200]>''/cuecam/unlock''</td><td>Unlock CueCam</td></tr>
</table>