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