version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Editorial annotations
@section Editorial annotations
@lilypondfile[quote]{editorial-headword.ly}
-This section discusses the various ways to change the appearance of
+This section discusses the various ways to change the appearance of
notes and add analysis or educational emphasis.
@menu
-* Inside the staff::
-* Outside the staff::
+* Inside the staff::
+* Outside the staff::
@end menu
@node Inside the staff
@subsection Inside the staff
-This section discusses how to add emphasis to elements that are
+This section discusses how to add emphasis to elements that are
inside the staff.
@menu
-* Selecting notation font size::
-* Fingering instructions::
-* Hidden notes::
-* Coloring objects::
-* Parentheses::
-* Stems::
+* Selecting notation font size::
+* Fingering instructions::
+* Hidden notes::
+* Coloring objects::
+* Parentheses::
+* Stems::
@end menu
@node Selecting notation font size
@unnumberedsubsubsec Selecting notation font size
+@cindex font size (notation) scaling
@cindex font size (notation)
@cindex selecting font size (notation)
+@cindex notation font size
+@cindex note heads
+@funindex fontSize
+@funindex font-size
+@funindex magstep
+@funindex \huge
+@funindex \large
+@funindex \normalsize
+@funindex \small
+@funindex \tiny
+@funindex \teeny
+@funindex huge
+@funindex large
+@funindex normalsize
+@funindex small
+@funindex tiny
+@funindex teeny
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 font sizes of text, see
-@ref{Common markup commands}.}
+@ref{Selecting font and font size}.}
@lilypond[verbatim,quote,relative=2]
\huge
c4.-> d8---3
@end lilypond
-@cindex font size (notation) scaling
-
Internally, this sets the @code{fontSize} property. This in turn
causes the @code{font-size} property to be set in all layout
objects. The value of @code{font-size} is a number indicating the
@cindex standard font size (notation)
@cindex font size (notation), standard
+@funindex font-interface
+@funindex font-size
Font size changes are achieved by scaling the design size that is
closest to the desired size. The standard font size (for
that use fonts. These are the ones supporting the
@code{font-interface} layout interface.
-@predefined
+@predefined
@funindex \teeny
@code{\teeny},
@funindex \tiny
@code{\large},
@funindex \huge
@code{\huge}.
+@endpredefined
-@seealso
+@seealso
Snippets:
@rlsr{Editorial annotations}.
Internals Reference:
-@rinternals{fontSize},
-@rinternals{font-size},
@rinternals{font-interface}.
@cindex fingering
@cindex finger change
+@funindex \finger
+@funindex finger
Fingering instructions can be entered using
@var{note}-@var{digit}:
c4-1 d-2 f-4 e-3
@end lilypond
-Markup texts may be used for finger changes.
+Markup texts may be used for finger changes.
@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
@end lilypond
@cindex thumb-script
+@funindex \thumb
+@funindex thumb
A thumb-script can be added (e.g., in cello music) to indicate
-that a note should be played with the thumb.
+that a note should be played with the thumb.
@lilypond[verbatim,quote,relative=2]
<a_\thumb a'-3>2 <b_\thumb b'-3>
@end lilypond
@cindex fingering chords
+@cindex fingering instructions for chords
@cindex chords, fingering
Fingerings for chords can also be added to individual notes of the
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{avoiding-collisions-of-chord-fingering-with-beams.ly}
-@seealso
+@seealso
Notation Reference:
@ref{Direction and placement}
@cindex hidden notes
@cindex invisible notes
@cindex transparent notes
+@cindex notes, hidden
+@cindex notes, invisible
+@cindex notes, transparent
@funindex \hideNotes
+@funindex hideNotes
@funindex \unHideNotes
+@funindex unHideNotes
Hidden (or invisible or transparent) notes can be useful in
preparing theory or composition exercises.
e4 f
\unHideNotes
g a
-\hideNotes
+\hideNotes
b
\unHideNotes
c
@predefined
+@code{\hideNotes},
+@code{\unHideNotes}.
+@endpredefined
-@funindex \hideNotes
-@funindex \unHideNotes
-@code{\hideNotes}, @code{\unHideNotes}
@seealso
-
Snippets:
@rlsr{Editorial annotations}.
@cindex colored notes
@cindex coloring notes
@cindex notes, colored
+@cindex x11 color
+@cindex x11-color
+@cindex with-color
+@funindex color
+@funindex \with-color
+@funindex with-color
+@funindex x11-color
Individual objects may be assigned colors. Valid color names
are listed in the @ref{List of colors}.
e
@end lilypond
-@cindex x11-color
The full range of colors defined for X11 can be accessed by using
the Scheme function @code{x11-color}. The function takes one
possible to access X11 colors by the multi-word form of its name.
If @code{x11-color} cannot make sense of the parameter then the
-color returned defaults to black.
+color returned defaults to black.
@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
b2 cis
@end lilypond
+@cindex rgb-color
+@cindex color, rgb
+@cindex rgb color
+@funindex rgb-color
+
Exact RGB colors can be specified using the Scheme function
@code{rgb-color}.
\set Staff.instrumentName = \markup {
\with-color #(x11-color 'navy) "Clarinet"
}
-
+
\override Stem #'color = #(rgb-color 0 0 0)
gis8 a
\override Stem #'color = #(rgb-color 1 1 1)
gis8 a
-\override Stem #'color = #(rgb-color 0 0 0.5)
+\override Stem #'color = #(rgb-color 0 0 0.5)
gis4 a
@end lilypond
-@seealso
+@seealso
Notation Reference:
-@ref{List of colors}, @ref{Objects connected to
-the input}.
+@ref{List of colors}, @ref{The
+tweak command}.
Snippets:
@rlsr{Editorial annotations}.
+
+@cindex x11 color
+@cindex colored notes in chords
+@cindex notes, colored in chords
+@cindex color in chords
+@funindex x11-color
+
@knownissues
An X11 color is not necessarily exactly the same shade as a
-similarly named normal color.
+similarly named normal color.
Not all X11 colors are distinguishable in a web browser, i.e.,
a web browser might not display a difference between @code{'LimeGreen}
Notes in a chord cannot be colored with @code{\override}; use
-@code{\tweak} instead, see @ref{Objects connected to the input}.
+@code{\tweak} instead, see @ref{The tweak command}.
@node Parentheses
@cindex notes, ghost
@cindex notes, parenthesized
@cindex parentheses
+@funindex \parenthesize
+@funindex parenthesize
Objects may be parenthesized by prefixing @code{\parenthesize} to
the music event. When prefixed to a chord, it parenthesizes every
c2 \parenthesize r
@end lilypond
-@seealso
+@seealso
Snippets:
@rlsr{Editorial annotations}.
@rinternals{ParenthesesItem},
@rinternals{parentheses-interface}.
+
@knownissues
Parenthesizing a chord prints parentheses around each individual
@unnumberedsubsubsec Stems
@cindex stem
+@cindex stem, invisible
+@cindex invisible stem
Whenever a note is found, a @code{Stem} object is created
automatically. For whole notes and rests, they are also created but
made invisible.
-@predefined
+@predefined
@funindex \stemUp
@code{\stemUp},
@funindex \stemDown
@code{\stemDown},
@funindex \stemNeutral
@code{\stemNeutral}.
+@endpredefined
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
+
@seealso
Notation Reference:
@ref{Direction and placement}.
@node Outside the staff
@subsection Outside the staff
-This section discusses how to add emphasis to elements in the staff
-from outside of the staff.
+This section discusses how to add emphasis to elements in the staff
+from outside of the staff.
@menu
-* Balloon help::
-* Grid lines::
-* Analysis brackets::
+* Balloon help::
+* Grid lines::
+* Analysis brackets::
@end menu
@node Balloon help
@unnumberedsubsubsec Balloon help
+@cindex balloon
+@cindex notation, explaining
+@cindex balloon help
+@cindex help, balloon
+@funindex \balloonGrobText
+@funindex \balloonText
+@funindex Balloon_engraver
+@funindex balloonGrobText
+@funindex balloonText
+
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
+ a8
\balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
r
- <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
+ <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
}
@end lilypond
-@cindex balloon
-@cindex notation, explaining
There are two music functions, @code{balloonGrobText} and
@code{balloonText}; the former is used like
{
\balloonLengthOff
\balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
- a8
+ 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.
+ <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
}
@end lilypond
@predefined
-
@funindex balloonLengthOn
+@funindex \balloonLengthOn
+@code{\balloonLengthOn},
+@funindex \balloonLengthOff
@funindex balloonLengthOff
-@code{\balloonLengthOn}, @code{\balloonLengthOff}
+@code{\balloonLengthOff}.
+@endpredefined
-@seealso
+@seealso
Snippets:
@rlsr{Editorial annotations}.
@node Grid lines
@unnumberedsubsubsec Grid lines
+@cindex grid lines
+@cindex lines, grid
+@cindex vertical lines between staves
+@cindex lines, vertical between staves
+@funindex Grid_point_engraver
+@funindex Grid_line_span_engraver
+@funindex gridInterval
+
Vertical lines can be drawn between staves synchronized with the
notes.
\layout {
\context {
\Staff
- \consists "Grid_point_engraver"
+ \consists "Grid_point_engraver"
gridInterval = #(ly:make-moment 1 4)
}
\context {
@seealso
-
Snippets:
@rlsr{Editorial annotations}.
@unnumberedsubsubsec Analysis brackets
@cindex brackets
-@cindex phrasing brackets
+@cindex bracket, phrasing
+@cindex phrasing bracket
@cindex musicological analysis
@cindex note grouping bracket
+@cindex horizontal bracket
+@cindex bracket, horizontal
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
Brackets are used in musical analysis to indicate structure in musical
pieces. Simple horizontal brackets are supported.
}
@end lilypond
-@seealso
+@seealso
Snippets:
@rlsr{Editorial annotations}.