ZMidi.Score.BarBeatPos

Summary: Functions for representing MIDI time musically.

Documentation

getBeatInBar :: TimeSig -> TPB -> Time -> (Bar, Beat, BeatRat)

Within a MidiScore we can musically describe every (quantised) position in time in Bar, Beat, and BarRat. Therefore, we need the TimeSignature, the length of a beat (TPB, in ticks), and the actual Time stamp.

getBarRat :: TimeSig -> TPB -> Time -> (Bar, BarRat)

Similar to getBeatInBar we can also describe the musical position as the combination of a Bar and a BarRat. The latter denotes the ratio within a bar, e.g. BarRat (3 % 4) denotes the 4th Beat in the bar.

toRatInBeat :: TimeSig -> BarRat -> (Beat, BeatRat)

toRatInBeat allows us to convert a BarRat into a (Beat,BeatRat)

toBarRat :: QBins -> TimeSig -> (Beat, BeatRat) -> BarRat

Musically it is sometimes more intuitive to have a BarRat, i.e. the onset is defined as the ratio within the bar. For example 1%4 denotes them the position of the second quarter note within a 4/4 meter