Documentation/fr/user/pitches.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @c \version "2.11.51"
  10
  11 @c Translators: Frédéric Chiasson
  12 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
  13
  14 @node Pitches
  15 @section Pitches
  16
  17 @lilypondfile[quote]{pitches-headword.ly}
  18
  19 Cette section détaille la façon d'indiquer les hauteurs de notes, sous
  20 trois aspects : la saisie des hauteurs, la modification des hauteurs
  21 et les options de gravure.
  22
  23 @menu
  24 * Writing pitches::
  25 * Changing multiple pitches::
  26 * Displaying pitches::
  27 * Note heads::
  28 @end menu
  29
  30
  31 @node Writing pitches
  32 @subsection Writing pitches
  33
  34 Cette section explique la manière d'indiquer les hauteurs de note.  Il
  35 y a deux modes d'indiquer l'octave des notes : le mode absolu, et le
  36 mode relatif.  Le dernier est le plus pratique lors de la saisie d'un
  37 fichier source au clavier de l'ordinateur.
  38
  39 @menu
  40 * Absolute octave entry::
  41 * Relative octave entry::
  42 * Accidentals::
  43 * Note names in other languages::
  44 @end menu
  45
  46 @node Absolute octave entry
  47 @unnumberedsubsubsec Absolute octave entry
  48
  49 @cindex noms de note
  50 @cindex hauteurs
  51 @cindex absolues, hauteurs
  52 @cindex absolues, octaves
  53 @cindex octaves absolues
  54
  55 La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
  56 notation anglaise, en utilisant les lettres @code{a} à @code{g}.
  57 Une gamme ascendante de do majeur s'écrit
  58
  59 @lilypond[quote,fragment,verbatim,ragged-right]
  60 \clef bass
  61 c d e f g a b c'
  62 @end lilypond
  63
  64 La note @code{c} est écrite une octave sous le do central.
  65
  66 @lilypond[quote,fragment,verbatim,ragged-right]
  67 \clef treble
  68 c1
  69 \clef bass
  70 c1
  71 @end lilypond
  72
  73 @funindex '
  74 @funindex ,
  75
  76 L'octave peut être précisée sous forme d'une série d'apostrophes
  77 @samp{'} ou d'une série de virgules @samp{,}.  Chaque @samp{'} hausse la
  78 note d'une octave, chaque @samp{,} baisse la note d'une octave.
  79
  80 @lilypond[quote,ragged-right,fragment,verbatim]
  81 \clef treble
  82 c' c'' e' g d'' d' d c
  83 \clef bass
  84 c, c,, e, g d,, d, d c
  85 @end lilypond
  86
  87 Il existe une autre méthode pour préciser à quelle octave se situe la
  88 note à graver ; cette méthode demande moins d'indications d'octave
  89 (@code{'} ou @code{,}) --- voir @ref{Relative octave entry}.
  90
  91
  92 @node Relative octave entry
  93 @unnumberedsubsubsec Relative octave entry
  94
  95 @cindex relatif
  96 @cindex indication d'octave relative
  97 @funindex \relative
  98
  99 On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
 100 hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
 101 à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
 102 Le mode d'écriture \relative prévient ces erreurs dans la mesure où
 103 elles deviennent beaucoup plus évidentes : une seule erreur décale le
 104 reste de la pièce à une mauvaise octave.
 105
 106
 107 @example
 108 \relative @var{startpitch} @var{musicexpr}
 109 @end example
 110
 111 @noindent
 112 ou
 113
 114 @example
 115 \relative @var{musicexpr}
 116 @end example
 117
 118 @noindent
 119 @code{c'} est utilisé par défaut si aucune hauteur de départ n'est
 120 définie.
 121
 122 L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
 123 la manière suivante : si aucun signe de changement d'octave n'est
 124 utilisé, l'intervalle de base entre la note actuelle et la précédente
 125 sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
 126 tenir compte des altérations ; ainsi un @code{fisis} après un
 127 @code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
 128 une quarte doublement augmentée demeure considérée comme un intervavlle
 129 plus petit qu'une quinte diminuée, bien que la quarte doublement
 130 augmentée soit de sept demi-tons et la quinte diminuée de seulement six
 131 demi-tons.
 132
 133 Les signes de changement d'octave @code{'} et @code{,} peuvent être
 134 ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
 135 Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
 136 départ peut être spécifiée, et agira dès lors comme si elle précédait la
 137 première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
 138 spécifiée, le do central sert de point de départ.
 139
 140 Voici le mode \relative en action.
 141 @lilypond[quote,fragment,ragged-right,verbatim]
 142 \relative c'' {
 143   b c d c b c bes a
 144 }
 145 @end lilypond
 146
 147 On utilise les signes de changement d'octave pour les intervalles
 148 dépassant la quarte.
 149
 150 @lilypond[quote,ragged-right,fragment,verbatim]
 151 \relative c'' {
 152   c g c f, c' a, e''
 153 }
 154 @end lilypond
 155
 156 Si l'expression précédente est un accord, c'est la première note de
 157 l'accord qui détermine l'emplacement de la première note du prochain
 158 accord.
 159
 160 @lilypond[quote,ragged-right,fragment,verbatim]
 161 \relative c' {
 162   c <c e g>
 163   <c' e g>
 164   <c, e' g>
 165 }
 166 @end lilypond
 167
 168 La hauteur après @code{\relative} contient un nom de note.
 169
 170 La conversion en mode \relative n'affectera pas les sections @code{\transpose},
 171 @code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
 172 utiliser \relative dans de la musique transposée, un code
 173 @code{\relative} additionnel doit être placé dans @code{\transpose}.
 174
 175
 176 @node Accidentals
 177 @unnumberedsubsubsec Accidentals
 178
 179 @cindex noms de note, hollandais
 180 @cindex noms de note, par défaut
 181
 182 Dans la notation par défaut, un dièse est formé en ajoutant @code{-is}
 183 après le nom de note, un bémol en ajoutant @code{-es}.  Les
 184 double-dièses et double-bémols sont obtenus en ajoutant @code{-isis}
 185 ou @code{-eses} au nom de note.
 186
 187 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 188 a2 ais a aes
 189 a2 aisis a aeses
 190 @end lilypond
 191
 192 @noindent
 193 Ce sont les noms de note hollandais.  En hollandais, on élide @code{aes}
 194 pour écrire @code{as}, mais les deux formes sont acceptées.  De manière
 195 similaire, on accepte aussi bien @code{es} que @code{ees}.
 196
 197 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
 198 a2 as e es
 199 @end lilypond
 200
 201 Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
 202 ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
 203 bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
 204 donnera une note bécarre.
 205
 206 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 207 a4 aes a2
 208 @end lilypond
 209
 210 LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
 211 naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
 212 Pour plus d'information à propos de la distinction entre le contenu
 213 musical et sa représentation, voir @rlearning{Accidentals and key signatures}.
 214
 215 @lilypond[fragment,quote,ragged-right,verbatim,relative]
 216 \key d \major
 217 d e f g
 218 d e fis g
 219 @end lilypond
 220
 221
 222 @snippets
 223
 224 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
 225 {preventing-extra-naturals-from-being-automatically-added.ly}
 226
 227 @seealso
 228
 229 Référence du programme : @rinternals{LedgerLineSpanner},
 230 @rinternals{NoteHead}.
 231
 232
 233 @unnumberedsubsubsec Micro tones
 234
 235 @cindex quarts de ton
 236 @cindex demi-bémols, demi-dièses
 237
 238 Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
 239 @code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
 240 croissantes :
 241
 242 @lilypond[verbatim,ragged-right,quote,relative=2,fragment]
 243 \set Staff.extraNatural = ##f
 244 ceseh ceh cih cisih
 245 @end lilypond
 246
 247 Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 248
 249 @knownissues
 250
 251 Il n'y a pas de standard universellement accepté pour noter le bémol et
 252 demi (qui abaisse la hauteur trois quarts de ton), le symbole de
 253 LilyPond n'est donc conforme à aucun standard.
 254
 255
 256 @unnumberedsubsubsec Cautionary accidentals
 257
 258 @cindex altération, de précaution
 259 @cindex altération, entre parenthèses
 260 @cindex altération de précaution
 261 @funindex ?
 262 @cindex altération entre parenthèses
 263 @funindex !
 264
 265 Normalement, les altérations sont imprimées automatiquement, mais il se
 266 peut que vous vouliez les imprimer manuellement.  On peut forcer
 267 l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
 268 point d'exclamation @samp{!} après la hauteur de note.  Une altération
 269 entre parenthèses peut être obtenue en ajoutant un point d'interrogation
 270 @samp{?} après la hauteur de note.  Ces signes peuvent aussi être
 271 utilisés pour imprimer des bécarres.
 272
 273 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
 274 cis cis cis! cis? c c? c! c
 275 @end lilypond
 276
 277
 278 @seealso
 279
 280 L'impression automatique des altérations peut être affinée de plusieurs
 281 manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
 282
 283
 284 @node Note names in other languages
 285 @unnumberedsubsubsec Note names in other languages
 286
 287 Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
 288 langues.  Pour les utiliser, incluez le fichier d'initialisation
 289 spécifique à la langue voulue.  Par exemple, pour les langues romanes,
 290 ajoutez @code{\include "italiano.ly"} au début du fichier source.  Les
 291 fichiers de langues disponibles ainsi que les noms de notes utilisés
 292 sont les suivants :
 293
 294 @cindex noms de note, autres langues
 295 @example
 296                        Noms de note              dièse       bémol      double          double
 297                                                                         dièse           bémol
 298 nederlands.ly  c   d   e   f   g   a   bes b   -is         -es          -isis           -eses
 299 english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat     -ss/-x/         -ff/
 300                                                                         -sharpshsarp    -flatflat
 301 deutsch.ly     c   d   e   f   g   a   b   h   -is         -es          -isis           -eses
 302 norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es     -ississ/-isis   -essess/-eses
 303 svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess         -ississ         -essess
 304 italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b           -dd             -bb
 305 catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b           -dd/-ss         -bb
 306 espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b           -ss             -bb
 307 @end example
 308
 309 @noindent
 310 Notez qu'en hollandais, en allemand, en norvégien et en suédois, un
 311 @samp{la} altéré de bemol se note @code{aes} et @code{aeses}.  Ces
 312 formes sont contractées en @code{as} et @code{ases} (ou plus communément
 313 @code{asas}).  Dans certains fichiers linguistiques, seules ces formes
 314 abrégées ont été définies ; ceci s'applique aussi aux suffixes pour les
 315 quarts de ton.
 316
 317 @noindent
 318 Certaines musiques utilisent des microtonalités, pour lesquelles les
 319 altérations sont des fractions de dièse ou bémol @qq{normaux}.  Le
 320 tableau suivant répertorie les noms de note en quart de ton, tels que
 321 définis dans plusieurs fichiers linguistiques. Les préfixes @q{semi-} et
 322 @q{sesqui-} correspondent au @q{demi-} et @q{trois demis}.  À noter
 323 qu'aucune définition n'existe à ce jour pour le norvégien, le suédois,
 324 le catalan et l'espagnol.
 325
 326 @c What about Turkish Maquam music and similar microtonal systems?
 327 @c
 328 @c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code
 329 @c is actually misleading since the alteration is in fact one and a half
 330 @c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
 331
 332 @example
 333                         Noms de note           semi-   semi-  sesqui-  sesqui-
 334                                                dièse   bémol  dièse    bémol
 335
 336 nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
 337 english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
 338 deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
 339 norsk.ly       c   d   e   f   g   a   b   h
 340 svenska.ly     c   d   e   f   g   a   b   h
 341 italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
 342 catalan.ly     do  re  mi  fa  sol la  sib si
 343 espanol.ly     do  re  mi  fa  sol la  sib si
 344 @end example
 345
 346
 347 @node Changing multiple pitches
 348 @subsection Changing multiple pitches
 349
 350 @menu
 351 * Octave checks::
 352 * Transpose::
 353 @end menu
 354
 355 @node Octave checks
 356 @unnumberedsubsubsec Octave checks
 357
 358 @cindex vérification d'octave
 359
 360 Les tests d'octave rendent la correction d'erreurs d'octave plus facile
 361 dans le mode d'octave @code{relative} : une note peut être suivie de
 362 @code{=}@var{apostrophes/virgules} pour indiquer à quelle octave absolue
 363 elle devrait être.  Dans l'exemple suivant,
 364
 365 @example
 366 \relative c'' @{ c='' b=' d,='' @}
 367 @end example
 368
 369 @noindent
 370 le @code{d} générera un avertissement, puisqu'on attend un @code{d''}
 371 mais qu'on obtient un @code{d'} --- il n'y a qu'une tierce entre
 372 @code{b'} et @code{d''}.  Sur la partition, l'octave sera corrigée pour
 373 donner un @code{d''} et la prochaine note sera calculée en fonction de
 374 @code{d''} et non de @code{d'}.
 375
 376 Il existe aussi une vérification d'octave qui ne produit pas de musique
 377 imprimée, ayant pour syntaxe
 378
 379 @example
 380 \octaveCheck @var{hauteur}
 381 @end example
 382
 383 Cette commande vérifie que la @var{hauteur} considérée sans apostrophe
 384 ni virgule et comme hauteur relative, est la même que la @var{hauteur}
 385 absolue considérée avec ses éventuelles apostrophes ou virgules.  Sinon,
 386 un avertissement est émis et l'octave est corrigée.  La @var{hauteur}
 387 n'est pas considérée comme une note, et donc n'est pas imprimée.
 388
 389 Dans l'exemple ci-dessous, le premier test réussit, puisque le @code{e}
 390 --- dans le mode @code{relative} --- est au plus à une quarte de
 391 @code{a'}.  Cependant, le deuxième test produit un avertissement,
 392 puisque le @code{e} est à quinte de @code{b'}.  Le message
 393 d'avertissement est émis, et l'octave est corrigée afin que les notes
 394 suivantes soient à nouveau à la bonne octave.
 395
 396 @example
 397 \relative c' @{
 398   e
 399   \octaveCheck a'
 400   \octaveCheck b'
 401 @}
 402 @end example
 403
 404 L'octave d'une note qui suit un test d'octave est déterminée selon la
 405 note précédente.  Dans l'exemple suivant, la dernière note est un
 406 @code{a'}, au-dessus du do central.  Cela veut dire que le test
 407 @code{\octaveCheck} réussit, et peut donc être enlevé sans changer le
 408 résultat sur la partition.
 409
 410 @lilypond[quote,ragged-right,verbatim,fragment]
 411 \relative c' {
 412   e
 413   \octaveCheck b
 414   a
 415 }
 416 @end lilypond
 417
 418
 419 @node Transpose
 420 @unnumberedsubsubsec Transpose
 421
 422 @cindex transposition
 423 @cindex transposition des hauteurs
 424 @funindex \transpose
 425
 426 Une expression musicale peut être transposée avec @code{\transpose}.
 427 Voici la syntaxe :
 428 @example
 429 \transpose @var{note_de départ} @var{note_d_arrivée} @var{musicexpr}
 430 @end example
 431
 432 Cela signifie que @var{musicexpr} est transposé d'un intervalle entre
 433 les notes @var{note_de_départ} et @var{note_d_arrivée} : toute note
 434 dont la hauteur était @code{note_de_départ}
 435 est changée en @code{note_d_arrivée}.
 436
 437 Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce est
 438 un peu trop basse pour l'interprète, elle peut être transposée en mi
 439 majeur avec
 440 @example
 441 \transpose d e @dots{}
 442 @end example
 443
 444 Regardons maintenant une partie écrite pour violon --- un instrument en
 445 ut).  Si cette partie doit être jouée par une clarinette en la (écrite à
 446 la tierce mineure supérieure, un do écrit donnant un la réel), la
 447 transposition suivante créera la partie appropriée.
 448
 449 @example
 450 \transpose a c @dots{}
 451 @end example
 452
 453 @code{\transpose} fait la distinction entre les notes enharmoniques :
 454 @code{\transpose c cis} et @code{\transpose c des} transposeront la
 455 pièce un demi-ton plus haut.  Mais la première version écrira des
 456 dièses et la deuxième des bémols.
 457
 458 @lilypond[quote,ragged-right,verbatim]
 459 mus = { \key d \major cis d fis g }
 460 \new Staff {
 461   \clef "F" \mus
 462   \clef "G"
 463   \transpose c g' \mus
 464   \transpose c f' \mus
 465 }
 466 @end lilypond
 467
 468 On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
 469 pour un instrument transpositeur.  Normalement, les hauteurs dans
 470 LilyPond sont écrites en ut, i.e. en sons réels, mais elles peuvent être
 471 écrites dans un autre ton.  Quand, par exemple, on écrit pour une
 472 trompette en si bémol, commençant sur ré note réelle, on pourrait écrire
 473 @example
 474 \transpose c bes @{ e4 @dots{} @}
 475 @end example
 476
 477 Pour imprimer cette musique en si bémol à nouveau --- et de ce fait
 478 produire une partie de trompette, au lieu d'un conducteur en notes
 479 réelles, on utilisera un deuxième @code{transpose}
 480
 481 @example
 482 \transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
 483 @end example
 484
 485
 486 @seealso
 487
 488 Référence du programme : @rinternals{TransposedMusic}.
 489
 490 Exemples : @rlsr{Pitches}.
 491
 492
 493 @knownissues
 494
 495 Si vous voulez utiliser en même temps @code{\transpose} et
 496 @code{\relative}, vous devez mettre @code{\transpose} en dehors de
 497 @code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
 498 musique apparaissant dans un @code{\transpose}.
 499
 500 @node Displaying pitches
 501 @subsection Displaying pitches
 502
 503 @menu
 504 * Clef::
 505 * Key signature::
 506 * Ottava brackets::
 507 * Instrument transpositions::
 508 * Automatic accidentals::
 509 * Ambitus::
 510 @end menu
 511
 512 @node Clef
 513 @unnumberedsubsubsec Clef
 514
 515 @funindex \clef
 516
 517 La clé indique quelles lignes de la portée correspondent à telles
 518 hauteurs.  Elle est réglée par la commande @code{\clef}.
 519
 520 @lilypond[quote,ragged-right,fragment,verbatim]
 521 { c''2 \clef alto g'2 }
 522 @end lilypond
 523
 524 @cindex clé de sol
 525 @cindex clé de fa
 526 @cindex clé d'ut
 527
 528 Les clés prises en charge sont
 529
 530 @multitable @columnfractions .33 .66
 531 @headitem Clef @tab Position
 532 @item @code{treble}, violin, G, G2 @tab Clé de sol 2e ligne
 533 @item @code{alto, C} @tab Clé d'ut 3e ligne
 534 @item @code{tenor} @tab Clé d'ut 4e ligne
 535 @item @code{bass, F} @tab Clé de fa 4e ligne
 536 @item @code{french} @tab Clé de sol 1e ligne
 537 @item @code{soprano} @tab Clé d'ut 1e ligne
 538 @item @code{mezzosoprano} @tab Clé d'ut 2e ligne
 539 @item @code{baritone} @tab Clé d'ut 5e ligne
 540 @item @code{varbaritone} @tab Clé de fa 3e ligne
 541 @item @code{subbass} @tab Clé de fa 5e ligne
 542 @item @code{percussion} @tab Clé de percussion
 543 @item @code{tab} @tab Clé de tablature
 544 @end multitable
 545
 546 En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
 547 transposée à l'octave respectivement inférieure ou supérieure, et
 548 @code{_15} ou @code{^15} la transpose de deux octaves.  L'argument
 549 @var{clefname} doit être mis entre guillemets lorsqu'il contient un
 550 caractère @qq{souligné} ou des chiffres.  Par exemple,
 551
 552
 553 @cindex choral tenor clef
 554 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
 555 \clef "G_8" c4
 556 @end lilypond
 557
 558
 559 @commonprop
 560
 561 La commande @code{\clef "treble_8"} équivaut à définir @code{clefGlyph},
 562 @code{clefPosition} --- qui contrôle la position verticale de la clé ---
 563 @code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
 564 lorsque l'une de ces propriétés est changée.  Les exemples suivant font
 565 apparaître des possibilités de réglage manuel de ces propriétés.
 566
 567 @lilypond[quote,ragged-right,verbatim]
 568 {
 569   \set Staff.clefGlyph = #"clefs.F"
 570   \set Staff.clefPosition = #2
 571   c'4
 572   \set Staff.clefGlyph = #"clefs.G"
 573   c'4
 574   \set Staff.clefGlyph = #"clefs.C"
 575   c'4
 576   \set Staff.clefOctavation = #7
 577   c'4
 578   \set Staff.clefOctavation = #0
 579   \set Staff.clefPosition = #0
 580   c'4
 581   \clef "bass"
 582   c'4
 583   \set Staff.middleCPosition = #4
 584   c'4
 585 }
 586 @end lilypond
 587
 588
 589 @seealso
 590
 591 Dans ce manuel : @ref{Grace notes}.
 592
 593 Référence du programme : @rinternals{Clef}.
 594
 595
 596 @node Key signature
 597 @unnumberedsubsubsec Key signature
 598
 599 @cindex armure
 600 @funindex \key
 601
 602 L'armure indique la tonalité dans laquelle la pièce doit être jouée.
 603 Elle comprend un ensemble d'altérations (dièses ou bémols) à la clé,
 604 c'est-à-dire au début de la portée.
 605
 606 On définit ou modifie l'armure avec la commande @code{\key}
 607
 608 @example
 609 @code{\key} @var{hauteur} @var{type}
 610 @end example
 611
 612 @funindex \minor
 613 @funindex \major
 614 @funindex \minor
 615 @funindex \ionian
 616 @funindex \locrian
 617 @funindex \aeolian
 618 @funindex \mixolydian
 619 @funindex \lydian
 620 @funindex \phrygian
 621 @funindex \dorian
 622 @cindex modes anciens
 623
 624 Ici, @var{type} doit être @code{\major} ou @code{\minor} afin d'avoir
 625 respectivement @var{hauteur}-major ou @var{hauteur}-minor.  Vous pouvez
 626 aussi avoir recours aux modes anciens que sont @code{\ionian},
 627 @code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
 628 @code{\phrygian}, et @code{\dorian}.
 629
 630 Cette commande fixe la propriété de contexte @code{Staff.keySignature}.
 631 Des armures inhabituelles peuvent être spécifiées en modifiant
 632 directement cette propriété.
 633
 634 Les nouveaux utilisateurs s'embrouillent souvent dans les altérations et
 635 les armures, car des notes naturelles prennent ou non un bécarre selon
 636 l'armure.  Pour plus d'informations, voir @ref{Accidentals} ou
 637 @rlearning{Accidentals and key signatures}.
 638
 639 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
 640 \key g \major
 641 f1
 642 fis
 643 @end lilypond
 644
 645
 646 @commonprop
 647
 648 Un bécarre est imprimé pour annuler toute altération précédente.  Ceci
 649 peut être supprimé en réglant la propriété
 650 @code{Staff.printKeyCancellation}.
 651
 652 @lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
 653 \key d \major
 654 a b cis d
 655 \key g \minor
 656 a bes c d
 657 \set Staff.printKeyCancellation = ##f
 658 \key d \major
 659 a b cis d
 660 \key g \minor
 661 a bes c d
 662 @end lilypond
 663
 664
 665 @seealso
 666
 667 Référence du programme : @rinternals{KeyCancellation},
 668 @rinternals{KeySignature}.
 669
 670
 671 @node Ottava brackets
 672 @unnumberedsubsubsec Ottava brackets
 673
 674 Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
 675 transposition spécifique d'une octave pour la portée en cours.  C'est
 676 la fonction @code{ottava} qui s'en charge.
 677
 678 @cindex ottava
 679 @cindex 15ma
 680 @cindex octaviation
 681
 682 @lilypond[quote,ragged-right,verbatim,fragment]
 683 \relative c''' {
 684   a2 b
 685   \ottava #1
 686   a b
 687   \ottava #0
 688   a b
 689 }
 690 @end lilypond
 691
 692 La fonction @code{ottava} peut aussi prendre en argument les
 693 valeurs -1@tie{}(pour 8va bassa), 2@tie{}(pour 15ma --- 2 octaves) ou
 694 -2@tie{}(pour 15ma bassa).   En interne, cette fonction détermine les
 695 propriétés @code{ottavation} (p.ex. en @code{"8va"} ou @code{"8vb"})
 696 et @code{centralCPosition}.  Vous pouvez modifier le texte d'une marque
 697 d'octaviation en définissant @code{ottavation} après avoir fait appel
 698 à @code{ottava} :
 699
 700 @lilypond[quote,ragged-right,verbatim]
 701 {
 702   \ottava #1
 703   \set Staff.ottavation = #"8"
 704   c'''
 705 }
 706 @end lilypond
 707
 708
 709 @seealso
 710
 711 Référence du programme : @rinternals{OttavaBracket}.
 712
 713
 714 @knownissues
 715
 716 @code{ottava} gère difficilement les changements de clé qui
 717 pourraient intervenir alors qu'elle est effective.
 718
 719
 720 @node Instrument transpositions
 721 @unnumberedsubsubsec Instrument transpositions
 722
 723 @cindex transposition, MIDI
 724 @cindex transposition, instrument
 725
 726 Vous pouvez spécifier la tonalité d'un instrument transpositeur, ce
 727 qui est le cas pour de nombreux instruments à vent comme la clarinette
 728 (si bémol, la ou mi bémol), le cor (fa), ou la trompette (si bémol,
 729 ut, ré ou mi bémol).
 730
 731 Cette transposition s'indique après le mot-clé @code{\transposition}.
 732
 733 @example
 734 \transposition bes   %% clarinette en si bémol
 735 @end example
 736
 737 @noindent
 738 Cette commande détermine la propriété @code{instrumentTransposition},
 739 dont la valeur sera utilisée pour le fichier MIDI et en cas de
 740 citation.  Elle n'affecte en rien la manière dont les notes seront
 741 imprimées sur la portée.  Référez-vous à la section @ref{Transpose}
 742 pour obtenir un autre résultat.
 743
 744 La hauteur donnée en argument à @code{\transposition} doit
 745 correspondre à la note entendue lorsqu'un @code{do} écrit sur la
 746 portée est joué par l'instrument transpositeur.  Par exemple, lorsque
 747 vous saisissez une partition en notes réelles, toutes les voix
 748 devraient être en ut ; pour les instruments transpositeurs, il faudra
 749 procéder de cette manière :
 750
 751 @example
 752 clarinet = @{
 753   \transposition c'
 754   ...
 755 @}
 756 saxophone = @{
 757   \transposition c'
 758   ...
 759 @}
 760 @end example
 761
 762 Lorsque vous entrez de la musique à partir d'une partie transposée,
 763 utilisez la commande @code{\transposition}.  Si l'on prend l'exemple
 764 des parties de cor, leur tonalité change souvent au cours d'un morceau ;
 765 en recopiant cette partie, utilisez @code{\transposition} ainsi :
 766
 767 @example
 768 \transposition d'
 769 c'4^"en ré"
 770 ...
 771 \transposition g'
 772 c'4^"en sol"
 773 ...
 774 @end example
 775
 776 @node Automatic accidentals
 777 @unnumberedsubsubsec Automatic accidentals
 778 @cindex Altérations accidentelles automatiques
 779
 780 Une fonction a été créée pour regrouper les règles suivant lesquelles
 781 s'impriment les altérations.  Elle s'invoque de la manière suivante :
 782
 783 @funindex set-accidental-style
 784 @example
 785 #(set-accidental-style 'REGLE)
 786 @end example
 787
 788 @c TODO: check the context stuff below
 789 @c -does it *really* work?
 790 @c -the default contexts as specified in
 791 @c  scm/music-function.scm seem to be different -vv
 792
 793 Cette fonction prend pour argument le nom de la règle d'altérations,
 794 auquel peut s'ajouter, comme argument facultatif, le contexte
 795 devant être affecté :
 796
 797 @example
 798 #(set-accidental-style 'REGLE #('CONTEXTE#))
 799 @end example
 800
 801 Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ;
 802 cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu
 803 et place.
 804
 805 Les régles d'altérations suivantes sont possibles :
 806
 807 @table @code
 808 @item default
 809 C'est la règle d'impression par défaut, qui se rapporte à l'usage
 810 en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
 811 une mesure, et uniquement à leur propre octave.
 812
 813
 814 @lilypond[quote,ragged-right]
 815 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 816        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 817
 818 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 819         \change Staff = up cis' \change Staff = down <fis, a>
 820         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 821         <f a d>2 |  } }}
 822
 823 \score {
 824         \new PianoStaff {
 825        << \context Staff = "up" {
 826                %#(set-accidental-style 'default)
 827        \musicA }
 828        \context Staff = "down"{
 829                %#(set-accidental-style 'default)
 830        \musicB } >> }
 831        \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
 832 }
 833 @end lilypond
 834
 835 @item voice
 836 En principe, LilyPond se souvient de toutes les altérations présentes sur la
 837 portée (contexte Staff).  Avec cette règle, cependant, les altérations sont indépendantes
 838 pour chacune des voix.
 839
 840
 841 @example
 842  \new Staff <<
 843         #(set-accidental-style 'voice)
 844         @{ @dots{} @}
 845         >>
 846 @end example
 847
 848 De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
 849 ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
 850 il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
 851
 852 @lilypond[quote,ragged-right]
 853 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 854        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 855
 856 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 857         \change Staff = up cis' \change Staff = down <fis, a>
 858         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 859         <f a d>2 |  } }}
 860
 861 \score {
 862         \new PianoStaff {
 863        << \context Staff = "up" {
 864                #(set-accidental-style 'voice)
 865        \musicA }
 866        \context Staff = "down"{
 867                #(set-accidental-style 'voice)
 868        \musicB } >> }
 869        \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
 870 }
 871 @end lilypond
 872
 873 La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
 874 des musiciens différents.  S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
 875 à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
 876
 877
 878 @item modern
 879 @funindex modern style accidentals
 880 Cette règle est la plus courante au XXème siècle.  Les altérations accidentelles
 881 sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
 882 apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
 883 sont ajoutés.  Dans l'exemple suivant, notez ainsi les deux bécarres dans la
 884 deuxième mesure de la main droite.
 885
 886 @lilypond[quote,ragged-right]
 887 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 888        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 889
 890 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 891         \change Staff = up cis' \change Staff = down <fis, a>
 892         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 893         <f a d>2 |  } }}
 894
 895 \score {
 896         \new PianoStaff {
 897        << \context Staff = "up" {
 898                #(set-accidental-style 'modern)
 899        \musicA }
 900        \context Staff = "down"{
 901                #(set-accidental-style 'modern)
 902        \musicB } >> }
 903        \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
 904 }
 905 @end lilypond
 906
 907 @item @code{modern-cautionary}
 908 @funindex modern-cautionary
 909 Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
 910 imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
 911 Il est possible de le définir au moyen de la propriété @code{cautionary-style}
 912 pour l'objet @rinternals{AccidentalSuggestion}.
 913
 914 @lilypond[quote,ragged-right]
 915 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 916        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 917
 918 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 919         \change Staff = up cis' \change Staff = down <fis, a>
 920         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 921         <f a d>2 |  } }}
 922
 923 \score {
 924         \new PianoStaff {
 925        << \context Staff = "up" {
 926                #(set-accidental-style 'modern-cautionary)
 927        \musicA }
 928        \context Staff = "down"{
 929                #(set-accidental-style 'modern-cautionary)
 930        \musicB } >> }
 931        \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
 932 }
 933 @end lilypond
 934
 935 @funindex modern-voice
 936 @item modern-voice
 937 Cette règle sert aux altérations dans de la musique polyphonique destinée
 938 autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
 939 Les altérations sont imprimées voix par voix, mais les autres voix, dans le même
 940 contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
 941
 942 @lilypond[quote,ragged-right]
 943 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 944        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 945
 946 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 947         \change Staff = up cis' \change Staff = down <fis, a>
 948         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 949         <f a d>2 |  } }}
 950
 951 \score {
 952         \new PianoStaff {
 953        << \context Staff = "up" {
 954                #(set-accidental-style 'modern-voice)
 955        \musicA }
 956        \context Staff = "down"{
 957                #(set-accidental-style 'modern-voice)
 958        \musicB } >> }
 959        \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
 960 }
 961 @end lilypond
 962
 963 @funindex modern-voice-cautionary
 964 @item modern-voice-cautionary
 965 Cette régle est similaire à la précédente, mais les altérations de précautions
 966 (celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
 967 particulière.  On retrouve donc toutes les altérations qu'imprimerait
 968 @code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
 969
 970 @lilypond[quote,ragged-right]
 971 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
 972        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
 973
 974 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
 975         \change Staff = up cis' \change Staff = down <fis, a>
 976         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
 977         <f a d>2 |  } }}
 978
 979 \score {
 980         \new PianoStaff {
 981        << \context Staff = "up" {
 982                #(set-accidental-style 'modern-voice-cautionary)
 983        \musicA }
 984        \context Staff = "down"{
 985                #(set-accidental-style 'modern-voice-cautionary)
 986        \musicB } >> }
 987        \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
 988 }
 989 @end lilypond
 990
 991 @item piano
 992 @funindex piano accidentals
 993 Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier
 994 pour chaque portée individuelle au sein du contexte GrandStaff.
 995
 996 @example
 997 \new GrandStaff @{ <<
 998   \new Staff = "up" @{ <<
 999     #(set-accidental-style 'piano)
1000     @{ @dots{} @}
1001   >> @}
1002   \new Staff = "down"@{ <<
1003     #(set-accidental-style 'piano)
1004   @{ @dots{} @}
1005   >> @}
1006 >> @}
1007 @end example
1008
1009 Cette règle est communément employée pour les partitions de piano au XXème siècle.
1010 Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
1011 les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
1012 @rinternals{PianoStaff}.
1013
1014 @lilypond[quote,ragged-right]
1015 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
1016        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
1017
1018 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
1019         \change Staff = up cis' \change Staff = down <fis, a>
1020         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
1021         <f a d>2 |  } }}
1022
1023 \score {
1024         \new PianoStaff {
1025        << \context Staff = "up" {
1026                #(set-accidental-style 'piano)
1027        \musicA }
1028        \context Staff = "down"{
1029                #(set-accidental-style 'piano)
1030        \musicB } >> }
1031        \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
1032 }
1033 @end lilypond
1034
1035 @item piano-cautionary
1036 @funindex #(set-accidental-style 'piano-cautionary)
1037 Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
1038 sont imprimées différemment.
1039
1040 @lilypond[quote,ragged-right]
1041 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
1042        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
1043
1044 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
1045         \change Staff = up cis' \change Staff = down <fis, a>
1046         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
1047         <f a d>2 |  } }}
1048
1049 \score {
1050         \new PianoStaff {
1051        << \context Staff = "up" {
1052                #(set-accidental-style 'piano-cautionary)
1053        \musicA }
1054        \context Staff = "down"{
1055                #(set-accidental-style 'piano-cautionary)
1056        \musicB } >> }
1057        \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
1058 }
1059 @end lilypond
1060
1061 @item no-reset
1062 @funindex no-reset accidental style
1063 C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
1064 ne cesse jamais, même dans les mesures suivantes.
1065 @lilypond[quote,ragged-right]
1066 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
1067        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
1068
1069 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
1070         \change Staff = up cis' \change Staff = down <fis, a>
1071         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
1072         <f a d>2 |  } }}
1073
1074 \score {
1075         \new PianoStaff {
1076        << \context Staff = "up" {
1077                #(set-accidental-style 'no-reset)
1078        \musicA }
1079        \context Staff = "down"{
1080                #(set-accidental-style 'no-reset)
1081        \musicB } >> }
1082        \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
1083 }
1084 @end lilypond
1085
1086 @item forget
1087 Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
1088 et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
1089 imprimées, en fonction de l'éventuelle armure.
1090
1091 @lilypond[quote,ragged-right]
1092 musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
1093        \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
1094
1095 musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4
1096         \change Staff = up cis' \change Staff = down <fis, a>
1097         \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
1098         <f a d>2 |  } }}
1099
1100 \score {
1101         \new PianoStaff {
1102        << \context Staff = "up" {
1103                #(set-accidental-style 'forget)
1104        \musicA }
1105        \context Staff = "down"{
1106                #(set-accidental-style 'forget)
1107        \musicB } >> }
1108        \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
1109 }
1110 @end lilypond
1111 @end table
1112
1113
1114 @seealso
1115
1116 Référence du programme : @rinternals{Accidental_engraver},
1117 @rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
1118
1119
1120 @knownissues
1121
1122 Les notes simultanées sont considérées comme des évènements séquentiels.
1123 Ce qui implique que, dans un accord, les altérations accidentelles seront
1124 imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
1125 de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
1126 sein d'un accord certaines altérations dépendent les unes des autres.
1127 Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
1128 concernées.
1129
1130
1131 @node Ambitus
1132 @unnumberedsubsubsec Ambitus
1133 @cindex ambitus
1134
1135 L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
1136 partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
1137 est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
1138 partitions vocales, afin que les exécutants puissent voir au premier
1139 coup d'oeil s'ils sont en mesure de tenir la partie en question.
1140
1141 Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
1142 représentant la hauteur la plus basse et la plus haute.  Pour imprimer
1143 cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
1144 au contexte @rinternals{Voice}.  Ainsi,
1145
1146 @example
1147 \layout @{
1148   \context @{
1149     \Voice
1150     \consists Ambitus_engraver
1151   @}
1152 @}
1153 @end example
1154
1155 @noindent
1156 donne pour résultat
1157
1158 @lilypond[quote,ragged-right]
1159 \layout {
1160   \context {
1161     \Staff
1162     \consists Ambitus_engraver
1163   }
1164 }
1165
1166 \relative \new Staff {
1167   as'' c e2 cis,2
1168 }
1169 @end lilypond
1170
1171 Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
1172 graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
1173 plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
1174 alors celui de toutes les voix cumulées, non d'une seule des voix
1175 actives.
1176
1177 @lilypond[verbatim,ragged-right,quote]
1178 \new Staff \with {
1179   \consists "Ambitus_engraver"
1180 }
1181 <<
1182   \new Voice \with {
1183     \remove "Ambitus_engraver"
1184   } \relative c'' {
1185     \override Ambitus #'X-offset = #-1.0
1186     \voiceOne
1187     c4 a d e f2
1188   }
1189   \new Voice \with {
1190     \remove "Ambitus_engraver"
1191   } \relative c' {
1192     \voiceTwo
1193     es4 f g as b2
1194   }
1195 >>
1196 @end lilypond
1197
1198 @noindent
1199 Cet exemple met en œuvre une fonctionnalité avancée :
1200
1201 @example
1202 \override Ambitus #'X-offset = #-1.0
1203 @end example
1204
1205 @noindent
1206 Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
1207 être obtenu avec @code{extra-offset}, mais alors le système de mise en
1208 forme n'aurait pas attribué d'espace supplémentaire pour l'objet
1209 déplacé.
1210
1211 @seealso
1212
1213 Référence du programme : @rinternals{Ambitus},
1214 @rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
1215 @rinternals{AmbitusAccidental}.
1216
1217 Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
1218
1219 @knownissues
1220
1221 LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
1222 une même portée.
1223
1224
1225 @node Note heads
1226 @subsection Note heads
1227
1228 @menu
1229 * Special note heads::
1230 * Easy notation note heads::
1231 * Shape note heads::
1232 * Improvisation::
1233 @end menu
1234
1235 @node Special note heads
1236 @unnumberedsubsubsec Special note heads
1237
1238 @cindex têtes de note, spéciales
1239
1240 Certains instruments utilisent des têtes de note différentes à des
1241 fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
1242 notes étouffées des guitares ; des losanges pour les harmoniques des
1243 cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
1244 losange ; pour les autres styles de tête, il vous faudra jouer avec la
1245 propriété @code{NoteHead}.
1246
1247 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
1248 c4 d
1249 \override NoteHead #'style = #'cross
1250 e f
1251 \revert NoteHead #'style
1252 e d <c f\harmonic> <d a'\harmonic>
1253 @end lilypond
1254
1255 @noindent
1256 Pour une liste exhaustive des styles de tête de note, consultez
1257 @ref{Note head styles}.
1258
1259
1260 @seealso
1261
1262 Référence du programme : @rinternals{NoteHead}.
1263
1264
1265 @node Easy notation note heads
1266 @unnumberedsubsubsec Easy notation note heads
1267
1268 @cindex tête de note, apprentissage
1269 @cindex notation facile
1270 @cindex Hal Leonard
1271
1272 Les notes @q{easy play} comportent le nom de la note à l'intérieur de
1273 la tête.  On l'utilise dans des partitions pour débutants.
1274
1275 @lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
1276   \easyHeadsOn
1277   c'2 e'4 f' | g'1
1278 @end lilypond
1279
1280 La commande @code{\easyHeadsOn} remplace tous les réglages de l'objet
1281 @rinternals{NoteHead}.  L'impression doit être de plus grande
1282 taille, afin que les lettres soient lisibles.  Voir à ce propos
1283 @ref{Setting the staff size}.
1284
1285 @predefined
1286
1287 @funindex \easyHeadsOn
1288 @code{\easyHeadsOn}
1289
1290
1291 @node Shape note heads
1292 @unnumberedsubsubsec Shape note heads
1293
1294 @cindex tête de note, allure
1295
1296 En notation profilée, le profil d'une tête de note correspond à la
1297 fonction harmonique de cette note dans la gamme.  Ce style de notation
1298 était très en vogue dans les recueils de chansons américains du XIXe
1299 siècle.
1300
1301 Des notes profilées sont produites après activation de
1302 @code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
1303
1304 @lilypond[verbatim,relative=1,fragment]
1305   \aikenHeads
1306   c8 d4 e8 a2 g1
1307   \sacredHarpHeads
1308   c8 d4. e8 a2 g1
1309 @end lilypond
1310
1311 Les profils sont déterminés par la hauteur dans la gamme, le premier
1312 degré étant défini par la commande @code{\key}.
1313
1314 @funindex \key
1315 @funindex shapeNoteStyles
1316 @funindex \aikenHeads
1317 @funindex \sacredHarpHeads
1318
1319 Les notes profilées sont mises en œuvre par la propriété
1320 @code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
1321 de symboles.  Le n-ième élément indique le style à utiliser pour le
1322 n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
1323
1324 @lilypond[verbatim,relative=1,fragment]
1325   \set shapeNoteStyles  = #'#(cross triangle fa #f mensural xcircle diamond)
1326   c8 d4. e8 a2 g1
1327 @end lilypond
1328
1329
1330 @node Improvisation
1331 @unnumberedsubsubsec Improvisation
1332
1333 L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
1334 allongée (@emph{slash}).  Ces têtes de notes sont créées  par
1335 l'adjonction du graveur @rinternals{Pitch_squash_engraver} au
1336 contexte @rinternals{Voice}, de telle sorte que la commande
1337
1338 @example
1339 \set squashedPosition = #0
1340 \override NoteHead #'style = #'slash
1341 @end example
1342
1343 @noindent
1344 active les notes penchées.
1345
1346 Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
1347 @code{\improvisationOff} pour cette séquence, comme l'illustre
1348 l'exemple ci dessous.
1349
1350 @lilypond[verbatim,ragged-right,quote]
1351 \new Voice \with {
1352   \consists Pitch_squash_engraver
1353 } \transpose c c' {
1354   e8 e g a a16(bes)(a8) g \improvisationOn
1355   e8
1356   ~e2~e8 f4 fis8
1357   ~fis2 \improvisationOff a16(bes) a8 g e
1358 }
1359 @end lilypond