1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: ca543ea73189a1e53af94973dad0b8a5042c130c
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
11 @c Translators: Jean-Charles Malahieude
13 @node Notation éditoriale
14 @section Notation éditoriale
15 @translationof Editorial annotations
17 @lilypondfile[quote]{editorial-headword.ly}
19 Ce chapitre traite de la manière de modifier l'apparence des notes dans
20 un but pédagogique ou d'analyse.
29 @subsection Dans la portée
30 @translationof Inside the staff
32 Nous allons voir ici comment mettre en exergue certains éléments à
33 l'intérieur même de la portée.
36 * Indication de la taille de fonte musicale::
39 * Coloration d'objets::
44 @node Indication de la taille de fonte musicale
45 @unnumberedsubsubsec Indication de la taille de fonte musicale
46 @translationof Selecting notation font size
48 @cindex selection de la taille (notation)
50 @cindex taille des notes
70 Le plus sûr moyen de régler la taille de la police, quel que soit le
71 contexte, consiste à définir la propriété @code{fontSize}.
72 Ceci ne modifiera en rien la taille des différents symboles tels que
73 ligatures ou liaisons.
75 @warning{En matière de taille des éléments textuels, référez-vous au
76 chapitre @ref{Sélection de la fonte et de la taille}.}
78 @lilypond[verbatim,quote,relative=2]
93 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
94 de définir la propriété @code{font-size} pour tous les objets de
95 rendu. La valeur de @code{font-size} est un entier représentant la
96 taille proportionnellement à la hauteur standard de la portée en
97 cours. Chaque incrément correspond à une augmentation d'environ
98 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
99 au doublement de la taille. La fonction Scheme @code{magstep}
100 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
101 Vous pouvez aussi définir directement la propriété @code{font-size} de
102 manière à n'affecter seulement que certains objets de rendu.
104 @lilypond[verbatim,quote,relative=2]
107 \override NoteHead #'font-size = #-4
109 \override Script #'font-size = #2
111 \override Stem #'font-size = #-5
115 @cindex standard, taille des notes
116 @cindex notes, taille standard
118 @funindex font-interface
121 Pour changer la taille des symboles musicaux (police Feta), LilyPond met
122 à l'échelle la fonte dont la taille est la plus proche de la taille
123 voulue -- cf. @ref{Définition de la taille de portée}. 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 10
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 @rlsr{Editorial annotations}.
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 :
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 @rlsr{Editorial annotations}.
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
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 Les objets de notation attachés à une note invisible ne seront pas
260 @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 @rlsr{Editorial annotations}.
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 @var{'TaraTata}
325 ou bien une chaîne de caractères comme @var{"TaraTata"}. La première
326 formulation est à la fois plus rapide à écrire et aussi plus efficace.
327 Néanmoins, la deuxième forme permet d'accéder aux noms composés des
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
364 @lilypond[verbatim,quote,relative=2]
365 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
366 \set Staff.instrumentName = \markup {
367 \with-color #(x11-color 'navy) "Clarinet"
370 \override Stem #'color = #(rgb-color 0 0 0)
372 \override Stem #'color = #(rgb-color 1 1 1)
374 \override Stem #'color = #(rgb-color 0 0 0.5)
381 @ref{Liste des couleurs},
382 @ref{La commande d'affinage (@emph{tweak})}.
385 @rlsr{Editorial annotations}.
389 @cindex couleur, notes d'un accord
390 @cindex notes colorisées dans un accord
391 @cindex accords et couleur
396 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
397 normale ayant un nom similaire.
399 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
400 internet. Aussi nous vous recommandons, dans le cadre d'une
401 présentation multimedia, d'utiliser des couleurs de base @code{#blue},
402 @code{#green}, @code{#red} -- bleu, vert, rouge.
405 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
406 @code{\override}. Si besoin est, utilisez @code{\tweak}.
407 Pour plus de détails, consultez
408 @ref{La commande d'affinage (@emph{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
446 @rlsr{Editorial annotations}.
448 Référence des propriétés internes :
449 @rinternals{Parenthesis_engraver},
450 @rinternals{ParenthesesItem},
451 @rinternals{parentheses-interface}.
456 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
457 individuellement à chacune des notes le composant, alors qu'on
458 attendrait une seule paire de parenthèses encadrant tout l'accord.
462 @unnumberedsubsubsec Hampes
466 @cindex hampes invisibles
467 @cindex visibilité des hampes
468 @cindex masquage des hampes
474 @funindex \stemNeutral
475 @funindex stemNeutral
476 @cindex stem, direction
479 @cindex stem, neutral
481 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
482 automatiquement. Pour les rondes et les silences, ils sont aussi
483 créés, mais en mode invisible.
485 La direction des hampes peut être définie manuellement -- voir
486 @ref{Direction et positionnement} à ce sujet.
498 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
499 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
504 @ref{Direction et positionnement}.
507 @rlsr{Editorial annotations}.
509 Référence des propriétés internes :
510 @rinternals{Stem_engraver},
512 @rinternals{stem-interface}.
515 @node Hors de la portée
516 @subsection Hors de la portée
517 @translationof Outside the staff
519 Nous allons nous intéresser ici à souligner des éléments inscrits dans
520 la portée par des éléments qui lui seront externes.
524 * Quadrillage temporel::
525 * Crochets d'analyse::
529 @unnumberedsubsubsec Info-bulle
530 @translationof Balloon help
533 @cindex notation, explication
536 @funindex \balloonGrobText
537 @funindex \balloonText
538 @funindex Balloon_engraver
539 @funindex balloonGrobText
540 @funindex balloonText
541 @funindex \balloonLengthOn
542 @funindex balloonLengthOn
543 @funindex \balloonLengthOff
544 @funindex balloonLengthOff
546 Vous pouvez marquer et nommer des éléments de notation à l'aide de
547 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
550 En voici un exemple :
552 @lilypond[verbatim,quote,relative=2]
553 \new Voice \with { \consists "Balloon_engraver" }
555 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
557 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
559 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
564 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
565 @code{balloonText}. @code{balloonGrobText} prend en argument
566 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
567 comme une simple articulation. Les autres arguments sont le décalage
568 et le texte de la bulle.
570 Les info-bulles ont une influence sur les espacements, que l'on peut
574 @lilypond[verbatim,quote,relative=2]
575 \new Voice \with { \consists "Balloon_engraver" }
578 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
580 \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
583 <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
589 @code{\balloonLengthOn},
590 @code{\balloonLengthOff}.
596 @rlsr{Editorial annotations}.
598 Référence des propriétés internes :
599 @rinternals{Balloon_engraver},
600 @rinternals{BalloonTextItem},
601 @rinternals{balloon-interface}.
604 @node Quadrillage temporel
605 @unnumberedsubsubsec Quadrillage temporel
606 @translationof Grid lines
608 @cindex cadrillage temporel
609 @cindex temporel, cadrillage
611 @funindex Grid_point_engraver
612 @funindex Grid_line_span_engraver
613 @funindex gridInterval
615 Vous pouvez tracer des lignes entre les portées, synchronisées avec
618 LilyPond a recours à deux graveurs distincts afin d'afficher le
619 cadrillage : le @code{Grid_point_engraver} se charge de
620 déterminer l'envergure du crochet, alors que le
621 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
622 Les lignes sont par défaut centrées horizontalement sous les notes et
623 alignées sur la gauche des têtes. La propriété @code{gridInterval}
624 spécifie quant à elle l'espace de temps entre chaque ligne.
627 @lilypond[verbatim,quote]
631 \consists "Grid_point_engraver" %% active les guides
632 gridInterval = #(ly:make-moment 1 4)
636 \consists "Grid_line_span_engraver"
637 %% centre les lignes guides horizontalement sous les notes
643 \new Staff \relative c'' {
647 \new Staff \relative c {
648 %% centre les lignes guides verticalement
659 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
660 {grid-lines--changing-their-appearance.ly}
665 @rlsr{Editorial annotations}.
667 Référence des propriétés internes :
668 @rinternals{Grid_line_span_engraver},
669 @rinternals{Grid_point_engraver},
670 @rinternals{GridLine},
671 @rinternals{GridPoint},
672 @rinternals{grid-line-interface},
673 @rinternals{grid-point-interface}.
676 @node Crochets d'analyse
677 @unnumberedsubsubsec Crochets d'analyse
678 @translationof Analysis brackets
681 @cindex crochets de phrasé
682 @cindex analyse musicologique
683 @cindex crochet de regroupement de notes
685 @funindex Horizontal_bracket_engraver
686 @funindex \startGroup
691 On utilise des crochets en analyse musicale, pour indiquer la
692 structure d'une pièce.
694 @lilypond[verbatim,quote]
698 \consists "Horizontal_bracket_engraver"
707 Les crochets d'analyses sont susceptibles d'être imbriqués :
709 @lilypond[verbatim,quote]
713 \consists "Horizontal_bracket_engraver"
717 c4\startGroup\startGroup
720 d4\stopGroup\stopGroup
727 @rlsr{Editorial annotations}.
729 Référence des propriétés internes :
730 @rinternals{Horizontal_bracket_engraver},
731 @rinternals{HorizontalBracket},
732 @rinternals{horizontal-bracket-interface},