]> Shamusworld >> Repos - ardour-manual/blobdiff - include/osc58-controlling-ardour-with-osc.html
Converts <img> to <figure> where it makes sense
[ardour-manual] / include / osc58-controlling-ardour-with-osc.html
index 27b3551b65aa8ce53a33494ffb83a583f00d5fbe..e6ba85f670988629cbf10d0509b16521d6d5f03c 100644 (file)
@@ -14,7 +14,7 @@
   to gain controls. If you are using an Ardour version of 4.7 or less,
   please read <a
   href="@@osc-control-for-ardour-4.7-and-prior">
   to gain controls. If you are using an Ardour version of 4.7 or less,
   please read <a
   href="@@osc-control-for-ardour-4.7-and-prior">
-  Osc control in ardour 4.7 and prior.</a>
+  Osc control in Ardour 4.7 and prior.</a>
 </p>
 
 <p>
 </p>
 
 <p>
@@ -53,9 +53,9 @@ here</em>"/&gt;</kbd>
 <h2>Control Surface Set Up</h2>
 
 <p>
 <h2>Control Surface Set Up</h2>
 
 <p>
-  Control surface set up allows the controller to tell Ardour about it's
+  Control surface set up allows the controller to tell Ardour about its
   capabilities. The surface can tell Ardour how many control strips it
   capabilities. The surface can tell Ardour how many control strips it
-  has for banking, if it is capable of setting it's faders or buttons
+  has for banking, if it is capable of setting its faders or buttons
   to values set by Ardour's GUI or automation, What kind of math the
   faders use and more.
 </p>
   to values set by Ardour's GUI or automation, What kind of math the
   faders use and more.
 </p>
@@ -158,7 +158,7 @@ here</em>"/&gt;</kbd>
   then adding all those numbers together for a value to send.
 </p>
 <p>Please see: <a
   then adding all those numbers together for a value to send.
 </p>
 <p>Please see: <a
-  href="@@osc58-feedback-and-strip-types-values">
+  href="@@osc58-feedback-and-strip-types-values#feedback">
   Calculating Feedback and Strip-types Values.</a></p>
 <p class="note">
        Feedback can also be set with <em>/set_surface/feedback feedback.</em>
   Calculating Feedback and Strip-types Values.</a></p>
 <p class="note">
        Feedback can also be set with <em>/set_surface/feedback feedback.</em>
@@ -323,16 +323,22 @@ here</em>"/&gt;</kbd>
   <td>dB is a float indicating the desired gain in dB</td></tr>
   <tr><th><kbd class="osc">/master/fader  <em>position</em></kbd></th>
   <td>position is a float between 0 and 1 setting the desired position of the fader</td></tr>
   <td>dB is a float indicating the desired gain in dB</td></tr>
   <tr><th><kbd class="osc">/master/fader  <em>position</em></kbd></th>
   <td>position is a float between 0 and 1 setting the desired position of the fader</td></tr>
+  <tr><th><kbd class="osc">/master/db_delta <em>delta</em></kbd></th>
+  <td>where <em>delta</em> is a float that will increase or decrease the gain of master by the amount of the delta. (Ardour 5.11+)</td></tr>
   <tr><th><kbd class="osc">/master/trimdB <em>dB</em></kbd></th>
   <td>dB is a float from -20 to +20 representing the desired trim gain in dB</td></tr>
   <tr><th><kbd class="osc">/master/pan_stereo_position <em>position</em></kbd></th>
   <td>position is a float from 0 to 1 representing the desired pan position</td></tr>
   <tr><th><kbd class="osc">/master/trimdB <em>dB</em></kbd></th>
   <td>dB is a float from -20 to +20 representing the desired trim gain in dB</td></tr>
   <tr><th><kbd class="osc">/master/pan_stereo_position <em>position</em></kbd></th>
   <td>position is a float from 0 to 1 representing the desired pan position</td></tr>
-  <tr><th><kbd class="osc">/master/mute  <em>state</em></kbd></th>
+  <tr><th><kbd class="osc">/master/mute  <em>key</em></kbd></th>
+  <td>key is an optional float 1 representing a master bus select</td></tr>
+  <tr><th><kbd class="osc">/master/select  <em>state</em></kbd></th>
   <td>state is an int of o or 1 representing the desired mute state</td></tr>
   <tr><th><kbd class="osc">/monitor/gain <em>dB</em></kbd></th>
   <td>dB is a float indicating the desired gain in dB</td></tr>
   <tr><th><kbd class="osc">/monitor/fader  <em>position</em></kbd></th>
   <td>position is a float between 0 and 1 setting the desired position of the fader</td></tr>
   <td>state is an int of o or 1 representing the desired mute state</td></tr>
   <tr><th><kbd class="osc">/monitor/gain <em>dB</em></kbd></th>
   <td>dB is a float indicating the desired gain in dB</td></tr>
   <tr><th><kbd class="osc">/monitor/fader  <em>position</em></kbd></th>
   <td>position is a float between 0 and 1 setting the desired position of the fader</td></tr>
