@end menu
@node Selecting notation font size
-@subsubsection Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
@cindex font size
@cindex font size, selecting
@cindex selecting font size
-The font size of notation elements may be altered:
-@ignore
+The font size of notation elements may be altered. It does not
+change the size of variable symbols, such as beams or slurs.
@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
-c8.->( d16 e4
+\huge
+c4.-> d8---3
\large
-c8.->( d16 e4
+c4.-> d8---3
\normalsize
-c8.->( d16 e4
+c4.-> d8---3
\small
-c8.->( d16 e4
-\normalsize
-c8.->( d16 e4
+c4.-> d8---3
\tiny
-c8.->( d16 e4
-@end lilypond
-@end ignore
-
-The easiest method of setting the font size of any context is by
-setting the @code{fontSize} property.
-
-@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
-c4
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g8 a
+c4.-> d8---3
+\normalsize
+c2
@end lilypond
-@noindent
-It does not change the size of variable symbols, such as beams or
-slurs.
-
@cindex font size scaling
-Internally, the @code{fontSize} context property will cause the
-@code{font-size} property to be set in all layout objects. The
-value of @code{font-size} is a number indicating the size relative
-to the standard size for the current staff height. Each step up
-is an increase of approximately 12% of the font size. Six steps
-is exactly a factor two. The Scheme function @code{magstep}
-converts a @code{font-size} number to a scaling factor. The
-@code{font-size} property can also be set directly, so that only
-certain layout objects are affected.
+Internally, this sets the @code{fontSize} property. This in turns
+causes the @code{font-size} property to be set in all layout
+objects. The value of @code{font-size} is a number indicating the
+size relative to the standard size for the current staff height.
+Each step up is an increase of approximately 12% of the font size.
+Six steps is exactly a factor two. The Scheme function
+@code{magstep} converts a @code{font-size} number to a scaling
+factor. The @code{font-size} property can also be set directly,
+so that only certain layout objects are affected.
@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
-c4
+\set fontSize = #3
+c4.-> d8---3
\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g8 a
+c4.-> d8---3
+\override Script #'font-size = #2
+c4.-> d8---3
+\override Stem #'font-size = #-5
+c4.-> d8---3
@end lilypond
@cindex standard font size
@code{font-size} equals 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 that
-use fonts. These are the ones supporting the @code{font-interface}
-layout interface.
+The @code{font-size} property can only be set on layout objects
+that use fonts. These are the ones supporting the
+@code{font-interface} layout interface.
@predefined
-The following commands set @code{fontSize} for the current voice:
-
@funindex \tiny
@code{\tiny},
@funindex \small
@code{\small},
@funindex \normalsize
-@code{\normalsize}.
+@code{\normalsize},
+@funindex \large
+@code{\large},
+@funindex \huge
+@code{\huge}.
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
-Internals Reference: @internalsref{font-interface}.
+Internals Reference:
+@internalsref{font-interface}.
@node Fingering instructions
-@subsubsection Fingering instructions
+@unnumberedsubsubsec Fingering instructions
@cindex fingering
@cindex finger change
Fingering instructions can be entered using
@var{note}-@var{digit}:
-
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
c4-1 d-2 f-4 e-3
@end lilypond
-Use markup texts for finger changes.
+Markup texts may be used for finger changes.
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
@snippets
-@code{fingeringOrientations} are used to control where the fingering
-numbers are placed.
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{controlling-the-placement-of-chord-fingerings.ly}
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\set fingeringOrientations = #'(left)
-<c-1 e-3 a-5 > 4
-\set fingeringOrientations = #'(down)
-<c-1 e-3 a-5 >
-\set fingeringOrientations = #'(right)
-<c-1 e-3 a-5 >
-\set fingeringOrientations = #'(up)
-<c-1 e-3 a-5 >
-\set fingeringOrientations = #'(left down)
-<c-1 e-3 a-5 > 2
-\set fingeringOrientations = #'(up right down)
-<c-1 e-3 a-5 >
-@end lilypond
@seealso
+
+Notation Reference:
@ref{Controlling direction and placement}
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
-Internals Reference: @internalsref{Fingering}.
+Internals Reference:
+@internalsref{Fingering}.
@node Hidden notes
-@subsubsection Hidden notes
+@unnumberedsubsubsec Hidden notes
@cindex Hidden notes
@cindex Invisible notes
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
@node Coloring objects
-@subsubsection Coloring objects
+@unnumberedsubsubsec Coloring objects
@cindex colored objects
@cindex colors
@seealso
-Notation Reference: @ref{List of colors}, @ref{Objects connected to
+Notation Reference:
+@ref{List of colors}, @ref{Objects connected to
the input}.
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
@knownissues
An x11 color is not necessarily exactly the same shade as a
@node Parentheses
-@subsubsection Parentheses
+@unnumberedsubsubsec Parentheses
@cindex ghost notes
@cindex notes, ghost
parenthesize a single note it must be enclosed with @code{<>} as
if it is a chord.
+FIXME: after 2.11.44 is out,
+@c \parenthesize c4-. \parenthesize r4 \parenthesize <c e g>4->
+
@lilypond[quote,relative=2,fragment,verbatim,ragged-right]
c2 < \parenthesize d>
@end lilypond
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
+
+@knownissues
+
+Rests cannot be parenthesized.
@node Stems
-@subsubsection Stems
+@unnumberedsubsubsec Stems
@cindex stem
@cindex stem, down
@cindex stem, neutral
-To change the direction of stems on the center line of the staff, use
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
@seealso
+Notation Reference:
@ref{Controlling direction and placement}.
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
@node Outside the staff
@end menu
@node Balloon help
-@subsubsection Balloon help
+@unnumberedsubsubsec 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
\new Voice \with { \consists "Balloon_engraver" }
{
\balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
- a4
+ a8
+ \balloonGrobText #'Rest #' (-4 . -4) \markup { "I'm a rest" }
+ r
<c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
}
@end lilypond
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
-Internals Reference: @internalsref{text-balloon-interface}.
+Internals Reference:
+@internalsref{text-balloon-interface}.
@node Grid lines
-@subsubsection Grid lines
+@unnumberedsubsubsec Grid lines
Vertical lines can be drawn between staves synchronized with the
notes.
\layout {
\context {
\Staff
- \consists "Grid_point_engraver"
% sets up grids
- gridInterval = #(ly:make-moment 1 4)
+ \consists "Grid_point_engraver"
% this sets the grid interval to 1 quarternote (crotchet)
- }
+ gridInterval = #(ly:make-moment 1 4)
+ }
}
\new Score \with {
- \consists "Grid_line_span_engraver"
- %% by default this centers grid lines horizontally below and to the
+ % by default this centers grid lines horizontally below and to the
% left side of the notehead, the grid lines extend from
% the middle lines of each staff
-}
+ \consists "Grid_line_span_engraver"
+ }
\new ChoirStaff <<
\new Staff {
@snippets
-To change the grid lines use \override.
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{grid-lines-changing-their-appearance.ly}
-@lilypond[quote,verbatim,ragged-right]
-\layout {
- \context {
- \Staff
- \consists "Grid_point_engraver"
- % sets up grids
- gridInterval = #(ly:make-moment 1 4)
- % this sets the grid interval to 1 quarternote (crotchet)
- }
-}
-
-\new Score \with {
- \consists "Grid_line_span_engraver"
- \override NoteColumn #'X-offset = #-0.5
- % this moves them to the right half a staff space
-}
-
-\new ChoirStaff <<
- \new Staff {
- \relative c'' {
- \stemUp
- c'4. d8 e8 f g4
- }
- }
- \new Staff {
- \relative c {
- \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
- % this moves them up one staff space from the default position
- \stemDown
- \clef bass
- \once \override Score.GridLine #'thickness = #5.0
- c4
- \once \override Score.GridLine #'thickness = #1.0
- g'
- \once \override Score.GridLine #'thickness = #3.0
- f
- \once \override Score.GridLine #'thickness = #5.0
- e
- }
- }
->>
-@end lilypond
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
@node Analysis brackets
-@subsubsection Analysis brackets
+@unnumberedsubsubsec Analysis brackets
@cindex brackets
@cindex phrasing brackets
@seealso
-Snippets: @lsrdir{Editorial,Editorial-annotations}.
+Snippets:
+@lsrdir{Editorial,Editorial-annotations}.
-Internals Reference: @internalsref{HorizontalBracket},
-@internalsref{Horizontal_bracket_engraver}, @internalsref{Staff}.
+Internals Reference:
+@internalsref{HorizontalBracket},
+@internalsref{Horizontal_bracket_engraver},
+@internalsref{Staff}.