aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--lv2/ns/ext/presets/presets.ttl39
1 files changed, 37 insertions, 2 deletions
diff --git a/lv2/ns/ext/presets/presets.ttl b/lv2/ns/ext/presets/presets.ttl
index 0fd3a3f..ddc383e 100644
--- a/lv2/ns/ext/presets/presets.ttl
+++ b/lv2/ns/ext/presets/presets.ttl
@@ -59,8 +59,43 @@
]
]
] ;
- rdfs:comment """
-Defines presets (e.g. named sets of control values) for LV2 plugins.
+ lv2:documentation """
+<p>This extension describes a format for presets (i.e. named sets of control
+values) for LV2 plugins. The structure of pset:Preset is deliberately very
+similar to the description of a plugin and can be thought of as a plugin
+<q>overlay</q>. For example:</p>
+
+<pre class="turtle-code">
+@prefix eg: &lt;http://example.org/&gt; .
+
+eg:mypreset
+ a pset:Preset ;
+ rdfs:label "One louder" ;
+ pset:appliesTo eg:myplugin ;
+ lv2:port [
+ lv2:symbol "volume1" ;
+ pset:value 11
+ ] , [
+ lv2:symbol "volume2" ;
+ pset:value 11.0
+ ] .
+</pre>
+
+<p>Presets may be defined in any bundles, including the plugin's bundle,
+separate third party preset bundles, or user-created preset bundles created by
+hosts. The manifest.ttl of a bundle containing presets should list the
+presets like so:</p>
+
+<pre class="turtle-code">
+eg:mypreset
+ a pset:Preset ;
+ pset:appliesTo eg:myplugin ;
+ rdfs:seeAlso &lt;mypreset.ttl&gt; .
+</pre>
+
+<p>This extension does not define a dynamic mechanism for changing plugin
+presets for plugins that require such a facility, but may be extended to do
+so.</p>
""" .
pset:Preset