1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: a6b5eea83ddcdd8e1fd0760db385176ff9b2b1cd
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Jean-Charles Malahieude
14 @node Annotations éditoriales
15 @section Annotations éditoriales
16 @translationof Editorial annotations
18 @lilypondfile[quote]{editorial-headword.ly}
20 Ce chapitre traite de la manière de modifier l'apparence des notes dans
21 un but pédagogique ou d'analyse.
30 @subsection Dans la portée
31 @translationof Inside the staff
33 Nous allons voir ici comment mettre en exergue certains éléments à
34 l'intérieur même de la portée.
37 * Indication de la taille de fonte musicale::
40 * Coloration d'objets::
45 @node Indication de la taille de fonte musicale
46 @unnumberedsubsubsec Indication de la taille de fonte musicale
47 @translationof Selecting notation font size
49 @cindex selection de la taille (notation)
51 @cindex taille des notes
71 Le plus sûr moyen de régler la taille de la police, quel que soit le
72 contexte, consiste à définir la propriété @code{fontSize}.
73 Ceci ne modifiera en rien la taille des différents symboles tels que
74 ligatures ou liaisons.
76 @warning{En matière de taille des éléments textuels, référez-vous au
77 chapitre @ref{Sélection de la fonte et de la taille}.}
79 @lilypond[verbatim,quote,relative=2]
94 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
95 de définir la propriété @code{font-size} pour tous les objets de
96 rendu. La valeur de @code{font-size} est un entier représentant la
97 taille proportionnellement à la hauteur standard de la portée en
98 cours. Chaque incrément correspond à une augmentation d'environ
99 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
100 au doublement de la taille. La fonction Scheme @code{magstep}
101 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
102 Vous pouvez aussi définir directement la propriété @code{font-size} de
103 manière à n'affecter seulement que certains objets de rendu.
105 @lilypond[verbatim,quote,relative=2]
108 \override NoteHead #'font-size = #-4
110 \override Script #'font-size = #2
112 \override Stem #'font-size = #-5
116 @cindex standard, taille des notes
117 @cindex notes, taille standard
119 @funindex font-interface
122 Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
123 dont la taille est la plus proche de la taille voulue. La taille
124 standard (pour laquelle @w{@code{font-size = #0}}) dépend de la hauteur
125 de la portée. À une portée de 20@tie{}points correspond une police de
128 La propriété @code{font-size} ne peut intervenir que pour les objets
129 qui utilisent des polices, autrement dit ceux qui disposent de
130 l'interface de rendu @code{font-interface}.
145 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
147 Référence des propriétés internes :
148 @rinternals{font-interface}.
152 @unnumberedsubsubsec Doigtés
153 @translationof Fingering instructions
156 @cindex substitution de doigt
161 Les doigtés peuvent être indiqués comme suit@tie{}:
162 @var{note}-@var{chiffre_du_doigt}
164 @lilypond[verbatim,quote,relative=2]
168 Pour les substitutions de doigts, on a recours à une indication
169 textuelle (commande @code{\markup}) de doigté
170 (commande @code{\finger}).
172 @lilypond[verbatim,quote,relative=2]
173 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
176 @cindex pouce, doigté
181 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
182 dans une partition de violoncelle, si une note doit être jouée avec le
183 pouce (@emph{thumb} en anglais).
185 @lilypond[verbatim,quote,relative=2]
186 <a_\thumb a'-3>2 <b_\thumb b'-3>
189 @cindex doigtés des accords
190 @cindex accords, doigtés
192 Les doigtés des accords peuvent être saisis note par note,
193 en les indiquant après chaque hauteur de note.
195 @lilypond[verbatim,quote,relative=2]
196 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
199 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
200 la portée -- voir @ref{Direction et positionnement} à ce sujet.
204 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
205 {controlling-the-placement-of-chord-fingerings.ly}
207 @lilypondfile[verbatim,quote,texidoc,doctitle]
208 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
210 @lilypondfile[verbatim,quote,texidoc,doctitle]
211 {avoiding-collisions-with-chord-fingerings.ly}
216 @ref{Direction et positionnement}.
219 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
221 Référence des propriétés internes :
222 @rinternals{FingeringEvent},
223 @rinternals{fingering-event},
224 @rinternals{Fingering_engraver},
225 @rinternals{New_fingering_engraver},
226 @rinternals{Fingering}.
229 La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
230 défaut, les chiffres supérieurs à 9.
234 @unnumberedsubsubsec Dictée à trous
235 @translationof Hidden notes
237 @cindex masquées, notes
238 @cindex invisibles, notes
239 @cindex transparentes, notes
240 @cindex note invisible
245 @funindex \unHideNotes
246 @funindex unHideNotes
248 Les notes masquées -- ou invisibles ou encore transparentes -- sont
249 utiles dans le cadre d'exercices de théorie ou de composition.
251 @lilypond[verbatim,quote,relative=2]
263 Les objets de notation attachés à une note invisible ne seront pas
266 @lilypond[verbatim,quote,relative=2]
280 Manuel d'initiation :
281 @rlearning{Visibilité et couleur des objets}.
284 @ref{Silences invisibles},
285 @ref{Visibilité des objets},
286 @ref{Masquage de portées}.
289 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
291 Référence des propriétés internes :
292 @rinternals{Note_spacing_engraver},
293 @rinternals{NoteSpacing}.
296 @node Coloration d'objets
297 @unnumberedsubsubsec Coloration d'objets
298 @translationof Coloring objects
300 @cindex objets en couleur
302 @cindex colorisation d'objets
303 @cindex coloration d'objets
304 @cindex coloration de notes
305 @cindex colorisation de notes
306 @cindex notes en couleur
307 @cindex x11, couleurs
311 @funindex \with-color
315 Des objets peuvent être colorisés individuellement. Une listes des
316 noms des couleurs disponibles se trouvent à l'annexe
317 @ref{Liste des couleurs}.
319 @lilypond[verbatim,quote,relative=2]
320 \override NoteHead #'color = #red
322 \override NoteHead #'color = #(x11-color 'LimeGreen)
324 \override Stem #'color = #blue
328 L'intégralité de la palette des couleurs définies pour X11 est
329 accessible par la fonction Scheme @code{x11-color}. Cette fonction
330 prend en argument une expression symbolique de la forme
331 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
332 @code{@var{"TaraTata"}}. La première formulation est à la fois plus
333 rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
334 permet d'accéder aux noms composés des couleurs de X11.
336 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
337 elle revient à la couleur par défaut, le noir. Le problème ressort de
338 façon évidente au vu de la partition finale.
340 @lilypond[verbatim,quote,relative=2]
341 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
342 \set Staff.instrumentName = \markup {
343 \with-color #(x11-color 'navy) "Clarinet"
347 \override Beam #'color = #(x11-color "medium turquoise")
349 \override Accidental #'color = #(x11-color 'DarkRed)
351 \override NoteHead #'color = #(x11-color "LimeGreen")
353 % this is deliberate nonsense; note that the stems remain black
354 \override Stem #'color = #(x11-color 'Boggle)
366 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
367 les composantes de la couleur exacte au format rouge-vert-bleu
368 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
369 l'exemple suivant correspond à 128).
371 @lilypond[verbatim,quote,relative=2]
372 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
373 \set Staff.instrumentName = \markup {
374 \with-color #(x11-color 'navy) "Clarinet"
377 \override Stem #'color = #(rgb-color 0 0 0)
379 \override Stem #'color = #(rgb-color 1 1 1)
381 \override Stem #'color = #(rgb-color 0 0 0.5)
388 @ref{Liste des couleurs},
389 @ref{La commande d'affinage (tweak)}.
392 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
396 @cindex couleur, notes d'un accord
397 @cindex notes colorisées dans un accord
398 @cindex accords et couleur
403 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
404 normale ayant un nom similaire.
406 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
407 internet. Aussi nous vous recommandons, dans le cadre d'une
408 présentation multimedia, d'utiliser des couleurs de base @code{blue},
409 @code{green}, @code{red} -- bleu, vert, rouge.
412 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
413 @code{\override}. Si besoin est, utilisez @code{\tweak}.
414 Pour plus de détails, consultez
415 @ref{La commande d'affinage (tweak)}.
419 @unnumberedsubsubsec Parenthèses
420 @translationof Parentheses
422 @cindex fantômes, notes
423 @cindex notes fantômes
424 @cindex parenthèses, notes entre
426 @funindex \parenthesize
427 @funindex parenthesize
429 Des objets peuvent être mis entre parenthèses en saisissant
430 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
431 préfixe un accord, chaque note le composant se présentera entre
432 parenthèses. Vous pouvez aussi mettre individuellement entre
433 parenthèses les notes d'un accord.
435 @lilypond[verbatim,quote,relative=2]
437 c2 \parenthesize <c e g>
438 c2 <c \parenthesize e g>
441 Les objets autres que des notes peuvent aussi être entre parenthèses.
442 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
443 doit cependant être précédée d'un tiret.
445 @lilypond[verbatim,quote,relative=2]
446 c2-\parenthesize -. d
453 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
455 Référence des propriétés internes :
456 @rinternals{Parenthesis_engraver},
457 @rinternals{ParenthesesItem},
458 @rinternals{parentheses-interface}.
463 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
464 individuellement à chacune des notes le composant, alors qu'on
465 attendrait une seule paire de parenthèses encadrant tout l'accord.
469 @unnumberedsubsubsec Hampes
473 @cindex hampes invisibles
474 @cindex visibilité des hampes
475 @cindex masquage des hampes
481 @funindex \stemNeutral
482 @funindex stemNeutral
483 @cindex stem, direction
486 @cindex stem, neutral
488 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
489 automatiquement. Pour les rondes et les silences, ils sont aussi
490 créés, mais en mode invisible.
492 L'orientation des hampes peut être définie manuellement -- voir
493 @ref{Direction et positionnement} à ce sujet.
505 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
506 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
511 @ref{Direction et positionnement}.
514 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
516 Référence des propriétés internes :
517 @rinternals{Stem_engraver},
519 @rinternals{stem-interface}.
522 @node Hors de la portée
523 @subsection Hors de la portée
524 @translationof Outside the staff
526 Nous allons nous intéresser ici à souligner des éléments inscrits dans
527 la portée par des éléments qui lui seront externes.
531 * Quadrillage temporel::
532 * Crochets d'analyse::
536 @unnumberedsubsubsec Info-bulle
537 @translationof Balloon help
540 @cindex notation, explication
543 @funindex \balloonGrobText
544 @funindex \balloonText
545 @funindex Balloon_engraver
546 @funindex balloonGrobText
547 @funindex balloonText
548 @funindex \balloonLengthOn
549 @funindex balloonLengthOn
550 @funindex \balloonLengthOff
551 @funindex balloonLengthOff
553 Vous pouvez marquer et nommer des éléments de notation à l'aide de
554 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
557 En voici un exemple :
559 @lilypond[verbatim,quote,relative=2]
560 \new Voice \with { \consists "Balloon_engraver" }
562 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
564 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
566 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
570 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
571 @code{balloonText}. @code{balloonGrobText} prend en argument
572 l'objet graphique à agrémenter et s'utilise comme
573 @code{\once@tie{}\override}. @code{balloonText}, quant à lui, s'utilise
574 comme une simple articulation et fonctionne comme @code{\tweak} pour
575 attacher du texte à l'une des notes d'un accord. Les autres arguments
576 sont le décalage et le texte de la bulle.
578 Les info-bulles ont une influence sur les espacements, que l'on peut
582 @lilypond[verbatim,quote,relative=2]
583 \new Voice \with { \consists "Balloon_engraver" }
586 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
588 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
591 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
597 @code{\balloonLengthOn},
598 @code{\balloonLengthOff}.
604 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
606 Référence des propriétés internes :
607 @rinternals{Balloon_engraver},
608 @rinternals{BalloonTextItem},
609 @rinternals{balloon-interface}.
612 @node Quadrillage temporel
613 @unnumberedsubsubsec Quadrillage temporel
614 @translationof Grid lines
616 @cindex quadrillage temporel
617 @cindex temporel, quadrillage
619 @funindex Grid_point_engraver
620 @funindex Grid_line_span_engraver
621 @funindex gridInterval
623 Vous pouvez tracer des lignes entre les portées, synchronisées avec
626 LilyPond a recours à deux graveurs distincts afin d'afficher le
627 quadrillage@tie{}: le @code{Grid_point_engraver} se charge de
628 déterminer l'envergure du crochet, alors que le
629 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
630 Les lignes sont par défaut centrées horizontalement sous les notes et
631 alignées sur la gauche des têtes. La propriété @code{gridInterval}
632 spécifie quant à elle l'espace de temps entre chaque ligne.
635 @lilypond[verbatim,quote]
639 \consists "Grid_point_engraver" %% active les guides
640 gridInterval = #(ly:make-moment 1 4)
644 \consists "Grid_line_span_engraver"
645 %% centre les lignes guides horizontalement sous les notes
651 \new Staff \relative c'' {
655 \new Staff \relative c {
656 %% centre les lignes guides verticalement
667 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
668 {grid-lines--changing-their-appearance.ly}
673 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
675 Référence des propriétés internes :
676 @rinternals{Grid_line_span_engraver},
677 @rinternals{Grid_point_engraver},
678 @rinternals{GridLine},
679 @rinternals{GridPoint},
680 @rinternals{grid-line-interface},
681 @rinternals{grid-point-interface}.
684 @node Crochets d'analyse
685 @unnumberedsubsubsec Crochets d'analyse
686 @translationof Analysis brackets
689 @cindex crochets de phrasé
690 @cindex analyse musicologique
691 @cindex crochet de regroupement de notes
693 @funindex Horizontal_bracket_engraver
694 @funindex \startGroup
699 On utilise des crochets en analyse musicale, pour indiquer la
700 structure d'une pièce.
702 @lilypond[verbatim,quote]
706 \consists "Horizontal_bracket_engraver"
715 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
717 @lilypond[verbatim,quote]
721 \consists "Horizontal_bracket_engraver"
725 c4\startGroup\startGroup
728 d4\stopGroup\stopGroup
735 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
737 Référence des propriétés internes :
738 @rinternals{Horizontal_bracket_engraver},
739 @rinternals{HorizontalBracket},
740 @rinternals{horizontal-bracket-interface},