aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/lv2plug.in/ns/ext/presets/presets.ttl
blob: 24dafc982718b36bdc9da5f572f0e26b0dc325cf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
@prefix dcs:  <http://ontologi.es/doap-changeset#> .
@prefix doap: <http://usefulinc.com/ns/doap#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
@prefix owl:  <http://www.w3.org/2002/07/owl#> .
@prefix pset: <http://lv2plug.in/ns/ext/presets#> .
@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd:  <http://www.w3.org/2001/XMLSchema#> .

<http://lv2plug.in/ns/ext/presets>
	a lv2:Specification ;
	rdfs:seeAlso <../../meta/meta.ttl> ;
	doap:license <http://opensource.org/licenses/isc> ;
	doap:name "LV2 Presets" ;
	doap:shortdesc "Presets for LV2 plugins. " ;
	doap:created "2009-00-00" ;
	doap:developer <http://drobilla.net/drobilla#me> ;
	doap:release [
		doap:revision "2.5" ;
		doap:created "2012-04-12" ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Add pset:preset property for describing the preset currently applied to a plugin instance."
			] , [
				rdfs:label "Remove pset:appliesTo property, use lv2:appliesTo instead."
			]
		]
	] , [
		doap:revision "2.2" ;
		doap:created "2011-11-21" ;
		doap:file-release <http://lv2plug.in/spec/lv2-presets-2.2.tar.bz2> ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Update packaging."
			] , [
				rdfs:label "Improve documentation."
			]
		]
	] , [
		doap:revision "2.0" ;
		doap:created "2010-10-04" ;
		doap:file-release <http://lv2plug.in/spec/lv2-presets-2.0.tar.gz> ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Initial release."
			]
		]
	] ;
	lv2:documentation """
<p>This extension describes a format for presets (i.e. named sets of control
values and possibly other state) for LV2 plugins.  The structure of a
pset:Preset is deliberately identical to that of an lv2:Plugin, and can be
thought of as a plugin template or overlay.  For example:</p>

<pre class="turtle-code">
@prefix eg: &lt;http://example.org/&gt; .

eg:mypreset
    a pset:Preset ;
    rdfs:label "One louder" ;
    lv2:appliesTo eg:myplugin ;
    lv2:port [
        lv2:symbol "volume1" ;
        pset:value 11.0
    ] , [
        lv2:symbol "volume2" ;
        pset:value 11.0
    ] .
</pre>

<p>Presets may be defined in any bundle, including the plugin's bundle,
separate third party preset bundles, or user preset bundles saved by hosts.
Since preset data tends to be large, it is recommended that plugins describe
presets in a separate file(s) to avoid slowing down 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 ;
    lv2:appliesTo eg:myplugin ;
    rdfs:seeAlso  &lt;mypreset.ttl&gt; .
</pre>
""" .

pset:Preset
	a rdfs:Class ;
	rdfs:subClassOf lv2:PluginBase ;
	rdfs:label "LV2 Preset" ;
	rdfs:subClassOf [
		a owl:Restriction ;
		owl:onProperty rdfs:label ;
		owl:someValuesFrom xsd:string ;
		rdfs:comment "A Preset MUST have at least one string rdfs:label."
	] ;
	lv2:documentation """
<p>A Preset for an LV2 Plugin.  A preset can be considered an "overlay" on a
Plugin.  Rather than attempting to define all valid predicates for a Preset
(which is not possible since presets may need to specify values for things
defined in other extensions), the presets extension simply provides this class
which can be augmented with any data in the exact same fashion as the
definition of a Plugin.</p>

<p>A Preset SHOULD have at least one lv2:appliesTo property.  Each Port on a
Preset MUST have at least a lv2:symbol property and a pset:value property.</p>
""" .

pset:value
	a rdf:Property ;
	rdfs:domain lv2:Port ;
	rdfs:label "Has value" ;
	rdfs:comment """
Specifies the value of a Port on some Preset.  This property is used
in a similar way to e.g. lv2:default.
""" .

pset:preset
	a rdf:Property ;
	rdfs:domain lv2:PluginBase ;
	rdfs:range pset:Preset ;
	rdfs:label "Preset" ;
	lv2:documentation """
<p>Specifies the preset currently applied to a plugin instance.  This property
may be useful for saving state, or notifying a plugin instance at run-time
about a preset change.</p>
""" .