Documentation/fr/notation/editorial.itely

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