Documentation/fr/notation/editorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2
   3 @ignore
   4    Translation of GIT committish: 16d46fb0995cc6d078617ada1e8fea7879dffe07
   5
   6    When revising a translation, copy the HEAD committish of the
   7    version that you are working on.  For details, see the Contributors'
   8    Guide, node Updating translation committishes..
   9 @end ignore
  10
  11 @c \version "2.19.21"
  12
  13 @c Translators: Jean-Charles Malahieude
  14
  15 @node Annotations éditoriales
  16 @section Annotations éditoriales
  17 @translationof Editorial annotations
  18
  19 @lilypondfile[quote]{editorial-headword.ly}
  20
  21 Ce chapitre traite de la manière de modifier l'apparence des notes dans
  22 un but pédagogique ou d'analyse.
  23
  24 @menu
  25 * Dans la portée::
  26 * Hors de la portée::
  27 @end menu
  28
  29
  30 @node Dans la portée
  31 @subsection Dans la portée
  32 @translationof Inside the staff
  33
  34 Nous allons voir ici comment mettre en exergue certains éléments à
  35 l'intérieur même de la portée.
  36
  37 @menu
  38 * Indication de la taille de fonte musicale::
  39 * Doigtés::
  40 * Dictée à trous::
  41 * Coloration d'objets::
  42 * Parenthèses::
  43 * Hampes::
  44 @end menu
  45
  46
  47 @node Indication de la taille de fonte musicale
  48 @unnumberedsubsubsec Indication de la taille de fonte musicale
  49 @translationof Selecting notation font size
  50
  51 @cindex sélection de la taille (notation)
  52 @cindex notes, taille
  53 @cindex taille des notes
  54 @cindex têtes de note
  55
  56 @funindex fontSize
  57 @funindex font-size
  58 @funindex magnification->font-size
  59 @funindex magstep
  60 @funindex magnifyMusic
  61 @funindex \teeny
  62 @funindex \tiny
  63 @funindex \small
  64 @funindex \normalsize
  65 @funindex \large
  66 @funindex \huge
  67 @funindex teeny
  68 @funindex tiny
  69 @funindex small
  70 @funindex normalsize
  71 @funindex large
  72 @funindex huge
  73
  74 @warning{@*
  75 Pour les tailles de police textuelle, voir
  76 @ref{Sélection de la fonte et de la taille}.@*
  77 Pour la taille des portées, voir
  78 @ref{Définition de la taille de portée}.@*
  79 Pour les petites notes, voir
  80 @ref{Mise en forme d'une citation}.@*
  81 Pour les variantes, voir @ref{Portées d'ossia}.}
  82
  83 Le plus sûr moyen de régler la taille des éléments de notation sans
  84 modifier la taille de la portée consiste à utiliser la commande
  85 @code{\magnifyMusic} :
  86
  87 @c Grieg Piano Concerto (mvt.1 cadenza)
  88 @lilypond[verbatim,quote]
  89 \new Staff <<
  90   \new Voice \relative {
  91     \voiceOne
  92     <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
  93   }
  94   \new Voice \relative {
  95     \voiceTwo
  96     \magnifyMusic 0.63 {
  97       \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
  98       r32 c'' a c a c a c r c a c a c a c
  99       r c a c a c a c a c a c a c a c
 100     }
 101   }
 102 >>
 103 @end lilypond
 104
 105 La présence d'un @code{\override} dans cet exemple permet de
 106 contourner une bogue -- voir « Problèmes connus et avertissements » en
 107 fin de section.
 108
 109 Dans le cas de fusion d'une tête de note normale avec une autre de
 110 taille inférieure, la taille de la petite note peut nécessiter une
 111 réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} --
 112 de telle sorte que les hampes et altérations s'alignent correctement :
 113
 114 @c Chopin Prelude op.28 no.8
 115 @lilypond[verbatim,quote]
 116 \new Staff <<
 117   \key fis \minor
 118   \mergeDifferentlyDottedOn
 119   \new Voice \relative {
 120     \voiceOne
 121     \magnifyMusic 0.63 {
 122       \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
 123       \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
 124       \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
 125       \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
 126       \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
 127     }
 128   }
 129   \new Voice \relative {
 130     \voiceTwo
 131     cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
 132   }
 133 >>
 134 @end lilypond
 135
 136 La commande @code{\magnifyMusic} n'est pas conçue pour gérer les
 137 citations, notes d'ornement ou portées d'ossia -- des moyens
 138 spécifiques sont déjà disponibles en la matière.  Elle est par contre
 139 tout à fait adaptée dans le cas d'un instrument particulier disposant de
 140 sa propre portée là où des notes d'ornement seraient inappropriées,
 141 comme pour une pseudo-cadence ou les exemples ci-dessus.  L'attribution
 142 d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un
 143 contexte @code{CueVoice}.
 144
 145 @warning{La commande @code{@bs{}magnifyMusic} n'est pas censée
 146 intervenir en complément d'une modification de la taille de portée --
 147 voir @ref{Définition de la taille de portée}.}
 148
 149
 150 @subsubsubheading Redimmensionnement individuel d'objets de rendu
 151 @c VO Resizing individual layout objects
 152
 153 L'ajustement de la propriété @code{font-size} à l'aide des commandes
 154 @code{\tweak} ou @code{\override} permet de retailler un objet de rendu
 155 particulier :
 156
 157 @lilypond[quote,verbatim]
 158 \relative {
 159   % resize a note head
 160   <f' \tweak font-size -4 b e>-5
 161   % resize a fingering
 162   bes-\tweak font-size 0 -3
 163   % resize an accidental
 164   \once \override Accidental.font-size = -4 bes!-^
 165   % resize an articulation
 166   \once \override Script.font-size = 4 bes!-^
 167 }
 168 @end lilypond
 169
 170 La valeur par défaut de @code{font-size} est mentionnée, pour chaque
 171 objet de rendu, dans la référence des propriétés internes.  La propriété
 172 @code{font-size} ne peut intervenir que pour les objets qui utilisent
 173 des polices, autrement dit ceux qui disposent de l'interface de rendu
 174 @code{font-interface}.  L'abence de @code{font-size} dans la liste des
 175 « réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir
 176 @rinternals{All layout objects} @emph{(Tous les objets de rendu)}.
 177
 178
 179 @subsubsubheading La propriété @code{fontSize}
 180 @c VO Understanding the @code{fontSize} property
 181
 182 La propriété @code{fontSize} d'un contexte a pour effet de définir la
 183 taille proportionnelle de tout élément de notation basé sur un
 184 glyphe dans ce contexte :
 185
 186 @lilypond[verbatim,quote]
 187 \relative {
 188   \time 3/4
 189   d''4---5 c8( b a g) |
 190   \set fontSize = -6
 191   e'4-- c!8-4( b a g) |
 192   \set fontSize = 0
 193   fis4---3 e8( d) fis4 |
 194   g2.
 195 }
 196 @end lilypond
 197
 198 La valeur de @code{fontSize} est un nombre indiquant la taille
 199 relative par rapport à la hauteur standard de la portée en cours.
 200 La valeur par défaut de @code{fontSize} est de 0.  Un pas de six
 201 aboutit exactement au doublement de la taille ; un pas de moins
 202 six la réduit de moitié.  Chaque incrément correspond à une
 203 augmentation d'environ 12 % de la taille de la police.
 204
 205 La fonction Scheme @code{magnification->font-size} permet de
 206 s'affranchir de l'échelle logarithmique peu intuitive des unités
 207 de la propriété @code{font-size}.  Ainsi, l'ajustement à 75 % de
 208 la notation musicale par rapport à la taille de la portée peut se
 209 libeller :
 210
 211 @example
 212 \set fontSize = #(magnification->font-size 0.75)
 213 @end example
 214
 215 La fonction Scheme @code{magstep} quant à elle effectue
 216 l'inverse : elle convertit le nombre affecté à @code{font-size} en
 217 facteur d'échelle.
 218
 219 La propriété @code{fontSize} affecte uniquement les éléments de
 220 notation reposant sur des glyphes, tels les têtes de note,
 221 altérations, scripts, etc.  Elle n'aura aucun effet sur la taille
 222 de la portée, la hauteur des hampes ou la longueur des ligatures
 223 ni sur l'espacement horizontal.  L'échelonnement des hampes,
 224 ligature et espacement horizontal, couplé à la taille de la
 225 notation (sans modification de la taille de la portée), s'obtient
 226 à l'aide de la commande @code{\magnifyMusic} comme nous venons de
 227 le voir.  La modification de l'ensemble, y compris la taille de
 228 portée, est abordé dans @ref{Définition de la taille de portée}.
 229
 230 Dès lors que la @strong{propriété de contexte} @code{fontSize} est
 231 définie, sa valeur est ajoutée individuellement à la valeur de la
 232 @strong{propriété de @emph{grob}} @code{font-size} des objets de
 233 rendu.  Ceci peut être source de confusion lorsque des propriétés
 234 @code{font-size} individuelles sont réglées alors que
 235 @code{fontSize} est déjà fixé :
 236
 237 @lilypond[verbatim,quote,fragment]
 238 % the default font-size for NoteHead is 0
 239 % the default font-size for Fingering is -5
 240 c''4-3
 241
 242 \set fontSize = -3
 243 % the effective font size for NoteHead is now -3
 244 % the effective font size for Fingering is now -8
 245 c''4-3
 246
 247 \override Fingering.font-size = 0
 248 % the effective font size for Fingering is now -3
 249 c''4-3
 250 @end lilypond
 251
 252 LilyPond dispose d'un certain nombre de raccourcis :
 253
 254 @multitable @columnfractions .2 .4 .4
 255 @item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative}
 256 @item @code{\teeny}      @tab @code{\set fontSize = -3} @tab 71 %
 257 @item @code{\tiny}       @tab @code{\set fontSize = -2} @tab 79 %
 258 @item @code{\small}      @tab @code{\set fontSize = -1} @tab 89 %
 259 @item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 %
 260 @item @code{\large}      @tab @code{\set fontSize = 1} @tab 112 %
 261 @item @code{\huge}       @tab @code{\set fontSize = 2} @tab 126 %
 262 @end multitable
 263
 264 @lilypond[verbatim,quote]
 265 \relative c'' {
 266   \teeny
 267   c4.-> d8---3
 268   \tiny
 269   c4.-> d8---3
 270   \small
 271   c4.-> d8---3
 272   \normalsize
 273   c4.-> d8---3
 274   \large
 275   c4.-> d8---3
 276   \huge
 277   c4.-> d8---3
 278 }
 279 @end lilypond
 280
 281 @cindex standard, taille des notes
 282 @cindex notes, taille standard
 283
 284 @funindex font-interface
 285 @funindex font-size
 286
 287 Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
 288 dont la taille est la plus proche de la taille voulue.  La taille
 289 standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
 290 de la portée.  À une portée de 20 points correspond une police de
 291 11 points.
 292
 293
 294 @predefined
 295 @code{\magnifyMusic},
 296 @code{\teeny},
 297 @code{\tiny},
 298 @code{\small},
 299 @code{\normalsize},
 300 @code{\large},
 301 @code{\huge}.
 302 @endpredefined
 303
 304 @seealso
 305 Manuel de notation :
 306 @ref{Définition de la taille de portée},
 307 @ref{Mise en forme d'une citation},
 308 @ref{Portées d'ossia},
 309 @ref{Sélection de la fonte et de la taille}.
 310
 311 Fichiers d'initialisation :
 312 @file{ly/music-functions-init.ly},
 313 @file{ly/property-init.ly}.
 314
 315 Morceaux choisis :
 316 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 317
 318 Référence des propriétés internes :
 319 @rinternals{font-interface}.
 320
 321 @c The two issues mentioned below:
 322 @c http://code.google.com/p/lilypond/issues/detail?id=3987
 323 @c http://code.google.com/p/lilypond/issues/detail?id=3990
 324 @knownissues
 325 Deux bogues actuellement répertoriés font obstacle à un espacement
 326 horizontal correct avec @code{\magnifyMusic}.  La seule façon de les
 327 contourner n'est cependant pas garantie dans toutes les situations.
 328 Dans l'exemple suivant, il vous faudra adapter la valeur de la variable
 329 @var{mag}.  Vous pourriez aussi tenter de supprimer une ou les deux
 330 commandes @code{\newSpacingSection}, ou les commandes @code{\override}
 331 et @code{\revert} :
 332
 333 @example
 334 \magnifyMusic @var{mag} @{
 335   \newSpacingSection
 336   \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
 337   [@var{musique}]
 338   \newSpacingSection
 339   \revert Score.SpacingSpanner.spacing-increment
 340 @}
 341 @end example
 342
 343
 344 @node Doigtés
 345 @unnumberedsubsubsec Doigtés
 346 @translationof Fingering instructions
 347
 348 @cindex doigté
 349 @cindex substitution de doigt
 350
 351 @funindex \finger
 352 @funindex finger
 353
 354 Les doigtés peuvent être indiqués comme suit :
 355 @var{note}-@var{chiffre_du_doigt}
 356
 357 @lilypond[verbatim,quote]
 358 \relative { c''4-1 d-2 f-4 e-3 }
 359 @end lilypond
 360
 361 Pour les substitutions de doigts, on a recours à une indication
 362 textuelle (commande @code{\markup}) de doigté (commande @code{\finger}).
 363
 364 @lilypond[verbatim,quote]
 365 \relative {
 366   c''4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
 367 }
 368 @end lilypond
 369
 370 @cindex pouce, doigté
 371
 372 @funindex \thumb
 373 @funindex thumb
 374
 375 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 376 dans une partition de violoncelle, si une note doit être jouée avec le
 377 pouce (@emph{thumb} en anglais).
 378
 379 @lilypond[verbatim,quote]
 380 \relative { <a'_\thumb a'-3>2 <b_\thumb b'-3> }
 381 @end lilypond
 382
 383 @cindex doigtés des accords
 384 @cindex accords, doigtés
 385
 386 Les doigtés des accords peuvent être saisis note par note,
 387 en les indiquant après chaque hauteur de note.
 388
 389 @lilypond[verbatim,quote]
 390 \relative {
 391   <c''-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 392 }
 393 @end lilypond
 394
 395 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
 396 la portée -- voir @ref{Direction et positionnement} à ce sujet.
 397
 398 @snippets
 399
 400 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 401 {controlling-the-placement-of-chord-fingerings.ly}
 402
 403 @lilypondfile[verbatim,quote,texidoc,doctitle]
 404 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 405
 406 @lilypondfile[verbatim,quote,texidoc,doctitle]
 407 {avoiding-collisions-with-chord-fingerings.ly}
 408
 409 @seealso
 410 Manuel de notation :
 411 @ref{Direction et positionnement}.
 412
 413 Morceaux choisis :
 414 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
 415
 416 Référence des propriétés internes :
 417 @rinternals{FingeringEvent},
 418 @rinternals{fingering-event},
 419 @rinternals{Fingering_engraver},
 420 @rinternals{New_fingering_engraver},
 421 @rinternals{Fingering}.
 422
 423
 424 @node Dictée à trous
 425 @unnumberedsubsubsec Dictée à trous
 426 @translationof Hidden notes
 427
 428 @cindex masquées, notes
 429 @cindex invisibles, notes
 430 @cindex transparentes, notes
 431 @cindex note invisible
 432 @cindex note masquée
 433
 434 @funindex \hideNotes
 435 @funindex hideNotes
 436 @funindex \unHideNotes
 437 @funindex unHideNotes
 438
 439 Les notes masquées -- ou invisibles ou encore transparentes -- sont
 440 utiles dans le cadre d'exercices de théorie ou de composition.
 441
 442 @lilypond[verbatim,quote]
 443 \relative {
 444   c''4 d
 445   \hideNotes
 446   e4 f
 447   \unHideNotes
 448   g a
 449   \hideNotes
 450   b
 451   \unHideNotes
 452   c
 453 }
 454 @end lilypond
 455
 456 Têtes de note, hampes, crochets et silences sont invisibles.  Une
 457 ligature sera invisible si elle démarre sur une note invisible.
 458 Les objets de notation attachés à une note invisible ne seront pas
 459 masqués pour autant.
 460
 461 @lilypond[verbatim,quote]
 462 \relative c'' {
 463   e8(\p f g a)--
 464   \hideNotes
 465   e8(\p f g a)--
 466 }
 467 @end lilypond
 468
 469 @predefined
 470 @code{\hideNotes},
 471 @code{\unHideNotes}.
 472 @endpredefined
 473
 474 @seealso
 475 Manuel d'initiation :
 476 @rlearning{Visibilité et couleur des objets}.
 477
 478 Manuel de notation :
 479 @ref{Masquage de portées},
 480 @ref{Silences invisibles},
 481 @ref{Visibilité des objets}.
 482
 483 Morceaux choisis :
 484 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 485
 486 Référence des propriétés internes :
 487 @rinternals{Note_spacing_engraver},
 488 @rinternals{NoteSpacing}.
 489
 490
 491 @node Coloration d'objets
 492 @unnumberedsubsubsec Coloration d'objets
 493 @translationof Coloring objects
 494
 495 @cindex objets en couleur
 496 @cindex couleurs
 497 @cindex colorisation d'objets
 498 @cindex coloration d'objets
 499 @cindex coloration de notes
 500 @cindex colorisation de notes
 501 @cindex notes en couleur
 502 @cindex x11, couleurs
 503 @cindex couleurs x11
 504
 505 @funindex color
 506 @funindex \with-color
 507 @funindex with-color
 508 @funindex x11-color
 509
 510 Des objets peuvent être colorisés individuellement.  Une listes des
 511 noms des couleurs disponibles se trouvent à l'annexe
 512 @ref{Liste des couleurs}.
 513
 514 @lilypond[verbatim,quote,fragment]
 515 \override NoteHead.color = #red
 516 c''4 c''
 517 \override NoteHead.color = #(x11-color 'LimeGreen)
 518 d''
 519 \override Stem.color = #blue
 520 e''
 521 @end lilypond
 522
 523 L'intégralité de la palette des couleurs définies pour X11 est
 524 accessible par la fonction Scheme @code{x11-color}.  Cette fonction
 525 prend en argument une expression symbolique de la forme
 526 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
 527 @code{@var{"TaraTata"}}.  La première formulation est à la fois plus
 528 rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
 529 permet d'accéder aux noms composés des couleurs de X11.
 530
 531 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
 532 elle revient à la couleur par défaut, le noir.  Le problème ressort de
 533 façon évidente au vu de la partition finale.
 534
 535 @lilypond[verbatim,quote]
 536 \relative c'' {
 537   \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
 538   \set Staff.instrumentName = \markup {
 539     \with-color #(x11-color 'navy) "Clarinet"
 540   }
 541
 542   gis8 a
 543   \override Beam.color = #(x11-color "medium turquoise")
 544   gis a
 545   \override Accidental.color = #(x11-color 'DarkRed)
 546   gis a
 547   \override NoteHead.color = #(x11-color "LimeGreen")
 548   gis a
 549   % this is deliberate nonsense; note that the stems remain black
 550   \override Stem.color = #(x11-color 'Boggle)
 551   b2 cis
 552 }
 553 @end lilypond
 554
 555 @cindex rgb-color
 556 @cindex couleur rgb
 557 @cindex couleur rvb
 558 @cindex rgb, couleur
 559 @cindex rvb, couleur
 560
 561 @funindex rgb-color
 562
 563 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
 564 les composantes de la couleur exacte au format rouge-vert-bleu
 565 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
 566 l'exemple suivant correspond à 128).
 567
 568 @lilypond[verbatim,quote]
 569 \relative c'' {
 570   \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
 571   \set Staff.instrumentName = \markup {
 572     \with-color #(x11-color 'navy) "Clarinet"
 573   }
 574
 575   \override Stem.color = #(rgb-color 0 0 0)
 576   gis8 a
 577   \override Stem.color = #(rgb-color 1 1 1)
 578   gis8 a
 579   \override Stem.color = #(rgb-color 0 0 0.5)
 580   gis4 a
 581 }
 582 @end lilypond
 583
 584 @seealso
 585 Manuel de notation :
 586 @ref{La commande d'affinage (tweak)},
 587 @ref{Liste des couleurs}.
 588
 589 Morceaux choisis :
 590 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 591
 592 @cindex x11, couleur
 593 @cindex couleur, notes d'un accord
 594 @cindex notes colorisées dans un accord
 595 @cindex accords et couleur
 596
 597 @funindex x11-color
 598
 599 @knownissues
 600 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
 601 normale ayant un nom similaire.
 602
 603 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 604 internet.  Aussi nous vous recommandons, dans le cadre d'une
 605 présentation multimédia, d'utiliser des couleurs de base @code{blue},
 606 @code{green}, @code{red} -- bleu, vert, rouge.
 607
 608 Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
 609 d'un accord avec @code{\override}.  Si besoin est, utilisez
 610 @code{\tweak} ou @code{\single\override} devant la note en question.
 611 Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 612
 613
 614 @node Parenthèses
 615 @unnumberedsubsubsec Parenthèses
 616 @translationof Parentheses
 617
 618 @cindex fantômes, notes
 619 @cindex notes fantômes
 620 @cindex parenthèses, notes entre
 621 @cindex crochets, notes entre
 622
 623 @funindex \parenthesize
 624 @funindex parenthesize
 625
 626 Des objets peuvent être mis entre parenthèses en saisissant
 627 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
 628 préfixe un accord, chaque note le composant se présentera entre
 629 parenthèses.  Vous pouvez aussi mettre individuellement entre
 630 parenthèses les notes d'un accord.
 631
 632 @lilypond[verbatim,quote]
 633 \relative {
 634   c''2 \parenthesize d
 635   c2 \parenthesize <c e g>
 636   c2 <c \parenthesize e g>
 637 }
 638 @end lilypond
 639
 640 Les objets autres que des notes peuvent aussi être entre parenthèses.
 641 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
 642 doit cependant être précédée d'un tiret.
 643
 644 @lilypond[verbatim,quote]
 645 \relative {
 646   c''2-\parenthesize -. d
 647   c2 \parenthesize r
 648 }
 649 @end lilypond
 650
 651 @seealso
 652 Morceaux choisis :
 653 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 654
 655 Référence des propriétés internes :
 656 @rinternals{Parenthesis_engraver},
 657 @rinternals{ParenthesesItem},
 658 @rinternals{parentheses-interface}.
 659
 660 @knownissues
 661 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
 662 individuellement à chacune des notes le composant, alors qu'on
 663 attendrait une seule paire de parenthèses encadrant tout l'accord.
 664
 665
 666 @node Hampes
 667 @unnumberedsubsubsec Hampes
 668 @translationof Stems
 669
 670 @cindex hampes
 671 @cindex hampes invisibles
 672 @cindex visibilité des hampes
 673 @cindex masquage des hampes
 674 @cindex hampe, orientation
 675 @cindex hampe montante
 676 @cindex hampe descendante
 677 @cindex hampe neutre
 678
 679 @funindex \stemUp
 680 @funindex stemUp
 681 @funindex \stemDown
 682 @funindex stemDown
 683 @funindex \stemNeutral
 684 @funindex stemNeutral
 685
 686 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
 687 automatiquement.  Pour les rondes et les silences, ils sont aussi
 688 créés, mais en mode invisible.
 689
 690 L'orientation des hampes peut être définie manuellement -- voir
 691 @ref{Direction et positionnement} à ce sujet.
 692
 693 @predefined
 694 @code{\stemUp},
 695 @code{\stemDown},
 696 @code{\stemNeutral}.
 697 @endpredefined
 698
 699 @snippets
 700
 701 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 702 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 703
 704 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 705 {automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
 706
 707 @seealso
 708 Manuel de notation :
 709 @ref{Direction et positionnement}.
 710
 711 Morceaux choisis :
 712 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 713
 714 Référence des propriétés internes :
 715 @rinternals{Stem_engraver},
 716 @rinternals{Stem},
 717 @rinternals{stem-interface}.
 718
 719
 720 @node Hors de la portée
 721 @subsection Hors de la portée
 722 @translationof Outside the staff
 723
 724 Nous allons nous intéresser ici à souligner des éléments inscrits dans
 725 la portée par des éléments qui lui seront externes.
 726
 727 @menu
 728 * Info-bulle::
 729 * Quadrillage temporel::
 730 * Crochets d'analyse::
 731 @end menu
 732
 733
 734 @node Info-bulle
 735 @unnumberedsubsubsec Info-bulle
 736 @translationof Balloon help
 737
 738 @cindex bulle
 739 @cindex notation, explication
 740 @cindex info-bulle
 741
 742 @funindex \balloonGrobText
 743 @funindex \balloonText
 744 @funindex Balloon_engraver
 745 @funindex balloonGrobText
 746 @funindex balloonText
 747 @funindex \balloonLengthOn
 748 @funindex balloonLengthOn
 749 @funindex \balloonLengthOff
 750 @funindex balloonLengthOff
 751
 752 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 753 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
 754 notation.
 755
 756 En voici un exemple :
 757 @c KEEP LY
 758 @lilypond[verbatim,quote]
 759 \new Voice \with { \consists "Balloon_engraver" }
 760 \relative c'' {
 761   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 762   a8
 763   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
 764   r
 765   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
 766 }
 767 @end lilypond
 768
 769 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
 770 @code{balloonText}.  @code{balloonGrobText} prend en argument l'objet
 771 graphique à agrémenter et s'utilise comme @code{\once \override}.
 772 @code{balloonText}, quant à lui, s'utilise comme une simple articulation
 773 et fonctionne comme @code{\tweak} pour attacher du texte à l'une des
 774 notes d'un accord.  Les autres arguments sont le décalage et le texte de
 775 la bulle.
 776
 777 Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
 778 peut toutefois le gérer ainsi :
 779
 780 @c KEEP LY
 781 @lilypond[verbatim,quote]
 782 \new Voice \with { \consists "Balloon_engraver" }
 783 \relative c'' {
 784   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 785   a8
 786   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
 787   r
 788   \balloonLengthOn
 789   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
 790 }
 791 @end lilypond
 792
 793 @predefined
 794 @code{\balloonLengthOn},
 795 @code{\balloonLengthOff}.
 796 @endpredefined
 797
 798 @seealso
 799 Morceaux choisis :
 800 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 801
 802 Référence des propriétés internes :
 803 @rinternals{Balloon_engraver},
 804 @rinternals{BalloonTextItem},
 805 @rinternals{balloon-interface}.
 806
 807
 808 @node Quadrillage temporel
 809 @unnumberedsubsubsec Quadrillage temporel
 810 @translationof Grid lines
 811
 812 @cindex quadrillage temporel
 813 @cindex temporel, quadrillage
 814
 815 @funindex Grid_point_engraver
 816 @funindex Grid_line_span_engraver
 817 @funindex gridInterval
 818
 819 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 820 les notes.
 821
 822 LilyPond a recours à deux graveurs distincts afin d'afficher le
 823 quadrillage :  le @code{Grid_point_engraver} se charge de déterminer
 824 l'envergure du crochet, alors que le @code{Grid_line_span_engraver} se
 825 consacrera au tracé des lignes.  Les lignes sont par défaut centrées
 826 horizontalement sous les notes et alignées sur la gauche des têtes.  La
 827 propriété @code{gridInterval} spécifie quant à elle l'espace de temps
 828 entre chaque ligne.
 829
 830 @c KEEP LY
 831 @lilypond[verbatim,quote]
 832 \layout {
 833   \context {
 834     \Staff
 835     \consists "Grid_point_engraver" %% active les guides
 836     gridInterval = #(ly:make-moment 1/4)
 837   }
 838   \context {
 839     \Score
 840     \consists "Grid_line_span_engraver"
 841      %% centre les lignes guides horizontalement sous les notes
 842   }
 843 }
 844
 845 \score {
 846   \new ChoirStaff <<
 847     \new Staff \relative {
 848       \stemUp
 849       c''4. d8 e8 f g4
 850     }
 851     \new Staff \relative {
 852     %% centre les lignes guides verticalement
 853       \clef bass
 854       \stemDown
 855       c4  g'  f  e
 856     }
 857   >>
 858 }
 859 @end lilypond
 860
 861 @snippets
 862
 863 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 864 {grid-lines--changing-their-appearance.ly}
 865
 866 @seealso
 867 Morceaux choisis :
 868 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 869
 870 Référence des propriétés internes :
 871 @rinternals{Grid_line_span_engraver},
 872 @rinternals{Grid_point_engraver},
 873 @rinternals{GridLine},
 874 @rinternals{GridPoint},
 875 @rinternals{grid-line-interface},
 876 @rinternals{grid-point-interface}.
 877
 878
 879 @node Crochets d'analyse
 880 @unnumberedsubsubsec Crochets d'analyse
 881 @translationof Analysis brackets
 882
 883 @cindex crochets
 884 @cindex crochets de phrasé
 885 @cindex analyse musicologique
 886 @cindex crochet de regroupement de notes
 887 @cindex musicologie, crochets d'analyse
 888
 889 @funindex Horizontal_bracket_engraver
 890 @funindex \startGroup
 891 @funindex startGroup
 892 @funindex \stopGroup
 893 @funindex stopGroup
 894
 895 On utilise des crochets en analyse musicale, pour indiquer la
 896 structure d'une pièce.
 897
 898 @lilypond[verbatim,quote]
 899 \layout {
 900   \context {
 901     \Voice
 902     \consists "Horizontal_bracket_engraver"
 903   }
 904 }
 905 \relative {
 906   c''2\startGroup
 907   d\stopGroup
 908 }
 909 @end lilypond
 910
 911 Les crochets d'analyses sont susceptibles d'être imbriqués :
 912
 913 @lilypond[verbatim,quote]
 914 \layout {
 915   \context {
 916     \Voice
 917     \consists "Horizontal_bracket_engraver"
 918   }
 919 }
 920 \relative {
 921   c''4\startGroup\startGroup
 922   d4\stopGroup
 923   e4\startGroup
 924   d4\stopGroup\stopGroup
 925 }
 926 @end lilypond
 927
 928 @seealso
 929 Morceaux choisis :
 930 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 931
 932 Référence des propriétés internes :
 933 @rinternals{Horizontal_bracket_engraver},
 934 @rinternals{HorizontalBracket},
 935 @rinternals{horizontal-bracket-interface},
 936 @rinternals{Staff}.