feat(matrix): res modulation target

sound_algo/data_only/matrix.scd

@@ -28,12 +28,12 @@
 ~matModTargets   = ~matModTargets   ? IdentityDictionary[
     \kick->[\amp,\pan,\rev], \hats->[\amp,\pan,\rev], \clap->[\amp,\pan,\rev],
     \perc->[\amp,\cutoff,\pan,\rev],
-    \sub->[\amp,\pan,\rev], \acid->[\amp,\cutoff,\pan,\rev], \arp->[\amp,\cutoff,\pan,\rev],
-    \lead->[\amp,\cutoff,\pan,\rev], \stab->[\amp,\cutoff,\pan,\rev], \pad->[\amp,\cutoff,\pan,\rev],
+    \sub->[\amp,\pan,\rev,\res], \acid->[\amp,\cutoff,\pan,\rev,\res], \arp->[\amp,\cutoff,\pan,\rev,\res],
+    \lead->[\amp,\cutoff,\pan,\rev,\res], \stab->[\amp,\cutoff,\pan,\rev,\res], \pad->[\amp,\cutoff,\pan,\rev,\res],
     \ride->[\amp,\pan,\rev], \rim->[\amp,\pan,\rev], \tom->[\amp,\pan,\rev],
-    \reese->[\amp,\cutoff,\pan,\rev],
-    \bells->[\amp,\pan,\rev], \sweep->[\amp,\pan,\rev],
-    \melody->[\amp,\cutoff,\pan,\rev], \chord->[\amp,\cutoff,\pan,\rev],
+    \reese->[\amp,\cutoff,\pan,\rev,\res],
+    \bells->[\amp,\pan,\rev,\res], \sweep->[\amp,\pan,\rev],
+    \melody->[\amp,\cutoff,\pan,\rev,\res], \chord->[\amp,\cutoff,\pan,\rev,\res],
     \fx->[\amp,\pan,\rev], \snare->[\amp,\pan,\rev],
     \crash->[\amp,\pan,\rev], \shaker->[\amp,\pan,\rev]
 ];
@@ -181,13 +181,19 @@ File.exists(~matDir).not.if({ ("mkdir -p " ++ ~matDir.quote).systemCmd });
                 var a = 0; list.do { |b| a = a + (~matModSourceVal.(b[\source]) * b[\depth]) };
                 a.clip(0, 1)
             }]
+        }, {
+        (tgt == \res).if({
+            pairs = pairs ++ [\res, Pfunc {
+                var a = 0; list.do { |b| a = a + (~matModSourceVal.(b[\source]) * b[\depth]) };
+                a.clip(0, 1)
+            }]
         }, {
             pairs = pairs ++ [\amp, Pfunc {
                 var base = (spec[\amp] ? 1.0) * volOf.value;
                 list.do { |b| base = base * (1 + (b[\depth] * (~matModSourceVal.(b[\source]) * 2 - 1))).max(0) };
                 base
             }]
-        }) }) })
+        }) }) }) })
     };
     pairs
 };

sound_algo/data_only/test/test_matrix.scd

@@ -456,6 +456,21 @@ pass = pass and: {
     pf.notNil and: { (pf.asStream.next(()) - 0.4).abs < 0.001 }
 };
 ~matVoiceMods[\acid] = [];
+// --- res target (cycle 1) ---
+// res: additive, two sources sum and clip 0..1
+~matVoiceMods[\acid] = [ (source: \rHandY, target: \res, depth: 0.5),
+                          (source: \bodyY,  target: \res, depth: 0.5) ];
+~matModCache[\rHandY] = 1.0; ~matModCache[\bodyY] = 1.0;   // 1*0.5 + 1*0.5 = 1.0 (clip)
+pass = pass and: {
+    var pairs, pf;
+    pairs = ~matModPairs.(\acid, (amp: 1.0), { 1.0 });
+    pf    = pairs[pairs.indexOf(\res) + 1];
+    pf.notNil and: { (pf.asStream.next(()) - 1.0).abs < 0.001 }
+};
+~matVoiceMods[\acid] = [];
+// res target is gated to res-voices: ~matModTargets[\hats] must NOT include \res
+pass = pass and: { (~matModTargets[\hats] ? []).includes(\res).not };
+pass = pass and: { (~matModTargets[\acid] ? []).includes(\res) };
 // disallowed target: kick has no cutoff in ~matModTargets -> gated out
 ~matVoiceMods[\kick] = [ (source: \bodyY, target: \cutoff, depth: 1.0) ];
 pass = pass and: { ~matModPairs.(\kick, (amp: 1.0), { 1.0 }).includes(\cutoff).not };