1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 65264f1ec906b40c1b281e360d4860f7a6eb8138
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@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}.
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@tie{}:
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
419 @funindex \parenthesize
420 @funindex parenthesize
422 Des objets peuvent être mis entre parenthèses en saisissant
423 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
424 préfixe un accord, chaque note le composant se présentera entre
425 parenthèses. Vous pouvez aussi mettre individuellement entre
426 parenthèses les notes d'un accord.
428 @lilypond[verbatim,quote,relative=2]
430 c2 \parenthesize <c e g>
431 c2 <c \parenthesize e g>
434 Les objets autres que des notes peuvent aussi être entre parenthèses.
435 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
436 doit cependant être précédée d'un tiret.
438 @lilypond[verbatim,quote,relative=2]
439 c2-\parenthesize -. d
445 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
447 Référence des propriétés internes :
448 @rinternals{Parenthesis_engraver},
449 @rinternals{ParenthesesItem},
450 @rinternals{parentheses-interface}.
453 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
454 individuellement à chacune des notes le composant, alors qu'on
455 attendrait une seule paire de parenthèses encadrant tout l'accord.
459 @unnumberedsubsubsec Hampes
463 @cindex hampes invisibles
464 @cindex visibilité des hampes
465 @cindex masquage des hampes
466 @cindex hampe, orientation
467 @cindex hampe montante
468 @cindex hampe descendante
475 @funindex \stemNeutral
476 @funindex stemNeutral
478 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
479 automatiquement. Pour les rondes et les silences, ils sont aussi
480 créés, mais en mode invisible.
482 L'orientation des hampes peut être définie manuellement -- voir
483 @ref{Direction et positionnement} à ce sujet.
493 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
494 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
499 @ref{Direction et positionnement}.
502 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
504 Référence des propriétés internes :
505 @rinternals{Stem_engraver},
507 @rinternals{stem-interface}.
510 @node Hors de la portée
511 @subsection Hors de la portée
512 @translationof Outside the staff
514 Nous allons nous intéresser ici à souligner des éléments inscrits dans
515 la portée par des éléments qui lui seront externes.
519 * Quadrillage temporel::
520 * Crochets d'analyse::
525 @unnumberedsubsubsec Info-bulle
526 @translationof Balloon help
529 @cindex notation, explication
532 @funindex \balloonGrobText
533 @funindex \balloonText
534 @funindex Balloon_engraver
535 @funindex balloonGrobText
536 @funindex balloonText
537 @funindex \balloonLengthOn
538 @funindex balloonLengthOn
539 @funindex \balloonLengthOff
540 @funindex balloonLengthOff
542 Vous pouvez marquer et nommer des éléments de notation à l'aide de
543 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
546 En voici un exemple :
548 @lilypond[verbatim,quote,relative=2]
549 \new Voice \with { \consists "Balloon_engraver" }
551 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
553 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
555 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
559 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
560 @code{balloonText}. @code{balloonGrobText} prend en argument
561 l'objet graphique à agrémenter et s'utilise comme
562 @code{\once@tie{}\override}. @code{balloonText}, quant à lui, s'utilise
563 comme une simple articulation et fonctionne comme @code{\tweak} pour
564 attacher du texte à l'une des notes d'un accord. Les autres arguments
565 sont le décalage et le texte de la bulle.
567 Les info-bulles ont une influence sur les espacements, que l'on peut
571 @lilypond[verbatim,quote,relative=2]
572 \new Voice \with { \consists "Balloon_engraver" }
575 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
577 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
580 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
585 @code{\balloonLengthOn},
586 @code{\balloonLengthOff}.
591 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
593 Référence des propriétés internes :
594 @rinternals{Balloon_engraver},
595 @rinternals{BalloonTextItem},
596 @rinternals{balloon-interface}.
599 @node Quadrillage temporel
600 @unnumberedsubsubsec Quadrillage temporel
601 @translationof Grid lines
603 @cindex quadrillage temporel
604 @cindex temporel, quadrillage
606 @funindex Grid_point_engraver
607 @funindex Grid_line_span_engraver
608 @funindex gridInterval
610 Vous pouvez tracer des lignes entre les portées, synchronisées avec
613 LilyPond a recours à deux graveurs distincts afin d'afficher le
614 quadrillage@tie{}: le @code{Grid_point_engraver} se charge de
615 déterminer l'envergure du crochet, alors que le
616 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
617 Les lignes sont par défaut centrées horizontalement sous les notes et
618 alignées sur la gauche des têtes. La propriété @code{gridInterval}
619 spécifie quant à elle l'espace de temps entre chaque ligne.
622 @lilypond[verbatim,quote]
626 \consists "Grid_point_engraver" %% active les guides
627 gridInterval = #(ly:make-moment 1 4)
631 \consists "Grid_line_span_engraver"
632 %% centre les lignes guides horizontalement sous les notes
638 \new Staff \relative c'' {
642 \new Staff \relative c {
643 %% centre les lignes guides verticalement
654 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
655 {grid-lines--changing-their-appearance.ly}
659 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
661 Référence des propriétés internes :
662 @rinternals{Grid_line_span_engraver},
663 @rinternals{Grid_point_engraver},
664 @rinternals{GridLine},
665 @rinternals{GridPoint},
666 @rinternals{grid-line-interface},
667 @rinternals{grid-point-interface}.
670 @node Crochets d'analyse
671 @unnumberedsubsubsec Crochets d'analyse
672 @translationof Analysis brackets
675 @cindex crochets de phrasé
676 @cindex analyse musicologique
677 @cindex crochet de regroupement de notes
679 @funindex Horizontal_bracket_engraver
680 @funindex \startGroup
685 On utilise des crochets en analyse musicale, pour indiquer la
686 structure d'une pièce.
688 @lilypond[verbatim,quote]
692 \consists "Horizontal_bracket_engraver"
701 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
703 @lilypond[verbatim,quote]
707 \consists "Horizontal_bracket_engraver"
711 c4\startGroup\startGroup
714 d4\stopGroup\stopGroup
720 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
722 Référence des propriétés internes :
723 @rinternals{Horizontal_bracket_engraver},
724 @rinternals{HorizontalBracket},
725 @rinternals{horizontal-bracket-interface},