aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2011-03-18 06:31:39 +0000
committerDavid Robillard <d@drobilla.net>2011-03-18 06:31:39 +0000
commit32f0a41640a5dff6f80ba1eb64bc961bd840f691 (patch)
tree3d990de6136e23e99f1bed3bc2ad6cacd9c21151
parent673c2fa8e710c94b1ce250ec7b01d183d2bf91a0 (diff)
downloadlv2-32f0a41640a5dff6f80ba1eb64bc961bd840f691.tar.xz
Tidy.
-rw-r--r--core.lv2/ChangeLog1
-rw-r--r--core.lv2/lv2.ttl152
2 files changed, 64 insertions, 89 deletions
diff --git a/core.lv2/ChangeLog b/core.lv2/ChangeLog
index 0d7db59..507a791 100644
--- a/core.lv2/ChangeLog
+++ b/core.lv2/ChangeLog
@@ -10,6 +10,7 @@ lv2core (UNRELEASED) unstable; urgency=low
* Fix definition of lv2:minimum etc. (used for values, not scale points)
* More precisely define properties with OWL
* Move project metadata to manifest
+ * Add lv2:enumeration port property.
-- David Robillard <d@drobilla.net> UNRELEASED
diff --git a/core.lv2/lv2.ttl b/core.lv2/lv2.ttl
index 4350f8b..c013119 100644
--- a/core.lv2/lv2.ttl
+++ b/core.lv2/lv2.ttl
@@ -28,20 +28,15 @@
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix doap: <http://usefulinc.com/ns/doap#> .
-####################
-## Resource Class ##
-####################
+###########################
+## General LV2 Resources ##
+###########################
lv2:Resource a rdfs:Class , owl:Class ;
rdfs:comment """
An LV2 Resource (e.g. plugin, specification, or any other LV2 related thing).
""" .
-
-#########################
-## Specification Class ##
-#########################
-
lv2:Specification a rdfs:Class , owl:Class ;
rdfs:subClassOf lv2:Resource ;
rdfs:comment """
@@ -52,10 +47,22 @@ so hosts may discover all present LV2 data. See http://lv2plug.in/docs for
more details.
""" .
-
-#######################
-## LV2 Specification ##
-#######################
+lv2:documentation a rdf:Property , owl:DatatypeProperty ;
+ rdfs:range rdfs:Literal ;
+ rdfs:label "documentation" ;
+ rdfs:seeAlso <http://www.w3.org/TR/xhtml-basic/> ;
+ lv2:documentation """
+<p>Relates a Resource to documentation markup. The value of this property
+MUST be a string literal which is a valid XHTML Basic 1.1 fragment suitable
+for use as the content of a &lt;div&gt; element. This can be used by
+hosts to provide rich online documentation or by tools to generate external
+documentation pages. The standard language tagging facility of RDF can be
+used to provide multi-lingual documentation.</p>
+<p>XHTML Basic is a W3C Recommendation which defines a basic subset of XHTML
+intended to be reasonable to implement with limited resources (e.g. on embedded
+devices). See <a href="http://www.w3.org/TR/xhtml-basic/#s_xhtmlmodules"
+>XHTML Basic, Section 3</a> for a list of legal tags.</p>
+""" .
<http://lv2plug.in/ns/lv2core>
a lv2:Specification ;
@@ -147,10 +154,9 @@ allowed. For example, a host may call <code>run()</code> for two different
plugin instances simultaneously.</p>
""" .
-
-#############################
-## Template/Plugin Classes ##
-#############################
+############
+## Plugin ##
+############
lv2:Template a rdfs:Class , owl:Class ;
rdfs:subClassOf lv2:Resource ;
@@ -187,10 +193,9 @@ e.g. <q>Tape Delay Unit</q>. Use doap:shortdesc or doap:description for more
detailed descriptions.</p>
""" .
-
-##################
-## Port Classes ##
-##################
+##########
+## Port ##
+##########
lv2:Port a rdfs:Class , owl:Class ;
rdfs:subClassOf lv2:Resource ;
@@ -276,10 +281,9 @@ lv2:AudioPort a rdfs:Class , owl:Class ;
with elements of C type <code>float</code>.</p>
""" .
-
-#####################################
-## Mandatory Plugin RDF Properties ##
-#####################################
+#######################
+## Plugin Properties ##
+#######################
lv2:port a rdf:Property , owl:ObjectProperty ;
rdfs:domain lv2:Template ;
@@ -418,32 +422,9 @@ if/when to load the data, knowing that it describes an additional resource and
not the plugin itself.</p>
""" .
-
-####################################
-## Documentation ##
-####################################
-
-lv2:documentation a rdf:Property , owl:DatatypeProperty ;
- rdfs:range rdfs:Literal ;
- rdfs:label "documentation" ;
- rdfs:seeAlso <http://www.w3.org/TR/xhtml-basic/> ;
- lv2:documentation """
-<p>Relates a Resource to documentation markup. The value of this property
-MUST be a string literal which is a valid XHTML Basic 1.1 fragment suitable
-for use as the content of a &lt;div&gt; element. This can be used by
-hosts to provide rich online documentation or by tools to generate external
-documentation pages. The standard language tagging facility of RDF can be
-used to provide multi-lingual documentation.</p>
-<p>XHTML Basic is a W3C Recommendation which defines a basic subset of XHTML
-intended to be reasonable to implement with limited resources (e.g. on embedded
-devices). See <a href="http://www.w3.org/TR/xhtml-basic/#s_xhtmlmodules"
->XHTML Basic, Section 3</a> for a list of legal tags.</p>
-""" .
-
-
-###################################
-## Mandatory Port RDF Properties ##
-###################################
+#####################
+## Port Properties ##
+#####################
lv2:index a rdf:Property , owl:DatatypeProperty ;
rdfs:domain lv2:Port ;
@@ -478,10 +459,9 @@ port identification. The plugin author may change the values of this
property without changing the Plugin URI.
""" .
-
-##################################
-## Optional Port RDF Properties ##
-##################################
+###########################
+## Port Range and Points ##
+###########################
lv2:Point a rdfs:Class , owl:Class ;
rdfs:label "Port value point" ;
@@ -515,7 +495,7 @@ lv2:minimum a rdf:Property , owl:DatatypeProperty ;
rdfs:domain lv2:Port ;
rdfs:label "Minimum value" ;
lv2:documentation """
-A hint to the host for the minimum useful value that the port will use. This
+A hint to the host for the minimum useful value that the port will use. This
is a <q>soft</q> limit; the plugin is required to gracefully accept all values
in the range of a port's data type.
""" .
@@ -529,10 +509,9 @@ This is a <q>soft</q> limit; the plugin is required to gracefully accept all
values in the range of a port's data type.</p>
""" .
-
-##############
-## Features ##
-##############
+#############
+## Feature ##
+#############
lv2:Feature a rdfs:Class , owl:Class ;
rdfs:subClassOf lv2:Resource ;
@@ -546,7 +525,7 @@ lv2:optionalFeature a rdf:Property , owl:ObjectProperty ;
rdfs:range lv2:Feature ;
rdfs:label "Optional feature" ;
lv2:documentation """
-<p>Signifies that a plugin or other resource supports a certain feature. If
+<p>Signifies that a plugin or other resource supports a certain feature. If
the host supports this feature, it MUST pass its URI and any additional data to
the plugin in LV2_Descriptor::instantiate(). The plugin MUST NOT fail to
instantiate if an optional feature is not supported by the host.</p>
@@ -557,7 +536,7 @@ lv2:requiredFeature a rdf:Property , owl:ObjectProperty ;
rdfs:range lv2:Feature ;
rdfs:label "Required feature" ;
lv2:documentation """
-<p>Signifies that a plugin or other resource requires a certain feature. If
+<p>Signifies that a plugin or other resource requires a certain feature. If
the host supports this feature, it MUST pass its URI and any additional data to
the plugin in LV2_Descriptor::instantiate(). The plugin MUST fail to
instantiate if a required feature is not present; hosts SHOULD always check
@@ -565,29 +544,6 @@ this before attempting to instantiate a plugin (i.e. discovery by attempting to
instantiate is strongly discouraged).</p>
""" .
-
-####################
-## PortProperties ##
-####################
-
-lv2:PortProperty a rdfs:Class , owl:Class ;
- rdfs:label "Port property" ;
- rdfs:comment """
-A port property - a useful piece of information that allows a host to make more
-sensible decisions (e.g. to provide a better interface).
-""" .
-
-lv2:portProperty a rdf:Property , owl:ObjectProperty ;
- rdfs:domain lv2:Port ;
- rdfs:range lv2:PortProperty ;
- rdfs:label "Port property" ;
- rdfs:comment """
-Relates Ports to PortProperties. The PortProperty may be ignored without
-catastrophic effects, though it may be useful e.g. for providing a sensible
-interface for the port.
-""" .
-
-
#######################
## Standard Features ##
#######################
@@ -597,7 +553,7 @@ lv2:isLive a lv2:Feature ;
lv2:documentation """
<p>Indicates that the plugin has a real-time dependency (e.g. queues data from
a socket) and so its output must not be cached or subject to significant
-latency, and calls to the run method should be done in rapid succession. This
+latency, and calls to the run method should be done in rapid succession. This
property is not related to <q>hard real-time</q> execution requirements (see
lv2:hardRTCapable).</p>
""" .
@@ -606,9 +562,9 @@ lv2:inPlaceBroken a lv2:Feature ;
rdfs:label "In-place broken" ;
lv2:documentation """
<p>Indicates that the plugin may cease to work correctly if the host elects to
-use the same data location for both input and output. Plugins that will fail
+use the same data location for both input and output. Plugins that will fail
to work correctly if ANY input port is connected to the same location as ANY
-output port MUST require this Feature. Doing so should be avoided as it makes
+output port MUST require this Feature. Doing so should be avoided as it makes
it impossible for hosts to use the plugin to process data <q>in-place</q>.</p>
""" .
@@ -640,6 +596,26 @@ plugin MUST satisfy all of the following:</p>
<p>Note these rules apply to the connect_port() function as well as run().</p>
""" .
+##################
+## PortProperty ##
+##################
+
+lv2:PortProperty a rdfs:Class , owl:Class ;
+ rdfs:label "Port property" ;
+ rdfs:comment """
+A port property - a useful piece of information that allows a host to make more
+sensible decisions (e.g. to provide a better interface).
+""" .
+
+lv2:portProperty a rdf:Property , owl:ObjectProperty ;
+ rdfs:domain lv2:Port ;
+ rdfs:range lv2:PortProperty ;
+ rdfs:label "Port property" ;
+ rdfs:comment """
+Relates Ports to PortProperties. The PortProperty may be ignored without
+catastrophic effects, though it may be useful e.g. for providing a sensible
+interface for the port.
+""" .
#############################
## Standard PortProperties ##
@@ -705,8 +681,6 @@ simply choosing the largest enumeration value less than or equal to the actual
input value (i.e. round the input value down).
""" .
-
-
####################
## Plugin Classes ##
####################