contexttools.get_instrument_mark_attached_to_component

abjad.tools.contexttools.get_instrument_mark_attached_to_component.get_instrument_mark_attached_to_component(component)[source]

New in version 2.1.

Get instrument mark attached to component:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> violin = contexttools.InstrumentMark('Violin ', 'Vn. ')
abjad> violin.attach(staff)
InstrumentMark(instrument_name='Violin ', short_instrument_name='Vn. ')(Staff{4})
abjad> f(staff)
\new Staff {
    \set Staff.instrumentName = \markup { Violin  }
    \set Staff.shortInstrumentName = \markup { Vn.  }
    c'8
    d'8
    e'8
    f'8
}
abjad> contexttools.get_instrument_mark_attached_to_component(staff)
InstrumentMark(instrument_name='Violin ', short_instrument_name='Vn. ')(Staff{4})

Return instrument mark.

Raise missing mark error when no instrument mark attaches to component.

This Page