tur/timing

(defstruct BeatClock [])

tracks beat time from a running sample counter.

(make-beat-clock [bpm sample-rate])

create a new beat clock at the given BPM and sample rate.

BeatClock starting at sample 0.

  (make-beat-clock 120.0 48000.0)

(clock->beats [clock sample-offset])

convert a sample offset to beats.

(clock->samples [clock beats])

convert a beat offset to samples.

(clock-advance [clock samples])

advance the clock by a number of samples.

(clock-now [clock])

get the current beat time from a clock.

(defstruct ScheduledEvent [])

an event queued for future execution at a specific beat.

(defstruct EventQueue [])

ordered queue of scheduled events.

(queue-new)

create an empty event queue.

(queue-push [queue event])

add an event to an event queue.

(queue-pop [queue])

remove and return the earliest event from the queue.

(queue-peek [queue])

look at the earliest event without removing it.

(defstruct PatternScheduler [])

scheduler combining a beat clock with an event queue.

(scheduler-new [clock])

create a new pattern scheduler.

(schedule-pattern [sched pattern at-beat callback])

schedule a pattern to be evaluated at a specific beat.

(schedule-param [sched node-id pattern at-beat])

schedule a synth parameter update at a specific beat.

(process-events [sched current-beat])

fire all events due at or before current-beat.

(process-samples [sched samples])

advance the clock by samples and fire due events.

(audio-pattern [p clock])

wrap a pattern for audio-rate evaluation using sample offsets.

(mix-audio-patterns [& patterns])

mix multiple audio-rate patterns by summation.

(audio-pattern-block [p clock block-size])

render a block of audio from a pattern.

(defstruct SampleAccuratePattern [])

pattern with sample-accurate timing state.

(make-sample-accurate [p clock])

wrap a pattern for sample-accurate evaluation.

(sap-eval [sap sample-offset])

evaluate a sample-accurate pattern at a sample offset.

(sap-update [sap new-sample])

advance a sample-accurate pattern to a new sample position.

(samples->beats [samples bpm sample-rate])

convert sample count to beats.

(beats->samples [beats bpm sample-rate])

convert beat time to sample count.

(defstruct TempoTracker [])

tracks beat time across multiple tempo changes.

(tempo-tracker-new [bpm sample-rate])

create a new tempo tracker at a constant initial BPM.

(tempo-change [tracker at-sample new-bpm])

record a tempo change at a specific sample position.

(tempo-at [tracker sample])

query the BPM at a specific sample position.

(beats-at [tracker sample])

compute beat time at a sample accounting for tempo changes.

(schedule-at-sample [sched at-sample callback])

schedule a callback to fire at a specific sample position.

(schedule-pattern-at-sample [sched at-sample pattern callback])

schedule a pattern evaluation at a sample position.