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