1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5
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::
46 @node Indication de la taille de fonte musicale
47 @unnumberedsubsubsec Indication de la taille de fonte musicale
48 @translationof Selecting notation font size
50 @cindex sélection de la taille (notation)
52 @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 % 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 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}.
143 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
145 Référence des propriétés internes :
146 @rinternals{font-interface}.
150 @unnumberedsubsubsec Doigtés
151 @translationof Fingering instructions
154 @cindex substitution de doigt
159 Les doigtés peuvent être indiqués comme suit :
160 @var{note}-@var{chiffre_du_doigt}
162 @lilypond[verbatim,quote,relative=2]
166 Pour les substitutions de doigts, on a recours à une indication
167 textuelle (commande @code{\markup}) de doigté
168 (commande @code{\finger}).
170 @lilypond[verbatim,quote,relative=2]
171 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
174 @cindex pouce, doigté
179 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
180 dans une partition de violoncelle, si une note doit être jouée avec le
181 pouce (@emph{thumb} en anglais).
183 @lilypond[verbatim,quote,relative=2]
184 <a_\thumb a'-3>2 <b_\thumb b'-3>
187 @cindex doigtés des accords
188 @cindex accords, doigtés
190 Les doigtés des accords peuvent être saisis note par note,
191 en les indiquant après chaque hauteur de note.
193 @lilypond[verbatim,quote,relative=2]
194 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
197 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
198 la portée -- voir @ref{Direction et positionnement} à ce sujet.
202 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
203 {controlling-the-placement-of-chord-fingerings.ly}
205 @lilypondfile[verbatim,quote,texidoc,doctitle]
206 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
208 @lilypondfile[verbatim,quote,texidoc,doctitle]
209 {avoiding-collisions-with-chord-fingerings.ly}
213 @ref{Direction et positionnement}.
216 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
218 Référence des propriétés internes :
219 @rinternals{FingeringEvent},
220 @rinternals{fingering-event},
221 @rinternals{Fingering_engraver},
222 @rinternals{New_fingering_engraver},
223 @rinternals{Fingering}.
226 La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
227 défaut, les chiffres supérieurs à 9.
231 @unnumberedsubsubsec Dictée à trous
232 @translationof Hidden notes
234 @cindex masquées, notes
235 @cindex invisibles, notes
236 @cindex transparentes, notes
237 @cindex note invisible
242 @funindex \unHideNotes
243 @funindex unHideNotes
245 Les notes masquées -- ou invisibles ou encore transparentes -- sont
246 utiles dans le cadre d'exercices de théorie ou de composition.
248 @lilypond[verbatim,quote,relative=2]
260 Têtes de note, hampes, crochets et silences sont invisibles. Une
261 ligature sera invisible si elle démarre sur une note invisible.
262 Les objets de notation attachés à une note invisible ne seront pas
265 @lilypond[verbatim,quote,relative=2]
277 Manuel d'initiation :
278 @rlearning{Visibilité et couleur des objets}.
281 @ref{Silences invisibles},
282 @ref{Visibilité des objets},
283 @ref{Masquage de portées}.
286 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
288 Référence des propriétés internes :
289 @rinternals{Note_spacing_engraver},
290 @rinternals{NoteSpacing}.
293 @node Coloration d'objets
294 @unnumberedsubsubsec Coloration d'objets
295 @translationof Coloring objects
297 @cindex objets en couleur
299 @cindex colorisation d'objets
300 @cindex coloration d'objets
301 @cindex coloration de notes
302 @cindex colorisation de notes
303 @cindex notes en couleur
304 @cindex x11, couleurs
308 @funindex \with-color
312 Des objets peuvent être colorisés individuellement. Une listes des
313 noms des couleurs disponibles se trouvent à l'annexe
314 @ref{Liste des couleurs}.
316 @lilypond[verbatim,quote,relative=2]
317 \override NoteHead #'color = #red
319 \override NoteHead #'color = #(x11-color 'LimeGreen)
321 \override Stem #'color = #blue
325 L'intégralité de la palette des couleurs définies pour X11 est
326 accessible par la fonction Scheme @code{x11-color}. Cette fonction
327 prend en argument une expression symbolique de la forme
328 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
329 @code{@var{"TaraTata"}}. La première formulation est à la fois plus
330 rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
331 permet d'accéder aux noms composés des couleurs de X11.
333 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
334 elle revient à la couleur par défaut, le noir. Le problème ressort de
335 façon évidente au vu de la partition finale.
337 @lilypond[verbatim,quote,relative=2]
338 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
339 \set Staff.instrumentName = \markup {
340 \with-color #(x11-color 'navy) "Clarinet"
344 \override Beam #'color = #(x11-color "medium turquoise")
346 \override Accidental #'color = #(x11-color 'DarkRed)
348 \override NoteHead #'color = #(x11-color "LimeGreen")
350 % this is deliberate nonsense; note that the stems remain black
351 \override Stem #'color = #(x11-color 'Boggle)
363 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
364 les composantes de la couleur exacte au format rouge-vert-bleu
365 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
366 l'exemple suivant correspond à 128).
368 @lilypond[verbatim,quote,relative=2]
369 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
370 \set Staff.instrumentName = \markup {
371 \with-color #(x11-color 'navy) "Clarinet"
374 \override Stem #'color = #(rgb-color 0 0 0)
376 \override Stem #'color = #(rgb-color 1 1 1)
378 \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}.
391 @cindex couleur, notes d'un accord
392 @cindex notes colorisées dans un accord
393 @cindex accords et couleur
398 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
399 normale ayant un nom similaire.
401 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
402 internet. Aussi nous vous recommandons, dans le cadre d'une
403 présentation multimédia, d'utiliser des couleurs de base @code{blue},
404 @code{green}, @code{red} -- bleu, vert, rouge.
406 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
407 @code{\override}. Si besoin est, utilisez @code{\tweak}. Pour plus de
408 détails, consultez @ref{La commande d'affinage (tweak)}.
412 @unnumberedsubsubsec Parenthèses
413 @translationof Parentheses
415 @cindex fantômes, notes
416 @cindex notes fantômes
417 @cindex parenthèses, notes entre
418 @cindex crochets, notes entre
420 @funindex \parenthesize
421 @funindex parenthesize
423 Des objets peuvent être mis entre parenthèses en saisissant
424 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
425 préfixe un accord, chaque note le composant se présentera entre
426 parenthèses. Vous pouvez aussi mettre individuellement entre
427 parenthèses les notes d'un accord.
429 @lilypond[verbatim,quote,relative=2]
431 c2 \parenthesize <c e g>
432 c2 <c \parenthesize e g>
435 Les objets autres que des notes peuvent aussi être entre parenthèses.
436 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
437 doit cependant être précédée d'un tiret.
439 @lilypond[verbatim,quote,relative=2]
440 c2-\parenthesize -. d
446 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
448 Référence des propriétés internes :
449 @rinternals{Parenthesis_engraver},
450 @rinternals{ParenthesesItem},
451 @rinternals{parentheses-interface}.
454 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
455 individuellement à chacune des notes le composant, alors qu'on
456 attendrait une seule paire de parenthèses encadrant tout l'accord.
460 @unnumberedsubsubsec Hampes
464 @cindex hampes invisibles
465 @cindex visibilité des hampes
466 @cindex masquage des hampes
467 @cindex hampe, orientation
468 @cindex hampe montante
469 @cindex hampe descendante
476 @funindex \stemNeutral
477 @funindex stemNeutral
479 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
480 automatiquement. Pour les rondes et les silences, ils sont aussi
481 créés, mais en mode invisible.
483 L'orientation des hampes peut être définie manuellement -- voir
484 @ref{Direction et positionnement} à ce sujet.
494 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
495 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
500 @ref{Direction et positionnement}.
503 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
505 Référence des propriétés internes :
506 @rinternals{Stem_engraver},
508 @rinternals{stem-interface}.
511 @node Hors de la portée
512 @subsection Hors de la portée
513 @translationof Outside the staff
515 Nous allons nous intéresser ici à souligner des éléments inscrits dans
516 la portée par des éléments qui lui seront externes.
520 * Quadrillage temporel::
521 * Crochets d'analyse::
526 @unnumberedsubsubsec Info-bulle
527 @translationof Balloon help
530 @cindex notation, explication
533 @funindex \balloonGrobText
534 @funindex \balloonText
535 @funindex Balloon_engraver
536 @funindex balloonGrobText
537 @funindex balloonText
538 @funindex \balloonLengthOn
539 @funindex balloonLengthOn
540 @funindex \balloonLengthOff
541 @funindex balloonLengthOff
543 Vous pouvez marquer et nommer des éléments de notation à l'aide de
544 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
547 En voici un exemple :
549 @lilypond[verbatim,quote,relative=2]
550 \new Voice \with { \consists "Balloon_engraver" }
552 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
554 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
556 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
560 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
561 @code{balloonText}. @code{balloonGrobText} prend en argument
562 l'objet graphique à agrémenter et s'utilise comme
563 @code{\once \override}. @code{balloonText}, quant à lui, s'utilise
564 comme une simple articulation et fonctionne comme @code{\tweak} pour
565 attacher du texte à l'une des notes d'un accord. Les autres arguments
566 sont le décalage et le texte de la bulle.
568 Les info-bulles ont une influence sur les espacements, que l'on peut
572 @lilypond[verbatim,quote,relative=2]
573 \new Voice \with { \consists "Balloon_engraver" }
576 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
578 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
581 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
586 @code{\balloonLengthOn},
587 @code{\balloonLengthOff}.
592 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
594 Référence des propriétés internes :
595 @rinternals{Balloon_engraver},
596 @rinternals{BalloonTextItem},
597 @rinternals{balloon-interface}.
600 @node Quadrillage temporel
601 @unnumberedsubsubsec Quadrillage temporel
602 @translationof Grid lines
604 @cindex quadrillage temporel
605 @cindex temporel, quadrillage
607 @funindex Grid_point_engraver
608 @funindex Grid_line_span_engraver
609 @funindex gridInterval
611 Vous pouvez tracer des lignes entre les portées, synchronisées avec
614 LilyPond a recours à deux graveurs distincts afin d'afficher le
615 quadrillage : le @code{Grid_point_engraver} se charge de
616 déterminer l'envergure du crochet, alors que le
617 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
618 Les lignes sont par défaut centrées horizontalement sous les notes et
619 alignées sur la gauche des têtes. La propriété @code{gridInterval}
620 spécifie quant à elle l'espace de temps entre chaque ligne.
623 @lilypond[verbatim,quote]
627 \consists "Grid_point_engraver" %% active les guides
628 gridInterval = #(ly:make-moment 1 4)
632 \consists "Grid_line_span_engraver"
633 %% centre les lignes guides horizontalement sous les notes
639 \new Staff \relative c'' {
643 \new Staff \relative c {
644 %% centre les lignes guides verticalement
655 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
656 {grid-lines--changing-their-appearance.ly}
660 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
662 Référence des propriétés internes :
663 @rinternals{Grid_line_span_engraver},
664 @rinternals{Grid_point_engraver},
665 @rinternals{GridLine},
666 @rinternals{GridPoint},
667 @rinternals{grid-line-interface},
668 @rinternals{grid-point-interface}.
671 @node Crochets d'analyse
672 @unnumberedsubsubsec Crochets d'analyse
673 @translationof Analysis brackets
676 @cindex crochets de phrasé
677 @cindex analyse musicologique
678 @cindex crochet de regroupement de notes
680 @funindex Horizontal_bracket_engraver
681 @funindex \startGroup
686 On utilise des crochets en analyse musicale, pour indiquer la
687 structure d'une pièce.
689 @lilypond[verbatim,quote]
693 \consists "Horizontal_bracket_engraver"
702 Les crochets d'analyses sont susceptibles d'être imbriqués :
704 @lilypond[verbatim,quote]
708 \consists "Horizontal_bracket_engraver"
712 c4\startGroup\startGroup
715 d4\stopGroup\stopGroup
721 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
723 Référence des propriétés internes :
724 @rinternals{Horizontal_bracket_engraver},
725 @rinternals{HorizontalBracket},
726 @rinternals{horizontal-bracket-interface},