Skip to main content

addmarker​

addmarker(
    @onset ? ## int/float (required)
    @names null
    @role null
) -> null

Inserts a marker into the transcription score, given an onset time and, optionally, a list of names and/or role associated with that marker. Note that if marker role is assigned, names are not displayed in the score but are still associated with the marker. Roles are particularly useful when exporting scores as llll files for quantization purposes.

Arguments​

  • @onset ? [int/float]: marker onset position. (required)
  • @names [symbol/list/null]: optional list of marker names. (default: null).
  • @role [symbol/list/null]: optional marker role. (default: null).
    • 'tempo <unit> <bpm>': tempo marker role, followed by a tempo specification, as a unit ratio and bpm value.
    • 'timesig <time_sig_num> <time_sig_den>': time signature marker role, followed by a time signature, as a pair of numerator and denominator.
    • 'barline': barline marker role.
    • 'division': beat division marker role.
    • 'subdivision': beat subdivision marker role.

Usage​

$onsets = 0 500 1000 1500 2000;
for $onset $i in $onsets do (
    addmarker(@onset $onset @names $i)
)