1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
11 @node Editorial annotations
12 @section Editorial annotations
14 @lilypondfile[quote]{editorial-headword.ly}
16 This section discusses the various ways to change the appearance of
17 notes and add analysis or educational emphasis.
25 @node Inside the staff
26 @subsection Inside the staff
28 This section discusses how to add emphasis to elements that are
32 * Selecting notation font size::
33 * Fingering instructions::
40 @node Selecting notation font size
41 @unnumberedsubsubsec Selecting notation font size
43 @cindex font size (notation)
44 @cindex selecting font size (notation)
46 The font size of notation elements may be altered. It does not
47 change the size of variable symbols, such as beams or slurs.
49 @warning{For @strong{text} font sizes, see
50 @ref{Common markup commands}.}
52 @lilypond[quote,fragment,relative=2,verbatim,ragged-right]
67 @cindex font size (notation) scaling
69 Internally, this sets the @code{fontSize} property. This in turn
70 causes the @code{font-size} property to be set in all layout
71 objects. The value of @code{font-size} is a number indicating the
72 size relative to the standard size for the current staff height.
73 Each step up is an increase of approximately 12% of the font size.
74 Six steps is exactly a factor of two. The Scheme function
75 @code{magstep} converts a @code{font-size} number to a scaling
76 factor. The @code{font-size} property can also be set directly,
77 so that only certain layout objects are affected.
79 @lilypond[quote,fragment,relative=2,verbatim,ragged-right]
82 \override NoteHead #'font-size = #-4
84 \override Script #'font-size = #2
86 \override Stem #'font-size = #-5
90 @cindex standard font size (notation)
91 @cindex font size (notation), standard
93 Font size changes are achieved by scaling the design size that is
94 closest to the desired size. The standard font size (for
95 @code{font-size = #0}), depends on the standard staff height.
96 For a 20pt staff, a 10pt font is selected.
98 The @code{font-size} property can only be set on layout objects
99 that use fonts. These are the ones supporting the
100 @code{font-interface} layout interface.
110 @funindex \normalsize
120 @lsrdir{Editorial,Editorial-annotations}.
123 @internalsref{fontSize},
124 @internalsref{font-size},
125 @internalsref{font-interface}.
128 @node Fingering instructions
129 @unnumberedsubsubsec Fingering instructions
132 @cindex finger change
134 Fingering instructions can be entered using
135 @var{note}-@var{digit}:
137 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
141 Markup texts may be used for finger changes.
143 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
144 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
149 You can use the thumb-script (e.g., in cello music) to indicate that a
150 note should be played with the thumb.
152 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
153 <a_\thumb a'-3>2 <b_\thumb b'-3>
156 @cindex fingering chords
157 @cindex chords, fingering
159 Fingerings for chords can also be added to individual notes of the
160 chord by adding them after the pitches.
162 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
163 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
166 Fingering instructions may be manually placed above or below the
167 staff, see @ref{Controlling direction and placement}.
171 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
172 {controlling-the-placement-of-chord-fingerings.ly}
178 @ref{Controlling direction and placement}
181 @lsrdir{Editorial,Editorial-annotations}.
184 @internalsref{FingeringEvent},
185 @internalsref{fingering-event},
186 @internalsref{Fingering_engraver},
187 @internalsref{New_fingering_engraver},
188 @internalsref{Fingering}.
192 @unnumberedsubsubsec Hidden notes
195 @cindex invisible notes
196 @cindex transparent notes
198 @funindex \unHideNotes
200 Hidden (or invisible or transparent) notes can be useful in
201 preparing theory or composition exercises.
203 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
217 @code{\hideNotes}, @code{\unHideNotes}
222 @lsrdir{Editorial,Editorial-annotations}.
225 @internalsref{Note_spacing_engraver},
226 @internalsref{NoteSpacing}.
229 @node Coloring objects
230 @unnumberedsubsubsec Coloring objects
232 @cindex colored objects
234 @cindex coloring objects
235 @cindex colored notes
236 @cindex coloring notes
237 @cindex notes, colored
239 Individual objects may be assigned colors. Valid color names
240 are listed in the @ref{List of colors}.
242 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
243 \override NoteHead #'color = #red
245 \override NoteHead #'color = #(x11-color 'LimeGreen)
247 \override Stem #'color = #blue
253 The full range of colors defined for X11 can be accessed by using
254 the Scheme function @code{x11-color}. The function takes one
255 argument; this can be a symbol in the form @var{'FooBar} or a
256 string in the form @var{"FooBar"}. The first form is quicker to
257 write and is more efficient. However, using the second form it is
258 possible to access X11 colors by the multi-word form of its name.
260 If @code{x11-color} cannot make sense of the parameter then the
261 color returned defaults to black.
263 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
264 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
265 \set Staff.instrumentName = \markup {
266 \with-color #(x11-color 'navy) "Clarinet"
270 \override Beam #'color = #(x11-color "medium turquoise")
272 \override Accidental #'color = #(x11-color 'DarkRed)
274 \override NoteHead #'color = #(x11-color "LimeGreen")
276 % this is deliberate nonsense; note that the stems remain black
277 \override Stem #'color = #(x11-color 'Boggle)
281 Exact RGB colors can be specified using the Scheme function
284 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
285 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
286 \set Staff.instrumentName = \markup {
287 \with-color #(x11-color 'navy) "Clarinet"
291 \override Stem #'color = #(rgb-color 0 0 0)
294 \override Stem #'color = #(rgb-color 1 1 1)
297 \override Stem #'color = #(rgb-color 0 0 0.5)
304 @ref{List of colors}, @ref{Objects connected to
308 @lsrdir{Editorial,Editorial-annotations}.
311 An X11 color is not necessarily exactly the same shade as a
312 similarly named normal color.
314 Not all X11 colors are distinguishable in a web browser, i.e.,
315 a web browser might not display a difference between @code{'LimeGreen}
316 and @code{'ForestGreen}. For web use normal colors are recommended
317 (i.e., @code{#blue}, @code{#green}, @code{#red}).
320 Notes in a chord cannot be colored with @code{\override}; use
321 @code{\tweak} instead, see @ref{Objects connected to the input}.
325 @unnumberedsubsubsec Parentheses
329 @cindex notes, parenthesized
332 Objects may be parenthesized by prefixing @code{\parenthesize} to
333 the music event. When applied to a chord, it parenthesizes every
336 @lilypond[quote,relative=2,fragment,verbatim,ragged-right]
338 c2 \parenthesize <c e g>
341 Non-note objects may be parenthesized as well.
343 @lilypond[quote,relative=2,fragment,verbatim,ragged-right]
344 c2-\parenthesize -. d
351 @lsrdir{Editorial,Editorial-annotations}.
354 @internalsref{Parenthesis_engraver},
355 @internalsref{ParenthesesItem},
356 @internalsref{parentheses-interface}.
360 @unnumberedsubsubsec Stems
364 Whenever a note is found, a @code{Stem} object is created
365 automatically. For whole notes and rests, they are also created but
374 @funindex \stemNeutral
380 @cindex stem, direction
383 @cindex stem, neutral
385 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
386 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
390 @ref{Controlling direction and placement}.
393 @lsrdir{Editorial,Editorial-annotations}.
396 @internalsref{Stem_engraver},
398 @internalsref{stem-interface}.
401 @node Outside the staff
402 @subsection Outside the staff
404 This section discusses how to add emphasis to elements in the staff
405 from outside of the staff.
410 * Analysis brackets::
414 @unnumberedsubsubsec Balloon help
416 Elements of notation can be marked and named with the help of a
417 square balloon. The primary purpose of this feature is to explain
420 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
421 \new Voice \with { \consists "Balloon_engraver" }
423 \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
425 \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
427 <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
431 There are two music functions, @code{balloonGrobText} and
432 @code{balloonText}; the former is used like @code{\once \override} to
433 attach text to any grob, and the latter is used like @code{\tweak},
434 typically within chords, to attach text to an individual note.
437 @cindex notation, explaining
442 @lsrdir{Editorial,Editorial-annotations}.
445 @internalsref{Balloon_engraver},
446 @internalsref{BalloonTextItem},
447 @internalsref{balloon-interface}.
451 @unnumberedsubsubsec Grid lines
453 Vertical lines can be drawn between staves synchronized with the
456 @lilypond[quote,verbatim,ragged-right]
461 \consists "Grid_point_engraver"
462 % set the grid interval to one quarter note
463 gridInterval = #(ly:make-moment 1 4)
467 % by default this centers grid lines horizontally below
468 % and to the left side of the note head, the grid lines
469 % extending from the middle lines of each staff
470 \consists "Grid_line_span_engraver"
476 \new Staff \relative c'' {
480 \new Staff \relative c {
491 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
492 {grid-lines-changing-their-appearance.ly}
498 @lsrdir{Editorial,Editorial-annotations}.
501 @internalsref{Grid_line_span_engraver},
502 @internalsref{Grid_point_engraver},
503 @internalsref{GridLine},
504 @internalsref{GridPoint},
505 @internalsref{grid-line-interface},
506 @internalsref{grid-point-interface}.
509 @node Analysis brackets
510 @unnumberedsubsubsec Analysis brackets
513 @cindex phrasing brackets
514 @cindex musicological analysis
515 @cindex note grouping bracket
517 Brackets are used in musical analysis to indicate structure in musical
518 pieces. Simple horizontal brackets are supported.
520 @lilypond[quote,verbatim,ragged-right]
524 \consists "Horizontal_bracket_engraver"
533 Analysis brackets may be nested.
535 @lilypond[quote,verbatim,ragged-right]
539 \consists "Horizontal_bracket_engraver"
543 c4\startGroup\startGroup
546 d4\stopGroup\stopGroup
553 @lsrdir{Editorial,Editorial-annotations}.
556 @internalsref{Horizontal_bracket_engraver},
557 @internalsref{HorizontalBracket},
558 @internalsref{horizontal-bracket-interface},
559 @internalsref{Staff}.