X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-querying-ardour.html;h=4c7fc6c5367668b46d62b9deecf8978dd4e4528d;hb=592b0257fc94cd2d1be69050cb78ab264749ee94;hp=fed62f370f8b9bef6bb9202def3a99846339e694;hpb=7be4f507991a0b87174a0e78831a4e7e9e96bcbe;p=ardour-manual

diff --git a/include/osc58-querying-ardour.html b/include/osc58-querying-ardour.html
index fed62f3..4c7fc6c 100644
--- a/include/osc58-querying-ardour.html
+++ b/include/osc58-querying-ardour.html
@@ -32,14 +32,22 @@
   current session has. Ardour replies with a message for each
   strip with the following information:
   <ul>
-    <li>Strip type</li>
+    <li>Strip type - One of:</li>
+    <ul>
+		<li>AT - Audio Track</li>
+		<li>MT - MIDI Track</li>
+		<li>B - Audio Bus</li>
+		<li>MB - MIDI bus</li>
+		<li>AX - Aux bus</li>
+		<li>V - VCA</li>
+    </ul>
     <li>Strip name</li>
     <li>Number of inputs</li>
     <li>Number of outputs</li>
-    <li>Muted (bool)</li>
-    <li>Soloed (bool)</li>
+    <li>Muted</li>
+    <li>Soloed</li>
     <li>Ssid (strip number)</li>
-    <li>Record enabled (bool)</li>
+    <li>Record enabled</li>
   </ul>
   After all the strip messages have been sent, one final message is
   sent with:
@@ -47,8 +55,21 @@
     <li>The text <code>end_route_list</code></li>
     <li>The session frame rate</li>
     <li>The last frame number of the session</li>
+    <li>Monitor section present</li>
   </ul>
 </p>
+<p class="note">
+	The <code>/set_surface</code> should be set before this is called. That way
+	The right set of strips will be sent in return (though the default is good
+	for most uses) and feedback will start correctly.
+</p>
+<p>
+  If the surface is using <code>/strip/list</code>, the surface needs to know
+  if the strips have changed. This would be true if a strip gets moved, created or
+  deleted. When this happens Ardour sends <code>/strip/list</code> to the surfaces
+  that have previously requested a <code>/strip/list</code>. This lets the
+  surface know that it's list of strips is no longer valid.
+</p>
 <p class="note">A bus will not have a record enable and so a bus message
   will have one less parameter than a track. It is the controllers
   responsability to deal with this.