diff options
Diffstat (limited to 'lv2/lv2plug.in/ns/ext/patch')
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl | 36 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/manifest.ttl | 8 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.h | 55 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.ttl | 367 |
4 files changed, 0 insertions, 466 deletions
diff --git a/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl b/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl deleted file mode 100644 index a2f3e79..0000000 --- a/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl +++ /dev/null @@ -1,36 +0,0 @@ -@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://lv2plug.in/ns/ext/patch> - a doap:Project ; - rdfs:seeAlso <../../meta/meta.ttl> ; - doap:created "2012-02-09" ; - doap:license <http://opensource.org/licenses/isc> ; - doap:developer <http://drobilla.net/drobilla#me> ; - doap:name "LV2 Patch" ; - doap:shortdesc "Messages for accessing and manipulating properties." ; - doap:release [ - doap:revision "2.0" ; - doap:created "2013-01-10" ; - doap:file-release <http://lv2plug.in/spec/lv2-1.4.0.tar.bz2> ; - dcs:blame <http://drobilla.net/drobilla#me> ; - dcs:changeset [ - dcs:item [ - rdfs:label "Make patch:Set a compact message for setting one property." - ] , [ - rdfs:label "Add patch:readable and patch:writable for describing available properties." - ] - ] - ] , [ - doap:revision "1.0" ; - doap:created "2012-04-17" ; - doap:file-release <http://lv2plug.in/spec/lv2-1.0.0.tar.bz2> ; - dcs:blame <http://drobilla.net/drobilla#me> ; - dcs:changeset [ - dcs:item [ - rdfs:label "Initial release." - ] - ] - ] . diff --git a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl deleted file mode 100644 index fcc06be..0000000 --- a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl +++ /dev/null @@ -1,8 +0,0 @@ -@prefix lv2: <http://lv2plug.in/ns/lv2core#> . -@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . - -<http://lv2plug.in/ns/ext/patch> - a lv2:Specification ; - lv2:minorVersion 2 ; - lv2:microVersion 0 ; - rdfs:seeAlso <patch.ttl> . diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.h b/lv2/lv2plug.in/ns/ext/patch/patch.h deleted file mode 100644 index 1a7a893..0000000 --- a/lv2/lv2plug.in/ns/ext/patch/patch.h +++ /dev/null @@ -1,55 +0,0 @@ -/* - Copyright 2012 David Robillard <http://drobilla.net> - - 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 patch.h C header for the LV2 Patch extension - <http://lv2plug.in/ns/ext/patch>. - - The patch extension is purely data, this header merely defines URIs - for convenience. -*/ - -#ifndef LV2_PATCH_H -#define LV2_PATCH_H - -#define LV2_PATCH_URI "http://lv2plug.in/ns/ext/patch" -#define LV2_PATCH_PREFIX LV2_PATCH_URI "#" - -#define LV2_PATCH__Ack LV2_PATCH_PREFIX "Ack" -#define LV2_PATCH__Delete LV2_PATCH_PREFIX "Delete" -#define LV2_PATCH__Error LV2_PATCH_PREFIX "Error" -#define LV2_PATCH__Get LV2_PATCH_PREFIX "Get" -#define LV2_PATCH__Message LV2_PATCH_PREFIX "Message" -#define LV2_PATCH__Move LV2_PATCH_PREFIX "Move" -#define LV2_PATCH__Patch LV2_PATCH_PREFIX "Patch" -#define LV2_PATCH__Post LV2_PATCH_PREFIX "Post" -#define LV2_PATCH__Put LV2_PATCH_PREFIX "Put" -#define LV2_PATCH__Request LV2_PATCH_PREFIX "Request" -#define LV2_PATCH__Response LV2_PATCH_PREFIX "Response" -#define LV2_PATCH__Set LV2_PATCH_PREFIX "Set" -#define LV2_PATCH__add LV2_PATCH_PREFIX "add" -#define LV2_PATCH__body LV2_PATCH_PREFIX "body" -#define LV2_PATCH__destination LV2_PATCH_PREFIX "destination" -#define LV2_PATCH__property LV2_PATCH_PREFIX "property" -#define LV2_PATCH__readable LV2_PATCH_PREFIX "readable" -#define LV2_PATCH__remove LV2_PATCH_PREFIX "remove" -#define LV2_PATCH__request LV2_PATCH_PREFIX "request" -#define LV2_PATCH__subject LV2_PATCH_PREFIX "subject" -#define LV2_PATCH__value LV2_PATCH_PREFIX "value" -#define LV2_PATCH__wildcard LV2_PATCH_PREFIX "wildcard" -#define LV2_PATCH__writable LV2_PATCH_PREFIX "writable" - -#endif /* LV2_PATCH_H */ diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.ttl b/lv2/lv2plug.in/ns/ext/patch/patch.ttl deleted file mode 100644 index ae1a0e3..0000000 --- a/lv2/lv2plug.in/ns/ext/patch/patch.ttl +++ /dev/null @@ -1,367 +0,0 @@ -@prefix foaf: <http://xmlns.com/foaf/0.1/> . -@prefix lv2: <http://lv2plug.in/ns/lv2core#> . -@prefix owl: <http://www.w3.org/2002/07/owl#> . -@prefix patch: <http://lv2plug.in/ns/ext/patch#> . -@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . -@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . -@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . - -<http://lv2plug.in/ns/ext/patch> - a owl:Ontology ; - rdfs:seeAlso <patch.h> , - <lv2-patch.doap.ttl> ; - lv2:documentation """ -<p>This vocabulary defines messages which can be used to access and manipulate -properties. It is designed to provide a dynamic control interface for LV2 -plugins, but is useful in many contexts.</p> - -<p>The main feature of this design is that the messages themselves are -described in the same format as the data they work with. In particular, -messages can be serialised as a binary <a -href="../atom/atom.html#Object">Object</a> or in Turtle (or any other RDF -serialisation).</p> - -<p>The idea behind using a property-based interface for control is to prevent -an an explosion of message types. Instead of a custom message for each action, -control is achieved via manipulating properties (which are likely already -defined for other reasons). Note, however, that this is purely conceptual; -there is no requirement that the receiver actually implement a store of -resources with properties.</p> - -<p>For example, consider an object that can blink. Rather than define a -specific interface to control this (e.g. <code>obj.start_blinking(); -obj.stop_blinking()</code>), set a <q>blinking</q> property to true or false -(e.g. <code>obj.set(blinking, true)</code>) to achieve the desired behaviour. -One benefit of this approach is that a persistent state model is available -<q>for free</q>: simply serialise the <q>blinking</q> property.</p> - -<p>This specification is strictly metadata and does not define any binary -mechanism, though it can be completely expressed by standard types in the <a -href="../atom/atom.html">LV2 Atom</a> extension. Thus, hosts can be expected -to be capable of transmitting it between plugins, or between a plugin and its -UI, making it a good choice for advanced plugin control.</p> -""" . - -patch:Ack - a rdfs:Class ; - rdfs:subClassOf patch:Response ; - rdfs:label "Ack" ; - lv2:documentation """ -<p>An acknowledgement that a request has been successfully processed. This is -returned as a reply when a specific reply type is not necessary or -appropriate.</p> -""" . - -patch:Delete - a rdfs:Class ; - rdfs:subClassOf patch:Request ; - rdfs:label "Delete" ; - lv2:documentation """ -<p>Request the subject(s) be deleted.</p> -""" . - -patch:Error - a rdfs:Class ; - rdfs:subClassOf patch:Response ; - rdfs:label "Error" ; - lv2:documentation """ -<p>A response indicating an error processing a request.</p> -""" . - -patch:Get - a rdfs:Class ; - rdfs:subClassOf patch:Request ; - rdfs:label "Get" ; - lv2:documentation """ -<p>Request a description of the subject.</p> - -<p>The detail of the response is not specified, it may be a flat description of -all the properties of the subject, or a more expressive description with -several subjects. A good choice is a <q><a -href="http://www.w3.org/Submission/CBD/">concise bounded description</a></q>, -i.e. a description which recursively includes all properties with blank node -values.</p> - -<p>The response should have the same patch:subject property as the request, and -a patch:body that is a description of that subject. For example:</p> -<pre class="turtle-code"> -<get-request> - a patch:Get ; - patch:subject <something> . -</pre> - -<p>Could result in:</p> -<pre class="turtle-code"> -[] - a patch:Response ; - patch:request <get-request> ; - patch:subject <something> ; - patch:body [ - eg:name "Something" ; - eg:ratio 1.6180339887 ; - ] . -</pre> - -<p>Note the use of blank nodes is not required; the value of patch:body may be -the actual resource node. Depending on the transport and syntax used this may -be preferable. However, the patch:subject property is required regardless. For -example, the same response could be written:</p> - -<pre class="turtle-code"> -<something> - eg:name "Something" ; - eg:ratio 1.6180339887 . - -[] - a patch:Response ; - patch:request <get-request> ; - patch:subject <something> ; - patch:body <something> . -</pre> -""" . - -patch:Insert - a rdfs:Class ; - rdfs:subClassOf patch:Request ; - rdfs:label "Insert" ; - rdfs:subClassOf [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:subject - ] ; - lv2:documentation """ -<p>Insert the patch:body at patch:subject. If the subject does not exist, it is -created. If the subject does already exist, it is added to. This request only -adds properties, it never removes them. The user must take care that multiple -values are not set for properties which should only have one value.</p> -""" . - -patch:Message - a rdfs:Class ; - rdfs:label "Message" . - -patch:Move - a rdfs:Class ; - rdfs:subClassOf patch:Request ; - rdfs:label "Move" ; - rdfs:subClassOf [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:subject - ] , [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:destination - ] ; - lv2:documentation """ -<p>Move the patch:subject to patch:destination. After this, patch:destination has -the description patch:subject had prior to this request's execution, and -patch:subject does not exist any more.It is an error if the subject does not -exist or the destination already exists.</p> -""" . - -patch:Patch - a rdfs:Class ; - rdfs:subClassOf patch:Request , - [ - a owl:Restriction ; - owl:minCardinality 1 ; - owl:onProperty patch:subject - ] ; - lv2:documentation """ -<p>A method for modifying the properties of an object.</p> - -<p>This method always has at least one patch:subject, and exactly one patch:add -and patch:remove property. The value of patch:add and patch:remove are nodes -which have the properties to add or remove from the subject(s), respectively. -The special value patch:wildcard may be used as the value of a remove property -to remove all properties with the given predicate. For example:</p> - -<pre class="turtle-code"> -[] - a patch:Patch ; - patch:subject <something> ; - patch:add [ - eg:name "New name" ; - eg:age 42 ; - ] ; - patch:remove [ - eg:name "Old name" ; - eg:age patch:wildcard ; # Remove all old eg:age properties - ] . -</pre> -""" . - -patch:Put - a rdfs:Class ; - rdfs:subClassOf patch:Request ; - rdfs:label "Put" ; - rdfs:subClassOf [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:subject - ] ; - lv2:documentation """ -<p>Put the patch:body as the patch:subject. If the subject does not already exist, -it is created. If the subject does already exist, the patch:body is considered -an updated version of it, and the previous version is replaced.</p> -""" . - -patch:Request - a rdfs:Class ; - rdfs:label "Request" ; - rdfs:subClassOf patch:Message ; - lv2:documentation """ -<p>A request. A request may have a patch:subject property, which indicates which -resource the request applies to. The subject may be omitted in contexts where -it is implicit (e.g. the recipient is the subject).</p> -""" . - -patch:Response - a rdfs:Class ; - rdfs:subClassOf patch:Message ; - rdfs:label "Response" ; - lv2:documentation """ -<p>A response to a method.</p> -""" . - -patch:Set - a rdfs:Class ; - rdfs:subClassOf patch:Request , - [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:property - ] , [ - a owl:Restriction ; - owl:cardinality 1 ; - owl:onProperty patch:value - ] ; - lv2:documentation """ -<p>A compact message for setting one property to a specific value.</p> - -<p>This is equivalent to a patch:Patch which removes <em>all</em> pre-existing -values for the property before setting the new value. For example:</p> - -<pre class="turtle-code"> -[] - a patch:Set ; - patch:subject <something> ; - patch:property eg:name ; - patch:value "New name" . -</pre> - -<p>Which is equivalent to:</p> -<pre class="turtle-code"> -[] - a patch:Patch ; - patch:subject <something> ; - patch:add [ - eg:name "New name" ; - ] ; - patch:remove [ - eg:name patch:wildcard ; - ] . -</pre> -""" . - -patch:add - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Message . - -patch:body - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Message ; - lv2:documentation """ -<p>The body of a message.</p> - -<p>The details of this property's value depend on the type of message it is a -part of.</p> -""" . - -patch:destination - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Message . - -patch:property - a rdf:Property ; - rdfs:label "property" ; - rdfs:range rdf:Property ; - lv2:documentation """ -<p>The property this message applies to.</p> -""" . - -patch:readable - a rdf:Property ; - rdfs:label "readable" ; - rdfs:range rdf:Property ; - lv2:documentation """ -<p>Indicates that the subject may have a property that can be read via a -patch:Get message. See the similar property patch:writable for details.</p> -""" . - -patch:remove - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Message . - -patch:request - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Response ; - rdfs:range patch:Request ; - lv2:documentation """ -<p>The request this is a response to.</p> -""" . - -patch:subject - a rdf:Property , - owl:ObjectProperty , - owl:FunctionalProperty ; - rdfs:domain patch:Message . - -patch:value - a rdf:Property ; - rdfs:label "value" ; - rdfs:range rdf:Property ; - lv2:documentation """ -<p>The value of a property in a patch:Set message.</p> -""" . - -patch:wildcard - a rdfs:Resource ; - rdfs:comment """ -A wildcard which matches any resource. This makes it possible to describe the removal of all values for a given property. -""" . - -patch:writable - a rdf:Property ; - rdfs:label "writable" ; - rdfs:range rdf:Property ; - lv2:documentation """ -<p>Indicates that subject may have a property that can be written via a patch -message. This is used to list supported properties, e.g. so user interfaces -can present appropriate controls. For example:</p> - -<pre class="turtle-code"> -@prefix eg: <http://example.org/> . -@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . -@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . - -eg:title - a rdf:Property ; - rdfs:label "title" ; - rdfs:range xsd:string . - -eg:plugin - patch:writable eg:title . -</pre> -""" . |