]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/editorial.itely
Doc-fr: updates editorial and changing-default
[lilypond.git] / Documentation / fr / notation / editorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @ignore
3     Translation of GIT committish: 65264f1ec906b40c1b281e360d4860f7a6eb8138
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
46 @node Indication de la taille de fonte musicale
47 @unnumberedsubsubsec Indication de la taille de fonte musicale
48 @translationof Selecting notation font size
49
50 @cindex sélection de la taille (notation)
51 @cindex notes, taille
52 @cindex taille des notes
53 @cindex têtes de note
54
55 @funindex fontSize
56 @funindex font-size
57 @funindex magstep
58 @funindex \huge
59 @funindex \large
60 @funindex \normalsize
61 @funindex \small
62 @funindex \tiny
63 @funindex \teeny
64 @funindex huge
65 @funindex large
66 @funindex normalsize
67 @funindex small
68 @funindex tiny
69 @funindex teeny
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 @predefined
133 @code{\teeny},
134 @code{\tiny},
135 @code{\small},
136 @code{\normalsize},
137 @code{\large},
138 @code{\huge}.
139 @endpredefined
140
141 @seealso
142 Morceaux choisis :
143 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
144
145 Référence des propriétés internes :
146 @rinternals{font-interface}.
147
148
149 @node Doigtés
150 @unnumberedsubsubsec Doigtés
151 @translationof Fingering instructions
152
153 @cindex doigté
154 @cindex substitution de doigt
155
156 @funindex \finger
157 @funindex finger
158
159 Les doigtés peuvent être indiqués comme suit@tie{}:
160 @var{note}-@var{chiffre_du_doigt}
161
162 @lilypond[verbatim,quote,relative=2]
163 c4-1 d-2 f-4 e-3
164 @end lilypond
165
166 Pour les substitutions de doigts, on a recours à une indication
167 textuelle (commande @code{\markup}) de doigté
168 (commande @code{\finger}).
169
170 @lilypond[verbatim,quote,relative=2]
171 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
172 @end lilypond
173
174 @cindex pouce, doigté
175
176 @funindex \thumb
177 @funindex thumb
178
179 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
180 dans une partition de violoncelle, si une note doit être jouée avec le
181 pouce (@emph{thumb} en anglais).
182
183 @lilypond[verbatim,quote,relative=2]
184 <a_\thumb a'-3>2 <b_\thumb b'-3>
185 @end lilypond
186
187 @cindex doigtés des accords
188 @cindex accords, doigtés
189
190 Les doigtés des accords peuvent être saisis note par note,
191 en les indiquant après chaque hauteur de note.
192
193 @lilypond[verbatim,quote,relative=2]
194 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
195 @end lilypond
196
197 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
198 la portée -- voir @ref{Direction et positionnement} à ce sujet.
199
200 @snippets
201
202 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
203 {controlling-the-placement-of-chord-fingerings.ly}
204
205 @lilypondfile[verbatim,quote,texidoc,doctitle]
206 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
207
208 @lilypondfile[verbatim,quote,texidoc,doctitle]
209 {avoiding-collisions-with-chord-fingerings.ly}
210
211 @seealso
212 Manuel de notation :
213 @ref{Direction et positionnement}.
214
215 Morceaux choisis :
216 @rlsrnamed{Editorial annotations, Annotations éditoriales}.
217
218 Référence des propriétés internes :
219 @rinternals{FingeringEvent},
220 @rinternals{fingering-event},
221 @rinternals{Fingering_engraver},
222 @rinternals{New_fingering_engraver},
223 @rinternals{Fingering}.
224
225 @knownissues
226 La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
227 défaut, les chiffres supérieurs à 9.
228
229
230 @node Dictée à trous
231 @unnumberedsubsubsec Dictée à trous
232 @translationof Hidden notes
233
234 @cindex masquées, notes
235 @cindex invisibles, notes
236 @cindex transparentes, notes
237 @cindex note invisible
238 @cindex note masquée
239
240 @funindex \hideNotes
241 @funindex hideNotes
242 @funindex \unHideNotes
243 @funindex unHideNotes
244
245 Les notes masquées -- ou invisibles ou encore transparentes -- sont
246 utiles dans le cadre d'exercices de théorie ou de composition.
247
248 @lilypond[verbatim,quote,relative=2]
249 c4 d
250 \hideNotes
251 e4 f
252 \unHideNotes
253 g a
254 \hideNotes
255 b
256 \unHideNotes
257 c
258 @end lilypond
259
260 Têtes de note, hampes, crochets et silences sont invisibles.  Une
261 ligature sera invisible si elle démarre sur une note invisible.
262 Les objets de notation attachés à une note invisible ne seront pas
263 masqués pour autant.
264
265 @lilypond[verbatim,quote,relative=2]
266 e8(\p f g a)--
267 \hideNotes
268 e8(\p f g a)--
269 @end lilypond
270
271 @predefined
272 @code{\hideNotes},
273 @code{\unHideNotes}.
274 @endpredefined
275
276 @seealso
277 Manuel d'initiation :
278 @rlearning{Visibilité et couleur des objets}.
279
280 Manuel de notation :
281 @ref{Silences invisibles},
282 @ref{Visibilité des objets},
283 @ref{Masquage de portées}.
284
285 Morceaux choisis :
286 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
287
288 Référence des propriétés internes :
289 @rinternals{Note_spacing_engraver},
290 @rinternals{NoteSpacing}.
291
292
293 @node Coloration d'objets
294 @unnumberedsubsubsec Coloration d'objets
295 @translationof Coloring objects
296
297 @cindex objets en couleur
298 @cindex couleurs
299 @cindex colorisation d'objets
300 @cindex coloration d'objets
301 @cindex coloration de notes
302 @cindex colorisation de notes
303 @cindex notes en couleur
304 @cindex x11, couleurs
305 @cindex couleurs x11
306
307 @funindex color
308 @funindex \with-color
309 @funindex with-color
310 @funindex x11-color
311
312 Des objets peuvent être colorisés individuellement.  Une listes des
313 noms des couleurs disponibles se trouvent à l'annexe
314 @ref{Liste des couleurs}.
315
316 @lilypond[verbatim,quote,relative=2]
317 \override NoteHead #'color = #red
318 c4 c
319 \override NoteHead #'color = #(x11-color 'LimeGreen)
320 d
321 \override Stem #'color = #blue
322 e
323 @end lilypond
324
325 L'intégralité de la palette des couleurs définies pour X11 est
326 accessible par la fonction Scheme @code{x11-color}.  Cette fonction
327 prend en argument une expression symbolique de la forme
328 @code{@var{'TaraTata}} ou bien une chaîne de caractères comme
329 @code{@var{"TaraTata"}}.  La première formulation est à la fois plus
330 rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
331 permet d'accéder aux noms composés des couleurs de X11.
332
333 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
334 elle revient à la couleur par défaut, le noir.  Le problème ressort de
335 façon évidente au vu de la partition finale.
336
337 @lilypond[verbatim,quote,relative=2]
338 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
339 \set Staff.instrumentName = \markup {
340   \with-color #(x11-color 'navy) "Clarinet"
341 }
342
343 gis8 a
344 \override Beam #'color = #(x11-color "medium turquoise")
345 gis a
346 \override Accidental #'color = #(x11-color 'DarkRed)
347 gis a
348 \override NoteHead #'color = #(x11-color "LimeGreen")
349 gis a
350 % this is deliberate nonsense; note that the stems remain black
351 \override Stem #'color = #(x11-color 'Boggle)
352 b2 cis
353 @end lilypond
354
355 @cindex rgb-color
356 @cindex couleur rgb
357 @cindex couleur rvb
358 @cindex rgb, couleur
359 @cindex rvb, couleur
360
361 @funindex rgb-color
362
363 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
364 les composantes de la couleur exacte au format rouge-vert-bleu
365 (@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
366 l'exemple suivant correspond à 128).
367
368 @lilypond[verbatim,quote,relative=2]
369 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
370 \set Staff.instrumentName = \markup {
371   \with-color #(x11-color 'navy) "Clarinet"
372 }
373
374 \override Stem #'color = #(rgb-color 0 0 0)
375 gis8 a
376 \override Stem #'color = #(rgb-color 1 1 1)
377 gis8 a
378 \override Stem #'color = #(rgb-color 0 0 0.5)
379 gis4 a
380 @end lilypond
381
382 @seealso
383 Manuel de notation :
384 @ref{Liste des couleurs},
385 @ref{La commande d'affinage (tweak)}.
386
387 Morceaux choisis :
388 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
389
390 @cindex x11, couleur
391 @cindex couleur, notes d'un accord
392 @cindex notes colorisées dans un accord
393 @cindex accords et couleur
394
395 @funindex x11-color
396
397 @knownissues
398 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
399 normale ayant un nom similaire.
400
401 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
402 internet.  Aussi nous vous recommandons, dans le cadre d'une
403 présentation multimédia, d'utiliser des couleurs de base @code{blue},
404 @code{green}, @code{red} -- bleu, vert, rouge.
405
406 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
407 @code{\override}.  Si besoin est, utilisez @code{\tweak}.  Pour plus de
408 détails, consultez @ref{La commande d'affinage (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 @seealso
444 Morceaux choisis :
445 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
446
447 Référence des propriétés internes :
448 @rinternals{Parenthesis_engraver},
449 @rinternals{ParenthesesItem},
450 @rinternals{parentheses-interface}.
451
452 @knownissues
453 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
454 individuellement à chacune des notes le composant, alors qu'on
455 attendrait une seule paire de parenthèses encadrant tout l'accord.
456
457
458 @node Hampes
459 @unnumberedsubsubsec Hampes
460 @translationof Stems
461
462 @cindex hampes
463 @cindex hampes invisibles
464 @cindex visibilité des hampes
465 @cindex masquage des hampes
466 @cindex hampe, orientation
467 @cindex hampe montante
468 @cindex hampe descendante
469 @cindex hampe neutre
470
471 @funindex \stemUp
472 @funindex stemUp
473 @funindex \stemDown
474 @funindex stemDown
475 @funindex \stemNeutral
476 @funindex stemNeutral
477
478 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
479 automatiquement.  Pour les rondes et les silences, ils sont aussi
480 créés, mais en mode invisible.
481
482 L'orientation des hampes peut être définie manuellement -- voir
483 @ref{Direction et positionnement} à ce sujet.
484
485 @predefined
486 @code{\stemUp},
487 @code{\stemDown},
488 @code{\stemNeutral}.
489 @endpredefined
490
491 @snippets
492
493 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
494 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
495
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@tie{}\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 ont une influence sur les espacements, que l'on peut
568 gérer ainsi@tie{}:
569
570 @c KEEP LY
571 @lilypond[verbatim,quote,relative=2]
572 \new Voice \with { \consists "Balloon_engraver" }
573 {
574   \balloonLengthOff
575   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
576   a8
577   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
578   r
579   \balloonLengthOn
580   <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
581 }
582 @end lilypond
583
584 @predefined
585 @code{\balloonLengthOn},
586 @code{\balloonLengthOff}.
587 @endpredefined
588
589 @seealso
590 Morceaux choisis :
591 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
592
593 Référence des propriétés internes :
594 @rinternals{Balloon_engraver},
595 @rinternals{BalloonTextItem},
596 @rinternals{balloon-interface}.
597
598
599 @node Quadrillage temporel
600 @unnumberedsubsubsec Quadrillage temporel
601 @translationof Grid lines
602
603 @cindex quadrillage temporel
604 @cindex temporel, quadrillage
605
606 @funindex Grid_point_engraver
607 @funindex Grid_line_span_engraver
608 @funindex gridInterval
609
610 Vous pouvez tracer des lignes entre les portées, synchronisées avec
611 les notes.
612
613 LilyPond a recours à deux graveurs distincts afin d'afficher le
614 quadrillage@tie{}:  le @code{Grid_point_engraver} se charge de
615 déterminer l'envergure du crochet, alors que le
616 @code{Grid_line_span_engraver} se consacrera au tracé des lignes.
617 Les lignes sont par défaut centrées horizontalement sous les notes et
618 alignées sur la gauche des têtes.  La propriété @code{gridInterval}
619 spécifie quant à elle l'espace de temps entre chaque ligne.
620
621 @c KEEP LY
622 @lilypond[verbatim,quote]
623 \layout {
624   \context {
625     \Staff
626     \consists "Grid_point_engraver" %% active les guides
627     gridInterval = #(ly:make-moment 1 4)
628   }
629   \context {
630     \Score
631     \consists "Grid_line_span_engraver"
632      %% centre les lignes guides horizontalement sous les notes
633   }
634 }
635
636 \score {
637   \new ChoirStaff <<
638     \new Staff \relative c'' {
639       \stemUp
640       c'4. d8 e8 f g4
641     }
642     \new Staff \relative c {
643     %% centre les lignes guides verticalement
644       \clef bass
645       \stemDown
646       c4  g'  f  e
647     }
648   >>
649 }
650 @end lilypond
651
652 @snippets
653
654 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
655 {grid-lines--changing-their-appearance.ly}
656
657 @seealso
658 Morceaux choisis :
659 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
660
661 Référence des propriétés internes :
662 @rinternals{Grid_line_span_engraver},
663 @rinternals{Grid_point_engraver},
664 @rinternals{GridLine},
665 @rinternals{GridPoint},
666 @rinternals{grid-line-interface},
667 @rinternals{grid-point-interface}.
668
669
670 @node Crochets d'analyse
671 @unnumberedsubsubsec Crochets d'analyse
672 @translationof Analysis brackets
673
674 @cindex crochets
675 @cindex crochets de phrasé
676 @cindex analyse musicologique
677 @cindex crochet de regroupement de notes
678
679 @funindex Horizontal_bracket_engraver
680 @funindex \startGroup
681 @funindex startGroup
682 @funindex \stopGroup
683 @funindex stopGroup
684
685 On utilise des crochets en analyse musicale, pour indiquer la
686 structure d'une pièce.
687
688 @lilypond[verbatim,quote]
689 \layout {
690   \context {
691     \Voice
692     \consists "Horizontal_bracket_engraver"
693   }
694 }
695 \relative c'' {
696   c2\startGroup
697   d\stopGroup
698 }
699 @end lilypond
700
701 Les crochets d'analyses sont susceptibles d'être imbriqués@tie{}:
702
703 @lilypond[verbatim,quote]
704 \layout {
705   \context {
706     \Voice
707     \consists "Horizontal_bracket_engraver"
708   }
709 }
710 \relative c'' {
711   c4\startGroup\startGroup
712   d4\stopGroup
713   e4\startGroup
714   d4\stopGroup\stopGroup
715 }
716 @end lilypond
717
718 @seealso
719 Morceaux choisis :
720 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
721
722 Référence des propriétés internes :
723 @rinternals{Horizontal_bracket_engraver},
724 @rinternals{HorizontalBracket},
725 @rinternals{horizontal-bracket-interface},
726 @rinternals{Staff}.
727