diff options
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl | 11 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/manifest.ttl | 2 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.h | 4 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.ttl | 88 |
4 files changed, 82 insertions, 23 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 index a996b6c..ba976f5 100644 --- a/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl +++ b/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl @@ -12,6 +12,17 @@ doap:name "LV2 Patch" ; doap:shortdesc "Messages for accessing and manipulating properties." ; doap:release [ + doap:revision "1.1" ; + doap:created "2012-01-10" ; + 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> ; diff --git a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl index 38b93ae..1037a9c 100644 --- a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl +++ b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl @@ -4,5 +4,5 @@ <http://lv2plug.in/ns/ext/patch> a lv2:Specification ; lv2:minorVersion 1 ; - lv2:microVersion 0 ; + lv2:microVersion 1 ; rdfs:seeAlso <patch.ttl> . diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.h b/lv2/lv2plug.in/ns/ext/patch/patch.h index d03cdae..1a7a893 100644 --- a/lv2/lv2plug.in/ns/ext/patch/patch.h +++ b/lv2/lv2plug.in/ns/ext/patch/patch.h @@ -43,9 +43,13 @@ #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 index 6267c71..ae1a0e3 100644 --- a/lv2/lv2plug.in/ns/ext/patch/patch.ttl +++ b/lv2/lv2plug.in/ns/ext/patch/patch.ttl @@ -231,42 +231,37 @@ patch:Set [ a owl:Restriction ; owl:cardinality 1 ; - owl:onProperty patch:body + owl:onProperty patch:property + ] , [ + a owl:Restriction ; + owl:cardinality 1 ; + owl:onProperty patch:value ] ; lv2:documentation """ -<p>A method for setting properties of an object to unique values.</p> +<p>A compact message for setting one property to a specific value.</p> -<p>This is a simplified version of patch:Patch which only makes sense for -properties which have at most one value. This method always has at least one -patch:subject, and exactly one patch:add property. All the properties of the -value of patch:add are set on the subject, with all old values for those -properties removed. For example:</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:body [ - eg:name "New name" ; - eg:age 42 ; - ] . + patch:property eg:name ; + patch:value "New name" . </pre> -<p>This method is equivalent to a patch:Patch where the patch:remove value has -every property of patch:add but with wildcard values. For example, the above -patch is equivalent to:</p> +<p>Which is equivalent to:</p> <pre class="turtle-code"> [] a patch:Patch ; patch:subject <something> ; patch:add [ eg:name "New name" ; - eg:age 42 ; ] ; patch:remove [ eg:name patch:wildcard ; - eg:age patch:wildcard ; - ] ; + ] . </pre> """ . @@ -294,6 +289,29 @@ patch:destination 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 , @@ -310,14 +328,40 @@ patch:subject owl:FunctionalProperty ; rdfs:domain patch:Message . -patch:remove - 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> +""" . |