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 some elements of music notation that arise when
21 * Common notation for wind instruments::
26 @node Common notation for wind instruments
27 @subsection Common notation for wind instruments
29 This section discusses some issues 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 @ref{List of
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 There are also other aspects of musical notation that can apply to wind
59 @item Many wind instruments are transposing instruments, see
60 @ref{Instrument transpositions}.
61 @item The slide glissando are characteristic of the trombone, but other
62 winds may perform keyed or valved glissandi. See @ref{Glissando}.
63 @item Harmonic series glissandi, which are possible on all brass
64 instruments but common for French Horns, are usually written out as
66 @item Pitch inflections at the end of a note are discussed in @ref{Falls
68 @item Key slaps or valve slaps are often shown by the @code{cross} style
69 of @ref{Special note heads}.
70 @item Woodwinds can overblow low notes to sound harmonics. These are
71 shown by the @code{flageolet} articulation. 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. See @ref{Articulations and
75 ornamentations} and @ref{List of articulations}.
76 @item Stopped horns are indicated by the @code{stopped} articulation.
77 See @ref{Articulations and ornamentations}.
82 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
83 {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.
111 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
112 {fingering-symbols-for-wind-instruments.ly}
114 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
115 {recorder-fingering-chart.ly}
126 This section includes extra information for writing for bagpipes.
129 * Bagpipe definitions::
133 @node Bagpipe definitions
134 @unnumberedsubsubsec Bagpipe definitions
137 @cindex Scottish highland bagpipe
141 @funindex \hideKeySignature
142 @funindex hideKeySignature
143 @funindex \showKeySignature
144 @funindex showKeySignature
146 LilyPond contains special definitions for music for the Scottish
147 highland bagpipe; to use them, add
150 \include "bagpipe.ly"
154 at the top of your input file. This lets you add the special grace notes
155 common to bagpipe music with short commands. For example, you could
156 write @code{\taor} instead of
159 \grace @{ \small G32[ d G e] @}
162 @code{bagpipe.ly} also contains pitch definitions for the bagpipe
163 notes in the appropriate octaves, so you do not need to worry about
164 @code{\relative} or @code{\transpose}.
166 @lilypond[ragged-right,verbatim,quote,notime]
167 \include "bagpipe.ly"
168 { \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
171 Bagpipe music nominally uses the key of D Major (even though that
172 isn't really true). However, since that is the only key that can be used,
173 the key signature is normally not written out. To set this up correctly,
174 always start your music with @code{\hideKeySignature}. If you for some
175 reason want to show the key signature, you can use @code{\showKeySignature}
178 Some modern music use cross fingering on c and f to flatten those notes.
179 This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
180 piobaireachd high g can be written @code{gflat} when it occurs in light
188 @node Bagpipe example
189 @unnumberedsubsubsec Bagpipe example
191 @cindex bagpipe example
192 @cindex Amazing Grace bagpipe example
194 This is what the well known tune Amazing Grace looks like in bagpipe
197 @lilypond[verbatim,quote]
198 \include "bagpipe.ly"
201 \context { \Score \remove "Bar_number_engraver" }
205 title = "Amazing Grace"
207 arranger = "Trad. arr."
213 \grg \partial 4 a8. d16
214 \slurd d2 \grg f8[ e32 d16.]
218 \slurd d2 \grg f8[ e32 d16.]
222 \grg A2 \hdblf f8[ e32 d16.]
226 \slurd d2 \grg f8[ e32 d16.]
239 @subsection Woodwinds
241 This section describes notation specifically for woodwinds.
244 * Woodwind diagrams::
247 @node Woodwind diagrams
248 @subsubsection Woodwind diagrams
250 Woodwind diagrams can be used to indicate the fingering to be used
251 to play specific notes. Woodwind diagrams are available for most woodwind
254 Woodwind diagrams are available for the following instruments:
268 The diagrams and the scheme instrument names are shown in the snippet below.
270 Woodwind diagrams are created as markups:
273 @lilypond[verbatim, quote, relative=2]
274 c1^ \markup \woodwind-diagram #'piccolo #'((lh . (gis))
279 Keys can be open, partially-covered, ring-depressed, or fully covered:
281 @lilypond [verbatim, quote, relative=2]
283 c1^ \markup \center-column {
285 \woodwind-diagram #'flute #'((cc . (one1q))
289 c1^ \markup \center-column {
291 \woodwind-diagram #'flute #'((cc . (one1h))
295 c1^ \markup \center-column {
297 \woodwind-diagram #'flute #'((cc . (one3q))
301 c1^ \markup \center-column {
303 \woodwind-diagram #'flute #'((cc . (oneR))
307 c1^ \markup \center-column {
309 \woodwind-diagram #'flute #'((cc . (oneF two))
315 Trills are indicated in the woodwind diagrams as shaded keys:
317 @lilypond [verbatim, quote, relative=2]
318 c1^ \markup \woodwind-diagram #'bass-clarinet
319 #'((cc . (threeT four))
324 A variety of trills can be displayed:
326 @lilypond [verbatim, quote, relative=2]
328 c1^ \markup \center-column {
329 "one quarter to ring"
330 \woodwind-diagram #'flute #'((cc . (one1qTR))
334 c1^ \markup \center-column {
336 \woodwind-diagram #'flute #'((cc . (oneTR))
340 c1^ \markup \center-column {
342 \woodwind-diagram #'flute #'((cc . (oneRT))
346 c1^ \markup \center-column {
348 \woodwind-diagram #'flute #'((cc . (oneT))
352 c1^ \markup \center-column {
353 "one quarter to three quarters"
354 \woodwind-diagram #'flute #'((cc . (one1qT3q))
360 The list of all possible keys and settings for a given instrument
361 can be displayed on the console or in the log file, although they
362 will not show up in the music output:
364 @lilypond[verbatim, quote]
366 #(print-keys-verbose 'flute)
370 New diagrams can be created by following the patterns in
371 @file{scm/define-woodwind-diagrams.scm} and
372 @file{scm/display-woodwind-diagrams.scm}. However, this will
373 require Scheme ability and may not be accessible to all users.
379 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
380 {woodwind-diagrams-listing.ly}
382 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
383 {graphical-and-text-woodwind-diagrams.ly}
385 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
386 {changing-the-size-of-woodwind-diagrams.ly}
388 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
389 {woodwind-diagrams-key-lists.ly}
394 @file{scm/define-woodwind-diagrams.scm},
395 @file{scm/display-woodwind-diagrams.scm}.
397 Snippets: @rlsr{Winds}.
400 @rinternals{TextScript},
401 @rinternals{instrument-specific-markup-interface}.