Initial control-input-port-change-request extension

kx-control-input-port-change-request.lv2/control-input-port-change-request.doap.ttl

@@ -0,0 +1,25 @@
+@prefix dcs:  <http://ontologi.es/doap-changeset#> .
+@prefix doap: <http://usefulinc.com/ns/doap#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://kx.studio/ns/lv2ext/control-input-port-change-request>
+    a doap:Project ;
+    rdfs:seeAlso <../kx-meta/meta.ttl> ;
+    doap:license <http://opensource.org/licenses/isc> ;
+    doap:name "ControlPort Change Request" ;
+    doap:homepage <http://kx.studio/ns/lv2ext/control-input-port-change-request> ;
+    doap:created "2020-10-14" ;
+    doap:shortdesc "LV2 extension for allowing plugins to request changes on their own control input ports." ;
+    doap:developer <https://falktx.com> ;
+    doap:maintainer <https://falktx.com> ;
+    doap:release [
+        doap:revision "0.0" ;
+        doap:created "2020-10-14" ;
+        doap:file-release <http://kx.studio/ns/lv2ext/kx-extensions-1.0.tar.bz2> ;
+        dcs:changeset [
+            dcs:item [
+                rdfs:label "First stable release."
+            ]
+        ]
+    ] .

kx-control-input-port-change-request.lv2/control-input-port-change-request.h

@@ -0,0 +1,72 @@
+/*
+  LV2 ControlInputPort change request extension
+  Copyright 2020 Filipe Coelho <falktx@falktx.com>
+
+  Permission to use, copy, modify, and/or distribute this software for any
+  purpose with or without fee is hereby granted, provided that the above
+  copyright notice and this permission notice appear in all copies.
+
+  THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+  ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+*/
+
+/**
+   @file control-input-port-change-request.h
+   C header for the LV2 ControlInputPort change request extension <http://kx.studio/ns/lv2ext/control-input-port-change-request>.
+*/
+
+#ifndef LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_H
+#define LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_H
+
+#include "lv2/lv2plug.in/ns/lv2core/lv2.h"
+
+#define LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_URI    "http://kx.studio/ns/lv2ext/control-input-port-change-request"
+#define LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_PREFIX LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_URI "#"
+
+#ifdef __cplusplus
+extern "C" {
+#else
+#include <stdbool.h>
+#endif
+
+typedef void* LV2_ControlInputPort_Change_Request_Handle;
+
+/**
+ * On instantiation, host must supply LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_URI feature.
+ * LV2_Feature::data must be pointer to LV2_ControlInputPort_Change_Request.
+*/
+typedef struct _LV2_ControlInputPort_Change_Request {
+    /**
+     *  Opaque host data.
+     */
+    LV2_ControlInputPort_Change_Request_Handle handle;
+
+    /**
+     * request_change()
+     *
+     * Ask the host to change a plugin's control input port value.
+     * Parameter handle MUST be the 'handle' member of this struct.
+     * Parameter index is port index to change.
+     * Parameter value is the requested value to change the control port input to.
+     *
+     * Returns if the operation succeeded.
+     * The host may decline this request if it is e.g. currently automating this port.
+     *
+     * The plugin MUST call this function during run().
+     */
+    bool (*request_change)(LV2_ControlPortChangeRequest_Handle handle,
+                           uint32_t index,
+                           float value);
+
+} LV2_ControlInputPort_Change_Request;
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /* LV2_CONTROL_INPUT_PORT_CHANGE_REQUEST_H */

kx-control-input-port-change-request.lv2/control-input-port-change-request.ttl

@@ -0,0 +1,15 @@
+@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
+@prefix owl:  <http://www.w3.org/2002/07/owl#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://kx.studio/ns/lv2ext/control-input-port-change-request>
+    a owl:Ontology ,
+        lv2:Feature ;
+    rdfs:seeAlso <control-port-change-request.h> ,
+        <control-port-change-request.doap.ttl> ,
+        <../kx-meta/meta.ttl> ;
+    lv2:documentation """
+<p>
+    LV2 Programs is an <a href="http://lv2plug.in/ns/lv2core#Specification" target="_blank">LV2 Extension</a> for allowing plugins to request changes on their own control input ports.
+</p>
+""" .

kx-control-input-port-change-request.lv2/manifest.ttl

@@ -0,0 +1,8 @@
+@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://kx.studio/ns/lv2ext/control-input-port-change-request>
+    a lv2:Specification ;
+    lv2:minorVersion 0 ;
+    lv2:microVersion 0 ;
+    rdfs:seeAlso <control-input-port-change-request.ttl> .