]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/editorial.itely
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / fr / notation / editorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @ignore
3     Translation of GIT committish: a6b5eea83ddcdd8e1fd0760db385176ff9b2b1cd
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.14.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,quote,ragged-right,texidoc,doctitle]
205 {controlling-the-placement-of-chord-fingerings.ly}
206
207 @lilypondfile[verbatim,quote,texidoc,doctitle]
208 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
209
210 @lilypondfile[verbatim,quote,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 @knownissues
229 La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
230 défaut, les chiffres supérieurs à 9.
231
232
233 @node Dictée à trous
234 @unnumberedsubsubsec Dictée à trous
235 @translationof Hidden notes
236
237 @cindex masquées, notes
238 @cindex invisibles, notes
239 @cindex transparentes, notes
240 @cindex note invisible
241 @cindex note masquée
242
243 @funindex \hideNotes
244 @funindex hideNotes
245 @funindex \unHideNotes
246 @funindex unHideNotes
247
248 Les notes masquées -- ou invisibles ou encore transparentes -- sont
249 utiles dans le cadre d'exercices de théorie ou de composition.
250
251 @lilypond[verbatim,quote,relative=2]
252 c4 d
253 \hideNotes
254 e4 f
255 \unHideNotes
256 g a
257 \hideNotes
258 b
259 \unHideNotes
260 c
261 @end lilypond
262
263 Les objets de notation attachés à une note invisible ne seront pas
264 masqués pour autant.
265
266 @lilypond[verbatim,quote,relative=2]
267 c4( d)
268 \hideNotes
269 e4(\p f)--
270 @end lilypond
271
272
273 @predefined
274 @code{\hideNotes},
275 @code{\unHideNotes}.
276 @endpredefined
277
278
279 @seealso
280 Manuel d'initiation :
281 @rlearning{Visibilité et couleur des objets}.
282
283 Manuel de notation :
284 @ref{Silences invisibles},
285 @ref{Visibilité des objets},
286 @ref{Masquage de portées}.
287
288 Morceaux choisis :
289 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
290
291 Référence des propriétés internes :
292 @rinternals{Note_spacing_engraver},
293 @rinternals{NoteSpacing}.
294
295
296 @node Coloration d'objets
297 @unnumberedsubsubsec Coloration d'objets
298 @translationof Coloring objects
299
300 @cindex objets en couleur
301 @cindex couleurs
302 @cindex colorisation d'objets
303 @cindex coloration d'objets
304 @cindex coloration de notes
305 @cindex colorisation de notes
306 @cindex notes en couleur
307 @cindex x11, couleurs
308 @cindex couleurs x11
309
310 @funindex color
311 @funindex \with-color
312 @funindex with-color
313 @funindex x11-color
314
315 Des objets peuvent être colorisés individuellement.  Une listes des
316 noms des couleurs disponibles se trouvent à l'annexe
317 @ref{Liste des couleurs}.
318
319 @lilypond[verbatim,quote,relative=2]
320 \override NoteHead #'color = #red
321 c4 c
322 \override NoteHead #'color = #(x11-color 'LimeGreen)
323 d
324 \override Stem #'color = #blue
325 e
326 @end lilypond
327
328 L'intégralité de la palette des couleurs définies pour X11 est
329 accessible par la fonction Scheme @code{x11-color}.  Cette fonction
330 prend en argument une expression symbolique de la forme
331 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
332 @code{@var{"TaraTata"}}.  La première formulation est à la fois plus
333 rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
334 permet d'accéder aux noms composés des couleurs de X11.
335
336 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
337 elle revient à la couleur par défaut, le noir.  Le problème ressort de
338 façon évidente au vu de la partition finale.
339
340 @lilypond[verbatim,quote,relative=2]
341 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
342 \set Staff.instrumentName = \markup {
343   \with-color #(x11-color 'navy) "Clarinet"
344 }
345
346 gis8 a
347 \override Beam #'color = #(x11-color "medium turquoise")
348 gis a
349 \override Accidental #'color = #(x11-color 'DarkRed)
350 gis a
351 \override NoteHead #'color = #(x11-color "LimeGreen")
352 gis a
353 % this is deliberate nonsense; note that the stems remain black
354 \override Stem #'color = #(x11-color 'Boggle)
355 b2 cis
356 @end lilypond
357
358 @cindex rgb-color
359 @cindex couleur rgb
360 @cindex couleur rvb
361 @cindex rgb, couleur
362 @cindex rvb, couleur
363
364 @funindex rgb-color
365
366 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
367 les composantes de la couleur exacte au format rouge-vert-bleu
368 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
369 l'exemple suivant correspond à 128).
370
371 @lilypond[verbatim,quote,relative=2]
372 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
373 \set Staff.instrumentName = \markup {
374   \with-color #(x11-color 'navy) "Clarinet"
375 }
376
377 \override Stem #'color = #(rgb-color 0 0 0)
378 gis8 a
379 \override Stem #'color = #(rgb-color 1 1 1)
380 gis8 a
381 \override Stem #'color = #(rgb-color 0 0 0.5)
382 gis4 a
383 @end lilypond
384
385
386 @seealso
387 Manuel de notation :
388 @ref{Liste des couleurs},
389 @ref{La commande d'affinage (tweak)}.
390
391 Morceaux choisis :
392 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
393
394
395 @cindex x11, couleur
396 @cindex couleur, notes d'un accord
397 @cindex notes colorisées dans un accord
398 @cindex accords et couleur
399
400 @funindex x11-color
401
402 @knownissues
403 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
404 normale ayant un nom similaire.
405
406 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
407 internet.  Aussi nous vous recommandons, dans le cadre d'une
408 présentation multimedia, d'utiliser des couleurs de base @code{blue},
409 @code{green}, @code{red} -- bleu, vert, rouge.
410
411
412 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
413 @code{\override}.  Si besoin est, utilisez @code{\tweak}.
414 Pour plus de détails, consultez
415 @ref{La commande d'affinage (tweak)}.
416
417
418 @node Parenthèses
419 @unnumberedsubsubsec Parenthèses
420 @translationof Parentheses
421
422 @cindex fantômes, notes
423 @cindex notes fantômes
424 @cindex parenthèses, notes entre
425
426 @funindex \parenthesize
427 @funindex parenthesize
428
429 Des objets peuvent être mis entre parenthèses en saisissant
430 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
431 préfixe un accord, chaque note le composant se présentera entre
432 parenthèses.  Vous pouvez aussi mettre individuellement entre
433 parenthèses les notes d'un accord.
434
435 @lilypond[verbatim,quote,relative=2]
436 c2 \parenthesize d
437 c2 \parenthesize <c e g>
438 c2 <c \parenthesize e g>
439 @end lilypond
440
441 Les objets autres que des notes peuvent aussi être entre parenthèses.
442 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
443 doit cependant être précédée d'un tiret.
444
445 @lilypond[verbatim,quote,relative=2]
446 c2-\parenthesize -. d
447 c2 \parenthesize r
448 @end lilypond
449
450
451 @seealso
452 Morceaux choisis :
453 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
454
455 Référence des propriétés internes :
456 @rinternals{Parenthesis_engraver},
457 @rinternals{ParenthesesItem},
458 @rinternals{parentheses-interface}.
459
460
461 @knownissues
462
463 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
464 individuellement à chacune des notes le composant, alors qu'on
465 attendrait une seule paire de parenthèses encadrant tout l'accord.
466
467
468 @node Hampes
469 @unnumberedsubsubsec Hampes
470 @translationof Stems
471
472 @cindex hampes
473 @cindex hampes invisibles
474 @cindex visibilité des hampes
475 @cindex masquage des hampes
476
477 @funindex \stemUp
478 @funindex stemUp
479 @funindex \stemDown
480 @funindex stemDown
481 @funindex \stemNeutral
482 @funindex stemNeutral
483 @cindex stem, direction
484 @cindex stem, up
485 @cindex stem, down
486 @cindex stem, neutral
487
488 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
489 automatiquement.  Pour les rondes et les silences, ils sont aussi
490 créés, mais en mode invisible.
491
492 L'orientation des hampes peut être définie manuellement -- voir
493 @ref{Direction et positionnement} à ce sujet.
494
495
496 @predefined
497 @code{\stemUp},
498 @code{\stemDown},
499 @code{\stemNeutral}.
500 @endpredefined
501
502
503 @snippets
504
505 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
506 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
507
508
509 @seealso
510 Manuel de notation :
511 @ref{Direction et positionnement}.
512
513 Morceaux choisis :
514 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
515
516 Référence des propriétés internes :
517 @rinternals{Stem_engraver},
518 @rinternals{Stem},
519 @rinternals{stem-interface}.
520
521
522 @node Hors de la portée
523 @subsection Hors de la portée
524 @translationof Outside the staff
525
526 Nous allons nous intéresser ici à souligner des éléments inscrits dans
527 la portée par des éléments qui lui seront externes.
528
529 @menu
530 * Info-bulle::
531 * Quadrillage temporel::
532 * Crochets d'analyse::
533 @end menu
534
535 @node Info-bulle
536 @unnumberedsubsubsec Info-bulle
537 @translationof Balloon help
538
539 @cindex bulle
540 @cindex notation, explication
541 @cindex info-bulle
542
543 @funindex \balloonGrobText
544 @funindex \balloonText
545 @funindex Balloon_engraver
546 @funindex balloonGrobText
547 @funindex balloonText
548 @funindex \balloonLengthOn
549 @funindex balloonLengthOn
550 @funindex \balloonLengthOff
551 @funindex balloonLengthOff
552
553 Vous pouvez marquer et nommer des éléments de notation à l'aide de
554 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
555 notation.
556
557 En voici un exemple :
558 @c KEEP LY
559 @lilypond[verbatim,quote,relative=2]
560 \new Voice \with { \consists "Balloon_engraver" }
561 {
562   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
563   a8
564   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
565   r
566   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
567 }
568 @end lilypond
569
570 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
571 @code{balloonText}.  @code{balloonGrobText} prend en argument
572 l'objet graphique à agrémenter et s'utilise comme
573 @code{\once@tie{}\override}.  @code{balloonText}, quant à lui, s'utilise
574 comme une simple articulation et fonctionne comme @code{\tweak} pour
575 attacher du texte à l'une des notes d'un accord.  Les autres arguments
576 sont le décalage et le texte de la bulle.
577
578 Les info-bulles ont une influence sur les espacements, que l'on peut
579 gérer ainsi@tie{}:
580
581 @c KEEP LY
582 @lilypond[verbatim,quote,relative=2]
583 \new Voice \with { \consists "Balloon_engraver" }
584 {
585   \balloonLengthOff
586   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
587   a8
588   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
589   r
590   \balloonLengthOn
591   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
592 }
593 @end lilypond
594
595
596 @predefined
597 @code{\balloonLengthOn},
598 @code{\balloonLengthOff}.
599 @endpredefined
600
601
602 @seealso
603 Morceaux choisis :
604 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
605
606 Référence des propriétés internes :
607 @rinternals{Balloon_engraver},
608 @rinternals{BalloonTextItem},
609 @rinternals{balloon-interface}.
610
611
612 @node Quadrillage temporel
613 @unnumberedsubsubsec Quadrillage temporel
614 @translationof Grid lines
615
616 @cindex quadrillage temporel
617 @cindex temporel, quadrillage
618
619 @funindex Grid_point_engraver
620 @funindex Grid_line_span_engraver
621 @funindex gridInterval
622
623 Vous pouvez tracer des lignes entre les portées, synchronisées avec
624 les notes.
625
626 LilyPond a recours à deux graveurs distincts afin d'afficher le
627 quadrillage@tie{}:  le @code{Grid_point_engraver} se charge de
628 déterminer l'envergure du crochet, alors que le
629 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
630 Les lignes sont par défaut centrées horizontalement sous les notes et
631 alignées sur la gauche des têtes.  La propriété @code{gridInterval}
632 spécifie quant à elle l'espace de temps entre chaque ligne.
633
634 @c KEEP LY
635 @lilypond[verbatim,quote]
636 \layout {
637   \context {
638     \Staff
639     \consists "Grid_point_engraver" %% active les guides
640     gridInterval = #(ly:make-moment 1 4)
641   }
642   \context {
643     \Score
644     \consists "Grid_line_span_engraver"
645      %% centre les lignes guides horizontalement sous les notes
646   }
647 }
648
649 \score {
650   \new ChoirStaff <<
651     \new Staff \relative c'' {
652       \stemUp
653       c'4. d8 e8 f g4
654     }
655     \new Staff \relative c {
656     %% centre les lignes guides verticalement
657       \clef bass
658       \stemDown
659       c4  g'  f  e
660     }
661   >>
662 }
663 @end lilypond
664
665 @snippets
666
667 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
668 {grid-lines--changing-their-appearance.ly}
669
670
671 @seealso
672 Morceaux choisis :
673 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
674
675 Référence des propriétés internes :
676 @rinternals{Grid_line_span_engraver},
677 @rinternals{Grid_point_engraver},
678 @rinternals{GridLine},
679 @rinternals{GridPoint},
680 @rinternals{grid-line-interface},
681 @rinternals{grid-point-interface}.
682
683
684 @node Crochets d'analyse
685 @unnumberedsubsubsec Crochets d'analyse
686 @translationof Analysis brackets
687
688 @cindex crochets
689 @cindex crochets de phrasé
690 @cindex analyse musicologique
691 @cindex crochet de regroupement de notes
692
693 @funindex Horizontal_bracket_engraver
694 @funindex \startGroup
695 @funindex startGroup
696 @funindex \stopGroup
697 @funindex stopGroup
698
699 On utilise des crochets en analyse musicale, pour indiquer la
700 structure d'une pièce.
701
702 @lilypond[verbatim,quote]
703 \layout {
704   \context {
705     \Voice
706     \consists "Horizontal_bracket_engraver"
707   }
708 }
709 \relative c'' {
710   c2\startGroup
711   d\stopGroup
712 }
713 @end lilypond
714
715 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
716
717 @lilypond[verbatim,quote]
718 \layout {
719   \context {
720     \Voice
721     \consists "Horizontal_bracket_engraver"
722   }
723 }
724 \relative c'' {
725   c4\startGroup\startGroup
726   d4\stopGroup
727   e4\startGroup
728   d4\stopGroup\stopGroup
729 }
730 @end lilypond
731
732
733 @seealso
734 Morceaux choisis :
735 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
736
737 Référence des propriétés internes :
738 @rinternals{Horizontal_bracket_engraver},
739 @rinternals{HorizontalBracket},
740 @rinternals{horizontal-bracket-interface},
741 @rinternals{Staff}.
742