The font size of notation elements may be altered. It does not
change the size of variable symbols, such as beams or slurs.
-@warning{For @strong{text} font sizes, see
+@warning{For font sizes of text, see
@ref{Common markup commands}.}
@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
Font size changes are achieved by scaling the design size that is
closest to the desired size. The standard font size (for
-@code{font-size = #0}), depends on the standard staff height.
+@code{font-size = #0}) depends on the standard staff height.
For a 20pt staff, a 10pt font is selected.
The @code{font-size} property can only be set on layout objects
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{fontSize},
-@internalsref{font-size},
-@internalsref{font-interface}.
+@rinternals{fontSize},
+@rinternals{font-size},
+@rinternals{font-interface}.
@node Fingering instructions
@cindex thumb-script
-You can use the thumb-script (e.g., in cello music) to indicate that a
-note should be played with the thumb.
+A thumb-script can be added (e.g., in cello music) to indicate
+that a note should be played with the thumb.
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
<a_\thumb a'-3>2 <b_\thumb b'-3>
@ref{Controlling direction and placement}
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{FingeringEvent},
-@internalsref{fingering-event},
-@internalsref{Fingering_engraver},
-@internalsref{New_fingering_engraver},
-@internalsref{Fingering}.
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
@node Hidden notes
@unnumberedsubsubsec Hidden notes
-@cindex Hidden notes
-@cindex Invisible notes
-@cindex Transparent notes
+@cindex hidden notes
+@cindex invisible notes
+@cindex transparent notes
@funindex \hideNotes
@funindex \unHideNotes
c
@end lilypond
+Notation objects which are attached to invisible notes are still
+visible.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+c4( d)
+\hideNotes
+e4(\p f)--
+@end lilypond
+
+
@predefined
+@funindex \hideNotes
+@funindex \unHideNotes
@code{\hideNotes}, @code{\unHideNotes}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Note_spacing_engraver},
-@internalsref{NoteSpacing}.
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
@node Coloring objects
\with-color #(x11-color 'navy) "Clarinet"
}
-% black
\override Stem #'color = #(rgb-color 0 0 0)
gis8 a
-% white
\override Stem #'color = #(rgb-color 1 1 1)
gis8 a
-% dark blue
\override Stem #'color = #(rgb-color 0 0 0.5)
gis4 a
@end lilypond
the input}.
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
@knownissues
An X11 color is not necessarily exactly the same shade as a
@cindex parentheses
Objects may be parenthesized by prefixing @code{\parenthesize} to
-the music event. When applied to a chord, it parenthesizes every
-note.
+the music event. When prefixed to a chord, it parenthesizes every
+note. Individual notes inside a chord may also be parenthesized.
@lilypond[quote,relative=2,fragment,verbatim,ragged-right]
c2 \parenthesize d
c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
@end lilypond
Non-note objects may be parenthesized as well.
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Parenthesis_engraver},
-@internalsref{ParenthesesItem},
-@internalsref{parentheses-interface}.
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
+
+@knownissues
+
+Parenthesizing a chord prints parentheses around each individual
+note, instead of a single large parenthesis around the entire
+chord.
@node Stems
@ref{Controlling direction and placement}.
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Stem_engraver},
-@internalsref{Stem},
-@internalsref{stem-interface}.
+@rinternals{Stem_engraver},
+@rinternals{Stem},
+@rinternals{stem-interface}.
@node Outside the staff
}
@end lilypond
+@cindex balloon
+@cindex notation, explaining
+
There are two music functions, @code{balloonGrobText} and
@code{balloonText}; the former is used like @code{\once \override} to
attach text to any grob, and the latter is used like @code{\tweak},
typically within chords, to attach text to an individual note.
-@cindex balloon
-@cindex notation, explaining
+Balloon text normally influences note spacing, but this can be
+altered:
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\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.
+}
+@end lilypond
+
+
+@predefined
+
+@funindex balloonLengthOn
+@funindex balloonLengthOff
+@code{\balloonLengthOn}, @code{\balloonLengthOff}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Balloon_engraver},
-@internalsref{BalloonTextItem},
-@internalsref{balloon-interface}.
+@rinternals{Balloon_engraver},
+@rinternals{BalloonTextItem},
+@rinternals{balloon-interface}.
@node Grid lines
Vertical lines can be drawn between staves synchronized with the
notes.
+The @code{Grid_point_engraver} must be used to create the end
+points of the lines, while the @code{Grid_line_span_engraver} must
+be used to actually draw the lines. By default this centers grid
+lines horizontally below and to the left side of each note head.
+Grid lines extend from the middle lines of each staff. The
+@code{gridInterval} must specify the duration between the grid
+lines.
+
@lilypond[quote,verbatim,ragged-right]
\layout {
\context {
\Staff
- % set up grids
\consists "Grid_point_engraver"
- % set the grid interval to one quarter note
gridInterval = #(ly:make-moment 1 4)
}
\context {
\Score
- % by default this centers grid lines horizontally below
- % and to the left side of the note head, the grid lines
- % extending from the middle lines of each staff
\consists "Grid_line_span_engraver"
}
}
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
-{grid-lines-changing-their-appearance.ly}
+{grid-lines--changing-their-appearance.ly}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Grid_line_span_engraver},
-@internalsref{Grid_point_engraver},
-@internalsref{GridLine},
-@internalsref{GridPoint},
-@internalsref{grid-line-interface},
-@internalsref{grid-point-interface}.
+@rinternals{Grid_line_span_engraver},
+@rinternals{Grid_point_engraver},
+@rinternals{GridLine},
+@rinternals{GridPoint},
+@rinternals{grid-line-interface},
+@rinternals{grid-point-interface}.
@node Analysis brackets
@lilypond[quote,verbatim,ragged-right]
\layout {
\context {
- \Staff
+ \Voice
\consists "Horizontal_bracket_engraver"
}
}
@lilypond[quote,verbatim,ragged-right]
\layout {
\context {
- \Staff
+ \Voice
\consists "Horizontal_bracket_engraver"
}
}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Horizontal_bracket_engraver},
-@internalsref{HorizontalBracket},
-@internalsref{horizontal-bracket-interface},
-@internalsref{Staff}.
+@rinternals{Horizontal_bracket_engraver},
+@rinternals{HorizontalBracket},
+@rinternals{horizontal-bracket-interface},
+@rinternals{Staff}.