leaftools.set_preprolated_leaf_duration

abjad.tools.leaftools.set_preprolated_leaf_duration.set_preprolated_leaf_duration(leaf, new_preprolated_duration)[source]

New in version 1.1.

Set preprolated leaf duration:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> spannertools.BeamSpanner(staff.leaves)
BeamSpanner(c'8, d'8, e'8, f'8)
abjad> leaftools.set_preprolated_leaf_duration(staff[1], Duration(3, 16))
[Note("d'8.")]
abjad> f(staff)
\new Staff {
    c'8 [
    d'8.
    e'8
    f'8 ]
}

Set tied preprolated leaf duration:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> spannertools.BeamSpanner(staff.leaves)
BeamSpanner(c'8, d'8, e'8, f'8)
abjad> leaftools.set_preprolated_leaf_duration(staff[1], Duration(5, 32))
[Note("d'8"), Note("d'32")]
abjad> f(staff)
\new Staff {
    c'8 [
    d'8 ~
    d'32
    e'8
    f'8 ]
}

Set nonbinary preprolated leaf duration:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> spannertools.BeamSpanner(staff.leaves)
BeamSpanner(c'8, d'8, e'8, f'8)
abjad> leaftools.set_preprolated_leaf_duration(staff[1], Duration(1, 12))
[Note("d'8")]
abjad> f(staff)
\new Staff {
    c'8 [
    \times 2/3 {
        d'8
    }
    e'8
    f'8 ]
}

Set tied nonbinary preprolated leaf duration:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> spannertools.BeamSpanner(staff.leaves)
BeamSpanner(c'8, d'8, e'8, f'8)
abjad> leaftools.set_preprolated_leaf_duration(staff[1], Duration(5, 48))
[Note("d'8"), Note("d'32")]
abjad> f(staff)
\new Staff {
    c'8 [
    \times 2/3 {
        d'8 ~
        d'32
    }
    e'8
    f'8 ]
}

Set preprolated leaf duration with LilyPond multiplier:

abjad> note = Note(0, (1, 8))
abjad> note.duration_multiplier = Duration(1, 2)
abjad> leaftools.set_preprolated_leaf_duration(note, Duration(5, 48))
[Note("c'8 * 5/6")]
abjad> f(note)
c'8 * 5/6

Return list of leaf and leaves newly tied to leaf.

Changed in version 2.0: renamed leaftools.change_leaf_preprolated_duration() to leaftools.set_preprolated_leaf_duration().

This Page