aboutsummaryrefslogtreecommitdiffstats
path: root/lv2
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2013-01-10 05:51:00 +0000
committerDavid Robillard <d@drobilla.net>2013-01-10 05:51:00 +0000
commitbdf14db0af9cf3ebc52225f8b33abd6def61587d (patch)
tree9af34d6e1cbbcdfb80b26983b505b814695c4b06 /lv2
parentb73784ea11af64f1e655637aa2012f454748a87f (diff)
downloadlv2-bdf14db0af9cf3ebc52225f8b33abd6def61587d.tar.xz
Make patch:Set a compact message for setting one property.
Add patch:readable and patch:writable for describing available properties.
Diffstat (limited to 'lv2')
-rw-r--r--lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl11
-rw-r--r--lv2/lv2plug.in/ns/ext/patch/manifest.ttl2
-rw-r--r--lv2/lv2plug.in/ns/ext/patch/patch.h4
-rw-r--r--lv2/lv2plug.in/ns/ext/patch/patch.ttl88
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 &lt;something&gt; ;
- 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 &lt;something&gt; ;
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: &lt;http://example.org/&gt; .
+@prefix rdf: &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt; .
+@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
+
+eg:title
+ a rdf:Property ;
+ rdfs:label "title" ;
+ rdfs:range xsd:string .
+
+eg:plugin
+ patch:writable eg:title .
+</pre>
+""" .