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.
10 @section Educational use
20 @subsection Note heads
23 * Easy notation note heads::
29 @node Easy notation note heads
30 @unnumberedsubsubsec Easy notation note heads
32 @cindex note heads, practice
33 @cindex note heads, easy notation
37 The @q{easy play} note head includes a note name inside the head.
38 It is used in music for beginners
40 @lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
45 The command @code{\setEasyHeads} overrides settings for the
46 @internalsref{NoteHead} object. To make the letters readable, it
47 has to be printed in a large font size. To print with a larger
48 font, see @ref{Setting the staff size}.
52 @funindex \setEasyHeads
56 @node Shape note heads
57 @unnumberedsubsubsec Shape note heads
59 @cindex note heads, shape
61 In shape note head notation, the shape of the note head
62 corresponds to the harmonic function of a note in the scale. This
63 notation was popular in the 19th century American song books.
65 Shape note heads can be produced by setting @code{\aikenHeads} or
66 @code{\sacredHarpHeads}, depending on the style desired.
68 @lilypond[verbatim,relative=1,fragment]
75 Shapes are determined on the step in the scale, where the base of
76 the scale is determined by the @code{\key} command
79 @funindex shapeNoteStyles
81 @funindex \sacredHarpHeads
83 Shape note heads are implemented through the
84 @code{shapeNoteStyles} property. Its value is a vector of
85 symbols. The k-th element indicates the style to use for the k-th
86 step of the scale. Arbitrary combinations are possible, e.g.
88 @lilypond[verbatim,relative=1,fragment]
89 \set shapeNoteStyles =
90 ##(cross triangle fa #f mensural xcircle diamond)
96 @unnumberedsubsubsec Improvisation
98 Improvisation is sometimes denoted with slashed note heads. Such
99 note heads can be created by adding a
100 @internalsref{Pitch_squash_engraver} to the @internalsref{Voice}
101 context. Then, the following command
104 \set squashedPosition = #0
105 \override NoteHead #'style = #'slash
109 switches on the slashes.
111 There are shortcuts @code{\improvisationOn} (and an accompanying
112 @code{\improvisationOff}) for this command sequence. They are
113 used in the following example
115 @lilypond[verbatim,ragged-right,quote]
117 \consists Pitch_squash_engraver
119 e8 e g a a16(bes)(a8) g \improvisationOn
122 ~fis2 \improvisationOff a16(bes) a8 g e
127 @node Special noteheads
128 @unnumberedsubsubsec Special noteheads
130 @cindex note heads, special
132 Different noteheads are used by various instruments for various
133 meanings -- crosses are used for @q{parlato} with vocalists,
134 stopped notes on guitar; diamonds are used for harmonics on string
135 instruments, etc. There is a shorthand (@code{\harmonic}) for
136 diamond shapes; the other notehead styles are produced by tweaking
139 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
141 \override NoteHead #'style = #'cross
143 \revert NoteHead #'style
144 e d <c f\harmonic> <d a'\harmonic>
148 To see all notehead styles, please see @ref{Note head styles}.
153 Program reference: @internalsref{NoteHead}.
157 @node Inside the staff
158 @subsection Inside the staff
162 * Selecting notation font size::
163 * Fingering instructions::
171 @node Selecting notation font size
172 @unnumberedsubsubsec Selecting notation font size
174 The easiest method of setting the font size of any context is by
175 setting the @code{fontSize} property.
177 @lilypond[quote,fragment,relative=1,verbatim]
186 It does not change the size of variable symbols, such as beams or
189 Internally, the @code{fontSize} context property will cause the
190 @code{font-size} property to be set in all layout objects. The
191 value of @code{font-size} is a number indicating the size relative
192 to the standard size for the current staff height. Each step up
193 is an increase of approximately 12% of the font size. Six steps
194 is exactly a factor two. The Scheme function @code{magstep}
195 converts a @code{font-size} number to a scaling factor. The
196 @code{font-size} property can also be set directly, so that only
197 certain layout objects are affected.
199 @lilypond[quote,fragment,relative=1,verbatim]
201 \override NoteHead #'font-size = #-4
203 \override NoteHead #'font-size = #3
207 Font size changes are achieved by scaling the design size that is
208 closest to the desired size. The standard font size (for
209 @code{font-size} equals 0), depends on the standard staff height.
210 For a 20pt staff, a 10pt font is selected.
212 The @code{font-size} property can only be set on layout objects
213 that use fonts. These are the ones supporting the
214 @internalsref{font-interface} layout interface.
218 The following commands set @code{fontSize} for the current voice:
224 @funindex \normalsize
228 @node Fingering instructions
229 @unnumberedsubsubsec Fingering instructions
232 @cindex finger change
234 Fingering instructions can be entered using
237 @var{note}-@var{digit}
240 For finger changes, use markup texts
242 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
244 c^\markup { \finger "2 - 3" }
247 You can use the thumb-script to indicate that a note should be
248 played with the thumb (e.g., in cello music)
250 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
251 <a_\thumb a'-3>8 <b_\thumb b'-3>
254 Fingerings for chords can also be added to individual notes of the
255 chord by adding them after the pitches
257 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
264 You may exercise greater control over fingering chords by setting
265 @code{fingeringOrientations}
267 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
268 \set fingeringOrientations = #'(left down)
269 <c-1 es-2 g-4 bes-5 > 4
270 \set fingeringOrientations = #'(up right down)
271 <c-1 es-2 g-4 bes-5 > 4
274 Using this feature, it is also possible to put fingering
275 instructions very close to note heads in monophonic music,
277 @lilypond[verbatim,ragged-right,quote,fragment]
278 \set fingeringOrientations = #'(right)
285 Program reference: @internalsref{Fingering}.
287 Examples: @lsr{expressive,fingering-chords.ly}
292 @unnumberedsubsubsec Hidden notes
295 @cindex Invisible notes
296 @cindex Transparent notes
299 @funindex \unHideNotes
301 Hidden (or invisible or transparent) notes can be useful in
302 preparing theory or composition exercises.
304 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
313 @node Coloring objects
314 @unnumberedsubsubsec Coloring objects
316 Individual objects may be assigned colors. You may use the color
317 names listed in the @ref{List of colors}.
319 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
320 \override NoteHead #'color = #red
322 \override NoteHead #'color = #(x11-color 'LimeGreen)
324 \override Stem #'color = #blue
328 The full range of colors defined for X11 can be accessed by using
329 the Scheme function x11-color. The function takes one argument
333 \override Beam #'color = #(x11-color 'MediumTurquoise)
339 \override Beam #'color = #(x11-color "MediumTurquoise")
342 The first form is quicker to write and is more efficient.
343 However, using the second form it is possible to access X11 colors
344 by the multi-word form of its name
347 \override Beam #'color = #(x11-color "medium turquoise")
350 If x11-color cannot make sense of the parameter then the color
351 returned defaults to black. It should be obvious from the final
352 score that something is wrong.
354 This example illustrates the use of x11-color. Notice that the
355 stem color remains black after being set to (x11-color 'Boggle),
356 which is deliberate nonsense.
358 @lilypond[quote,ragged-right,verbatim]
360 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
361 \set Staff.instrumentName = \markup {
362 \with-color #(x11-color 'navy) "Clarinet"
366 \override Beam #'color = #(x11-color "medium turquoise")
368 \override NoteHead #'color = #(x11-color "LimeGreen")
370 \override Stem #'color = #(x11-color 'Boggle)
378 Appendix: @ref{List of colors}.
382 Not all x11 colors are distinguishable in a web browser. For web
383 use normal colors are recommended.
385 An x11 color is not necessarily exactly the same shade as a
386 similarly named normal color.
388 Notes in a chord cannot be colored with @code{\override}; use
389 @code{\tweak} instead. See @ref{Objects connected to the input},
394 @unnumberedsubsubsec Parentheses
398 @cindex notes, parenthesized
400 Objects may be parenthesized by prefixing @code{\parenthesize} to
403 @lilypond[relative=2,fragment,verbatim,ragged-right]
411 This only functions inside chords, even for single notes
414 < \parenthesize NOTE>
419 @unnumberedsubsubsec Ambitus
422 The term @emph{ambitus} denotes a range of pitches for a given
423 voice in a part of music. It may also denote the pitch range that
424 a musical instrument is capable of playing. Ambits are printed on
425 vocal parts, so performers can easily determine it meets their
428 Ambits are denoted at the beginning of a piece near the initial
429 clef. The range is graphically specified by two note heads that
430 represent the minimum and maximum pitch. To print such ambits,
431 add the @internalsref{Ambitus_engraver} to the
432 @internalsref{Voice} context, for example,
438 \consists Ambitus_engraver
443 This results in the following output
445 @lilypond[quote,ragged-right]
449 \consists Ambitus_engraver
453 \relative \new Staff {
458 If you have multiple voices in a single staff and you want a
459 single ambitus per staff rather than per each voice, add the
460 @internalsref{Ambitus_engraver} to the @internalsref{Staff}
461 context rather than to the @internalsref{Voice} context. Here is
464 @lilypond[verbatim,ragged-right,quote]
466 \consists "Ambitus_engraver"
470 \remove "Ambitus_engraver"
472 \override Ambitus #'X-offset = #-1.0
477 \remove "Ambitus_engraver"
486 This example uses one advanced feature,
489 \override Ambitus #'X-offset = #-1.0
493 This code moves the ambitus to the left. The same effect could
494 have been achieved with @code{extra-offset}, but then the
495 formatting system would not reserve space for the moved object.
499 Program reference: @internalsref{Ambitus},
500 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
501 @internalsref{AmbitusAccidental}.
504 @lsr{vocal,ambitus@/.ly}.
508 There is no collision handling in the case of multiple per-voice
513 @unnumberedsubsubsec Stems
515 Whenever a note is found, a @internalsref{Stem} object is created
516 automatically. For whole notes and rests, they are also created
525 @funindex \stemNeutral
531 To change the direction of stems in the middle of the staff, use
533 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
535 \override Stem #'neutral-direction = #up
537 \override Stem #'neutral-direction = #down
542 @node Outside the staff
543 @subsection Outside the staff
549 * Blank music sheet::
553 @unnumberedsubsubsec Balloon help
555 Elements of notation can be marked and named with the help of a
556 square balloon. The primary purpose of this feature is to explain
559 The following example demonstrates its use.
561 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
562 \new Voice \with { \consists "Balloon_engraver" }
564 \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
565 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
570 There are two music functions, @code{balloonText} and
571 @code{balloonGrobText}. The latter takes the name of the grob to
572 adorn, while the former may be used as an articulation on a note.
573 The other arguments are the offset and the text of the label.
576 @cindex notation, explaining
580 Program reference: @internalsref{text-balloon-interface}.
584 @unnumberedsubsubsec Grid lines
586 Vertical lines can be drawn between staves synchronized with the
589 @lilypond[ragged-right,quote,verbatim]
593 \consists "Grid_point_engraver" %% sets of grid
594 gridInterval = #(ly:make-moment 1 4)
599 \consists "Grid_line_span_engraver"
600 %% centers grid lines horizontally below noteheads
601 \override NoteColumn #'X-offset = #-0.5
612 %% centers grid lines vertically
613 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
623 Examples: @lsrdir{education}
626 @node Blank music sheet
627 @unnumberedsubsubsec Blank music sheet
629 @cindex Sheet music, empty
630 @cindex Staves, blank sheet
632 A blank music sheet can be produced also by using invisible notes,
633 and removing @code{Bar_number_engraver}.
636 @lilypond[quote,verbatim]
637 \layout{ indent = #0 }
639 \repeat unfold 2 % Change this for more lines.
644 \override TimeSignature #'transparent = ##t
645 % un-comment this line if desired
646 % \override Clef #'transparent = ##t
648 \remove Bar_number_engraver
651 % modify these to get the staves you want
652 \new Staff \emptymusic
653 \new TabStaff \emptymusic