tur/temporal

(slow [factor p])

play a pattern slower by a given factor.

Pattern<T> that plays at 1/factor speed.

  ((slow 2 my-pat) 1.0)  ; same as (my-pat 0.5)

(fast [factor p])

play a pattern faster by a given factor.

Pattern<T> that plays factor times faster.

  ((fast 2 my-pat) 1.0)  ; same as (my-pat 2.0)

(stretch [factor p])

stretch time within a cycle (alias for slow).

(compress [factor p])

compress time within a cycle (alias for fast).

(shift [offset p])

shift a pattern forward or backward in time.

Pattern<T> shifted in time.

  ((shift 0.5 my-pat) 1.0)  ; same as (my-pat 1.5)

(rot [amount p])

rotate a pattern's phase (alias for shift).

(mirror [p])

mirror a pattern within each 2-beat window.

Pattern<T> that plays forward in [0,1) then backward in [1,2).

  ((mirror my-pat) 1.5)  ; reads from time 0.5

(rev [p])

reverse a pattern within each 1-beat cycle.

Pattern<T> with reversed time within each cycle.

  ((rev my-pat) 0.25)  ; same as (my-pat 0.75)

(repeat [n p])

repeat a pattern n times within its cycle.

Pattern<T> playing n times faster.

  ((repeat 4 my-pat) 0.0)

(once [p & [zero 0])

play a pattern only during the first beat, then return zero.

(for-beats [duration p & [zero 0])

play a pattern for a fixed number of beats, then return zero.

(loop-cycles [cycles p & [zero 0])

loop a pattern for a fixed number of cycles then stop.

(loop-range [start end p & [zero 0])

loop a pattern between two time points.

(warp [warp-fn p])

remap time using an arbitrary function.

(warp-by [warp-pat p])

remap time by multiplying with values from another pattern.

(quantize-beat [p])

snap pattern evaluation to the nearest beat boundary.

(quantize [n p])

snap pattern evaluation to multiples of n beats.

Pattern<T> quantized to n-beat intervals.

  (quantize 0.25 my-pat)  ; 16th-note grid

(quantize-subdiv [subdivisions p])

snap pattern evaluation to a subdivision grid.

(time-mod [period p])

wrap time into a [0, period) window before evaluation.

(time-switch [period & patterns])

cycle through a list of patterns, each lasting period beats.

Pattern<T> switching to the next pattern every period beats.

  ((time-switch 4 pat-a pat-b pat-c) 5.0)  ; uses pat-b

(transform-time [p & transformations])

apply a sequence of temporal transformations to a pattern.

Pattern<T> with all transformations applied.

  (transform-time (cycle 1 2 3) [slow 2] [shift 0.5] [repeat 2])

(backwards [p & [duration 1.0])

play a pattern in reverse within each cycle.

(palindrome [p & [duration 1.0])

play a pattern forwards then backwards (ping-pong).

Pattern<T> playing forward then backward in a 2*duration window.

  ((palindrome my-pat) 1.5)  ; reads from time 0.5 (backwards half)

(stutter [subdivisions p])

repeat each value of a pattern subdivisions times.

Pattern<T> with stuttered output.

  ((stutter 4 my-pat) 0.5)  ; reads from floor(0.5/4) = 0

(time-window [start end p & [zero 0])

gate a pattern to a specific time window.

(fade-in [fade-duration p])

produce a linear ramp from 0 to 1 over fade-duration beats.

(fade-out [fade-duration start-time p])

produce a linear ramp from 1 to 0 starting at start-time.