1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: a59d022ee65e8310ea16954da7b637c07ca00ae2
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..
13 @c Translators: Jean-Charles Malahieude
15 @node Annotations éditoriales
16 @section Annotations éditoriales
17 @translationof Editorial annotations
19 @lilypondfile[quote]{editorial-headword.ly}
21 Ce chapitre traite de la manière de modifier l'apparence des notes dans
22 un but pédagogique ou d'analyse.
31 @subsection Dans la portée
32 @translationof Inside the staff
34 Nous allons voir ici comment mettre en exergue certains éléments à
35 l'intérieur même de la portée.
38 * Indication de la taille de fonte musicale::
41 * Coloration d'objets::
47 @node Indication de la taille de fonte musicale
48 @unnumberedsubsubsec Indication de la taille de fonte musicale
49 @translationof Selecting notation font size
51 @cindex sélection de la taille (notation)
53 @cindex taille des notes
58 @funindex magnification->font-size
60 @funindex magnifyMusic
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}.}
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} :
87 @c Grieg Piano Concerto (mvt.1 cadenza)
88 @lilypond[verbatim,quote]
90 \new Voice \relative {
92 <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
94 \new Voice \relative {
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
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 :
109 @c Chopin Prelude op.28 no.8
110 @lilypond[verbatim,quote]
113 \mergeDifferentlyDottedOn
114 \new Voice \relative {
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')
123 \new Voice \relative {
125 cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
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}.
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}.}
144 @subsubsubheading Redimmensionnement individuel d'objets de rendu
145 @c VO Resizing individual layout objects
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
151 @lilypond[quote,verbatim,relative=1]
153 <f \tweak font-size -4 b e>-5
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!-^
162 @lilypond[verbatim,quote,relative=2]
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)}.
186 @subsubsubheading La propriété @code{fontSize}
187 @c VO Understanding the @code{fontSize} property
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 :
193 @lilypond[verbatim,quote,relative=2]
197 e'4-- c!8-4( b a g) |
199 fis4---3 e8( d) fis4 |
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.
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
217 \set fontSize = #(magnification->font-size 0.75)
220 La fonction Scheme @code{magstep} quant à elle effectue
221 l'inverse : elle convertit le nombre affecté à @code{font-size} en
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}.
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é :
242 @lilypond[verbatim,quote,relative=2]
243 % the default font-size for NoteHead is 0
244 % the default font-size for Fingering is -5
248 % the effective font size for NoteHead is now -3
249 % the effective font size for Fingering is now -8
252 \override Fingering.font-size = 0
253 % the effective font size for Fingering is now -3
257 LilyPond dispose d'un certain nombre de raccourcis :
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 %
269 @lilypond[verbatim,quote,relative=2]
284 @cindex standard, taille des notes
285 @cindex notes, taille standard
287 @funindex font-interface
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
298 @code{\magnifyMusic},
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}.
314 Fichiers d'initialisation :
315 @file{ly/music-functions-init.ly},
316 @file{ly/property-init.ly}.
319 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
321 Référence des propriétés internes :
322 @rinternals{font-interface}.
326 @unnumberedsubsubsec Doigtés
327 @translationof Fingering instructions
330 @cindex substitution de doigt
335 Les doigtés peuvent être indiqués comme suit :
336 @var{note}-@var{chiffre_du_doigt}
338 @lilypond[verbatim,quote,relative=2]
342 Pour les substitutions de doigts, on a recours à une indication
343 textuelle (commande @code{\markup}) de doigté
344 (commande @code{\finger}).
346 @lilypond[verbatim,quote,relative=2]
347 c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
350 @cindex pouce, doigté
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).
359 @lilypond[verbatim,quote,relative=2]
360 <a_\thumb a'-3>2 <b_\thumb b'-3>
363 @cindex doigtés des accords
364 @cindex accords, doigtés
366 Les doigtés des accords peuvent être saisis note par note,
367 en les indiquant après chaque hauteur de note.
369 @lilypond[verbatim,quote,relative=2]
370 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
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.
378 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
379 {controlling-the-placement-of-chord-fingerings.ly}
381 @lilypondfile[verbatim,quote,texidoc,doctitle]
382 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
384 @lilypondfile[verbatim,quote,texidoc,doctitle]
385 {avoiding-collisions-with-chord-fingerings.ly}
389 @ref{Direction et positionnement}.
392 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
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}.
403 @unnumberedsubsubsec Dictée à trous
404 @translationof Hidden notes
406 @cindex masquées, notes
407 @cindex invisibles, notes
408 @cindex transparentes, notes
409 @cindex note invisible
414 @funindex \unHideNotes
415 @funindex unHideNotes
417 Les notes masquées -- ou invisibles ou encore transparentes -- sont
418 utiles dans le cadre d'exercices de théorie ou de composition.
420 @lilypond[verbatim,quote,relative=2]
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
437 @lilypond[verbatim,quote,relative=2]
449 Manuel d'initiation :
450 @rlearning{Visibilité et couleur des objets}.
453 @ref{Silences invisibles},
454 @ref{Visibilité des objets},
455 @ref{Masquage de portées}.
458 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
460 Référence des propriétés internes :
461 @rinternals{Note_spacing_engraver},
462 @rinternals{NoteSpacing}.
465 @node Coloration d'objets
466 @unnumberedsubsubsec Coloration d'objets
467 @translationof Coloring objects
469 @cindex objets en couleur
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
480 @funindex \with-color
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}.
488 @lilypond[verbatim,quote,relative=2]
489 \override NoteHead.color = #red
491 \override NoteHead.color = #(x11-color 'LimeGreen)
493 \override Stem.color = #blue
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.
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.
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"
516 \override Beam.color = #(x11-color "medium turquoise")
518 \override Accidental.color = #(x11-color 'DarkRed)
520 \override NoteHead.color = #(x11-color "LimeGreen")
522 % this is deliberate nonsense; note that the stems remain black
523 \override Stem.color = #(x11-color 'Boggle)
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).
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"
546 \override Stem.color = #(rgb-color 0 0 0)
548 \override Stem.color = #(rgb-color 1 1 1)
550 \override Stem.color = #(rgb-color 0 0 0.5)
556 @ref{Liste des couleurs},
557 @ref{La commande d'affinage (tweak)}.
560 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
563 @cindex couleur, notes d'un accord
564 @cindex notes colorisées dans un accord
565 @cindex accords et couleur
570 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
571 normale ayant un nom similaire.
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.
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)}.
584 @unnumberedsubsubsec Parenthèses
585 @translationof Parentheses
587 @cindex fantômes, notes
588 @cindex notes fantômes
589 @cindex parenthèses, notes entre
590 @cindex crochets, notes entre
592 @funindex \parenthesize
593 @funindex parenthesize
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.
601 @lilypond[verbatim,quote,relative=2]
603 c2 \parenthesize <c e g>
604 c2 <c \parenthesize e g>
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.
611 @lilypond[verbatim,quote,relative=2]
612 c2-\parenthesize -. d
618 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
620 Référence des propriétés internes :
621 @rinternals{Parenthesis_engraver},
622 @rinternals{ParenthesesItem},
623 @rinternals{parentheses-interface}.
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.
632 @unnumberedsubsubsec 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
648 @funindex \stemNeutral
649 @funindex stemNeutral
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.
655 L'orientation des hampes peut être définie manuellement -- voir
656 @ref{Direction et positionnement} à ce sujet.
666 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
667 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
669 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
670 {automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
674 @ref{Direction et positionnement}.
677 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
679 Référence des propriétés internes :
680 @rinternals{Stem_engraver},
682 @rinternals{stem-interface}.
685 @node Hors de la portée
686 @subsection Hors de la portée
687 @translationof Outside the staff
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.
694 * Quadrillage temporel::
695 * Crochets d'analyse::
700 @unnumberedsubsubsec Info-bulle
701 @translationof Balloon help
704 @cindex notation, explication
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
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
721 En voici un exemple :
723 @lilypond[verbatim,quote,relative=2]
724 \new Voice \with { \consists "Balloon_engraver" }
726 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
728 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
730 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
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.
742 Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
743 peut toutefois le gérer ainsi :
746 @lilypond[verbatim,quote,relative=2]
747 \new Voice \with { \consists "Balloon_engraver" }
749 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
751 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
754 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
759 @code{\balloonLengthOn},
760 @code{\balloonLengthOff}.
765 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
767 Référence des propriétés internes :
768 @rinternals{Balloon_engraver},
769 @rinternals{BalloonTextItem},
770 @rinternals{balloon-interface}.
773 @node Quadrillage temporel
774 @unnumberedsubsubsec Quadrillage temporel
775 @translationof Grid lines
777 @cindex quadrillage temporel
778 @cindex temporel, quadrillage
780 @funindex Grid_point_engraver
781 @funindex Grid_line_span_engraver
782 @funindex gridInterval
784 Vous pouvez tracer des lignes entre les portées, synchronisées avec
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.
796 @lilypond[verbatim,quote]
800 \consists "Grid_point_engraver" %% active les guides
801 gridInterval = #(ly:make-moment 1/4)
805 \consists "Grid_line_span_engraver"
806 %% centre les lignes guides horizontalement sous les notes
812 \new Staff \relative c'' {
816 \new Staff \relative c {
817 %% centre les lignes guides verticalement
828 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
829 {grid-lines--changing-their-appearance.ly}
833 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
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}.
844 @node Crochets d'analyse
845 @unnumberedsubsubsec Crochets d'analyse
846 @translationof Analysis brackets
849 @cindex crochets de phrasé
850 @cindex analyse musicologique
851 @cindex crochet de regroupement de notes
853 @funindex Horizontal_bracket_engraver
854 @funindex \startGroup
859 On utilise des crochets en analyse musicale, pour indiquer la
860 structure d'une pièce.
862 @lilypond[verbatim,quote]
866 \consists "Horizontal_bracket_engraver"
875 Les crochets d'analyses sont susceptibles d'être imbriqués :
877 @lilypond[verbatim,quote]
881 \consists "Horizontal_bracket_engraver"
885 c4\startGroup\startGroup
888 d4\stopGroup\stopGroup
894 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
896 Référence des propriétés internes :
897 @rinternals{Horizontal_bracket_engraver},
898 @rinternals{HorizontalBracket},
899 @rinternals{horizontal-bracket-interface},