</p>
<ul>
<li>
- <a href="#set-up">Control Surface Set</a>
+ <a href="#osc_set-up">Control Surface Set</a>
</li>
<li>
- <a href="#global">Master or Global messages</a>
+ <a href="#osc_global">Master or Global messages</a>
</li>
<li>
- <a href="#transport">Transport Control</a>
+ <a href="#osc_transport">Transport Control</a>
</li>
<li>
- <a href="#recording">Recording control</a>
+ <a href="#osc_recording">Recording control</a>
</li>
<li>
- <a href="#information">Transport Information</a>
+ <a href="#osc_information">Transport Information</a>
</li>
<li>
- <a href="#editing">Editing-related</a>
+ <a href="#osc_editing">Editing-related</a>
</li>
<li>
- <a href="#Master-strip">Master and Monitor strip control</a>
+ <a href="#osc_Master-strip">Master and Monitor strip control</a>
</li>
<li>
- <a href="#strips">Track specific operations</a>
+ <a href="#osc_strips">Track specific operations</a>
</li>
<li>
- <a href="#select">Selected Strip Operations</a>
+ <a href="#osc_select">Selected Strip Operations</a>
</li>
<li>
- <a href="#menu">Menu actions</a>
+ <a href="#osc_menu">Menu actions</a>
</li>
</ul>
<p>
OSC feedback In Ardour.</a>
</p>
-<h2 id="set-up">Control Surface Set Up</h2>
+<h2 id="osc_set-up">Control Surface Set Up</h2>
<p>
Control surface set up allows the controller to tell Ardour about its
Gainmode is an int:
<ul>
<li><em>0:</em> dB value as a float from -193 to +6. Sent as
- <kbd class="osc">/strip/gain SSID value</kbd>. (-193 or below are the same as -inf)</li>
+ <kbd class="osc">/strip/gain SSID value</kbd>. (-193 or below are the same as −∞)</li>
<li><em>1:</em> A positional fader based on the same math
as Ardour's GUI. A Float from 0 to 1. Sent as
<kbd class="osc">/strip/fader SSID value</kbd>. At the same time the
href="@@osc58-parameter-types">
Parameter Types in OSC.</a>
</p>
-<h3 id="global">Master or Global messages</h3>
+<h3 id="osc_global">Master or Global messages</h3>
-<h4 id="transport">Transport Control</h4>
+<h4 id="osc_transport">Transport Control</h4>
<table class="dl">
<tr><th><kbd class="osc">/transport_stop</kbd></th>
<td>Stops a rolling transport</td></tr>
OSC Jog Modes</a></td></tr>
</table>
-<h4 id="recording">Recording control</h4>
+<h4 id="osc_recording">Recording control</h4>
<table class="dl">
<tr><th><kbd class="osc">/toggle_punch_in</kbd></th>
<td></td></tr>
<td>Toggles master record enable</td></tr>
</table>
-<h4 id="information">Transport Information</h4>
+<h4 id="osc_information">Transport Information</h4>
<table class="dl">
<tr><th><kbd class="osc">/transport_frame</kbd></th>
<td>Ardour sends /transport_frame <em>current_frame</em></td></tr>
<td>Ardour sends /record_enabled <em>recordenable_status</em></td></tr>
</table>
-<h4 id="editing">Editing-related</h4>
+<h4 id="osc_editing">Editing-related</h4>
<table class="dl">
<tr><th><kbd class="osc">/undo</kbd></th>
<td></td></tr>
<td>Set session name to <em>new_name</em> (if new_name is legal and unique)</td></tr>
</table>
-<h4 id="Master-strip">Master and Monitor strip control</h4>
+<h4 id="osc_Master-strip">Master and Monitor strip control</h4>
<table class="dl">
<tr><th><kbd class="osc">/master/gain <em>dB</em></kbd></th>
<td>dB is a float indicating the desired gain in dB</td></tr>
<td>state is an int of 0 or 1 where 1 is mono mode</td></tr>
</table>
-<h3 id="strips">Track specific operations</h3>
+<h3 id="osc_strips">Track specific operations</h3>
<p>
For each of the following, <em>ssid</em> is the Surface Strip ID for the track
</p>
<tr><th><kbd class="osc">/strip/spill <em>ssid</em></kbd></th>
<td> Use strips this strip is grouped with or those that feed this bus
(if this strip is a bus) or that this vca (if this is a VCA) controls.
- See <a href="#spill">Spill Strips</a> for more details</td></tr>
+ See <a href="#osc_spill">Spill Strips</a> for more details</td></tr>
<tr><th><kbd class="osc">/strip/hide <em>ssid</em> <em>y/n</em></kbd></th>
<td>Where <em>y/n</em> = 1 hide this strip, 0 for show this track.
<a href="@@osc58-feedback-and-strip-types-values#hidden">
<td>where <em>strip_name</em> is a string representing the desired name for the strip</td></tr>
<tr><th><kbd class="osc">/strip/group <em>ssid</em> <em>group_name</em></kbd></th>
<td>where <em>group_name</em> is a string representing the name of the group desired.
- See <a href="#groups">groups</a> for more details</td></tr>
+ See <a href="#osc_groups">groups</a> for more details</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/name <em>ssid</em> <em>name</em></kbd></th>
<td>where <em>name</em> is a string for the desired name of the track</td></tr>
</table>
-<h3 id="select">Selected Strip Operations</h3>
+<h3 id="osc_select">Selected Strip Operations</h3>
<p>
New for Ardour 5, A whole set of operations that work on the selected
or expanded strip.
<td>where <em>comment</em> is a string representing the desired comment for the strip</td></tr>
<tr><th><kbd class="osc">/select/group <em>group_name</em></kbd></th>
<td>where <em>group_name</em> is a string representing the name of the group desired.
- See <a href="#groups">groups</a> for more details</td></tr>
+ See <a href="#osc_groups">groups</a> for more details</td></tr>
<tr><th><kbd class="osc">/select/group/enable <em>state</em></kbd></th>
<td>where <em>state</em> is an int representing the desired enable state
of the group the selected strip is a part of</td></tr>
<tr><th><kbd class="osc">/select/spill</kbd></th>
<td> show only strips this strip is grouped with or
those that feed this bus or that this vca controls.
- See <a href="#spill">Spill Strips</a> for more details</td></tr>
+ See <a href="#osc_spill">Spill Strips</a> for more details</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>
<td>where <em>position</em> is a float ranging from 0 to 1 representing the desired front to back position of the track</td></tr>
<tr><th><kbd class="osc">/select/pan_lfe_control <em>value</em></kbd></th>
<td>where <em>value</em> is a float ranging from 0 to 1 representing the desired LFE control value for the track</td></tr>
- <tr><th><kbd class="osc">/select/send_gain", <em>sendid</em> <em>send_gain</em></kbd></th>
+ <tr><th><kbd class="osc">/select/send_gain, <em>sendid</em> <em>send_gain</em></kbd></th>
<td>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
ranging from -193 to +6 representing the desired gain in dB for the send</td></tr>
- <tr><th><kbd class="osc">/select/send_fader", <em>sendid</em> <em>send_gain</em></kbd></th>
+ <tr><th><kbd class="osc">/select/send_fader, <em>sendid</em> <em>send_gain</em></kbd></th>
<td>where <em>sendid</em> = nth_send, <em>send_gain</em> is a float
ranging from 0 to 1 representing the desired position for the send as a fader</td></tr>
- <tr><th><kbd class="osc">/select/send_enable", <em>sendid</em> <em>state</em></kbd></th>
+ <tr><th><kbd class="osc">/select/send_enable, <em>sendid</em> <em>state</em></kbd></th>
<td>where <em>sendid</em> = nth_send, <em>state</em> is 1 for enabled and 0 for disabled</td></tr>
- <tr><th><kbd class="osc">/select/send_page", <em>delta</em></kbd></th>
+ <tr><th><kbd class="osc">/select/send_page, <em>delta</em></kbd></th>
<td>where <em>delta</em> is an int or float selecting another send as a delta from the current send.</td></tr>
- <tr><th><kbd class="osc">/select/plugin_page", <em>delta</em></kbd></th>
+ <tr><th><kbd class="osc">/select/plugin_page, <em>delta</em></kbd></th>
<td>where <em>delta</em> is an int or float selecting another plugin parameter as a delta from the current parameter.</td></tr>
- <tr><th><kbd class="osc">/select/plugin/activate", <em>state</em></kbd></th>
+ <tr><th><kbd class="osc">/select/plugin/activate, <em>state</em></kbd></th>
<td>where <em>state</em> is an int or float with the desired state of the current plugin activation.(new Ardour 6.0)</td></tr>
- <tr><th><kbd class="osc">/select/plugin/parameter", <em>plugin</em> <em>parameter</em> <em>value</em></kbd></th>
+ <tr><th><kbd class="osc">/select/plugin/parameter, <em>plugin</em> <em>parameter</em> <em>value</em></kbd></th>
<td>where <em>plugin</em> = nth plugin, <em>parameter</em> = nth parameter and <em>value</em> is a float from 0 to 1</td></tr>
</table>
<p class="note">
for page up and a switch with a value of <code>-1</code> for page down. An encoder
can be used as well. (these commands were added in Ardour version 5.10)
</p>
-<h4 id="groups">Using groups with strip and select (new for Ardour 6.0)</h4>
+<h4 id="osc_groups">Using groups with strip and select (new for Ardour 6.0)</h4>
<p class="note">
No grouping will occure unless <code>use_group</code> is set either
by using <kbd class="osc">/set_surface/strip_types</kbd> with the use groups bit set
<p>To create a new group from a strip that is already joined to a group,
the strip must first remove itself from the current group.
</p>
-<h4 id="spill">Spill Strips</h4>
+<h4 id="osc_spill">Spill Strips</h4>
<p><kbd class="osc">/select/spill</kbd> or <kbd class="osc">/strip/spill</kbd>
will:</p>
<ul>
that are a part of the group the strip is a part of so long
as that strip is a track.</li>
<li>
- set the current set of strips to the set of strips that feed
+ set the current set of strips to the set of strips that feed
this strip if it is a bus. In the case where this strip is
being fed by sends rather than strip outputs, the strips that
feed this bus will have their names set to the name of the strip
<kbd class="osc">/strip/custom/mode <em>mode</em></kbd>.
</p>
-<h3 id="menu">Menu actions</h3>
+<h3 id="osc_menu">Menu actions</h3>
<p>
Every single menu item in Ardour's GUI is accessible via OSC. There is
a single common syntax to trigger the action as if it was selected
projects / ardour-manual / blobdiff