path: root/lv2/lv2plug.in/ns/lv2core
diff options
authorDavid Robillard <d@drobilla.net>2012-03-24 22:14:38 +0000
committerDavid Robillard <d@drobilla.net>2012-03-24 22:14:38 +0000
commit978d41eaad0052d3c9ef5314b98053d38bdce7bd (patch)
treed80d09290d1337a823e52415e53afe15740de394 /lv2/lv2plug.in/ns/lv2core
parentbf611932445b2b9c1126f91196f2068fe5cdf4eb (diff)
Add metadata concept of a designation, a channel or parameter description which can be assigned to ports for more intelligent use by hosts.
Relax the range of lv2:index so it can be used for things other than ports.
Diffstat (limited to 'lv2/lv2plug.in/ns/lv2core')
2 files changed, 41 insertions, 35 deletions
diff --git a/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl b/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
index 752349c..eb29db8 100644
--- a/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
+++ b/lv2/lv2plug.in/ns/lv2core/lv2core.doap.ttl
@@ -32,9 +32,11 @@
dcs:item [
rdfs:label "Fix LV2_SYMBOL_EXPORT and lv2_descriptor prototype for Windows." ;
] , [
- rdfs:label "Add lv2:isParameter, lv2:hasParameter, lv2:latency, and lv2:freeWheeling." ;
+ rdfs:label "Add metadata concept of a designation, a channel or parameter description which can be assigned to ports for more intelligent use by hosts." ;
] , [
rdfs:label "Add new discovery API which allows libraries to read bundle files during discovery, makes library construction/destruction explicit, and adds extensibility to prevent future breakage." ;
+ ] , [
+ rdfs:label "Relax the range of lv2:index so it can be used for things other than ports." ;
] ;
] ;
] , [
diff --git a/lv2/lv2plug.in/ns/lv2core/lv2core.ttl b/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
index 7d0e729..8841003 100644
--- a/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
+++ b/lv2/lv2plug.in/ns/lv2core/lv2core.ttl
@@ -417,13 +417,9 @@ not the plugin itself.</p>
lv2:index a rdf:Property , owl:DatatypeProperty ;
- rdfs:domain lv2:Port ;
rdfs:range xsd:nonNegativeInteger ;
rdfs:label "index" ;
- rdfs:comment """
-Specifies the index of the port, passed as an argument to the connect port
-function. The index uniqely identifies the port on an instance of the plugin.
-""" .
+ rdfs:comment "A non-negative zero-based index." .
lv2:symbol a rdf:Property , owl:DatatypeProperty ;
rdfs:label "symbol" ;
@@ -449,26 +445,33 @@ port identification. The plugin author may change the values of this
property without changing the Plugin URI.
""" .
- a rdfs:Class ;
- rdfs:subClassOf rdf:Property ;
+lv2:Designation a rdfs:Class ;
+ rdfs:label "Designation" ;
lv2:documentation """
-<p>A <q>parameter</q> of a plugin. A parameter is simply a recognized
-property, identified by URI. Parameters are abstract in the sense that they
-may be controlled by several methods. The simplest is with an
-lv2:ControlPort, which can be associated with a parameter using
-lv2:isParameter. Other methods, such as setting dynamic parameters via
-messages, are possible but not defined in this specification. The concept of a
-parameter is deliberately separate from any particular code mechanism, so that
-a parameter can be defined once and used in several contexts.</p>
+<p>The designation (or <q>assignment</q>) of an input or output. A designation
+is metadata that describes the meaning or role of data. By assigning a
+designation to a port using lv2:designation, the port's content becomes
+meaningful and can be used more intelligently by the host.</p>
+""" .
-<p>Parameters are <em>meaningful</em> controls which allow hosts to act
-intelligently. For example, if a plugin has a foo:volume parameter, and the
-host understands it, the host knows how to automatically control the volume of
-that plugin.</p>
+lv2:Channel a rdfs:Class ;
+ rdfs:label "Channel" ;
+ rdfs:subClassOf lv2:Designation ;
+ lv2:documentation """
+<p>A specific channel of audio, e.g. <q>left</q> or <q>right</q>.</p>
+""" .
-<p>Any existing property can be used as a parameter, an LV2 specific definition
-is not required.</p>
+lv2:Parameter a rdfs:Class ;
+ rdfs:subClassOf rdf:Property , lv2:Designation ;
+ lv2:documentation """
+<p>A parameter, i.e. a recognized property. A parameter is a designation for a
+<p>A parameter defines the <em>meaning</em> of a control (not the
+<em>method</em> of conveying its value). The standard way of exposing a plugin
+parameter is via an lv2:ControlPort, which can be given a parameter designation
+with lv2:designation. Other methods, such as setting dynamic parameters via
+messages, are possible but not defined here.</p>
""" .
lv2:hasParameter a rdf:Property , owl:ObjectProperty ;
@@ -478,26 +481,27 @@ lv2:hasParameter a rdf:Property , owl:ObjectProperty ;
<p>Indicates that a specific parameter is supported. This predicate is to
advertise that a plugin supports a parameter in some way other than a port
value, such as a message interface. It is not necessary use for control port
-parameters, simply use lv2:isParameter on the port for that.</p>
+parameters, simply use lv2:designation on the port for that.</p>
<p>This property may be used to indicate any resource has a parameter, it is
not restricted to plugins.</p>
""" .
-lv2:isParameter a rdf:Property , owl:ObjectProperty ;
- rdfs:domain lv2:Port ;
- rdfs:range lv2:Parameter ;
- rdfs:label "is parameter" ;
+lv2:designation a rdf:Property , owl:ObjectProperty ;
+ rdfs:range lv2:Designation ;
+ rdfs:label "assignment" ;
lv2:documentation """
-<p>Indicates that a port contains the value of a plugin parameter.</p>
+<p>Indicates a channel or parameter designation.</p>
-<p>For example, if a port lv2:isParameter foo:gain, then the value of that port
-represents the foo:gain of the plugin instance. Associating a port with a
-well-defined parameter gives the port's value meaning, which allows the host
-to use the port more intelligently.</p>
+<p>This property is used to give the port's contents a well-defined meaning.
+For example, if a port has lv2:designation eg:gain, then the value of that port
+represents the eg:gain of the plugin instance.</p>
-<p>For a given parameter, plugins SHOULD have at most one port per direction
-(lv2:InputPort or lv2:OutputPort).</p> """ .
+<p>Ports should be given designations whenever a well-defined designation
+exists. This allows the host to act more intelligently and/or provide a more
+effective user interface. For example, if the plugin has a BPM parameter, the
+host may automatically set that parameter to the current tempo.</p>
+""" .