tur/synth

(pat->param [p session node-id param-index])

send a pattern value to a synth control at the current beat time.

(pats->params [session node-id param-patterns])

send multiple pattern values to synth controls.

(pats->named-params [session node-id param-map param-name->index])

send pattern values to named synth controls.

(defstruct PatternPlayer [])

a player that triggers and controls synths from a pattern.

(player-new [session def-name pattern bpm])

create a new (stopped) pattern player.

(player-start [player])

start a pattern player.

(player-stop [player])

stop a pattern player and free all its synth nodes.

(player-update [player new-pattern])

swap the pattern in a running player.

(player-swap [player new-param-map])

atomically swap parameter-map pattern in a player.

(pattern-synth [session def-name param-patterns & [bpm time/DEFAULT_BPM])

create a synth driven by pattern parameters at time 0.

(pattern-synth-player [session def-name param-patterns bpm duration])

create a player that continuously updates synth parameters.

(note->freq [note])

convert a MIDI note number to frequency in Hz.

Frequency in Hz.

  (note->freq 69)  ; => 440.0

(vel->amp [vel])

convert a MIDI velocity to a linear amplitude value.

Amplitude in [0, 1].

  (vel->amp 127)  ; => 1.0

(note-pattern [pitch & [vel (pattern/const 100) gate (pattern/const true)])

produce a synth parameter map from pitch, velocity, and gate patterns.

Pattern<map> with :freq, :amp, and :gate keys.

  ((note-pattern (cycle 60 62 64)) 0.0)

(note-pattern-dur [pitch vel dur & [gate (pattern/const true)])

note pattern including note duration.

(chord-pattern [& note-patterns])

stack multiple note patterns to play chords.

(arp-pattern [chord & [speed 4 direction :up])

arpeggiate a chord pattern.

IntPattern cycling through chord tones.

  ((arp-pattern my-chord 4 :up) 0.0)

(drum-pattern [& hits])

build a drum pattern from a list of (time, name, velocity) hits.

(drum-name->note [name])

map a drum abbreviation to a GM MIDI note number.

(kick [& times])

kick drum pattern triggered at specific beat positions.

Pattern<map> with {:note 36 :vel 127} on hits, {} otherwise.

  ((kick 0 1 2 3) 0.0)

(snare [& times])

snare drum pattern triggered at specific beat positions.

Pattern<map> with {:note 38 :vel 100} on hits, {} otherwise.

  ((snare 1 3) 1.0)

(hat [& times])

hi-hat pattern triggered at specific beat positions.

Pattern<map> with {:note 42 :vel 80} on hits, {} otherwise.

  ((hat 0 0.5 1 1.5 2 2.5 3 3.5) 0.0)

(pattern->osc [pattern session node-id time])

send a parameter map pattern to a synth node via OSC.

(trigger-pattern [session def-name pattern bpm])

create a player that spawns a new synth on each pattern event.

(freq-pattern [base-freq & [modulation (pattern/const 0)])

frequency pattern with optional additive modulation.

(amp-pattern [base-amp & [envelope (pattern/const 1)])

amplitude pattern with optional envelope modulation.

(pan-pattern [base-pan & [modulation (pattern/const 0)])

stereo pan pattern with optional modulation, clamped to [-1, 1].

(synth-params [freq-pattern amp-pattern pan-pattern])

combine freq, amp, and pan patterns into a parameter map pattern.

(synth-pattern-player [session def-name param-patterns bpm])

create a player driven by a named parameter map.