aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/parameters
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2020-03-22 16:36:44 +0100
committerDavid Robillard <d@drobilla.net>2020-04-10 19:46:04 +0200
commit430284545345539c9ffb31df889debac1d3888b5 (patch)
treedc9bb1f32f0d6fe34a7339221389048e199f14a5 /lv2/parameters
parentc4514483da1ab4f49148f9c4fe4ff5b559323217 (diff)
downloadlv2-430284545345539c9ffb31df889debac1d3888b5.tar.xz
Move documentation to metadata files and convert it to Markdown
Diffstat (limited to 'lv2/parameters')
-rw-r--r--lv2/parameters/parameters.meta.ttl29
-rw-r--r--lv2/parameters/parameters.ttl55
2 files changed, 52 insertions, 32 deletions
diff --git a/lv2/parameters/parameters.meta.ttl b/lv2/parameters/parameters.meta.ttl
index 028b3b0..5fcd047 100644
--- a/lv2/parameters/parameters.meta.ttl
+++ b/lv2/parameters/parameters.meta.ttl
@@ -1,6 +1,8 @@
@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 param: <http://lv2plug.in/ns/ext/parameters#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
<http://lv2plug.in/ns/ext/parameters>
@@ -44,5 +46,30 @@
doap:created "2009-00-00" ;
doap:shortdesc "Common parameters for audio processing." ;
doap:maintainer <http://drobilla.net/drobilla#me> ;
- doap:developer <http://lv2plug.in/ns/meta#larsl> .
+ doap:developer <http://lv2plug.in/ns/meta#larsl> ;
+ lv2:documentation """
+
+This is a vocabulary for parameters that are common in audio processing
+software. A <q>parameter</q> is purely a metadata concept, unrelated to any
+particular code mechanism. Parameters are used to assign meaning to controls
+(e.g. using lv2:designation for ports) so they can be used more intelligently
+or presented to the user more efficiently.
+
+"""^^lv2:Markdown .
+
+param:wetDryRatio
+ a lv2:Parameter ;
+ rdfs:label "wet/dry ratio" ;
+ lv2:documentation """
+
+The ratio between processed and bypass components in output signal. The dry
+and wet percentages can be calculated from the following equations:
+
+ :::c
+ dry = (wetDryRatio.maximum - wetDryRatio.value) / wetDryRatio.maximum
+ wet = wetDryRatio.value / wetDryRatio.maximum
+
+Typically, maximum value of 1 or 100 and minimum value of 0 should be used.
+
+"""^^lv2:Markdown .
diff --git a/lv2/parameters/parameters.ttl b/lv2/parameters/parameters.ttl
index 05b59ff..4ce2d8b 100644
--- a/lv2/parameters/parameters.ttl
+++ b/lv2/parameters/parameters.ttl
@@ -8,13 +8,9 @@
<http://lv2plug.in/ns/ext/parameters>
a lv2:Specification ;
- rdfs:seeAlso <parameters.meta.ttl> ;
- lv2:documentation """
-<p>This vocabulary describes parameters common in audio processing software. A
-<q>parameter</q> is purely a metadata concept, unrelated to any particular code
-mechanism. Parameters are used to assign meaning to controls (e.g. using
-lv2:designation for ports) so they can be used more intelligently or presented
-to the user more efficiently.</p> """ .
+ rdfs:label "LV2 Parameters" ;
+ rdfs:comment "Common parameters for audio processing." ;
+ rdfs:seeAlso <parameters.meta.ttl> .
param:ControlGroup
a rdfs:Class ;
@@ -25,41 +21,44 @@ param:ControlGroup
param:amplitude
a lv2:Parameter ;
rdfs:range atom:Float ;
- rdfs:label "amplitude" .
+ rdfs:label "amplitude" ;
+ rdfs:comment "An amplitude as a factor, where 0 is silent and 1 is unity." .
param:attack
a lv2:Parameter ;
rdfs:range atom:Float ;
rdfs:label "attack" ;
- rdfs:comment """The duration of an envelope's attack stage.""" .
+ rdfs:comment "The duration of an envelope attack stage." .
param:cutoffFrequency
a lv2:Parameter ;
rdfs:range atom:Float ;
- rdfs:label "cutoff frequency" .
+ rdfs:label "cutoff frequency" ;
+ rdfs:comment "The cutoff frequency, typically in Hz, for a filter." .
param:decay
a lv2:Parameter ;
rdfs:range atom:Float ;
rdfs:label "decay" ;
- rdfs:comment """The duration of an envelope's decay stage.""" .
+ rdfs:comment "The duration of an envelope decay stage." .
param:delay
a lv2:Parameter ;
rdfs:range atom:Float ;
rdfs:label "delay" ;
- rdfs:comment """The duration of an envelope's delay stage.""" .
+ rdfs:comment "The duration of an envelope delay stage." .
param:frequency
a lv2:Parameter ;
rdfs:range atom:Float ;
- rdfs:label "frequency" .
+ rdfs:label "frequency" ;
+ rdfs:comment "A frequency, typically in Hz." .
param:hold
a lv2:Parameter ;
rdfs:range atom:Float ;
rdfs:label "hold" ;
- rdfs:comment """The duration of an envelope's hold stage.""" .
+ rdfs:comment "The duration of an envelope hold stage." .
param:pulseWidth
a lv2:Parameter ;
@@ -77,7 +76,7 @@ param:release
a lv2:Parameter ;
rdfs:range atom:Float ;
rdfs:label "release" ;
- rdfs:comment """The duration of an envelope's release stage.""" .
+ rdfs:comment "The duration of an envelope release stage." .
param:resonance
a lv2:Parameter ;
@@ -89,7 +88,7 @@ param:sustain
a lv2:Parameter ;
rdfs:label "sustain" ;
rdfs:range atom:Float ;
- rdfs:comment """The level (not duration) of an envelope's sustain stage.""" .
+ rdfs:comment "The level of an envelope sustain stage as a factor." .
param:threshold
a lv2:Parameter ;
@@ -100,7 +99,8 @@ param:threshold
param:waveform
a lv2:Parameter ;
rdfs:range atom:Float ;
- rdfs:label "waveform" .
+ rdfs:label "waveform" ;
+ rdfs:comment """The waveform "fader" for oscillators or modulators that have several.""" .
param:gain
a lv2:Parameter ;
@@ -115,18 +115,7 @@ param:gain
param:wetDryRatio
a lv2:Parameter ;
rdfs:label "wet/dry ratio" ;
- lv2:documentation """
-<p>The ratio between processed and bypass components in output signal. The dry
-and wet percentages can be calculated from the following equations:</p>
-
-<pre class="c-code">
- dry = (wetDryRatio.maximum - wetDryRatio.value) / wetDryRatio.maximum
- wet = wetDryRatio.value / wetDryRatio.maximum
-</pre>
-
-<p>Typically, maximum value of 1 or 100 and minimum value of 0 should be
-used.</p>
-""" .
+ rdfs:comment "The ratio between processed and bypassed levels in the output." .
param:wetLevel
a lv2:Parameter ;
@@ -141,7 +130,7 @@ param:dryLevel
param:bypass
a lv2:Parameter ;
rdfs:label "bypass" ;
- rdfs:comment "A boolean parameter that disabled processing if true." .
+ rdfs:comment "A boolean parameter that disables processing if true." .
param:sampleRate
a lv2:Parameter ;
@@ -151,7 +140,8 @@ param:sampleRate
param:EnvelopeControls
a rdfs:Class ;
rdfs:subClassOf param:ControlGroup ;
- rdfs:label "DAHDSR Envelope Controls" ;
+ rdfs:label "Envelope Controls" ;
+ rdfs:comment "Typical controls for a DAHDSR envelope." ;
pg:element [
lv2:index 0 ;
lv2:designation param:delay
@@ -176,6 +166,7 @@ param:OscillatorControls
a rdfs:Class ;
rdfs:subClassOf param:ControlGroup ;
rdfs:label "Oscillator Controls" ;
+ rdfs:comment "Typical controls for an oscillator." ;
pg:element [
lv2:designation param:frequency
] , [
@@ -190,6 +181,7 @@ param:FilterControls
a rdfs:Class ;
rdfs:subClassOf param:ControlGroup ;
rdfs:label "Filter Controls" ;
+ rdfs:comment "Typical controls for a filter." ;
pg:element [
lv2:designation param:cutoffFrequency
] , [
@@ -200,6 +192,7 @@ param:CompressorControls
a rdfs:Class ;
rdfs:subClassOf param:ControlGroup ;
rdfs:label "Compressor Controls" ;
+ rdfs:comment "Typical controls for a compressor." ;
pg:element [
lv2:designation param:threshold
] , [