1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 049bdd90b5ae67fe463bf85e926c2eabf51acf74
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
72 Le plus sûr moyen de régler la taille de la police, quel que soit le
73 contexte, consiste à définir la propriété @code{fontSize}.
74 Ceci ne modifiera en rien la taille des différents symboles tels que
75 ligatures ou liaisons.
77 @warning{En matière de taille des éléments textuels, référez-vous au
78 chapitre @ref{Sélection de la fonte et de la taille}.}
80 @lilypond[verbatim,quote,relative=2]
95 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
96 de définir la propriété @code{font-size} pour tous les objets de
97 rendu. La valeur de @code{font-size} est un entier représentant la
98 taille proportionnellement à la hauteur standard de la portée en
99 cours. Chaque incrément correspond à une augmentation d'environ
100 12 % de la taille de la police. Un pas de six aboutit exactement
101 au doublement de la taille. La fonction Scheme @code{magstep}
102 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
103 Vous pouvez aussi définir directement la propriété @code{font-size} de
104 manière à n'affecter seulement que certains objets de rendu.
106 @lilypond[verbatim,quote,relative=2]
109 \override NoteHead #'font-size = #-4
111 \override Script #'font-size = #2
113 \override Stem #'font-size = #-5
117 @cindex standard, taille des notes
118 @cindex notes, taille standard
120 @funindex font-interface
123 Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
124 dont la taille est la plus proche de la taille voulue. La taille
125 standard (pour laquelle @code{font-size = #0}) dépend de la hauteur
126 de la portée. À une portée de 20 points correspond une police de
129 La propriété @code{font-size} ne peut intervenir que pour les objets
130 qui utilisent des polices, autrement dit ceux qui disposent de
131 l'interface de rendu @code{font-interface}.
144 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
146 Référence des propriétés internes :
147 @rinternals{font-interface}.
151 @unnumberedsubsubsec Doigtés
152 @translationof Fingering instructions
155 @cindex substitution de doigt
160 Les doigtés peuvent être indiqués comme suit :
161 @var{note}-@var{chiffre_du_doigt}
163 @lilypond[verbatim,quote,relative=2]
167 Pour les substitutions de doigts, on a recours à une indication
168 textuelle (commande @code{\markup}) de doigté
169 (commande @code{\finger}).
171 @lilypond[verbatim,quote,relative=2]
172 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
175 @cindex pouce, doigté
180 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
181 dans une partition de violoncelle, si une note doit être jouée avec le
182 pouce (@emph{thumb} en anglais).
184 @lilypond[verbatim,quote,relative=2]
185 <a_\thumb a'-3>2 <b_\thumb b'-3>
188 @cindex doigtés des accords
189 @cindex accords, doigtés
191 Les doigtés des accords peuvent être saisis note par note,
192 en les indiquant après chaque hauteur de note.
194 @lilypond[verbatim,quote,relative=2]
195 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
198 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
199 la portée -- voir @ref{Direction et positionnement} à ce sujet.
203 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
204 {controlling-the-placement-of-chord-fingerings.ly}
206 @lilypondfile[verbatim,quote,texidoc,doctitle]
207 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
209 @lilypondfile[verbatim,quote,texidoc,doctitle]
210 {avoiding-collisions-with-chord-fingerings.ly}
214 @ref{Direction et positionnement}.
217 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
219 Référence des propriétés internes :
220 @rinternals{FingeringEvent},
221 @rinternals{fingering-event},
222 @rinternals{Fingering_engraver},
223 @rinternals{New_fingering_engraver},
224 @rinternals{Fingering}.
227 La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
228 défaut, les chiffres supérieurs à 9.
232 @unnumberedsubsubsec Dictée à trous
233 @translationof Hidden notes
235 @cindex masquées, notes
236 @cindex invisibles, notes
237 @cindex transparentes, notes
238 @cindex note invisible
243 @funindex \unHideNotes
244 @funindex unHideNotes
246 Les notes masquées -- ou invisibles ou encore transparentes -- sont
247 utiles dans le cadre d'exercices de théorie ou de composition.
249 @lilypond[verbatim,quote,relative=2]
261 Têtes de note, hampes, crochets et silences sont invisibles. Une
262 ligature sera invisible si elle démarre sur une note invisible.
263 Les objets de notation attachés à une note invisible ne seront pas
266 @lilypond[verbatim,quote,relative=2]
278 Manuel d'initiation :
279 @rlearning{Visibilité et couleur des objets}.
282 @ref{Silences invisibles},
283 @ref{Visibilité des objets},
284 @ref{Masquage de portées}.
287 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
289 Référence des propriétés internes :
290 @rinternals{Note_spacing_engraver},
291 @rinternals{NoteSpacing}.
294 @node Coloration d'objets
295 @unnumberedsubsubsec Coloration d'objets
296 @translationof Coloring objects
298 @cindex objets en couleur
300 @cindex colorisation d'objets
301 @cindex coloration d'objets
302 @cindex coloration de notes
303 @cindex colorisation de notes
304 @cindex notes en couleur
305 @cindex x11, couleurs
309 @funindex \with-color
313 Des objets peuvent être colorisés individuellement. Une listes des
314 noms des couleurs disponibles se trouvent à l'annexe
315 @ref{Liste des couleurs}.
317 @lilypond[verbatim,quote,relative=2]
318 \override NoteHead #'color = #red
320 \override NoteHead #'color = #(x11-color 'LimeGreen)
322 \override Stem #'color = #blue
326 L'intégralité de la palette des couleurs définies pour X11 est
327 accessible par la fonction Scheme @code{x11-color}. Cette fonction
328 prend en argument une expression symbolique de la forme
329 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
330 @code{@var{"TaraTata"}}. La première formulation est à la fois plus
331 rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
332 permet d'accéder aux noms composés des couleurs de X11.
334 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
335 elle revient à la couleur par défaut, le noir. Le problème ressort de
336 façon évidente au vu de la partition finale.
338 @lilypond[verbatim,quote,relative=2]
339 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
340 \set Staff.instrumentName = \markup {
341 \with-color #(x11-color 'navy) "Clarinet"
345 \override Beam #'color = #(x11-color "medium turquoise")
347 \override Accidental #'color = #(x11-color 'DarkRed)
349 \override NoteHead #'color = #(x11-color "LimeGreen")
351 % this is deliberate nonsense; note that the stems remain black
352 \override Stem #'color = #(x11-color 'Boggle)
364 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
365 les composantes de la couleur exacte au format rouge-vert-bleu
366 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
367 l'exemple suivant correspond à 128).
369 @lilypond[verbatim,quote,relative=2]
370 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
371 \set Staff.instrumentName = \markup {
372 \with-color #(x11-color 'navy) "Clarinet"
375 \override Stem #'color = #(rgb-color 0 0 0)
377 \override Stem #'color = #(rgb-color 1 1 1)
379 \override Stem #'color = #(rgb-color 0 0 0.5)
385 @ref{Liste des couleurs},
386 @ref{La commande d'affinage (tweak)}.
389 @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 multimédia, d'utiliser des couleurs de base @code{blue},
405 @code{green}, @code{red} -- bleu, vert, rouge.
407 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
408 @code{\override}. Si besoin est, utilisez @code{\tweak}. Pour plus de
409 détails, consultez @ref{La commande d'affinage (tweak)}.
413 @unnumberedsubsubsec Parenthèses
414 @translationof Parentheses
416 @cindex fantômes, notes
417 @cindex notes fantômes
418 @cindex parenthèses, notes entre
419 @cindex crochets, notes entre
421 @funindex \parenthesize
422 @funindex parenthesize
424 Des objets peuvent être mis entre parenthèses en saisissant
425 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
426 préfixe un accord, chaque note le composant se présentera entre
427 parenthèses. Vous pouvez aussi mettre individuellement entre
428 parenthèses les notes d'un accord.
430 @lilypond[verbatim,quote,relative=2]
432 c2 \parenthesize <c e g>
433 c2 <c \parenthesize e g>
436 Les objets autres que des notes peuvent aussi être entre parenthèses.
437 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
438 doit cependant être précédée d'un tiret.
440 @lilypond[verbatim,quote,relative=2]
441 c2-\parenthesize -. d
447 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
449 Référence des propriétés internes :
450 @rinternals{Parenthesis_engraver},
451 @rinternals{ParenthesesItem},
452 @rinternals{parentheses-interface}.
455 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
456 individuellement à chacune des notes le composant, alors qu'on
457 attendrait une seule paire de parenthèses encadrant tout l'accord.
461 @unnumberedsubsubsec Hampes
465 @cindex hampes invisibles
466 @cindex visibilité des hampes
467 @cindex masquage des hampes
468 @cindex hampe, orientation
469 @cindex hampe montante
470 @cindex hampe descendante
477 @funindex \stemNeutral
478 @funindex stemNeutral
480 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
481 automatiquement. Pour les rondes et les silences, ils sont aussi
482 créés, mais en mode invisible.
484 L'orientation des hampes peut être définie manuellement -- voir
485 @ref{Direction et positionnement} à ce sujet.
495 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
496 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
501 @ref{Direction et positionnement}.
504 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
506 Référence des propriétés internes :
507 @rinternals{Stem_engraver},
509 @rinternals{stem-interface}.
512 @node Hors de la portée
513 @subsection Hors de la portée
514 @translationof Outside the staff
516 Nous allons nous intéresser ici à souligner des éléments inscrits dans
517 la portée par des éléments qui lui seront externes.
521 * Quadrillage temporel::
522 * Crochets d'analyse::
527 @unnumberedsubsubsec Info-bulle
528 @translationof Balloon help
531 @cindex notation, explication
534 @funindex \balloonGrobText
535 @funindex \balloonText
536 @funindex Balloon_engraver
537 @funindex balloonGrobText
538 @funindex balloonText
539 @funindex \balloonLengthOn
540 @funindex balloonLengthOn
541 @funindex \balloonLengthOff
542 @funindex balloonLengthOff
544 Vous pouvez marquer et nommer des éléments de notation à l'aide de
545 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
548 En voici un exemple :
550 @lilypond[verbatim,quote,relative=2]
551 \new Voice \with { \consists "Balloon_engraver" }
553 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
555 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
557 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
561 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
562 @code{balloonText}. @code{balloonGrobText} prend en argument
563 l'objet graphique à agrémenter et s'utilise comme
564 @code{\once \override}. @code{balloonText}, quant à lui, s'utilise
565 comme une simple articulation et fonctionne comme @code{\tweak} pour
566 attacher du texte à l'une des notes d'un accord. Les autres arguments
567 sont le décalage et le texte de la bulle.
569 Les info-bulles ont une influence sur les espacements, que l'on peut
573 @lilypond[verbatim,quote,relative=2]
574 \new Voice \with { \consists "Balloon_engraver" }
577 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
579 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
582 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
587 @code{\balloonLengthOn},
588 @code{\balloonLengthOff}.
593 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
595 Référence des propriétés internes :
596 @rinternals{Balloon_engraver},
597 @rinternals{BalloonTextItem},
598 @rinternals{balloon-interface}.
601 @node Quadrillage temporel
602 @unnumberedsubsubsec Quadrillage temporel
603 @translationof Grid lines
605 @cindex quadrillage temporel
606 @cindex temporel, quadrillage
608 @funindex Grid_point_engraver
609 @funindex Grid_line_span_engraver
610 @funindex gridInterval
612 Vous pouvez tracer des lignes entre les portées, synchronisées avec
615 LilyPond a recours à deux graveurs distincts afin d'afficher le
616 quadrillage : le @code{Grid_point_engraver} se charge de
617 déterminer l'envergure du crochet, alors que le
618 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
619 Les lignes sont par défaut centrées horizontalement sous les notes et
620 alignées sur la gauche des têtes. La propriété @code{gridInterval}
621 spécifie quant à elle l'espace de temps entre chaque ligne.
624 @lilypond[verbatim,quote]
628 \consists "Grid_point_engraver" %% active les guides
629 gridInterval = #(ly:make-moment 1 4)
633 \consists "Grid_line_span_engraver"
634 %% centre les lignes guides horizontalement sous les notes
640 \new Staff \relative c'' {
644 \new Staff \relative c {
645 %% centre les lignes guides verticalement
656 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
657 {grid-lines--changing-their-appearance.ly}
661 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
663 Référence des propriétés internes :
664 @rinternals{Grid_line_span_engraver},
665 @rinternals{Grid_point_engraver},
666 @rinternals{GridLine},
667 @rinternals{GridPoint},
668 @rinternals{grid-line-interface},
669 @rinternals{grid-point-interface}.
672 @node Crochets d'analyse
673 @unnumberedsubsubsec Crochets d'analyse
674 @translationof Analysis brackets
677 @cindex crochets de phrasé
678 @cindex analyse musicologique
679 @cindex crochet de regroupement de notes
681 @funindex Horizontal_bracket_engraver
682 @funindex \startGroup
687 On utilise des crochets en analyse musicale, pour indiquer la
688 structure d'une pièce.
690 @lilypond[verbatim,quote]
694 \consists "Horizontal_bracket_engraver"
703 Les crochets d'analyses sont susceptibles d'être imbriqués :
705 @lilypond[verbatim,quote]
709 \consists "Horizontal_bracket_engraver"
713 c4\startGroup\startGroup
716 d4\stopGroup\stopGroup
722 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
724 Référence des propriétés internes :
725 @rinternals{Horizontal_bracket_engraver},
726 @rinternals{HorizontalBracket},
727 @rinternals{horizontal-bracket-interface},