From 2765ce386605360c121e130d81e50412045b47bf Mon Sep 17 00:00:00 2001 From: David Robillard 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 """ +

Indicates that a plugin or other resource has a certain parameter. 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.

+ +

Any property URI can be used as a parameter, no LV2 specific definition is +required. Existing vocabularies SHOULD be used whenever possible.

+""" . + +lv2:isParameter a rdf:Property , owl:ObjectProperty ; rdfs:domain lv2:Port ; + rdfs:range rdf:Property ; rdfs:label "relation" ; lv2:documentation """ -

Indicates the relation the value of a port represents. The value of this -property must the URI of some relation (i.e. a predicate).

+

Indicates that a port contains the value of a plugin parameter.

-

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.

+

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).

-

Plugins SHOULD NOT have several ports with the same lv2:relation.

-""" . +

For a given parameter, plugins SHOULD have at most one port per direction +(lv2:InputPort or lv2:OutputPort).

""" . #################################### -- cgit v1.2.1