Documentation/fr/notation/editorial.itely

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