Next: , Up: Outside the staff


Balloon help

Elements of notation can be marked and named with the help of a square balloon. The primary purpose of this feature is to explain notation.

     
     \new Voice \with { \consists "Balloon_engraver" }
     {
       \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
       a8 
       \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
       r
       <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2. 
     }

[image of music]

There are two music functions, balloonGrobText and balloonText; the former is used like \once \override to attach text to any grob, and the latter is used like \tweak, typically within chords, to attach text to an individual note.

Balloon text normally influences note spacing, but this can be altered:

     
     \new Voice \with { \consists "Balloon_engraver" }
     {
       \balloonLengthOff
       \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
       a8 
       \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
       r
       \balloonLengthOn
       <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2. 
     }

[image of music]

Predefined commands

\balloonLengthOn, \balloonLengthOff

See also

Snippets: Editorial annotations.

Internals Reference: Balloon_engraver, BalloonTextItem, balloon-interface.

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.