3.2.51 font-interface

Any symbol that is typeset through fixed sets of glyphs, (i.e., fonts).

User-settable properties:

font-encoding (symbol)

The font encoding is the broadest category for selecting a font. Currently, only lilypond’s system fonts (Emmentaler) are using this property. Available values are fetaMusic (Emmentaler), fetaBraces, fetaText (Emmentaler).

font-family (symbol)

The font family is the broadest category for selecting text fonts. Options include serif, sans and typewriter.

font-features (list)

Opentype features.

font-name (string)

This property is kept for backwards compatibility only. Use the fonts property instead.

font-series (symbol)

Select the series of a font. Common choices are normal and bold. The full list of symbols that can be used is: thin, ultralight, light, semilight, book, normal, medium, semibold, bold, ultrabold, heavy, ultraheavy.

font-shape (symbol)

Select the shape of a font. Possible values are upright, italic, oblique, and slanted (which is the same as oblique).

font-size (number)

The font size, compared to the ‘normal’ size. 0 is style-sheet’s normal size, -1 is smaller, +1 is bigger. Each step of 1 is approximately 12% larger; 6 steps are exactly a factor 2 larger. If the context property fontSize is set, its value is added to this before the glyph is printed. Fractional values are allowed.

font-stretch (symbol)

Select a condensed or expanded font, if available in the font family. Possible values are ultra-condensed, extra-condensed, condensed, semi-condensed, normal, semi-expanded, expanded, extra-expanded, and ultra-expanded.

font-variant (symbol)

Select the variant of a font. Choices include normal and small-caps.

fonts (alist, with symbols as keys)

An alist mapping font families to font names. The standard font families are music, serif, sans and typewriter.

Internal properties:

font (font metric)

A cached font metric object.

This grob interface is used in the following graphical object(s): Accidental, AccidentalCautionary, AccidentalSuggestion, AmbitusAccidental, AmbitusLine, AmbitusNoteHead, Arpeggio, BalloonText, BarLine, BarNumber, BassFigure, BendSpanner, BreathingSign, CaesuraScript, CenteredBarNumber, ChordName, Clef, ClefModifier, CodaMark, CombineTextScript, CueClef, CueEndClef, Custos, Divisio, Dots, DoublePercentRepeat, DoublePercentRepeatCounter, DoubleRepeatSlash, DurationLine, DynamicText, DynamicTextSpanner, Episema, FingerGlideSpanner, Fingering, Flag, Footnote, FretBoard, Glissando, GridChordName, HorizontalBracketText, InstrumentName, InstrumentSwitch, JumpScript, KeyCancellation, KeySignature, KievanLigature, LyricHyphen, LyricRepeatCount, LyricText, MeasureCounter, MeasureSpanner, MensuralLigature, MetronomeMark, MultiMeasureRest, MultiMeasureRestNumber, MultiMeasureRestScript, MultiMeasureRestText, NonMusicalPaperColumn, NoteHead, NoteName, OttavaBracket, PaperColumn, Parentheses, PercentRepeat, PercentRepeatCounter, RehearsalMark, Rest, Script, SectionLabel, SegnoMark, SignumRepetitionis, SostenutoPedal, SpanBar, StaffEllipsis, StanzaNumber, StringNumber, StrokeFinger, SustainPedal, SystemStartBrace, SystemStartBracket, SystemStartSquare, TabNoteHead, TextMark, TextScript, TextSpanner, TimeSignature, TrillPitchAccidental, TrillPitchHead, TrillPitchParentheses, TrillSpanner, TupletNumber, UnaCordaPedal, VaticanaLigature and VoltaBracket.


LilyPond Internals Reference v2.25.21 (development-branch).