]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/editorial.itely
Doc-fr: updates NR
[lilypond.git] / Documentation / fr / notation / editorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2
3 @ignore
4     Translation of GIT committish: 5c35684285613e8960e2dd4324559e1ee3774b9b
5
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..
9 @end ignore
10
11 @c \version "2.17.11"
12
13 @c Translators: Jean-Charles Malahieude
14
15 @node Annotations éditoriales
16 @section Annotations éditoriales
17 @translationof Editorial annotations
18
19 @lilypondfile[quote]{editorial-headword.ly}
20
21 Ce chapitre traite de la manière de modifier l'apparence des notes dans
22 un but pédagogique ou d'analyse.
23
24 @menu
25 * Dans la portée::
26 * Hors de la portée::
27 @end menu
28
29
30 @node Dans la portée
31 @subsection Dans la portée
32 @translationof Inside the staff
33
34 Nous allons voir ici comment mettre en exergue certains éléments à
35 l'intérieur même de la portée.
36
37 @menu
38 * Indication de la taille de fonte musicale::
39 * Doigtés::
40 * Dictée à trous::
41 * Coloration d'objets::
42 * Parenthèses::
43 * Hampes::
44 @end menu
45
46
47 @node Indication de la taille de fonte musicale
48 @unnumberedsubsubsec Indication de la taille de fonte musicale
49 @translationof Selecting notation font size
50
51 @cindex sélection de la taille (notation)
52 @cindex notes, taille
53 @cindex taille des notes
54 @cindex têtes de note
55
56 @funindex fontSize
57 @funindex font-size
58 @funindex magstep
59 @funindex \huge
60 @funindex \large
61 @funindex \normalsize
62 @funindex \small
63 @funindex \tiny
64 @funindex \teeny
65 @funindex huge
66 @funindex large
67 @funindex normalsize
68 @funindex small
69 @funindex tiny
70 @funindex teeny
71
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.
76
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}.}
79
80 @lilypond[verbatim,quote,relative=2]
81 \huge
82 c4.-> d8---3
83 \large
84 c4.-> d8---3
85 \normalsize
86 c4.-> d8---3
87 \small
88 c4.-> d8---3
89 \tiny
90 c4.-> d8---3
91 \teeny
92 c4.-> d8---3
93 @end lilypond
94
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.
105
106 @lilypond[verbatim,quote,relative=2]
107 \set fontSize = #3
108 c4.-> d8---3
109 \override NoteHead.font-size = #-4
110 c4.-> d8---3
111 \override Script.font-size = #2
112 c4.-> d8---3
113 \override Stem.font-size = #-5
114 c4.-> d8---3
115 @end lilypond
116
117 @cindex standard, taille des notes
118 @cindex notes, taille standard
119
120 @funindex font-interface
121 @funindex font-size
122
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
127 10 points.
128
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}.
132
133 @predefined
134 @code{\teeny},
135 @code{\tiny},
136 @code{\small},
137 @code{\normalsize},
138 @code{\large},
139 @code{\huge}.
140 @endpredefined
141
142 @seealso
143 Morceaux choisis :
144 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
145
146 Référence des propriétés internes :
147 @rinternals{font-interface}.
148
149
150 @node Doigtés
151 @unnumberedsubsubsec Doigtés
152 @translationof Fingering instructions
153
154 @cindex doigté
155 @cindex substitution de doigt
156
157 @funindex \finger
158 @funindex finger
159
160 Les doigtés peuvent être indiqués comme suit :
161 @var{note}-@var{chiffre_du_doigt}
162
163 @lilypond[verbatim,quote,relative=2]
164 c4-1 d-2 f-4 e-3
165 @end lilypond
166
167 Pour les substitutions de doigts, on a recours à une indication
168 textuelle (commande @code{\markup}) de doigté
169 (commande @code{\finger}).
170
171 @lilypond[verbatim,quote,relative=2]
172 c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
173 @end lilypond
174
175 @cindex pouce, doigté
176
177 @funindex \thumb
178 @funindex thumb
179
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).
183
184 @lilypond[verbatim,quote,relative=2]
185 <a_\thumb a'-3>2 <b_\thumb b'-3>
186 @end lilypond
187
188 @cindex doigtés des accords
189 @cindex accords, doigtés
190
191 Les doigtés des accords peuvent être saisis note par note,
192 en les indiquant après chaque hauteur de note.
193
194 @lilypond[verbatim,quote,relative=2]
195 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
196 @end lilypond
197
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.
200
201 @snippets
202
203 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
204 {controlling-the-placement-of-chord-fingerings.ly}
205
206 @lilypondfile[verbatim,quote,texidoc,doctitle]
207 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
208
209 @lilypondfile[verbatim,quote,texidoc,doctitle]
210 {avoiding-collisions-with-chord-fingerings.ly}
211
212 @seealso
213 Manuel de notation :
214 @ref{Direction et positionnement}.
215
216 Morceaux choisis :
217 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
218
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}.
225
226
227 @node Dictée à trous
228 @unnumberedsubsubsec Dictée à trous
229 @translationof Hidden notes
230
231 @cindex masquées, notes
232 @cindex invisibles, notes
233 @cindex transparentes, notes
234 @cindex note invisible
235 @cindex note masquée
236
237 @funindex \hideNotes
238 @funindex hideNotes
239 @funindex \unHideNotes
240 @funindex unHideNotes
241
242 Les notes masquées -- ou invisibles ou encore transparentes -- sont
243 utiles dans le cadre d'exercices de théorie ou de composition.
244
245 @lilypond[verbatim,quote,relative=2]
246 c4 d
247 \hideNotes
248 e4 f
249 \unHideNotes
250 g a
251 \hideNotes
252 b
253 \unHideNotes
254 c
255 @end lilypond
256
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
260 masqués pour autant.
261
262 @lilypond[verbatim,quote,relative=2]
263 e8(\p f g a)--
264 \hideNotes
265 e8(\p f g a)--
266 @end lilypond
267
268 @predefined
269 @code{\hideNotes},
270 @code{\unHideNotes}.
271 @endpredefined
272
273 @seealso
274 Manuel d'initiation :
275 @rlearning{Visibilité et couleur des objets}.
276
277 Manuel de notation :
278 @ref{Silences invisibles},
279 @ref{Visibilité des objets},
280 @ref{Masquage de portées}.
281
282 Morceaux choisis :
283 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
284
285 Référence des propriétés internes :
286 @rinternals{Note_spacing_engraver},
287 @rinternals{NoteSpacing}.
288
289
290 @node Coloration d'objets
291 @unnumberedsubsubsec Coloration d'objets
292 @translationof Coloring objects
293
294 @cindex objets en couleur
295 @cindex couleurs
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
302 @cindex couleurs x11
303
304 @funindex color
305 @funindex \with-color
306 @funindex with-color
307 @funindex x11-color
308
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}.
312
313 @lilypond[verbatim,quote,relative=2]
314 \override NoteHead.color = #red
315 c4 c
316 \override NoteHead.color = #(x11-color 'LimeGreen)
317 d
318 \override Stem.color = #blue
319 e
320 @end lilypond
321
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.
329
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.
333
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"
338 }
339
340 gis8 a
341 \override Beam.color = #(x11-color "medium turquoise")
342 gis a
343 \override Accidental.color = #(x11-color 'DarkRed)
344 gis a
345 \override NoteHead.color = #(x11-color "LimeGreen")
346 gis a
347 % this is deliberate nonsense; note that the stems remain black
348 \override Stem.color = #(x11-color 'Boggle)
349 b2 cis
350 @end lilypond
351
352 @cindex rgb-color
353 @cindex couleur rgb
354 @cindex couleur rvb
355 @cindex rgb, couleur
356 @cindex rvb, couleur
357
358 @funindex rgb-color
359
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).
364
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"
369 }
370
371 \override Stem.color = #(rgb-color 0 0 0)
372 gis8 a
373 \override Stem.color = #(rgb-color 1 1 1)
374 gis8 a
375 \override Stem.color = #(rgb-color 0 0 0.5)
376 gis4 a
377 @end lilypond
378
379 @seealso
380 Manuel de notation :
381 @ref{Liste des couleurs},
382 @ref{La commande d'affinage (tweak)}.
383
384 Morceaux choisis :
385 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
386
387 @cindex x11, couleur
388 @cindex couleur, notes d'un accord
389 @cindex notes colorisées dans un accord
390 @cindex accords et couleur
391
392 @funindex x11-color
393
394 @knownissues
395 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
396 normale ayant un nom similaire.
397
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.
402
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)}.
406
407
408 @node Parenthèses
409 @unnumberedsubsubsec Parenthèses
410 @translationof Parentheses
411
412 @cindex fantômes, notes
413 @cindex notes fantômes
414 @cindex parenthèses, notes entre
415 @cindex crochets, notes entre
416
417 @funindex \parenthesize
418 @funindex parenthesize
419
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.
425
426 @lilypond[verbatim,quote,relative=2]
427 c2 \parenthesize d
428 c2 \parenthesize <c e g>
429 c2 <c \parenthesize e g>
430 @end lilypond
431
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.
435
436 @lilypond[verbatim,quote,relative=2]
437 c2-\parenthesize -. d
438 c2 \parenthesize r
439 @end lilypond
440
441 @seealso
442 Morceaux choisis :
443 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
444
445 Référence des propriétés internes :
446 @rinternals{Parenthesis_engraver},
447 @rinternals{ParenthesesItem},
448 @rinternals{parentheses-interface}.
449
450 @knownissues
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.
454
455
456 @node Hampes
457 @unnumberedsubsubsec Hampes
458 @translationof Stems
459
460 @cindex 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
467 @cindex hampe neutre
468
469 @funindex \stemUp
470 @funindex stemUp
471 @funindex \stemDown
472 @funindex stemDown
473 @funindex \stemNeutral
474 @funindex stemNeutral
475
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.
479
480 L'orientation des hampes peut être définie manuellement -- voir
481 @ref{Direction et positionnement} à ce sujet.
482
483 @predefined
484 @code{\stemUp},
485 @code{\stemDown},
486 @code{\stemNeutral}.
487 @endpredefined
488
489 @snippets
490
491 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
492 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
493
494 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
495 {automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
496
497 @seealso
498 Manuel de notation :
499 @ref{Direction et positionnement}.
500
501 Morceaux choisis :
502 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
503
504 Référence des propriétés internes :
505 @rinternals{Stem_engraver},
506 @rinternals{Stem},
507 @rinternals{stem-interface}.
508
509
510 @node Hors de la portée
511 @subsection Hors de la portée
512 @translationof Outside the staff
513
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.
516
517 @menu
518 * Info-bulle::
519 * Quadrillage temporel::
520 * Crochets d'analyse::
521 @end menu
522
523
524 @node Info-bulle
525 @unnumberedsubsubsec Info-bulle
526 @translationof Balloon help
527
528 @cindex bulle
529 @cindex notation, explication
530 @cindex info-bulle
531
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
541
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
544 notation.
545
546 En voici un exemple :
547 @c KEEP LY
548 @lilypond[verbatim,quote,relative=2]
549 \new Voice \with { \consists "Balloon_engraver" }
550 {
551   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
552   a8
553   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
554   r
555   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
556 }
557 @end lilypond
558
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.
566
567 Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
568 peut toutefois le gérer ainsi :
569
570 @c KEEP LY
571 @lilypond[verbatim,quote,relative=2]
572 \new Voice \with { \consists "Balloon_engraver" }
573 {
574   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
575   a8
576   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
577   r
578   \balloonLengthOn
579   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
580 }
581 @end lilypond
582
583 @predefined
584 @code{\balloonLengthOn},
585 @code{\balloonLengthOff}.
586 @endpredefined
587
588 @seealso
589 Morceaux choisis :
590 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
591
592 Référence des propriétés internes :
593 @rinternals{Balloon_engraver},
594 @rinternals{BalloonTextItem},
595 @rinternals{balloon-interface}.
596
597
598 @node Quadrillage temporel
599 @unnumberedsubsubsec Quadrillage temporel
600 @translationof Grid lines
601
602 @cindex quadrillage temporel
603 @cindex temporel, quadrillage
604
605 @funindex Grid_point_engraver
606 @funindex Grid_line_span_engraver
607 @funindex gridInterval
608
609 Vous pouvez tracer des lignes entre les portées, synchronisées avec
610 les notes.
611
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.
619
620 @c KEEP LY
621 @lilypond[verbatim,quote]
622 \layout {
623   \context {
624     \Staff
625     \consists "Grid_point_engraver" %% active les guides
626     gridInterval = #(ly:make-moment 1/4)
627   }
628   \context {
629     \Score
630     \consists "Grid_line_span_engraver"
631      %% centre les lignes guides horizontalement sous les notes
632   }
633 }
634
635 \score {
636   \new ChoirStaff <<
637     \new Staff \relative c'' {
638       \stemUp
639       c'4. d8 e8 f g4
640     }
641     \new Staff \relative c {
642     %% centre les lignes guides verticalement
643       \clef bass
644       \stemDown
645       c4  g'  f  e
646     }
647   >>
648 }
649 @end lilypond
650
651 @snippets
652
653 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
654 {grid-lines--changing-their-appearance.ly}
655
656 @seealso
657 Morceaux choisis :
658 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
659
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}.
667
668
669 @node Crochets d'analyse
670 @unnumberedsubsubsec Crochets d'analyse
671 @translationof Analysis brackets
672
673 @cindex crochets
674 @cindex crochets de phrasé
675 @cindex analyse musicologique
676 @cindex crochet de regroupement de notes
677
678 @funindex Horizontal_bracket_engraver
679 @funindex \startGroup
680 @funindex startGroup
681 @funindex \stopGroup
682 @funindex stopGroup
683
684 On utilise des crochets en analyse musicale, pour indiquer la
685 structure d'une pièce.
686
687 @lilypond[verbatim,quote]
688 \layout {
689   \context {
690     \Voice
691     \consists "Horizontal_bracket_engraver"
692   }
693 }
694 \relative c'' {
695   c2\startGroup
696   d\stopGroup
697 }
698 @end lilypond
699
700 Les crochets d'analyses sont susceptibles d'être imbriqués :
701
702 @lilypond[verbatim,quote]
703 \layout {
704   \context {
705     \Voice
706     \consists "Horizontal_bracket_engraver"
707   }
708 }
709 \relative c'' {
710   c4\startGroup\startGroup
711   d4\stopGroup
712   e4\startGroup
713   d4\stopGroup\stopGroup
714 }
715 @end lilypond
716
717 @seealso
718 Morceaux choisis :
719 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
720
721 Référence des propriétés internes :
722 @rinternals{Horizontal_bracket_engraver},
723 @rinternals{HorizontalBracket},
724 @rinternals{horizontal-bracket-interface},
725 @rinternals{Staff}.