Sound.Sc3.Server.Param

Synthesis parameters

Documentation

type Param1 = (String, Double)

An Sc3 synthesis parameter, ie. (controlName, controlValue).

type Param = [Param1]

Set of Sc3 synthesiser parameters.

param_insert :: Param -> Param1 -> Param

Add new, or overwrite existing, parameter.

param_merge_uniq :: Param -> Param -> Param

Merge, require keys be unique.

>>> param_merge_uniq [("a",1),("b",2)] [("c",3),("d",4)]
[("a",1.0),("b",2.0),("c",3.0),("d",4.0)]

param_merge_uniq [("a",1)] [("a",2)] -- error

param_merge_r :: Param -> Param -> Param

Merge, right biased.

>>> param_merge_r [("a",1),("b",2)] [("c",3),("a",4)]
[("b",2.0),("c",3.0),("a",4.0)]

param_merge_r_seq :: [Param] -> Param

Right-fold (right-biased) of param_merge

>>> param_merge_r_seq [[("a",1),("b",2)],[("c",3),("a",4)],[("b",5)]]
[("c",3.0),("a",4.0),("b",5.0)]

param_get :: Param -> String -> Double -> Double

Lookup parameter value, with default.

param_parse :: (Char, Char) -> String -> Param

Given (param-separator,key-value-separator) parse paramter string.

>>> param_parse (';','=') "a=1;b=2"
[("a",1.0),("b",2.0)]

param_pp :: (Char, Char) -> Int -> Param -> String

Inverse of param_parse, k is the precision to print values to.

>>> param_pp (';','=') 4 [("a",1),("b",2)]
"a=1.0;b=2.0"