Documentation/fr/notation/pitches.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2 @ignore
   3     Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5
   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.16.0"
  11
  12 @c Translators: Frédéric Chiasson
  13 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
  14
  15 @node Hauteurs
  16 @section Hauteurs
  17 @translationof Pitches
  18
  19 @lilypondfile[quote]{pitches-headword.ly}
  20
  21 Cette section détaille la façon d'indiquer la hauteur des notes, sous
  22 trois aspects : la saisie des hauteurs, la modification des
  23 hauteurs et les options de gravure.
  24
  25 @menu
  26 * Écriture des hauteurs de note::
  27 * Modification de plusieurs hauteurs::
  28 * Gravure des hauteurs::
  29 * Têtes de note::
  30 @end menu
  31
  32
  33 @node Écriture des hauteurs de note
  34 @subsection Écriture des hauteurs de note
  35 @translationof Writing pitches
  36
  37 Cette section explique la manière d'indiquer les hauteurs de note.  Deux
  38 modes permettent d'indiquer l'octave des notes : le mode absolu, et le
  39 mode relatif.  Ce dernier est le plus pratique lors de la saisie d'un
  40 fichier source au clavier de l'ordinateur.
  41
  42 @menu
  43 * Hauteurs avec octave absolue::
  44 * Octaves relatives::
  45 * Altérations::
  46 * Nom des notes dans d'autres langues::
  47 @end menu
  48
  49
  50 @node Hauteurs avec octave absolue
  51 @unnumberedsubsubsec Hauteurs avec octave absolue
  52 @translationof Absolute octave entry
  53
  54 @cindex noms de note
  55 @cindex hauteurs
  56 @cindex absolues, hauteurs
  57 @cindex absolues, octaves
  58 @cindex octaves absolues
  59
  60 La hauteur s'écrit -- à moins de préciser une autre langue -- avec la
  61 notation batave, en utilisant les lettres de @code{a} à @code{g}.
  62 Les notes @code{c} (do) et @code{b} (si) sont écrites une octave sous le
  63 do central.
  64
  65 @c don't use c' here.
  66 @lilypond[verbatim,quote]
  67 {
  68   \clef bass
  69   c4 d e f
  70   g4 a b c
  71   d4 e f g
  72 }
  73 @end lilypond
  74
  75 @cindex octave, spécification
  76
  77 @funindex '
  78 @funindex ,
  79
  80 L'octave peut être précisée sous forme d'une série
  81 d'apostrophes @code{'} ou d'une série de virgules @code{,}.
  82 Chaque @code{'} hausse la note d'une octave ;
  83 chaque @code{,} baisse la note d'une octave.
  84
  85 @lilypond[verbatim,quote]
  86 {
  87   \clef treble
  88   c'4 c'' e' g
  89   d''4 d' d c
  90   \clef bass
  91   c,4 c,, e, g
  92   d,,4 d, d c
  93 }
  94 @end lilypond
  95
  96 @seealso
  97 Glossaire musicologique :
  98 @rglosnamed{Pitch names,Noms des notes}.
  99
 100 Morceaux choisis :
 101 @rlsrnamed{Pitches,Hauteurs}.
 102
 103
 104 @node Octaves relatives
 105 @unnumberedsubsubsec Octaves relatives
 106 @translationof Relative octave entry
 107
 108 @cindex relatif
 109 @cindex indication d'octave relative
 110 @cindex octave relative, indication
 111
 112 @funindex \relative
 113 @funindex relative
 114
 115 On spécifie les octaves en ajoutant @code{'} ou @code{,} aux
 116 noms de hauteur.  En recopiant de la musique, on a vite fait de mettre
 117 une note à la mauvaise octave ; ce genre d'erreur est difficile à
 118 retrouver.  Le mode d'écriture en octave relative prévient ces erreurs
 119 dans la mesure où elles deviennent beaucoup plus évidentes : une
 120 seule erreur décale le reste de la pièce à une mauvaise octave.
 121
 122 @example
 123 \relative @var{hauteur_de_référence} @var{expression_musicale}
 124 @end example
 125
 126 En mode relatif, chaque note est considérée comme étant le plus proche
 127 possible de celle qui la précède.  L'octave des notes mentionnées dans
 128 @var{expression_musicale} va être calculée de la manière suivante :
 129
 130 @itemize
 131 @item
 132 Si aucun signe de changement d'octave n'est utilisé, l'intervalle de
 133 base entre la note actuelle et la précédente sera toujours au plus d'une
 134 quarte.  Cet intervalle est déterminé sans tenir compte des altérations.
 135
 136 @item
 137 Un signe de changement d'octave @code{'} ou @code{,} peut être
 138 ajouté pour hausser ou baisser la note d'une octave par rapport à la
 139 hauteur calculée sans spécification.
 140
 141 @item
 142 Ces signes de changement d'octave peuvent être multipliés.  Par exemple,
 143 @code{''} ou @code{,,} ajouteront une octave supplémentaire.
 144
 145 @item
 146 Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
 147 départ peut être spécifiée, et agira dès lors comme si elle précédait la
 148 première note de @var{expression_musicale}.  Nous vous recommandons de
 149 faire référence à un do (@code{c}).
 150
 151 @end itemize
 152
 153 Voici le mode @code{\relative} en action.
 154
 155 @lilypond[verbatim,quote]
 156 \relative c {
 157   \clef bass
 158   c d e f
 159   g a b c
 160   d e f g
 161 }
 162 @end lilypond
 163
 164 On utilise les signes de changement d'octave pour les intervalles
 165 dépassant la quarte.
 166
 167 @lilypond[verbatim,quote]
 168 \relative c'' {
 169   c g c f,
 170   c' a, e'' c
 171 }
 172 @end lilypond
 173
 174 Bien que ne comportant aucun signe de changement d'octave, une séquence
 175 de notes peut tout à fait couvrir un intervalle important.
 176
 177 @lilypond[verbatim,quote]
 178 \relative c {
 179   c f b e
 180   a d g c
 181 }
 182 @end lilypond
 183
 184 Lorsque plusieurs blocs @code{\relative} sont imbriqués, c'est la
 185 dernière clause @code{\relative} qui est prise en compte.
 186
 187 @lilypond[verbatim,quote]
 188 \relative c' {
 189   c d e f
 190   \relative c'' {
 191     c d e f
 192   }
 193 }
 194 @end lilypond
 195
 196 @code{\relative} est sans effet sur un bloc @code{\chordmode}.
 197
 198 @lilypond[verbatim,quote]
 199 \new Staff {
 200   \relative c''' {
 201     \chordmode { c1 }
 202   }
 203   \chordmode { c1 }
 204 }
 205 @end lilypond
 206
 207 @code{\relative} n'est pas permis au sein d'un bloc @code{\chordmode}.
 208
 209 Pour utiliser le mode d'octave relative dans de la musique transposée,
 210 une clause @code{\relative} additionnelle doit être placée au sein du
 211 bloc @code{\transpose}.
 212
 213 @lilypond[verbatim,quote]
 214 \relative c' {
 215   d e
 216   \transpose f g {
 217     d e
 218     \relative c' {
 219       d e
 220     }
 221   }
 222 }
 223 @end lilypond
 224
 225 @cindex accords et octave relative
 226 @cindex octave relative et accords
 227
 228 Si l'expression précédente est un accord, c'est la première note de
 229 l'accord qui détermine l'emplacement de la première note du prochain
 230 accord.  À l'intérieur de l'accord, les notes sont placées relativement
 231 à celle qui précède.  Examinez avec attention l'exemple suivant, et tout
 232 particulièrement le positionnement des do.
 233
 234 @lilypond[verbatim,quote]
 235 \relative c' {
 236   c
 237   <c e g>
 238   <c' e g'>
 239   <c, e, g''>
 240 }
 241 @end lilypond
 242
 243 Comme nous l'avons vu, l'octaviation est déterminée sans tenir compte
 244 des altérations.  Ainsi un mi double-dièse qui suit un si naturel sera
 245 placé au-dessus de celui-ci, alors qu'un fa double-bémol se retrouvera
 246 en dessous.  En d'autres termes, une quarte doublement augmentée
 247 demeure considérée comme un intervalle plus petit qu'une quinte
 248 diminuée, bien que la quarte doublement augmentée soit de sept demi-tons
 249 et la quinte diminuée de seulement six demi-tons.
 250
 251 @lilypond[verbatim,quote]
 252 \relative c'' {
 253   c2 fis
 254   c2 ges
 255   b2 eisis
 256   b2 feses
 257 }
 258 @end lilypond
 259
 260 L'une des conséquences de toutes ces règles est que la première note
 261 rencontrée dans un fragment balisé par @code{@w{\relative f}} sera
 262 interprétée tout comme si elle avait été saisie en mode absolu.
 263
 264 @seealso
 265 Glossaire musicologique :
 266 @rglosnamed{fifth,quinte},
 267 @rglosnamed{interval,intervalle},
 268 @rglosnamed{Pitch names,nom des notes}.
 269
 270 Manuel de notation :
 271 @ref{Vérifications d'octave}.
 272
 273 Morceaux choisis :
 274 @rlsrnamed{Pitches,Hauteurs}.
 275
 276 Référence des propriétés internes :
 277 @rinternals{RelativeOctaveMusic}.
 278
 279
 280 @node Altérations
 281 @unnumberedsubsubsec Altérations
 282 @translationof Accidentals
 283
 284 @cindex altération
 285 @cindex armure
 286 @cindex clef
 287
 288 @c duplicated in Key signature and in Accidentals
 289 @warning{Les nouveaux utilisateurs sont parfois déroutés par la gestion
 290 des altérations et de l'armure.  Pour LilyPond, une hauteur n'est que du
 291 matériau brut ; l'armure et la clef ne feront que déterminer
 292 comment ce matériau sera retranscrit.  Un simple @code{c} signifie
 293 tout bonnement « do naturel » quelles que soient l'armure et la clef
 294 en question. Pour plus d'information, reportez-vous au chapitre
 295 @rlearning{Altérations et armure}.}
 296
 297 @cindex noms de note, hollandais
 298 @cindex noms de note, par défaut
 299 @cindex hauteur, nom par défaut
 300 @cindex dièse
 301 @cindex bémol
 302 @cindex double dièse
 303 @cindex double bémol
 304 @cindex naturel
 305 @cindex bécarre
 306
 307 Dans la notation par défaut, un @notation{dièse} est formé en ajoutant
 308 @code{is} après le nom de note, un @notation{bémol} en ajoutant
 309 @code{es}.  Les @notation{double-dièses} et @notation{double-bémols}
 310 sont obtenus en ajoutant respectivement @code{isis} ou @code{eses} au
 311 nom de note.  Ce sont les noms de note hollandais.  Pour les autres
 312 langues, consultez @ref{Nom des notes dans d'autres langues}.
 313
 314 @lilypond[verbatim,quote,relative=2]
 315 ais1 aes aisis aeses
 316 @end lilypond
 317
 318 Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
 319 ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
 320 bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
 321 donnera une note bécarre.
 322
 323 @lilypond[verbatim,quote,relative=2]
 324 a4 aes a2
 325 @end lilypond
 326
 327 @cindex quarts de ton
 328 @cindex demi-bémols
 329 @cindex demi-dièses
 330
 331 Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
 332 @code{eh} et @code{ih}. Voici une série de dos altérés en hauteurs
 333 croissantes :
 334
 335 @lilypond[verbatim,quote,relative=2]
 336 ceseh1 ces ceh c cih cis cisih
 337 @end lilypond
 338
 339 Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 340
 341 @cindex altération de précaution
 342 @cindex altération entre parenthèses
 343 @cindex précaution, altération de
 344 @cindex parenthèses, altération entre
 345
 346 @funindex ?
 347 @funindex !
 348
 349 Normalement, les altérations sont imprimées automatiquement, mais il se
 350 peut que vous vouliez les imprimer manuellement.  On peut forcer
 351 l'impression d'une altération, dite « de précaution », en ajoutant un
 352 point d'exclamation @code{!} après la hauteur de note.  Une
 353 altération entre parenthèses peut être obtenue en ajoutant un point
 354 d'interrogation @code{?} après la hauteur de note.  Ces signes
 355 peuvent aussi être utilisés pour imprimer des bécarres.
 356
 357 @lilypond[verbatim,quote,relative=2]
 358 cis cis cis! cis? c c c! c?
 359 @end lilypond
 360
 361 @cindex altération et liaison de tenue
 362 @cindex liaison de tenue et altération
 363
 364 Lorsqu'une note est prolongée par une liaison de tenue, l'altération ne
 365 sera réimprimée que s'il y a un saut de ligne.
 366
 367 @lilypond[verbatim,quote,relative=2]
 368 cis1 ~ cis ~
 369 \break
 370 cis
 371 @end lilypond
 372
 373 @snippets
 374 @lilypondfile[verbatim,quote,texidoc,doctitle,ragged-right]
 375 {hiding-accidentals-on-tied-notes-at-the-start-of-a-new-system.ly}
 376
 377 @lilypondfile[verbatim,quote,texidoc, doctitle]
 378 {preventing-extra-naturals-from-being-automatically-added.ly}
 379
 380 @seealso
 381 Glossaire musicologique :
 382 @rglosnamed{sharp,dièse},
 383 @rglosnamed{flat,bémol},
 384 @rglosnamed{double sharp,double dièse},
 385 @rglosnamed{double flat,double bémol},
 386 @rglosnamed{Pitch names,Nom des notes},
 387 @rglosnamed{quarter tone,quart de ton}.
 388
 389 Manuel d'initiation :
 390 @rlearning{Altérations et armure}.
 391
 392 Manuel de notation :
 393 @ref{Altérations accidentelles automatiques},
 394 @ref{Altérations suggérées (musica ficta)},
 395 @ref{Nom des notes dans d'autres langues}.
 396
 397 Morceaux choisis :
 398 @rlsrnamed{Pitches,Hauteurs}.
 399
 400 Références des propriétés internes :
 401 @rinternals{Accidental_engraver},
 402 @rinternals{Accidental},
 403 @rinternals{AccidentalCautionary},
 404 @rinternals{accidental-interface}.
 405
 406 @cindex accidentel, quart de ton
 407 @cindex quart de ton
 408
 409 @knownissues
 410 Il n'y a pas de standard universellement accepté pour noter le bémol et
 411 demi (qui abaisse la hauteur trois quarts de ton), le symbole de
 412 LilyPond n'est donc conforme à aucun standard.
 413
 414
 415 @node Nom des notes dans d'autres langues
 416 @unnumberedsubsubsec Nom des notes dans d'autres langues
 417 @translationof Note names in other languages
 418
 419 @cindex notes, noms selon la langue
 420 @cindex noms de note, langues
 421 @cindex langues, noms de note
 422
 423 Vous disposez de jeux prédéfinis de noms de note et altérations pour
 424 plusieurs autres langues.  Pour les utiliser, il suffit de déclarer, en
 425 début de fichier, la langue que vous utilisez.  Voici comment, par
 426 exemple, utiliser l'italien pour votre saisie :
 427
 428 @lilypond[quote,verbatim]
 429 \language "italiano"
 430
 431 \relative do' {
 432   do re mi sib
 433 }
 434 @end lilypond
 435
 436 Les langues disponibles ainsi que les noms de note utilisés
 437 sont les suivants :
 438
 439 @quotation
 440 @multitable {@code{nederlands}} {do re mi fa sol la sib si}
 441 @headitem Langue
 442   @tab Nom des notes
 443 @item @code{nederlands}
 444   @tab c d e f g a bes b
 445 @item @code{catalan}
 446   @tab do re mi fa sol la sib si
 447 @item @code{deutsch}
 448   @tab c d e f g a b h
 449 @item @code{english}
 450   @tab c d e f g a bf b
 451 @item @code{espanol}
 452   @tab do re mi fa sol la sib si
 453 @item @code{italiano}
 454   @tab do re mi fa sol la sib si
 455 @item @code{norsk}
 456   @tab c d e f g a b h
 457 @item @code{portugues}
 458   @tab do re mi fa sol la sib si
 459 @item @code{suomi}
 460   @tab c d e f g a b h
 461 @item @code{svenska}
 462   @tab c d e f g a b h
 463 @item @code{vlaams}
 464   @tab do re mi fa sol la sib si
 465 @end multitable
 466 @end quotation
 467
 468 @noindent
 469 et les suffixes d'altération correspondants :
 470
 471 @quotation
 472 @multitable {@code{nederlands}} {-s/-sharp} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
 473 @headitem Langue
 474   @tab dièse @tab bémol @tab double dièse @tab double bémol
 475 @item @code{nederlands}
 476   @tab -is @tab -es @tab -isis @tab -eses
 477 @item @code{catalan}
 478   @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
 479 @item @code{deutsch}
 480   @tab -is @tab -es @tab -isis @tab -eses
 481 @item @code{english}
 482   @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
 483     @tab -ff/-flatflat
 484 @item @code{espanol}
 485   @tab -s @tab -b @tab -ss/-x @tab -bb
 486 @item @code{italiano}
 487   @tab -d @tab -b @tab -dd @tab -bb
 488 @item @code{norsk}
 489   @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
 490     @tab -essess/-eses
 491 @item @code{portugues}
 492   @tab -s @tab -b @tab -ss @tab -bb
 493 @item @code{suomi}
 494   @tab -is @tab -es @tab -isis @tab -eses
 495 @item @code{svenska}
 496   @tab -iss @tab -ess @tab -ississ @tab -essess
 497 @item @code{vlaams}
 498   @tab -k @tab -b @tab -kk @tab -bb
 499 @end multitable
 500 @end quotation
 501
 502 @noindent
 503 Notez qu'en hollandais, en allemand, en norvégien et en suédois, un
 504 @notation{la} altéré de @notation{bémol} se note @code{aes} et
 505 @code{aeses}.  Ces formes sont contractées en @code{as} et @code{ases}
 506 (ou plus communément @code{asas}).  Dans certains fichiers
 507 linguistiques, seules ces formes abrégées ont été définies.
 508
 509 @lilypond[verbatim,quote,relative=2]
 510 a2 as e es a ases e eses
 511 @end lilypond
 512
 513 @cindex microtonalités
 514 @cindex demi-dièse
 515 @cindex demi-bémol
 516 @cindex sesqui-dièse
 517 @cindex sesqui-bémol
 518
 519 @noindent
 520 Certaines musiques utilisent des microtonalités, pour lesquelles les
 521 altérations sont des fractions de dièse ou bémol « normaux ».  Le
 522 tableau suivant répertorie les noms de note en quart de ton, tels que
 523 définis dans plusieurs fichiers linguistiques.  Les préfixes @emph{semi-}
 524 et @emph{sesqui-} correspondent au @emph{demi-} et @emph{trois demis}.
 525 À noter qu'aucune définition n'existe à ce jour pour le norvégien, le
 526 suédois, le catalan et l'espagnol.
 527
 528 @quotation
 529 @multitable {@code{nederlands}} {@b{semi-sharp}} {@b{semi-flat}} {@b{sesqui-sharp}} {@b{sesqui-flat}}
 530 @headitem Langue
 531   @tab semi-dièse @tab semi-bémol @tab sesqui-dièse @tab sesqui-bémol
 532 @item @code{nederlands}
 533   @tab -ih @tab -eh @tab -isih @tab -eseh
 534 @item @code{deutsch}
 535   @tab -ih @tab -eh @tab -isih @tab -eseh
 536 @item @code{english}
 537   @tab -qs @tab -qf @tab -tqs @tab -tqf
 538 @item @code{espanol}
 539   @tab -cs @tab -cb @tab -tcs @tab -tcb
 540 @item @code{italiano}
 541   @tab -sd @tab -sb @tab -dsd @tab -bsb
 542 @item @code{portugues}
 543   @tab -sqt @tab -bqt @tab -stqt @tab -btqt
 544 @end multitable
 545 @end quotation
 546
 547 La plupart des langues dont nous venons de parler correspondent à la
 548 musique classique occidentale au tempérament égal -- le concept de
 549 @emph{Common Practice Period} en anglais.  LilyPond prend néanmoins en
 550 charge d'autres systèmes de notation, comme indiqué au chapitre
 551 @ref{Noms des notes et altérations non-occidentaux}.
 552
 553 @seealso
 554 Glossaire musicologique :
 555 @rglosnamed{Pitch names,Nom des notes},
 556 @rglos{Common Practice Period}.
 557
 558 Manuel de notation :
 559 @ref{Noms des notes et altérations non-occidentaux}.
 560
 561 Fichiers d'initialisation :
 562 @file{scm/define-note-names.scm}.
 563
 564 Morceaux choisis :
 565 @rlsrnamed{Pitches,Hauteurs}.
 566
 567
 568 @node Modification de plusieurs hauteurs
 569 @subsection Modification de plusieurs hauteurs
 570 @translationof Changing multiple pitches
 571
 572 Cette partie traite de la manière de modifier les hauteurs de note.
 573
 574 @menu
 575 * Vérifications d'octave::
 576 * Transposition::
 577 * Inversion::
 578 * Rétrogradation::
 579 * Transformations modales::
 580 @end menu
 581
 582
 583 @node Vérifications d'octave
 584 @unnumberedsubsubsec Vérifications d'octave
 585 @translationof Octave checks
 586
 587 @cindex vérification d'octave
 588 @cindex octave, vérification
 589 @cindex contrôle des hauteurs
 590
 591 @funindex =
 592 @funindex \octaveCheck
 593 @funindex octaveCheck
 594 @funindex controlpitch
 595
 596 Les tests d'octave rendent la correction d'erreurs d'octave plus facile
 597 dans le mode d'octave @code{relative} -- un @code{,} ou
 598 un @code{'} oublié, ça n'arrive pas qu'aux autres !
 599
 600 Une note peut être suivie de @w{@code{=}@var{apostrophes/virgules}}
 601 pour indiquer à quelle @strong{octave absolue} elle devrait être.  Dans
 602 l'exemple suivant, le premier @code{d} générera un avertissement,
 603 puisqu'on attend un @code{d''} -- intervalle inférieur à la quarte --
 604 mais qu'on obtient un @code{d'}.  Sur la partition, l'octave sera
 605 corrigée pour donner un @code{d'} et la prochaine note sera calculée en
 606 fonction de ce @code{d'} et non de @code{d''}.
 607
 608 @lilypond[verbatim,quote]
 609 \relative c'' {
 610   c2 d='4 d
 611   e2 f
 612 }
 613 @end lilypond
 614
 615 Il existe aussi une vérification d'octave qui ne produit pas de musique
 616 imprimée, ayant pour syntaxe
 617 @code{\octaveCheck @var{hauteur_référence}} --
 618 @code{@var{hauteur_référence}} étant spécifiée en mode absolu.  Cette
 619 commande vérifie que l'intervalle entre la note qui précède et
 620 @code{@var{hauteur_référence}} est inférieur à la quinte comme il se
 621 doit en mode relatif.  Dans le cas contraire, un message sera émis et la
 622 note précédente ne sera pas modifiée.  Les notes suivantes seront, par
 623 contre, positionnées relativement à @code{@var{hauteur_référence}}.
 624
 625 @lilypond[verbatim,quote]
 626 \relative c'' {
 627   c2 d
 628   \octaveCheck c'
 629   e2 f
 630 }
 631 @end lilypond
 632
 633 Dans les deux mesures qui suivent, les premier et troisième
 634 @code{\octaveCheck} échouent, mais le deuxième est concluant.
 635
 636 @lilypond[verbatim,quote]
 637 \relative c'' {
 638   c4 f g f
 639
 640   c4
 641   \octaveCheck c'
 642   f
 643   \octaveCheck c'
 644   g
 645   \octaveCheck c'
 646   f
 647 }
 648 @end lilypond
 649
 650 @seealso
 651 Morceaux choisis :
 652 @rlsrnamed{Pitches,Hauteurs}.
 653
 654 Référence des propriétés internes :
 655 @rinternals{RelativeOctaveCheck}.
 656
 657
 658 @node Transposition
 659 @unnumberedsubsubsec Transposition
 660 @translationof Transpose
 661
 662 @cindex transposition
 663 @cindex transposition des hauteurs
 664
 665 @funindex \transpose
 666 @funindex transpose
 667
 668 Une expression musicale peut être transposée avec @code{\transpose}.
 669 En voici la syntaxe :
 670
 671 @example
 672 \transpose @var{note_de_départ} @var{note_d_arrivée} @var{expression_musicale}
 673 @end example
 674
 675 @noindent
 676 Cela signifie que @code{@var{expression_musicale}} est transposé de
 677 l'intervalle séparant @code{@var{note_de_départ}} et
 678 @code{@var{note_d_arrivée}} : toute note dont la hauteur était
 679 @code{note_de_départ} est changée en @code{note_d_arrivée} ; les
 680 autres notes seront changées selon le même intervalle.  Les deux
 681 hauteurs s'expriment en octave absolue.
 682
 683 @warning{La musique contenue dans un bloc @code{@bs{}transpose} est en
 684 octaves absolues, sauf à inclure dans ce même bloc une clause
 685 @code{@bs{}relative}.}
 686
 687 Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce est
 688 un peu trop basse pour l'interprète, elle peut être transposée en mi
 689 majeur.  Vous noterez que l'armure est automatiquement modifiée.
 690
 691 @lilypond[verbatim,quote]
 692 \transpose d e {
 693   \relative c' {
 694     \key d \major
 695     d4 fis a d
 696   }
 697 }
 698 @end lilypond
 699
 700 @cindex transpositeur, instrument
 701 @cindex instruments transpositeurs
 702
 703 Regardons maintenant une partie écrite pour violon -- un instrument en
 704 ut.  Si cette partie doit être jouée par une clarinette en la (écrite à
 705 la tierce mineure supérieure, un do écrit donnant un la réel), la
 706 transposition suivante créera la partie appropriée.
 707
 708 @lilypond[verbatim,quote]
 709 \transpose a c' {
 710   \relative c' {
 711     \key c \major
 712     c4 d e g
 713   }
 714 }
 715 @end lilypond
 716
 717 @noindent
 718 La présence de @w{@code{\key c \major}} s'explique par le fait que, bien
 719 que les notes soient effectivement transposées, l'armure ne sera
 720 imprimée que dans la mesure où elle est explicitement mentionnée.
 721
 722 @code{\transpose} fait la distinction entre les notes enharmoniques :
 723 @w{@code{\transpose c cis}} et @w{@code{\transpose c des}} transposeront
 724 la pièce un demi-ton plus haut, au détail près que la première version
 725 écrira des dièses et la deuxième des bémols.
 726
 727 @lilypond[verbatim,quote]
 728 music = \relative c' { c d e f }
 729 \new Staff {
 730   \transpose c cis { \music }
 731   \transpose c des { \music }
 732 }
 733 @end lilypond
 734
 735 On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
 736 pour un instrument transpositeur.  Normalement, les hauteurs dans
 737 LilyPond sont écrites en ut, c'est à dire en sons réels, mais elles
 738 peuvent être écrites dans un autre ton.  Prenons l'exemple d'un morceau
 739 pour trompette en si bémol commençant sur un ré à l'oreille ; on
 740 pourrait écrire
 741
 742 @example
 743 musiqueEnSiBemol = @{ e4 @dots{} @}
 744 \transpose c bes, \musiqueEnSiBemol
 745 @end example
 746
 747 @noindent
 748 Pour imprimer cette musique en fa -- et de ce fait produire une partie
 749 de cor au lieu d'un conducteur en notes réelles -- on utilisera un
 750 deuxième @code{\transpose} :
 751
 752 @example
 753 musiqueEnSiBemol = @{ e4 @dots{} @}
 754 \transpose f c' @{ \transpose c bes, \musiqueEnSiBemol @}
 755 @end example
 756
 757 @noindent
 758 Pour plus d'information à ce sujet, consultez
 759 @ref{Instruments transpositeurs}.
 760
 761 @snippets
 762 @lilypondfile[verbatim,quote,texidoc,doctitle]
 763 {transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
 764
 765 @seealso
 766 Manuel de notation :
 767 @ref{Octaves relatives},
 768 @ref{Instruments transpositeurs},
 769 @ref{Inversion},
 770 @ref{Transformations modales},
 771 @ref{Rétrogradation}.
 772
 773 Morceaux choisis :
 774 @rlsrnamed{Pitches, Hauteurs}.
 775
 776 Référence des propriété internes :
 777 @rinternals{TransposedMusic}.
 778
 779 @funindex \transpose
 780 @funindex transpose
 781 @funindex \chordmode
 782 @funindex chordmode
 783 @funindex \relative
 784 @funindex relative
 785
 786 @knownissues
 787 Si vous voulez utiliser en même temps @code{\transpose} et
 788 @code{\relative}, vous devez mettre @code{\transpose} en dehors de
 789 @code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
 790 musique apparaissant dans un @code{\transpose}.
 791
 792 La fonction @code{\transpose} ne permet pas d'imprimer des altérations
 793 triples ; elle les remplacera par un « équivalent enharmonique »
 794 -- par exemple ré bémol au lieu de mi triple bémol.
 795
 796
 797 @node Inversion
 798 @unnumberedsubsubsec Inversion
 799 @translationof Inversion
 800
 801 @cindex inversion
 802
 803 @funindex \inversion
 804
 805 Une expression musicale peut s'inverser et être transposée à l'aide de
 806 l'instruction
 807
 808 @example
 809 \inversion @var{hauteur-pivot} @var{hauteur-arrivée} @var{expression_musicale}
 810 @end example
 811
 812 L'@code{@var{expression_musicale}} sera alors inversée, intervalle par
 813 intervalle, puis transposée de telle sorte que
 814 @code{@var{hauteur-pivot}} devienne @code{@var{hauteur-arrivée}}.
 815
 816 @lilypond[verbatim,quote]
 817 music = \relative c' { c d e f }
 818 \new Staff {
 819   \music
 820   \inversion d' d' \music
 821   \inversion d' ees' \music
 822 }
 823 @end lilypond
 824
 825 @warning{Le motif à inverser doit être exprimé en hauteur absolue, à
 826 moins d'avoir été préalablement inclus explicitement dans un bloc
 827 @code{@bs{}relative}.}
 828
 829 @seealso
 830 Manuel de notation :
 831 @ref{Transformations modales},
 832 @ref{Rétrogradation},
 833 @ref{Transposition}.
 834
 835
 836 @node Rétrogradation
 837 @unnumberedsubsubsec Rétrogradation
 838 @translationof Retrograde
 839
 840 @cindex rétrograde, transformation
 841 @cindex transformation rétrograde
 842
 843 @funindex \retrograde
 844 @funindex retrograde
 845
 846 Une expression musicale peut se renverser et se présenter sous forme
 847 rétrograde :
 848
 849 @lilypond[verbatim,quote]
 850 music = \relative c' { c8. ees16( fis8. a16 b8.) gis16 f8. d16 }
 851
 852 \new Staff {
 853   \music
 854   \retrograde \music
 855 }
 856 @end lilypond
 857
 858 @knownissues
 859 Une liaison de prolongation à l'intérieur d'un bloc @code{\retrograde}
 860 sera de fait rompue, ce qui générera un message d'avertissement.
 861 Des liaisons de prolongation seront toutefois générées automatiquement
 862 dès lors qu'est activé le @ref{Découpage automatique des notes}.
 863
 864 @seealso
 865 Manuel de notation :
 866 @ref{Inversion},
 867 @ref{Transformations modales},
 868 @ref{Transposition}.
 869
 870
 871 @node Transformations modales
 872 @unnumberedsubsubsec Transformations modales
 873 @translationof Modal transformations
 874
 875 @cindex modales, transformations
 876
 877 Dans une composition basée sur une gamme, un même motif est transformé à
 878 plusieurs reprises et selon des schémas différents.  Il peut être
 879 @notation{transposé} pour partir de différents points de la gamme ou
 880 bien être @notation{inversé} à partir d'une note pivot dans la gamme.
 881 Il peut aussi être renversé pour produire une rétrogradation.
 882
 883 @warning{Toute note qui ne ferait pas partie de la gamme en question ne
 884 sera pas transformée.}
 885
 886
 887 @subsubheading Transposition modale
 888 @translationof Modal transposition
 889
 890 @cindex modale, transposition
 891
 892 @funindex \modalTranspose
 893 @funindex modalTranspose
 894
 895 Un motif peut se transposer selon une gamme donnée :
 896
 897 @example
 898 \modalTranspose @var{hauteur-départ} @var{hauteur-arrivée} @var{gamme} @var{motif}
 899 @end example
 900
 901 Les notes de @var{motif} seront décalées à l'intérieur de la @var{gamme}
 902 selon leur degré, déterminé par l'intervalle entre @var{hauteur-départ}
 903 et @var{hauteur-arrivée} :
 904
 905 @lilypond[verbatim,quote]
 906 diatonicScale = \relative c' { c d e f g a b }
 907 motif = \relative c' { c8 d e f g a b c }
 908
 909 \new Staff {
 910   \motif
 911   \modalTranspose c f \diatonicScale \motif
 912   \modalTranspose c b, \diatonicScale \motif
 913 }
 914 @end lilypond
 915
 916 Il est ainsi possible de déterminer une gamme ascendante, quels qu'en soient
 917 l'amplitude et les différents intervalles :
 918
 919 @lilypond[verbatim,quote]
 920 pentatonicScale = \relative c' { ges aes bes des ees }
 921 motif = \relative c' { ees8 des ges,4 <ges' bes,> <ges bes,> }
 922
 923 \new Staff {
 924   \motif
 925   \modalTranspose ges ees' \pentatonicScale \motif
 926 }
 927 @end lilypond
 928
 929 L'utilisation de @code{\modalTranspose} avec une gamme chromatique
 930 produit les mêmes effets qu'un @code{\transpose}, à ceci près que les
 931 notes seront alors prédéterminées :
 932
 933 @lilypond[verbatim,quote]
 934 chromaticScale = \relative c' { c cis d dis e f fis g gis a ais b }
 935 motif = \relative c' { c8 d e f g a b c }
 936
 937 \new Staff {
 938   \motif
 939   \transpose c f \motif
 940   \modalTranspose c f \chromaticScale \motif
 941 }
 942 @end lilypond
 943
 944
 945 @subsubheading Inversion modale
 946 @translationof Modal inversion
 947
 948 @cindex modale, inversion
 949
 950 @funindex \modalInversion
 951 @funindex modalInversion
 952
 953 Un motif peut s'inverser selon une certaine gamme et à partir d'un pivot
 954 déterminé, puis transposé, le tout en une seule opération :
 955
 956 @example
 957 \modalInversion @var{hauteur-pivot} @var{hauteur-arrivée} @var{gamme} @var{motif}
 958 @end example
 959
 960 Les notes de @var{motif} se retrouvent au même degré par rapport à
 961 @var{hauteur-pivot} dans la @var{gamme}, toutefois dans le sens opposé,
 962 puis décalées dans cette même @var{gamme} de l'intervalle séparant
 963 @var{hauteur-départ} et @var{hauteur-arrivée}.
 964
 965 Il est donc possible de simplement inverser à partir d'une des notes de
 966 la gamme en donnant la même valeur à @var{hauteur-départ} et
 967 @var{hauteur-arrivée} :
 968
 969 @lilypond[verbatim,quote]
 970 octatonicScale = \relative c' { ees f fis gis a b c d }
 971 motif = \relative c' { c8. ees16 fis8. a16 b8. gis16 f8. d16 }
 972
 973 \new Staff {
 974   \motif
 975   \modalInversion fis' fis' \octatonicScale \motif
 976 }
 977 @end lilypond
 978
 979 Pour permuter deux notes de la gamme, il suffit donc d'inverser à partir
 980 de l'une des notes et de transposer d'un degré de la gamme.  Les deux
 981 notes spécifiées peuvent s'interpréter comme étant les bornes du pivot.
 982
 983 @lilypond[verbatim,quote]
 984 scale = \relative c' { c g' }
 985 motive = \relative c' { c c g' c, }
 986
 987 \new Staff {
 988   \motive
 989   \modalInversion c' g' \scale \motive
 990 }
 991 @end lilypond
 992
 993 L'opération conjointe d'une inversion et d'une rétrogradation produit
 994 une rétrogradation inversée :
 995
 996 @lilypond[verbatim,quote]
 997 octatonicScale = \relative c' { ees f fis gis a b c d }
 998 motif = \relative c' { c8. ees16 fis8. a16 b8. gis16 f8. d16 }
 999
1000 \new Staff {
1001   \motif
1002   \retrograde \modalInversion c' c' \octatonicScale \motif
1003 }
1004 @end lilypond
1005
1006 @seealso
1007 Manuel de notation :
1008 @ref{Inversion},
1009 @ref{Rétrogradation},
1010 @ref{Transposition}.
1011
1012
1013 @node Gravure des hauteurs
1014 @subsection Gravure des hauteurs
1015 @translationof Displaying pitches
1016
1017 Nous allons voir dans cette partie comment influer sur la gravure des
1018 hauteurs.
1019
1020 @menu
1021 * Clefs::
1022 * Armure::
1023 * Marques d'octaviation::
1024 * Instruments transpositeurs::
1025 * Altérations accidentelles automatiques::
1026 * Ambitus::
1027 @end menu
1028
1029
1030 @node Clefs
1031 @unnumberedsubsubsec Clefs
1032 @translationof Clef
1033
1034 @cindex clé de sol
1035 @cindex clé de fa
1036 @cindex clé d'ut
1037 @cindex clés anciennes
1038
1039 @funindex \clef
1040 @funindex clef
1041
1042 La clef indique quelles lignes de la portée correspondent à quelles
1043 hauteurs.  Elle peut changer au fil du morceau, comme dans l'exemple
1044 suivant qui indique le do médium dans différentes clefs :
1045
1046 @lilypond[verbatim,quote,relative=1]
1047 \clef treble
1048 c2 c
1049 \clef alto
1050 c2 c
1051 \clef tenor
1052 c2 c
1053 \clef bass
1054 c2 c
1055 @end lilypond
1056
1057 LilyPond met à votre disposition d'autres clefs :
1058
1059 @lilypond[verbatim,quote,relative=1]
1060 \clef french
1061 c2 c
1062 \clef soprano
1063 c2 c
1064 \clef mezzosoprano
1065 c2 c
1066 \clef baritone
1067 c2 c
1068
1069 \break
1070
1071 \clef varbaritone
1072 c2 c
1073 \clef subbass
1074 c2 c
1075 \clef percussion
1076 c2 c
1077
1078 \break
1079
1080 \clef G   % synonym for treble
1081 c2 c
1082 \clef F   % synonym for bass
1083 c2 c
1084 \clef C   % synonym for alto
1085 c2 c
1086 @end lilypond
1087
1088 @cindex transposition et clef
1089 @cindex clef et transposition
1090 @cindex octave et clef
1091 @cindex chorale, clef de ténor
1092 @cindex ténor, clef
1093
1094 En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
1095 transposée à l'octave respectivement inférieure ou supérieure, et
1096 @code{_15} ou @code{^15} la transpose de deux octaves.  D'autres nombres
1097 entiers peuvent être utilisés selon les besoins.  L'argument
1098 @var{clefname} doit être mis entre guillemets lorsqu'il contient des
1099 caractères supplémentaires.  Par exemple,
1100
1101 @lilypond[verbatim,quote,relative=1]
1102 \clef treble
1103 c2 c
1104 \clef "treble_8"
1105 c2 c
1106 \clef "bass^15"
1107 c2 c
1108 \clef "alto_2"
1109 c2 c
1110 \clef "G_8"
1111 c2 c
1112 \clef "F^5"
1113 c2 c
1114 @end lilypond
1115
1116 Il existe d'autres clefs, destinées à un usage particulier.  Voir à ce
1117 sujet @ref{Notations anciennes}, @ref{Clefs anciennes},
1118 @ref{Clefs grégoriennes}, @ref{Tablatures par défaut} et @ref{Tablatures
1119 personnalisées}.  La nécessité de recourir à d'autres clefs dans le cas
1120 où la partition comprend des petites notes est abordée au chapitre
1121 @ref{Mise en forme d'une citation} -- voir les fonctions @code{\cueClef}
1122 et @code{\cueDuringWithClef}.
1123
1124 @snippets
1125 @lilypondfile[verbatim,quote,texidoc,doctitle]
1126 {tweaking-clef-properties.ly}
1127
1128 @seealso
1129 Manuel de notation :
1130 @ref{Notations anciennes},
1131 @ref{Clefs anciennes},
1132 @ref{Clefs grégoriennes},
1133 @ref{Mise en forme d'une citation},
1134 @ref{Tablatures par défaut},
1135 @ref{Tablatures personnalisées}.
1136
1137 Morceaux choisis:
1138 @rlsrnamed{Pitches,Hauteurs}.
1139
1140 Référence des propriétés internes :
1141 @rinternals{Clef_engraver},
1142 @rinternals{Clef},
1143 @rinternals{OctavateEight},
1144 @rinternals{clef-interface}.
1145
1146
1147 @node Armure
1148 @unnumberedsubsubsec Armure
1149 @translationof Key signature
1150
1151 @cindex armure
1152
1153 @funindex \key
1154 @funindex key
1155
1156 @c duplicated in Key signature and in Accidentals
1157 @warning{Les nouveaux utilisateurs sont parfois déroutés par la gestion
1158 des altérations et de l'armure.  Pour LilyPond, une hauteur n'est que du
1159 matériau brut ; l'armure et la clef ne feront que déterminer
1160 comment ce matériau sera retranscrit.  Un simple @code{c} signifie
1161 tout bonnement « do naturel » quelles que soient l'armure et la
1162 clef en question.  Pour plus d'information, reportez-vous au chapitre
1163 @rlearning{Altérations et armure}.}
1164
1165 L'armure indique la tonalité dans laquelle la pièce doit être jouée.
1166 Elle comprend un ensemble d'altérations (dièses ou bémols) à la clef,
1167 c'est-à-dire au début de la portée.  Elle peut varier en cours de
1168 morceau.
1169
1170 On définit ou modifie l'armure avec la commande @code{\key}
1171
1172 @example
1173 \key @var{hauteur} @var{mode}
1174 @end example
1175
1176 @funindex \major
1177 @funindex major
1178 @funindex \minor
1179 @funindex minor
1180 @funindex \ionian
1181 @funindex ionian
1182 @funindex \locrian
1183 @funindex locrian
1184 @funindex \aeolian
1185 @funindex aeolian
1186 @funindex \mixolydian
1187 @funindex mixolydian
1188 @funindex \lydian
1189 @funindex lydian
1190 @funindex \phrygian
1191 @funindex phrygian
1192 @funindex \dorian
1193 @funindex dorian
1194
1195 @cindex modes anciens
1196 @cindex modes
1197 @cindex majeur
1198 @cindex mineur
1199 @cindex ionien
1200 @cindex locrien
1201 @cindex éolien
1202 @cindex mixolydien
1203 @cindex lydien
1204 @cindex phrygien
1205 @cindex dorien
1206
1207 @noindent
1208 Ici, @code{@var{mode}} doit être @code{\major} ou @code{\minor} afin
1209 d'avoir respectivement @var{hauteur}-majeur ou @var{hauteur}-mineur.
1210 Vous pouvez aussi avoir recours aux modes anciens que sont
1211 @code{\ionian}, @code{\locrian}, @code{\aeolian}, @code{\mixolydian},
1212 @code{\lydian}, @code{\phrygian} et @code{\dorian}.
1213
1214 @lilypond[verbatim,quote,relative=2]
1215 \key g \major
1216 fis1
1217 f
1218 fis
1219 @end lilypond
1220
1221 @snippets
1222 @lilypondfile[verbatim,quote,texidoc,doctitle]
1223 {preventing-natural-signs-from-being-printed-when-the-key-signature-changes.ly}
1224
1225 @lilypondfile[verbatim,quote,texidoc,doctitle]
1226 {non-traditional-key-signatures.ly}
1227
1228 @seealso
1229 Glossaire musicologique :
1230 @rglosnamed{church mode,mode d'église},
1231 @rglos{scordatura}.
1232
1233 Manuel d'initiation :
1234 @rlearning{Altérations et armure}.
1235
1236 Morceaux choisis :
1237 @rlsrnamed{Pitches,Hauteurs}.
1238
1239 Référence des propriétés internes :
1240 @rinternals{KeyChangeEvent},
1241 @rinternals{Key_engraver},
1242 @rinternals{Key_performer},
1243 @rinternals{KeyCancellation},
1244 @rinternals{KeySignature},
1245 @rinternals{key-cancellation-interface},
1246 @rinternals{key-signature-interface}.
1247
1248
1249 @node Marques d'octaviation
1250 @unnumberedsubsubsec Marques d'octaviation
1251 @translationof Ottava brackets
1252
1253 @cindex ottava
1254 @cindex 15ma
1255 @cindex 8va
1256 @cindex 8ve
1257 @cindex octaviation
1258
1259 @funindex set-octavation
1260 @funindex \ottava
1261 @funindex ottava
1262
1263 Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
1264 transposition spécifique d'une octave pour la portée en cours.  C'est
1265 la fonction @code{ottava} qui s'en charge.
1266
1267 @lilypond[verbatim,quote,relative=2]
1268 a2 b
1269 \ottava #-2
1270 a2 b
1271 \ottava #-1
1272 a2 b
1273 \ottava #0
1274 a2 b
1275 \ottava #1
1276 a2 b
1277 \ottava #2
1278 a2 b
1279 @end lilypond
1280
1281 @snippets
1282 @lilypondfile[verbatim,quote,texidoc,doctitle]
1283 {ottava-text.ly}
1284
1285 @seealso
1286 Glossaire musicologique :
1287 @rglosnamed{octavation,octaviation}.
1288
1289 Morceaux choisis :
1290 @rlsrnamed{Pitches,Hauteurs}.
1291
1292 Référence des propriétés internes :
1293 @rinternals{Ottava_spanner_engraver},
1294 @rinternals{OttavaBracket},
1295 @rinternals{ottava-bracket-interface}.
1296
1297
1298 @node Instruments transpositeurs
1299 @unnumberedsubsubsec Instruments transpositeurs
1300 @translationof Instrument transpositions
1301
1302 @cindex transposition et MIDI
1303 @cindex MIDI et transposition
1304 @cindex transposition, instrument
1305
1306 @funindex \transposition
1307 @funindex transposition
1308
1309 Lorsque l'on saisit une partition d'ensemble incluant des instruments
1310 transpositeurs, certaines parties peuvent être dans une autre tonalité
1311 que la @notation{tonalité de concert}.  Il faudra en pareil cas indiquer
1312 la tonalité spécifique de ces @notation{instruments transpositeurs},
1313 sous peine de fichier MIDI erroné et de citations incorrectes.  Pour
1314 plus de détails sur les citations, consultez le chapitre
1315 @ref{Citation d'autres voix}.
1316
1317 @example
1318 \transposition @var{hauteur}
1319 @end example
1320
1321 La hauteur donnée en argument à @code{\transposition} doit
1322 correspondre à la note entendue lorsqu'un @code{do} écrit sur la
1323 portée est joué par l'instrument transpositeur.  Cette hauteur doit être
1324 mentionnée en @notation{mode absolu}.  Par exemple, lorsque
1325 vous saisissez une partition en notes réelles, toutes les voix
1326 devraient être en ut ; si un instrument joue un ton au dessus, il
1327 faudra lui ajouter un @w{@code{\transposition d'}}.  La commande
1328 @code{\transposition} s'utilise @strong{si et seulement si} les notes à
1329 saisir @strong{ne sont pas} dans la tonalité de concert.
1330
1331 Voici un fragment pour violon et clarinette en si bémol (@emph{B-flat})
1332 pour lequel les parties respectives ont été recopiées à partir du
1333 conducteur.  Les deux instruments sont à l'unisson.
1334
1335 @lilypond[verbatim,quote]
1336 \new GrandStaff <<
1337   \new Staff = "violin" {
1338     \relative c'' {
1339       \set Staff.instrumentName = #"Vln"
1340       \set Staff.midiInstrument = #"violin"
1341       % not strictly necessary, but a good reminder
1342       \transposition c'
1343
1344       \key c \major
1345       g4( c8) r c r c4
1346     }
1347   }
1348   \new Staff = "clarinet" {
1349     \relative c'' {
1350       \set Staff.instrumentName = \markup { Cl (B\flat) }
1351       \set Staff.midiInstrument = #"clarinet"
1352       \transposition bes
1353
1354       \key d \major
1355       a4( d8) r d r d4
1356     }
1357   }
1358 >>
1359 @end lilypond
1360
1361 La @code{\transposition} peut évoluer au cours d'un morceau.  Un
1362 clarinettiste peut être amené à jongler avec une clarinette en la et
1363 une autre en si bémol.
1364
1365 @lilypond[verbatim,quote,relative=2]
1366 \set Staff.instrumentName = #"Cl (A)"
1367 \key a \major
1368 \transposition a
1369 c d e f
1370 \textLengthOn
1371 <>^\markup { Switch to B\flat clarinet }
1372 R1
1373
1374 \key bes \major
1375 \transposition bes
1376 c2 g
1377 @end lilypond
1378
1379 @seealso
1380 Glossaire musicologique :
1381 @rglosnamed{concert pitch,tonalité de concert},
1382 @rglosnamed{transposing instrument,instrument transpositeur}.
1383
1384 Manuel de notation :
1385 @ref{Citation d'autres voix},
1386 @ref{Transposition}.
1387
1388 Morceaux choisis :
1389 @rlsrnamed{Pitches,Hauteurs}.
1390
1391
1392 @node Altérations accidentelles automatiques
1393 @unnumberedsubsubsec Altérations accidentelles automatiques
1394 @translationof Automatic accidentals
1395
1396 @cindex altération, style
1397 @cindex altération, style par défaut
1398 @cindex accidentelles, altérations
1399 @cindex accidentelles automatiques
1400 @cindex automatiques, altérations accidentelles
1401 @cindex style d'accidentelle
1402
1403 @funindex \accidentalStyle
1404 @funindex voice
1405 @funindex default
1406
1407 LilyPond dispose d'une fonction chargée de regrouper les règles suivant
1408 lesquelles s'impriment les altérations.  Elle s'invoque de la manière
1409 suivante :
1410
1411 @example
1412 \new Staff <<
1413   \accidentalStyle "voice"
1414   @{ @dots{} @}
1415 >>
1416 @end example
1417
1418 La règle de gestion des altérations s'applique par défaut au contexte
1419 @code{Staff} en cours, exception faite des styles @code{piano} et
1420 @code{piano-cautionary} comme nous allons le voir.  Cette fonction
1421 accepte un éventuel argument supplémentaire chargé de spécifier
1422 le champ d'action de la règle à suivre.  À titre d'exemple, il faudra
1423 utiliser, pour que toutes les portées d'un même système -- contexte
1424 @code{StaffGroup} -- soient soumises à la même règle :
1425
1426 @example
1427 \accidentalStyle #'StaffGroup "voice"
1428 @end example
1429
1430 Nous vous présentons ci-après les différentes règles d'altération prises
1431 en charge.  Pour les besoins de la démonstration, nous partirons de
1432 l'exemple suivant :
1433
1434 @lilypond[verbatim,quote]
1435 musicA = {
1436   <<
1437     \relative c' {
1438       cis'8 fis, bes4 <a cis>8 f bis4 |
1439       cis2. <c, g'>4 |
1440     }
1441     \\
1442     \relative c' {
1443       ais'2 cis, |
1444       fis8 b a4 cis2 |
1445     }
1446   >>
1447 }
1448
1449 musicB = {
1450   \clef bass
1451   \new Voice {
1452     \voiceTwo \relative c' {
1453       <fis, a cis>8[ <fis a cis>
1454       \change Staff = up
1455       cis' cis
1456       \change Staff = down
1457       <fis, a> <fis a>]
1458       \showStaffSwitch
1459       \change Staff = up
1460       dis'4 |
1461       \change Staff = down
1462       <fis, a cis>4 gis <f a d>2 |
1463     }
1464   }
1465 }
1466
1467 \new PianoStaff {
1468   <<
1469     \context Staff = "up" {
1470       \accidentalStyle "default"
1471       \musicA
1472     }
1473     \context Staff = "down" {
1474       \accidentalStyle "default"
1475       \musicB
1476     }
1477   >>
1478 }
1479 @end lilypond
1480
1481 Notez bien que pour appliquer le même style aux deux portées, seules les
1482 dernières lignes de cet exemple nous intéressent.
1483
1484 @example
1485 \new PianoStaff @{
1486   <<
1487     \context Staff = "haut" @{
1488       %%% voici la ligne à modifier en conséquence :
1489       \accidentalStyle #'Score "default"
1490       \musicA
1491     @}
1492     \context Staff = "bas" @{
1493       \musicB
1494     @}
1495   >>
1496 @}
1497 @end example
1498
1499
1500 @c don't use verbatim in this table.
1501 @table @code
1502 @item default
1503
1504 @cindex @emph{default}, style d'altérations
1505 @cindex altérations, style @emph{default}
1506
1507 @funindex default
1508
1509 C'est la règle d'impression par défaut, qui se rapporte à l'usage
1510 en vigueur au XVIIIe siècle : les altérations accidentelles sont
1511 valables tout une mesure, et uniquement à leur propre octave.  C'est la
1512 raison pour laquelle il n'y a pas de bécarre avant le @notation{si} de
1513 la deuxième mesure, ni avant le dernier @notation{do}.
1514
1515 @lilypond[quote]
1516 musicA = {
1517   <<
1518     \relative c' {
1519       cis'8 fis, bes4 <a cis>8 f bis4 |
1520       cis2. <c, g'>4 |
1521     }
1522     \\
1523     \relative c' {
1524       ais'2 cis, |
1525       fis8 b a4 cis2 |
1526     }
1527   >>
1528 }
1529
1530 musicB = {
1531   \clef bass
1532   \new Voice {
1533     \voiceTwo \relative c' {
1534       <fis, a cis>8[ <fis a cis>
1535       \change Staff = up
1536       cis' cis
1537       \change Staff = down
1538       <fis, a> <fis a>]
1539       \showStaffSwitch
1540       \change Staff = up
1541       dis'4 |
1542       \change Staff = down
1543       <fis, a cis>4 gis <f a d>2 |
1544     }
1545   }
1546 }
1547
1548 \new PianoStaff {
1549   <<
1550     \context Staff = "up" {
1551       \accidentalStyle "default"
1552       \musicA
1553     }
1554     \context Staff = "down" {
1555       \accidentalStyle "default"
1556       \musicB
1557     }
1558   >>
1559 }
1560 @end lilypond
1561
1562 @item voice
1563
1564 @cindex @emph{voice}, style d'altérations
1565 @cindex altérations, style @emph{voice}
1566 @cindex altérations, style @emph{modern}
1567 @cindex @emph{modern}, style d'altération
1568 @cindex altérations, style @emph{modern-cautionary}
1569 @cindex @emph{modern-cautionary}, style d'altération
1570
1571 @funindex voice
1572
1573 En principe, LilyPond se souvient de toutes les altérations présentes
1574 sur la portée (contexte @code{Staff}).  Avec cette règle, cependant, les
1575 altérations sont indépendantes pour chacune des voix tout en obéissant
1576 à la règle @code{default}.
1577
1578 Les altérations d'une voix sont de fait ignorées dans les autres
1579 voix, ce qui peut donner lieu à un résultat malencontreux.  Dans
1580 l'exemple suivant, il est difficile de dire si le deuxième @notation{la}
1581 est dièse ou naturel.  La règle @code{voice} n'est donc à envisager que
1582 dans le cas de voix devant être lues par des musiciens différents.  S'il
1583 s'agit d'un « conducteur », ou d'une portée destinée à un seul
1584 musicien, il vaut mieux utiliser @code{modern} ou
1585 @code{modern-cautionary}.
1586
1587 @lilypond[quote]
1588 musicA = {
1589   <<
1590     \relative c' {
1591       cis'8 fis, bes4 <a cis>8 f bis4 |
1592       cis2. <c, g'>4 |
1593     }
1594     \\
1595     \relative c' {
1596       ais'2 cis, |
1597       fis8 b a4 cis2 |
1598     }
1599   >>
1600 }
1601
1602 musicB = {
1603   \clef bass
1604   \new Voice {
1605     \voiceTwo \relative c' {
1606       <fis, a cis>8[ <fis a cis>
1607       \change Staff = up
1608       cis' cis
1609       \change Staff = down
1610       <fis, a> <fis a>]
1611       \showStaffSwitch
1612       \change Staff = up
1613       dis'4 |
1614       \change Staff = down
1615       <fis, a cis>4 gis <f a d>2 |
1616     }
1617   }
1618 }
1619
1620 \new PianoStaff {
1621   <<
1622     \context Staff = "up" {
1623       \accidentalStyle "voice"
1624       \musicA
1625     }
1626     \context Staff = "down" {
1627       \accidentalStyle "voice"
1628       \musicB
1629     }
1630   >>
1631 }
1632 @end lilypond
1633
1634 @item modern
1635
1636 @cindex altération, style @emph{modern}
1637 @cindex @emph{modern}, style d'altération
1638
1639 @funindex modern
1640
1641 Cette règle est la plus courante au XXe siècle.  Certains bécarres ne
1642 sont pas imprimés, comme il était d'usage lorsqu'une note diésée suit
1643 cette même note flanquée d'un double dièse, ou bien un bémol un double
1644 bémol.  Le style @code{modern} suit la même règle que le style
1645 @code{default}, avec deux additions afin de lever les ambiguïtés :
1646 lorsqu'une note non altérée apparaît à une octave différente, ou bien
1647 dans la mesure suivante, des bécarres de précaution sont ajoutés.  Dans
1648 l'exemple suivant, notez ainsi les deux bécarres dans la deuxième mesure
1649 de la main droite.
1650
1651 @lilypond[quote]
1652 musicA = {
1653   <<
1654     \relative c' {
1655       cis'8 fis, bes4 <a cis>8 f bis4 |
1656       cis2. <c, g'>4 |
1657     }
1658     \\
1659     \relative c' {
1660       ais'2 cis, |
1661       fis8 b a4 cis2 |
1662     }
1663   >>
1664 }
1665
1666 musicB = {
1667   \clef bass
1668   \new Voice {
1669     \voiceTwo \relative c' {
1670       <fis, a cis>8[ <fis a cis>
1671       \change Staff = up
1672       cis' cis
1673       \change Staff = down
1674       <fis, a> <fis a>]
1675       \showStaffSwitch
1676       \change Staff = up
1677       dis'4 |
1678       \change Staff = down
1679       <fis, a cis>4 gis <f a d>2 |
1680     }
1681   }
1682 }
1683
1684 \new PianoStaff {
1685   <<
1686     \context Staff = "up" {
1687       \accidentalStyle "modern"
1688       \musicA
1689     }
1690     \context Staff = "down" {
1691       \accidentalStyle "modern"
1692       \musicB
1693     }
1694   >>
1695 }
1696 @end lilypond
1697
1698 @item modern-cautionary
1699
1700 @cindex altération, style @emph{modern cautionary}
1701 @cindex @emph{modern cautionary}, style d'altération
1702 @cindex altération de précaution, style @emph{modern}
1703 @cindex @emph{modern}, style d'altération de précaution
1704
1705 @funindex modern-cautionary
1706
1707 Cette règle est équivalente à @code{modern}, mais les bécarres de
1708 précaution (absents dans la règle @code{default}) sont imprimés de façon
1709 particulière : soit plus petit, soit (par défaut) entre parenthèses
1710 -- il est possible de le définir au moyen de la propriété
1711 @code{cautionary-style} de l'objet @code{AccidentalSuggestion}.
1712
1713 @lilypond[quote]
1714 musicA = {
1715   <<
1716     \relative c' {
1717       cis'8 fis, bes4 <a cis>8 f bis4 |
1718       cis2. <c, g'>4 |
1719     }
1720     \\
1721     \relative c' {
1722       ais'2 cis, |
1723       fis8 b a4 cis2 |
1724     }
1725   >>
1726 }
1727
1728 musicB = {
1729   \clef bass
1730   \new Voice {
1731     \voiceTwo \relative c' {
1732       <fis, a cis>8[ <fis a cis>
1733       \change Staff = up
1734       cis' cis
1735       \change Staff = down
1736       <fis, a> <fis a>]
1737       \showStaffSwitch
1738       \change Staff = up
1739       dis'4 |
1740       \change Staff = down
1741       <fis, a cis>4 gis <f a d>2 |
1742     }
1743   }
1744 }
1745
1746 \new PianoStaff {
1747   <<
1748     \context Staff = "up" {
1749       \accidentalStyle "modern-cautionary"
1750       \musicA
1751     }
1752     \context Staff = "down" {
1753       \accidentalStyle "modern-cautionary"
1754       \musicB
1755     }
1756   >>
1757 }
1758 @end lilypond
1759
1760 @item modern-voice
1761
1762 @cindex @emph{modern}, style d'altération
1763 @cindex style d'altération @emph{modern}
1764 @cindex altérations multivoix
1765 @cindex style d'altération @emph{modern accidental}
1766 @cindex voix multiples et altérations
1767 @cindex multivoix, altérations
1768
1769 @funindex modern-voice
1770
1771 Cette règle sert aux altérations dans de la musique polyphonique destinée
1772 autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble
1773 des voix.  Les altérations sont imprimées voix par voix, mais les autres
1774 voix d'un même contexte @code{Staff} en @emph{tiennent compte}
1775 cette fois.  C'est pourquoi le @notation{la} de la dernière mesure est
1776 affublé d'un bécarre bien qu'il y en ait déjà eu un dans la mesure
1777 précédente, et que le @notation{ré} de la main gauche en ait un alors
1778 que le dièse qu'il avait auparavant concernait la main droite.
1779
1780 @lilypond[quote]
1781 musicA = {
1782   <<
1783     \relative c' {
1784       cis'8 fis, bes4 <a cis>8 f bis4 |
1785       cis2. <c, g'>4 |
1786     }
1787     \\
1788     \relative c' {
1789       ais'2 cis, |
1790       fis8 b a4 cis2 |
1791     }
1792   >>
1793 }
1794
1795 musicB = {
1796   \clef bass
1797   \new Voice {
1798     \voiceTwo \relative c' {
1799       <fis, a cis>8[ <fis a cis>
1800       \change Staff = up
1801       cis' cis
1802       \change Staff = down
1803       <fis, a> <fis a>]
1804       \showStaffSwitch
1805       \change Staff = up
1806       dis'4 |
1807       \change Staff = down
1808       <fis, a cis>4 gis <f a d>2 |
1809     }
1810   }
1811 }
1812
1813 \new PianoStaff {
1814   <<
1815     \context Staff = "up" {
1816       \accidentalStyle "modern-voice"
1817       \musicA
1818     }
1819     \context Staff = "down" {
1820       \accidentalStyle "modern-voice"
1821       \musicB
1822     }
1823   >>
1824 }
1825 @end lilypond
1826
1827 @item modern-voice-cautionary
1828
1829 @cindex altération de précaution style @emph{modern voice}
1830 @cindex @emph{modern voice}, style d'altération de précaution
1831
1832 @funindex modern-voice-cautionary
1833
1834 Cette règle est similaire à la précédente, mais les altérations de
1835 précaution (celles que n'aurait pas ajoutées @code{voice}), sont
1836 imprimées de façon particulière.  On retrouve donc toutes les
1837 altérations qu'imprimerait @code{default}, mais certaines sont
1838 considérées comme étant « de précaution ».
1839
1840 @lilypond[quote]
1841 musicA = {
1842   <<
1843     \relative c' {
1844       cis'8 fis, bes4 <a cis>8 f bis4 |
1845       cis2. <c, g'>4 |
1846     }
1847     \\
1848     \relative c' {
1849       ais'2 cis, |
1850       fis8 b a4 cis2 |
1851     }
1852   >>
1853 }
1854
1855 musicB = {
1856   \clef bass
1857   \new Voice {
1858     \voiceTwo \relative c' {
1859       <fis, a cis>8[ <fis a cis>
1860       \change Staff = up
1861       cis' cis
1862       \change Staff = down
1863       <fis, a> <fis a>]
1864       \showStaffSwitch
1865       \change Staff = up
1866       dis'4 |
1867       \change Staff = down
1868       <fis, a cis>4 gis <f a d>2 |
1869     }
1870   }
1871 }
1872
1873 \new PianoStaff {
1874   <<
1875     \context Staff = "up" {
1876       \accidentalStyle "modern-voice-cautionary"
1877       \musicA
1878     }
1879     \context Staff = "down" {
1880       \accidentalStyle "modern-voice-cautionary"
1881       \musicB
1882     }
1883   >>
1884 }
1885 @end lilypond
1886
1887 @item piano
1888
1889 @cindex @emph{piano}, style d'altérations
1890 @cindex altérations style @emph{piano}
1891 @cindex piano et altérations
1892
1893 @funindex piano
1894
1895 Cette règle est communément employée pour les partitions de piano au
1896 XXe siècle.  Très similaire à @code{modern} de par son comportement,
1897 elle s'en distingue en ce que les altérations tiennent compte des autre
1898 portées du contexte @code{GrandStaff} ou @code{PianoStaff}.
1899
1900 Cette règle s'applique par défaut dans un @code{GrandStaff} et dans un
1901 @code{PianoStaff}.
1902
1903 @lilypond[quote]
1904 musicA = {
1905   <<
1906     \relative c' {
1907       cis'8 fis, bes4 <a cis>8 f bis4 |
1908       cis2. <c, g'>4 |
1909     }
1910     \\
1911     \relative c' {
1912       ais'2 cis, |
1913       fis8 b a4 cis2 |
1914     }
1915   >>
1916 }
1917
1918 musicB = {
1919   \clef bass
1920   \new Voice {
1921     \voiceTwo \relative c' {
1922       <fis, a cis>8[ <fis a cis>
1923       \change Staff = up
1924       cis' cis
1925       \change Staff = down
1926       <fis, a> <fis a>]
1927       \showStaffSwitch
1928       \change Staff = up
1929       dis'4 |
1930       \change Staff = down
1931       <fis, a cis>4 gis <f a d>2 |
1932     }
1933   }
1934 }
1935
1936 \new PianoStaff {
1937   <<
1938     \context Staff = "up" {
1939       \accidentalStyle "piano"
1940       \musicA
1941     }
1942     \context Staff = "down" {
1943       \musicB
1944     }
1945   >>
1946 }
1947 @end lilypond
1948
1949 @item piano-cautionary
1950
1951 @cindex @emph{piano cautionary}, style d'altérations
1952 @cindex altérations style @emph{piano cautionary}
1953 @cindex piano et altérations
1954
1955 @funindex piano-cautionary
1956
1957 Identique au style @code{piano}, mais les altérations de précaution sont
1958 imprimées différemment.
1959
1960 @lilypond[quote]
1961 musicA = {
1962   <<
1963     \relative c' {
1964       cis'8 fis, bes4 <a cis>8 f bis4 |
1965       cis2. <c, g'>4 |
1966     }
1967     \\
1968     \relative c' {
1969       ais'2 cis, |
1970       fis8 b a4 cis2 |
1971     }
1972   >>
1973 }
1974
1975 musicB = {
1976   \clef bass
1977   \new Voice {
1978     \voiceTwo \relative c' {
1979       <fis, a cis>8[ <fis a cis>
1980       \change Staff = up
1981       cis' cis
1982       \change Staff = down
1983       <fis, a> <fis a>]
1984       \showStaffSwitch
1985       \change Staff = up
1986       dis'4 |
1987       \change Staff = down
1988       <fis, a cis>4 gis <f a d>2 |
1989     }
1990   }
1991 }
1992
1993 \new PianoStaff {
1994   <<
1995     \context Staff = "up" {
1996       \accidentalStyle "piano-cautionary"
1997       \musicA
1998     }
1999     \context Staff = "down" {
2000       \musicB
2001     }
2002   >>
2003 }
2004 @end lilypond
2005
2006 @item neo-modern
2007
2008 @cindex @emph{neo-modern}, style d'altérations
2009 @cindex altérations, style @emph{neo-modern}
2010
2011 @funindex neo-modern
2012
2013 Cette règle suit les pratiques de la musique contemporaine : les
2014 altérations accidentelles apparaissent comme dans le style
2015 @code{modern}, à ceci près qu'elles sont répétées dans la même mesure --
2016 sauf si elles concernent deux notes consécutives.
2017
2018 @lilypond[quote]
2019 musicA = {
2020   <<
2021     \relative c' {
2022       cis'8 fis, bes4 <a cis>8 f bis4 |
2023       cis2. <c, g'>4 |
2024     }
2025     \\
2026     \relative c' {
2027       ais'2 cis, |
2028       fis8 b a4 cis2 |
2029     }
2030   >>
2031 }
2032
2033 musicB = {
2034   \clef bass
2035   \new Voice {
2036     \voiceTwo \relative c' {
2037       <fis, a cis>8[ <fis a cis>
2038       \change Staff = up
2039       cis' cis
2040       \change Staff = down
2041       <fis, a> <fis a>]
2042       \showStaffSwitch
2043       \change Staff = up
2044       dis'4 |
2045       \change Staff = down
2046       <fis, a cis>4 gis <f a d>2 |
2047     }
2048   }
2049 }
2050
2051 \new PianoStaff {
2052   <<
2053     \context Staff = "up" {
2054       \accidentalStyle "neo-modern"
2055       \musicA
2056     }
2057     \context Staff = "down" {
2058       \accidentalStyle "neo-modern"
2059       \musicB
2060     }
2061   >>
2062 }
2063 @end lilypond
2064
2065 @item neo-modern-cautionary
2066
2067 @cindex @emph{neo-modern-cautionary}, style d'altérations
2068 @cindex style d'altération @emph{neo-modern-cautionary}
2069
2070 @funindex neo-modern-cautionary
2071
2072 Identique au style @code{neo-modern}, mais les altérations de précaution
2073 sont imprimées différemment.
2074
2075 @lilypond[quote]
2076 musicA = {
2077   <<
2078     \relative c' {
2079       cis'8 fis, bes4 <a cis>8 f bis4 |
2080       cis2. <c, g'>4 |
2081     }
2082     \\
2083     \relative c' {
2084       ais'2 cis, |
2085       fis8 b a4 cis2 |
2086     }
2087   >>
2088 }
2089
2090 musicB = {
2091   \clef bass
2092   \new Voice {
2093     \voiceTwo \relative c' {
2094       <fis, a cis>8[ <fis a cis>
2095       \change Staff = up
2096       cis' cis
2097       \change Staff = down
2098       <fis, a> <fis a>]
2099       \showStaffSwitch
2100       \change Staff = up
2101       dis'4 |
2102       \change Staff = down
2103       <fis, a cis>4 gis <f a d>2 |
2104     }
2105   }
2106 }
2107
2108 \new PianoStaff {
2109   <<
2110     \context Staff = "up" {
2111       \accidentalStyle "neo-modern-cautionary"
2112       \musicA
2113     }
2114     \context Staff = "down" {
2115       \accidentalStyle "neo-modern-cautionary"
2116       \musicB
2117     }
2118   >>
2119 }
2120 @end lilypond
2121
2122 @item neo-modern-voice
2123
2124 @cindex @emph{neo-modern-voice}, style d'altération
2125 @cindex style d'altération @emph{neo-modern-voice}
2126 @cindex altérations multivoix
2127 @cindex voix multiples et altérations
2128 @cindex multivoix, altérations
2129
2130 @funindex neo-modern-voice
2131
2132 Cette règle sert aux altérations dans de la musique polyphonique destinée
2133 autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble
2134 des voix.  Les altérations sont imprimées voix par voix comme avec le style
2135 @code{neo-modern} mais les autres voix dans le même contexte @code{Staff}
2136 en tiennent aussi compte.
2137
2138 @lilypond[quote]
2139 musicA = {
2140   <<
2141     \relative c' {
2142       cis'8 fis, bes4 <a cis>8 f bis4 |
2143       cis2. <c, g'>4 |
2144     }
2145     \\
2146     \relative c' {
2147       ais'2 cis, |
2148       fis8 b a4 cis2 |
2149     }
2150   >>
2151 }
2152
2153 musicB = {
2154   \clef bass
2155   \new Voice {
2156     \voiceTwo \relative c' {
2157       <fis, a cis>8[ <fis a cis>
2158       \change Staff = up
2159       cis' cis
2160       \change Staff = down
2161       <fis, a> <fis a>]
2162       \showStaffSwitch
2163       \change Staff = up
2164       dis'4 |
2165       \change Staff = down
2166       <fis, a cis>4 gis <f a d>2 |
2167     }
2168   }
2169 }
2170
2171 \new PianoStaff {
2172   <<
2173     \context Staff = "up" {
2174       \accidentalStyle "neo-modern-voice"
2175       \musicA
2176     }
2177     \context Staff = "down" {
2178       \accidentalStyle "neo-modern-voice"
2179       \musicB
2180     }
2181   >>
2182 }
2183 @end lilypond
2184
2185 @item neo-modern-voice-cautionary
2186
2187 @funindex neo-modern-voice-cautionary
2188
2189 Cette règle est identique à @code{neo-modern-voice},
2190 mais les altérations de précaution sont imprimées
2191 soit entre parenthèses (par défaut), soit en plus petit.
2192
2193 @lilypond[quote]
2194 musicA = {
2195   <<
2196     \relative c' {
2197       cis'8 fis, bes4 <a cis>8 f bis4 |
2198       cis2. <c, g'>4 |
2199     }
2200     \\
2201     \relative c' {
2202       ais'2 cis, |
2203       fis8 b a4 cis2 |
2204     }
2205   >>
2206 }
2207
2208 musicB = {
2209   \clef bass
2210   \new Voice {
2211     \voiceTwo \relative c' {
2212       <fis, a cis>8[ <fis a cis>
2213       \change Staff = up
2214       cis' cis
2215       \change Staff = down
2216       <fis, a> <fis a>]
2217       \showStaffSwitch
2218       \change Staff = up
2219       dis'4 |
2220       \change Staff = down
2221       <fis, a cis>4 gis <f a d>2 |
2222     }
2223   }
2224 }
2225
2226 \new PianoStaff {
2227   <<
2228     \context Staff = "up" {
2229       \accidentalStyle "neo-modern-voice-cautionary"
2230       \musicA
2231     }
2232     \context Staff = "down" {
2233       \accidentalStyle "neo-modern-voice-cautionary"
2234       \musicB
2235     }
2236   >>
2237 }
2238 @end lilypond
2239
2240 @item dodecaphonic
2241
2242 @cindex @emph{dodecaphonic}, style d'altérations
2243 @cindex altération, style @emph{dodecaphonic}
2244
2245 @funindex dodecaphonic
2246
2247 Cette règle reproduit ce que certains compositeurs du début du XXe
2248 siècle ont introduit dans leur désir d'abolir la distinction entre les
2249 notes naturelles ou non.  Ainsi, @strong{chaque} note est affublée d'une
2250 altération, même si elle est naturelle.
2251
2252 @lilypond[quote]
2253 musicA = {
2254   <<
2255     \relative c' {
2256       cis'8 fis, bes4 <a cis>8 f bis4 |
2257       cis2. <c, g'>4 |
2258     }
2259     \\
2260     \relative c' {
2261       ais'2 cis, |
2262       fis8 b a4 cis2 |
2263     }
2264   >>
2265 }
2266
2267 musicB = {
2268   \clef bass
2269   \new Voice {
2270     \voiceTwo \relative c' {
2271       <fis, a cis>8[ <fis a cis>
2272       \change Staff = up
2273       cis' cis
2274       \change Staff = down
2275       <fis, a> <fis a>]
2276       \showStaffSwitch
2277       \change Staff = up
2278       dis'4 |
2279       \change Staff = down
2280       <fis, a cis>4 gis <f a d>2 |
2281     }
2282   }
2283 }
2284
2285 \new PianoStaff {
2286   <<
2287     \context Staff = "up" {
2288       \accidentalStyle "dodecaphonic"
2289       \musicA
2290     }
2291     \context Staff = "down" {
2292       \accidentalStyle "dodecaphonic"
2293       \musicB
2294     }
2295   >>
2296 }
2297 @end lilypond
2298
2299
2300 @item teaching
2301
2302 @cindex @emph{teaching}, style d'altérations
2303 @cindex altérations, style @emph{teaching}
2304
2305 @funindex teaching
2306
2307 Cette règle est à usage pédagogique : l'impression d'une simple
2308 gamme fera apparaître une altération de précaution pour toute note
2309 altérée.  Les altérations accidentelles sont imprimées selon le style
2310 @code{modern}, et une altération de précaution est ajoutée pour chaque
2311 dièse ou bémol à la clef -- sauf dans le cas de notes consécutives.
2312
2313 @lilypond[quote,staffsize=18]
2314 musicA = {
2315   <<
2316     \relative c' {
2317       cis'8 fis, bes4 <a cis>8 f bis4 |
2318       cis2. <c, g'>4 |
2319     }
2320     \\
2321     \relative c' {
2322       ais'2 cis, |
2323       fis8 b a4 cis2 |
2324     }
2325   >>
2326 }
2327
2328 musicB = {
2329   \clef bass
2330   \new Voice {
2331     \voiceTwo \relative c' {
2332       <fis, a cis>8[ <fis a cis>
2333       \change Staff = up
2334       cis' cis
2335       \change Staff = down
2336       <fis, a> <fis a>]
2337       \showStaffSwitch
2338       \change Staff = up
2339       dis'4 |
2340       \change Staff = down
2341       <fis, a cis>4 gis <f a d>2 |
2342     }
2343   }
2344 }
2345
2346 \new PianoStaff {
2347   <<
2348     \context Staff = "up" {
2349       \key fis \minor
2350       \accidentalStyle "teaching"
2351       \musicA
2352     }
2353     \context Staff = "down" {
2354       \key fis \minor
2355       \accidentalStyle "teaching"
2356       \musicB
2357     }
2358   >>
2359 }
2360 @end lilypond
2361
2362 @item no-reset
2363
2364 @cindex altération, style @emph{no reset}
2365 @cindex @emph{no reset}, style d'altérations
2366
2367 @funindex no-reset
2368
2369 C'est la même règle que @code{default}, mais l'effet des altérations
2370 accidentelles ne cesse jamais, même dans les mesures suivantes.
2371
2372 @lilypond[quote]
2373 musicA = {
2374   <<
2375     \relative c' {
2376       cis'8 fis, bes4 <a cis>8 f bis4 |
2377       cis2. <c, g'>4 |
2378     }
2379     \\
2380     \relative c' {
2381       ais'2 cis, |
2382       fis8 b a4 cis2 |
2383     }
2384   >>
2385 }
2386
2387 musicB = {
2388   \clef bass
2389   \new Voice {
2390     \voiceTwo \relative c' {
2391       <fis, a cis>8[ <fis a cis>
2392       \change Staff = up
2393       cis' cis
2394       \change Staff = down
2395       <fis, a> <fis a>]
2396       \showStaffSwitch
2397       \change Staff = up
2398       dis'4 |
2399       \change Staff = down
2400       <fis, a cis>4 gis <f a d>2 |
2401     }
2402   }
2403 }
2404
2405 \new PianoStaff {
2406   <<
2407     \context Staff = "up" {
2408       \accidentalStyle "no-reset"
2409       \musicA
2410     }
2411     \context Staff = "down" {
2412       \accidentalStyle "no-reset"
2413       \musicB
2414     }
2415   >>
2416 }
2417 @end lilypond
2418
2419 @item forget
2420
2421 @cindex @emph{forget}, style d'altérations
2422 @cindex altérations, style @emph{forget}
2423
2424 @funindex forget
2425
2426 Tout le contraire de @code{no-reset} : l'effet des altérations
2427 cesse aussitôt ; toutes les altérations, quelque soit leur place
2428 dans la mesure, sont de ce fait imprimées en fonction de l'éventuelle
2429 armure.
2430
2431 @lilypond[quote]
2432 musicA = {
2433   <<
2434     \relative c' {
2435       cis'8 fis, bes4 <a cis>8 f bis4 |
2436       cis2. <c, g'>4 |
2437     }
2438     \\
2439     \relative c' {
2440       ais'2 cis, |
2441       fis8 b a4 cis2 |
2442     }
2443   >>
2444 }
2445
2446 musicB = {
2447   \clef bass
2448   \new Voice {
2449     \voiceTwo \relative c' {
2450       <fis, a cis>8[ <fis a cis>
2451       \change Staff = up
2452       cis' cis
2453       \change Staff = down
2454       <fis, a> <fis a>]
2455       \showStaffSwitch
2456       \change Staff = up
2457       dis'4 |
2458       \change Staff = down
2459       <fis, a cis>4 gis <f a d>2 |
2460     }
2461   }
2462 }
2463
2464 \new PianoStaff {
2465   <<
2466     \context Staff = "up" {
2467       \accidentalStyle "forget"
2468       \musicA
2469     }
2470     \context Staff = "down" {
2471       \accidentalStyle "forget"
2472       \musicB
2473     }
2474   >>
2475 }
2476 @end lilypond
2477 @end table
2478
2479 @seealso
2480 Morceaux choisis :
2481 @rlsrnamed{Pitches,Hauteurs}.
2482
2483 Référence des propriétés internes :
2484 @rinternals{Accidental},
2485 @rinternals{Accidental_engraver},
2486 @rinternals{GrandStaff} et
2487 @rinternals{PianoStaff},
2488 @rinternals{Staff},
2489 @rinternals{AccidentalSuggestion},
2490 @rinternals{AccidentalPlacement}.
2491 @rinternals{accidental-suggestion-interface}.
2492
2493
2494 @cindex altérations et notes simultanées
2495 @cindex notes simultanées et altérations
2496 @cindex altérations et accords
2497 @cindex accords et altérations
2498
2499 @knownissues
2500 Les notes simultanées sont considérées comme des évènements séquentiels.
2501 Ceci implique que, dans un accord, les altérations accidentelles
2502 seront imprimées comme si les notes de l'accord apparaissaient l'une
2503 après l'autre, en fonction de l'ordre dans lequel elles ont été saisies
2504 -- ce qui peut poser problème lorsqu'au sein d'un accord certaines
2505 altérations dépendent les unes des autres.
2506 Ce problème est à résoudre manuellement, en insérant des @code{!}
2507 et des @code{?} après les notes concernées, tel @samp{<f! fis!>}.
2508
2509 L'absence d'altération de précaution est déterminée par l'examen de la
2510 mesure précédente.  Néanmoins, lorsqu'un bloc @code{\alternative} suit
2511 une section @code{\repeat volta N}, la logique voudrait que
2512 l'on regarde la dernière mesure @emph{jouée} plutôt que la dernière
2513 @emph{imprimée}.  Dans l'exemple qui suit, vous conviendrez que le do de
2514 la seconde alternative ne nécessite pas son bécarre.
2515
2516 @lilypond[quote]
2517 {
2518   \accidentalStyle "modern"
2519   \time 2/4
2520   \repeat volta 2 {
2521     c'2
2522   }
2523   \alternative {
2524      cis'
2525      c'
2526   }
2527 }
2528 @end lilypond
2529
2530 L'astuce suivante, qui définit temporairement le recours au style
2531 @code{forget}, permet d'obtenir quelque chose de présentable.
2532
2533 @lilypond[verbatim,quote]
2534 forget = #(define-music-function (parser location music) (ly:music?) #{
2535   \accidentalStyle "forget"
2536   #music
2537   \accidentalStyle "modern"
2538 #})
2539 {
2540   \accidentalStyle "modern"
2541   \time 2/4
2542   \repeat volta 2 {
2543     c'2
2544   }
2545   \alternative {
2546      cis'
2547      \forget c'
2548   }
2549 }
2550 @end lilypond
2551
2552
2553 @node Ambitus
2554 @unnumberedsubsubsec Ambitus
2555 @translationof Ambitus
2556
2557 @cindex ambitus
2558 @cindex tessiture
2559 @cindex amplitude
2560
2561 L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
2562 partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
2563 est capable d'atteindre.  Souvent, cet @emph{ambitus} est imprimé au
2564 début des partitions vocales, afin que les exécutants puissent voir au
2565 premier coup d'œil s'ils sont en mesure de tenir la partie en question.
2566
2567 Pour exprimer l'@emph{ambitus} d'une pièce, on indique avant la clef
2568 deux têtes de note représentant la hauteur la plus basse et la plus
2569 haute.  Les éventuelles altérations accidentelles seront automatiquement
2570 ajoutées.
2571
2572 @lilypond[verbatim,quote]
2573 \layout {
2574   \context {
2575     \Voice
2576     \consists "Ambitus_engraver"
2577   }
2578 }
2579
2580 \relative c'' {
2581   aes c e2
2582   cis,1
2583 }
2584 @end lilypond
2585
2586 @snippets
2587 @lilypondfile[verbatim,quote,texidoc,doctitle]
2588 {adding-ambitus-per-voice.ly}
2589
2590 @lilypondfile[verbatim,quote,texidoc,doctitle]
2591 {ambitus-with-multiple-voices.ly}
2592
2593 @lilypondfile[verbatim,quote,texidoc,doctitle]
2594 {changing-the-ambitus-gap.ly}
2595
2596 @seealso
2597 Glossaire musicologique :
2598 @rglos{ambitus}.
2599
2600 Morceaux choisis :
2601 @rlsrnamed{Pitches,Hauteurs}.
2602
2603 Référence des propriétés internes :
2604 @rinternals{Ambitus_engraver},
2605 @rinternals{Voice},
2606 @rinternals{Staff},
2607 @rinternals{Ambitus},
2608 @rinternals{AmbitusAccidental},
2609 @rinternals{AmbitusLine},
2610 @rinternals{AmbitusNoteHead},
2611 @rinternals{ambitus-interface}.
2612
2613 @knownissues
2614 LilyPond ne gère pas les collisions entre plusieurs @emph{ambitus}
2615 présents sur une même portée.
2616
2617
2618 @node Têtes de note
2619 @subsection Têtes de note
2620 @translationof Note heads
2621
2622 Nous allons voir dans ce chapitre comment modifier l'aspect des têtes de
2623 note.
2624
2625 @menu
2626 * Têtes de note spécifiques::
2627 * Têtes de note avec nom de note::
2628 * Têtes de note à forme variable::
2629 * Improvisation::
2630 @end menu
2631
2632
2633 @node Têtes de note spécifiques
2634 @unnumberedsubsubsec Têtes de note spécifiques
2635 @translationof Special note heads
2636
2637 @cindex têtes de note, spéciales
2638 @cindex croix, tête de note
2639 @cindex losange, tête de note
2640 @cindex parlato, tête de note
2641 @cindex harmonique, tête de note
2642 @cindex guitare, tête de note
2643 @cindex styles, tête de note
2644
2645 @funindex cross
2646
2647 L'apparence des têtes de note peut évoluer au cours de la partition :
2648
2649 @lilypond[verbatim,quote,relative=2]
2650 c4 b
2651 \override NoteHead #'style = #'cross
2652 c4 b
2653 \revert NoteHead #'style
2654 a b
2655 \override NoteHead #'style = #'harmonic
2656 a b
2657 \revert NoteHead #'style
2658 c4 d e f
2659 @end lilypond
2660
2661 Pour une liste exhaustive des styles de tête de note, consultez
2662 @ref{Styles de tête de note}.
2663
2664 Certains instruments utilisent des têtes de note différentes à des
2665 fins spécifiques -- des croix (style @code{cross}) pour le
2666 @emph{parlato} des chanteurs ou les notes étouffées des guitares :
2667
2668 @lilypond[verbatim,quote,relative=2]
2669 c4 b
2670 \xNotesOn
2671  a b c4 b
2672 \xNotesOff
2673 c4 d
2674 @end lilypond
2675
2676 Cette commande opère aussi bien sur des notes isolées qu'au sein d'un
2677 accord, dans une portée traditionnelle ou dans un contexte de
2678 tablature :
2679
2680 @lilypond[verbatim,quote,relative=2]
2681 c4 b
2682 \xNote { e f }
2683 c b < g \xNote c f > b
2684 @end lilypond
2685
2686 Vous pouvez utiliser, en lieu et place de @code{\xNote},
2687 @code{\xNotesOn} et @code{\xNotesOff}, les commandes
2688 @code{\deadNote}, @code{\deadNotesOn} et @code{\deadNotesOff}.
2689
2690 Il existe un raccourci pour les notes en losange qui indiquent les
2691 harmoniques des cordes :
2692
2693 @lilypond[verbatim,quote,relative=2]
2694 <c f\harmonic>2 <d a'\harmonic>4 <c g'\harmonic>
2695 @end lilypond
2696
2697 @predefined
2698 @code{\harmonic},
2699 @code{\xNotesOn},
2700 @code{\xNotesOff},
2701 @code{\xNote}.
2702 @endpredefined
2703
2704 @seealso
2705 Manuel de notation :
2706 @ref{Styles de tête de note},
2707 @ref{Notes en accords},
2708 @ref{Indication des harmoniques et notes étouffées}.
2709
2710 Morceaux choisis :
2711 @rlsrnamed{Pitches,Hauteurs}.
2712
2713 Référence des propriétés internes :
2714 @rinternals{note-event},
2715 @rinternals{Note_heads_engraver},
2716 @rinternals{Ledger_line_engraver},
2717 @rinternals{NoteHead}.
2718 @rinternals{LedgerLineSpanner},
2719 @rinternals{note-head-interface},
2720 @rinternals{ledger-line-spanner-interface}.
2721
2722
2723 @node Têtes de note avec nom de note
2724 @unnumberedsubsubsec Têtes de note avec nom de note
2725 @translationof Easy notation note heads
2726
2727 @cindex tête de note, apprentissage
2728 @cindex notation facile
2729 @cindex Hal Leonard
2730 @cindex @emph{easy play}, têtes de note
2731
2732 @funindex \easyHeadsOn
2733 @funindex easyHeadsOn
2734 @funindex \easyHeadsOff
2735 @funindex easyHeadsOff
2736
2737 Les notes « easy play » comportent le nom de la note à l'intérieur de
2738 la tête.  On l'utilise dans des partitions pour débutants.  L'impression
2739 doit être de plus grande taille, afin que les lettres soient lisibles.
2740 Voir à ce propos @ref{Définition de la taille de portée}.
2741
2742 @lilypond[verbatim,quote]
2743 #(set-global-staff-size 26)
2744 \relative c' {
2745   \easyHeadsOn
2746   c2 e4 f
2747   g1
2748   \easyHeadsOff
2749   c,1
2750 }
2751 @end lilypond
2752
2753 @predefined
2754 @code{\easyHeadsOn},
2755 @code{\easyHeadsOff}.
2756 @endpredefined
2757
2758 @snippets
2759 @lilypondfile[verbatim,quote,texidoc,doctitle]
2760 {numbers-as-easy-note-heads.ly}
2761
2762 @seealso
2763 Manuel de notation :
2764 @ref{Définition de la taille de portée}.
2765
2766 Morceaux choisis :
2767 @rlsrnamed{Pitches,Hauteurs}.
2768
2769 Référence des propriétés internes :
2770 @rinternals{note-event},
2771 @rinternals{Note_heads_engraver},
2772 @rinternals{NoteHead},
2773 @rinternals{note-head-interface}.
2774
2775
2776 @node Têtes de note à forme variable
2777 @unnumberedsubsubsec Têtes de note à forme variable
2778 @translationof Shape note heads
2779
2780 @cindex tête de note, allure
2781 @cindex tête de note, Aiken
2782 @cindex tête de note, harpe sacrée
2783 @cindex notes profilées
2784 @cindex Aiken, tête de note
2785 @cindex harpe sacrée, tête de note
2786 @cindex Funk, tête de note
2787 @cindex tête de note, Funk
2788 @cindex tête de note, Harmonica Sacra
2789 @cindex Harmonica Sacra, tête de note
2790 @cindex Christian Harmony, tête de note
2791 @cindex tête de note, Christian Harmony
2792 @cindex Walker shape, tête de note
2793 @cindex tête de note, Walker
2794
2795 @funindex \key
2796 @funindex key
2797 @funindex \aikenHeads
2798 @funindex aikenHeads
2799 @funindex \aikenHeadsMinor
2800 @funindex aikenHeadsMinor
2801 @funindex \sacredHarpHeads
2802 @funindex sacredHarpHeads
2803 @funindex \sacredHarpHeadsMinor
2804 @funindex sacredHarpHeadsMinor
2805 @funindex \southernHarmonyHeads
2806 @funindex southernHarmonyHeads
2807 @funindex \southernHarmonyHeadsMinor
2808 @funindex southernHarmonyHeadsMinor
2809 @funindex \funkHeads
2810 @funindex funkHeads
2811 @funindex \walkerHeads
2812 @funindex walkerHeads
2813 @funindex \funkHeadsMinor
2814 @funindex funkHeadsMinor
2815 @funindex \walkerHeadsMinor
2816 @funindex walkerHeadsMinor
2817
2818 En notation profilée, le profil d'une tête de note correspond à la
2819 fonction harmonique de cette note dans la gamme.  Ce style de notation
2820 était très en vogue dans les recueils de chansons américains du XIXe
2821 siècle.  Voici comment procéder :
2822
2823 @lilypond[verbatim,quote,relative=2]
2824 \aikenHeads
2825 c, d e f g2 a b1 c \break
2826 \sacredHarpHeads
2827 c,4 d e f g2 a b1 c \break
2828 \southernHarmonyHeads
2829 c,4 d e f g2 a b1 c \break
2830 \funkHeads
2831 c,4 d e f g2 a b1 c \break
2832 \walkerHeads
2833 c,4 d e f g2 a b1 c \break
2834 @end lilypond
2835
2836 Les profils sont déterminés par la hauteur dans la gamme, le premier
2837 degré étant défini par la commande @code{\key}.  Pour une tonalité
2838 mineure, les degrés sont déterminés par rapport au relatif majeur :
2839
2840 @lilypond[verbatim,quote,relative=2]
2841 \key a \minor
2842 \aikenHeads
2843 a b c d e2 f g1 a \break
2844 \aikenHeadsMinor
2845 a,4 b c d e2 f g1 a \break
2846 \sacredHarpHeadsMinor
2847 a,2 b c d \break
2848 \southernHarmonyHeadsMinor
2849 a2 b c d \break
2850 \funkHeadsMinor
2851 a2 b c d \break
2852 \walkerHeadsMinor
2853 a2 b c d \break
2854 @end lilypond
2855
2856 @predefined
2857 @code{\aikenHeads},
2858 @code{\aikenHeadsMinor},
2859 @code{\funkHeads},
2860 @code{\funkHeadsMinor},
2861 @code{\sacredHarpHeads}.
2862 @code{\sacredHarpHeadsMinor},
2863 @code{\southernHarmonyHeads},
2864 @code{\southernHarmonyHeadsMinor},
2865 @code{\walkerHeads},
2866 @code{\walkerHeadsMinor}.
2867 @endpredefined
2868
2869 @snippets
2870 @lilypondfile[verbatim,quote,texidoc,doctitle]
2871 {applying-note-head-styles-depending-on-the-step-of-the-scale.ly}
2872
2873 Pour une liste exhaustive des styles de tête de note, consultez
2874 @ref{Styles de tête de note}.
2875
2876 @seealso
2877 Manuel de notation :
2878 @ref{Styles de tête de note}.
2879
2880 Morceaux choisis :
2881 @rlsrnamed{Pitches,Hauteurs}.
2882
2883 Référence des propriétés internes :
2884 @rinternals{note-event},
2885 @rinternals{Note_heads_engraver},
2886 @rinternals{NoteHead},
2887 @rinternals{note-head-interface}.
2888
2889
2890 @node Improvisation
2891 @unnumberedsubsubsec Improvisation
2892 @translationof Improvisation
2893
2894 @cindex improvisation
2895 @cindex notes penchées
2896 @cindex tête de note et improvisation
2897 @cindex tête de note allongée
2898
2899 @funindex \improvisationOn
2900 @funindex improvisationOn
2901 @funindex \improvisationOff
2902 @funindex improvisationOff
2903
2904 L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
2905 allongée (@emph{slash}).  L'interprète jouera alors les notes qu'il
2906 veut, en respectant toutefois le rythme affiché. Ces têtes de notes sont
2907 créées ainsi :
2908
2909 @lilypond[verbatim,quote,relative=2]
2910 \new Voice \with {
2911   \consists "Pitch_squash_engraver"
2912 } {
2913   e8 e g a a16( bes) a8 g
2914   \improvisationOn
2915   e8 ~
2916   e2 ~ e8 f4 f8 ~
2917   f2
2918   \improvisationOff
2919   a16( bes) a8 g e
2920 }
2921 @end lilypond
2922
2923 @predefined
2924 @code{\improvisationOn},
2925 @code{\improvisationOff}.
2926 @endpredefined
2927
2928 @seealso
2929 Morceaux choisis :
2930 @rlsrnamed{Pitches,Hauteurs}.
2931
2932 Référence des propriétés internes :
2933 @rinternals{Pitch_squash_engraver},
2934 @rinternals{Voice},
2935 @rinternals{RhythmicStaff}.
2936
2937
2938 @c  LocalWords:  lilypondfile subsection translationof seealso funindex
2939 @c  LocalWords:  unnumberedsubsubsec rglosnamed rlsrnamed itemize quote
2940 @c  LocalWords:  rinternals rlearning snippets texidoc doctitle
2941 @c  LocalWords:  ragged-right knownissues quotation multitable headitem
2942 @c  LocalWords:  noindent Staff.instrumentName Staff.midiInstrument
2943 @c  LocalWords:  accidentalStyle PianoStaff GrandStaff predefined