X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-querying-ardour.html;h=f94e28c5e140dfbbdcb638cb0a71f5208734eaf9;hb=976060f5e2c2064c0574f2f8764721452679db53;hp=018ded025c2dcfe5e494db3440dc47ede87687e4;hpb=042723be8949fe53bb488183a91e27c398d40ce4;p=ardour-manual

diff --git a/include/osc58-querying-ardour.html b/include/osc58-querying-ardour.html
index 018ded0..f94e28c 100644
--- a/include/osc58-querying-ardour.html
+++ b/include/osc58-querying-ardour.html
@@ -25,6 +25,8 @@
   <td>Asks for a list of descriptors for plug-in <em>piid</em> on strip <em>ssid</em></td></tr>
   <tr><th><kbd class="osc">/set_surface</kbd></th>
   <td>Ask for the current surface setting. Reply is in the same form as setting the surface would be.</td></tr>
+  <tr><th><kbd class="osc">/surface/list</kbd></th>
+  <td>Print a list of known surfaces and Link Sets to the log window.</td></tr>
 </table>
 
 <h3>A list of strips</h3>
@@ -181,4 +183,21 @@
 	access to plug-ins, the /select/plugin/ set of commands will handle most
 	needs.
 </p>
+<h3>Obtaining a list of surfaces Ardour knows about</h3>
+<p>
+	Ardour can work with more than one OSC control surface at a time.
+	Sometimes it is useful to know the information stored about all
+	surfaces. Sending <code>/surface/list</code> from any surface or selecting:
+	<kbd class="menu">Print surface information to Log window</kbd> from
+	the <kbd class="menu">Debug</kbd> dropdown in the OSC setup dialog,
+	will list all the information Ardour uses to calculate the feedback
+	it sends. The Log window can be opened from the menu with
+	<kbd class="option">Window &gt; Log</kbd>.
+	This would be useful information to include with any OSC
+	related Bug report. The output is printed in this format:
+</p>
+<p>
+<img alt="Surface Output"
+     src="/images/osc-surface-log.png">
+</p>