Documentation/fr/notation/editorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2
   3 @ignore
   4    Translation of GIT committish: b7fff49e6e45ba9d3e3b48df76fe36d60dab518c
   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
 353 Les doigtés peuvent être indiqués comme suit :
 354 @var{note}-@var{chiffre_du_doigt}
 355
 356 @lilypond[verbatim,quote]
 357 \relative { c''4-1 d-2 f-4 e-3 }
 358 @end lilypond
 359
 360 Pour les substitutions de doigts, on a recours à une indication
 361 textuelle (commande @code{\markup}) de doigté (commande @code{\finger}).
 362
 363 @lilypond[verbatim,quote]
 364 \relative {
 365   c''4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
 366 }
 367 @end lilypond
 368
 369 @cindex pouce, doigté
 370
 371 @funindex \thumb
 372
 373 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 374 dans une partition de violoncelle, si une note doit être jouée avec le
 375 pouce (@emph{thumb} en anglais).
 376
 377 @lilypond[verbatim,quote]
 378 \relative { <a'_\thumb a'-3>2 <b_\thumb b'-3> }
 379 @end lilypond
 380
 381 @cindex doigtés des accords
 382 @cindex accords, doigtés
 383
 384 Les doigtés des accords peuvent être saisis note par note,
 385 en les indiquant après chaque hauteur de note.
 386
 387 @lilypond[verbatim,quote]
 388 \relative {
 389   <c''-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 390 }
 391 @end lilypond
 392
 393 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
 394 la portée -- voir @ref{Direction et positionnement} à ce sujet.
 395
 396 @snippets
 397
 398 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 399 {controlling-the-placement-of-chord-fingerings.ly}
 400
 401 @lilypondfile[verbatim,quote,texidoc,doctitle]
 402 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 403
 404 @lilypondfile[verbatim,quote,texidoc,doctitle]
 405 {avoiding-collisions-with-chord-fingerings.ly}
 406
 407 @seealso
 408 Manuel de notation :
 409 @ref{Direction et positionnement}.
 410
 411 Morceaux choisis :
 412 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
 413
 414 Référence des propriétés internes :
 415 @rinternals{FingeringEvent},
 416 @rinternals{fingering-event},
 417 @rinternals{Fingering_engraver},
 418 @rinternals{New_fingering_engraver},
 419 @rinternals{Fingering}.
 420
 421
 422 @node Dictée à trous
 423 @unnumberedsubsubsec Dictée à trous
 424 @translationof Hidden notes
 425
 426 @cindex masquées, notes
 427 @cindex invisibles, notes
 428 @cindex transparentes, notes
 429 @cindex note invisible
 430 @cindex note masquée
 431
 432 @funindex \hideNotes
 433 @funindex \unHideNotes
 434
 435 Les notes masquées -- ou invisibles ou encore transparentes -- sont
 436 utiles dans le cadre d'exercices de théorie ou de composition.
 437
 438 @lilypond[verbatim,quote]
 439 \relative {
 440   c''4 d
 441   \hideNotes
 442   e4 f
 443   \unHideNotes
 444   g a
 445   \hideNotes
 446   b
 447   \unHideNotes
 448   c
 449 }
 450 @end lilypond
 451
 452 Têtes de note, hampes, crochets et silences sont invisibles.  Une
 453 ligature sera invisible si elle démarre sur une note invisible.
 454 Les objets de notation attachés à une note invisible ne seront pas
 455 masqués pour autant.
 456
 457 @lilypond[verbatim,quote]
 458 \relative c'' {
 459   e8(\p f g a)--
 460   \hideNotes
 461   e8(\p f g a)--
 462 }
 463 @end lilypond
 464
 465 @predefined
 466 @code{\hideNotes},
 467 @code{\unHideNotes}.
 468 @endpredefined
 469
 470 @seealso
 471 Manuel d'initiation :
 472 @rlearning{Visibilité et couleur des objets}.
 473
 474 Manuel de notation :
 475 @ref{Masquage de portées},
 476 @ref{Silences invisibles},
 477 @ref{Visibilité des objets}.
 478
 479 Morceaux choisis :
 480 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 481
 482 Référence des propriétés internes :
 483 @rinternals{Note_spacing_engraver},
 484 @rinternals{NoteSpacing}.
 485
 486
 487 @node Coloration d'objets
 488 @unnumberedsubsubsec Coloration d'objets
 489 @translationof Coloring objects
 490
 491 @cindex objets en couleur
 492 @cindex couleurs
 493 @cindex colorisation d'objets
 494 @cindex coloration d'objets
 495 @cindex coloration de notes
 496 @cindex colorisation de notes
 497 @cindex notes en couleur
 498 @cindex x11, couleurs
 499 @cindex couleurs x11
 500
 501 @funindex color
 502 @funindex \with-color
 503 @funindex x11-color
 504
 505 Des objets peuvent être colorisés individuellement.  Une listes des
 506 noms des couleurs disponibles se trouvent à l'annexe
 507 @ref{Liste des couleurs}.
 508
 509 @lilypond[verbatim,quote,fragment]
 510 \override NoteHead.color = #red
 511 c''4 c''
 512 \override NoteHead.color = #(x11-color 'LimeGreen)
 513 d''
 514 \override Stem.color = #blue
 515 e''
 516 @end lilypond
 517
 518 L'intégralité de la palette des couleurs définies pour X11 est
 519 accessible par la fonction Scheme @code{x11-color}.  Cette fonction
 520 prend en argument une expression symbolique de la forme
 521 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
 522 @code{@var{"TaraTata"}}.  La première formulation est à la fois plus
 523 rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
 524 permet d'accéder aux noms composés des couleurs de X11.
 525
 526 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
 527 elle revient à la couleur par défaut, le noir.  Le problème ressort de
 528 façon évidente au vu de la partition finale.
 529
 530 @lilypond[verbatim,quote]
 531 \new Staff \with {
 532   instrumentName = \markup {
 533     \with-color #(x11-color 'red) "Clarinet"
 534     }
 535   }
 536
 537   \relative c'' {
 538   \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
 539   gis8 a
 540   \override Beam.color = #(x11-color "medium turquoise")
 541   gis a
 542   \override Accidental.color = #(x11-color 'DarkRed)
 543   gis a
 544   \override NoteHead.color = #(x11-color "LimeGreen")
 545   gis a
 546   % this is deliberate nonsense; note that the stems remain black
 547   \override Stem.color = #(x11-color 'Boggle)
 548   b2 cis
 549 }
 550 @end lilypond
 551
 552 @cindex rgb-color
 553 @cindex couleur rgb
 554 @cindex couleur rvb
 555 @cindex rgb, couleur
 556 @cindex rvb, couleur
 557
 558 @funindex rgb-color
 559
 560 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
 561 les composantes de la couleur exacte au format rouge-vert-bleu
 562 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
 563 l'exemple suivant correspond à 128).
 564
 565 @lilypond[verbatim,quote]
 566 \new Staff \with {
 567   instrumentName = \markup {
 568     \with-color #(x11-color 'red) "Clarinet"
 569     }
 570   }
 571   \relative c'' {
 572   \override Stem.color = #(rgb-color 0 0 0)
 573   gis8 a
 574   \override Stem.color = #(rgb-color 1 1 1)
 575   gis8 a
 576   \override Stem.color = #(rgb-color 0 0 0.5)
 577   gis4 a
 578 }
 579 @end lilypond
 580
 581 @seealso
 582 Manuel de notation :
 583 @ref{La commande d'affinage (tweak)},
 584 @ref{Liste des couleurs}.
 585
 586 Morceaux choisis :
 587 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 588
 589 @cindex x11, couleur
 590 @cindex couleur, notes d'un accord
 591 @cindex notes colorisées dans un accord
 592 @cindex accords et couleur
 593
 594 @funindex x11-color
 595
 596 @knownissues
 597 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
 598 normale ayant un nom similaire.
 599
 600 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 601 internet.  Aussi nous vous recommandons, dans le cadre d'une
 602 présentation multimédia, d'utiliser des couleurs de base @code{blue},
 603 @code{green}, @code{red} -- bleu, vert, rouge.
 604
 605 Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
 606 d'un accord avec @code{\override}.  Si besoin est, utilisez
 607 @code{\tweak} ou @code{\single\override} devant la note en question.
 608 Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 609
 610
 611 @node Parenthèses
 612 @unnumberedsubsubsec Parenthèses
 613 @translationof Parentheses
 614
 615 @cindex fantômes, notes
 616 @cindex notes fantômes
 617 @cindex parenthèses, notes entre
 618 @cindex crochets, notes entre
 619
 620 @funindex \parenthesize
 621
 622 Des objets peuvent être mis entre parenthèses en saisissant
 623 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
 624 préfixe un accord, chaque note le composant se présentera entre
 625 parenthèses.  Vous pouvez aussi mettre individuellement entre
 626 parenthèses les notes d'un accord.
 627
 628 @lilypond[verbatim,quote]
 629 \relative {
 630   c''2 \parenthesize d
 631   c2 \parenthesize <c e g>
 632   c2 <c \parenthesize e g>
 633 }
 634 @end lilypond
 635
 636 Les objets autres que des notes peuvent aussi être entre parenthèses.
 637 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
 638 doit cependant être précédée d'un tiret.
 639
 640 @lilypond[verbatim,quote]
 641 \relative {
 642   c''2-\parenthesize -. d
 643   c2 \parenthesize r
 644 }
 645 @end lilypond
 646
 647 @seealso
 648 Morceaux choisis :
 649 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 650
 651 Référence des propriétés internes :
 652 @rinternals{Parenthesis_engraver},
 653 @rinternals{ParenthesesItem},
 654 @rinternals{parentheses-interface}.
 655
 656 @knownissues
 657 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
 658 individuellement à chacune des notes le composant, alors qu'on
 659 attendrait une seule paire de parenthèses encadrant tout l'accord.
 660
 661
 662 @node Hampes
 663 @unnumberedsubsubsec Hampes
 664 @translationof Stems
 665
 666 @cindex hampes
 667 @cindex hampes invisibles
 668 @cindex visibilité des hampes
 669 @cindex masquage des hampes
 670 @cindex hampe, orientation
 671 @cindex hampe montante
 672 @cindex hampe descendante
 673 @cindex hampe neutre
 674
 675 @funindex \stemUp
 676 @funindex \stemDown
 677 @funindex \stemNeutral
 678
 679 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
 680 automatiquement.  Pour les rondes et les silences, ils sont aussi
 681 créés, mais en mode invisible.
 682
 683 L'orientation des hampes peut être définie manuellement -- voir
 684 @ref{Direction et positionnement} à ce sujet.
 685
 686 @predefined
 687 @code{\stemUp},
 688 @code{\stemDown},
 689 @code{\stemNeutral}.
 690 @endpredefined
 691
 692 @snippets
 693
 694 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 695 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 696
 697 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 698 {automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
 699
 700 @seealso
 701 Manuel de notation :
 702 @ref{Direction et positionnement}.
 703
 704 Morceaux choisis :
 705 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 706
 707 Référence des propriétés internes :
 708 @rinternals{Stem_engraver},
 709 @rinternals{Stem},
 710 @rinternals{stem-interface}.
 711
 712
 713 @node Hors de la portée
 714 @subsection Hors de la portée
 715 @translationof Outside the staff
 716
 717 Nous allons nous intéresser ici à souligner des éléments inscrits dans
 718 la portée par des éléments qui lui seront externes.
 719
 720 @menu
 721 * Info-bulle::
 722 * Quadrillage temporel::
 723 * Crochets d'analyse::
 724 @end menu
 725
 726
 727 @node Info-bulle
 728 @unnumberedsubsubsec Info-bulle
 729 @translationof Balloon help
 730
 731 @cindex bulle
 732 @cindex notation, explication
 733 @cindex info-bulle
 734
 735 @funindex \balloonGrobText
 736 @funindex \balloonText
 737 @funindex Balloon_engraver
 738 @funindex balloonGrobText
 739 @funindex balloonText
 740 @funindex \balloonLengthOn
 741 @funindex \balloonLengthOff
 742
 743 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 744 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
 745 notation.
 746
 747 En voici un exemple :
 748 @c KEEP LY
 749 @lilypond[verbatim,quote]
 750 \new Voice \with { \consists "Balloon_engraver" }
 751 \relative c'' {
 752   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 753   a8
 754   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
 755   r
 756   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
 757 }
 758 @end lilypond
 759
 760 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
 761 @code{balloonText}.  @code{balloonGrobText} prend en argument l'objet
 762 graphique à agrémenter et s'utilise comme @code{\once \override}.
 763 @code{balloonText}, quant à lui, s'utilise comme une simple articulation
 764 et fonctionne comme @code{\tweak} pour attacher du texte à l'une des
 765 notes d'un accord.  Les autres arguments sont le décalage et le texte de
 766 la bulle.
 767
 768 Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
 769 peut toutefois le gérer ainsi :
 770
 771 @c KEEP LY
 772 @lilypond[verbatim,quote]
 773 \new Voice \with { \consists "Balloon_engraver" }
 774 \relative c'' {
 775   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 776   a8
 777   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
 778   r
 779   \balloonLengthOn
 780   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
 781 }
 782 @end lilypond
 783
 784 @predefined
 785 @code{\balloonLengthOn},
 786 @code{\balloonLengthOff}.
 787 @endpredefined
 788
 789 @seealso
 790 Morceaux choisis :
 791 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 792
 793 Référence des propriétés internes :
 794 @rinternals{Balloon_engraver},
 795 @rinternals{BalloonTextItem},
 796 @rinternals{balloon-interface}.
 797
 798
 799 @node Quadrillage temporel
 800 @unnumberedsubsubsec Quadrillage temporel
 801 @translationof Grid lines
 802
 803 @cindex quadrillage temporel
 804 @cindex temporel, quadrillage
 805
 806 @funindex Grid_point_engraver
 807 @funindex Grid_line_span_engraver
 808 @funindex gridInterval
 809
 810 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 811 les notes.
 812
 813 LilyPond a recours à deux graveurs distincts afin d'afficher le
 814 quadrillage :  le @code{Grid_point_engraver} se charge de déterminer
 815 l'envergure du crochet, alors que le @code{Grid_line_span_engraver} se
 816 consacrera au tracé des lignes.  Les lignes sont par défaut centrées
 817 horizontalement sous les notes et alignées sur la gauche des têtes.  La
 818 propriété @code{gridInterval} spécifie quant à elle l'espace de temps
 819 entre chaque ligne.
 820
 821 @c KEEP LY
 822 @lilypond[verbatim,quote]
 823 \layout {
 824   \context {
 825     \Staff
 826     \consists "Grid_point_engraver" %% active les guides
 827     gridInterval = #(ly:make-moment 1/4)
 828   }
 829   \context {
 830     \Score
 831     \consists "Grid_line_span_engraver"
 832      %% centre les lignes guides horizontalement sous les notes
 833   }
 834 }
 835
 836 \score {
 837   \new ChoirStaff <<
 838     \new Staff \relative {
 839       \stemUp
 840       c''4. d8 e8 f g4
 841     }
 842     \new Staff \relative {
 843     %% centre les lignes guides verticalement
 844       \clef bass
 845       \stemDown
 846       c4  g'  f  e
 847     }
 848   >>
 849 }
 850 @end lilypond
 851
 852 @snippets
 853
 854 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 855 {grid-lines--changing-their-appearance.ly}
 856
 857 @seealso
 858 Morceaux choisis :
 859 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 860
 861 Référence des propriétés internes :
 862 @rinternals{Grid_line_span_engraver},
 863 @rinternals{Grid_point_engraver},
 864 @rinternals{GridLine},
 865 @rinternals{GridPoint},
 866 @rinternals{grid-line-interface},
 867 @rinternals{grid-point-interface}.
 868
 869
 870 @node Crochets d'analyse
 871 @unnumberedsubsubsec Crochets d'analyse
 872 @translationof Analysis brackets
 873
 874 @cindex crochets
 875 @cindex crochets de phrasé
 876 @cindex analyse musicologique
 877 @cindex crochet de regroupement de notes
 878 @cindex musicologie, crochets d'analyse
 879
 880 @funindex Horizontal_bracket_engraver
 881 @funindex \startGroup
 882 @funindex \stopGroup
 883
 884 On utilise des crochets en analyse musicale, pour indiquer la
 885 structure d'une pièce.
 886
 887 @lilypond[verbatim,quote]
 888 \layout {
 889   \context {
 890     \Voice
 891     \consists "Horizontal_bracket_engraver"
 892   }
 893 }
 894 \relative {
 895   c''2\startGroup
 896   d\stopGroup
 897 }
 898 @end lilypond
 899
 900 Les crochets d'analyses sont susceptibles d'être imbriqués :
 901
 902 @lilypond[verbatim,quote]
 903 \layout {
 904   \context {
 905     \Voice
 906     \consists "Horizontal_bracket_engraver"
 907   }
 908 }
 909 \relative {
 910   c''4\startGroup\startGroup
 911   d4\stopGroup
 912   e4\startGroup
 913   d4\stopGroup\stopGroup
 914 }
 915 @end lilypond
 916
 917 @snippets
 918
 919 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 920 {analysis-brackets-above-the-staff.ly}
 921
 922 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 923 {analysis-brackets-with-labels.ly}
 924
 925
 926 @seealso
 927 Référence des propriétés internes :
 928 @rinternals{Horizontal_bracket_engraver},
 929 @rinternals{HorizontalBracket},
 930 @rinternals{horizontal-bracket-interface},
 931 @rinternals{HorizontalBracketText},
 932 @rinternals{horizontal-bracket-text-interface},
 933 @rinternals{Staff}.