Next: , Up: Text markup commands


B.8.1 Font

\abs-fontsize size (number) arg (markup)

Use size as the absolute font size to display arg. Adjust baseline skip and word space accordingly.

          
          \markup {
            default text font size
            \hspace #2
            \abs-fontsize #16 { text font size 16 }
            \hspace #2
            \abs-fontsize #12 { text font size 12 }
          }
     

[image of music]


\bigger arg (markup)

Increase the font size relative to current setting.

          
          \markup {
            \huge {
              huge
              \hspace #2
              \bigger {
                bigger
              }
              \hspace #2
              huge
            }
          }
     

[image of music]


\bold arg (markup)

Switch to bold font-series.

          
          \markup {
            default
            \hspace #2
            \bold
            bold
          }
     

[image of music]


\box arg (markup)

Draw a box round arg. Looks at thickness, box-padding and font-size properties to determine line thickness and padding around the markup.

          
          \markup {
            \override #'(box-padding . 0.5)
            \box
            \line { V. S. }
          }
     

[image of music]

Used properties:


\caps arg (markup)

Copy of the \smallCaps command.

          
          \markup {
            default
            \hspace #2
            \caps {
              Text in small caps
            }
          }
     

[image of music]


\dynamic arg (markup)

Use the dynamic font. This font only contains s, f, m, z, p, and r. When producing phrases, like ‘più f’, the normal words (like ‘più’) should be done in a different font. The recommended font for this is bold and italic.

          
          \markup {
            \dynamic {
              sfzp
            }
          }
     

[image of music]


\finger arg (markup)

Set the argument as small numbers.

          
          \markup {
            \finger {
              1 2 3 4 5
            }
          }
     

[image of music]


\fontCaps arg (markup)

Set font-shape to caps

Note: \fontCaps requires the installation and selection of fonts which support the caps font shape.

\fontsize increment (number) arg (markup)

Add increment to the font-size. Adjust baseline skip accordingly.

          
          \markup {
            default
            \hspace #2
            \fontsize #-1.5
            smaller
          }
     

[image of music]

Used properties:


\huge arg (markup)

Set font size to +2.

          
          \markup {
            default
            \hspace #2
            \huge
            huge
          }
     

[image of music]


\italic arg (markup)

Use italic font-shape for arg.

          
          \markup {
            default
            \hspace #2
            \italic
            italic
          }
     

[image of music]


\large arg (markup)

Set font size to +1.

          
          \markup {
            default
            \hspace #2
            \large
            large
          }
     

[image of music]


\larger arg (markup)

Copy of the \bigger command.

          
          \markup {
            default
            \hspace #2
            \larger
            larger
          }
     

[image of music]


\magnify sz (number) arg (markup)

Set the font magnification for its argument. In the following example, the middle A is 10% larger:

     A \magnify #1.1 { A } A

Note: Magnification only works if a font name is explicitly selected. Use \fontsize otherwise.

          
          \markup {
            default
            \hspace #2
            \magnify #1.5 {
              50% larger
            }
          }
     

[image of music]


\medium arg (markup)

Switch to medium font series (in contrast to bold).

          
          \markup {
            \bold {
              some bold text
              \hspace #2
              \medium {
                medium font series
              }
              \hspace #2
              bold again
            }
          }
     

[image of music]


\normal-size-sub arg (markup)

Set arg in subscript, in a normal font size.

          
          \markup {
            default
            \normal-size-sub {
              subscript in standard size
            }
          }
     

[image of music]

Used properties:


\normal-size-super arg (markup)

Set arg in superscript with a normal font size.

          
          \markup {
            default
            \normal-size-super {
              superscript in standard size
            }
          }
     

[image of music]

Used properties:


\normal-text arg (markup)

Set all font related properties (except the size) to get the default normal text font, no matter what font was used earlier.

          
          \markup {
            \huge \bold \sans \caps {
              Some text with font overrides
              \hspace #2
              \normal-text {
                Default text, same font-size
              }
              \hspace #2
              More text as before
            }
          }
     

[image of music]


\normalsize arg (markup)

Set font size to default.

          
          \markup {
            \teeny {
              this is very small
              \hspace #2
              \normalsize {
                normal size
              }
              \hspace #2
              teeny again
            }
          }
     

[image of music]


\number arg (markup)

Set font family to number, which yields the font used for time signatures and fingerings. This font only contains numbers and some punctuation. It doesn't have any letters.

          
          \markup {
            \number {
              0 1 2 3 4 5 6 7 8 9 . ,
            }
          }
     

[image of music]


\roman arg (markup)

Set font family to roman.

          
          \markup {
            \sans \bold {
              sans serif, bold
              \hspace #2
              \roman {
                text in roman font family
              }
              \hspace #2
              return to sans
            }
          }
     

[image of music]


\sans arg (markup)

Switch to the sans serif family.

          
          \markup {
            default
            \hspace #2
            \sans {
              sans serif
            }
          }
     

[image of music]


\simple str (string)

A simple text string; \markup { foo } is equivalent with \markup { \simple #"foo" }.

Note: for creating standard text markup or defining new markup commands, the use of \simple is unnecessary.

          
          \markup {
            \simple #"simple"
            \simple #"text"
            \simple #"strings"
          }
     

[image of music]


\small arg (markup)

Set font size to -1.

          
          \markup {
            default
            \hspace #2
            \small
            small
          }
     

[image of music]


\smallCaps text (markup)

Emit arg as small caps.

Note: \smallCaps does not support accented characters.

          
          \markup {
            default
            \hspace #2
            \smallCaps {
              Text in small caps
            }
          }
     

[image of music]


\smaller arg (markup)

Decrease the font size relative to current setting.

          
          \markup {
            \fontsize #3.5 {
              some large text
              \hspace #2
              \smaller {
                a bit smaller
              }
              \hspace #2
              more large text
            }
          }
     

[image of music]


\sub arg (markup)

Set arg in subscript.

          
          \markup {
            \concat {
              H
              \sub {
                2
              }
              O
            }
          }
     

[image of music]

Used properties:


\super arg (markup)

Raising and lowering texts can be done with \super and \sub:

          
          \markup {
            E =
            \concat {
              mc
              \super
              2
            }
          }
     

[image of music]

Used properties:


\teeny arg (markup)

Set font size to -3.

          
          \markup {
            default
            \hspace #2
            \teeny
            teeny
          }
     

[image of music]


\text arg (markup)

Use a text font instead of music symbol or music alphabet font.

          
          \markup {
            \number {
              1, 2,
              \text {
                three, four,
              }
              5
            }
          }
     

[image of music]


\tiny arg (markup)

Set font size to -2.

          
          \markup {
            default
            \hspace #2
            \tiny
            tiny
          }
     

[image of music]


\typewriter arg (markup)

Use font-family typewriter for arg.

          
          \markup {
            default
            \hspace #2
            \typewriter
            typewriter
          }
     

[image of music]


\underline arg (markup)

Underline arg. Looks at thickness to determine line thickness and y offset.

          
          \markup {
            default
            \hspace #2
            \override #'(thickness . 2)
            \underline {
              underline
            }
          }
     

[image of music]

Used properties:


\upright arg (markup)

Set font shape to upright. This is the opposite of italic.

          
          \markup {
            \italic {
              italic text
              \hspace #2
              \upright {
                upright text
              }
              \hspace #2
              italic again
            }
          }
     

[image of music]

This page is for LilyPond-2.11.58 (development-branch).

Report errors to http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.

Your suggestions for the documentation are welcome.

Other languages: français, español, deutsch.