X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-querying-ardour.html;h=fa2a6f9dd02df26f167b86a44f392acdaf131f8c;hb=081e7af0b6f6dec0ca685d3a538eacf20394c2cc;hp=a101bebed7588e6c00606f3d674ed1d678a21150;hpb=0d4be5fdfb660d75853e46019e4a5acf3816363b;p=ardour-manual diff --git a/include/osc58-querying-ardour.html b/include/osc58-querying-ardour.html index a101beb..fa2a6f9 100644 --- a/include/osc58-querying-ardour.html +++ b/include/osc58-querying-ardour.html @@ -12,18 +12,20 @@ Here are the commands used to query Ardour: (added in Ardour 5.5)
-/strip/list | +Ask for a list of strips |
---|---|
/strip/sends ssid | +Asks for a list of sends on the strip ssid |
/strip/receives ssid | +Asks for a list of tracks that have sends to the strip ssid points to |
/strip/plugin/list ssid | +Asks for a list of plug-ins for strip ssid. |
/strip/plugin/descriptor ssid piid | +Asks for a list of descriptors for plug-in piid on strip ssid |
/set_surface | +Ask for the current surface setting. Reply is in the same form as setting the surface would be. |
end_route_list
+ The /set_surface
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.
+
+ If the surface is using /strip/list
, 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 /strip/list
to the surfaces
+ that have previously requested a /strip/list
. This lets the
+ surface know that it's list of strips is no longer valid.
+
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. @@ -109,17 +132,17 @@
- /plugin/descriptor ssid piid
will
+ /strip/plugin/descriptor ssid piid
will
return the plug-in parameters for ppid plug-in on the ssid strip. The
- reply will contain the following information:
+ reply will be sent as a number of messages, one for each parameter.
+ Each message will contain the following information:
+ After all the parameters have been sent this way, one final message"
+ /strip/plugin/descriptor_end
is sent with these parameters:
+
The flag bitset above has been defined as (from lsb):
While this seems complex, it is really not that bad. Minimum, - maximum and value will in most cases give you all you need. + maximum and value will in most cases give you all you need. For simpler + access to plug-ins, the /select/plugin/ set of commands will handle most + needs.