1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 5c35684285613e8960e2dd4324559e1ee3774b9b
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\finger \markup \tied-lyric #"4~3" c\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}.
228 @unnumberedsubsubsec Dictée à trous
229 @translationof Hidden notes
231 @cindex masquées, notes
232 @cindex invisibles, notes
233 @cindex transparentes, notes
234 @cindex note invisible
239 @funindex \unHideNotes
240 @funindex unHideNotes
242 Les notes masquées -- ou invisibles ou encore transparentes -- sont
243 utiles dans le cadre d'exercices de théorie ou de composition.
245 @lilypond[verbatim,quote,relative=2]
257 Têtes de note, hampes, crochets et silences sont invisibles. Une
258 ligature sera invisible si elle démarre sur une note invisible.
259 Les objets de notation attachés à une note invisible ne seront pas
262 @lilypond[verbatim,quote,relative=2]
274 Manuel d'initiation :
275 @rlearning{Visibilité et couleur des objets}.
278 @ref{Silences invisibles},
279 @ref{Visibilité des objets},
280 @ref{Masquage de portées}.
283 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
285 Référence des propriétés internes :
286 @rinternals{Note_spacing_engraver},
287 @rinternals{NoteSpacing}.
290 @node Coloration d'objets
291 @unnumberedsubsubsec Coloration d'objets
292 @translationof Coloring objects
294 @cindex objets en couleur
296 @cindex colorisation d'objets
297 @cindex coloration d'objets
298 @cindex coloration de notes
299 @cindex colorisation de notes
300 @cindex notes en couleur
301 @cindex x11, couleurs
305 @funindex \with-color
309 Des objets peuvent être colorisés individuellement. Une listes des
310 noms des couleurs disponibles se trouvent à l'annexe
311 @ref{Liste des couleurs}.
313 @lilypond[verbatim,quote,relative=2]
314 \override NoteHead.color = #red
316 \override NoteHead.color = #(x11-color 'LimeGreen)
318 \override Stem.color = #blue
322 L'intégralité de la palette des couleurs définies pour X11 est
323 accessible par la fonction Scheme @code{x11-color}. Cette fonction
324 prend en argument une expression symbolique de la forme
325 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
326 @code{@var{"TaraTata"}}. La première formulation est à la fois plus
327 rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
328 permet d'accéder aux noms composés des couleurs de X11.
330 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
331 elle revient à la couleur par défaut, le noir. Le problème ressort de
332 façon évidente au vu de la partition finale.
334 @lilypond[verbatim,quote,relative=2]
335 \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
336 \set Staff.instrumentName = \markup {
337 \with-color #(x11-color 'navy) "Clarinet"
341 \override Beam.color = #(x11-color "medium turquoise")
343 \override Accidental.color = #(x11-color 'DarkRed)
345 \override NoteHead.color = #(x11-color "LimeGreen")
347 % this is deliberate nonsense; note that the stems remain black
348 \override Stem.color = #(x11-color 'Boggle)
360 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
361 les composantes de la couleur exacte au format rouge-vert-bleu
362 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
363 l'exemple suivant correspond à 128).
365 @lilypond[verbatim,quote,relative=2]
366 \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
367 \set Staff.instrumentName = \markup {
368 \with-color #(x11-color 'navy) "Clarinet"
371 \override Stem.color = #(rgb-color 0 0 0)
373 \override Stem.color = #(rgb-color 1 1 1)
375 \override Stem.color = #(rgb-color 0 0 0.5)
381 @ref{Liste des couleurs},
382 @ref{La commande d'affinage (tweak)}.
385 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
388 @cindex couleur, notes d'un accord
389 @cindex notes colorisées dans un accord
390 @cindex accords et couleur
395 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
396 normale ayant un nom similaire.
398 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
399 internet. Aussi nous vous recommandons, dans le cadre d'une
400 présentation multimédia, d'utiliser des couleurs de base @code{blue},
401 @code{green}, @code{red} -- bleu, vert, rouge.
403 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
404 @code{\override}. Si besoin est, utilisez @code{\tweak}. Pour plus de
405 détails, consultez @ref{La commande d'affinage (tweak)}.
409 @unnumberedsubsubsec Parenthèses
410 @translationof Parentheses
412 @cindex fantômes, notes
413 @cindex notes fantômes
414 @cindex parenthèses, notes entre
415 @cindex crochets, notes entre
417 @funindex \parenthesize
418 @funindex parenthesize
420 Des objets peuvent être mis entre parenthèses en saisissant
421 @code{\parenthesize} juste avant l'événement musical. Si l'instruction
422 préfixe un accord, chaque note le composant se présentera entre
423 parenthèses. Vous pouvez aussi mettre individuellement entre
424 parenthèses les notes d'un accord.
426 @lilypond[verbatim,quote,relative=2]
428 c2 \parenthesize <c e g>
429 c2 <c \parenthesize e g>
432 Les objets autres que des notes peuvent aussi être entre parenthèses.
433 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
434 doit cependant être précédée d'un tiret.
436 @lilypond[verbatim,quote,relative=2]
437 c2-\parenthesize -. d
443 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
445 Référence des propriétés internes :
446 @rinternals{Parenthesis_engraver},
447 @rinternals{ParenthesesItem},
448 @rinternals{parentheses-interface}.
451 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
452 individuellement à chacune des notes le composant, alors qu'on
453 attendrait une seule paire de parenthèses encadrant tout l'accord.
457 @unnumberedsubsubsec Hampes
461 @cindex hampes invisibles
462 @cindex visibilité des hampes
463 @cindex masquage des hampes
464 @cindex hampe, orientation
465 @cindex hampe montante
466 @cindex hampe descendante
473 @funindex \stemNeutral
474 @funindex stemNeutral
476 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
477 automatiquement. Pour les rondes et les silences, ils sont aussi
478 créés, mais en mode invisible.
480 L'orientation des hampes peut être définie manuellement -- voir
481 @ref{Direction et positionnement} à ce sujet.
491 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
492 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
494 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
495 {automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.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 \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 n'ont aucune influence sur l'espacement des notes ; on
568 peut toutefois le gérer ainsi :
571 @lilypond[verbatim,quote,relative=2]
572 \new Voice \with { \consists "Balloon_engraver" }
574 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
576 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
579 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
584 @code{\balloonLengthOn},
585 @code{\balloonLengthOff}.
590 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
592 Référence des propriétés internes :
593 @rinternals{Balloon_engraver},
594 @rinternals{BalloonTextItem},
595 @rinternals{balloon-interface}.
598 @node Quadrillage temporel
599 @unnumberedsubsubsec Quadrillage temporel
600 @translationof Grid lines
602 @cindex quadrillage temporel
603 @cindex temporel, quadrillage
605 @funindex Grid_point_engraver
606 @funindex Grid_line_span_engraver
607 @funindex gridInterval
609 Vous pouvez tracer des lignes entre les portées, synchronisées avec
612 LilyPond a recours à deux graveurs distincts afin d'afficher le
613 quadrillage : le @code{Grid_point_engraver} se charge de
614 déterminer l'envergure du crochet, alors que le
615 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
616 Les lignes sont par défaut centrées horizontalement sous les notes et
617 alignées sur la gauche des têtes. La propriété @code{gridInterval}
618 spécifie quant à elle l'espace de temps entre chaque ligne.
621 @lilypond[verbatim,quote]
625 \consists "Grid_point_engraver" %% active les guides
626 gridInterval = #(ly:make-moment 1/4)
630 \consists "Grid_line_span_engraver"
631 %% centre les lignes guides horizontalement sous les notes
637 \new Staff \relative c'' {
641 \new Staff \relative c {
642 %% centre les lignes guides verticalement
653 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
654 {grid-lines--changing-their-appearance.ly}
658 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
660 Référence des propriétés internes :
661 @rinternals{Grid_line_span_engraver},
662 @rinternals{Grid_point_engraver},
663 @rinternals{GridLine},
664 @rinternals{GridPoint},
665 @rinternals{grid-line-interface},
666 @rinternals{grid-point-interface}.
669 @node Crochets d'analyse
670 @unnumberedsubsubsec Crochets d'analyse
671 @translationof Analysis brackets
674 @cindex crochets de phrasé
675 @cindex analyse musicologique
676 @cindex crochet de regroupement de notes
678 @funindex Horizontal_bracket_engraver
679 @funindex \startGroup
684 On utilise des crochets en analyse musicale, pour indiquer la
685 structure d'une pièce.
687 @lilypond[verbatim,quote]
691 \consists "Horizontal_bracket_engraver"
700 Les crochets d'analyses sont susceptibles d'être imbriqués :
702 @lilypond[verbatim,quote]
706 \consists "Horizontal_bracket_engraver"
710 c4\startGroup\startGroup
713 d4\stopGroup\stopGroup
719 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
721 Référence des propriétés internes :
722 @rinternals{Horizontal_bracket_engraver},
723 @rinternals{HorizontalBracket},
724 @rinternals{horizontal-bracket-interface},