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