Documentation/fr/notation/editorial.itely

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