docs: update readme

src/mixer.rs

@@ -258,3 +258,89 @@ pub trait MixerTrackDevice: Debug + Send + Sync {
 impl MixerTrackDevice for Sampler {}
 
 impl MixerTrackDevice for Plugin {}
+
+const SYM_NAME:    &str = ":name";
+const SYM_GAIN:    &str = ":gain";
+const SYM_SAMPLER: &str = "sampler";
+const SYM_LV2:     &str = "lv2";
+
+from_edn!("mixer/track" => |jack: &Arc<RwLock<JackConnection>>, args| -> MixerTrack {
+    let mut _gain = 0.0f64;
+    let mut track = MixerTrack {
+        name:       String::new(),
+        audio_ins:  vec![],
+        audio_outs: vec![],
+        devices:    vec![],
+    };
+    edn!(edn in args {
+        Edn::Map(map) => {
+            if let Some(Edn::Str(n)) = map.get(&Edn::Key(SYM_NAME)) {
+                track.name = n.to_string();
+            }
+            if let Some(Edn::Double(g)) = map.get(&Edn::Key(SYM_GAIN)) {
+                _gain = f64::from(*g);
+            }
+        },
+        Edn::List(args) => match args.first() {
+            // Add a sampler device to the track
+            Some(Edn::Symbol(SYM_SAMPLER)) => {
+                track.devices.push(
+                    Box::new(Sampler::from_edn(jack, &args[1..])?) as Box<dyn MixerTrackDevice>
+                );
+                panic!(
+                    "unsupported in track {}: {:?}; tek_mixer not compiled with feature \"sampler\"",
+                    &track.name,
+                    args.first().unwrap()
+                )
+            },
+            // Add a LV2 plugin to the track.
+            Some(Edn::Symbol(SYM_LV2)) => {
+                track.devices.push(
+                    Box::new(Plugin::from_edn(jack, &args[1..])?) as Box<dyn MixerTrackDevice>
+                );
+                panic!(
+                    "unsupported in track {}: {:?}; tek_mixer not compiled with feature \"plugin\"",
+                    &track.name,
+                    args.first().unwrap()
+                )
+            },
+            None =>
+                panic!("empty list track {}", &track.name),
+            _ =>
+                panic!("unexpected in track {}: {:?}", &track.name, args.first().unwrap())
+        },
+        _ => {}
+    });
+    Ok(track)
+});
+
+//impl ArrangerScene {
+
+    ////TODO
+    ////pub fn from_edn <'a, 'e> (args: &[Edn<'e>]) -> Usually<Self> {
+        ////let mut name  = None;
+        ////let mut clips = vec![];
+        ////edn!(edn in args {
+            ////Edn::Map(map) => {
+                ////let key = map.get(&Edn::Key(":name"));
+                ////if let Some(Edn::Str(n)) = key {
+                    ////name = Some(*n);
+                ////} else {
+                    ////panic!("unexpected key in scene '{name:?}': {key:?}")
+                ////}
+            ////},
+            ////Edn::Symbol("_") => {
+                ////clips.push(None);
+            ////},
+            ////Edn::Int(i) => {
+                ////clips.push(Some(*i as usize));
+            ////},
+            ////_ => panic!("unexpected in scene '{name:?}': {edn:?}")
+        ////});
+        ////Ok(ArrangerScene {
+            ////name:  Arc::new(name.unwrap_or("").to_string().into()),
+            ////color: ItemColor::random(),
+            ////clips,
+        ////})
+    ////}
+//}