1@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
2@prefix owl:  <http://www.w3.org/2002/07/owl#> .
3@prefix pset: <http://lv2plug.in/ns/ext/presets#> .
4@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
5@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
6@prefix xsd:  <http://www.w3.org/2001/XMLSchema#> .
7
8<http://lv2plug.in/ns/ext/presets>
9	a owl:Ontology ;
10	rdfs:seeAlso <lv2-presets.doap.ttl> ;
11	lv2:documentation """
12<p>This vocabulary describes a format for presets (i.e. named sets of control
13values and possibly other state) for LV2 plugins.  The structure of a
14pset:Preset is deliberately identical to that of an lv2:Plugin, and can be
15thought of as a plugin template or overlay.</p>
16
17<p>Presets may be defined in any bundle, including the plugin's bundle,
18separate third party preset bundles, or user preset bundles saved by hosts.
19Since preset data tends to be large, it is recommended that plugins describe
20presets in a separate file(s) to avoid slowing down hosts.  The manifest.ttl of
21a bundle containing presets should list the presets like so:</p>
22
23<pre class="turtle-code">
24eg:mypreset
25    a             pset:Preset ;
26    lv2:appliesTo eg:myplugin ;
27    rdfs:seeAlso  &lt;mypreset.ttl&gt; .
28</pre>
29""" .
30
31pset:Bank
32	a rdfs:Class ;
33	rdfs:label "Bank" ;
34	rdfs:subClassOf [
35		a owl:Restriction ;
36		owl:onProperty rdfs:label ;
37		owl:someValuesFrom xsd:string ;
38		rdfs:comment "A Bank MUST have at least one string rdfs:label."
39	] ;
40	rdfs:comment "A bank of presets." .
41
42pset:Preset
43	a rdfs:Class ;
44	rdfs:subClassOf lv2:PluginBase ;
45	rdfs:label "Preset" ;
46	rdfs:subClassOf [
47		a owl:Restriction ;
48		owl:onProperty rdfs:label ;
49		owl:someValuesFrom xsd:string ;
50		rdfs:comment "A Preset MUST have at least one string rdfs:label."
51	] ;
52	lv2:documentation """
53<p>A Preset for an LV2 Plugin.  The structure of a Preset deliberately mirrors that
54of a plugin, so existing predicates can be used to describe any data associated with
55the preset.  For example:</p>
56
57<pre class="turtle-code">
58@prefix eg: &lt;http://example.org/&gt; .
59
60eg:mypreset
61    a pset:Preset ;
62    rdfs:label "One louder" ;
63    lv2:appliesTo eg:myplugin ;
64    lv2:port [
65        lv2:symbol "volume1" ;
66        pset:value 11.0
67    ] , [
68        lv2:symbol "volume2" ;
69        pset:value 11.0
70    ] .
71</pre>
72
73<p>A Preset SHOULD have at least one lv2:appliesTo property.  Each Port on a
74Preset MUST have at least a lv2:symbol property and a pset:value property.</p>
75
76<p>Hosts SHOULD save user presets to a bundle in the user-local LV2 directory
77(e.g. ~/.lv2) with a name like
78<code>&lt;Plugin_Name&gt;_&lt;Preset_Name&gt;.preset.lv2</code>
79(e.g. <code>LV2_Amp_At_Eleven.preset.lv2</code>), where names are transformed
80to be valid LV2 symbols for maximum compatibility.</p>
81""" .
82
83pset:bank
84	a rdf:Property ;
85	rdfs:domain pset:Preset ;
86	rdfs:range pset:Bank ;
87	rdfs:label "bank" ;
88	rdfs:comment "The bank this preset belongs to." .
89
90pset:value
91	a rdf:Property ;
92	rdfs:domain lv2:PortBase ;
93	rdfs:label "value" ;
94	rdfs:comment """Specifies the value of a Port on some Preset.  This property is used in a similar way to e.g. lv2:default.""" .
95
96pset:preset
97	a rdf:Property ;
98	rdfs:domain lv2:PluginBase ;
99	rdfs:range pset:Preset ;
100	rdfs:label "preset" ;
101	lv2:documentation """
102<p>Specifies the preset currently applied to a plugin instance.  This property
103may be useful for saving state, or notifying a plugin instance at run-time
104about a preset change.</p>
105""" .
106