+  <tr><th><kbd class="osc">/monitor/db_delta <em>delta</em></kbd></th>
+  <td>where <em>delta</em> is a float that will increase or decrease the gain of monitor by the amount of the delta. (Ardour 5.11+)</td></tr>
   <tr><th><kbd class="osc">/monitor/mute  <em>state</em></kbd></th>
   <td>state is an int of 0 or 1 where 1 is muted</td></tr>
   <tr><th><kbd class="osc">/monitor/dim  <em>state</em></kbd></th>
   <tr><th><kbd class="osc">/monitor/mute  <em>state</em></kbd></th>
   <td>state is an int of 0 or 1 where 1 is muted</td></tr>
   <tr><th><kbd class="osc">/monitor/dim  <em>state</em></kbd></th>
@@ -367,6 +373,9 @@ here</em>"/&gt;</kbd>
   <td>Where <em>delta</em> is a float of 1 to bank up and -1 is bank down for use with an encoder (Ardour 5.11+)</td></tr>
   <tr><th><kbd class="osc">/bank_down </kbd></th>
   <td>Change bank to the next lower bank.</td></tr>
   <td>Where <em>delta</em> is a float of 1 to bank up and -1 is bank down for use with an encoder (Ardour 5.11+)</td></tr>
   <tr><th><kbd class="osc">/bank_down </kbd></th>
   <td>Change bank to the next lower bank.</td></tr>
+  <tr><th><kbd class="osc">/use_group <em>state</em></kbd></th>
+  <td>Where <em>state</em> is a float of 1 to use group or 0 to not use group.
+  <a href="@@osc58-feedback-and-strip-types-values#use-group">more info on use_group</a></td></tr>
   <tr><th><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></th>
   <td>where <em>mute_st</em> is a bool/int representing the desired mute state of the track</td></tr>
   <tr><th><kbd class="osc">/strip/solo <em>ssid</em> <em>solo_st</em></kbd></th>
   <tr><th><kbd class="osc">/strip/mute <em>ssid</em> <em>mute_st</em></kbd></th>
   <td>where <em>mute_st</em> is a bool/int representing the desired mute state of the track</td></tr>
   <tr><th><kbd class="osc">/strip/solo <em>ssid</em> <em>solo_st</em></kbd></th>
@@ -504,6 +513,8 @@ here</em>"/&gt;</kbd>
   <td>Where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</td></tr>
   <tr><th><kbd class="osc">/select/fader <em>position</em></kbd></th>
   <td>Where <em>position</em> is an float ranging from 0 to 1 representing the fader control position.</td></tr>
   <td>Where <em>gain</em> is a float ranging from -193 to 6 representing the desired gain of the track in dB.</td></tr>
   <tr><th><kbd class="osc">/select/fader <em>position</em></kbd></th>
   <td>Where <em>position</em> is an float ranging from 0 to 1 representing the fader control position.</td></tr>
+  <tr><th><kbd class="osc">/select/db_delta <em>delta</em></kbd></th>
+  <td>where <em>delta</em> is a float that will increase or decrease the gain of the selected track by the amount of the delta. (Ardour 5.11+)</td></tr>
   <tr><th><kbd class="osc">/select/*/automation  <em>mode</em></kbd></th>
   <td>where <em>mode</em> is an int ranging from 0 to 3 representing the desired automation mode for the control.
   <a href="@@osc58-automation">See OSC Automation.</a></td></tr>
   <tr><th><kbd class="osc">/select/*/automation  <em>mode</em></kbd></th>
   <td>where <em>mode</em> is an int ranging from 0 to 3 representing the desired automation mode for the control.
   <a href="@@osc58-automation">See OSC Automation.</a></td></tr>
@@ -589,7 +600,7 @@ Any of these actions that can be moved to session->action calls may reapear.
   <tr><th><kbd class="osc">/quick_snapshot_stay</kbd></th>
   <td>Take a snapshot and keep working on this version</td></tr>
   <tr><th><kbd class="osc">/fit_*_track(s)</kbd></th>
   <tr><th><kbd class="osc">/quick_snapshot_stay</kbd></th>
   <td>Take a snapshot and keep working on this version</td></tr>
   <tr><th><kbd class="osc">/fit_*_track(s)</kbd></th>
-  <td>Were <em>*</em> is one of 1, 2, 4, 8, 16, 32 or all. Fits this
+  <td>Where <em>*</em> is one of 1, 2, 4, 8, 16, 32 or all. Fits this
   many tracks in editor window. (add s for more than 1)</td></tr>
   <tr><th><kbd class="osc">/zoom_*</kbd></th>
   <td>Zoom editor to include <em>*</em> where <em>*</em> is 100_ms, 1_sec,
   many tracks in editor window. (add s for more than 1)</td></tr>
   <tr><th><kbd class="osc">/zoom_*</kbd></th>
   <td>Zoom editor to include <em>*</em> where <em>*</em> is 100_ms, 1_sec,
@@ -610,3 +621,4 @@ Any of these actions that can be moved to session->action calls may reapear.
   <td>Uses edit range as punch range</td></tr>
   <dt><kbd class="osc">/toggle_all_rec_enables</kbd></th>
   <td>(toggles all tracks' recording state)</dd-->
   <td>Uses edit range as punch range</td></tr>
   <dt><kbd class="osc">/toggle_all_rec_enables</kbd></th>
   <td>(toggles all tracks' recording state)</dd-->
+