Matrix Modulation
🚫
soon, currently not available in v0.3.0
┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
│ RGXP: BPM: 120 MDE: anuesyz BUF: Face Step Bars │
│ FLAG: i m DIV: 8 MVE: [f]rdp SYM: Phs: [ ][ ][ ] │
│ ERRR: - LEN: w:1,h:1 ACM: - RPL: AnX: [ ][ ][ ] │ ←───┐
│ TOTL: - POS: x:0,y:0 CHN: 1/1 Bar: [ ][ ][ ] │ ─┐ │
│ MIDI: IAC Driver Bus 1 LCK: - TLT: | ph:0.00 ax:0.00 br:0.00 │ │ │
└─────────────────────────────────────────────────────────────────────────────────────────────────┘ │ │
CHRM C# ━#━#█━#━#━#━━#━#█━#━#━#━━#━#█━#━#█━#━#━#━━#━#█━#━#━#━━#━#█━#━#█━#━━#█━#━#━#━━#━# +3 -7 │ │
[ ∧ ] █ █ █ █ █ █ █ █ │ │
HARM A ↑ -2 +5 │ │
│ │ ↑ │ │
│ │ │ │ │
│ 1. event matrix modulation normalized to 0.0-1.0 ────────────────────────────────┘
│ │ │ │
└────────────────────────────────────────────────────────────────────────────┘ └───────┘
3. the dice will determines 2. it will control
how the scale evolve how the dice change
over time
A modulation matrix that routes internal sequencer signals to Dice parameters, letting Dice behaviour evolve automatically based on what the sequencer is already doing.
Signal Flow
SOURCE ──(normalize)──► 0.0..1.0 ──(amount)──► MATRIX CELL ──(map)──► DESTINATION- Source, a live sequencer value, normalized to
0.0..1.0 - Matrix cell, an
amount(-1.0..1.0) that scales the source - Destination, converts the scaled value into the target’s own type and range
Sources
Each source is sampled once per bar.
| Source | Behaviour |
|---|---|
MovementPhase | Ramp tracking active step progress through the playhead area. Shape depends on movement mode, ramp up (Forward), ramp down (Reverse), triangle (Pendulum), stepped random (Random). |
PlayheadAnchorX | Where the playhead area is parked on the grid (0 = leftmost). Changes only when the user moves it with hjkl, not on every step. |
BarCount | Ramp that resets every N bars. |
Destinations
Three Dice parameters can be driven by the matrix.
| Destination | Range | Effect |
|---|---|---|
DiceFace | 1–6 | Which face is active, determines how many dots (scale steps) are in the cycle. |
DiceStep | -1, 0, +1 | Dot advance direction: +1 forward, -1 reverse, 0 hold. |
DiceBarsDiv | 1–16 | How many bars pass before the active dot advances. |
The Matrix
A 2D routing table, rows are sources, columns are destinations. Each cell holds an amount or is empty.
Face Step Bars
Phs: [+1.0][+1.0][ ] ←──────────── MovementPhase
AnX: [ ][ ][+0.5] ←──────────── PlayheadAnchorX
Bar: [-0.5][ ][ ] ←──────────── BarCount
ph:0.00 ax:0.00 br:0.00 ←──────────── Movement State
The amount is a multiplier applied before mapping: v = (source × amount).clamp(0.0, 1.0). When multiple routes target the same destination, the last one wins.
| Amount | Effect |
|---|---|
+1.0 | Full range, min → max |
-1.0 | Inverted, max → min |
+0.5 | Compressed, lower half only |
0.0 | No modulation |
Example Routes
| Source | Dest | Amount | Musical effect |
|---|---|---|---|
MovementPhase | DiceStep | +1.0 | Dice direction follows playhead movement. |
MovementPhase | DiceFace | +1.0 | Dice face cycles as playhead sweeps through area. |
PlayheadAnchorX | DiceBarsDiv | +0.5 | Area parked left = fast steps, parked right = slower. |
BarCount | DiceFace | -1.0 | Dice face counts down over the bar cycle. |