duration_glyph

duration_glyph(duration: Duration | None)

The note glyph for a duration, or None where there is none.

A duration with numerator, denominator, dots and ratio (WSMN’s MetricalDuration) whose value is a power-of-two fraction of a whole note gets its glyph, a dot per augmentation dot, and a tuplet ratio as text after it; a tied duration its members joined by a tie; a grace duration the word grace and its nominal glyph.

>>> from openmusickit.systems.wsmn.temporal.symbols import quarter, dotted_half, eighth, eighth_in_triplet
>>> from openmusickit.systems.wsmn.temporal.metrical_duration import MetricalDuration, TiedDuration
>>> duration_glyph(quarter), duration_glyph(dotted_half), duration_glyph(eighth_in_triplet)
('♩', '𝅗𝅥.', '♪ 3:2')
>>> duration_glyph(TiedDuration((quarter, eighth))), duration_glyph(MetricalDuration(1, 128))
('♩‿♪', None)
>>> from openmusickit.values.time.duration import GraceDuration
>>> duration_glyph(GraceDuration(eighth)), duration_glyph(None)
('grace ♪', None)