Documentation/notation/wind.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   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..
   8 @end ignore
   9
  10 @c \version "2.12.0"
  11
  12 @node Wind instruments
  13 @section Wind instruments
  14
  15 @lilypondfile[quote]{wind-headword.ly}
  16
  17 This section includes some elements of music notation that arise when
  18 writing for winds.
  19
  20 @menu
  21 * Common notation for wind instruments::
  22 * Bagpipes::
  23 * Woodwinds::
  24 @end menu
  25
  26 @node Common notation for wind instruments
  27 @subsection Common notation for wind instruments
  28
  29 This section discusses some issues common to most wind instruments.
  30
  31 @menu
  32 * References for wind instruments::
  33 * Fingerings::
  34 @end menu
  35
  36 @node References for wind instruments
  37 @unnumberedsubsubsec References for wind instruments
  38
  39 @cindex wind instruments
  40
  41 Many notation issues for wind instruments pertain to breathing and
  42 tonguing:
  43
  44 @itemize
  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
  50 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}.
  53 @end itemize
  54
  55 There are also other aspects of musical notation that can apply to wind
  56 instruments:
  57
  58 @itemize
  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
  65 @ref{Grace notes}.
  66 @item Pitch inflections at the end of a note are discussed in @ref{Falls
  67 and doits}.
  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}.
  78 @end itemize
  79
  80 @snippets
  81
  82 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
  83 {changing--flageolet-mark-size.ly}
  84
  85
  86 @seealso
  87 Notation Reference:
  88 @ref{Breath marks},
  89 @ref{Slurs},
  90 @ref{Articulations and ornamentations},
  91 @ref{List of articulations},
  92 @ref{Tremolo repeats},
  93 @ref{Instrument transpositions},
  94 @ref{Glissando},
  95 @ref{Grace notes},
  96 @ref{Falls and doits},
  97 @ref{Special note heads},
  98
  99 Snippets:
 100 @rlsr{Winds}.
 101
 102
 103 @node Fingerings
 104 @unnumberedsubsubsec Fingerings
 105
 106 All wind instruments other than the trombone require the use of several
 107 fingers to produce each pitch.
 108
 109 @snippets
 110
 111 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 112 {fingering-symbols-for-wind-instruments.ly}
 113
 114 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 115 {recorder-fingering-chart.ly}
 116
 117 @seealso
 118
 119 Snippets:
 120 @rlsr{Winds}.
 121
 122
 123 @node Bagpipes
 124 @subsection Bagpipes
 125
 126 This section includes extra information for writing for bagpipes.
 127
 128 @menu
 129 * Bagpipe definitions::
 130 * Bagpipe example::
 131 @end menu
 132
 133 @node Bagpipe definitions
 134 @unnumberedsubsubsec Bagpipe definitions
 135
 136 @cindex bagpipe
 137 @cindex Scottish highland bagpipe
 138 @cindex grace notes
 139 @funindex \taor
 140 @funindex taor
 141 @funindex \hideKeySignature
 142 @funindex hideKeySignature
 143 @funindex \showKeySignature
 144 @funindex showKeySignature
 145
 146 LilyPond contains special definitions for music for the Scottish
 147 highland bagpipe; to use them, add
 148
 149 @example
 150 \include "bagpipe.ly"
 151 @end example
 152
 153 @noindent
 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
 157
 158 @example
 159 \grace @{ \small G32[ d G e] @}
 160 @end example
 161
 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}.
 165
 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 }
 169 @end lilypond
 170
 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}
 176 instead.
 177
 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
 181 music.
 182
 183
 184 @seealso
 185 @rlsr{Winds}.
 186
 187
 188 @node Bagpipe example
 189 @unnumberedsubsubsec Bagpipe example
 190
 191 @cindex bagpipe example
 192 @cindex Amazing Grace bagpipe example
 193
 194 This is what the well known tune Amazing Grace looks like in bagpipe
 195 notation.
 196
 197 @lilypond[verbatim,quote]
 198 \include "bagpipe.ly"
 199 \layout {
 200   indent = 0.0\cm
 201   \context { \Score \remove "Bar_number_engraver" }
 202 }
 203
 204 \header {
 205   title = "Amazing Grace"
 206   meter = "Hymn"
 207   arranger = "Trad. arr."
 208 }
 209
 210 {
 211   \hideKeySignature
 212   \time 3/4
 213   \grg \partial 4 a8. d16
 214   \slurd d2 \grg f8[ e32 d16.]
 215   \grg f2 \grg f8 e
 216   \thrwd d2 \grg b4
 217   \grG a2 \grg a8. d16
 218   \slurd d2 \grg f8[ e32 d16.]
 219   \grg f2 \grg e8. f16
 220   \dblA A2 \grg A4
 221   \grg A2 f8. A16
 222   \grg A2 \hdblf f8[ e32 d16.]
 223   \grg f2 \grg f8 e
 224   \thrwd d2 \grg b4
 225   \grG a2 \grg a8. d16
 226   \slurd d2 \grg f8[ e32 d16.]
 227   \grg f2 e4
 228   \thrwd d2.
 229   \slurd d2
 230   \bar "|."
 231 }
 232 @end lilypond
 233
 234
 235 @seealso
 236 @rlsr{Winds}.
 237
 238 @node Woodwinds
 239 @subsection Woodwinds
 240
 241 This section describes notation specifically for woodwinds.
 242
 243 @menu
 244 * Woodwind diagrams::
 245 @end menu
 246
 247 @node Woodwind diagrams
 248 @subsubsection Woodwind diagrams
 249
 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
 252 instruments.
 253
 254 Woodwind diagrams are available for the following instruments:
 255
 256 @itemize
 257 @item piccolo
 258 @item flute
 259 @item oboe
 260 @item clarinet
 261 @item bass clarinet
 262 @item saxophone
 263 @item basson
 264 @item contrabassoon
 265 @end itemize
 266
 267 @noindent
 268 The diagrams and the scheme instrument names are shown in the snippet below.
 269
 270 Woodwind diagrams are created as markups:
 271
 272
 273 @lilypond[verbatim, quote, relative=2]
 274 c1^ \markup \woodwind-diagram #'piccolo #'((lh . (gis))
 275                                            (cc . (one three))
 276                                            (rh . (ees)))
 277 @end lilypond
 278
 279 Keys can be open, partially-covered, ring-depressed, or fully covered:
 280
 281 @lilypond [verbatim, quote, relative=2]
 282 \textLengthOn
 283 c1^ \markup \center-column {
 284   "one quarter"
 285   \woodwind-diagram #'flute #'((cc . (one1q))
 286                                   (lh . ())
 287                                   (rh . ()))
 288 }
 289 c1^ \markup \center-column {
 290   "one half"
 291   \woodwind-diagram #'flute #'((cc . (one1h))
 292                                   (lh . ())
 293                                   (rh . ()))
 294 }
 295 c1^ \markup \center-column {
 296   "three quarter"
 297   \woodwind-diagram #'flute #'((cc . (one3q))
 298                                   (lh . ())
 299                                   (rh . ()))
 300 }
 301 c1^ \markup \center-column {
 302   "ring"
 303   \woodwind-diagram #'flute #'((cc . (oneR))
 304                                   (lh . ())
 305                                   (rh . ()))
 306 }
 307 c1^ \markup \center-column {
 308   "full"
 309   \woodwind-diagram #'flute #'((cc . (oneF two))
 310                                   (lh . ())
 311                                   (rh . ()))
 312 }
 313 @end lilypond
 314
 315 Trills are indicated in the woodwind diagrams as shaded keys:
 316
 317 @lilypond [verbatim, quote, relative=2]
 318 c1^ \markup \woodwind-diagram #'bass-clarinet
 319                               #'((cc . (threeT four))
 320                                  (lh . ())
 321                                  (rh . (b fis)))
 322 @end lilypond
 323
 324 A variety of trills can be displayed:
 325
 326 @lilypond [verbatim, quote, relative=2]
 327 \textLengthOn
 328 c1^ \markup \center-column {
 329   "one quarter to ring"
 330   \woodwind-diagram #'flute #'((cc . (one1qTR))
 331                                   (lh . ())
 332                                   (rh . ()))
 333 }
 334 c1^ \markup \center-column {
 335   "ring to shut"
 336   \woodwind-diagram #'flute #'((cc . (oneTR))
 337                                   (lh . ())
 338                                   (rh . ()))
 339 }
 340 c1^ \markup \center-column {
 341   "ring to open"
 342   \woodwind-diagram #'flute #'((cc . (oneRT))
 343                                   (lh . ())
 344                                   (rh . ()))
 345 }
 346 c1^ \markup \center-column {
 347   "open to shut"
 348   \woodwind-diagram #'flute #'((cc . (oneT))
 349                                   (lh . ())
 350                                   (rh . ()))
 351 }
 352 c1^ \markup \center-column {
 353   "one quarter to three quarters"
 354   \woodwind-diagram #'flute #'((cc . (one1qT3q))
 355                                   (lh . ())
 356                                   (rh . ()))
 357 }
 358 @end lilypond
 359
 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:
 363
 364 @lilypond[verbatim, quote]
 365
 366 #(print-keys-verbose 'flute)
 367
 368 @end lilypond
 369
 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.
 374
 375 @predefined
 376 @endpredefined
 377
 378 @snippets
 379 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 380 {woodwind-diagrams-listing.ly}
 381
 382 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
 383 {graphical-and-text-woodwind-diagrams.ly}
 384
 385 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
 386 {changing-the-size-of-woodwind-diagrams.ly}
 387
 388 @lilypondfile[verbatim, lilyquote, texidoc, doctitle]
 389 {woodwind-diagrams-key-lists.ly}
 390
 391 @seealso
 392
 393 Installed Files:
 394 @file{scm/define-woodwind-diagrams.scm},
 395 @file{scm/display-woodwind-diagrams.scm}.
 396
 397 Snippets: @rlsr{Winds}.
 398
 399 Internals Reference:
 400 @rinternals{TextScript},
 401 @rinternals{instrument-specific-markup-interface}.
 402
 403 @knownissues