diff options
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/message/message.h | 46 | ||||
| l--------- | lv2/lv2plug.in/ns/ext/patch/ext.pc.in (renamed from lv2/lv2plug.in/ns/ext/message/ext.pc.in) | 0 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/manifest.ttl (renamed from lv2/lv2plug.in/ns/ext/message/manifest.ttl) | 4 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.h | 47 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/patch/patch.ttl (renamed from lv2/lv2plug.in/ns/ext/message/message.ttl) | 206 | ||||
| l--------- | lv2/lv2plug.in/ns/ext/patch/waf (renamed from lv2/lv2plug.in/ns/ext/message/waf) | 0 | ||||
| l--------- | lv2/lv2plug.in/ns/ext/patch/wscript (renamed from lv2/lv2plug.in/ns/ext/message/wscript) | 0 |
7 files changed, 152 insertions, 151 deletions
diff --git a/lv2/lv2plug.in/ns/ext/message/message.h b/lv2/lv2plug.in/ns/ext/message/message.h deleted file mode 100644 index d2f3b1d..0000000 --- a/lv2/lv2plug.in/ns/ext/message/message.h +++ /dev/null @@ -1,46 +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 message.h C header for the LV2 Message extension - <http://lv2plug.in/ns/ext/message>. - - The message extension is purely data, this header merely defines URIs - for convenience. -*/ - -#ifndef LV2_MESSAGE_H -#define LV2_MESSAGE_H - -#define LV2_MESSAGE_URI "http://lv2plug.in/ns/ext/message" - -#define LV2_MESSAGE__Ack LV2_MESSAGE_URI "#Ack" -#define LV2_MESSAGE__Delete LV2_MESSAGE_URI "#Delete" -#define LV2_MESSAGE__Error LV2_MESSAGE_URI "#Error" -#define LV2_MESSAGE__Get LV2_MESSAGE_URI "#Get" -#define LV2_MESSAGE__Message LV2_MESSAGE_URI "#Message" -#define LV2_MESSAGE__Move LV2_MESSAGE_URI "#Move" -#define LV2_MESSAGE__Patch LV2_MESSAGE_URI "#Patch" -#define LV2_MESSAGE__Post LV2_MESSAGE_URI "#Post" -#define LV2_MESSAGE__Put LV2_MESSAGE_URI "#Put" -#define LV2_MESSAGE__Request LV2_MESSAGE_URI "#Request" -#define LV2_MESSAGE__Response LV2_MESSAGE_URI "#Response" -#define LV2_MESSAGE__Set LV2_MESSAGE_URI "#Set" -#define LV2_MESSAGE__add LV2_MESSAGE_URI "#add" -#define LV2_MESSAGE__body LV2_MESSAGE_URI "#body" -#define LV2_MESSAGE__request LV2_MESSAGE_URI "#request" - -#endif /* LV2_MESSAGE_H */ diff --git a/lv2/lv2plug.in/ns/ext/message/ext.pc.in b/lv2/lv2plug.in/ns/ext/patch/ext.pc.in index 03dd044..03dd044 120000 --- a/lv2/lv2plug.in/ns/ext/message/ext.pc.in +++ b/lv2/lv2plug.in/ns/ext/patch/ext.pc.in diff --git a/lv2/lv2plug.in/ns/ext/message/manifest.ttl b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl index 3708bd9..96e89eb 100644 --- a/lv2/lv2plug.in/ns/ext/message/manifest.ttl +++ b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl @@ -1,9 +1,9 @@ @prefix lv2: <http://lv2plug.in/ns/lv2core#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . -<http://lv2plug.in/ns/ext/message> +<http://lv2plug.in/ns/ext/patch> a lv2:Specification ; lv2:minorVersion 0 ; lv2:microVersion 1 ; - rdfs:seeAlso <message.ttl> . + rdfs:seeAlso <patch.ttl> . diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.h b/lv2/lv2plug.in/ns/ext/patch/patch.h new file mode 100644 index 0000000..f0327f1 --- /dev/null +++ b/lv2/lv2plug.in/ns/ext/patch/patch.h @@ -0,0 +1,47 @@ +/* + 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 Message 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__request LV2_PATCH_PREFIX "request" + +#endif /* LV2_PATCH_H */ diff --git a/lv2/lv2plug.in/ns/ext/message/message.ttl b/lv2/lv2plug.in/ns/ext/patch/patch.ttl index 70fa304..34954fa 100644 --- a/lv2/lv2plug.in/ns/ext/message/message.ttl +++ b/lv2/lv2plug.in/ns/ext/patch/patch.ttl @@ -1,4 +1,4 @@ -# LV2 Message Extension +# LV2 Patch Extension # Copyright 2012 David Robillard <d@drobilla.net> # # Permission to use, copy, modify, and/or distribute this software for any @@ -13,16 +13,16 @@ # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -@prefix doap: <http://usefulinc.com/ns/doap#> . -@prefix foaf: <http://xmlns.com/foaf/0.1/> . -@prefix lv2: <http://lv2plug.in/ns/lv2core#> . -@prefix msg: <http://lv2plug.in/ns/ext/message#> . -@prefix owl: <http://www.w3.org/2002/07/owl#> . -@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#> . +@prefix doap: <http://usefulinc.com/ns/doap#> . +@prefix foaf: <http://xmlns.com/foaf/0.1/> . +@prefix lv2: <http://lv2plug.in/ns/lv2core#> . +@prefix patch: <http://lv2plug.in/ns/ext/patch#> . +@prefix owl: <http://www.w3.org/2002/07/owl#> . +@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/message> +<http://lv2plug.in/ns/ext/patch> a lv2:Specification ; doap:license <http://opensource.org/licenses/isc> ; doap:maintainer [ @@ -31,7 +31,7 @@ foaf:homepage <http://drobilla.net/> ; foaf:name "David Robillard" ] ; - doap:name "LV2 Message" ; + doap:name "LV2 Patch" ; doap:release [ doap:created "2012-02-08" ; doap:revision "0.1" @@ -49,7 +49,7 @@ burdens like a new syntax or binary formats. In particular, messages can be serialised in Turtle, or as an <a href="http://lv2plug.in/ns/ext/atom#Object">LV2 Object</a>.</p> -<p>This set of message types is deliberately small to avoid an explosion of +<p>This set of patch types is deliberately small to avoid an explosion of messages that all implementations would have to explicitly support. Instead, the idea is to achieve control via manipulating properties rather than defining custom commands. However, this is conceptual; there is no requirement that the @@ -74,9 +74,9 @@ RDF properties, thus predicates from any of the countless pre-existing vocabularies may be used.</p> """ . -msg:Ack +patch:Ack a rdfs:Class ; - rdfs:subClassOf msg:Response ; + rdfs:subClassOf patch:Response ; rdfs:label "Ack" ; lv2:documentation """ <p>An acknowledgement that a request has been successfully processed. This is @@ -84,25 +84,25 @@ returned as a reply when a specific reply type is not necessary or appropriate.</p> """ . -msg:Delete +patch:Delete a rdfs:Class ; - rdfs:subClassOf msg:Request ; + rdfs:subClassOf patch:Request ; rdfs:label "Delete" ; lv2:documentation """ <p>Request the subject(s) be deleted.</p> """ . -msg:Error +patch:Error a rdfs:Class ; - rdfs:subClassOf msg:Response ; + rdfs:subClassOf patch:Response ; rdfs:label "Error" ; lv2:documentation """ <p>A response indicating an error processing a request.</p> """ . -msg:Get +patch:Get a rdfs:Class ; - rdfs:subClassOf msg:Request ; + rdfs:subClassOf patch:Request ; rdfs:label "Get" ; lv2:documentation """ <p>Request a description of the subject.</p> @@ -114,29 +114,29 @@ 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 msg:subject property as the request, and -a msg:body that is a description of that subject. For example:</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 msg:Get ; - msg:subject <something> . + a patch:Get ; + patch:subject <something> . </pre> <p>Could result in:</p> <pre class="turtle-code"> [] - a msg:Response ; - msg:request <get-request> ; - msg:subject <something> ; - msg:body [ + 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 msg:body may be +<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 msg:subject property is required regardless. For +be preferable. However, the patch:subject property is required regardless. For example, the same response could be written:</p> <pre class="turtle-code"> @@ -145,205 +145,205 @@ example, the same response could be written:</p> eg:ratio 1.6180339887 . [] - a msg:Response ; - msg:request <get-request> ; - msg:subject <something> ; - msg:body <something> . + a patch:Response ; + patch:request <get-request> ; + patch:subject <something> ; + patch:body <something> . </pre> """ . -msg:Insert +patch:Insert a rdfs:Class ; - rdfs:subClassOf msg:Request ; + rdfs:subClassOf patch:Request ; rdfs:label "Insert" ; rdfs:subClassOf [ a owl:Restriction ; owl:maxCardinality 1 ; - owl:onProperty msg:subject + owl:onProperty patch:subject ] ; lv2:documentation """ -<p>Insert the msg:body at msg:subject. If the subject does not exist, it is +<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> """ . -msg:Message +patch:Patch a rdfs:Class ; - rdfs:label "Message" . + rdfs:label "Patch" . -msg:Move +patch:Move a rdfs:Class ; - rdfs:subClassOf msg:Request ; + rdfs:subClassOf patch:Request ; rdfs:label "Move" ; rdfs:subClassOf [ a owl:Restriction ; owl:maxCardinality 1 ; - owl:onProperty msg:subject ; + owl:onProperty patch:subject ; ] , [ a owl:Restriction ; owl:cardinality 1 ; - owl:onProperty msg:destination ; + owl:onProperty patch:destination ; ] ; lv2:documentation """ -<p>Move the msg:subject to msg:destination. After this, msg:destination has -the description msg:subject had prior to this request's execution, and -msg:subject does not exist any more.It is an error if the subject does not +<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> """ . -msg:Patch +patch:Patch a rdfs:Class ; - rdfs:subClassOf msg:Request , [ + rdfs:subClassOf patch:Request , [ a owl:Restriction ; owl:minCardinality 1 ; - owl:onProperty msg:subject + owl:onProperty patch:subject ] , [ a owl:Restriction ; owl:maxCardinality 1 ; - owl:onProperty msg:add + owl:onProperty patch:add ] , [ a owl:Restriction ; owl:maxCardinality 1 ; - owl:onProperty msg:remove + owl:onProperty patch:remove ] ; lv2:documentation """ <p>A method for modifying the properties of an object.</p> -<p>This method always has at least one msg:subject, and exactly one msg:add -and msg:remove property. The value of msg:add and msg:remove are nodes +<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 msg:wildcard may be used as the value of a remove property +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 msg:Patch ; - msg:subject <something> ; - msg:add [ + a patch:Patch ; + patch:subject <something> ; + patch:add [ eg:name "New name" ; eg:age 42 ; ] ; - msg:remove [ + patch:remove [ eg:name "Old name" ; - eg:age msg:wildcard ; # Remove all old eg:age properties + eg:age patch:wildcard ; # Remove all old eg:age properties ] . </pre> """ . -msg:Put +patch:Put a rdfs:Class ; - rdfs:subClassOf msg:Request ; + rdfs:subClassOf patch:Request ; rdfs:label "Put" ; rdfs:subClassOf [ a owl:Restriction ; owl:maxCardinality 1 ; - owl:onProperty msg:subject + owl:onProperty patch:subject ] ; lv2:documentation """ -<p>Put the msg:body as the msg:subject. If the subject does not already exist, -it is created. If the subject does already exist, the msg:body is considered +<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> """ . -msg:Request +patch:Request a rdfs:Class ; rdfs:label "Request" ; - rdfs:subClassOf msg:Message ; + rdfs:subClassOf patch:Patch ; lv2:documentation """ -<p>A request. A request may have a msg:subject property, which indicates which +<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> """ . -msg:Response +patch:Response a rdfs:Class ; - rdfs:subClassOf msg:Message ; + rdfs:subClassOf patch:Patch ; rdfs:label "Response" ; lv2:documentation """ <p>A response to a method.</p> """ . -msg:Set +patch:Set a rdfs:Class ; - rdfs:subClassOf msg:Request , [ + rdfs:subClassOf patch:Request , [ a owl:Restriction ; owl:cardinality 1 ; - owl:onProperty msg:body + owl:onProperty patch:body ] ; lv2:documentation """ <p>A method for setting properties of an object to unique values.</p> -<p>This is a simplified version of msg:Patch which only makes sense for +<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 -msg:subject, and exactly one msg:add property. All the properties of the -value of msg:add are set on the subject, with all old values for those +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> <pre class="turtle-code"> [] - a msg:Set ; - msg:subject <something> ; - msg:body [ + a patch:Set ; + patch:subject <something> ; + patch:body [ eg:name "New name" ; eg:age 42 ; ] . </pre> -<p>This method is equivalent to a msg:Patch where the msg:remove value has -every property of msg:add but with wildcard values. For example, the above -message is equivalent to:</p> +<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> <pre class="turtle-code"> [] - a msg:Patch ; - msg:subject <something> ; - msg:add [ + a patch:Patch ; + patch:subject <something> ; + patch:add [ eg:name "New name" ; eg:age 42 ; ] ; - msg:remove [ - eg:name msg:wildcare ; - eg:age msg:wildcard ; + patch:remove [ + eg:name patch:wildcare ; + eg:age patch:wildcard ; ] ; </pre> """ . -msg:subject +patch:subject a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Message . + rdfs:domain patch:Patch . -msg:add +patch:add a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Message . + rdfs:domain patch:Patch . -msg:remove +patch:remove a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Message . + rdfs:domain patch:Patch . -msg:destination +patch:destination a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Message . + rdfs:domain patch:Patch . -msg:body +patch:body a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Message ; + rdfs:domain patch:Patch ; lv2:documentation """ -<p>The body of a message.</p> +<p>The body of a patch.</p> -<p>The details of this property's value depend on the type of message it is a +<p>The details of this property's value depend on the type of patch it is a part of.</p> """ . -msg:request +patch:request a rdf:Property , owl:ObjectProperty ; - rdfs:domain msg:Response ; - rdfs:range msg:Request ; + rdfs:domain patch:Response ; + rdfs:range patch:Request ; lv2:documentation """ <p>The request this is a response to.</p> """ .
\ No newline at end of file diff --git a/lv2/lv2plug.in/ns/ext/message/waf b/lv2/lv2plug.in/ns/ext/patch/waf index 5235032..5235032 120000 --- a/lv2/lv2plug.in/ns/ext/message/waf +++ b/lv2/lv2plug.in/ns/ext/patch/waf diff --git a/lv2/lv2plug.in/ns/ext/message/wscript b/lv2/lv2plug.in/ns/ext/patch/wscript index 7e2c01b..7e2c01b 120000 --- a/lv2/lv2plug.in/ns/ext/message/wscript +++ b/lv2/lv2plug.in/ns/ext/patch/wscript |