bach.track — bach 1.0.0-SNAPSHOT

compile-track clj

(compile-track track)

Provides a 'compiled' version of a parsed track that contains all of the information necessary to easily interpret a track as a single stream of normalized data (no references, all values are resolved)

compiled-track clj

default-headers clj

default-scale clj

default-tempo clj

default-time-signature clj

deref-variables clj

(deref-variables track)

Dereferences any variables found in the parsed track. Does NOT support hoisting (yet)

find-header clj

(find-header track label default)

Generically finds a header entry / meta tag in a parsed track by its label

get-beat-unit clj

(get-beat-unit track)

Determines the reference unit to use for beats, based on time signature

get-beat-unit-ratio clj

(get-beat-unit-ratio track)

Determines the ratio between the beat unit and the number of beats per measure

get-beats-per-measure clj

(get-beats-per-measure track)

Determines how many beats are in each measure, based on the time signature

get-headers clj

(get-headers track)

Provides the headers (aka meta info) for a parsed track

get-lowest-beat clj

(get-lowest-beat track)

Despite its name, this determines the greatest common beat (by duration) among every beat in a track. Once a this beat is found, a track can be iterated through evenly (and without variance) by its duration. This logic serves as the basis for normalization of the track, enabling trivial and optimal interpretation.

get-meter clj

(get-meter track)

get-ms-per-beat clj

(get-ms-per-beat track)

Determines the number of milliseconds each beat should be played for (normalized to lowest common beat). Mostly exists to make parsing easier for the high-level interpreter / player

get-normalized-beats-per-measure clj

(get-normalized-beats-per-measure track)

Determines how many beats are in a measure, normalized against the lowest beat of the track

get-normalized-total-beats clj

(get-normalized-total-beats track)

Determines the total beats in a track normalized to the lowest beat of the track

get-normalized-total-measures clj

(get-normalized-total-measures track)

Determines the total number of measures in a track, normalized to the lowest common beat

get-scaled-beat-unit clj

(get-scaled-beat-unit track)

Determines the reference unit to use for beats, scaled to a quarter note @see https://music.stackexchange.com/a/24141

get-scaled-total-beats clj

(get-scaled-total-beats track)

Determines the total number of beats in the track scaled to the beat unit (4/4 time, 4 beats = four quarter notes)

get-tags clj

(get-tags track)

get-tempo clj

(get-tempo track)

get-time-signature clj

(get-time-signature track)

get-title clj

(get-title track)

get-total-beats clj

(get-total-beats track)

Determines the total number of beats in the track (1 = 1 whole note, NOT necessarily 1 measure depending on the context).

get-total-duration clj

(get-total-duration track unit)

Determines the total time duration of a track (milliseconds, seconds, minutes)

get-total-measures clj

(get-total-measures track)

Determines the total number of measures in the track. Beats and measures are equivelant here since the beats are not normalized to the lowest common beat

normalize-duration clj

(normalize-duration duration unit meter)

Adjusts a beat's duration from being based on whole notes (i.e. 1 = 4 quarter notes) to being based on the provided beat unit (i.e. the duration of a single normalized beat). In general, this determines 'How many unitsdoes the provideddurationequal considering themeter` (i.e. time-sig)?.

normalize-measures clj

(normalize-measures track)

Parses the track data exported via Play into a normalized matrix where each row (measure) has the same number of elements (beats). Makes parsing the track much easier for the high-level interpreter / player as the matrix is trivial to iterate through.

powers-of-two clj

provision-headers clj

(provision-headers track)

Combines default static meta information with dynamic meta information to provide a provisioned set of headers

reduce-track clj

(reduce-track track)

Dereferences variables and reduces the primitive values in a parsed track

reduce-values clj

(reduce-values track)

Reduces any primitive values in a parsed track

validate clj

(validate track)

Determines if a parsed track is valid or not

validate-memo clj

variable-scope clj

(variable-scope scope)

Provides a localized scope/stack for tracking variables