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,lilyquote,texidoc,doctitle]
84 {changing--flageolet-mark-size.ly}
91 @ref{Articulations and ornamentations},
92 @ref{List of articulations},
93 @ref{Tremolo repeats},
94 @ref{Instrument transpositions},
97 @ref{Falls and doits},
98 @ref{Special note heads},
105 @unnumberedsubsubsec Fingerings
107 All wind instruments other than the trombone require the use of several
108 fingers to produce each pitch. Some fingering examples are shown in
111 Woodwind diagrams can be produced and are described in
112 @ref{Woodwind diagrams}.
116 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
117 {fingering-symbols-for-wind-instruments.ly}
119 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
120 {recorder-fingering-chart.ly}
125 @ref{Woodwind diagrams}.
134 This section discusses notation common bagpipes.
137 * Bagpipe definitions::
141 @node Bagpipe definitions
142 @unnumberedsubsubsec Bagpipe definitions
145 @cindex Scottish highland bagpipe
149 @funindex \hideKeySignature
150 @funindex hideKeySignature
151 @funindex \showKeySignature
152 @funindex showKeySignature
154 LilyPond contains special definitions for Scottish, Highland Bagpipe
155 music; to use them, add
158 \include "bagpipe.ly"
162 to the top of your input file. This lets you add the special grace notes
163 common to bagpipe music with short commands. For example, you could
164 write @code{\taor} instead of
167 \grace @{ \small G32[ d G e] @}
170 @code{bagpipe.ly} also contains pitch definitions for the bagpipe
171 notes in the appropriate octaves, so you do not need to worry about
172 @code{\relative} or @code{\transpose}.
174 @lilypond[ragged-right,verbatim,quote,notime]
175 \include "bagpipe.ly"
176 { \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
179 Bagpipe music nominally uses the key of D Major (even though that
180 isn't really true). However, since that is the only key that can be used,
181 the key signature is normally not written out. To set this up correctly,
182 always start your music with @code{\hideKeySignature}. If you for some
183 reason want to show the key signature, you can use @code{\showKeySignature}
186 Some modern music use cross fingering on c and f to flatten those notes.
187 This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
188 piobaireachd high g can be written @code{gflat} when it occurs in light
196 @node Bagpipe example
197 @unnumberedsubsubsec Bagpipe example
199 @cindex bagpipe example
200 @cindex Amazing Grace bagpipe example
202 This is what the well known tune Amazing Grace looks like in bagpipe
205 @lilypond[verbatim,quote]
206 \include "bagpipe.ly"
209 \context { \Score \remove "Bar_number_engraver" }
213 title = "Amazing Grace"
215 arranger = "Trad. arr."
221 \grg \partial 4 a8. d16
222 \slurd d2 \grg f8[ e32 d16.]
226 \slurd d2 \grg f8[ e32 d16.]
230 \grg A2 \hdblf f8[ e32 d16.]
234 \slurd d2 \grg f8[ e32 d16.]
247 @subsection Woodwinds
249 This section discusses notation specifically for woodwind instruments.
252 * Woodwind diagrams::
255 @node Woodwind diagrams
256 @subsubsection Woodwind diagrams
258 Woodwind diagrams can be used to indicate the fingering to be used
259 for specific notes and are available for the following instruments:
273 Woodwind diagrams are created as markups:
276 @lilypond[verbatim,quote,relative=2]
278 \woodwind-diagram #'piccolo #'((lh . (gis))
284 Keys can be open, partially-covered, ring-depressed, or fully covered:
286 @lilypond[verbatim,quote,relative=2]
291 \woodwind-diagram #'flute #'((cc . (one1q))
300 \woodwind-diagram #'flute #'((cc . (one1h))
309 \woodwind-diagram #'flute #'((cc . (one3q))
318 \woodwind-diagram #'flute #'((cc . (oneR))
327 \woodwind-diagram #'flute #'((cc . (oneF two))
334 Trills are indicated as shaded keys:
336 @lilypond[verbatim,quote,relative=2]
338 \woodwind-diagram #'bass-clarinet
339 #'((cc . (threeT four))
345 A variety of trills can be displayed:
347 @lilypond[verbatim,quote,relative=2]
351 "one quarter to ring"
352 \woodwind-diagram #'flute #'((cc . (one1qTR))
361 \woodwind-diagram #'flute #'((cc . (oneTR))
370 \woodwind-diagram #'flute #'((cc . (oneRT))
379 \woodwind-diagram #'flute #'((cc . (oneT))
387 "one quarter to three quarters"
388 \woodwind-diagram #'flute #'((cc . (one1qT3q))
395 The list of all possible keys and settings for a given instrument
396 can be displayed on the console or in the log file, although they
397 will not show up in the music output:
399 @lilypond[verbatim,quote]
401 #(print-keys-verbose 'flute)
405 New diagrams can be created by following the patterns in
406 @file{scm/define-woodwind-diagrams.scm} and
407 @file{scm/display-woodwind-diagrams.scm}. However, this will
408 require Scheme ability and may not be accessible to all users.
414 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
415 {woodwind-diagrams-listing.ly}
417 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
418 {graphical-and-text-woodwind-diagrams.ly}
420 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
421 {changing-the-size-of-woodwind-diagrams.ly}
423 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
424 {woodwind-diagrams-key-lists.ly}
429 @file{scm/define-woodwind-diagrams.scm},
430 @file{scm/display-woodwind-diagrams.scm}.
432 Snippets: @rlsr{Winds}.
435 @rinternals{TextScript},
436 @rinternals{instrument-specific-markup-interface}.