tur/mini

(defstruct MiniToken [])

a single lexed token from a mini-notation string.

(mini-tokenize [s])

lex a mini-notation string into a vector of tokens.

vec<MiniToken> in source order.

  (mini-tokenize "1 2 3")

(parse-expr [tokens index])

recursive descent parser for mini-notation tokens.

(apply-op [op left right])

apply an infix operator to two patterns.

(parse-mini [s])

parse a mini-notation expression string into a pattern.

NumPattern.

  (parse-mini "1 2 3")
  (parse-mini "[1 2 3]")  ; => fast 2x

(s [expr])

inline mini-notation macro.

(s "1 2 3")  ; same as (parse-mini "1 2 3")

(parse-drums [s])

parse drum mini-notation into a sequenced drum pattern.

Pattern<map> producing drum parameters for each step.

  (parse-drums "bd sd bd sd")

(d [expr])

drum pattern macro.

(d "bd sd")  ; same as (parse-drums "bd sd")

(parse-note [note-str & [default-octave 4])

parse a note name string into a MIDI note number.

MIDI note number as int.

  (parse-note "c4")   ; => 60
  (parse-note "a4")   ; => 69

(parse-notes [s])

parse a space-separated note string into a cycling MIDI pattern.

NumPattern cycling through MIDI note numbers.

  (parse-notes "c4 e4 g4")

(n [expr])

note pattern macro.

(n "c4 e4 g4")  ; same as (parse-notes "c4 e4 g4")

(parse-chord [s])

parse bracket-delimited chord notation into a constant chord pattern.

Pattern<vec<int>> that always returns the same MIDI note vector.

  (parse-chord "[c4 e4 g4]")

(chord [expr])

chord pattern macro.

(chord "[c4 e4 g4]")  ; same as (parse-chord "[c4 e4 g4]")

(parse-rhythm [s & [hit-value 1 rest-value 0])

parse an x/o shorthand rhythm string into a numeric pattern.

NumPattern cycling through hit/rest values.

  (parse-rhythm "x o x o")  ; => alternating 1 and 0

(r [expr])

rhythm pattern macro.

(r "x o x o")  ; same as (parse-rhythm "x o x o")

(parse-with-repeat [s])

expand *n repetition notation before cycling.

NumPattern with expanded sequence.

  (parse-with-repeat "bd*2 sd")  ; => cycle of bd bd sd

(mini [s])

parse a complete mini-notation expression (alias for parse-mini).