]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/user/rhythms.itely
Merge branch 'lilypond/translation' of ssh://trettig@git.sv.gnu.org/srv/git/lilypond...
[lilypond.git] / Documentation / fr / user / rhythms.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
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 * Showing melody rhythms::      
534 @end menu
535
536 @node Time signature
537 @subsubsection Time signature
538
539 @cindex chiffrage de mesure
540 @cindex chiffre indicateur de mesure
541 @cindex métrique
542 @funindex \time
543
544 Le chiffre de mesure indique le mètre d'une pièce : une alternance
545 régulière de temps forts et de temps faibles.  Il est indiqué par une
546 fraction au début de la portée.
547
548 Le chiffre de mesure est réglé par la commande @code{\time}.
549
550 @lilypond[quote,ragged-right,fragment,verbatim]
551 \time 2/4 c'2 \time 3/4 c'2.
552 @end lilypond
553
554 @commonprop
555
556 Le symbole imprimé peut être modifié avec la propriété @code{style}.
557 En la réglant sur @code{#'()}, une fraction sera utilisée pour les
558 chiffres de mesure 4/4 et 2/2.
559
560 @lilypond[fragment,quote,ragged-right,verbatim]
561 \time 4/4 c'1
562 \time 2/2 c'1
563 \override Staff.TimeSignature #'style = #'()
564 \time 4/4 c'1
565 \time 2/2 c'1
566 @end lilypond
567
568 Il y a bien d'autres options pour sa mise en place.  Voir @ref{Ancient time
569 signatures} pour plus d'exemples.
570
571 @code{\time} définit les propriétés @code{timeSignatureFraction},
572 @code{beatLength} et @code{measureLength} dans le contexte
573 @code{Timing}, qui en principe est assimilé à @rinternals{Score}.  La
574 propriété @code{measureLength} détermine où des barres de mesure doivent
575 être insérées, et comment les groupements de notes doivent être gérés.
576 La modification de la valeur de @code{timeSignatureFraction} donne
577 également lieu à l'impression d'un symbole.
578
579 Plus d'options sont accessibles au moyen de la fonction Scheme
580 @code{set-time-signature}.  De concert avec le
581 @rinternals{Measure_grouping_engraver}, elle crée les signes de
582 @rinternals{MeasureGrouping}, qui facilitent la lecture de musiques
583 modernes, complexes rythmiquement.  Dans l'exemple suivant, les mesures
584 à 9/8 sont subdivisées en @code{(2 2 2 3)}, ce qui est donné comme
585 argument à la commande @code{set-time-signature}, en troisième position.
586
587 @lilypond[quote,ragged-right,verbatim]
588 \score {
589   \relative c'' {
590     #(set-time-signature 9 8 '(2 2 2 3))
591     g8[ g] d[ d] g[ g] a8[( bes g]) |
592     #(set-time-signature 5 8 '(3 2))
593     a4. g4
594   }
595   \layout {
596     \context {
597       \Staff
598       \consists "Measure_grouping_engraver"
599     }
600   }
601 }
602 @end lilypond
603
604
605 @seealso
606
607 Référence du programme : @rinternals{TimeSignature} et
608 @rinternals{Timing_translator}.
609
610 Exemples : @rlsr{Rhythms}.
611
612
613 @knownissues
614
615 Le groupement automatique des ligatures n'utilise pas les groupements
616 spécifiés par @code{set-time-signature}.
617
618
619 @node Upbeats
620 @subsubsection Upbeats
621
622 @cindex anacrouse
623 @cindex levée
624 @cindex mesure incomplète
625 @funindex \partial
626
627
628 Les mesures incomplètes, telles que les anacrouses ou levées, doivent
629 être entrées avec la commande
630
631 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
632 \partial 16*5 c16 cis d dis e | a2. c,4 | b2
633 @end lilypond
634
635
636 La syntaxe de cette commande est
637
638 @example
639 \partial @var{durée}
640 @end example
641
642 @code{durée} étant la valeur rythmique devant être ajoutée avant la
643 mesure suivante.
644
645 Le programme traduit cette commande en
646
647 @example
648 \set Timing.measurePosition = -@var{durée}
649 @end example
650
651
652 La propriété @code{measurePosition} contient un nombre rationnel qui
653 indique, à ce point précis, où l'on en est de la mesure. Notez qu'il
654 peut s'agir d'un nombre négatif ; @code{\partial 4} signifie, pour le
655 programme : @qq{Dans cette mesure, il reste juste une noire}.
656
657
658 @knownissues
659
660 Cette commande ne prend pas en compte les notes d'ornement ou
661 appoggiatures au début de la musique. Lorsqu'un morceau commence par une
662 levée et avec des petites notes, la commande @code{\partial} devrait être
663 placée après celles-ci.
664
665 @lilypond[verbatim,quote,ragged-right,relative,fragment]
666 \grace f16
667 \partial 4
668 g4
669 a2 g2
670 @end lilypond
671
672 @code{\partial} n'est destiné à être utilisé qu'en début de pièce.
673 Si on l'utilise ailleurs qu'au début, des messages d'erreurs peuvent
674 s'afficher.
675
676
677 @node Unmetered music
678 @subsubsection Unmetered music
679
680 @cindex cadence
681 @funindex \cadenzaOn
682 @funindex \cadenzaOff
683
684
685 Les barres de mesure et les numéros de mesure sont calculés
686 automatiquement, ce qui n'est pas souhaitable dans le cas d'une musique
687 non mesurée --- les cadences, par exemple. Les commandes
688 @code{\cadenzaOn} et @code{\cadenzaOff} permettent de désactiver et de
689 rétablir la métrique automatique.
690
691 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
692 c4 d e d
693 \cadenzaOn
694 c4 c d8 d d f4 g4.
695 \cadenzaOff
696 \bar "|"
697 d4 e d c
698 @end lilypond
699
700
701 @knownissues
702
703 LilyPond ne change de ligne ou de page qu'au niveau des barres de
704 mesure.  Si votre musique non mesurée dure plus d'une ligne, il vous
705 faudra insérer des barres de mesure invisibles, pour indiquer à quels
706 endroit un saut de ligne peut intervenir.
707
708 @example
709 \bar ""
710 @end example
711
712
713 @node Polymetric notation
714 @subsubsection Polymetric notation
715
716 @cindex métrique composite
717 @cindex composite, métrique
718 @cindex métrique polymétrique
719 @cindex polymétrie
720
721 LilyPond ne gère pas les métriques composites de manière explicite,
722 mais on peut contourner ce problème.  Dans l'exemple suivant,
723 l'indicateur de métrique est obtenu grâce à une étiquette textuelle.
724 Cette étiquette vient s'insérer dans l'objet graphique (@emph{grob})
725 @rinternals{TimeSignature}.
726
727 @lilypond[verbatim,ragged-right]
728 % Create 9/8 split into 2/4 + 5/8
729 tsMarkup = \markup {
730   \override #'(baseline-skip . 2) \number {
731     \column { "2" "4" }
732     \vcenter "+"
733     \bracket \column { "5" "8" }
734   }
735 }
736
737 {
738   \override Staff.TimeSignature #'stencil =
739     #ly:text-interface::print
740   \override Staff.TimeSignature #'text = #tsMarkup
741   \time 9/8
742   c'2 \bar ":" c'4 c'4.
743   c'2 \bar ":" c'4 c'4.
744 }
745 @end lilypond
746
747 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
748 {compound-time-signatures.ly}
749
750 Il arrive aussi que chaque portée ait sa propre métrique.  Vous y
751 parviendrez en déplaçant le @rinternals{Timing_translator} dans le
752 contexte @rinternals{Staff}.
753
754 @example
755 \layout @{
756   \context @{ \Score
757      \remove "Timing_translator"
758      \remove "Default_bar_line_engraver"
759   @}
760   \context @{
761     \Staff
762     \consists "Timing_translator"
763     \consists "Default_bar_line_engraver"
764   @}
765
766 @}
767 @end example
768
769
770 Maintenant, chacune des portées dispose de sa propre métrique.
771 @example
772 <<
773   \new Staff @{
774     \time 3/4
775     c4 c c | c c c |
776   @}
777   \new Staff @{
778     \time 2/4
779     c4 c | c c | c c
780   @}
781   \new Staff @{
782     \time 3/8
783     c4. c8 c c c4. c8 c c
784   @}
785 >>
786 @end example
787
788 @lilypond[quote,ragged-right]
789 \layout{
790   \context{
791      \Score
792      \remove "Timing_translator"
793      \remove "Default_bar_line_engraver"
794     }
795   \context{ \Staff
796     \consists "Timing_translator"
797     \consists "Default_bar_line_engraver"
798   }
799 }
800
801 \relative c' <<
802   \new Staff {
803     \time 3/4
804     c4 c c | c c c |
805   }
806   \new Staff {
807     \time 2/4
808     c4 c | c c | c c
809   }
810   \new Staff {
811     \time 3/8
812     c4. c8 c c c4. c8 c c
813   }
814 >>
815 @end lilypond
816
817
818 Une autre forme de notation polymétrique consiste dans le fait que des
819 notes aient une durée relative différente selon la portée.  
820
821 Vous pouvez créer une telle notation en définissant une métrique
822 commune à toutes les portées,  que vous proratiserez manuellement
823 selon le cas en utilisant @code{timeSignatureFraction} pour obtenir la
824 division adéquate pour chaque portée.  Les durées, dans chacune des
825 portées, seront alors échelonnées par rapport à la métrique commune.
826 L'échelle de représentation se règle avec @code{\scaleDurations} ---
827 qui fonctionne comme @code{\times}, sans toutefois créer de crochet.
828 La syntaxe appropriée est :
829 @example
830 \scaleDurations #'(@var{numérateur} . @var{dénominateur}) @var{exprmusicale}
831 @end example
832
833
834 L'exemple suivant utilise parallèlement des mesures à 3/4, 9/8 et
835 10/8.  Pour la deuxième portée, les durées sont multipliées par 2/3,
836 de telle sorte que @w{2/3 * 9/8 = 3/4} ; pour la troisième, elles sont
837 multipliées par 3/5, de telle sorte que @w{3/5 * 10/8 = 3/4}.
838
839 @lilypond[quote,ragged-right,verbatim,fragment]
840 \relative c' { <<
841   \new Staff {
842     \time 3/4
843     c4 c c | c c c |
844   }
845   \new Staff {
846     \time 3/4
847     \set Staff.timeSignatureFraction = #'(9 . 8)
848     \scaleDurations #'(2 . 3)
849       \repeat unfold 6 { c8[ c c] }
850   }
851   \new Staff {
852     \time 3/4
853     \set Staff.timeSignatureFraction = #'(10 . 8)
854     \scaleDurations #'(3 . 5) {
855       \repeat unfold 2 { c8[ c c] }
856       \repeat unfold 2 { c8[ c] }
857       | c4. c4. \times 2/3 { c8 c c } c4
858     }
859   }
860 >> }
861 @end lilypond
862
863 @seealso
864
865 Exemples : @rlsr{Rhythms}.
866
867 @knownissues
868
869 L'utilisation de métriques différentes en parallèle entraine un
870 alignement vertical.  De ce fait, les barres de mesure ont tendance à
871 fausser l'espacement régulier.
872
873
874 @node Automatic note splitting
875 @subsubsection Automatic note splitting
876
877 On peut convertir automatiquement les notes longues en notes liées.  Il
878 faut pour cela remplacer le graveur @rinternals{Note_heads_engraver}
879 par le graveur @rinternals{Completion_heads_engraver}.  Dans les
880 exemples suivants, les notes dépassant de la mesure sont divisées et
881 liées.
882
883 @lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
884 \new Voice \with {
885   \remove "Note_heads_engraver"
886   \consists "Completion_heads_engraver"
887 } {
888   c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
889 }
890 @end lilypond
891
892 Ce graveur divise toutes les notes qui sortent de la mesure, et insère
893 des liaisons de prolongation.  Une utilisation posible consiste à
894 déboguer des partitions complexes : si les mesures ne sont pas
895 entièrement remplies, alors les liaisons de prolongation montrent
896 exactement la durée des décalages de mesure.
897
898 Si vous voulez permettre un saut de ligne aux barres de mesure où
899 @rinternals{Completion_heads_engraver} divise les notes, vous devez
900 aussi enlever @rinternals{Forbid_line_break_engraver}.
901
902
903 @knownissues
904
905 Bien que toutes les durées --- particulièrement celles contenant des
906 nolets --- ne puissent pas être représentées exactement avec des notes
907 normales et des points, le graveur n'insèrera pas de nolets.
908
909 @code{Completion_heads_engraver} affecte seulement les notes, il ne
910 divise pas les silences.
911
912 @seealso
913
914 Référence du programme : @rinternals{Completion_heads_engraver}.
915
916 @node Showing melody rhythms
917 @subsubsection Showing melody rhythms
918
919 Au moyen d'une portée rythmique -- @q{rhythmic staff} en anglais -- on
920 peut montrer seulement le rythme d'une mélodie : toutes les notes sont
921 ramenées à la même hauteur, sur une portée d'une seule ligne.
922
923 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
924 \new RhythmicStaff {
925   \time 4/4
926   c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
927 }
928 @end lilypond
929
930 @seealso
931
932 Référence du programme : @rinternals{RhythmicStaff}.
933
934 @node Beams
935 @subsection Beams
936
937 @menu
938 * Automatic beams::             
939 * Manual beams::                
940 * Feathered beams::             
941 @end menu
942
943 @node Automatic beams
944 @subsubsection Automatic beams
945
946 LilyPond décide automatiquement de la manière de grouper les notes et
947 d'imprimer les ligatures.
948
949 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
950 \time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
951 @end lilypond
952
953 Lorsque ce comportement automatisé n'est pas satisfaisant, on peut
954 définir des groupements manuellement --- voir section suivante --- ou
955 personnaliser les groupements automatiques --- voir @ref{Setting
956 automatic beam behavior}.
957
958 La commande @code{\noBeam} peut servir à empêcher des notes
959 individuelles d'être rattachées aux autres.
960
961 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
962 \time 2/4 c8 c\noBeam c c
963 @end lilypond
964
965
966 @seealso
967
968 Référence du programme : @rinternals{Beam}.
969
970
971 @node Manual beams
972 @subsubsection Manual beams
973
974 @cindex groupements de note manuels
975 @cindex ligatures manuelles
976 @funindex ]
977 @funindex [
978
979 Dans certaines situations, il peut s'avérer nécessaire de
980 supplanter l'algorithme de groupement automatique des notes, par
981 exemple pour prolonger une ligature par-dessus un silence ou une barre
982 de mesure.  Le début et la fin de la ligature sont alors indiqués par
983 @code{[} et @code{]}.
984
985 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
986 {
987   r4 r8[ g' a r8] r8 g[ | a] r8
988 }
989 @end lilypond
990
991
992 @commonprop
993
994 @funindex stemLeftBeamCount
995 @funindex stemRightBeamCount
996
997 LilyPond peut déterminer automatiquement les sous-groupes à
998 l'intérieur d'un groupement de notes, bien que le résultat ne soit pas 
999 toujours optimal.  Les propriétés @code{stemLeftBeamCount} et
1000 @code{stemRightBeamCount} permettent alors
1001 d'ajuster ce comportement.  Lorsque l'une ou l'autre de ces propriétés
1002 est définie, elle ne s'applique qu'une seule fois, après quoi sa
1003 définition est effacée.
1004
1005 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
1006 {
1007    f8[ r16
1008       f g a]
1009    f8[ r16
1010    \set stemLeftBeamCount = #1
1011       f g a]
1012 }
1013 @end lilypond
1014
1015 La propriété @code{subdivideBeams} sert à grouper les double-croches
1016 ou les valeurs plus brèves pulsation par pulsation, la pulsation
1017 étant définie par la propriété @code{beatLength}.
1018
1019 @lilypond[fragment,quote,relative=2,verbatim]
1020 c16[ c c c c c c c]
1021 \set subdivideBeams = ##t
1022 c16[ c c c c c c c]
1023 \set Score.beatLength = #(ly:make-moment 1 8)
1024 c16[ c c c c c c c]
1025 @end lilypond
1026 @funindex subdivideBeams
1027
1028 @noindent
1029 Pour plus d'information sur @code{make-moment}, voir
1030 @ref{Time administration}.
1031
1032 Lorsqu'une ligature franchit une barre de mesure, le saut
1033 de ligne est en principe interdit à cet endroit.  Ce comportement peut
1034 être outrepassé en définissant @code{breakable}.
1035
1036 @funindex breakable
1037
1038 @cindex ligatures et sauts de ligne
1039 @cindex ligatures coudées
1040 @cindex auto-knee-gap
1041
1042 LilyPond insère automatiquement des ligatures coudées --- certaines
1043 notes vers le haut, d'autres vers le bas --- lorsqu'il détecte un espace
1044 important entre des têtes de notes. Ce comportement peut être changé par
1045 l'intermédiaire de l'objet @code{auto-knee-gap}
1046
1047
1048 @knownissues
1049
1050 Les ligatures coudées à cheval sur deux portées ne peuvent être
1051 employées en même temps que des portées invisibles.  Voir
1052 @ref{Hiding staves}.
1053
1054 @c Is this still true with skyline spacing stuff? -J.Mandereau
1055 Les ligatures peuvent entrer en collision avec des symboles entourant
1056 les notes, contrairement aux textes ou aux altérations.
1057
1058
1059 @node Feathered beams
1060 @subsubsection Feathered beams
1061
1062 Les ligatures en soufflet s'obtiennent en définissant la propriété
1063 @code{grow-direction} d'une barre de ligature.  La fonction
1064 @code{\featherDurations} sert à ajuster la durée des notes.
1065
1066 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
1067 \override Beam #'grow-direction = #LEFT
1068 \featherDurations #(ly:make-moment 5 4) 
1069 {
1070   c16[ c c c c c c]
1071 }
1072 @end lilypond
1073
1074 @knownissues
1075
1076 La commande @code{\featherDurations} ne permet de traiter que de très
1077 courts extraits.
1078
1079
1080 @node Bars
1081 @subsection Bars
1082
1083
1084 @menu
1085 * Bar check::                   
1086 * Bar lines::                   
1087 * Bar numbers::                 
1088 * Barnumber check::             
1089 * Rehearsal marks::             
1090 @end menu
1091
1092 @node Bar check
1093 @subsubsection Bar check
1094
1095 @cindex vérification des limites de mesure
1096 @cindex mesures, vérification des limites
1097 @funindex barCheckSynchronize
1098 @funindex |
1099
1100 Les tests de limites de mesure (ou tests de mesure) aident à détecter
1101 les erreurs dans les durées.  Un test de mesure s'écrit avec une barre
1102 verticale, @samp{|}.  Lors du traitement, elle doit correspondre à une
1103 barre de mesure.  Sinon, un avertissement est émis.  Dans l'exemple
1104 suivant, le deuxième test de mesure signale une erreur.
1105 @example
1106 \time 3/4 c2 e4 | g2 |
1107 @end example
1108
1109 Le test de mesure peut être aussi utilisé dans les paroles, par exemple :
1110 @example
1111 \lyricmode @{
1112  \time 2/4
1113  Twin -- kle | Twin -- kle
1114 @}
1115 @end example
1116
1117 Des durées incorrectes font échouer les tests de mesure, et peuvent
1118 souvent mettre la partition sens dessus dessous, particulièrement s'il
1119 s'agit de musique polyphonique.  Vérifier les tests de mesure qui ont
1120 échoué et les durées incorrectes est un bon moyen de commencer à
1121 corriger sa partition.
1122
1123 @funindex |
1124 @funindex pipeSymbol
1125
1126 Il est aussi possible d'attribuer une autre valeur au symbole
1127 @code{|}, en assignant une expression musicale à @code{pipeSymbol},
1128
1129 @lilypond[quote,ragged-right,verbatim]
1130 pipeSymbol = \bar "||"
1131
1132 { c'2 c' | c'2 c' }
1133 @end lilypond
1134
1135
1136 @node Bar lines
1137 @subsubsection Bar lines
1138
1139 @cindex barres de mesure
1140 @funindex \bar
1141 @cindex barres de reprise
1142
1143
1144 Les barres de mesures délimitent les mesures, mais peuvent aussi
1145 indiquer une reprise. En principe, elles sont insérées automatiquement,
1146 et les sauts de ligne ne peuvent avoir lieu qu'au niveau de ces barres.
1147
1148 Il est possible de forcer l'impression d'une barre de mesure spéciale,
1149 avec la commande @code{\bar} :
1150
1151 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1152 c4 \bar "|:" c4
1153 @end lilypond
1154
1155
1156 Les styles de barres de mesure disponibles sont
1157
1158 @c @lilypondfile[ragged-right,quote]{bar-lines.ly}
1159
1160
1161 En plus de cela, on peut demander @code{"||:"}, qui équivaut à
1162 @code{"|:"}, mais qui donnera, en cas de saut de ligne, une double barre
1163 en fin de ligne, et une barre de reprise au début de la ligne suivante.
1164
1165 Il est possible d'autoriser un saut de ligne même s'il n'y a pas
1166 de barre de mesure visible, en utilisant :
1167
1168 @example
1169 \bar ""
1170 @end example
1171
1172 @noindent
1173
1174
1175 Ceci insérera une barre de mesure invisible, et permettra de sauter de
1176 ligne à cet endroit, sans incrémenter le numéro de mesure.
1177
1178
1179 Dans une partition comprenant plusieurs portées, la commande @code{\bar}
1180 placée sur une portée s'applique automatiquement à toutes les
1181 portées. Les barres de mesure que l'on obtient alors sont d'un seul
1182 tenant sur les portées d'un @code{StaffGroup}, d'un @code{PianoStaff} ou
1183 d'un @code{GrandStaff}.
1184
1185 @lilypond[quote,ragged-right,fragment,verbatim]
1186 <<
1187   \new StaffGroup <<
1188     \new Staff {
1189       e'4 d'
1190       \bar "||"
1191       f' e'
1192     }
1193     \new Staff { \clef bass c4 g e g }
1194   >>
1195   \new Staff { \clef bass c2 c2 }
1196 >>
1197 @end lilypond
1198
1199
1200 @commonprop
1201
1202 @funindex whichBar
1203 @funindex repeatCommands
1204 @funindex defaultBarType
1205
1206
1207 La commande @code{\bar }@var{bartype} sert de raccourci pour @code{\set
1208 Timing.whichBar = }@var{bartype}.  Dès que l'on définit @code{whichBar},
1209 une barre de mesure est créée selon le style défini.
1210
1211
1212 Dès que la propriété @code{whichBar} est définie, une barre de mesure
1213 est créée.  À chaque début de mesure, elle prend la valeur de
1214 @code{Timing.defaultBarType}.  La valeur de @code{repeatCommands} sert à
1215 remplacer les barres de mesure par défaut.
1216
1217 Nous vous invitons à utiliser @code{\repeat} pour indiquer les
1218 reprises. Voyez à ce sujet @ref{Repeats}.
1219
1220
1221 @seealso
1222
1223 Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
1224
1225 Référence du programme : @rinternals{BarLine} (faisant partie du
1226 contexte @rinternals{Staff}), @rinternals{SpanBar} (sur plusieurs
1227 portées).
1228
1229
1230 @node Bar numbers
1231 @subsubsection Bar numbers
1232
1233 @cindex Mesure, numéro de
1234 @cindex numéros de mesure
1235 @funindex currentBarNumber
1236
1237 Les numéros de mesure sont imprimés par défaut à chaque début de
1238 ligne.  Ce nombre est stocké par la propriété @code{currentBarNumber}
1239 qui sera mis à jour à chaque mesure.
1240
1241 @lilypond[verbatim,ragged-right,quote,fragment,relative]
1242 \repeat unfold 4 {c4 c c c} \break
1243 \set Score.currentBarNumber = #50
1244 \repeat unfold 4 {c4 c c c}
1245 @end lilypond
1246
1247 L'impression d'un numéro de mesure ne peut intervenir que s'il y a une
1248 barre.  Aussi, pour pouvoir le faire au début d'un morceau,
1249 devrez-vous ajouter une barre vide :
1250
1251 @lilypond[verbatim,ragged-right,quote,fragment,relative]
1252 \set Score.currentBarNumber = #50
1253 \bar ""
1254 \repeat unfold 4 {c4 c c c} \break
1255 \repeat unfold 4 {c4 c c c}
1256 @end lilypond
1257
1258 Vous pouvez imprimer un numéro de mesure à intervalles réguliers plutôt
1259 qu'en tête de chaque ligne.  C'est ce qu'illustre l'exemple suivant.
1260
1261 @lilypond[verbatim,ragged-right,quote,fragment,relative]
1262 \override Score.BarNumber #'break-visibility = ##(#f #t #t)
1263 \set Score.currentBarNumber = #11
1264 \bar ""  % Permit first bar number to be printed
1265 % Print a bar number every second measure
1266 \set Score.barNumberVisibility = #(every-nth-bar-number-visible 2)
1267 c1 c c c c
1268 \break
1269 c c c c c
1270 @end lilypond
1271
1272
1273 Désactiver le graveur concerné --- @code{Bar_number_engraver} ---
1274 donnera une partition sans numéros de mesure.
1275
1276 @lilypond[verbatim,ragged-right,quote]
1277 \layout {
1278   \context {
1279     \Score
1280     \remove "Bar_number_engraver"
1281   }
1282 }
1283 \relative c''{
1284 c4 c c c \break
1285 c4 c c c
1286 }
1287 @end lilypond
1288
1289
1290 @seealso
1291
1292 Référence du programme : @rinternals{BarNumber}.
1293
1294 Exemples : @rlsr{Staff notation}.
1295
1296
1297 @knownissues
1298
1299 Les numéros de mesure peuvent entrer en collision avec les crochets de
1300 @rinternals{StaffGroup}. La propriété @code{padding} --- décalage
1301 --- de l'objet @rinternals{BarNumber} permet alors d'ajuster leur
1302 positionnement. 
1303
1304
1305 @node Barnumber check
1306 @subsubsection Barnumber check
1307
1308 Lorsque l'on recopie de longues pièces, il peut être utile de vérifier
1309 que les numéros de mesures de LilyPond correspondent à l'original que
1310 l'on recopie.  Cela se fait avec @code{\barNumberCheck}.  Par exemple,
1311
1312 @verbatim
1313 \barNumberCheck #123
1314 @end verbatim
1315
1316 @noindent
1317 affiche un avertissement lors du traitement si le numéro de mesure à ce
1318 point (variable @code{currentBarNumber}) n'est pas 123.
1319
1320
1321 @node Rehearsal marks
1322 @subsubsection Rehearsal marks
1323
1324 @cindex Repères, indication de
1325 @funindex \mark
1326
1327 Indiquer un repère s'obtient grâce à la commande @code{\mark}.
1328
1329 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1330 c1 \mark \default
1331 c1 \mark \default
1332 c1 \mark #8
1333 c1 \mark \default
1334 c1 \mark \default
1335 @end lilypond
1336
1337 @noindent
1338 La lettre@tie{}@q{I} n'est pas utilisée, conformément aux usages de la
1339 gravure.  Cependant, vous pourrez intégrer la lettre @q{I} en utilisant
1340
1341 @example
1342 \set Score.markFormatter = #format-mark-alphabet
1343 @end example
1344
1345 Lorsque vous utilisez @code{\mark \default}, le repère s'incrémente
1346 automatiquement ; toutefois donner un nombre en argument permet de
1347 spécifier manuellement le repère en question.  La valeur à utiliser
1348 est enregistrée dans la propriété @code{rehearsalMark}.
1349
1350 Le style du repère est déterminé par la propriété
1351 @code{markFormatter}.  Il s'agit d'une fonction qui prend en arguments
1352 le repère en cours (un entier) ainsi que le contexte en cours, et
1353 retournera un objet de type étiquette.  Dans l'exemple qui suit,
1354 @code{markFormatter} est réglé pour une procédure type. Quelques
1355 mesure plus loin, son comportement est modifié pour imprimer un
1356 repère encadré.
1357
1358 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
1359 \set Score.markFormatter = #format-mark-numbers
1360 c1 \mark \default
1361 c1 \mark \default
1362 \set Score.markFormatter = #format-mark-box-numbers
1363 c1 \mark \default
1364 c1 \mark \default
1365 c1
1366 @end lilypond
1367
1368 Le fichier @file{scm/@/translation@/-functions@/.scm} comporte les
1369 définitions de @code{format-mark-numbers} (comportement par défaut), 
1370 @code{format-mark-box-numbers},
1371 @code{format-mark-letters} et @code{format-mark-box-letters}.  Vous
1372 pouvez vous en inspirer pour d'autres fonctions de formatage.
1373
1374 @code{format-mark-barnumbers}, @code{format-mark-box-barnumbers} et 
1375 @code{format-mark-circle-barnumbers}  permettent d'imprimer le numéro
1376 de mesure au lieu des compteurs alphabétique ou numérique.
1377
1378 On peut aussi spécifier manuellement une marque de repère :
1379
1380 @example
1381 \mark "A1"
1382 @end example
1383
1384 @noindent
1385 @code{Score.markFormatter} sera sans effet sur des repères ainsi
1386 définis.  Un @code{\markup} peut néanmoins s'utiliser en argument.
1387
1388 @example
1389 \mark \markup@{ \box A1 @}
1390 @end example
1391
1392 @cindex segno
1393 @cindex coda
1394 @cindex D.S al Fine
1395
1396 Un @code{\mark} peut contenir un glype musical tel que le signe
1397 @emph{segno}.  
1398
1399 @lilypond[fragment,quote,ragged-right,verbatim,relative]
1400 c1 \mark \markup { \musicglyph #"scripts.segno" }
1401 c1 \mark \markup { \musicglyph #"scripts.coda" }
1402 c1 \mark \markup { \musicglyph #"scripts.ufermata" }
1403 c1
1404 @end lilypond
1405
1406 @noindent
1407 Pour connaître les différents symboles accessibles par
1408 @code{\musicglyph}, consultez @ref{The Feta font}.
1409
1410 Pour affiner le positionnement des repères, veuillez vous référer à
1411 @ref{Text marks}.
1412
1413 @seealso
1414
1415 Dans ce manuel : @ref{Text marks}.
1416
1417 Référence du programme : @rinternals{RehearsalMark}.
1418
1419 Fichiers d'initialisation : @file{scm/@/translation@/-functions@/.scm}
1420 contient les définitions de @code{format-mark-numbers} et
1421 @code{format-mark-letters}.  Elles seront source d'inspiration pour
1422 d'autres fonctions de formatage.
1423
1424 Exemples : @rlsr{Rhythms}, @rlsr{Expressive marks}.
1425
1426
1427 @node Special rhythmic concerns
1428 @subsection Special rhythmic concerns
1429
1430
1431 @menu
1432 * Grace notes::                 
1433 * Aligning to cadenzas::        
1434 * Time administration::         
1435 * Proportional notation (introduction)::  
1436 @end menu
1437
1438 @node Grace notes
1439 @subsubsection Grace notes
1440
1441 @funindex \grace
1442 @cindex ornements
1443 @cindex notes d'ornement
1444 @cindex appoggiature
1445 @cindex accacciature
1446 @cindex petite note
1447
1448
1449 Les petites notes sont des ornements entièrement écrits.  Les plus
1450 courantes sont les accacciatures, qui doivent se jouer très vite,
1451 et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
1452 et liée.  L'appoggiature est une petite note non barrée, qui vole
1453 une fraction à la durée de la note réelle qui la suit.
1454
1455 Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
1456 et @code{\appoggiatura}, comme le montre l'exemple suivant :
1457
1458 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1459 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
1460 \acciaccatura { g16[ f] } e4
1461 @end lilypond
1462
1463
1464 Ce sont là deux formes spéciales de la commande @code{\grace}, qui prend
1465 en charge toutes les petites notes. Si on la fait suivre d'une
1466 expression musicale, un groupe de petites notes sera créé, sans impact
1467 sur la métrique.
1468
1469 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1470 c4 \grace c16 c4
1471 \grace { c16[ d16] } c2 c4
1472 @end lilypond
1473
1474 @noindent
1475 Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
1476 commande @code{\grace} ne provoque pas de liaison.
1477
1478 La durée des petites notes est interprétée par le programme en fonction
1479 d'un deuxième compteur de temps, le chronomètre @code{grace}.  Chaque
1480 instant est défini par deux nombres rationnels : le premier compte les
1481 durées réelles, le second compte la durée des petites notes.  Reprenons
1482 l'exemple ci-dessus en y ajoutant ces couples de nombres :
1483
1484 @lilypond[quote,ragged-right]
1485 <<
1486   \relative c''{
1487     c4 \grace c16 c4 \grace {
1488     c16[ d16] } c2 c4
1489   }
1490   \new Lyrics \lyricmode {
1491     \override LyricText #'font-family = #'typewriter
1492
1493     \markup { (0,0) } 4
1494     \grace { \markup {
1495       ( \fraction 1 4 , \fraction -1 16 ) } 16 }
1496     \markup { (\fraction 1 4 , 0 ) } 4
1497     \grace {
1498       \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
1499       \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
1500     }
1501     \markup { ( \fraction 2 4 , 0 ) }
1502   }
1503 >>
1504 @end lilypond
1505
1506 Les petites notes se placent de façon synchrone entre les différentes
1507 portées.  Dans l'exemple suivant, il y a deux petites double-croches
1508 pour chaque petite croche.
1509
1510 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1511 << \new Staff { e4 \grace { c16[ d e f] } e4 }
1512    \new Staff { c4 \grace { g8[ b] } c4 } >>
1513 @end lilypond
1514
1515 @funindex \afterGrace
1516
1517 La commande @code{\afterGrace} sert à placer une petite note après une
1518 note réelle --- et non @emph{avant} comme d'ordinaire.  Cette commande
1519 requiert deux arguments : la note réelle, et la ou les petites notes qui
1520 suivent.
1521
1522 @lilypond[ragged-right, verbatim,relative=2,fragment]
1523 c1 \afterGrace d1 { c16[ d] } c4
1524 @end lilypond
1525
1526 Les petites notes se placent alors aux 3/4 de la durée de la note
1527 réelle.  Cette fraction peut être changée en définissant
1528 @code{afterGraceFraction} ; ainsi,
1529
1530 @example
1531 #(define afterGraceFraction (cons 7 8))
1532 @end example
1533
1534 @noindent
1535 placera la petite note à 7/8 de la note réelle.
1536
1537 On peut obtenir le même effet manuellement, de la façon suivante :
1538
1539 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1540 \new Voice {
1541   << { d1^\trill_( }
1542      { s2 \grace { c16[ d] } } >>
1543   c4)
1544 }
1545 @end lilypond
1546
1547 @noindent
1548 Le silence invisible peut être plus ou moins long --- ici c'est une
1549 demi-pause --- afin d'ajuster l'espace entre la note réelle et les
1550 petites notes.
1551
1552 Les expressions @code{\grace} obéissent à des règles typographiques
1553 particulières, notamment pour régler l'orientation et la taille des
1554 objets.  De ce fait, toute subtilité de mise en forme devra être
1555 indiquée @emph{à l'intérieur} de l'expression introduite par
1556 @code{\grace} :
1557
1558 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1559 \new Voice {
1560   \acciaccatura {
1561     \stemDown
1562     f16->
1563     \stemNeutral
1564   }
1565   g4
1566 }
1567 @end lilypond
1568
1569 @noindent
1570 Tous les réglages ajoutés doivent également être désactivés dans cette
1571 même expression.
1572
1573 Il est possible de changer globalement la mise en forme des petites
1574 notes dans un morceau, au moyen de la fonction
1575 @code{add-grace-property}.  Ici, par exemple, on ôte la définition de
1576 l'orientation des objets @code{Stem} pour toutes les petites notes, afin
1577 que les hampes ne soient pas toujours orientées vers le haut.
1578
1579 @example
1580 \new Staff @{
1581  #(add-grace-property 'Voice 'Stem 'direction '())
1582  @dots{}
1583 @}
1584 @end example
1585
1586 @noindent
1587 Il est par ailleurs possible de modifier les variables
1588 @code{startGraceMusic}, @code{stopGraceMusic},
1589 @code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
1590 @code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
1591 Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
1592
1593 @noindent
1594 Le trait que l'on trouve sur les hampes des accacciatures peut
1595 être appliqué dans d'autres situations en définissant @*
1596 @code{\override Stem  #'stroke-style = #"grace"}.
1597
1598
1599 @commonprop
1600
1601 Il est possible de forcer l'élasticité de l'espacement des notes d'agrément.
1602
1603 @lilypond[verbatim,quote,relative=2]
1604 <<
1605   \override Score.SpacingSpanner #'strict-grace-spacing = ##t
1606   \new Staff {
1607     c4
1608     \afterGrace c4 { c16[ c8 c16] }
1609     c4 r
1610   }
1611   \new Staff {
1612     c16 c c c c c c c c4 r
1613   }
1614 >>
1615 @end lilypond
1616
1617
1618 @seealso
1619
1620 Référence du programme : @rinternals{GraceMusic}.
1621
1622
1623 @knownissues
1624
1625 Une partition commençant par une expression @code{\grace} doit faire
1626 intervenir la commande @code{\new Voice}, sans quoi la note réelle et
1627 la petite note se retrouveront sur des portées différentes.
1628
1629 La synchronisation des petites notes se fait de façon parfois
1630 surprenante, car les autres objets de la portée --- barres de mesure,
1631 armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
1632 mélez des portées comprenant des petites notes et d'autres sans :
1633
1634 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1635 << \new Staff { e4 \bar "|:" \grace c16 d4 }
1636    \new Staff { c4 \bar "|:" d4 } >>
1637 @end lilypond
1638
1639 @noindent
1640 Il est possible de remédier à cela en insérant sur les autres portées
1641 des silences invisibles dans une expression précédée de @code{\grace},
1642 correspondant à la durée des petites notes.
1643
1644 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
1645 << \new Staff { e4 \bar "|:" \grace c16 d4 }
1646    \new Staff { c4 \bar "|:" \grace s16 d4 } >>
1647 @end lilypond
1648  
1649 Seules des expressions musicales séquentielles peuvent être utilisées
1650 pour des petites notes ; il n'est pas possible d'imbriquer ni de
1651 juxtaposer des sections de petites notes, faute de quoi le traitement du
1652 code peut échouer ou produire des erreurs.
1653
1654
1655 @node Aligning to cadenzas
1656 @subsubsection Aligning to cadenzas
1657
1658 Dans un contexte orchestral, une cadence constitue un problème
1659 spécifique.  Lors du montage d'une partition contenant une cadence,
1660 tous les autres instruments doivent sauter autant de notes que ce
1661 qu'en comporte la cadence, faute de quoi il démarreraient trop tôt ou
1662 trop tard. 
1663
1664 Les fonctions @code{mmrest-of-length} ou @code{skip-of-length}
1665 permettent de résoudre ce problème.  Ces fonctions Scheme prennent en
1666 argument un fragment de musique, et génèrent un @code{\skip} ou un
1667 silence multi-mesures d'une durée correspondant à ce fragment.
1668 L'exemple qui suit illustre l'utilisation de @code{mmrest-of-length}. 
1669
1670 @lilypond[verbatim,ragged-right,quote]
1671 cadenza = \relative c' {
1672   c4 d8 << { e f g } \\ { d4. } >>
1673   g4 f2 g4 g
1674 }
1675
1676 \new GrandStaff <<
1677   \new Staff { \cadenza c'4 }
1678   \new Staff {
1679     #(ly:export (mmrest-of-length cadenza))
1680     c'4
1681   }
1682 >>
1683 @end lilypond
1684
1685
1686 @node Time administration
1687 @subsubsection Time administration
1688
1689 @cindex temps, gestion du
1690
1691 Le temps est administré par le @rinternals{Time_signature_engraver},
1692 qui réside en principe dans le contexte @rinternals{Score}.  Sa
1693 gestion traite les variables suivantes :
1694
1695 @table @code
1696 @item currentBarNumber
1697 Le numéro de mesure.
1698
1699 @item measureLength
1700 La longueur de la mesure, dans la métrique en cours.  Pour une mesure
1701 à 4/4, elle est de@tie{}1, et de 3/4 pour une mesure à 6/8.
1702
1703 @item measurePosition
1704 Le moment où l'on en est dans la mesure en cours.  Cette quantité est
1705 remise à@tie{}0 dès lors qu'on dépasse @code{measureLength} ; la variable
1706 @code{currentBarNumber} est alors incrémentée.  
1707
1708 @item timing
1709 Lorsqu'on lui assigne la valeur @emph{vrai}, les valeurs ci-dessus
1710 mentionnées sont mises à jour à chaque pas.  Fixée à @emph{faux}, le
1711 graveur restera indéfiniment dans la mesure en cours.
1712 @end table
1713
1714 Le calage peut être modifié en réglant explicitement l'une de ces
1715 variables.  Dans l'exemple qui suit, nous réglons la métrique à 4/4,
1716 tout en fixant @code{measureLength} à 5/4.  Un peu plus loin, nous
1717 raccourcissons la mesure de 1/8, en assignant 7/8 à
1718 @code{measurePosition}, alors que nous en sommes à 2/4 dans la
1719 mesure ; la barre de mesure tombera donc à @w{2/4 + 3/8}.  Les 3/8
1720 résultent du fait que 5/4 équivaut à 10/8, mais nous nous sommes recalés
1721 à 7/8 de la mesure ;  donc @w{10/8 @minus{} 7/8 = 3/8}.
1722
1723 @lilypond[quote,ragged-right,verbatim,relative,fragment]
1724 \set Score.measureLength = #(ly:make-moment 5 4)
1725 c1 c4
1726 c1 c4
1727 c4 c4
1728 \set Score.measurePosition = #(ly:make-moment 7 8)
1729 b8 b b
1730 c4 c1
1731 @end lilypond
1732
1733 @noindent
1734 Comme le montre cet exemple, @code{ly:make-moment n m} construit une
1735 durée de n/m fois une ronde.  
1736 Par conséquent, @code{ly:make-moment 1 8} correspond à une croche, et
1737 @code{ly:make-moment 7 16} à la durée de sept doubles croches.
1738
1739 @c Old. -fv
1740 @node Proportional notation (introduction)
1741 @subsubsection Proportional notation (introduction)
1742 @cindex Notation proportionnelle
1743
1744 Voir @ref{Proportional notation}.
1745
1746
1747 @c À faire : supprimer tout ça ?
1748
1749 Les notes peuvent s'espacer proportionnellement en assignant une durée
1750 à @code{proportionalNotationDuration}
1751
1752 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
1753 <<
1754   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
1755   \new Staff { c8[ c c c c c]  c4 c2 r2 }
1756   \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
1757 >>
1758 @end lilypond
1759
1760 Manipuler cette propriété affectera l'espacement idéal uniquement pour
1761 des notes consécutives.  Pour obtenir une véritable notation
1762 proportionnelle, vous devrez tenir compte des réglages suivants :
1763
1764 @itemize @bullet
1765
1766 @item La véritable notation proportionnelle exige que des symboles
1767 puissent en écraser d'autres.  Pour y parvenir, il faut retirer le
1768 @rinternals{Separating_line_group_engraver} du contexte
1769 @rinternals{Staff}. 
1770
1771 @item L'influence en matière d'espacement induite par le formatage
1772 (clés, barres de mesure, etc) s'annule en assignant
1773 @emph{vrai}@tie{}(#t) à la propriété @code{strict-note-spacing} de
1774 l'objet @rinternals{SpacingSpanner}.
1775
1776 @item Les affinages optiques se règlent en assignant @emph{vrai} à la
1777 propriété @code{uniform-stretching} du @rinternals{SpacingSpanner}. 
1778
1779
1780 @end itemize
1781
1782 @seealso
1783
1784 Exemples : @rlsr{Spacing}.
1785
1786 Le fichier @file{input/proportional.ly} illustre la notation
1787 proportionnelle stricte.
1788
1789