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. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @node Wind instruments
13 @section Wind instruments
15 @lilypondfile[quote]{wind-headword.ly}
17 This section includes elements of music notation that arise when
18 writing specifically for wind instruments.
21 * Common notation for wind instruments::
26 @node Common notation for wind instruments
27 @subsection Common notation for wind instruments
29 This section discusses notation common to most wind instruments.
32 * References for wind instruments::
36 @node References for wind instruments
37 @unnumberedsubsubsec References for wind instruments
39 @cindex wind instruments
41 Many notation issues for wind instruments pertain to breathing and
45 @item Breathing can be specified by rests or @ref{Breath marks}.
46 @item Legato playing is indicated by @ref{Slurs}.
47 @item Different types of tonguings, ranging from legato to non-legato to
48 staccato are usually shown by articulation marks, sometimes combined
49 with slurs, see @ref{Articulations and ornamentations} and
50 @ref{List of articulations}.
51 @item Flutter tonguing is usually indicated by placing a tremolo mark
52 and a text markup on the note. See @ref{Tremolo repeats}.
55 Other aspects of musical notation that can apply to wind instruments:
58 @item Many wind instruments are transposing instruments, see
59 @ref{Instrument transpositions}.
60 @item The slide glissando are characteristic of the trombone, but other
61 winds may perform keyed or valved glissandi. See @ref{Glissando}.
62 @item Harmonic series glissandi, which are possible on all brass
63 instruments but common for French Horns, are usually written out as
65 @item Pitch inflections at the end of a note are discussed in
66 @ref{Falls and doits}.
67 @item Key slaps or valve slaps are often shown by the @code{cross} style
68 of @ref{Special note heads}.
69 @item Woodwinds can overblow low notes to sound harmonics. These are
70 shown by the @code{flageolet} articulation.
71 See @ref{List of articulations}.
72 @item The use of brass mutes is usually indicated by a text markup, but
73 where there are many rapid changes it is better to use the
74 @code{stopped} and @code{open} articulations.
75 See @ref{Articulations and ornamentations} and
76 @ref{List of articulations}.
77 @item Stopped horns are indicated by the @code{stopped} articulation.
78 See @ref{Articulations and ornamentations}.
83 @lilypondfile[verbatim,quote,texidoc,doctitle]
84 {changing--flageolet-mark-size.ly}
90 @ref{Articulations and ornamentations},
91 @ref{List of articulations},
92 @ref{Tremolo repeats},
93 @ref{Instrument transpositions},
96 @ref{Falls and doits},
97 @ref{Special note heads},
104 @unnumberedsubsubsec Fingerings
106 All wind instruments other than the trombone require the use of several
107 fingers to produce each pitch. Some fingering examples are shown in
110 Woodwind diagrams can be produced and are described in
111 @ref{Woodwind diagrams}.
115 @lilypondfile[verbatim,quote,texidoc,doctitle]
116 {fingering-symbols-for-wind-instruments.ly}
118 @lilypondfile[verbatim,quote,texidoc,doctitle]
119 {recorder-fingering-chart.ly}
123 @ref{Woodwind diagrams}.
132 This section discusses notation common bagpipes.
135 * Bagpipe definitions::
139 @node Bagpipe definitions
140 @unnumberedsubsubsec Bagpipe definitions
143 @cindex Scottish highland bagpipe
147 @funindex \hideKeySignature
148 @funindex hideKeySignature
149 @funindex \showKeySignature
150 @funindex showKeySignature
152 LilyPond contains special definitions for Scottish, Highland Bagpipe
153 music; to use them, add
156 \include "bagpipe.ly"
160 to the top of your input file. This lets you add the special grace notes
161 common to bagpipe music with short commands. For example, you could
162 write @code{\taor} instead of
165 \grace @{ \small G32[ d G e] @}
168 @file{bagpipe.ly} also contains pitch definitions for the bagpipe
169 notes in the appropriate octaves, so you do not need to worry about
170 @code{\relative} or @code{\transpose}.
172 @lilypond[ragged-right,verbatim,quote,notime]
173 \include "bagpipe.ly"
174 { \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
177 Bagpipe music nominally uses the key of D Major (even though that
178 isn't really true). However, since that is the only key that can be used,
179 the key signature is normally not written out. To set this up correctly,
180 always start your music with @code{\hideKeySignature}. If you for some
181 reason want to show the key signature, you can use @code{\showKeySignature}
184 Some modern music use cross fingering on c and f to flatten those notes.
185 This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
186 piobaireachd high g can be written @code{gflat} when it occurs in light
194 @node Bagpipe example
195 @unnumberedsubsubsec Bagpipe example
197 @cindex bagpipe example
198 @cindex Amazing Grace bagpipe example
200 This is what the well known tune Amazing Grace looks like in bagpipe
203 @lilypond[verbatim,quote]
204 \include "bagpipe.ly"
207 \context { \Score \remove "Bar_number_engraver" }
211 title = "Amazing Grace"
213 arranger = "Trad. arr."
219 \grg \partial 4 a8. d16
220 \slurd d2 \grg f8[ e32 d16.]
224 \slurd d2 \grg f8[ e32 d16.]
228 \grg A2 \hdblf f8[ e32 d16.]
232 \slurd d2 \grg f8[ e32 d16.]
246 @subsection Woodwinds
248 This section discusses notation specifically for woodwind instruments.
251 * Woodwind diagrams::
254 @node Woodwind diagrams
255 @subsubsection Woodwind diagrams
257 Woodwind diagrams can be used to indicate the fingering to be used
258 for specific notes and are available for the following instruments:
272 Woodwind diagrams are created as markups:
275 @lilypond[verbatim,quote,relative=2]
277 \woodwind-diagram #'piccolo #'((lh . (gis))
283 Keys can be open, partially-covered, ring-depressed, or fully covered:
285 @lilypond[verbatim,quote,relative=2]
290 \woodwind-diagram #'flute #'((cc . (one1q))
299 \woodwind-diagram #'flute #'((cc . (one1h))
308 \woodwind-diagram #'flute #'((cc . (one3q))
317 \woodwind-diagram #'flute #'((cc . (oneR))
326 \woodwind-diagram #'flute #'((cc . (oneF two))
333 Trills are indicated as shaded keys:
335 @lilypond[verbatim,quote,relative=2]
337 \woodwind-diagram #'bass-clarinet
338 #'((cc . (threeT four))
344 A variety of trills can be displayed:
346 @lilypond[verbatim,quote,relative=2]
350 "one quarter to ring"
351 \woodwind-diagram #'flute #'((cc . (one1qTR))
360 \woodwind-diagram #'flute #'((cc . (oneTR))
369 \woodwind-diagram #'flute #'((cc . (oneRT))
378 \woodwind-diagram #'flute #'((cc . (oneT))
386 "one quarter to three quarters"
387 \woodwind-diagram #'flute #'((cc . (one1qT3q))
394 The list of all possible keys and settings for a given instrument
395 can be displayed on the console using
396 @code{#(print-keys-verbose 'flute)} or in the log file using
397 @code{#(print-keys-verbose 'flute (current-error-port))}, although
398 they will not show up in the music output.
400 New diagrams can be created by following the patterns in
401 @file{scm/define-woodwind-diagrams.scm} and
402 @file{scm/display-woodwind-diagrams.scm}. However, this will
403 require Scheme ability and may not be accessible to all users.
409 @lilypondfile[verbatim,quote,texidoc,doctitle]
410 {woodwind-diagrams-listing.ly}
412 @lilypondfile[verbatim,quote,texidoc,doctitle]
413 {graphical-and-text-woodwind-diagrams.ly}
415 @lilypondfile[verbatim,quote,texidoc,doctitle]
416 {changing-the-size-of-woodwind-diagrams.ly}
418 @lilypondfile[verbatim,quote,texidoc,doctitle]
419 {woodwind-diagrams-key-lists.ly}
423 @file{scm/define-woodwind-diagrams.scm},
424 @file{scm/display-woodwind-diagrams.scm}.
430 @rinternals{TextScript},
431 @rinternals{instrument-specific-markup-interface}.