From 2765ce386605360c121e130d81e50412045b47bf Mon Sep 17 00:00:00 2001
From: David Robillard <d@drobilla.net>
Date: Tue, 28 Feb 2012 04:27:55 +0000
Subject: Replace lv2:relation with the concept of plugin "parameters".

---
 lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl |  2 +-
 lv2/lv2plug.in/ns/lv2core/lv2core.ttl      | 33 ++++++++++++++++++++++--------
 2 files changed, 25 insertions(+), 10 deletions(-)

(limited to 'lv2/lv2plug.in/ns/lv2core')

diff --git a/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl b/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
index cbda00e..25fbd6f 100644
--- a/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
+++ b/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
@@ -31,7 +31,7 @@
 		dcs:changeset [
 			dcs:item [
 				rdfs:label "Fix LV2_SYMBOL_EXPORT and lv2_descriptor prototype for Windows." ;
-				rdfs:label "Add lv2:relation, lv2:latency, and lv2:freeWheeling."
+				rdfs:label "Add lv2:isParameter, lv2:hasParameter, lv2:latency, and lv2:freeWheeling."
 			]
 		]
 	] , [
diff --git a/lv2/lv2plug.in/ns/lv2core/lv2core.ttl b/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
index 285c1ad..b2becdc 100644
--- a/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
+++ b/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
@@ -449,20 +449,35 @@ port identification. The plugin author may change the values of this
 property without changing the Plugin URI.
 """ .
 
-lv2:relation a rdf:Property , owl:ObjectProperty ;
+lv2:hasParameter a rdf:Property , owl:ObjectProperty ;
+    rdfs:domain lv2:Resource ;
+    rdfs:range rdf:Property ;
+    rdfs:label "has parameter" ;
+    lv2:documentation """
+<p>Indicates that a plugin or other resource has a certain <q>parameter</q>.  A
+parameter is simply a recognized property, i.e. a URI predicate and any type of
+object.  Parameters may be associated with a control port or controlled using
+another mechanism.  Parameter values may be part of an instance's state.</p>
+
+<p>Any property URI can be used as a parameter, no LV2 specific definition is
+required.  Existing vocabularies SHOULD be used whenever possible.</p>
+""" .
+
+lv2:isParameter a rdf:Property , owl:ObjectProperty ;
     rdfs:domain lv2:Port ;
+    rdfs:range rdf:Property ;
     rdfs:label "relation" ;
     lv2:documentation """
-<p>Indicates the relation the value of a port represents.  The value of this
-property must the URI of some relation (i.e. a predicate).</p>
+<p>Indicates that a port contains the value of a plugin parameter.</p>
 
-<p>For example, if a port has lv2:relation foo:volume, then the value of that
-port represents the foo:volume of the plugin instance.  This is used to make
-control ports meaningful and compatible with other methods of control and/or
-state representation.</p>
+<p>For example, if a port lv2:isParameter foo:volume, then the value of that
+port represents the foo:volume of the plugin instance.  Associating a port with
+a well-defined parameter gives the port's value meaning.  This allows it to be
+handled specially by the host and integrate with other property-based
+mechanisms (e.g. messages or plugin state).</p>
 
-<p>Plugins SHOULD NOT have several ports with the same lv2:relation.</p>
-""" .
+<p>For a given parameter, plugins SHOULD have at most one port per direction
+(lv2:InputPort or lv2:OutputPort).</p> """ .
 
 
 ####################################
-- 
cgit v1.2.1