Prototype LV2 extension for plugins to provide Midnams

[ardour.git] / libs / ardour / ardour / lv2_extensions.h

diff --git a/libs/ardour/ardour/lv2_extensions.h b/libs/ardour/ardour/lv2_extensions.h
index 64fc3bc615cf13e69a934e419cc7b008715427b3..f38ac8122aeca6146c1109abb17000abde782fe6 100644 (file)
--- a/libs/ardour/ardour/lv2_extensions.h
+++ b/libs/ardour/ardour/lv2_extensions.h
@@ -171,4 +171,42 @@ typedef struct _LV2_License_Interface {
    @}
 */
 
+/**
+   @defgroup midnam MIDI Naming
+
+   @{
+*/
+
+
+#define LV2_MIDNAM_URI "http://ardour.org/lv2/midnam"
+#define LV2_MIDNAM_PREFIX LV2_MIDNAM_URI "#"
+#define LV2_MIDNAM__interface LV2_MIDNAM_PREFIX "interface"
+#define LV2_MIDNAM__update LV2_MIDNAM_PREFIX "update"
+
+typedef void* LV2_Midnam_Handle;
+
+/** a LV2 Feature provided by the Host to the plugin */
+typedef struct {
+       /** Opaque host data */
+       LV2_Midnam_Handle handle;
+       /** Request from run() that the host should re-read the midnam */
+       void (*update)(LV2_Midnam_Handle handle);
+} LV2_Midnam;
+
+typedef struct {
+       /** query midnam document. The plugin
+        * is expected to return an allocated
+        * null-terminated XML text, which is
+        * safe for the host to pass to free().
+        *
+        * The midnam <Model> must be unique and
+        * specific for the given plugin-instance.
+        */
+       char* (*midnam)(LV2_Handle instance);
+       char* (*model)(LV2_Handle instance);
+} LV2_Midnam_Interface;
+
+/**
+   @}
+*/
 #endif