]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/user/rhythms.itely
Update translated docs skeletons and add translation authoring info
[lilypond.git] / Documentation / fr / user / rhythms.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
8
9 @c Translators: Frédéric Chiasson
10 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
11
12 @node Rhythms
13 @section Rhythms
14
15 This section discusses rhythms, durations, and bars.
16
17 @menu
18 * Writing rhythms::             
19 * Writing rests::               
20 * Displaying rhythms::          
21 * Beams::                       
22 * Bars::                        
23 * Special rhythmic concerns::   
24 @end menu
25
26
27 @node Writing rhythms
28 @subsection Writing rhythms
29
30 @menu
31 * Durations::                   
32 * Augmentation dots::           
33 * Tuplets::                     
34 * Scaling durations::           
35 @end menu
36
37 @node Durations
38 @unnumberedsubsubsec Durations
39
40 @cindex durées
41 @funindex \longa
42 @funindex \breve
43 @funindex \maxima
44
45 Dans les modes de notes, d'accords et de paroles, les durées sont
46 écrites avec des chiffres et des points : les durées sont indiquées par
47 leur valeur fractionnaire par rapport à la durée d'une ronde.  Une
48 noire, par exemple, qui équivaut à un 1/4 de ronde --- @qq{quarter note}
49 en anglais --- s'écrit @code{4}, alors qu'une blanche ---
50 @qq{half-note}, 1/2 ronde --- s'écrit @code{2}.  Pour des notes plus
51 longues qu'une ronde, vous devrez utiliser les commandes @code{\longa}
52 pour une longue, et @code{\breve} pour une brève, aussi appelée carrée.
53
54 @example
55 c'\breve
56 c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
57 r\longa r\breve
58 r1 r2 r4 r8 r16 r32 r64 r64
59 @end example
60
61 @lilypond[quote]
62 \score {
63 \relative c'' {
64     a\breve*1/2 \autoBeamOff
65     a1 a2 a4 a8 a16 a32 a64 a64
66    \bar "empty"
67    \break
68     r\longa*1/4 r\breve *1/2
69     r1 r2 r4 r8 r16 r32 r64 r64
70   }
71   \layout {
72     ragged-right = ##t
73     indent=0\mm
74     \context {
75       \Score
76         \remove "Bar_number_engraver"
77     }
78     \context {
79       \Staff
80         \remove "Clef_engraver"
81         \override StaffSymbol #'transparent = ##t
82         \override TimeSignature #'transparent = ##t
83         \override BarLine #'transparent = ##t
84         \consists "Pitch_squash_engraver"
85     }
86   }
87 }
88 @end lilypond
89
90 Si la durée n'est pas précisée, elle est alors assimilée à la durée
91 précédente.  La valeur par défaut pour la première note est une noire
92 (4).
93
94 @lilypond[quote,ragged-right,verbatim,fragment]
95 { a a a2 a a4 a a1 a }
96 @end lilypond
97
98
99 @node Augmentation dots
100 @unnumberedsubsubsec Augmentation dots
101
102 @funindex .
103
104 Pour obtenir des notes pointées, ajoutez simplement un point
105 (@samp{.}) au chiffre.  Les notes doublement pointées sont créées de
106 la même façon.
107
108 @lilypond[quote,ragged-right,fragment,verbatim]
109 a'4 b' c''4. b'8 a'4. b'4.. c''8.
110 @end lilypond
111
112 @refcommands
113
114 Les points sont normalement haussés pour éviter les lignes de portées,
115 sauf dans certaines polyphonies.  Les commandes suivantes peuvent être
116 utilisées pour demander manuellement une orientation particulière des
117 points.
118
119 @funindex \dotsUp
120 @code{\dotsUp},
121 @funindex \dotsDown
122 @code{\dotsDown},
123 @funindex \dotsNeutral
124 @code{\dotsNeutral}.
125
126 @seealso
127
128 Référence du programme : @internalsref{Dots}, @internalsref{DotColumn}.
129
130
131 @node Tuplets
132 @unnumberedsubsubsec Tuplets
133
134 @cindex nolets
135 @cindex triolets
136 @funindex \times
137
138 Les nolets --- triolets, quintolets, etc. --- sont obtenus en
139 multipliant toutes les durées d'une expression musicale par une
140 fraction.
141
142 @example
143 \times @var{fraction} @var{expr_musique}
144 @end example
145
146 @noindent
147 La durée de @var{expr_musique} sera multipliée par la fraction.  Le
148 dénominateur de la fraction sera imprimé au-dessus des notes, parfois
149 avec un crochet.  Le nolet le plus courant est le triolet, dans lequel 3
150 notes ont la durée de 2, et où les notes durent donc 2/3 de leur valeur
151 écrite.
152
153 @lilypond[quote,ragged-right,fragment,verbatim]
154 g'4 \times 2/3 {c'4 c' c'} d'4 d'4
155 @end lilypond
156
157 Les nolets peuvent être imbriqués ; par exemple,
158
159 @lilypond[fragment,ragged-right,verbatim,relative=2]
160 \override TupletNumber #'text = #tuplet-number::calc-fraction-text
161 \times 4/6 {
162   a4 a
163   \times 3/5 { a a a a a }
164 }
165 @end lilypond
166
167 @refcommands
168
169 @funindex \tupletUp
170 @code{\tupletUp},
171 @funindex \tupletDown
172 @code{\tupletDown},
173 @funindex \tupletNeutral
174 @code{\tupletNeutral}.
175
176
177 @commonprop
178
179 @funindex tupletNumberFormatFunction
180 @cindex nolets, formatage
181
182 La propriété @code{tupletSpannerDuration} spécifie la longueur voulue de
183 chaque crochet.  Avec elle, vous pouvez faire plusieurs nolets en ne
184 tapant @code{\times} qu'une fois, ce qui évite une longue saisie.  Dans
185 le prochain exemple, deux triolets sont imprimés avec une seule fonction
186 @code{\times}.
187
188 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
189 \set tupletSpannerDuration = #(ly:make-moment 1 4)
190 \times 2/3 { c8 c c c c c }
191 @end lilypond
192
193 @noindent
194 Pour plus d'information sur @code{make-moment}, voir
195 @ref{Time administration}.
196
197 L'apparence du chiffre est déterminée par la propriété @code{text} dans
198 @code{TupletNumber}.  La valeur par défaut imprime seulement le
199 dénominateur, mais si elle est définie par la fonction
200 @code{tuplet-number::calc-fraction-text}, la fraction entière
201 @var{num}:@var{den} sera imprimée à la place.
202
203 Pour éviter d'imprimer les chiffres des nolets, utilisez
204
205 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
206 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
207 \override TupletNumber #'transparent = ##t
208 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
209 @end lilypond
210
211 Utilisez la fonction @code{\tweak} pour définir une priorité dans le cas
212 de nolets imbriqués débutant au même moment.  Dans cet exemple,
213 @code{\tweak} spécifie un texte sous forme de fraction pour le
214 @code{TupletNumber} externe et de dénominateur pour les trois triolets
215 internes.
216
217 @lilypond[quote,ragged-right,verbatim]
218 \new Staff {
219   \tweak #'text #tuplet-number::calc-fraction-text
220   \times 4/3 {
221      \tweak #'text #tuplet-number::calc-denominator-text
222      \times 2/3 { c'8[ c'8 c'8] }
223      \times 2/3 { c'8[ c'8 c'8] }
224      \times 2/3 { c'8[ c'8 c'8] }
225   }
226 }
227 @end lilypond
228
229 Ici, @code{\tweak} et @code{\override} agissent de concert pour
230 spécifier le positionnement du @code{TupletBracket}.  Le premier
231 @code{\tweak} positionne le @code{TupletBracket} du nolet externe au
232 dessus de la portée. Le second @code{\tweak} positionne le
233 @code{TupletBracket} du premier triolet interne au dessous de la
234 portée.  Notez que cette paire de fonctions @code{\tweak} n'affecte
235 que le triolet extérieur et le premier des trois triolets imbriqués
236 parce qu'ils commencent au même instant musical.  Nous utilisons
237 @code{\override} de manière tout à fait normale, pour forcer le
238 positionnement du @code{TupletBracket} des deuxième et troisième
239 triolets en dessous de la portée.
240
241 @lilypond[quote,ragged-right,verbatim]
242 \new Staff {
243   \tweak #'text #tuplet-number::calc-fraction-text
244   \tweak #'direction #up
245   \times 4/3 {
246      \tweak #'direction #down
247      \times 2/3 { c'8[ c'8 c'8] }
248      \override TupletBracket #'direction = #down
249      \times 2/3 { c'8[ c'8 c'8] }
250      \times 2/3 { c'8[ c'8 c'8] }
251   }
252 }
253 @end lilypond
254
255 Les crochets de nolets peuvent aller jusqu'aux prémisses de la mesure
256 suivante, ou à la prochaine note.
257
258 @lilypond[ragged-right]
259 \new RhythmicStaff {
260   \set tupletFullLength = ##t
261   \time 4/4
262   \times 4/5 {
263     c4 c1
264   }
265   \set tupletFullLengthNote = ##t
266   \time 2/4
267   \times 2/3 {
268     c4 c c 
269   }
270   \time 3/4
271   c4 
272 }
273 @end lilypond
274
275
276 @seealso
277
278 Référence du programme : @internalsref{TupletBracket},
279 @internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
280
281
282
283 @node Scaling durations
284 @unnumberedsubsubsec Scaling durations
285
286 Vous pouvez altérer la durée des notes en leur joignant une fraction
287 @var{N/M}, donnant @q{@code{*}@var{N/M}} --- ou @q{@code{*}@var{N}} si
288 @var{M=1}.  Ceci n'affectera pas l'apparence des notes ou silences
289 produits.
290
291 Dans l'exemple suivant, les trois premières notes prennent exactement
292 deux temps, mais aucun triolet n'est imprimé.
293
294 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
295 \time 2/4
296 a4*2/3 gis4*2/3 a4*2/3
297 a4 a4 a4*2
298 b16*4 c4
299 @end lilypond
300
301
302 @seealso
303
304 Dans ce manuel : @ref{Tuplets}.
305
306
307 @node Writing rests
308 @subsection Writing rests
309
310 @menu
311 * Rests::                       
312 * Skips::                       
313 * Multi measure rests::         
314 @end menu
315
316 @node Rests
317 @unnumberedsubsubsec Rests
318 @cindex silences
319
320 @funindex \rest
321 @funindex r
322
323 Les silences sont écrits comme des notes avec le nom de note @code{r}.
324
325 @lilypond[fragment,quote,ragged-right,verbatim]
326 r1 r2 r4 r8
327 @end lilypond
328
329 Les pauses d'une mesure complète, qui sont placées au centre de la
330 mesure, doivent être entrées comme des mesures de silence.  Elles
331 peuvent être utilisées pour une seule mesure comme pour plusieurs, et
332 leur utilisation est expliquée dans la section
333 @ref{Multi measure rests}.
334
335 Pour spécifier explicitement la position verticale d'un silence, écrivez
336 une note suivie de @code{\rest}.  Un silence sera placé à la position où
337 serait imprimée la note.
338
339 @lilypond[fragment,quote,ragged-right,verbatim]
340 a'4\rest d'4\rest
341 @end lilypond
342
343 @noindent
344 Cela rend plus facile la mise en place de la musique polyphonique,
345 puisque le formateur automatique de collision des silences laissera ces
346 silences tranquilles.
347
348 @seealso
349
350 Référence du programme : @internalsref{Rest}.
351
352
353 @node Skips
354 @unnumberedsubsubsec Skips
355
356 @cindex sauts de durée
357 @cindex silences invisibles
358 @cindex silences d'espacement
359 @funindex \skip
360 @funindex s
361
362 Un silence invisible --- que l'on pourrait appeler un @qq{saut} ---
363 peut être entré comme une note avec le nom de note `@samp{s}' ou avec
364 @code{\skip @var{durée}}
365
366 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
367 a4 a4 s4 a4 \skip 1 a4
368 @end lilypond
369
370 La syntaxe @code{s} est seulement disponible pour les modes d'entrée
371 de notes et d'accords.  Dans d'autres situations, pour l'entrée de
372 paroles par exemple, vous devrez utiliser la commande @code{\skip}.
373
374 @lilypond[quote,ragged-right,verbatim]
375 <<
376   \relative { a'2 a2 }
377   \new Lyrics \lyricmode { \skip 2 bla2 }
378 >>
379 @end lilypond
380
381 La commande de saut génère simplement une case musicale vide.  Elle ne
382 produit rien sur la partition, pas même un symbole transparent.  Le code
383 de saut @code{s} crée tout de même une @internalsref{Staff} et une
384 @internalsref{Voice} lorsque nécessaire, tout comme les commandes de
385 note et de silence.  Ainsi, le code suivant aboutit à une portée vide.
386
387 @lilypond[quote,ragged-right,verbatim]
388 { s4 }
389 @end lilypond
390
391 Le fragment @code{@{ \skip 4 @} } produirait une page vide.
392
393 @seealso
394
395 Référence du programme : @internalsref{SkipMusic}.
396
397
398 @node Multi measure rests
399 @unnumberedsubsubsec Multi measure rests
400
401 @cindex mesures à compter
402 @cindex mesure entière de silence
403 @cindex Silences, multi-mesures
404 @cindex Silences, mesure entère
405 @cindex une pause par mesure
406 @funindex R
407
408 Un silence valant une ou plusieurs mesures entières s'entre avec un
409 @samp{R} majuscule.  Ceci ne peut être utile que pour une mesure complètement
410 vide, et pour générer des parties séparées : ce silence sera alors
411 répété sur autant de mesures que nécessaire, ou bien imprimé une seule
412 fois.  La répétition est contrôlée par la propriété
413 @code{Score.skipBars}.  Au cas où ce commutateur est défini comme
414 vrai (lettre @code{##t} pour @q{true}), les mesures vides ne seront pas répétées, et le nombre exact de
415 mesures sera ajouté.
416
417 @lilypond[quote,ragged-right,fragment,verbatim]
418 \time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
419 \set Score.skipBars = ##t R1*17 R1*4
420 @end lilypond
421
422 Le @code{1} de @code{R1} est le même que celui utilisé pour la durée
423 des notes.  Vous devrez donc, si le morceau n'est pas à 4/4, stipuler
424 un autre durée, qui pourra contenir des points d'augmentation ou être
425 libellé sous forme de fraction :
426
427 @lilypond[quote,ragged-right,fragment,verbatim]
428 \set Score.skipBars = ##t
429 \time 3/4
430 R2. | R2.*2
431 \time 13/8
432 R1*13/8
433 R1*13/8*12 |
434 \time 10/8 R4*5*4 |
435 @end lilypond
436
437 Un @code{R} qui s'étend sur une seule mesure s'imprime tantôt comme
438 une pause, tantôt comme une brève, et sera centré sur la mesure
439 quelle que soit la métrique.
440
441 Dans le cas où ce silence ne dure que quelques mesures, LilyPond
442 imprime sur la portée des @qq{ silences d'église }, simple suite de
443 rectangles.  La propriété @code{MultiMeasureRest.expand-limit} permet
444 d'obtenir un silence unique.
445
446 @lilypond[quote,ragged-right,fragment,verbatim]
447 \set Score.skipBars = ##t
448 R1*2 | R1*5 | R1*9
449 \override MultiMeasureRest #'expand-limit = 1
450 R1*2 | R1*5 | R1*9
451 @end lilypond
452
453 @cindex texte et silence multi-mesures
454 @cindex script et silence multi-mesures
455 @cindex point d'orgue et silence multi-measures
456
457 Vous pouvez aussi ajouter du texte à un silence multi-mesures en utilisant
458 la syntaxe @var{note}-@code{markup} (cf. @ref{Text markup}).  La
459 variable @code{\fermataMarkup} permet d'ajouter un point d'orgue.
460
461 @lilypond[quote,ragged-right,verbatim,fragment]
462 \set Score.skipBars = ##t
463 \time 3/4
464 R2.*10^\markup { \italic "ad lib." }
465 R2.^\fermataMarkup
466 @end lilypond
467
468 Attention !  c'est @code{MultiMeasureRestText} qui créera le texte, et
469 non @code{TextScript}.
470
471 @lilypond[quote,ragged-right,verbatim,fragment]
472 \override TextScript #'padding = #5
473 R1^"low"
474 \override MultiMeasureRestText #'padding = #5
475 R1^"high"
476 @end lilypond
477
478 Pour aligner votre texte sur le début de la mesure, rattachez-le à un
479 silence invisible de longueur zéro comme ceci :
480
481 @example
482 s1*0^"Allegro"
483 R1*4
484 @end example
485
486
487 @seealso
488
489 Référence du programme : @internalsref{MultiMeasureRestMusic},
490 @internalsref{MultiMeasureRest}.
491
492 L'objet de rendu @internalsref{MultiMeasureRestNumber} traite les
493 nombres, et @internalsref{MultiMeasureRestText} le texte ajouté par
494 l'utilisateur. 
495
496
497 @refbugs
498
499 Vous ne pouvez pas utiliser de doigtés (p.ex. @code{R1-4}) pour
500 positionner des nombres au dessus d'un silence multi-mesures, ni
501 modifier la hauteur.
502
503 @cindex condenser les silences
504
505 Condenser plusieurs silences en un unique silence multi-mesures ne peut 
506 être automatisé.  Les silences multi-mesures peuvent générer des
507 collisions avec d'autres silences.
508
509 Pensez à indiquer explicitement la durée de la note qui suit un
510 silence multi-mesures, car elle sera par défaut égale à la durée totale
511 des mesures à compter. Ainsi, dans l'exemple ci-après, les deux do
512 dièses vaudront chacun quatre mesures à 4/4.
513 @example
514 R1*4 cis cis
515 @end example
516 Lorsque @code{skipBars} est activé, le résultat semblera correct, mais
517 la numérotation des mesures sera suspendue. 
518
519
520 @node Displaying rhythms
521 @subsection Displaying rhythms
522
523 @menu
524 * Time signature::              
525 * Upbeats::                     
526 * Unmetered music::             
527 * Polymetric notation::         
528 * Automatic note splitting::    
529 @end menu
530
531 @node Time signature
532 @unnumberedsubsubsec Time signature
533
534 @cindex chiffrage de mesure
535 @cindex chiffre indicateur de mesure
536 @cindex métrique
537 @funindex \time
538
539 Le chiffre de mesure indique le mètre d'une pièce : une alternance
540 régulière de temps forts et de temps faibles.  Il est indiqué par une
541 fraction au début de la portée.
542
543 Le chiffre de mesure est réglé par la commande @code{\time}.
544
545 @lilypond[quote,ragged-right,fragment,verbatim]
546 \time 2/4 c'2 \time 3/4 c'2.
547 @end lilypond
548
549 @commonprop
550
551 Le symbole imprimé peut être modifié avec la propriété @code{style}.
552 En la réglant sur @code{#'()}, une fraction sera utilisée pour les
553 chiffres de mesure 4/4 et 2/2.
554
555 @lilypond[fragment,quote,ragged-right,verbatim]
556 \time 4/4 c'1
557 \time 2/2 c'1
558 \override Staff.TimeSignature #'style = #'()
559 \time 4/4 c'1
560 \time 2/2 c'1
561 @end lilypond
562
563 Il y a bien d'autres options pour sa mise en place.  Voir @ref{Ancient time
564 signatures} pour plus d'exemples.
565
566 @code{\time} définit les propriétés @code{timeSignatureFraction},
567 @code{beatLength} et @code{measureLength} dans le contexte
568 @code{Timing}, qui en principe est assimilé à @internalsref{Score}.  La
569 propriété @code{measureLength} détermine où des barres de mesure doivent
570 être insérées, et comment les groupements de notes doivent être gérés.
571 La modification de la valeur de @code{timeSignatureFraction} donne
572 également lieu à l'impression d'un symbole.
573
574 Plus d'options sont accessibles au moyen de la fonction Scheme
575 @code{set-time-signature}.  De concert avec le
576 @internalsref{Measure_grouping_engraver}, elle crée les signes de
577 @internalsref{MeasureGrouping}, qui facilitent la lecture de musiques
578 modernes, complexes rythmiquement.  Dans l'exemple suivant, les mesures
579 à 9/8 sont subdivisées en @code{(2 2 2 3)}, ce qui est donné comme
580 argument à la commande @code{set-time-signature}, en troisième position.
581
582 @lilypond[quote,ragged-right,verbatim]
583 \score {
584   \relative c'' {
585     #(set-time-signature 9 8 '(2 2 2 3))
586     g8[ g] d[ d] g[ g] a8[( bes g]) |
587     #(set-time-signature 5 8 '(3 2))
588     a4. g4
589   }
590   \layout {
591     \context {
592       \Staff
593       \consists "Measure_grouping_engraver"
594     }
595   }
596 }
597 @end lilypond
598
599
600 @seealso
601
602 Référence du programme : @internalsref{TimeSignature} et
603 @internalsref{Timing_translator}.
604
605 Exemples : @lsr{contemporary,compound-time-signature.ly}.
606
607
608 @refbugs
609
610 Le groupement automatique des ligatures n'utilise pas les groupements
611 spécifiés par @code{set-time-signature}.
612
613
614 @node Upbeats
615 @unnumberedsubsubsec Upbeats
616
617 @cindex anacrouse
618 @cindex levée
619 @cindex mesure incomplète
620 @funindex \partial
621
622
623 Les mesures incomplètes, telles que les anacrouses ou levées, doivent
624 être entrées avec la commande
625
626 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
627 \partial 16*5 c16 cis d dis e | a2. c,4 | b2
628 @end lilypond
629
630
631 La syntaxe de cette commande est
632
633 @example
634 \partial @var{durée}
635 @end example
636
637 @code{durée} étant la valeur rythmique devant être ajoutée avant la
638 mesure suivante.
639
640 Le programme traduit cette commande en
641
642 @example
643 \set Timing.measurePosition = -@var{durée}
644 @end example
645
646
647 La propriété @code{measurePosition} contient un nombre rationnel qui
648 indique, à ce point précis, où l'on en est de la mesure. Notez qu'il
649 peut s'agir d'un nombre négatif ; @code{\partial 4} signifie, pour le
650 programme : @qq{Dans cette mesure, il reste juste une noire}.
651
652
653 @refbugs
654
655 Cette commande ne prend pas en compte les notes d'ornement ou
656 appoggiatures au début de la musique. Lorsqu'un morceau commence par une
657 levée et avec des petites notes, la commande @code{\partial} devrait être
658 placée après celles-ci.
659
660 @lilypond[verbatim,quote,ragged-right,relative,fragment]
661 \grace f16
662 \partial 4
663 g4
664 a2 g2
665 @end lilypond
666
667 @code{\partial} n'est destiné à être utilisé qu'en début de pièce.
668 Si on l'utilise ailleurs qu'au début, des messages d'erreurs peuvent
669 s'afficher.
670
671
672 @node Unmetered music
673 @unnumberedsubsubsec Unmetered music
674
675 @cindex cadence
676 @funindex \cadenzaOn
677 @funindex \cadenzaOff
678
679
680 Les barres de mesure et les numéros de mesure sont calculés
681 automatiquement, ce qui n'est pas souhaitable dans le cas d'une musique
682 non mesurée --- les cadences, par exemple. Les commandes
683 @code{\cadenzaOn} et @code{\cadenzaOff} permettent de désactiver et de
684 rétablir la métrique automatique.
685
686 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
687 c4 d e d
688 \cadenzaOn
689 c4 c d8 d d f4 g4.
690 \cadenzaOff
691 \bar "|"
692 d4 e d c
693 @end lilypond
694
695
696 @refbugs
697
698 LilyPond ne change de ligne ou de page qu'au niveau des barres de
699 mesure.  Si votre musique non mesurée dure plus d'une ligne, il vous
700 faudra insérer des barres de mesure invisibles, pour indiquer à quels
701 endroit un saut de ligne peut intervenir.
702
703 @example
704 \bar ""
705 @end example
706
707
708 @node Polymetric notation
709 @unnumberedsubsubsec Polymetric notation
710
711 @cindex métrique composite
712 @cindex composite, métrique
713 @cindex métrique polymétrique
714 @cindex polymétrie
715
716 LilyPond ne gère pas les métriques composites de manière explicite,
717 mais on peut contourner ce problème.  Dans l'exemple suivant,
718 l'indicateur de métrique est obtenu grâce à une étiquette textuelle.
719 Cette étiquette vient s'insérer dans l'objet graphique (@emph{grob})
720 @internalsref{TimeSignature}.  Voir aussi
721 @lsr{contemporary,compound-time-signature}. 
722
723
724 @lilypond[verbatim,ragged-right]
725 % create 2/4 + 5/8
726 tsMarkup =\markup {
727   \override #'(baseline-skip . 2) \number {
728     \column { "2" "4" }
729     \vcenter "+"
730     \bracket \column { "5" "8" }
731   }
732 }
733
734 {
735   \override Staff.TimeSignature #'stencil = #ly:text-interface::print
736   \override Staff.TimeSignature #'text = #tsMarkup
737   \time 3/2
738   c'2 \bar ":" c'4 c'4.
739 }
740 @end lilypond
741
742 Il arrive aussi que chaque portée ait sa propre métrique.  Vous y
743 parviendrez en déplaçant le @internalsref{Timing_translator} dans le
744 contexte @internalsref{Staff}.
745
746 @example
747 \layout @{
748   \context @{ \Score
749      \remove "Timing_translator"
750      \remove "Default_bar_line_engraver"
751   @}
752   \context @{
753     \Staff
754     \consists "Timing_translator"
755     \consists "Default_bar_line_engraver"
756   @}
757
758 @}
759 @end example
760
761
762 Maintenant, chacune des portées dispose de sa propre métrique.
763 @example
764 <<
765   \new Staff @{
766     \time 3/4
767     c4 c c | c c c |
768   @}
769   \new Staff @{
770     \time 2/4
771     c4 c | c c | c c
772   @}
773   \new Staff @{
774     \time 3/8
775     c4. c8 c c c4. c8 c c
776   @}
777 >>
778 @end example
779
780 @lilypond[quote,ragged-right]
781 \layout{
782   \context{
783      \Score
784      \remove "Timing_translator"
785      \remove "Default_bar_line_engraver"
786     }
787   \context{ \Staff
788     \consists "Timing_translator"
789     \consists "Default_bar_line_engraver"
790   }
791 }
792
793 \relative c' <<
794   \new Staff {
795     \time 3/4
796     c4 c c | c c c |
797   }
798   \new Staff {
799     \time 2/4
800     c4 c | c c | c c
801   }
802   \new Staff {
803     \time 3/8
804     c4. c8 c c c4. c8 c c
805   }
806 >>
807 @end lilypond
808
809
810 Une autre forme de notation polymétrique consiste dans le fait que des
811 notes aient une durée relative différente selon la portée.  
812
813 Vous pouvez créer une telle notation en définissant une métrique
814 commune à toutes les portées,  que vous proratiserez manuellement
815 selon le cas en utilisant @code{timeSignatureFraction} pour obtenir la
816 division adéquate pour chaque portée.  Les durées, dans chacune des
817 portées, seront alors échelonnées par rapport à la métrique commune.
818 L'échelle de représentation se règle avec @code{\compressMusic} ---
819 qui fonctionne comme @code{\times}, sans toutefois créer de crochet.
820 La syntaxe appropriée est :
821 @example
822 \compressMusic #'(@var{numérateur} . @var{dénominateur}) @var{exprmusicale}
823 @end example
824
825
826 L'exemple suivant utilise parallèlement des mesures à 3/4, 9/8 et
827 10/8.  Pour la deuxième portée, les durées sont multipliées par 2/3,
828 de telle sorte que @w{2/3 * 9/8 = 3/4} ; pour la troisième, elles sont
829 multipliées par 3/5, de telle sorte que @w{3/5 * 10/8 = 3/4}.
830
831 @lilypond[quote,ragged-right,verbatim,fragment]
832 \relative c' { <<
833   \new Staff {
834     \time 3/4
835     c4 c c | c c c |
836   }
837   \new Staff {
838     \time 3/4
839     \set Staff.timeSignatureFraction = #'(9 . 8)
840     \compressMusic #'(2 . 3)
841       \repeat unfold 6 { c8[ c c] }
842   }
843   \new Staff {
844     \time 3/4
845     \set Staff.timeSignatureFraction = #'(10 . 8)
846     \compressMusic #'(3 . 5) {
847       \repeat unfold 2 { c8[ c c] }
848       \repeat unfold 2 { c8[ c] }
849       | c4. c4. \times 2/3 { c8 c c } c4
850     }
851   }
852 >> }
853 @end lilypond
854
855
856
857
858 @refbugs
859
860 L'utilisation de métriques différentes en parallèle entraine un
861 alignement vertical.  De ce fait, les barres de mesure ont tendance à
862 fausser l'espacement régulier.
863
864
865 @node Automatic note splitting
866 @unnumberedsubsubsec Automatic note splitting
867
868 On peut convertir automatiquement les notes longues en notes liées.  Il
869 faut pour cela remplacer le graveur @internalsref{Note_heads_engraver}
870 par le graveur @internalsref{Completion_heads_engraver}.  Dans les
871 exemples suivants, les notes dépassant de la mesure sont divisées et
872 liées.
873
874 @lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
875 \new Voice \with {
876   \remove "Note_heads_engraver"
877   \consists "Completion_heads_engraver"
878 } {
879   c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
880 }
881 @end lilypond
882
883 Ce graveur divise toutes les notes qui sortent de la mesure, et insère
884 des liaisons de prolongation.  Une utilisation posible consiste à
885 déboguer des partitions complexes : si les mesures ne sont pas
886 entièrement remplies, alors les liaisons de prolongation montrent
887 exactement la durée des décalages de mesure.
888
889 Si vous voulez permettre un saut de ligne aux barres de mesure où
890 @internalsref{Completion_heads_engraver} divise les notes, vous devez
891 aussi enlever @internalsref{Forbid_line_break_engraver}.
892
893
894 @refbugs
895
896 Bien que toutes les durées --- particulièrement celles contenant des
897 nolets --- ne puissent pas être représentées exactement avec des notes
898 normales et des points, le graveur n'insèrera pas de nolets.
899
900 @code{Completion_heads_engraver} affecte seulement les notes, il ne
901 divise pas les silences.
902
903 @seealso
904
905 Référence du programme : @internalsref{Completion_heads_engraver}.
906
907
908 @node Beams
909 @subsection Beams
910
911 @menu
912 * Automatic beams::             
913 * Manual beams::                
914 * Feathered beams::             
915 @end menu
916
917 @node Automatic beams
918 @unnumberedsubsubsec Automatic beams
919
920 LilyPond décide automatiquement de la manière de grouper les notes et
921 d'imprimer les ligatures.
922
923 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
924 \time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
925 @end lilypond
926
927 Lorsque ce comportement automatisé n'est pas satisfaisant, on peut
928 définir des groupements manuellement --- voir section suivante --- ou
929 personnaliser les groupements automatiques --- voir @ref{Setting
930 automatic beam behavior}.
931
932 La commande @code{\noBeam} peut servir à empêcher des notes
933 individuelles d'être rattachées aux autres.
934
935 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
936 \time 2/4 c8 c\noBeam c c
937 @end lilypond
938
939
940 @seealso
941
942 Référence du programme : @internalsref{Beam}.
943
944
945 @node Manual beams
946 @unnumberedsubsubsec Manual beams
947
948 @cindex groupements de note manuels
949 @cindex ligatures manuelles
950 @funindex ]
951 @funindex [
952
953 Dans certaines situations, il peut s'avérer nécessaire de
954 supplanter l'algorithme de groupement automatique des notes, par
955 exemple pour prolonger une ligature par-dessus un silence ou une barre
956 de mesure.  Le début et la fin de la ligature sont alors indiqués par
957 @code{[} et @code{]}.
958
959 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
960 {
961   r4 r8[ g' a r8] r8 g[ | a] r8
962 }
963 @end lilypond
964
965
966 @commonprop
967
968 @funindex stemLeftBeamCount
969 @funindex stemRightBeamCount
970
971 LilyPond peut déterminer automatiquement les sous-groupes à
972 l'intérieur d'un groupement de notes, bien que le résultat ne soit pas 
973 toujours optimal.  Les propriétés @code{stemLeftBeamCount} et
974 @code{stemRightBeamCount} permettent alors
975 d'ajuster ce comportement.  Lorsque l'une ou l'autre de ces propriétés
976 est définie, elle ne s'applique qu'une seule fois, après quoi sa
977 définition est effacée.
978
979 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
980 {
981    f8[ r16
982       f g a]
983    f8[ r16
984    \set stemLeftBeamCount = #1
985       f g a]
986 }
987 @end lilypond
988
989 La propriété @code{subdivideBeams} sert à grouper les double-croches
990 ou les valeurs plus brèves pulsation par pulsation, la pulsation
991 étant définie par la propriété @code{beatLength}.
992
993 @lilypond[fragment,quote,relative=2,verbatim]
994 c16[ c c c c c c c]
995 \set subdivideBeams = ##t
996 c16[ c c c c c c c]
997 \set Score.beatLength = #(ly:make-moment 1 8)
998 c16[ c c c c c c c]
999 @end lilypond
1000 @funindex subdivideBeams
1001
1002 @noindent
1003 Pour plus d'information sur @code{make-moment}, voir
1004 @ref{Time administration}.
1005
1006 Lorsqu'une ligature franchit une barre de mesure, le saut
1007 de ligne est en principe interdit à cet endroit.  Ce comportement peut
1008 être outrepassé en définissant @code{breakable}.
1009
1010 @funindex breakable
1011
1012 @cindex ligatures et sauts de ligne
1013 @cindex ligatures coudées
1014 @cindex auto-knee-gap
1015
1016 LilyPond insère automatiquement des ligatures coudées --- certaines
1017 notes vers le haut, d'autres vers le bas --- lorsqu'il détecte un espace
1018 important entre des têtes de notes. Ce comportement peut être changé par
1019 l'intermédiaire de l'objet @code{auto-knee-gap}
1020
1021
1022 @refbugs
1023
1024 Les ligatures coudées à cheval sur deux portées ne peuvent être
1025 employées en même temps que des portées invisibles.  Voir
1026 @ref{Hiding staves}.
1027
1028 @c Is this still true with skyline spacing stuff? -J.Mandereau
1029 Les ligatures peuvent entrer en collision avec des symboles entourant
1030 les notes, contrairement aux textes ou aux altérations.
1031
1032
1033 @node Feathered beams
1034 @unnumberedsubsubsec Feathered beams
1035
1036 Les ligatures en soufflet s'obtiennent en définissant la propriété
1037 @code{grow-direction} d'une barre de ligature.  La fonction
1038 @code{\featherDurations} sert à ajuster la durée des notes.
1039
1040 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
1041 \override Beam #'grow-direction = #LEFT
1042 \featherDurations #(ly:make-moment 5 4) 
1043 {
1044   c16[ c c c c c c]
1045 }
1046 @end lilypond
1047
1048 @refbugs
1049
1050 La commande @code{\featherDurations} ne permet de traiter que de très
1051 courts extraits.
1052
1053
1054 @node Bars
1055 @subsection Bars
1056
1057
1058 @menu
1059 * Bar check::                   
1060 * Bar lines::                   
1061 * Bar numbers::                 
1062 * Barnumber check::             
1063 * Rehearsal marks::             
1064 @end menu
1065
1066 @node Bar check
1067 @unnumberedsubsubsec Bar check
1068
1069 @cindex vérification des limites de mesure
1070 @cindex mesures, vérification des limites
1071 @funindex barCheckSynchronize
1072 @funindex |
1073
1074 Les tests de limites de mesure (ou tests de mesure) aident à détecter
1075 les erreurs dans les durées.  Un test de mesure s'écrit avec une barre
1076 verticale, @samp{|}.  Lors du traitement, elle doit correspondre à une
1077 barre de mesure.  Sinon, un avertissement est émis.  Dans l'exemple
1078 suivant, le deuxième test de mesure signale une erreur.
1079 @example
1080 \time 3/4 c2 e4 | g2 |
1081 @end example
1082
1083 Le test de mesure peut être aussi utilisé dans les paroles, par exemple :
1084 @example
1085 \lyricmode @{
1086  \time 2/4
1087  Twin -- kle | Twin -- kle
1088 @}
1089 @end example
1090
1091 Des durées incorrectes font échouer les tests de mesure, et peuvent
1092 souvent mettre la partition sens dessus dessous, particulièrement s'il
1093 s'agit de musique polyphonique.  Vérifier les tests de mesure qui ont
1094 échoué et les durées incorrectes est un bon moyen de commencer à
1095 corriger sa partition.
1096
1097 @funindex |
1098 @funindex pipeSymbol
1099
1100 Il est aussi possible d'attribuer une autre valeur au symbole
1101 @code{|}, en assignant une expression musicale à @code{pipeSymbol},
1102
1103 @lilypond[quote,ragged-right,verbatim]
1104 pipeSymbol = \bar "||"
1105
1106 { c'2 c' | c'2 c' }
1107 @end lilypond
1108
1109
1110 @node Bar lines
1111 @unnumberedsubsubsec Bar lines
1112
1113 @cindex barres de mesure
1114 @funindex \bar
1115 @cindex barres de reprise
1116
1117
1118 Les barres de mesures délimitent les mesures, mais peuvent aussi
1119 indiquer une reprise. En principe, elles sont insérées automatiquement,
1120 et les sauts de ligne ne peuvent avoir lieu qu'au niveau de ces barres.
1121
1122 Il est possible de forcer l'impression d'une barre de mesure spéciale,
1123 avec la commande @code{\bar} :
1124
1125 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1126 c4 \bar "|:" c4
1127 @end lilypond
1128
1129
1130 Les styles de barres de mesure disponibles sont
1131
1132 @c @lilypondfile[ragged-right,quote]{bar-lines.ly}
1133
1134
1135 En plus de cela, on peut demander @code{"||:"}, qui équivaut à
1136 @code{"|:"}, mais qui donnera, en cas de saut de ligne, une double barre
1137 en fin de ligne, et une barre de reprise au début de la ligne suivante.
1138
1139 Il est possible d'autoriser un saut de ligne même s'il n'y a pas
1140 de barre de mesure visible, en utilisant :
1141
1142 @example
1143 \bar ""
1144 @end example
1145
1146 @noindent
1147
1148
1149 Ceci insérera une barre de mesure invisible, et permettra de sauter de
1150 ligne à cet endroit, sans incrémenter le numéro de mesure.
1151
1152
1153 Dans une partition comprenant plusieurs portées, la commande @code{\bar}
1154 placée sur une portée s'applique automatiquement à toutes les
1155 portées. Les barres de mesure que l'on obtient alors sont d'un seul
1156 tenant sur les portées d'un @code{StaffGroup}, d'un @code{PianoStaff} ou
1157 d'un @code{GrandStaff}.
1158
1159 @lilypond[quote,ragged-right,fragment,verbatim]
1160 <<
1161   \new StaffGroup <<
1162     \new Staff {
1163       e'4 d'
1164       \bar "||"
1165       f' e'
1166     }
1167     \new Staff { \clef bass c4 g e g }
1168   >>
1169   \new Staff { \clef bass c2 c2 }
1170 >>
1171 @end lilypond
1172
1173
1174 @commonprop
1175
1176 @funindex whichBar
1177 @funindex repeatCommands
1178 @funindex defaultBarType
1179
1180
1181 La commande @code{\bar }@var{bartype} sert de raccourci pour @code{\set
1182 Timing.whichBar = }@var{bartype}.  Dès que l'on définit @code{whichBar},
1183 une barre de mesure est créée selon le style défini.
1184
1185
1186 Dès que la propriété @code{whichBar} est définie, une barre de mesure
1187 est créée.  À chaque début de mesure, elle prend la valeur de
1188 @code{Timing.defaultBarType}.  La valeur de @code{repeatCommands} sert à
1189 remplacer les barres de mesure par défaut.
1190
1191 Nous vous invitons à utiliser @code{\repeat} pour indiquer les
1192 reprises. Voyez à ce sujet @ref{Repeats}.
1193
1194
1195 @seealso
1196
1197 Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
1198
1199 Référence du programme : @internalsref{BarLine} (faisant partie du
1200 contexte @internalsref{Staff}), @internalsref{SpanBar} (sur plusieurs
1201 portées).
1202
1203
1204 @node Bar numbers
1205 @unnumberedsubsubsec Bar numbers
1206
1207 @cindex Mesure, numéro de
1208 @cindex numéros de mesure
1209 @funindex currentBarNumber
1210
1211 Les numéros de mesure sont imprimés par défaut à chaque début de
1212 ligne.  Ce nombre est stocké par la propriété @code{currentBarNumber}
1213 qui sera mis à jour à chaque mesure.
1214
1215 @lilypond[verbatim,ragged-right,quote,fragment,relative]
1216 \repeat unfold 4 {c4 c c c} \break
1217 \set Score.currentBarNumber = #50
1218 \repeat unfold 4 {c4 c c c}
1219 @end lilypond
1220
1221 L'impression d'un numéro de mesure ne peut intervenir que s'il y a une
1222 barre.  Aussi, pour pouvoir le faire au début d'un morceau,
1223 devrez-vous ajouter une barre vide :
1224
1225 @lilypond[verbatim,ragged-right,quote,fragment,relative]
1226 \set Score.currentBarNumber = #50
1227 \bar ""
1228 \repeat unfold 4 {c4 c c c} \break
1229 \repeat unfold 4 {c4 c c c}
1230 @end lilypond
1231
1232 Vous pouvez imprimer un numéro de mesure à intervalles réguliers plutôt
1233 qu'en tête de chaque ligne.  C'est ce qu'illustre l'exemple suivant,
1234 dont la source complète est 
1235 @lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
1236
1237 @c @lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
1238
1239 Désactiver le graveur concerné --- @code{Bar_number_engraver} ---
1240 donnera une partition sans numéros de mesure.
1241
1242 @lilypond[verbatim,ragged-right,quote]
1243 \layout {
1244   \context {
1245     \Score
1246     \remove "Bar_number_engraver"
1247   }
1248 }
1249 \relative c''{
1250 c4 c c c \break
1251 c4 c c c
1252 }
1253 @end lilypond
1254
1255
1256 @seealso
1257
1258 Référence du programme : @internalsref{BarNumber}.
1259
1260 Exemples : @lsrdir{staff}
1261
1262
1263 @refbugs
1264
1265 Les numéros de mesure peuvent entrer en collision avec les crochets de
1266 @internalsref{StaffGroup}. La propriété @code{padding} --- décalage
1267 --- de l'objet @internalsref{BarNumber} permet alors d'ajuster leur
1268 positionnement. 
1269
1270
1271 @node Barnumber check
1272 @unnumberedsubsubsec Barnumber check
1273
1274 Lorsque l'on recopie de longues pièces, il peut être utile de vérifier
1275 que les numéros de mesures de LilyPond correspondent à l'original que
1276 l'on recopie.  Cela se fait avec @code{\barNumberCheck}.  Par exemple,
1277
1278 @verbatim
1279 \barNumberCheck #123
1280 @end verbatim
1281
1282 @noindent
1283 affiche un avertissement lors du traitement si le numéro de mesure à ce
1284 point (variable @code{currentBarNumber}) n'est pas 123.
1285
1286
1287 @node Rehearsal marks
1288 @unnumberedsubsubsec Rehearsal marks
1289
1290 @cindex Repères, indication de
1291 @funindex \mark
1292
1293 Indiquer un repère s'obtient grâce à la commande @code{\mark}.
1294
1295 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1296 c1 \mark \default
1297 c1 \mark \default
1298 c1 \mark #8
1299 c1 \mark \default
1300 c1 \mark \default
1301 @end lilypond
1302
1303 @noindent
1304 La lettre@tie{}@q{I} n'est pas utilisée, conformément aux usages de la
1305 gravure.  Cependant, vous pourrez intégrer la lettre @q{I} en utilisant
1306
1307 @example
1308 \set Score.markFormatter = #format-mark-alphabet
1309 @end example
1310
1311 Lorsque vous utilisez @code{\mark \default}, le repère s'incrémente
1312 automatiquement ; toutefois donner un nombre en argument permet de
1313 spécifier manuellement le repère en question.  La valeur à utiliser
1314 est enregistrée dans la propriété @code{rehearsalMark}.
1315
1316 Le style du repère est déterminé par la propriété
1317 @code{markFormatter}.  Il s'agit d'une fonction qui prend en arguments
1318 le repère en cours (un entier) ainsi que le contexte en cours, et
1319 retournera un objet de type étiquette.  Dans l'exemple qui suit,
1320 @code{markFormatter} est réglé pour une procédure type. Quelques
1321 mesure plus loin, son comportement est modifié pour imprimer un
1322 repère encadré.
1323
1324 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
1325 \set Score.markFormatter = #format-mark-numbers
1326 c1 \mark \default
1327 c1 \mark \default
1328 \set Score.markFormatter = #format-mark-box-numbers
1329 c1 \mark \default
1330 c1 \mark \default
1331 c1
1332 @end lilypond
1333
1334 Le fichier @file{scm/@/translation@/-functions@/.scm} comporte les
1335 définitions de @code{format-mark-numbers} (comportement par défaut), 
1336 @code{format-mark-box-numbers},
1337 @code{format-mark-letters} et @code{format-mark-box-letters}.  Vous
1338 pouvez vous en inspirer pour d'autres fonctions de formatage.
1339
1340 @code{format-mark-barnumbers}, @code{format-mark-box-barnumbers} et 
1341 @code{format-mark-circle-barnumbers}  permettent d'imprimer le numéro
1342 de mesure au lieu des compteurs alphabétique ou numérique.
1343
1344 On peut aussi spécifier manuellement une marque de repère :
1345
1346 @example
1347 \mark "A1"
1348 @end example
1349
1350 @noindent
1351 @code{Score.markFormatter} sera sans effet sur des repères ainsi
1352 définis.  Un @code{\markup} peut néanmoins s'utiliser en argument.
1353
1354 @example
1355 \mark \markup@{ \box A1 @}
1356 @end example
1357
1358 @cindex segno
1359 @cindex coda
1360 @cindex D.S al Fine
1361
1362 Un @code{\mark} peut contenir un glype musical tel que le signe
1363 @emph{segno}.  
1364
1365 @lilypond[fragment,quote,ragged-right,verbatim,relative]
1366 c1 \mark \markup { \musicglyph #"scripts.segno" }
1367 c1 \mark \markup { \musicglyph #"scripts.coda" }
1368 c1 \mark \markup { \musicglyph #"scripts.ufermata" }
1369 c1
1370 @end lilypond
1371
1372 @noindent
1373 Pour connaître les différents symboles accessibles par
1374 @code{\musicglyph}, consultez @ref{The Feta font}.
1375
1376 Pour affiner le positionnement des repères, veuillez vous référer à
1377 @ref{Text marks}.
1378
1379 @seealso
1380
1381 Dans ce manuel : @ref{Text marks}.
1382
1383 Référence du programme : @internalsref{RehearsalMark}.
1384
1385 Fichiers d'initialisation : @file{scm/@/translation@/-functions@/.scm}
1386 contient les définitions de @code{format-mark-numbers} et
1387 @code{format-mark-letters}.  Elles seront source d'inspiration pour
1388 d'autres fonctions de formatage.
1389
1390 Exemples : @lsr{parts,rehearsal-mark-numbers.ly}
1391
1392
1393 @node Special rhythmic concerns
1394 @subsection Special rhythmic concerns
1395
1396
1397 @menu
1398 * Grace notes::                 
1399 * Aligning to cadenzas::        
1400 * Time administration::         
1401 * Proportional notation (introduction)::  
1402 @end menu
1403
1404 @node Grace notes
1405 @unnumberedsubsubsec Grace notes
1406
1407 @funindex \grace
1408 @cindex ornements
1409 @cindex notes d'ornement
1410 @cindex appoggiature
1411 @cindex accacciature
1412 @cindex petite note
1413
1414
1415 Les petites notes sont des ornements entièrement écrits.  Les plus
1416 courantes sont les accacciatures, qui doivent se jouer très vite,
1417 et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
1418 et liée.  L'appoggiature est une petite note non barrée, qui vole
1419 une fraction à la durée de la note réelle qui la suit.
1420
1421 Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
1422 et @code{\appoggiatura}, comme le montre l'exemple suivant :
1423
1424 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1425 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
1426 \acciaccatura { g16[ f] } e4
1427 @end lilypond
1428
1429
1430 Ce sont là deux formes spéciales de la commande @code{\grace}, qui prend
1431 en charge toutes les petites notes. Si on la fait suivre d'une
1432 expression musicale, un groupe de petites notes sera créé, sans impact
1433 sur la métrique.
1434
1435 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1436 c4 \grace c16 c4
1437 \grace { c16[ d16] } c2 c4
1438 @end lilypond
1439
1440 @noindent
1441 Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
1442 commande @code{\grace} ne provoque pas de liaison.
1443
1444 La durée des petites notes est interprétée par le programme en fonction
1445 d'un deuxième compteur de temps, le chronomètre @code{grace}.  Chaque
1446 instant est défini par deux nombres rationnels : le premier compte les
1447 durées réelles, le second compte la durée des petites notes.  Reprenons
1448 l'exemple ci-dessus en y ajoutant ces couples de nombres :
1449
1450 @lilypond[quote,ragged-right]
1451 <<
1452   \relative c''{
1453     c4 \grace c16 c4 \grace {
1454     c16[ d16] } c2 c4
1455   }
1456   \new Lyrics \lyricmode {
1457     \override LyricText #'font-family = #'typewriter
1458
1459     \markup { (0,0) } 4
1460     \grace { \markup {
1461       ( \fraction 1 4 , \fraction -1 16 ) } 16 }
1462     \markup { (\fraction 1 4 , 0 ) } 4
1463     \grace {
1464       \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
1465       \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
1466     }
1467     \markup { ( \fraction 2 4 , 0 ) }
1468   }
1469 >>
1470 @end lilypond
1471
1472 Les petites notes se placent de façon synchrone entre les différentes
1473 portées.  Dans l'exemple suivant, il y a deux petites double-croches
1474 pour chaque petite croche.
1475
1476 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1477 << \new Staff { e4 \grace { c16[ d e f] } e4 }
1478    \new Staff { c4 \grace { g8[ b] } c4 } >>
1479 @end lilypond
1480
1481 @funindex \afterGrace
1482
1483 La commande @code{\afterGrace} sert à placer une petite note après une
1484 note réelle --- et non @emph{avant} comme d'ordinaire.  Cette commande
1485 requiert deux arguments : la note réelle, et la ou les petites notes qui
1486 suivent.
1487
1488 @lilypond[ragged-right, verbatim,relative=2,fragment]
1489 c1 \afterGrace d1 { c16[ d] } c4
1490 @end lilypond
1491
1492 Les petites notes se placent alors aux 3/4 de la durée de la note
1493 réelle.  Cette fraction peut être changée en définissant
1494 @code{afterGraceFraction} ; ainsi,
1495
1496 @example
1497 #(define afterGraceFraction (cons 7 8))
1498 @end example
1499
1500 @noindent
1501 placera la petite note à 7/8 de la note réelle.
1502
1503 On peut obtenir le même effet manuellement, de la façon suivante :
1504
1505 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1506 \new Voice {
1507   << { d1^\trill_( }
1508      { s2 \grace { c16[ d] } } >>
1509   c4)
1510 }
1511 @end lilypond
1512
1513 @noindent
1514 Le silence invisible peut être plus ou moins long --- ici c'est une
1515 demi-pause --- afin d'ajuster l'espace entre la note réelle et les
1516 petites notes.
1517
1518 Les expressions @code{\grace} obéissent à des règles typographiques
1519 particulières, notamment pour régler l'orientation et la taille des
1520 objets.  De ce fait, toute subtilité de mise en forme devra être
1521 indiquée @emph{à l'intérieur} de l'expression introduite par
1522 @code{\grace} :
1523
1524 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1525 \new Voice {
1526   \acciaccatura {
1527     \stemDown
1528     f16->
1529     \stemNeutral
1530   }
1531   g4
1532 }
1533 @end lilypond
1534
1535 @noindent
1536 Tous les réglages ajoutés doivent également être désactivés dans cette
1537 même expression.
1538
1539 Il est possible de changer globalement la mise en forme des petites
1540 notes dans un morceau, au moyen de la fonction
1541 @code{add-grace-property}.  Ici, par exemple, on ôte la définition de
1542 l'orientation des objets @code{Stem} pour toutes les petites notes, afin
1543 que les hampes ne soient pas toujours orientées vers le haut.
1544
1545 @example
1546 \new Staff @{
1547  #(add-grace-property 'Voice 'Stem 'direction '())
1548  @dots{}
1549 @}
1550 @end example
1551
1552 @noindent
1553 Il est par ailleurs possible de modifier les variables
1554 @code{startGraceMusic}, @code{stopGraceMusic},
1555 @code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
1556 @code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
1557 Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
1558
1559 @noindent
1560 Le trait que l'on trouve sur les hampes des accacciatures peut
1561 être appliqué dans d'autres situations en définissant @*
1562 @code{\override Stem  #'stroke-style = #"grace"}.
1563
1564
1565 @commonprop
1566
1567 Il est possible de forcer l'élasticité de l'espacement des notes d'agrément.
1568
1569 @lilypond[relative=2,ragged-right]
1570 <<
1571   \override Score.SpacingSpanner #'strict-grace-spacing = ##t
1572   \new Staff {
1573      c'4
1574      \afterGrace
1575      c'4
1576      { c'16[ c'8 c'16] }
1577      c'4
1578   }  
1579   \new Staff {
1580      c'16[ c'16 c'16 c'16]
1581      c'16[ c'16 c'16 c'16]
1582      c'4
1583   }
1584 >>
1585 @end lilypond
1586
1587
1588 @seealso
1589
1590 Référence du programme : @internalsref{GraceMusic}.
1591
1592
1593 @refbugs
1594
1595 Une partition commençant par une expression @code{\grace} doit faire
1596 intervenir la commande @code{\new Voice}, sans quoi la note réelle et
1597 la petite note se retrouveront sur des portées différentes.
1598
1599 La synchronisation des petites notes se fait de façon parfois
1600 surprenante, car les autres objets de la portée --- barres de mesure,
1601 armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
1602 mélez des portées comprenant des petites notes et d'autres sans :
1603
1604 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1605 << \new Staff { e4 \bar "|:" \grace c16 d4 }
1606    \new Staff { c4 \bar "|:" d4 } >>
1607 @end lilypond
1608
1609 @noindent
1610 Il est possible de remédier à cela en insérant sur les autres portées
1611 des silences invisibles dans une expression précédée de @code{\grace},
1612 correspondant à la durée des petites notes.
1613
1614 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1615 << \new Staff { e4 \bar "|:" \grace c16 d4 }
1616    \new Staff { c4 \bar "|:" \grace s16 d4 } >>
1617 @end lilypond
1618  
1619 Seules des expressions musicales séquentielles peuvent être utilisées
1620 pour des petites notes ; il n'est pas possible d'imbriquer ni de
1621 juxtaposer des sections de petites notes, faute de quoi le traitement du
1622 code peut échouer ou produire des erreurs.
1623
1624
1625 @node Aligning to cadenzas
1626 @unnumberedsubsubsec Aligning to cadenzas
1627
1628 Dans un contexte orchestral, une cadence constitue un problème
1629 spécifique.  Lors du montage d'une partition contenant une cadence,
1630 tous les autres instruments doivent sauter autant de notes que ce
1631 qu'en comporte la cadence, faute de quoi il démarreraient trop tôt ou
1632 trop tard. 
1633
1634 Les fonctions @code{mmrest-of-length} ou @code{skip-of-length}
1635 permettent de résoudre ce problème.  Ces fonctions Scheme prennent en
1636 argument un fragment de musique, et génèrent un @code{\skip} ou un
1637 silence multi-mesures d'une durée correspondant à ce fragment.
1638 L'exemple qui suit illustre l'utilisation de @code{mmrest-of-length}. 
1639
1640 @lilypond[verbatim,ragged-right,quote]
1641 cadenza = \relative c' {
1642   c4 d8 << { e f g } \\ { d4. } >>
1643   g4 f2 g4 g
1644 }
1645
1646 \new GrandStaff <<
1647   \new Staff { \cadenza c'4 }
1648   \new Staff {
1649     #(ly:export (mmrest-of-length cadenza))
1650     c'4
1651   }
1652 >>
1653 @end lilypond
1654
1655
1656 @node Time administration
1657 @unnumberedsubsubsec Time administration
1658
1659 @cindex temps, gestion du
1660
1661 Le temps est administré par le @internalsref{Time_signature_engraver},
1662 qui réside en principe dans le contexte @internalsref{Score}.  Sa
1663 gestion traite les variables suivantes :
1664
1665 @table @code
1666 @item currentBarNumber
1667 Le numéro de mesure.
1668
1669 @item measureLength
1670 La longueur de la mesure, dans la métrique en cours.  Pour une mesure
1671 à 4/4, elle est de@tie{}1, et de 3/4 pour une mesure à 6/8.
1672
1673 @item measurePosition
1674 Le moment où l'on en est dans la mesure en cours.  Cette quantité est
1675 remise à@tie{}0 dès lors qu'on dépasse @code{measureLength} ; la variable
1676 @code{currentBarNumber} est alors incrémentée.  
1677
1678 @item timing
1679 Lorsqu'on lui assigne la valeur @emph{vrai}, les valeurs ci-dessus
1680 mentionnées sont mises à jour à chaque pas.  Fixée à @emph{faux}, le
1681 graveur restera indéfiniment dans la mesure en cours.
1682 @end table
1683
1684 Le calage peut être modifié en réglant explicitement l'une de ces
1685 variables.  Dans l'exemple qui suit, nous réglons la métrique à 4/4,
1686 tout en fixant @code{measureLength} à 5/4.  Un peu plus loin, nous
1687 raccourcissons la mesure de 1/8, en assignant 7/8 à
1688 @code{measurePosition}, alors que nous en sommes à 2/4 dans la
1689 mesure ; la barre de mesure tombera donc à @w{2/4 + 3/8}.  Les 3/8
1690 résultent du fait que 5/4 équivaut à 10/8, mais nous nous sommes recalés
1691 à 7/8 de la mesure ;  donc @w{10/8 @minus{} 7/8 = 3/8}.
1692
1693 @lilypond[quote,ragged-right,verbatim,relative,fragment]
1694 \set Score.measureLength = #(ly:make-moment 5 4)
1695 c1 c4
1696 c1 c4
1697 c4 c4
1698 \set Score.measurePosition = #(ly:make-moment 7 8)
1699 b8 b b
1700 c4 c1
1701 @end lilypond
1702
1703 @noindent
1704 Comme le montre cet exemple, @code{ly:make-moment n m} construit une
1705 durée de n/m fois une ronde.  
1706 Par conséquent, @code{ly:make-moment 1 8} correspond à une croche, et
1707 @code{ly:make-moment 7 16} à la durée de sept doubles croches.
1708
1709
1710 @node Proportional notation (introduction)
1711 @unnumberedsubsubsec Proportional notation (introduction)
1712 @cindex Notation proportionnelle
1713
1714 Voir @ref{Proportional notation}.
1715
1716
1717 @c À faire : supprimer tout ça ?
1718
1719 Les notes peuvent s'espacer proportionnellement en assignant une durée
1720 à @code{proportionalNotationDuration}
1721
1722 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
1723 <<
1724   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
1725   \new Staff { c8[ c c c c c]  c4 c2 r2 }
1726   \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
1727 >>
1728 @end lilypond
1729
1730 Manipuler cette propriété affectera l'espacement idéal uniquement pour
1731 des notes consécutives.  Pour obtenir une véritable notation
1732 proportionnelle, vous devrez tenir compte des réglages suivants :
1733
1734 @itemize @bullet
1735
1736 @item La véritable notation proportionnelle exige que des symboles
1737 puissent en écraser d'autres.  Pour y parvenir, il faut retirer le
1738 @internalsref{Separating_line_group_engraver} du contexte
1739 @internalsref{Staff}. 
1740
1741 @item L'influence en matière d'espacement induite par le formatage
1742 (clés, barres de mesure, etc) s'annule en assignant
1743 @emph{vrai}@tie{}(#t) à la propriété @code{strict-note-spacing} de
1744 l'objet @internalsref{SpacingSpanner}.
1745
1746 @item Les affinages optiques se règlent en assignant @emph{vrai} à la
1747 propriété @code{uniform-stretching} du @internalsref{SpacingSpanner}. 
1748
1749
1750 @end itemize
1751
1752 @seealso
1753
1754 Exemples : @lsr{spacing,proportional@/-spacing@/.ly}, 
1755 @lsr{spacing,proportional@/-strict@/-grace@/-notes@/.ly}, et
1756 @lsr{spacing,proportional@/-strict@/-notespacing@/.ly}
1757
1758 Le fichier @file{input/proportional.ly} illustre la notation
1759 proportionnelle stricte.
1760
1761