1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
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,lilyquote,ragged-right,texidoc,doctitle]
205 {controlling-the-placement-of-chord-fingerings.ly}
207 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
208 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
210 @lilypondfile[verbatim,lilyquote,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}.
230 @unnumberedsubsubsec Dictée à trous
231 @translationof Hidden notes
233 @cindex masquées, notes
234 @cindex invisibles, notes
235 @cindex transparentes, notes
236 @cindex note invisible
241 @funindex \unHideNotes
242 @funindex unHideNotes
244 Les notes masquées -- ou invisibles ou encore transparentes -- sont
245 utiles dans le cadre d'exercices de théorie ou de composition.
247 @lilypond[verbatim,quote,relative=2]
259 Les objets de notation attachés à une note invisible ne seront pas
262 @lilypond[verbatim,quote,relative=2]
276 Manuel d'initiation :
277 @rlearning{Visibilité et couleur des objets}.
280 @ref{Silences invisibles},
281 @ref{Visibilité des objets},
282 @ref{Masquage de portées}.
285 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
287 Référence des propriétés internes :
288 @rinternals{Note_spacing_engraver},
289 @rinternals{NoteSpacing}.
292 @node Coloration d'objets
293 @unnumberedsubsubsec Coloration d'objets
294 @translationof Coloring objects
296 @cindex objets en couleur
298 @cindex colorisation d'objets
299 @cindex coloration d'objets
300 @cindex coloration de notes
301 @cindex colorisation de notes
302 @cindex notes en couleur
303 @cindex x11, couleurs
307 @funindex \with-color
311 Des objets peuvent être colorisés individuellement. Une listes des
312 noms des couleurs disponibles se trouvent à l'annexe
313 @ref{Liste des couleurs}.
315 @lilypond[verbatim,quote,relative=2]
316 \override NoteHead #'color = #red
318 \override NoteHead #'color = #(x11-color 'LimeGreen)
320 \override Stem #'color = #blue
324 L'intégralité de la palette des couleurs définies pour X11 est
325 accessible par la fonction Scheme @code{x11-color}. Cette fonction
326 prend en argument une expression symbolique de la forme
327 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
328 @code{@var{"TaraTata"}}. La première formulation est à la fois plus
329 rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
330 permet d'accéder aux noms composés des couleurs de X11.
332 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
333 elle revient à la couleur par défaut, le noir. Le problème ressort de
334 façon évidente au vu de la partition finale.
336 @lilypond[verbatim,quote,relative=2]
337 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
338 \set Staff.instrumentName = \markup {
339 \with-color #(x11-color 'navy) "Clarinet"
343 \override Beam #'color = #(x11-color "medium turquoise")
345 \override Accidental #'color = #(x11-color 'DarkRed)
347 \override NoteHead #'color = #(x11-color "LimeGreen")
349 % this is deliberate nonsense; note that the stems remain black
350 \override Stem #'color = #(x11-color 'Boggle)
362 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
363 les composantes de la couleur exacte au format rouge-vert-bleu
364 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
365 l'exemple suivant correspond à 128).
367 @lilypond[verbatim,quote,relative=2]
368 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
369 \set Staff.instrumentName = \markup {
370 \with-color #(x11-color 'navy) "Clarinet"
373 \override Stem #'color = #(rgb-color 0 0 0)
375 \override Stem #'color = #(rgb-color 1 1 1)
377 \override Stem #'color = #(rgb-color 0 0 0.5)
384 @ref{Liste des couleurs},
385 @ref{La commande d'affinage (tweak)}.
388 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
392 @cindex couleur, notes d'un accord
393 @cindex notes colorisées dans un accord
394 @cindex accords et couleur
399 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
400 normale ayant un nom similaire.
402 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
403 internet. Aussi nous vous recommandons, dans le cadre d'une
404 présentation multimedia, d'utiliser des couleurs de base @code{#blue},
405 @code{#green}, @code{#red} -- bleu, vert, rouge.
408 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
409 @code{\override}. Si besoin est, utilisez @code{\tweak}.
410 Pour plus de détails, consultez
411 @ref{La commande d'affinage (tweak)}.
415 @unnumberedsubsubsec Parenthèses
416 @translationof Parentheses
418 @cindex fantômes, notes
419 @cindex notes fantômes
420 @cindex parenthèses, notes entre
422 @funindex \parenthesize
423 @funindex parenthesize
425 Des objets peuvent être mis entre parenthèses en saisissant
426 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
427 préfixe un accord, chaque note le composant se présentera entre
428 parenthèses. Vous pouvez aussi mettre individuellement entre
429 parenthèses les notes d'un accord.
431 @lilypond[verbatim,quote,relative=2]
433 c2 \parenthesize <c e g>
434 c2 <c \parenthesize e g>
437 Les objets autres que des notes peuvent aussi être entre parenthèses.
438 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
439 doit cependant être précédée d'un tiret.
441 @lilypond[verbatim,quote,relative=2]
442 c2-\parenthesize -. d
449 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
451 Référence des propriétés internes :
452 @rinternals{Parenthesis_engraver},
453 @rinternals{ParenthesesItem},
454 @rinternals{parentheses-interface}.
459 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
460 individuellement à chacune des notes le composant, alors qu'on
461 attendrait une seule paire de parenthèses encadrant tout l'accord.
465 @unnumberedsubsubsec Hampes
469 @cindex hampes invisibles
470 @cindex visibilité des hampes
471 @cindex masquage des hampes
477 @funindex \stemNeutral
478 @funindex stemNeutral
479 @cindex stem, direction
482 @cindex stem, neutral
484 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
485 automatiquement. Pour les rondes et les silences, ils sont aussi
486 créés, mais en mode invisible.
488 L'orientation des hampes peut être définie manuellement -- voir
489 @ref{Direction et positionnement} à ce sujet.
501 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
502 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
507 @ref{Direction et positionnement}.
510 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
512 Référence des propriétés internes :
513 @rinternals{Stem_engraver},
515 @rinternals{stem-interface}.
518 @node Hors de la portée
519 @subsection Hors de la portée
520 @translationof Outside the staff
522 Nous allons nous intéresser ici à souligner des éléments inscrits dans
523 la portée par des éléments qui lui seront externes.
527 * Quadrillage temporel::
528 * Crochets d'analyse::
532 @unnumberedsubsubsec Info-bulle
533 @translationof Balloon help
536 @cindex notation, explication
539 @funindex \balloonGrobText
540 @funindex \balloonText
541 @funindex Balloon_engraver
542 @funindex balloonGrobText
543 @funindex balloonText
544 @funindex \balloonLengthOn
545 @funindex balloonLengthOn
546 @funindex \balloonLengthOff
547 @funindex balloonLengthOff
549 Vous pouvez marquer et nommer des éléments de notation à l'aide de
550 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
553 En voici un exemple :
555 @lilypond[verbatim,quote,relative=2]
556 \new Voice \with { \consists "Balloon_engraver" }
558 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
560 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
562 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
566 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
567 @code{balloonText}. @code{balloonGrobText} prend en argument
568 l'objet graphique à agrémenter et s'utilise comme
569 @code{\once@tie{}\override}. @code{balloonText}, quant à lui, s'utilise
570 comme une simple articulation et fonctionne comme @code{\tweak} pour
571 attacher du texte à l'une des notes d'un accord. Les autres arguments
572 sont le décalage et le texte de la bulle.
574 Les info-bulles ont une influence sur les espacements, que l'on peut
578 @lilypond[verbatim,quote,relative=2]
579 \new Voice \with { \consists "Balloon_engraver" }
582 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
584 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
587 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
593 @code{\balloonLengthOn},
594 @code{\balloonLengthOff}.
600 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
602 Référence des propriétés internes :
603 @rinternals{Balloon_engraver},
604 @rinternals{BalloonTextItem},
605 @rinternals{balloon-interface}.
608 @node Quadrillage temporel
609 @unnumberedsubsubsec Quadrillage temporel
610 @translationof Grid lines
612 @cindex quadrillage temporel
613 @cindex temporel, quadrillage
615 @funindex Grid_point_engraver
616 @funindex Grid_line_span_engraver
617 @funindex gridInterval
619 Vous pouvez tracer des lignes entre les portées, synchronisées avec
622 LilyPond a recours à deux graveurs distincts afin d'afficher le
623 quadrillage@tie{}: le @code{Grid_point_engraver} se charge de
624 déterminer l'envergure du crochet, alors que le
625 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
626 Les lignes sont par défaut centrées horizontalement sous les notes et
627 alignées sur la gauche des têtes. La propriété @code{gridInterval}
628 spécifie quant à elle l'espace de temps entre chaque ligne.
631 @lilypond[verbatim,quote]
635 \consists "Grid_point_engraver" %% active les guides
636 gridInterval = #(ly:make-moment 1 4)
640 \consists "Grid_line_span_engraver"
641 %% centre les lignes guides horizontalement sous les notes
647 \new Staff \relative c'' {
651 \new Staff \relative c {
652 %% centre les lignes guides verticalement
663 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
664 {grid-lines--changing-their-appearance.ly}
669 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
671 Référence des propriétés internes :
672 @rinternals{Grid_line_span_engraver},
673 @rinternals{Grid_point_engraver},
674 @rinternals{GridLine},
675 @rinternals{GridPoint},
676 @rinternals{grid-line-interface},
677 @rinternals{grid-point-interface}.
680 @node Crochets d'analyse
681 @unnumberedsubsubsec Crochets d'analyse
682 @translationof Analysis brackets
685 @cindex crochets de phrasé
686 @cindex analyse musicologique
687 @cindex crochet de regroupement de notes
689 @funindex Horizontal_bracket_engraver
690 @funindex \startGroup
695 On utilise des crochets en analyse musicale, pour indiquer la
696 structure d'une pièce.
698 @lilypond[verbatim,quote]
702 \consists "Horizontal_bracket_engraver"
711 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
713 @lilypond[verbatim,quote]
717 \consists "Horizontal_bracket_engraver"
721 c4\startGroup\startGroup
724 d4\stopGroup\stopGroup
731 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
733 Référence des propriétés internes :
734 @rinternals{Horizontal_bracket_engraver},
735 @rinternals{HorizontalBracket},
736 @rinternals{horizontal-bracket-interface},