]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/editorial.itely
Doc-fr: update editorial
[lilypond.git] / Documentation / fr / notation / editorial.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: 4c48ef850dd6cc09e2240c83e21710758a8a595a
4
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..
8 @end ignore
9
10 @c \version "2.12.0"
11
12 @c Translators: Jean-Charles Malahieude
13
14 @node Annotations éditoriales
15 @section Annotations éditoriales
16 @translationof Editorial annotations
17
18 @lilypondfile[quote]{editorial-headword.ly}
19
20 Ce chapitre traite de la manière de modifier l'apparence des notes dans
21 un but pédagogique ou d'analyse.
22
23 @menu
24 * Dans la portée::
25 * Hors de la portée::
26 @end menu
27
28
29 @node Dans la portée
30 @subsection Dans la portée
31 @translationof Inside the staff
32
33 Nous allons voir ici comment mettre en exergue certains éléments à
34 l'intérieur même de la portée.
35
36 @menu
37 * Indication de la taille de fonte musicale::
38 * Doigtés::
39 * Dictée à trous::
40 * Coloration d'objets::
41 * Parenthèses::
42 * Hampes::
43 @end menu
44
45 @node Indication de la taille de fonte musicale
46 @unnumberedsubsubsec Indication de la taille de fonte musicale
47 @translationof Selecting notation font size
48
49 @cindex selection de la taille (notation)
50 @cindex notes, taille
51 @cindex taille des notes
52 @cindex têtes de note
53
54 @funindex fontSize
55 @funindex font-size
56 @funindex magstep
57 @funindex \huge
58 @funindex \large
59 @funindex \normalsize
60 @funindex \small
61 @funindex \tiny
62 @funindex \teeny
63 @funindex huge
64 @funindex large
65 @funindex normalsize
66 @funindex small
67 @funindex tiny
68 @funindex teeny
69
70
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.
75
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}.}
78
79 @lilypond[verbatim,quote,relative=2]
80 \huge
81 c4.-> d8---3
82 \large
83 c4.-> d8---3
84 \normalsize
85 c4.-> d8---3
86 \small
87 c4.-> d8---3
88 \tiny
89 c4.-> d8---3
90 \teeny
91 c4.-> d8---3
92 @end lilypond
93
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.
104
105 @lilypond[verbatim,quote,relative=2]
106 \set fontSize = #3
107 c4.-> d8---3
108 \override NoteHead #'font-size = #-4
109 c4.-> d8---3
110 \override Script #'font-size = #2
111 c4.-> d8---3
112 \override Stem #'font-size = #-5
113 c4.-> d8---3
114 @end lilypond
115
116 @cindex standard, taille des notes
117 @cindex notes, taille standard
118
119 @funindex font-interface
120 @funindex font-size
121
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
126 10@tie{}points.
127
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}.
131
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
143 @seealso
144 Morceaux choisis :
145 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
146
147 Référence des propriétés internes :
148 @rinternals{font-interface}.
149
150
151 @node Doigtés
152 @unnumberedsubsubsec Doigtés
153 @translationof Fingering instructions
154
155 @cindex doigté
156 @cindex substitution de doigt
157
158 @funindex \finger
159 @funindex finger
160
161 Les doigtés peuvent être indiqués comme suit@tie{}:
162 @var{note}-@var{chiffre_du_doigt}
163
164 @lilypond[verbatim,quote,relative=2]
165 c4-1 d-2 f-4 e-3
166 @end lilypond
167
168 Pour les substitutions de doigts, on a recours à une indication
169 textuelle (commande @code{\markup}) de doigté
170 (commande @code{\finger}).
171
172 @lilypond[verbatim,quote,relative=2]
173 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
174 @end lilypond
175
176 @cindex pouce, doigté
177
178 @funindex \thumb
179 @funindex thumb
180
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).
184
185 @lilypond[verbatim,quote,relative=2]
186 <a_\thumb a'-3>2 <b_\thumb b'-3>
187 @end lilypond
188
189 @cindex doigtés des accords
190 @cindex accords, doigtés
191
192 Les doigtés des accords peuvent être saisis note par note,
193 en les indiquant après chaque hauteur de note.
194
195 @lilypond[verbatim,quote,relative=2]
196 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
197 @end lilypond
198
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.
201
202 @snippets
203
204 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
205 {controlling-the-placement-of-chord-fingerings.ly}
206
207 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
208 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
209
210 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
211 {avoiding-collisions-with-chord-fingerings.ly}
212
213
214 @seealso
215 Manuel de notation :
216 @ref{Direction et positionnement}
217
218 Morceaux choisis :
219 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
220
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}.
227
228
229 @node Dictée à trous
230 @unnumberedsubsubsec Dictée à trous
231 @translationof Hidden notes
232
233 @cindex masquées, notes
234 @cindex invisibles, notes
235 @cindex transparentes, notes
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 Les objets de notation attachés à une note invisible ne seront pas
258 masqués pour autant.
259
260 @lilypond[verbatim,quote,relative=2]
261 c4( d)
262 \hideNotes
263 e4(\p f)--
264 @end lilypond
265
266
267 @predefined
268 @code{\hideNotes},
269 @code{\unHideNotes}.
270 @endpredefined
271
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 @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
328 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}).
363
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"
368 }
369
370 \override Stem #'color = #(rgb-color 0 0 0)
371 gis8 a
372 \override Stem #'color = #(rgb-color 1 1 1)
373 gis8 a
374 \override Stem #'color = #(rgb-color 0 0 0.5)
375 gis4 a
376 @end lilypond
377
378
379 @seealso
380 Manuel de notation :
381 @ref{Liste des couleurs},
382 @ref{La commande d'affinage (@emph{tweak})}.
383
384 Morceaux choisis :
385 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
386
387
388 @cindex x11, couleur
389 @cindex couleur, notes d'un accord
390 @cindex notes colorisées dans un accord
391 @cindex accords et couleur
392
393 @funindex x11-color
394
395 @knownissues
396 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
397 normale ayant un nom similaire.
398
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.
403
404
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})}.
409
410
411 @node Parenthèses
412 @unnumberedsubsubsec Parenthèses
413 @translationof Parentheses
414
415 @cindex fantômes, notes
416 @cindex notes fantômes
417 @cindex parenthèses, notes entre
418
419 @funindex \parenthesize
420 @funindex parenthesize
421
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.
427
428 @lilypond[verbatim,quote,relative=2]
429 c2 \parenthesize d
430 c2 \parenthesize <c e g>
431 c2 <c \parenthesize e g>
432 @end lilypond
433
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.
437
438 @lilypond[verbatim,quote,relative=2]
439 c2-\parenthesize -. d
440 c2 \parenthesize r
441 @end lilypond
442
443
444 @seealso
445 Morceaux choisis :
446 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
447
448 Référence des propriétés internes :
449 @rinternals{Parenthesis_engraver},
450 @rinternals{ParenthesesItem},
451 @rinternals{parentheses-interface}.
452
453
454 @knownissues
455
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.
459
460
461 @node Hampes
462 @unnumberedsubsubsec Hampes
463 @translationof Stems
464
465 @cindex hampes
466 @cindex hampes invisibles
467 @cindex visibilité des hampes
468 @cindex masquage des hampes
469
470 @funindex \stemUp
471 @funindex stemUp
472 @funindex \stemDown
473 @funindex stemDown
474 @funindex \stemNeutral
475 @funindex stemNeutral
476 @cindex stem, direction
477 @cindex stem, up
478 @cindex stem, down
479 @cindex stem, neutral
480
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.
484
485 La direction des hampes peut être définie manuellement -- voir
486 @ref{Direction et positionnement} à ce sujet.
487
488
489 @predefined
490 @code{\stemUp},
491 @code{\stemDown},
492 @code{\stemNeutral}.
493 @endpredefined
494
495
496 @snippets
497
498 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
499 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
500
501
502 @seealso
503 Manuel de notation :
504 @ref{Direction et positionnement}.
505
506 Morceaux choisis :
507 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
508
509 Référence des propriétés internes :
510 @rinternals{Stem_engraver},
511 @rinternals{Stem},
512 @rinternals{stem-interface}.
513
514
515 @node Hors de la portée
516 @subsection Hors de la portée
517 @translationof Outside the staff
518
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.
521
522 @menu
523 * Info-bulle::
524 * Quadrillage temporel::
525 * Crochets d'analyse::
526 @end menu
527
528 @node Info-bulle
529 @unnumberedsubsubsec Info-bulle
530 @translationof Balloon help
531
532 @cindex bulle
533 @cindex notation, explication
534 @cindex info-bulle
535
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
545
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
548 notation.
549
550 En voici un exemple :
551 @c KEEP LY
552 @lilypond[verbatim,quote,relative=2]
553 \new Voice \with { \consists "Balloon_engraver" }
554 {
555   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
556   a8
557   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
558   r
559   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
560 }
561 @end lilypond
562
563
564 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
565 @code{balloonText}.  @code{balloonGrobText} prend en argument
566 l'objet graphique à agrémenter et s'utilise comme
567 @code{\once@tie{}\override}.  @code{balloonText}, quant à lui, s'utilise
568 comme une simple articulation et fonctionne comme @code{\tweak} pour
569 attacher du texte à l'une des notes d'un accord.  Les autres arguments
570 sont le décalage et le texte de la bulle.
571
572 Les info-bulles ont une influence sur les espacements, que l'on peut
573 gérer ainsi@tie{}:
574
575 @c KEEP LY
576 @lilypond[verbatim,quote,relative=2]
577 \new Voice \with { \consists "Balloon_engraver" }
578 {
579   \balloonLengthOff
580   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
581   a8
582   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
583   r
584   \balloonLengthOn
585   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
586 }
587 @end lilypond
588
589
590 @predefined
591 @code{\balloonLengthOn},
592 @code{\balloonLengthOff}.
593 @endpredefined
594
595
596 @seealso
597 Morceaux choisis :
598 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
599
600 Référence des propriétés internes :
601 @rinternals{Balloon_engraver},
602 @rinternals{BalloonTextItem},
603 @rinternals{balloon-interface}.
604
605
606 @node Quadrillage temporel
607 @unnumberedsubsubsec Quadrillage temporel
608 @translationof Grid lines
609
610 @cindex cadrillage temporel
611 @cindex temporel, cadrillage
612
613 @funindex Grid_point_engraver
614 @funindex Grid_line_span_engraver
615 @funindex gridInterval
616
617 Vous pouvez tracer des lignes entre les portées, synchronisées avec
618 les notes.
619
620 LilyPond a recours à deux graveurs distincts afin d'afficher le
621 cadrillage@tie{}:  le @code{Grid_point_engraver} se charge de
622 déterminer l'envergure du crochet, alors que le
623 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
624 Les lignes sont par défaut centrées horizontalement sous les notes et
625 alignées sur la gauche des têtes.  La propriété @code{gridInterval}
626 spécifie quant à elle l'espace de temps entre chaque ligne.
627
628 @c KEEP LY
629 @lilypond[verbatim,quote]
630 \layout {
631   \context {
632     \Staff
633     \consists "Grid_point_engraver" %% active les guides
634     gridInterval = #(ly:make-moment 1 4)
635   }
636   \context {
637     \Score
638     \consists "Grid_line_span_engraver"
639      %% centre les lignes guides horizontalement sous les notes
640   }
641 }
642
643 \score {
644   \new ChoirStaff <<
645     \new Staff \relative c'' {
646       \stemUp
647       c'4. d8 e8 f g4
648     }
649     \new Staff \relative c {
650     %% centre les lignes guides verticalement
651       \clef bass
652       \stemDown
653       c4  g'  f  e
654     }
655   >>
656 }
657 @end lilypond
658
659 @snippets
660
661 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
662 {grid-lines--changing-their-appearance.ly}
663
664
665 @seealso
666 Morceaux choisis :
667 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
668
669 Référence des propriétés internes :
670 @rinternals{Grid_line_span_engraver},
671 @rinternals{Grid_point_engraver},
672 @rinternals{GridLine},
673 @rinternals{GridPoint},
674 @rinternals{grid-line-interface},
675 @rinternals{grid-point-interface}.
676
677
678 @node Crochets d'analyse
679 @unnumberedsubsubsec Crochets d'analyse
680 @translationof Analysis brackets
681
682 @cindex crochets
683 @cindex crochets de phrasé
684 @cindex analyse musicologique
685 @cindex crochet de regroupement de notes
686
687 @funindex Horizontal_bracket_engraver
688 @funindex \startGroup
689 @funindex startGroup
690 @funindex \stopGroup
691 @funindex stopGroup
692
693 On utilise des crochets en analyse musicale, pour indiquer la
694 structure d'une pièce.
695
696 @lilypond[verbatim,quote]
697 \layout {
698   \context {
699     \Voice
700     \consists "Horizontal_bracket_engraver"
701   }
702 }
703 \relative c'' {
704   c2\startGroup
705   d\stopGroup
706 }
707 @end lilypond
708
709 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
710
711 @lilypond[verbatim,quote]
712 \layout {
713   \context {
714     \Voice
715     \consists "Horizontal_bracket_engraver"
716   }
717 }
718 \relative c'' {
719   c4\startGroup\startGroup
720   d4\stopGroup
721   e4\startGroup
722   d4\stopGroup\stopGroup
723 }
724 @end lilypond
725
726
727 @seealso
728 Morceaux choisis :
729 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
730
731 Référence des propriétés internes :
732 @rinternals{Horizontal_bracket_engraver},
733 @rinternals{HorizontalBracket},
734 @rinternals{horizontal-bracket-interface},
735 @rinternals{Staff}.
736