From 71b9c3ae5fb85414f56c152eaf9d075bbfc0f6ff Mon Sep 17 00:00:00 2001
From: David Robillard <d@drobilla.net>
Date: Wed, 28 Mar 2012 00:19:37 +0000
Subject: Mark up control properties, port groups, and add documentation for
 plugins and ports.

git-svn-id: http://svn.drobilla.net/lad/trunk/plugins/mdala.lv2@4118 a436a847-0d15-0410-975c-d299462d15a1
---
 mdala.lv2/Tracker.ttl | 45 +++++++++++++++++++++++++++++++++++++--------
 1 file changed, 37 insertions(+), 8 deletions(-)

(limited to 'mdala.lv2/Tracker.ttl')

diff --git a/mdala.lv2/Tracker.ttl b/mdala.lv2/Tracker.ttl
index 7a04e01..caa3a0a 100644
--- a/mdala.lv2/Tracker.ttl
+++ b/mdala.lv2/Tracker.ttl
@@ -2,6 +2,8 @@
 @prefix lv2: <http://lv2plug.in/ns/lv2core#> .
 @prefix mdala: <http://drobilla.net/plugins/mdala/> .
 @prefix pg: <http://lv2plug.in/ns/ext/port-groups#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
 
 mdala:Tracker
 	a lv2:Plugin ,
@@ -13,6 +15,9 @@ mdala:Tracker
 	lv2:pluginProperty lv2:hardRTCapable ;
 	pg:mainInput mdala:mainIn ;
 	pg:mainOutput mdala:mainOut ;
+	rdfs:comment """This plug-in tracks the frequency of the input signal with an oscillator, ring modulator or filter.  The pitch tracking only works with monophonic inputs, but can create interesting effects on unpitched sounds such as drums.
+
+This plug can be used with white or pink noise inputs to generate random pitch sequences.  Interesting evolving soundscapes can be made with a drum loop input and Tracker, RezFilter and Delay in series.""" ;
 	lv2:port [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -21,7 +26,24 @@ mdala:Tracker
 		lv2:symbol "mode" ;
 		lv2:default 0 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		lv2:portProperty lv2:enumeration ;
+		lv2:scalePoint [
+			rdf:value 0.0 ;
+			rdfs:label "Sine oscillator"
+		] , [
+			rdf:value 0.25 ;
+			rdfs:label "Square oscillator"
+		] , [
+			rdf:value 0.5 ;
+			rdfs:label "Sawtooth oscillator"
+		] , [
+			rdf:value 0.75 ;
+			rdfs:label "Ring modulator"
+		] , [
+			rdf:value 1.0 ;
+			rdfs:label "Peaking EQ"
+		]
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -30,7 +52,8 @@ mdala:Tracker
 		lv2:symbol "dynamics" ;
 		lv2:default 1 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Apply dynamics of input signal to generated output"
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -39,7 +62,8 @@ mdala:Tracker
 		lv2:symbol "mix" ;
 		lv2:default 1 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Wet/dry mix"
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -48,7 +72,8 @@ mdala:Tracker
 		lv2:symbol "glide" ;
 		lv2:default 0.97 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Maximum pitch change rate"
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -57,7 +82,8 @@ mdala:Tracker
 		lv2:symbol "transpose" ;
 		lv2:default 0.5 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Pitch offset to create harmonics, octave doubling, etc."
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -66,7 +92,8 @@ mdala:Tracker
 		lv2:symbol "maximum" ;
 		lv2:default 0.8 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Maximum allowed pitch - to supress pitch tracking errors"
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -75,7 +102,8 @@ mdala:Tracker
 		lv2:symbol "trigger" ;
 		lv2:default 0.5 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Threshold level for pitch tracker - raise to stop tracking in gaps"
 	] , [
 		a lv2:InputPort ,
 			lv2:ControlPort ;
@@ -84,7 +112,8 @@ mdala:Tracker
 		lv2:symbol "output" ;
 		lv2:default 0.5 ;
 		lv2:minimum 0.0 ;
-		lv2:maximum 1.0
+		lv2:maximum 1.0 ;
+		rdfs:comment "Level trim"
 	] , [
 		a lv2:InputPort ,
 			lv2:AudioPort ;
-- 
cgit v1.2.1