]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/user/basic-notation.itely
4a68894658a706c210c8969e8f72697da9d4edf0
[lilypond.git] / Documentation / fr / user / basic-notation.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
3 @ignore
4     Translation of GIT committish: 9634340429eb0518432b152fe4aaf7471b67b013
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  See TRANSLATION for details.
8 @end ignore
9
10 @c A menu is needed before every deeper *section nesting of @node's; run
11 @c     M-x texinfo-all-menus-update
12 @c to automatically fill in these menus before saving changes
13
14 @node Basic notation
15 @chapter Basic notation
16
17 De l'utilisation des fonctions de notation de base.
18
19
20 @menu
21 * Pitches::
22 * Rhythms::
23 * Polyphony::
24 * Staff notation::
25 * Connecting notes::
26 * Expressive marks::
27 * Repeats::
28 @end menu
29
30
31 @node Pitches
32 @section Pitches
33
34 De la manière de spécifier les hauteurs de notes.
35
36 @menu
37 * Normal pitches::
38 * Accidentals::
39 * Cautionary accidentals::
40 * Micro tones::
41 * Note names in other languages::
42 * Relative octaves::
43 * Octave check::
44 * Transpose::
45 * Rests::
46 * Skips::
47 @end menu
48
49
50 @node Normal pitches
51 @subsection Normal pitches
52
53 @cindex noms de note
54 @cindex hauteurs
55
56 La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
57 notation anglaise, en utilisant les lettres @code{a} à @code{g}.
58 Une gamme ascendante de do majeur s'écrit
59
60 @lilypond[quote,fragment,verbatim,ragged-right]
61 \clef bass
62 c d e f g a b c'
63 @end lilypond
64
65 La note @code{c} est écrite une octave sous le do central.
66
67 @lilypond[quote,fragment,verbatim,ragged-right]
68 \clef treble
69 c1
70 \clef bass
71 c1
72 @end lilypond
73
74 @funindex '
75 @funindex ,
76
77 L'octave peut être précisée sous forme d'une série d'apostrophes
78 @samp{'} ou d'une série de virgules @samp{,}.  Chaque @samp{'} hausse la
79 note d'une octave, chaque @samp{,} baisse la note d'une octave.
80
81 @lilypond[quote,ragged-right,fragment,verbatim]
82 \clef treble
83 c' c'' e' g d'' d' d c
84 \clef bass
85 c, c,, e, g d,, d, d c
86 @end lilypond
87
88 Il existe une autre méthode pour préciser à quelle octave se situe la
89 note à graver ; cette méthode demande moins d'indications d'octaves
90 (@code{'} and @code{,}) --- voir @ref{Relative octaves}.
91
92
93 @node Accidentals
94 @subsection Accidentals
95
96 @cindex noms de note, hollandais
97 @cindex noms de note, par défaut
98
99 Dans la notation par défaut, un dièse est formé en ajoutant @code{-is}
100 après le nom de note, un bémol en ajoutant @code{-es}.  Les
101 double-dièses et double-bémols sont obtenus en ajoutant @code{-isis}
102 ou @code{-eses} au nom de note.
103
104 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
105 a2 ais a aes
106 a2 aisis a aeses
107 @end lilypond
108
109 @noindent
110 Ce sont les noms de note hollandais.  En hollandais, on élide @code{aes}
111 pour écrire @code{as}, mais les deux formes sont acceptées.  De manière
112 similaire, on accepte aussi bien @code{es} que @code{ees}.
113
114 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
115 a2 as e es
116 @end lilypond
117
118 Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
119 ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
120 bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
121 donnera une note bécarre.
122
123 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
124 a4 aes a2
125 @end lilypond
126
127 LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
128 naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
129 Pour plus d'information à propos de la distinction entre le contenu
130 musical et sa représentation, voir @ref{Accidentals and key signatures}.
131
132 @lilypond[fragment,quote,ragged-right,verbatim,relative]
133 \key d \major
134 d e f g
135 d e fis g
136 @end lilypond
137
138
139 @commonprop
140
141 En accord avec les règles standards de l'écriture musicale, on imprime
142 un bécarre avant un dièse ou un bémol si on a besoin d'annuler une
143 altération précédente.  Pour modifier ce comportement, écrivez
144 @code{\set Staff.extraNatural = ##f}
145
146 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
147 ceses4 ces cis c
148 \set Staff.extraNatural = ##f
149 ceses4 ces cis c
150 @end lilypond
151
152
153 @seealso
154
155 Référence du programme : @internalsref{LedgerLineSpanner},
156 @internalsref{NoteHead}.
157
158
159 @node Cautionary accidentals
160 @subsection Cautionary accidentals
161
162 @cindex altération, de précaution
163 @cindex altération, entre parenthèses
164 @cindex altération de précaution
165 @funindex ?
166 @cindex altération entre parenthèses
167 @funindex !
168
169 Normalement, les altérations sont imprimées automatiquement, mais il se
170 peut que vous vouliez les imprimer manuellement.  On peut forcer
171 l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
172 point d'exclamation @samp{!} après la hauteur de note.  Une altération
173 entre parenthèses peut être obtenue en ajoutant un point d'interrogation
174 @samp{?} après la hauteur de note.  Ces signes peuvent aussi être
175 utilisés pour imprimer des bécarres.
176
177 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
178 cis cis cis! cis? c c? c! c
179 @end lilypond
180
181
182 @seealso
183
184 L'impression automatique des altérations peut être affinée de plusieurs
185 manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
186
187
188 @node Micro tones
189 @subsection Micro tones
190
191 @cindex quarts de ton
192 @cindex demi-bémols, demi-dièses
193
194 Les demi-bémols et les demi-dièses s'écrivent en ajoutant respectivement
195 @code{-eh} et @code{-ih}. Voici une séries de dos altérés en hauteurs
196 croissantes :
197
198 @lilypond[verbatim,ragged-right,quote,relative=2,fragment]
199 \set Staff.extraNatural = ##f
200 ceseh ceh cih cisih
201 @end lilypond
202
203 Les micro-intervalles sont aussi exportés dans le fichier MIDI.
204
205 @refbugs
206
207 Il n'y a pas de standard universellement accepté pour noter le bémol et
208 demi (qui abaisse la hauteur trois quarts de ton), donc le symbole de
209 LilyPond n'est conforme à aucun standard.
210
211
212 @node Note names in other languages
213 @subsection Note names in other languages
214
215 Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
216 langues.  Pour les utiliser, incluez le fichier d'initialisation
217 spécifique à la langue voulue.  Par exemple, pour les langues romanes,
218 ajoutez @code{\include "italiano.ly"} au début du fichier source.  Les
219 fichiers de langues disponibles ainsi que les noms de notes utilisés
220 sont les suivants :
221
222 @cindex noms de note, autres langues
223 @example
224                        Noms de note              dièse       bémol      double          double
225                                                                         dièse           bémol
226 nederlands.ly  c   d   e   f   g   a   bes b   -is         -es          -isis           -eses
227 english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat     -ss/-x/         -ff/
228                                                                         -sharpshsarp    -flatflat
229 deutsch.ly     c   d   e   f   g   a   b   h   -is         -es          -isis           -eses
230 norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es     -ississ/-isis   -essess/-eses
231 svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess         -ississ         -essess
232 italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b           -dd             -bb
233 catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b           -dd/-ss         -bb
234 espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b           -ss             -bb
235 @end example
236
237 @noindent
238 Notez qu'en hollandais, en allemand, en norvégien et en suédois,
239 un @samp{la} altéré de bemol se note @code{aes} et @code{aeses}.  Ces
240 formes sont contractées en @code{as} et @code{ases} (ou plus
241 communément @code{asas}).  Dans certains fichiers linguistiques,
242 seules ces formes abrégées ont été définies ; ceci s'applique aussi
243 aux suffixes pour les quarts de ton.
244
245 @noindent
246 Certaines musiques utilisent des microtonalités, pour lesquelles les
247 altérations sont des fractions de dièse ou bémol @qq{normaux}.  Le
248 tableau suivant répertorie les noms de note en quart de ton, tels que
249 définis dans plusieurs fichiers linguistiques. Les préfixes @q{semi-}
250 et @q{sesqui-} correspondent au @q{demi-} et @q{trois demis}.  
251 À noter qu'aucune définition n'existe à ce jour pour le norvégien, le
252 suédois, le catalan et l'espagnol.
253
254 @c What about Turkish Maquam music and similar microtonal systems?
255 @c
256 @c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
257 @c is actually misleading since the alteration is in fact one and a half
258 @c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
259
260 @example
261                         Noms de note           semi-   semi-  sesqui-  sesqui-
262                                                dièse   bémol  dièse    bémol
263
264 nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
265 english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
266 deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
267 norsk.ly       c   d   e   f   g   a   b   h   
268 svenska.ly     c   d   e   f   g   a   b   h   
269 italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
270 catalan.ly     do  re  mi  fa  sol la  sib si  
271 espanol.ly     do  re  mi  fa  sol la  sib si  
272 @end example
273
274
275
276 @node Relative octaves
277 @subsection Relative octaves
278
279 @cindex relatif
280 @cindex indication d'octave relative
281 @funindex \relative
282
283 On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
284 hauteurs.  En recopiant de la musique, on a vite fait de mettre une
285 note à la mauvaise octave, et ce genre d'erreur est difficile à
286 retrouver.  Le mode d'écriture \relative prévient ces erreurs en
287 rendant les erreurs beaucoup plus évidentes : une seule erreur met le
288 reste de la pièce à la mauvaise octave.
289
290
291 @example
292 \relative @var{startpitch} @var{musicexpr}
293 @end example
294
295 @noindent
296 ou
297
298 @example
299 \relative @var{musicexpr}
300 @end example
301
302 @noindent
303 @code{c'} est utilisé par défaut si aucune hauteur de départ n'est définie.
304
305 L'octave des notes mentionnées dans @var{musicexpr} va être calculée
306 de la manière suivante : si aucun signe de changement d'octave n'est
307 utilisé, l'intervalle de base entre la note actuelle et la précédente
308 sera toujours d'une quarte ou moins.  Cet intervalle est déterminé
309 sans tenir compte des altérations ; ainsi un @code{fisis} après un
310 @code{ceses} sera mis au-dessus le @code{ceses}.  En d'autres termes,
311 une quarte doublement augmentée demeure considérée comme un
312 intervavlle plus petit qu'une quinte diminuée, bien que la quarte
313 doublement augmentée soit de sept demi-tons et la quinte diminuée de
314 six demi-tons seulement.
315
316 Les signes de changement d'octaves @code{'} et @code{,} peuvent être
317 ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
318 Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de départ
319 peut être spécifiée, et agira dès lors comme si elle précédait la
320 première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
321 spécifiée, le do central sert de point de départ.
322
323 Voici le mode \relative en action.
324 @lilypond[quote,fragment,ragged-right,verbatim]
325 \relative c'' {
326   b c d c b c bes a
327 }
328 @end lilypond
329
330 On utilise les signes de changement d'octave pour les intervalles
331 dépassant la quarte.
332
333 @lilypond[quote,ragged-right,fragment,verbatim]
334 \relative c'' {
335   c g c f, c' a, e''
336 }
337 @end lilypond
338
339 Si l'expression précédente est un accord, c'est la première note de
340 l'accord qui détermine l'emplacement de la première note du prochain
341 accord.
342
343 @lilypond[quote,ragged-right,fragment,verbatim]
344 \relative c' {
345   c <c e g>
346   <c' e g>
347   <c, e' g>
348 }
349 @end lilypond
350
351 La hauteur après @code{\relative} contient un nom de note.
352
353 La conversion en mode \relative n'affectera pas les sections @code{\transpose},
354 @code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
355 utiliser \relative dans de la musique transposée, un code
356 @code{\relative} additionnel doit être placé dans @code{\transpose}.
357
358
359 @node Octave check
360 @subsection Octave check
361
362 @cindex Octave check
363
364 Les tests d'octaves rendent la correction d'erreurs d'octaves plus
365 facile : une note peut être suivie de @code{=}@var{quotes} indiquant à
366 quelle octave absolue elle devrait être.  Dans l'exemple suivant,
367
368 @example
369 \relative c'' @{ c='' b=' d,='' @}
370 @end example
371
372 @noindent
373 le @code{d} générera un avertissement, puisqu'on attend un @code{d''}
374 mais qu'on obtient un @code{d'} --- il n'y a qu'une tierce entre
375 @code{b'} et @code{d''}.  Sur la partition, l'octave sera corrigée
376 pour donner un @code{d''} et la prochaine note sera calculée en
377 fonction de @code{d''} au lieu de @code{d'}.
378
379 Il existe aussi une vérification d'octave sans changement visible en
380 sortie, avec cette syntaxe :
381
382 @example
383 \octave @var{pitch}
384 @end example
385
386 Cette commande vérifie que @var{pitch} (sans apostrophe ni virgule)
387 donne @var{pitch} (avec apostrophes ou virgules) dans le mode
388 @code{\relative} comparé à la note donnée dans la commande
389 @code{\relative}.  Sinon, un avertissement est émis et l'octave est
390 corrigée.  La note @var{pitch} n'est pas imprimée.
391
392 Dans l'exemple ci-dessous, le premier test se fait sans incident,
393 puisque le @code{e} (dans le mode @code{relative}) est à moins d'une
394 quinte du @code{a'}.  Cependant, le deuxième test produit un
395 avertissement, puisque le @code{e} n'est pas à moins d'une quinte du
396 @code{b'}.  Le message d'avertissement est émis, et l'octave est
397 corrigée pour que les notes suivantes soient à nouveau à la bonne
398 octave.
399
400 @example
401 \relative c' @{
402   e
403   \octave a'
404   \octave b'
405 @}
406 @end example
407
408 L'octave d'une note qui suit un test d'octave est déterminée selon la
409 note précédente.  Dans le prochain exemple, la dernière note est un
410 @code{a'}, au-dessus du do central.  Cela veut dire que le test
411 @code{\octave} réussit, et peut donc être enlevé sans changer le
412 résultat sur la partition.
413
414 @lilypond[quote,ragged-right,verbatim,fragment]
415 \relative c' {
416   e
417   \octave b
418   a
419 }
420 @end lilypond
421
422
423 @node Transpose
424 @subsection Transpose
425
426 @cindex Transpose
427 @cindex Transposition of pitches
428 @funindex \transpose
429
430 Une expression musicale peut être transposée avec @code{\transpose}.
431 Voici la syntaxe :
432 @example
433 \transpose @var{note_de départ} @var{note_d_arrivée} @var{musicexpr}
434 @end example
435
436 Cela signifie que @var{musicexpr} est transposé d'un intervalle entre
437 les notes @var{note_de_départ} et @var{note_d_arrivée} : toute note
438 dont la hauteur était @code{note_de_départ}
439 est changée en @code{note_d_arrivée}.
440
441 Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce
442 est un peu trop basse pour l'interprète, elle peut être transposée en
443 mi majeur avec
444 @example
445 \transpose d e @dots{}
446 @end example
447
448 Regardons maintenant une partie écrite pour violon (un instrument en
449 ut).  Si cette partie doit être jouée par une clarinette en la (écrite
450 à la tierce mineure supérieure, un do écrit donnant un la réel), la
451 transposition suivante créera la partie appropriée.
452
453 @example
454 \transpose a c @dots{}
455 @end example
456
457 @code{\transpose} fait la distinction entre les notes enharmoniques :
458 @code{\transpose c cis} et @code{\transpose c des} transposeront la
459 pièce un demi-ton plus haut.  Mais la première version écrira des
460 dièses et la deuxième des bémols.
461
462 @lilypond[quote,ragged-right,verbatim]
463 mus = { \key d \major cis d fis g }
464 \new Staff {
465   \clef "F" \mus
466   \clef "G"
467   \transpose c g' \mus
468   \transpose c f' \mus
469 }
470 @end lilypond
471
472 On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
473 pour un instrument transpositeur.  Normalement, les hauteurs dans
474 LilyPond sont écrites en ut (ou notes réelles), mais elles peuvent
475 être écrites dans un autre ton.  Quand, par exemple, on écrit pour une
476 trompette en si bémol, commençant sur ré note réelle, on pourrait
477 écrire
478 @example
479 \transpose c bes @{ e4 @dots{} @}
480 @end example
481
482 Pour imprimer cette musique en si bémol à nouveau (et de ce fait
483 produire une partie de trompette, au lieu d'une partition de chef en
484 notes réelles), on utilisera un deuxième @code{transpose}
485
486 @example
487 \transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
488 @end example
489
490
491 @seealso
492
493 Référence du programme : @internalsref{TransposedMusic}.
494
495 Exemple : @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
496
497
498 @refbugs
499
500 Si vous voulez utiliser en même temps @code{\transpose} et
501 @code{\relative}, vous devez mettre @code{\transpose} en dehors de
502 @code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
503 musique apparaissant dans un @code{\transpose}.
504
505
506 @node Rests
507 @subsection Rests
508 @cindex Rests
509
510 @funindex \rest
511 @funindex r
512
513 Les silences sont écrits comme des notes avec le nom de note @code{r}.
514
515 @lilypond[fragment,quote,ragged-right,verbatim]
516 r1 r2 r4 r8
517 @end lilypond
518
519 Les pauses d'une mesure complète, qui sont placées au centre de la
520 mesure, doivent être entrées comme des mesures de silences.  Elles
521 peuvent être utilisées pour une seule mesure comme pour plusieurs, et
522 leur utilisation est expliquée dans la section
523 @ref{Multi measure rests}.
524
525 Pour spécifier explicitement la position verticale d'un silence,
526 écrivez une note suivie de @code{\rest}.  Un silence sera placé à la
527 position où serait imprimée la note.
528
529 @lilypond[fragment,quote,ragged-right,verbatim]
530 a'4\rest d'4\rest
531 @end lilypond
532
533 @noindent
534 Cela rend plus facile la mise en place de la musique polyphonique,
535 puisque le formateur automatique de collision des silences laissera
536 ces silences tranquilles.
537
538 @seealso
539
540 Référence du programme : @internalsref{Rest}.
541
542
543 @node Skips
544 @subsection Skips
545
546 @cindex Skip
547 @cindex Invisible rest
548 @cindex Space note
549 @funindex \skip
550 @funindex s
551
552 Un silence invisible --- que l'on pourrait appeler un @qq{saut} ---
553 peut être entré comme une note avec le nom de note `@samp{s}' ou avec
554 @code{\skip @var{durée}}
555
556 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
557 a4 a4 s4 a4 \skip 1 a4
558 @end lilypond
559
560 La syntaxe @code{s} est seulement disponible pour les modes d'entrée
561 de notes et d'accords.  Dans d'autres situations, pour l'entrée de
562 paroles par exemple, vous devrez utiliser la commande @code{\skip}.
563
564 @lilypond[quote,ragged-right,verbatim]
565 <<
566   \relative { a'2 a2 }
567   \new Lyrics \lyricmode { \skip 2 bla2 }
568 >>
569 @end lilypond
570
571 La commande de saut génère simplement une case vide.  Elle ne produit
572 rien sur la partition, pas même un symbole transparent.  Le code de
573 saut @code{s} crée tout de même une @internalsref{Staff} et une
574 @internalsref{Voice} lorsque nécessaire, tout comme les commandes de
575 notes et de silences.  Ainsi, le code suivant aboutit à une portée
576 vide.
577
578 @lilypond[quote,ragged-right,verbatim]
579 { s4 }
580 @end lilypond
581
582 Le fragment @code{@{ \skip 4 @} } produirait une page vide.
583
584 @seealso
585
586 Référence du programme : @internalsref{SkipMusic}.
587
588
589
590 @node Rhythms
591 @section Rhythms
592
593 Des rythmes, durées et mesures.
594
595 @menu
596 * Durations::
597 * Augmentation dots::
598 * Tuplets::
599 * Scaling durations::
600 * Bar check::
601 * Barnumber check::
602 * Automatic note splitting::
603 @end menu
604
605
606 @node Durations
607 @subsection Durations
608
609 @cindex duration
610 @funindex \longa
611 @funindex \breve
612 @funindex \maxima
613
614 Dans les modes Note, Accord et Paroles, les durées sont écrites avec
615 des chiffres et des points : les durées sont indiquées par leurs
616 valeurs réciproques en notation anglaise.  Une noire, par exemple, qui
617 équivaut en anglais à un 1/4 de note, @qq{quarter note}, s'écrit
618 @code{4}, alors qu'une blanche (@qq{half-note}, 1/2 note) s'écrit
619 @code{2}.  Pour des notes plus longues qu'une ronde, vous devrez
620 utiliser les commandes @code{\longa} (pour une longue) et
621 @code{\breve} (pour une brève, aussi appelée carrée).
622
623 @example
624 c'\breve
625 c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
626 r\longa r\breve
627 r1 r2 r4 r8 r16 r32 r64 r64
628 @end example
629
630 @lilypond[quote]
631 \score {
632 \relative c'' {
633     a\breve*1/2 \autoBeamOff
634     a1 a2 a4 a8 a16 a32 a64 a64
635    \bar "empty"
636    \break
637     r\longa*1/4 r\breve *1/2
638     r1 r2 r4 r8 r16 r32 r64 r64
639   }
640   \layout {
641     ragged-right = ##t
642     indent=0\mm
643     \context {
644       \Score
645         \remove "Bar_number_engraver"
646     }
647     \context {
648       \Staff
649         \remove "Clef_engraver"
650         \override StaffSymbol #'transparent = ##t
651         \override TimeSignature #'transparent = ##t
652         \override BarLine #'transparent = ##t
653         \consists "Pitch_squash_engraver"
654     }
655   }
656 }
657 @end lilypond
658
659 Si la durée n'est pas précisée, elle est alors assimilée à la durée
660 précédente.  La valeur par défaut pour la première note est une noire
661 (4).
662
663 @lilypond[quote,ragged-right,verbatim,fragment]
664 { a a a2 a a4 a a1 a }
665 @end lilypond
666
667
668 @node Augmentation dots
669 @subsection Augmentation dots
670
671 @funindex .
672
673 Pour obtenir des notes pointées, ajoutez simplement un point
674 (@samp{.}) au chiffre.  Les notes doublement pointées sont créées de
675 la même façon.
676
677 @lilypond[quote,ragged-right,fragment,verbatim]
678 a'4 b' c''4. b'8 a'4. b'4.. c''8.
679 @end lilypond
680
681 @refcommands
682
683 Les points sont normalement haussés pour éviter les lignes de portées,
684 sauf dans certaines polyphonies.  Les commandes suivantes peuvent être
685 utilisées pour demander manuellement une orientation particulière des
686 points.
687
688 @funindex \dotsUp
689 @code{\dotsUp},
690 @funindex \dotsDown
691 @code{\dotsDown},
692 @funindex \dotsNeutral
693 @code{\dotsNeutral}.
694
695 @seealso
696
697 Référence du programme : @internalsref{Dots}, @internalsref{DotColumn}.
698
699
700 @node Tuplets
701 @subsection Tuplets
702
703 @cindex tuplets
704 @cindex triplets
705 @funindex \times
706
707 Les nolets --- triolets, quintolets, etc. --- sont obtenus en
708 multipliant toutes les durées d'une expression musicale par une
709 fraction.
710
711 @example
712 \times @var{fraction} @var{musicexpr}
713 @end example
714
715 @noindent
716 La durée de @var{musicexpr} sera multipliée par la fraction.  Le
717 dénominateur de la fraction sera imprimé au-dessus des notes,
718 optionnellement avec un crochet.  Le nolet le plus courant est le
719 triolet, dans lequel 3 notes ont la durée de 2, et où les notes durent
720 donc 2/3 de leur valeur écrite.
721
722 @lilypond[quote,ragged-right,fragment,verbatim]
723 g'4 \times 2/3 {c'4 c' c'} d'4 d'4
724 @end lilypond
725
726 Les nolets peuvent être imbriqués ; par exemple,
727
728 @lilypond[fragment,ragged-right,verbatim,relative=2]
729 \override TupletNumber #'text = #tuplet-number::calc-fraction-text
730 \times 4/6 {
731   a4 a
732   \times 3/5 { a a a a a }
733 }
734 @end lilypond
735
736 @refcommands
737
738 @funindex \tupletUp
739 @code{\tupletUp},
740 @funindex \tupletDown
741 @code{\tupletDown},
742 @funindex \tupletNeutral
743 @code{\tupletNeutral}.
744
745
746 @commonprop
747
748 @funindex tupletNumberFormatFunction
749 @cindex tuplet formatting
750
751 La propriété @code{tupletSpannerDuration} spécifie la longueur voulue
752 de chaque crochet.  Avec elle, vous pouvez faire plusieurs n-olets en
753 ne tapant @code{\times} qu'une fois, ce qui évite une longue saisie.
754 Dans le prochain exemple, deux triolets sont imprimés avec une seule
755 fonction @code{\times}.
756
757 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
758 \set tupletSpannerDuration = #(ly:make-moment 1 4)
759 \times 2/3 { c8 c c c c c }
760 @end lilypond
761
762 @noindent
763 Pour plus d'information sur @code{make-moment}, voir
764 @ref{Time administration}.
765
766 L'apparence du chiffre est déterminée par la propriété @code{text} dans
767 @code{TupletNumber}.  La valeur par défaut imprime seulement le
768 dénominateur, mais si elle est définie par la fonction
769 @code{tuplet-number::calc-fraction-text}, la fraction entière
770 @var{num}:@var{den} sera imprimée à la place.
771
772 Pour éviter d'imprimer les chiffres des nolets, utilisez
773
774 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
775 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
776 \override TupletNumber #'transparent = ##t
777 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
778 @end lilypond
779
780 Utilisez la fonction @code{\tweak} pour définir une priorité dans le
781 cas de nolets imbriqués débutant au même moment.  Dans cet exemple,
782 @code{\tweak} spécifie un texte sous forme de fraction pour le
783 @code{TupletNumber} externe et de dénominateur pour les trois triolets internes. 
784
785 @lilypond[quote,ragged-right,verbatim]
786 \new Staff {
787   \tweak #'text #tuplet-number::calc-fraction-text
788   \times 4/3 {
789      \tweak #'text #tuplet-number::calc-denominator-text
790      \times 2/3 { c'8[ c'8 c'8] }
791      \times 2/3 { c'8[ c'8 c'8] }
792      \times 2/3 { c'8[ c'8 c'8] }
793   }
794 }
795 @end lilypond
796
797 Ici, @code{\tweak} et @code{\override} agissent de concert pour
798 spécifier le positionnement du @code{TupletBracket}.  Le premier
799 @code{\tweak} positionne le @code{TupletBracket} du nolet externe au
800 dessus de la portée. Le second @code{\tweak} positionne le
801 @code{TupletBracket} du premier triolet interne au dessous de la
802 portée.  Notez que cette paire de fonctions @code{\tweak} n'affectent
803 que le triolet extérieur et le premier des trois triolets imbriqués
804 parce qu'ils commencent au même instant musical.  Nous utilisons
805 @code{\override} de manière tout à fait normale, pour forcer le
806 positionnement du @code{TupletBracket} des deuxième et troisième
807 triolets en dessous de la portée.
808
809 @lilypond[quote,ragged-right,verbatim]
810 \new Staff {
811   \tweak #'text #tuplet-number::calc-fraction-text
812   \tweak #'direction #up
813   \times 4/3 {
814      \tweak #'direction #down
815      \times 2/3 { c'8[ c'8 c'8] }
816      \override TupletBracket #'direction = #down
817      \times 2/3 { c'8[ c'8 c'8] }
818      \times 2/3 { c'8[ c'8 c'8] }
819   }
820 }
821 @end lilypond
822
823 Les crochets de nolets peuvent aller jusqu'aux prémisses de la mesure
824 suivante, ou à la prochaine note.
825
826 @lilypond[ragged-right]
827 \new RhythmicStaff {
828   \set tupletFullLength = ##t
829   \time 4/4
830   \times 4/5 {
831     c4 c1
832   }
833   \set tupletFullLengthNote = ##t
834   \time 2/4
835   \times 2/3 {
836     c4 c c 
837   }
838   \time 3/4
839   c4 
840 }
841 @end lilypond
842
843
844 @seealso
845
846 Référence du programme : @internalsref{TupletBracket},
847 @internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
848
849 Exemples: @inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
850
851
852
853 @node Scaling durations
854 @subsection Scaling durations
855
856 Vous pouvez altérer la durée des notes en lui joignant une fraction
857 @var{N/M}, donnant @q{@code{*}@var{N/M}} --- ou @q{@code{*}@var{N}} si
858 @var{M=1}.  Ceci n'affectera pas l'apparence des notes ou silences
859 produits.
860
861 Dans l'exemple suivant, les trois premières notes prennent exactement
862 deux temps, mais aucun triolet n'est imprimé.
863
864 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
865 \time 2/4
866 a4*2/3 gis4*2/3 a4*2/3
867 a4 a4 a4*2
868 b16*4 c4
869 @end lilypond
870
871
872 @seealso
873
874 Dans ce manuel : @ref{Tuplets}.
875
876
877 @node Bar check
878 @subsection Bar check
879
880 @cindex Bar check
881 @funindex barCheckSynchronize
882 @funindex |
883
884 Les tests de mesure aident à détecter les erreurs dans les durées.  Un
885 test de mesure s'écrit avec une barre verticale, @samp{|}.  Lors du
886 traitement, elle devrait tomber sur une barre de mesure.  Sinon, un
887 avertissement est émis.  Dans l'exemple suivant, le deuxième test de
888 mesure signalera une erreur.
889 @example
890 \time 3/4 c2 e4 | g2 |
891 @end example
892
893 Le test de mesure peut être aussi utilisé dans les paroles, par exemple :
894 @example
895 \lyricmode @{
896  \time 2/4
897  Twin -- kle | Twin -- kle
898 @}
899 @end example
900
901 Des durées incorrectes font échouer les tests de mesure, et peuvent
902 souvent mettre la partition sens dessus dessous, particulièrement s'il
903 s'agit de musique polyphonique.  Vérifier les tests de mesure qui ont
904 échoué et les durées incorrectes est un bon moyen de commencer à
905 corriger sa partition.
906
907 @funindex |
908 @funindex pipeSymbol
909
910 Il est aussi possible d'attribuer une autre valeur au symbole
911 @code{|}, en assignant une expression musicale à @code{pipeSymbol},
912
913 @lilypond[quote,ragged-right,verbatim]
914 pipeSymbol = \bar "||"
915
916 { c'2 c' | c'2 c' }
917 @end lilypond
918
919
920 @node Barnumber check
921 @subsection Barnumber check
922
923 Lorsque l'on recopie de longues pièces, il peut être utile de vérifier
924 que les numéros de mesures de LilyPond correspondent à l'original que
925 l'on recopie.  Cela se fait avec @code{\barNumberCheck}.  Par exemple,
926
927 @verbatim
928 \barNumberCheck #123
929 @end verbatim
930
931 @noindent
932 imprimera un avertissement si le @code{currentBarNumber} n'est pas 123
933 quand il est traité.
934
935 @node Automatic note splitting
936 @subsection Automatic note splitting
937
938 On peut convertir automatiquement les notes longues en notes liées.
939 Il faut pour cela remplacer le @internalsref{Note_heads_engraver} par
940 le
941 @internalsref{Completion_heads_engraver}.
942 Dans les exemples suivants, les notes dépassant de la mesure sont
943 divisées et liées.
944
945 @lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
946 \new Voice \with {
947   \remove "Note_heads_engraver"
948   \consists "Completion_heads_engraver"
949 } {
950   c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
951 }
952 @end lilypond
953
954 Ce graveur divise toutes les notes qui sortent de la mesure, et insère
955 des liaisons de prolongation.  L'une de ses utilités est de déboguer
956 des partitions complexes : si les mesures ne sont pas entièrement
957 remplies, alors les liaisons de prolongation montrent exactement de
958 combien de temps les mesures sont décalées.
959
960 Si vous voulez permettre le saut de ligne aux barres de mesure où
961 @internalsref{Completion_heads_engraver} divise les notes, vous devez
962 aussi enlever @internalsref{Forbid_line_break_engraver}.
963
964
965 @refbugs
966
967 Bien que toutes les durées (particulièrement celles contenant des
968 nolets) ne puissent pas être représentées exactement avec des notes
969 normales et des points, le graveur n'insèrera pas de nolets.
970
971 @code{Completion_heads_engraver} affecte seulement les notes, il ne
972 divise pas les silences.
973
974 @seealso
975
976 Exemples : @inputfileref{input/@/regression,completion@/-heads@/.ly}.
977
978 @noindent
979
980 Référence du programme : @internalsref{Completion_heads_engraver}.
981
982
983 @node Polyphony
984 @section Polyphony
985
986 La notion musicale de polyphonie fait référence au fait d'avoir plus
987 d'une voix simultanément dans une pièce.  Dans LilyPond, la notion de
988 polyphonie fait référence au fait d'avoir plus d'une voix sur la même
989 portée.
990
991 @menu
992 * Chords::
993 * Stems::
994 * Basic polyphony::
995 * Explicitly instantiating voices::
996 * Collision Resolution::
997 @end menu
998
999
1000 @node Chords
1001 @subsection Chords
1002
1003 @cindex Chords
1004
1005 Un accord est formé en mettant une série de hauteurs entre @code{<}
1006 et @code{>}.  Un accord peut être suivi d'une durée et d'indications
1007 d'articulation, comme une simple note.
1008
1009 @lilypond[verbatim,ragged-right,fragment,quote,relative=1]
1010 <c e g>4 <c>8
1011 @end lilypond
1012
1013 Pour plus d'information à propos des accords, voir @ref{Chord names}.
1014
1015
1016 @node Stems
1017 @subsection Stems
1018
1019 Dès qu'une note est rencontrée, un objet @internalsref{Stem} se crée
1020 automatiquement.  Pour les rondes et les silences, ils sont aussi
1021 créés, mais en mode invisible.
1022
1023 @refcommands
1024
1025 @funindex \stemUp
1026 @code{\stemUp},
1027 @funindex \stemDown
1028 @code{\stemDown},
1029 @funindex \stemNeutral
1030 @code{\stemNeutral}.
1031
1032
1033 @commonprop
1034
1035 Pour changer la direction des hampes au milieu de la portée, utilisez
1036
1037 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
1038 a4 b c b
1039 \override Stem #'neutral-direction = #up
1040 a4 b c b
1041 \override Stem #'neutral-direction = #down
1042 a4 b c b
1043 @end lilypond
1044
1045
1046 @node Basic polyphony
1047 @subsection Basic polyphony
1048
1049 @cindex polyphony
1050
1051 La manière la plus facile d'entrer des fragments avec plus d'une voix
1052 sur une portée est d'entrer chaque voix comme une suite de notes
1053 (entre accolades : @code{@{...@}}), et de les combiner simultanément,
1054 en séparant les voix avec @code{\\}
1055
1056 @funindex \\
1057
1058 @lilypond[quote,verbatim,fragment]
1059 \new Staff \relative c' {
1060   c16 d e f
1061   <<
1062     { g4 f e | d2 e2 } \\
1063     { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
1064     { s2. | s4 b4 c2 }
1065   >>
1066 }
1067 @end lilypond
1068
1069 Le séparateur permet aux contextes @internalsref{Voice}@footnote{Ces
1070 voix polyphoniques sont parfois appelées @qq{couches} ou @qq{calques} dans
1071 d'autres logiciels de notation.}
1072 @cindex layers
1073 d'être identifiées.  Elles portent les noms @code{"1"}, @code{"2"},
1074 etc.  Dans chacun de ces contextes, la direction verticale des
1075 liaisons, hampes, etc. sont réglées de manière appropriée.
1076
1077 Ces voix sont toutes séparées de la voix qui contient les notes en
1078 dehors de la construction @code{<< \\ >>}.  Cela doit être pris en
1079 compte lorsqu'on fait des changements au niveau des voix.  Cela veut
1080 aussi dire que les liaisons de prolongation et d'articulation ne
1081 peuvent ni entrer ni sortir de la construction @code{<< \\ >>}.  À
1082 l'inverse, des voix parallèles venant de constructions @code{<< \\ >>}
1083 séparées sur la même portée sont dans les mêmes voix.  Voici le même
1084 exemple, avec des têtes de note différentes pour chaque voix.  Notez
1085 que le changement de style de tête de note n'affecte pas l'intérieur
1086 des constructions @code{<< \\ >>}.  Aussi, le changement à la deuxième
1087 voix dans la première construction @code{<< \\ >>} l'affecte aussi
1088 dans la deuxième construction @code{<< \\ >>}, et la voix est liée
1089 entre les deux constructions.
1090
1091 @cindex note heads, styles
1092
1093 @lilypond[quote,verbatim,fragment]
1094 \new Staff \relative c' {
1095   \override NoteHead #'style = #'cross
1096   c16 d e f
1097   <<
1098     { g4 f e } \\
1099     { \override NoteHead #'style = #'triangle
1100     r8 e4 d c8 ~ }
1101   >> |
1102   <<
1103     { d2 e2 } \\
1104     { c8 b16 a b8 g ~ g2 } \\
1105     { \override NoteHead #'style = #'slash s4 b4 c2 }
1106   >>
1107 }
1108 @end lilypond
1109
1110 La polyphonie ne change pas la relation des notes dans un bloc
1111 @code{\relative @{ @}}.  Chaque note est calculée en fonction de la
1112 note qui la précède immédiatement, sans tenir compte des voix
1113 différentes.
1114
1115 @example
1116 \relative @{ noteA << noteB \\ noteC >> noteD @}
1117 @end example
1118
1119 @code{noteC} est calculé relativement à @code{noteB}, pas à @code{noteA};
1120 @code{noteD} est calculé relativement à @code{noteC}, pas à @code{noteB} ou
1121 @code{noteA}.
1122
1123
1124 @node Explicitly instantiating voices
1125 @subsection Explicitly instantiating voices
1126
1127 Les contextes @internalsref{Voice} peuvent être déclarés manuellement
1128 dans un bloc @code{<< >>} pour créer de la musique polyphonique, en
1129 utilisant @code{\voiceOne}, jusqu'à @code{\voiceFour} pour assigner
1130 des directions de hampes et un déplacement horizontal pour chaque
1131 partie.
1132
1133 En particulier,
1134 @example
1135 << \upper \\ \lower >>
1136 @end example
1137
1138 @noindent
1139 équivaut à
1140
1141 @example
1142 <<
1143  \new Voice = "1" @{ \voiceOne \upper @}
1144  \new Voice = "2" @{ \voiceTwo \lower @}
1145 >>
1146 @end example
1147
1148 Les commandes @code{\voiceXXX} fixent la direction des hampes, des
1149 liaisons de prolongations et de phrasé, des articulations, des
1150 annotations, des points d'augmentation des notes pointées et des
1151 doigtés.  @code{\voiceOne} et @code{\voiceThree} font pointer ces
1152 objets vers le haut, alors que @code{\voiceTwo} et @code{\voiceFour}
1153 les font pointer vers le bas.  La commande @code{\oneVoice} les ramène
1154 aux critères normaux.
1155
1156 Une expression apparaissant directement dans un @code{<< >>}
1157 appartient à la voix principale.  Ceci est utile lorsque des voix
1158 supplémentaires apparaissent pendant que la voix principale est jouée.
1159  Voici une meilleure réalisation de l'exemple de la section
1160 précédente.  Les notes en croix démontrent que la mélodie principale
1161 est maintenant dans un seul contexte de voix.
1162
1163 @lilypond[quote,ragged-right,verbatim]
1164 \new Staff \relative c' {
1165   \override NoteHead #'style = #'cross
1166   c16 d e f
1167   \voiceOne
1168   <<
1169     { g4 f e | d2 e2 }
1170     \new Voice="1" { \voiceTwo
1171       r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1172       \oneVoice
1173     }
1174     \new Voice { \voiceThree
1175       s2. | s4 b4 c2
1176       \oneVoice
1177     }
1178   >>
1179   \oneVoice
1180 }
1181 @end lilypond
1182
1183 La définition correcte des voix permet à la mélodie d'être liée.
1184 @lilypond[quote,ragged-right,verbatim]
1185 \new Staff \relative c' {
1186   c16^( d e f
1187   \voiceOne
1188   <<
1189     { g4 f e | d2 e2) }
1190     \context Voice="1" { \voiceTwo
1191       r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1192       \oneVoice
1193     }
1194     \new Voice { \voiceThree
1195       s2. s4 b4 c2
1196       \oneVoice
1197     }
1198   >>
1199   \oneVoice
1200 }
1201 @end lilypond
1202
1203 Le fait d'éviter le séparateur @code{\\} permet aussi d'imbriquer des
1204 constructions polyphoniques, ce qui peut être une manière plus
1205 naturelle de taper la musique.
1206
1207 @lilypond[quote,ragged-right,verbatim]
1208 \new Staff \relative c' {
1209   c16^( d e f
1210   \voiceOne
1211   <<
1212     { g4 f e | d2 e2) }
1213     \context Voice="1" { \voiceTwo
1214       r8 e4 d c8 ~ |
1215       <<
1216         {c8 b16 a b8 g ~ g2}
1217         \new Voice { \voiceThree
1218           s4 b4 c2
1219           \oneVoice
1220         }
1221       >>
1222     \oneVoice
1223     }
1224   >>
1225   \oneVoice
1226 }
1227 @end lilypond
1228
1229 Dans certaines circonstances de polyphonie complexe, vous pourrez être
1230 amené à recourir à des voix supplémentaires afin d'éviter des
1231 collisions de notes.  Ces voix additionnelles s'ajoutent en
1232 définissant un identificateur, comme le montre l'exemple suivant :
1233
1234 @lilypond[quote,verbatim,ragged-right,relative=2]
1235 voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
1236
1237 \relative c''' <<
1238   { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
1239   { \voiceThree  b4} \\
1240   { \voiceFive d,} \\
1241   { \voiceTwo g,}
1242 >>
1243 @end lilypond
1244
1245 @node Collision Resolution
1246 @subsection Collision Resolution
1247
1248 D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
1249 fusionnées, mais lorsque la propriété @code{merge-differently-dotted}
1250 de l'objet @internalsref{NoteCollision} est définie, elles se trouvent
1251 fusionnées :
1252
1253 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
1254 \new Voice << {
1255   g8 g8
1256   \override Staff.NoteCollision
1257     #'merge-differently-dotted = ##t
1258   g8 g8
1259 } \\ { g8.[ f16] g8.[ f16] } >>
1260 @end lilypond
1261
1262 De même, vous pouvez fusionner une tête de blanche avec une tête de
1263 croche, en définissant @code{merge-differently-headed}
1264
1265 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
1266 \new Voice << {
1267  c8 c4.
1268  \override Staff.NoteCollision
1269    #'merge-differently-headed = ##t
1270 c8 c4.  } \\ { c2 c2 } >>
1271 @end lilypond
1272
1273 LilyPond empile aussi les silences à l'opposé des
1274 hampes, par exemple
1275
1276 @lilypond[quote,ragged-right,fragment,verbatim]
1277 \new Voice << c''4 \\ r4 >>
1278 @end lilypond
1279
1280 Lorsque trois notes ou plus s'agglutinent dans un même empilement, 
1281 @code{merge-differently-headed} ne peut mener à bien la fusion des 
1282 deux notes qui devraient l'être.  Pour obtenir une fusion optimale, 
1283 appliquez un décalage (@code{\shift}) à la note qui ne devrait pas
1284 s'empiler.  Dans la première mesure de l'exemple suivant, 
1285 @code{merge-differently-headed} ne fonctionne pas (la tête de la
1286 blanche est ancrée).  Dans la seconde mesure, @code{\shiftOn}
1287 s'applique pour sortir le sol (@code{g}) de l'alignement, et
1288 @code{merge-differently-headed} fonctionne correctement.
1289
1290 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1291 \override Staff.NoteCollision #'merge-differently-headed = ##t
1292 <<
1293   { d=''2 g2 } \\
1294   { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1295   { \voiceFour e,,2 e'2}
1296 >>
1297 <<
1298   { d'=''2 \shiftOn g2 } \\ 
1299   { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1300   { \voiceFour e,,2 e'2}
1301 >>
1302 @end lilypond
1303
1304
1305 @refcommands
1306
1307 @funindex \oneVoice
1308 @code{\oneVoice},
1309 @funindex \voiceOne
1310 @code{\voiceOne},
1311 @funindex \voiceTwo
1312 @code{\voiceTwo},
1313 @funindex \voiceThree
1314 @code{\voiceThree},
1315 @funindex \voiceFour
1316 @code{\voiceFour}.
1317
1318 @funindex \shiftOn
1319 @code{\shiftOn},
1320 @funindex \shiftOnn
1321 @code{\shiftOnn},
1322 @funindex \shiftOnnn
1323 @code{\shiftOnnn},
1324 @funindex \shiftOff
1325 @code{\shiftOff} : toutes ces commandes précisent quels accords de la
1326 voix courante doivent être combinés.  Les voix externes
1327 (habituellement, les voix un et deux) sont en @code{\shiftOff}, alors
1328 que les voix internes (trois et quatre) sont en @code{\shiftOn}.
1329 @code{\shiftOnn} et @code{\shiftOnnn} sont des niveaux supplémentaires
1330 de combinaison.
1331
1332 Quand LilyPond est dépassé, la propriété @code{force-hshift} de
1333 l'objet @internalsref{NoteColumn}, et des silences à hauteur
1334 déterminée, peuvent s'avérer utiles pour dicter au programme les choix
1335 de placement.
1336
1337 @lilypond[quote,verbatim,ragged-right]
1338 \relative <<
1339 {
1340   <d g>
1341   <d g>
1342 } \\ {
1343   <b f'>
1344   \once \override NoteColumn #'force-hshift = #1.7
1345   <b f'>
1346 } >>
1347 @end lilypond
1348
1349
1350 @seealso
1351 Référence du programme : les objets appropriés pour résoudre les
1352 collisions sont
1353 @internalsref{NoteCollision} et @internalsref{RestCollision}.
1354
1355
1356 @refbugs
1357
1358 Quand @code{merge-differently-headed} est utilisé avec une croche ou
1359 une valeur plus courte à hampe vers le haut, et une blanche hampe vers
1360 le bas, la croche se retrouve à la mauvaise place.
1361
1362 Il n'y a aucune prise en charge des agrégats dans lesquels une même
1363 note apparaît avec différentes altérations, plaquée en même temps.  Il
1364 est conseillé d'avoir recours aux enharmoniques, ou d'utiliser un
1365 cluster spécial (voir @ref{Clusters}).
1366
1367
1368
1369 @node Staff notation
1370 @section Staff notation
1371
1372 @cindex Staff notation
1373
1374 De la notation musicale concernant la portée, comme
1375 les armures, les clefs ou les chiffres de mesure.
1376
1377 @menu
1378 * Clef::
1379 * Key signature::
1380 * Time signature::
1381 * Partial measures::
1382 * Bar lines::
1383 * Unmetered music::
1384 * System start delimiters::
1385 * Staff symbol::
1386 * Writing music in parallel::
1387 @end menu
1388
1389
1390 @node Clef
1391 @subsection Clef
1392
1393 @funindex \clef
1394
1395 La clé indique quelles lignes de la portée correspondent à quelles
1396 hauteurs.  Elle est réglée par la commande @code{\clef}.
1397
1398 @lilypond[quote,ragged-right,fragment,verbatim]
1399 { c''2 \clef alto g'2 }
1400 @end lilypond
1401
1402 @cindex treble clef
1403 @cindex violin clef
1404 @cindex alto clef
1405 @cindex tenor clef
1406 @cindex bass clef
1407 @cindex french clef
1408 @cindex soprano clef
1409 @cindex mezzosoprano clef
1410 @cindex baritone clef
1411 @cindex varbaritone clef
1412 @cindex subbass clef
1413
1414 Les clés prises en charge vont jusqu'à
1415
1416 @multitable @columnfractions .33 .66
1417 @headitem Clef @tab Position
1418 @item @code{treble}, violin, G, G2 @tab
1419 Clé de Sol 2ème ligne
1420 @item @code{alto, C} @tab
1421 Clé d'Ut 3ème ligne
1422 @item @code{tenor} @tab
1423 Clé d'Ut 4ème ligne
1424 @item @code{bass, F} @tab
1425 Clé de Fa 4ème ligne
1426 @item @code{french} @tab
1427 Clé de Sol 1ère ligne
1428 @item @code{soprano} @tab
1429 Clé d'Ut 1ère ligne
1430 @item @code{mezzosoprano} @tab
1431 Clé d'Ut 2ème ligne
1432 @item @code{baritone} @tab
1433 Clé d'Ut 5ème ligne
1434 @item @code{varbaritone} @tab
1435 Clé de Fa 3ème ligne
1436 @item @code{subbass} @tab
1437 Clé de Fa 5ème ligne
1438 @item @code{percussion} @tab
1439 Clé de percussion
1440 @item @code{tab} @tab
1441 Clé de tablature
1442 @end multitable
1443
1444 En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
1445 transposée à l'octave respectivement inférieure ou supérieure, et
1446 @code{_15} ou @code{^15} la transpose de deux octaves.  L'argument
1447 @var{clefname} doit être mis entre guillemets lorsqu'il contient des
1448 caractères @qq{souligné} ou des nombres.  Par exemple,
1449
1450
1451 @cindex choral tenor clef
1452 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
1453 \clef "G_8" c4
1454 @end lilypond
1455
1456
1457 @commonprop
1458
1459 La commande @code{\clef "treble_8"} équivaut à définir
1460 @code{clefGlyph},
1461 @code{clefPosition} (qui contrôle la position verticale de la clé),
1462 @code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
1463 lorsque l'une de ces propriétés est changée.  Les exemples suivant
1464 font apparaître des possibilités pour régler les propriétés
1465 manuellement.
1466
1467 @lilypond[quote,ragged-right,verbatim]
1468 {
1469   \set Staff.clefGlyph = #"clefs.F"
1470   \set Staff.clefPosition = #2
1471   c'4
1472   \set Staff.clefGlyph = #"clefs.G"
1473   c'4
1474   \set Staff.clefGlyph = #"clefs.C"
1475   c'4
1476   \set Staff.clefOctavation = #7
1477   c'4
1478   \set Staff.clefOctavation = #0
1479   \set Staff.clefPosition = #0
1480   c'4
1481   \clef "bass"
1482   c'4
1483   \set Staff.middleCPosition = #4
1484   c'4
1485 }
1486 @end lilypond
1487
1488
1489 @seealso
1490
1491 Dans ce manuel : @ref{Grace notes}.
1492
1493 Référence du programme : @internalsref{Clef}.
1494
1495
1496 @node Key signature
1497 @subsection Key signature
1498
1499 @cindex Key signature
1500 @funindex \key
1501
1502 L'armure indique la tonalité dans laquelle la pièce doit être jouée.
1503 Elle comprend un ensemble d'altérations (dièses ou bémols) à la clé,
1504 c'est-à-dire au début de la portée.
1505
1506 On définit ou modifie l'armure avec la commande @code{\key}
1507
1508 @example
1509 @code{\key} @var{pitch} @var{type}
1510 @end example
1511
1512 @funindex \minor
1513 @funindex \major
1514 @funindex \minor
1515 @funindex \ionian
1516 @funindex \locrian
1517 @funindex \aeolian
1518 @funindex \mixolydian
1519 @funindex \lydian
1520 @funindex \phrygian
1521 @funindex \dorian
1522 @cindex church modes
1523
1524 Ici, @var{type} devrait être @code{\major} ou @code{\minor} afin
1525 d'avoir respectivement
1526 @var{pitch}-major ou @var{pitch}-minor.  Vous pouvez aussi avoir
1527 recours aux modes dits @qq{d'église} que sont @code{\ionian},
1528 @code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
1529 @code{\phrygian}, et @code{\dorian}.
1530
1531 Cette commande fixe la propriété de contexte
1532 @code{Staff.keySignature}.  Des armures inhabituelles peuvent être
1533 spécifiées en modifiant directement cette propriété.
1534
1535 Les nouveaux utilisateurs s'embrouillent souvent dans les altérations
1536 et les armures, car des notes naturelles prendront ou non un bécarre,
1537 selon l'armure.  Pour plus d'information, voir @ref{Accidentals} ou
1538 @ref{Accidentals and key signatures}.
1539
1540 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
1541 \key g \major
1542 f1
1543 fis
1544 @end lilypond
1545
1546
1547 @commonprop
1548
1549 Un bécarre est imprimé pour annuler toute altération précédente.  Ceci
1550 peut être supprimé en réglant la propriété
1551 @code{Staff.printKeyCancellation}.
1552
1553 @lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
1554 \key d \major
1555 a b cis d
1556 \key g \minor
1557 a bes c d
1558 \set Staff.printKeyCancellation = ##f
1559 \key d \major
1560 a b cis d
1561 \key g \minor
1562 a bes c d
1563 @end lilypond
1564
1565
1566 @seealso
1567
1568 Référence du programme : @internalsref{KeyCancellation},
1569 @internalsref{KeySignature}.
1570
1571
1572 @node Time signature
1573 @subsection Time signature
1574
1575 @cindex Time signature
1576 @cindex meter
1577 @funindex \time
1578
1579 Le chiffre de mesure indique le mètre d'une pièce : une alternance
1580 régulière de temps forts et de temps faibles.  Il est indiqué par une
1581 fraction au début de la portée.
1582
1583 Le chiffre de mesure est réglé par la commande @code{\time}.
1584
1585 @lilypond[quote,ragged-right,fragment,verbatim]
1586 \time 2/4 c'2 \time 3/4 c'2.
1587 @end lilypond
1588
1589 @commonprop
1590
1591 Le symbole imprimé peut être modifié avec la propriété @code{style}.
1592 En la réglant sur @code{#'()}, une fraction sera utilisée pour les
1593 chiffres de mesure 4/4 et 2/2.
1594
1595 @lilypond[fragment,quote,ragged-right,verbatim]
1596 \time 4/4 c'1
1597 \time 2/2 c'1
1598 \override Staff.TimeSignature #'style = #'()
1599 \time 4/4 c'1
1600 \time 2/2 c'1
1601 @end lilypond
1602
1603 Il y a bien d'autres options pour sa mise en place.  Voir @ref{Ancient time
1604 signatures} pour plus d'exemples.
1605
1606 @code{\time} définit les propriétés @code{timeSignatureFraction},
1607 @code{beatLength} et @code{measureLength} dans le contexte
1608 @code{Timing}, qui en principe est asservi à @internalsref{Score}.  La
1609 propriété @code{measureLength} détermine où des barres de mesure
1610 doivent être insérées, et comment les groupements de notes doivent
1611 être gérés.  Modifier la valeur de @code{timeSignatureFraction} donne
1612 également lieu à l'impression d'un symbole.
1613
1614 Plus d'options sont possibles au moyen de la fonction Scheme
1615 @code{set-time-signature}.  De concert avec le
1616 @internalsref{Measure_grouping_engraver}, elle crée les signes de
1617 @internalsref{MeasureGrouping}, qui facilitent la lecture de musiques
1618 modernes, complexes rythmiquement.  Dans l'exemple suivant, les
1619 mesures à 9/8 sont subdivisées en  @code{(2 2 2 3)}, ce qui est donné
1620 comme argument à la commande @code{set-time-signature}, en troisième
1621 position.
1622
1623 @lilypond[quote,ragged-right,verbatim]
1624 \score {
1625   \relative c'' {
1626     #(set-time-signature 9 8 '(2 2 2 3))
1627     g8[ g] d[ d] g[ g] a8[( bes g]) |
1628     #(set-time-signature 5 8 '(3 2))
1629     a4. g4
1630   }
1631   \layout {
1632     \context {
1633       \Staff
1634       \consists "Measure_grouping_engraver"
1635     }
1636   }
1637 }
1638 @end lilypond
1639
1640
1641 @seealso
1642
1643 Référence du programme : @internalsref{TimeSignature}, and
1644 @internalsref{Timing_translator}.
1645
1646 Exemples : @lsr{contemporary,compound-time-signature.ly}.
1647
1648
1649 @refbugs
1650
1651 Le groupement automatique des ligatures n'utilise pas les groupements
1652 spécifiés par @code{set-time-signature}.
1653
1654
1655 @node Partial measures
1656 @subsection Partial measures
1657
1658 @cindex anacrusis
1659 @cindex upbeat
1660 @cindex partial measure
1661 @cindex measure, partial
1662 @cindex shorten measures
1663 @funindex \partial
1664
1665
1666 Les mesures incomplètes, telles que les anacrouses ou levées, doivent
1667 être entrées avec la commande
1668
1669 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1670 \partial 16*5 c16 cis d dis e | a2. c,4 | b2
1671 @end lilypond
1672
1673
1674 La syntaxe de cette commande est
1675
1676 @example
1677 \partial @var{durée}
1678 @end example
1679
1680
1681 @code{durée} étant la valeur rythmique devant être ajoutée avant la
1682 mesure suivante.
1683
1684 Le programme traduit cette commande en
1685
1686 @example
1687 \set Timing.measurePosition = -@var{durée}
1688 @end example
1689
1690
1691 La propriété @code{measurePosition} contient un nombre rationnel qui
1692 indique, à ce point précis, où l'on en est de la mesure. Notez qu'il
1693 peut s'agir d'un nombre négatif ; @code{\partial 4} signifie, pour le
1694 programme : @qq{Dans cette mesure, il reste juste une noire}.
1695
1696 @refbugs
1697
1698
1699 Cette commande ne prend pas en compte les notes d'agrément ou
1700 appogiatures au début de la musique. Lorsqu'un morceau commence par
1701 une levée faite de petites notes, la commande @code{\partial} devrait
1702 être placée après celles-ci.
1703
1704 @lilypond[verbatim,quote,ragged-right,relative,fragment]
1705 \grace f16
1706 \partial 4
1707 g4
1708 a2 g2
1709 @end lilypond
1710
1711
1712 @code{\partial} n'est destiné qu'à être utilisé au début d'une pièce.
1713 Si on l'utilise ailleurs qu'au début, des messages d'erreurs peuvent
1714 s'afficher.
1715
1716 @node Bar lines
1717 @subsection Bar lines
1718
1719 @cindex Bar lines
1720 @funindex \bar
1721 @cindex measure lines
1722 @cindex repeat bars
1723
1724
1725 Les barres de mesures délimitent les mesures, mais peuvent aussi
1726 indiquer une reprise. En principe, elles sont insérées
1727 automatiquement, et les changements de ligne ne peuvent se faire qu'au
1728 niveau de ces barres.
1729
1730 Il est possible de forcer l'affichage d'une barre de mesure spéciale,
1731 avec la commande @code{\bar} :
1732
1733 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1734 c4 \bar "|:" c4
1735 @end lilypond
1736
1737
1738 Les styles de barres de mesure disponibles sont :
1739
1740 @lilypondfile[ragged-right,quote]{bar-lines.ly}
1741
1742
1743 En plus de cela, on peut demander @code{"||:"}, qui équivaut à
1744 @code{"|:"}, mais donnera, en cas de changement de ligne, une double
1745 barre à la fin de la première ligne, et une barre de reprise au début
1746 de la suivante.
1747
1748
1749 Il est possible d'autoriser un changement de ligne même s'il n'y a pas
1750 de barre de mesure visible, en utilisant :
1751
1752 @example
1753 \bar ""
1754 @end example
1755
1756 @noindent
1757
1758
1759 Ceci insérera une barre de mesure invisible, et permettra de changer
1760 de ligne à cet endroit.  Le nombre de mesures augmente en ce cas.
1761
1762
1763 Dans une partition écrite sur plusieurs portées, la commande
1764 @code{\bar} placée sur une portée s'appliquera automatiquement à
1765 toutes les portées. Les barres de mesure que l'on obtient alors sont
1766 d'un seul tenant sur les portées d'un @code{StaffGroup}, d'un
1767 @code{PianoStaff}, ou d'un @code{GrandStaff}.
1768
1769 @lilypond[quote,ragged-right,fragment,verbatim]
1770 <<
1771   \new StaffGroup <<
1772     \new Staff {
1773       e'4 d'
1774       \bar "||"
1775       f' e'
1776     }
1777     \new Staff { \clef bass c4 g e g }
1778   >>
1779   \new Staff { \clef bass c2 c2 }
1780 >>
1781 @end lilypond
1782
1783
1784 @commonprop
1785
1786 @funindex whichBar
1787 @funindex repeatCommands
1788 @funindex defaultBarType
1789
1790
1791 La commande @code{\bar }@var{bartype} sert de raccourci pour
1792 @code{\set Timing.whichBar = }@var{bartype}.  Dès que l'on définit
1793 @code{whichBar}, une barre de mesure sera créée suivant le style
1794 défini.
1795
1796
1797 Dès que la propriétée @code{whichBar} est définie, une barre de mesure
1798 est créée.  À chaque début de mesure elle est définie en tant que
1799 @code{Timing.defaultBarType}.  Les définitions telles que
1800 @code{repeatCommands} peuvent servir à remplacer les barres de mesure
1801 par défaut.
1802
1803 Nous vous invitons à utiliser @code{\repeat} pour indiquer les
1804 reprises. Voyez à ce sujet @ref{Repeats}.
1805
1806
1807 @seealso
1808
1809 Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
1810
1811 Référence du programme : @internalsref{BarLine} (faisant partie du
1812 contexte @internalsref{Staff}), @internalsref{SpanBar} (sur plusieurs
1813 portées).
1814
1815 D'autres exemples : @inputfileref{input/@/test,bar@/-lines@/.ly},
1816
1817
1818 @node Unmetered music
1819 @subsection Unmetered music
1820
1821 @cindex cadenza
1822 @funindex \cadenzaOn
1823 @funindex \cadenzaOff
1824
1825
1826 Les barres de mesure et les chiffres de mesure sont calculés
1827 automatiquement, ce qui n'est pas souhaitable dans la musique non
1828 mesurée --- les cadences, par exemple. Les commandes @code{\cadenzaOn}
1829 and @code{\cadenzaOff} permettent de désactiver et de rétablir la
1830 métrique automatique.
1831
1832 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
1833 c4 d e d
1834 \cadenzaOn
1835 c4 c d8 d d f4 g4.
1836 \cadenzaOff
1837 \bar "|"
1838 d4 e d c
1839 @end lilypond
1840
1841
1842 @refbugs
1843
1844
1845 LilyPond ne change de ligne ou de page qu'au niveau des barres de
1846 mesure.  Si votre musique non mesurée dure plus d'une ligne, il vous
1847 faudra insérer des barres de mesure invisibles, pour indiquer à quels
1848 endroit un changement de ligne peut intervenir.
1849
1850 @example
1851 \bar ""
1852 @end example
1853
1854 @noindent
1855
1856
1857 @node System start delimiters
1858 @subsection System start delimiters
1859
1860 @cindex start of system
1861 @cindex Staff, multiple
1862 @cindex bracket, vertical
1863 @cindex brace, vertical
1864 @cindex grand staff
1865 @cindex staff group
1866 @cindex staff, choir
1867
1868
1869 De nombreuses partitions sont écrites sur plus d'une portée.  Ces
1870 portées peuvent être regroupées de quatre manières différentes.
1871
1872 @itemize @bullet
1873 @item Le groupe de portées est attaché par une accolade sur la gauche,
1874 et les barres de mesure sont d'un seul tenant. Il s'agit du contexte
1875 @internalsref{GrandStaff}.
1876
1877 @lilypond[verbatim,ragged-right,quote]
1878 \new GrandStaff
1879 \relative <<
1880   \new Staff { c1 c }
1881   \new Staff { c c }
1882 >>
1883 @end lilypond
1884
1885 @item Le groupe de portées est attaché par un crochet, et les barres
1886 de mesure sont d'un seul tenant. Il s'agit du contexte
1887 @internalsref{StaffGroup}.
1888
1889 @lilypond[verbatim,ragged-right,quote]
1890 \new StaffGroup
1891 \relative <<
1892   \new Staff { c1 c }
1893   \new Staff { c c }
1894 >>
1895 @end lilypond
1896
1897
1898
1899 @item Le groupe de portées est attaché par un crochet, mais les barres
1900 de mesure sont séparées d'une portée à l'autre. Il s'agit du contexte
1901 @internalsref{ChoirStaff}.
1902
1903 @lilypond[verbatim,ragged-right,quote]
1904 \new ChoirStaff
1905 \relative <<
1906   \new Staff { c1 c }
1907   \new Staff { c c }
1908 >>
1909 @end lilypond
1910
1911 @item Les portées du groupe ne sont pas attachées (à part par une
1912 simple ligne verticale). Les barres de mesure sont détachées. Il
1913 s'agit de l'assemblage par défaut.
1914
1915 @lilypond[verbatim,ragged-right,quote]
1916 \relative <<
1917   \new Staff { c1 c }
1918   \new Staff { c c }
1919 >>
1920 @end lilypond
1921 @end itemize
1922
1923
1924 @seealso
1925
1926
1927 Pour les barres de mesure au début de chaque système, voir
1928 @internalsref{SystemStartBar}, @internalsref{SystemStartBrace}, et
1929 @internalsref{SystemStartBracket}.  Dans chaque contexte, seul l'un de
1930 ces styles est utilisé, et c'est la propriété
1931 @internalsref{systemStartDelimiter} qui détermine lequel.
1932
1933
1934 @node Staff symbol
1935 @subsection Staff symbol
1936
1937 @cindex adjusting staff symbol
1938
1939 Les notes, les symboles dynamiques, etc. sont regroupés dans un
1940 assemblage de lignes horizontales, que l'on nomme la portée (en
1941 anglais @qq{staff}, et @qq{staves} au pluriel).  Dans LilyPond, ces lignes
1942 sont dessinées au moyen d'un objet de mise en forme à part entière,
1943 nommé @code{staff symbol}.
1944
1945
1946 L'aspect du @code{staff symbol} peut être modifié selon différentes
1947 propriétés, telles que le nombre de lignes, leur épaisseur, ou leur
1948 éloignement. Vous en trouverez des exemples dans
1949 @lsr{staff,changing-the-number-of-lines-in-a-staff.ly}
1950 et
1951 @lsr{staff,changing-the-staff-size.ly}.
1952
1953
1954 De plus, les portées peuvent commencer et s'arrêter où l'on veut,
1955 grâce aux commandes @code{\startStaff} et @code{\stopStaff}.
1956
1957 @lilypond[verbatim,relative=2,fragment]
1958 b4 b
1959 \override Staff.StaffSymbol #'line-count = 2
1960 \stopStaff \startStaff
1961 b b
1962 \revert Staff.StaffSymbol #'line-count
1963 \stopStaff \startStaff
1964 b b
1965 @end lilypond
1966
1967
1968 Cette manière de procéder peut être utilisée pour introduire des
1969 @qq{ossias} dans des partitions à nombre de portées variable,
1970 comme sur l'exemple suivant :
1971
1972 @cindex ossia
1973
1974 @lilypondfile{ossia.ly}
1975
1976 @cindex staff lines, setting number of
1977 @cindex staff lines, setting thickness of
1978 @cindex thickness of staff lines, setting
1979 @cindex number of staff lines, setting
1980
1981 @seealso
1982
1983 Référence du programme : @internalsref{StaffSymbol}.
1984
1985 D'autres exemples : @lsrdir{staff}.
1986
1987 @node Writing music in parallel
1988 @subsection Writing music in parallel
1989
1990 @cindex Writing music in parallel
1991 @cindex Interleaved music
1992
1993 On peut écrire plusieurs voix de façon entremêlée :
1994
1995 @lilypond[quote,fragment,verbatim]
1996 \parallelMusic #'(voiceA voiceB) {
1997   r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
1998   c'2                                c'2                                |
1999   r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
2000   c'2                                c'2                                |
2001 }
2002 \new StaffGroup <<
2003   \new Staff \new Voice \voiceA
2004   \new Staff \new Voice \voiceB
2005 >>
2006 @end lilypond
2007
2008
2009
2010 @node Connecting notes
2011 @section Connecting notes
2012 De la notation qui affecte des groupes de notes.
2013
2014 @menu
2015 * Ties::
2016 * Slurs::
2017 * Phrasing slurs::
2018 * Laissez vibrer ties::
2019 * Automatic beams::
2020 * Manual beams::
2021 * Grace notes::
2022 @end menu
2023
2024
2025 @node Ties
2026 @subsection Ties
2027
2028 @cindex tie
2029 @funindex ~
2030
2031 Une liaison de tenue (ou de prolongation) relie deux notes adjacentes
2032 de même hauteur.  Dans les faits, une liaison de tenue prolonge la
2033 durée d'une note, et ne doit donc pas être confondue avec les liaisons
2034 d'articulation ou de phrasé.  Une liaison de tenue est indiquée au
2035 moyen du symbole appelé tilde @samp{~}.
2036
2037 @lilypond[quote,ragged-right,fragment,verbatim]
2038 e' ~ e' <c' e' g'> ~ <c' e' g'>
2039 @end lilypond
2040
2041
2042 Quand une liaison de tenue se trouve entre deux accords, toutes les
2043 notes de même hauteur entre ces deux accords seront reliées.  S'il n'y
2044 en a aucune, aucune liaison ne sera créée.  Il est également possible
2045 de lier partiellement deux accords, en mettant la liaison à
2046 l'intérieur des accords.
2047
2048 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2049 <c~ e g~ b> <c e g b>
2050 @end lilypond
2051
2052
2053 Une liaison de tenue est un moyen parmi d'autres de prolonger la durée
2054 d'une note, tout comme les notes pointées.  L'exemple suivant montre
2055 deux manières de noter exactement la même idée :
2056
2057
2058 @lilypond[quote,fragment,ragged-right]
2059 \time 3/4 c'2. c'2 ~ c'4
2060 @end lilypond
2061
2062 @noindent
2063
2064 Les liaisons de tenues sont utilisées soit quant la note dépasse de la
2065 mesure, ou quand les points ne suffisent pas à rendre le bon rythme.
2066 Lorsque l'on utilise ces liaisons, les valeurs rythmiques les plus
2067 longues doivent s'aligner sur les subidivisions de la mesure, comme
2068 ici :
2069
2070 @lilypond[fragment,quote,ragged-right]
2071 \relative {
2072   r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
2073 }
2074 @end lilypond
2075
2076
2077 Lorsque l'on doit lier de nombreuses notes sur plusieurs mesures, il
2078 devient plus facile d'avoir recours à la division automatique des
2079 notes (voir @ref{Automatic note splitting}).  Ce procédé divise
2080 automatiquement les notes trop longues, et les lie par-delà les barres
2081 de mesure.
2082
2083 @funindex \repeatTie
2084
2085
2086 Lorsque l'indication @q{2.} d'une reprise commence sur une note liée, la
2087 liaison doit être répétée. C'est à cela que sert la commande
2088 @code{\repeatTie}.
2089
2090 @lilypond[fragment,quote,ragged-right,relative=2]
2091 r <c e g>\repeatTie
2092 @end lilypond
2093
2094 @cindex repeating ties
2095 @cindex volta brackets and ties
2096
2097 @commonprop
2098
2099
2100 Les liaisons de tenues servent parfois à rendre un accord arpégé. Dans
2101 ce cas, les notes liées ne sont pas toutes l'une contre l'autre. Il
2102 faut alors définir comme vraie (@q{t} pour @q{true}) la propriété
2103 @code{tieWaitForNote}.  Cette même méthode peut servir, par exemple, à
2104 lier un trémolo à un accord :
2105
2106 @lilypond[fragment,verbatim,relative=1,ragged-right,quote]
2107 \set tieWaitForNote = ##t
2108 \grace { c16[~ e~ g]~ } <c, e g>2
2109 \repeat "tremolo" 8 { c32~ c'~ } <c c,>1
2110 e8~ c~ a~ f~ <e' c a f>2
2111 @end lilypond
2112
2113
2114 @refcommands
2115
2116
2117 @funindex \tieUp
2118 @code{\tieUp},
2119 @funindex \tieDown
2120 @code{\tieDown},
2121 @funindex \tieNeutral
2122 @code{\tieNeutral},
2123 @funindex \tieDotted
2124 @code{\tieDotted},
2125 @funindex \tieDashed
2126 @code{\tieDashed},
2127 @funindex \tieSolid
2128 @code{\tieSolid}.
2129
2130
2131 @seealso
2132
2133 Dans ce même manuel : @ref{Automatic note splitting}.
2134
2135 Référence du programme : @internalsref{Tie}.
2136
2137
2138
2139 @refbugs
2140
2141
2142 Un changement de portée, lorsqu'une liaison de tenue est active, ne
2143 peut produire une liaison oblique.
2144
2145 Il n'est pas vraiment possible de changer de clé ou d'octave écrite
2146 pendant une liaison de tenue.  Dans ces cas-là, il peut être plus
2147 judicieux d'utiliser un legato.
2148
2149 @node Slurs
2150 @subsection Slurs
2151
2152 @cindex Slurs
2153
2154
2155 Une liaison d'articulation indique que les notes doivent être
2156 jouées liées, ou @emph{legato}.  Ces liaisons s'indiquent au moyen de
2157 parenthèses.
2158
2159 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2160 f( g a) a8 b( a4 g2 f4)
2161 <c e>2( <b d>2)
2162 @end lilypond
2163
2164
2165 Il est possible d'indiquer l'orientation de la liaison, avec
2166 @code{\slur@emph{DIR}}, @code{@emph{DIR}} pouvant être soit @code{Up}
2167 pour une liaison vers le haut, @code{Down} pour une liaison vers le
2168 bas, ou encore @code{Neutral} pour laisser LilyPond décider.
2169
2170
2171 Cependant, il existe un raccourci pratique pour obliger les
2172 liaisons à s'orienter dans tel ou tel sens.   Il suffit pour cela
2173 d'ajouter @code{_} ou @code{^} avant d'ouvrir une parenthèse.  Ainsi,
2174
2175 @lilypond[relative=2,ragged-right,quote,verbatim,fragment]
2176 c4_( c) c^( c)
2177 @end lilypond
2178
2179
2180 Une seule liaison d'articulation peut être imprimée à la fois.
2181 S'il est nécessaire d'imprimer une liaison plus longue, englobant
2182 des liaisons plus courtes, il faudra utiliser des @ref{Phrasing slurs}.
2183
2184
2185 @commonprop
2186
2187
2188 Certains auteurs utilisent deux liaisons lorsqu'ils veulent
2189 lier des accords. Dans LilyPond, il faut pour cela définir comme
2190 vraie (@q{true}) la propriété @code{doubleSlurs} :
2191
2192 @lilypond[verbatim,ragged-right,relative,fragment,quote]
2193 \set doubleSlurs = ##t
2194 <c e>4 ( <d f> <c e> <d f> )
2195 @end lilypond
2196
2197
2198 @refcommands
2199
2200 @funindex \slurUp
2201 @code{\slurUp},
2202 @funindex \slurDown
2203 @code{\slurDown},
2204 @funindex \slurNeutral
2205 @code{\slurNeutral},
2206 @funindex \slurDashed
2207 @code{\slurDashed},
2208 @funindex \slurDotted
2209 @code{\slurDotted},
2210 @funindex \slurSolid
2211 @code{\slurSolid}.
2212
2213 @seealso
2214
2215 Référence du programme : @seeinternals{Slur}.
2216
2217
2218 @node Phrasing slurs
2219 @subsection Phrasing slurs
2220
2221 @cindex phrasing slurs
2222 @cindex phrasing marks
2223
2224
2225 Les liaisons de phrasé relient plusieurs notes et délimitent une
2226 phrase musicale.  On indique leut point de départ et d'arrivée avec
2227 @code{\(} et @code{\)} respectivement.
2228
2229 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2230 \time 6/4 c'\( d( e) f( e) d\)
2231 @end lilypond
2232
2233
2234 D'un point de vue typographique, rien ne distingue une liaison de
2235 phrasé d'une liaison d'articulation. Cependant, LilyPond les
2236 considère comme des objets différents. Une commande @code{\slurUp}
2237 n'affectera donc pas une liaison de phrasé : il faut plutôt utiliser
2238 @code{\phrasingSlurUp}, @code{\phrasingSlurDown} ou
2239 @code{\phrasingSlurNeutral}.
2240
2241
2242 Il n'est pas possible d'avoir plusieurs liaisons de phrasé en même temps.
2243
2244 @refcommands
2245
2246 @funindex \phrasingSlurUp
2247 @code{\phrasingSlurUp},
2248 @funindex \phrasingSlurDown
2249 @code{\phrasingSlurDown},
2250 @funindex \phrasingSlurNeutral
2251 @code{\phrasingSlurNeutral}.
2252
2253
2254 @seealso
2255
2256 Référence du programme : @internalsref{PhrasingSlur}.
2257
2258
2259 @node Laissez vibrer ties
2260 @subsection Laissez vibrer ties
2261 @cindex Laissez vibrer
2262 @cindex Ties, laissez vibrer
2263
2264
2265 Les liaisons @qq{Laissez vibrer} (L.V.) sont utilisées pour
2266 le piano, la harpe, et certains instruments de percussion.  Elles
2267 indiquent à l'instrumentiste de laisser sonner la note au lieu de
2268 l'étouffer.  Cet effet s'obtient avec la commande
2269 @code{\laissezVibrer}.
2270
2271 @lilypond[fragment,ragged-right,verbatim,relative=1]
2272 <c f g>\laissezVibrer
2273 @end lilypond
2274
2275 @seealso
2276
2277 Référence du programme :
2278 @internalsref{LaissezVibrerTie}
2279 @internalsref{LaissezVibrerTieColumn}
2280
2281 D'autres exemples :
2282 @lsr{connecting,laissez-vibrer-ties.ly}
2283
2284 @node Automatic beams
2285 @subsection Automatic beams
2286
2287
2288 LilyPond décide automatiquement de la manière de grouper les notes et
2289 d'imprimer les ligatures
2290
2291 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2292 \time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
2293 @end lilypond
2294
2295 Lorsque ces décisions ne sont pas satisfaisantes, il est
2296 possible de préciser quels groupements l'ont veut, ou même de définir
2297 des séquences de groupements en lieu et place des groupements
2298 par défaut. Voir @ref{Setting automatic beam behavior}
2299 pour plus de détails.
2300
2301
2302 La commande @code{\noBeam} peut servir à empêcher des notes
2303 individuelles d'être rattachées aux autres.
2304
2305 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2306 \time 2/4 c8 c\noBeam c c
2307 @end lilypond
2308
2309
2310 @seealso
2311
2312 Référence du programme : @internalsref{Beam}.
2313
2314
2315 @node Manual beams
2316 @subsection Manual beams
2317
2318 @cindex beams, manual
2319 @funindex ]
2320 @funindex [
2321
2322
2323 Dans certaines situations, il peut s'avérer nécessaire de
2324 supplanter l'algorithme de groupement automatique des notes, par
2325 exemple pour prolonger une ligature par-dessus un silence ou une barre
2326 de mesure.  Le début et la fin de la ligature sont alors indiqués par
2327 @code{[} et @code{]}.
2328
2329 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2330 {
2331   r4 r8[ g' a r8] r8 g[ | a] r8
2332 }
2333 @end lilypond
2334
2335
2336 @commonprop
2337
2338 @funindex stemLeftBeamCount
2339 @funindex stemRightBeamCount
2340
2341
2342 En principe, les sous-groupements à l'intérieur d'un groupe de notes
2343 sont déterminés automatiquement.  Cependant, les propriétés
2344 @code{stemLeftBeamCount} et @code{stemRightBeamCount} peuvent
2345 servir à contourner ce comportement.  Lorsque l'une ou l'autre de
2346 ces propriétés est définie, elle ne s'applique qu'une seule fois,
2347 après quoi sa définition est effacée.
2348
2349 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2350 {
2351    f8[ r16
2352       f g a]
2353    f8[ r16
2354    \set stemLeftBeamCount = #1
2355       f g a]
2356 }
2357 @end lilypond
2358
2359
2360 La propriété @code{subdivideBeams} sert à grouper les double-croches
2361 ou les valeurs plus brèves pulsation par pulsation, la pulsation
2362 étant définie par la propriété @code{beatLength}.
2363
2364 @lilypond[fragment,quote,relative=2,verbatim]
2365 c16[ c c c c c c c]
2366 \set subdivideBeams = ##t
2367 c16[ c c c c c c c]
2368 \set Score.beatLength = #(ly:make-moment 1 8)
2369 c16[ c c c c c c c]
2370 @end lilypond
2371 @funindex subdivideBeams
2372
2373 @noindent
2374 Pour plus d'information sur @code{make-moment}, voir
2375 @ref{Time administration}.
2376
2377
2378 Lorsqu'une ligature entre des notes franchit une barre de mesure,
2379 le retour à la ligne est en principe interdit à cet endroit.
2380 Ce comportement peut être changé en définissant @code{breakable}.
2381
2382 @funindex breakable
2383 @cindex beams and line breaks
2384 @cindex beams, kneed
2385 @cindex kneed beams
2386 @cindex auto-knee-gap
2387
2388
2389 @refbugs
2390
2391
2392 LilyPond insère automatiquement des ligatures d'orientation double
2393 (certaines notes vers le haut, d'autres vers le bas) lorsqu'il
2394 détecte un espace important entre des têtes de notes. Ce
2395 comportement peut être changé en paramétrant l'objet.
2396
2397
2398 Les ligatures d'orientation double à cheval sur deux portées
2399 ne peuvent être employées lorsque l'une des portées est invisible.
2400 Voir @ref{Hiding staves}.
2401
2402
2403 Les ligatures peuvent entrer en collision avec des symboles entourant
2404 les notes, contrairement aux textes ou aux altérations.
2405
2406
2407 @node Grace notes
2408 @subsection Grace notes
2409
2410 @funindex \grace
2411 @cindex ornaments
2412 @cindex grace notes
2413 @cindex appoggiatura
2414 @cindex acciaccatura
2415
2416
2417 Les petites notes sont des ornements entièrement écrits.  Les plus
2418 courantes sont les accacciatures, qui doivent se jouer très vite,
2419 et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
2420 et liée.  L'appoggiature est une petite note non barrée, qui vole
2421 une fraction de la durée de la note réelle qui la suit.
2422
2423 Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
2424 et @code{\appoggiatura}, comme le montre l'exemple suivant :
2425
2426 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2427 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
2428 \acciaccatura { g16[ f] } e4
2429 @end lilypond
2430
2431
2432 Ce sont là deux formes spéciales de la commande @code{\grace}, qui
2433 prend en charge toutes les petites notes. Si on la fait suivre
2434 d'une expression musicale, un groupe de petites notes sera créé,
2435 sans impact sur le reste de la métrique.
2436
2437 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2438 c4 \grace c16 c4
2439 \grace { c16[ d16] } c2 c4
2440 @end lilypond
2441
2442 @noindent
2443 Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
2444 commande @code{\grace} n'entame pas de liaison.
2445
2446 La durée des petites notes est interprétée par le programme en
2447 fonction d'une deuxième commande @code{\grace} indiquant la durée
2448 sous forme de deux nombres rationnels : le premier indique le rythme
2449 réel, le second indique le rythme des petites notes.  Reprenons
2450 l'exemple ci-dessus en y ajoutant ces couples de nombres :
2451
2452 @lilypond[quote,ragged-right]
2453 <<
2454   \relative c''{
2455     c4 \grace c16 c4 \grace {
2456     c16[ d16] } c2 c4
2457   }
2458   \new Lyrics \lyricmode {
2459     \override LyricText #'font-family = #'typewriter
2460
2461     \markup { (0,0) } 4
2462     \grace { \markup {
2463       ( \fraction 1 4 , \fraction -1 16 ) } 16 }
2464     \markup { (\fraction 1 4 , 0 ) } 4
2465     \grace {
2466       \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
2467       \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
2468     }
2469     \markup { ( \fraction 2 4 , 0 ) }
2470   }
2471 >>
2472 @end lilypond
2473
2474
2475 Les petites notes se placent de façon synchrone entre les différentes
2476 portées.  Dans l'exemple suivant, il y a deux petites double-croches
2477 pour chaque petite croche.
2478
2479 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2480 << \new Staff { e4 \grace { c16[ d e f] } e4 }
2481    \new Staff { c4 \grace { g8[ b] } c4 } >>
2482 @end lilypond
2483
2484 @funindex \afterGrace
2485
2486
2487 La commande @code{\afterGrace} sert à placer une petite note après
2488 une note réelle --- et non @emph{avant} comme d'ordinaire.
2489 Cette commande requiert deux arguments : la note réelle, et la ou les
2490 petites notes qui suivent.
2491
2492 @lilypond[ragged-right, verbatim,relative=2,fragment]
2493 c1 \afterGrace d1 { c16[ d] } c4
2494 @end lilypond
2495
2496
2497 Les petites notes se placent alors à 3/4 de la durée de la note
2498 réelle.  Cet espacement peut être changé en définissant
2499 @code{afterGraceFraction} ; ainsi,
2500
2501 @example
2502 #(define afterGraceFraction (cons 7 8))
2503 @end example
2504
2505 @noindent
2506 placera la petite note à 7/8 de la note réelle.
2507
2508 On peut obtenir le même effet manuellement, de la façon suivante :
2509
2510 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2511 \new Voice {
2512   << { d1^\trill_( }
2513      { s2 \grace { c16[ d] } } >>
2514   c4)
2515 }
2516 @end lilypond
2517
2518 @noindent
2519
2520 Le silence invisible peut être plus ou moins long (ici c'est une
2521 blanche) afin d'ajuster l'espace entre la note réelle et les petites
2522 notes.
2523
2524 Tout ce qui est introduit par @code{\grace} obéit à des règles
2525 typographiqes particulières, notamment pour règler l'orientation
2526 et la taille des objets.  De ce fait, toute subtilité de mise en
2527 forme devra être indiquée @emph{à l'intérieur} de la section
2528 introduite par @code{\grace} :
2529
2530 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2531 \new Voice {
2532   \acciaccatura {
2533     \stemDown
2534     f16->
2535     \stemNeutral
2536   }
2537   g4
2538 }
2539 @end lilypond
2540
2541 @noindent
2542 Tous les réglages ajoutés doivent également être désactivés dans cette
2543 même section.
2544
2545 Il est possible de changer la mise en forme de toutes les petites
2546 notes dans un morceau, au moyen de la fonction
2547 @code{add-grace-property}.  Ici, par exemple, l'on ôte la définition
2548 de l'orientation des objets @code{Stem} pour toutes les petites notes,
2549 afin que les hampes ne soient pas toujours orientées vers le haut.
2550
2551 @example
2552 \new Staff @{
2553  #(add-grace-property 'Voice 'Stem 'direction '())
2554  @dots{}
2555 @}
2556 @end example
2557
2558 @noindent
2559 Il est par ailleurs possible de chager les variables
2560 @code{startGraceMusic}, @code{stopGraceMusic},
2561 @code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
2562 @code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
2563 Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
2564
2565 @noindent
2566 Le trait que l'on trouve sur les hampes des accacciatures peut
2567 s'appliquer dans d'autres situations en définissant
2568 @code{\override Stem  #'stroke-style = #"grace"}.
2569
2570
2571 @commonprop
2572
2573
2574 Il est possible de forcer un espacement fluctuant des notes d'agrément.
2575
2576 @lilypond[relative=2,ragged-right]
2577 <<
2578   \override Score.SpacingSpanner #'strict-grace-spacing = ##t
2579   \new Staff {
2580      c'4
2581      \afterGrace
2582      c'4
2583      { c'16[ c'8 c'16] }
2584      c'4
2585   }  
2586   \new Staff {
2587      c'16[ c'16 c'16 c'16]
2588      c'16[ c'16 c'16 c'16]
2589      c'4
2590   }
2591 >>
2592 @end lilypond
2593
2594
2595 @seealso
2596
2597 Référence du programme : @internalsref{GraceMusic}.
2598
2599
2600 @refbugs
2601
2602 Une partition commençant par une section @code{\grace} doit faire
2603 intervenir la commande @code{\new Voice}, sans quoi la note réelle et
2604 la petite note se retrouveront sur des portées différentes.
2605
2606
2607 La synchronisation des petites notes se fait de façon parfois
2608 surprenante, car les autres objets de la portée --- barres de mesure,
2609 armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
2610 mélez des portées comprenant des petites notes et d'autres sans :
2611
2612 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2613 << \new Staff { e4 \bar "|:" \grace c16 d4 }
2614    \new Staff { c4 \bar "|:" d4 } >>
2615 @end lilypond
2616
2617 @noindent
2618 Il est possible de remédier à cela en insérant des silences invisibles
2619 correspondant aux durées des petites notes sur les autres portées ---
2620 les silences invisibles peuvent également être considérés comme des
2621 petites notes, s'ils suivent la commande @code{grace}.
2622
2623 @example
2624 \new Staff @{ c4 \bar "|:" \grace s16 d4 @}
2625 @end example
2626
2627
2628 Les sections de petites notes ne doivent être utilisées que dans des
2629 expressions musicales linéaires ; il n'est pas possible d'enchâsser
2630 ni de juxtaposer des sections de petites notes, faute de quoi le
2631 traitement du code peut échouer ou produire des erreurs.
2632
2633
2634 @node Expressive marks
2635 @section Expressive marks
2636
2637
2638 Les indications d'expression permettent aux interprètes de faire en
2639 sorte que la musique soit plus qu'un assemblage de notes et de rythmes.
2640
2641
2642 @menu
2643 * Articulations::
2644 * Fingering instructions::
2645 * Dynamics::
2646 * Breath marks::
2647 * Trills::
2648 * Glissando::
2649 * Arpeggio::
2650 * Falls and doits::
2651 @end menu
2652
2653
2654 @node Articulations
2655 @subsection Articulations
2656
2657 @cindex Articulations
2658 @cindex scripts
2659 @cindex ornaments
2660
2661
2662 Différents symboles peuvent être ajoutés au-dessus ou au-dessous des
2663 notes pour indiquer des ponctuations ou des modes de jeu différents.
2664 On les ajoute à chaque note au moyen d'un tiret suivi du caractère
2665 correspondant à l'articulation désirée.  En voici une démonstration :
2666
2667 @lilypondfile[quote,ragged-right]{script-abbreviations.ly}
2668
2669
2670 Il est possible de changer la signification de ces raccourcis : voir
2671 @file{ly/@/script@/-init@/.ly} pour quelques exemples.
2672
2673
2674 Même si LilyPond place automatiquement ces symboles, il est
2675 possible de l'obliger à les placer en-dessus ou en-dessous de la note,
2676 tout comme d'autres objets, en utilisant respectivement dans le code
2677 @code{_} et @code{^}.
2678
2679 @lilypond[quote,ragged-right,fragment,verbatim]
2680 c''4^^ c''4_^
2681 @end lilypond
2682
2683
2684 On peut ajouter d'autres symboles, avec la syntaxe
2685 @var{note}@code{\}@var{symbole}.  Là encore, on peut les forcer
2686 en bas ou en haut, avec @code{^} and @code{_}.  Ainsi :
2687
2688 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
2689 c\fermata c^\fermata c_\fermata
2690 @end lilypond
2691
2692 @cindex accent
2693 @cindex marcato
2694 @cindex staccatissimo
2695 @cindex espressivo
2696 @cindex fermata
2697 @cindex stopped
2698 @cindex staccato
2699 @cindex portato
2700 @cindex tenuto
2701 @cindex upbow
2702 @cindex downbow
2703 @cindex foot marks
2704 @cindex organ pedal marks
2705 @cindex turn
2706 @cindex open
2707 @cindex flageolet
2708 @cindex reverseturn
2709 @cindex trill
2710 @cindex prall
2711 @cindex mordent
2712 @cindex prallprall
2713 @cindex prallmordent
2714 @cindex prall, up
2715 @cindex prall, down
2716 @cindex mordent
2717 @cindex thumb marking
2718 @cindex segno
2719 @cindex coda
2720 @cindex varcoda
2721
2722
2723 Voici la liste exhaustive de tous les symboles possibles :
2724
2725 @lilypondfile[ragged-right,quote]{script-chart.ly}
2726
2727 @commonprop
2728
2729 Les symboles s'ordonnent verticalement suivant la propriété
2730 @code{script-priority}. Plus le nombre qui la définit est faible, plus
2731 le symbole se rapprochera de la note. Dans l'exemple suivant, l'objet
2732 @internalsref{TextScript} --- le dièse --- a d'abord la propriété la
2733 plus basse, et il est donc placé plus près de la note ; ensuite c'est
2734 l'objet @internalsref{Script} qui a la propriété la plus basse,
2735 et il se place alors sous le dièse.  Lorsque deux objets ont la même
2736 propriété, c'est l'ordre dans lequel ils sont indiqués qui détermine
2737 lequel sera placé en premier.
2738
2739 @lilypond[verbatim,relative=3,ragged-right,fragment,quote]
2740 \once \override TextScript #'script-priority = #-100
2741 a4^\prall^\markup { \sharp }
2742
2743 \once \override Script #'script-priority = #-100
2744 a4^\prall^\markup { \sharp }
2745 @end lilypond
2746
2747
2748 @seealso
2749
2750 Référence du programme : @internalsref{Script}.
2751
2752
2753 @refbugs
2754
2755
2756 Ces symboles sont présents sur la partition imprimée, mais
2757 n'ont pas d'effet sur le rendu sonore de la musique en MIDI.
2758
2759
2760 @node Fingering instructions
2761 @subsection Fingering instructions
2762
2763 @cindex fingering
2764 @cindex finger change
2765
2766
2767 Les doigtés peuvent être indiqués comme suit :
2768 @example
2769 @var{note}-@var{chiffre_du_doigt}
2770 @end example
2771 Pour les substitutions de doigts, on a recours à une indication
2772 textuelle (commande @code{\markup}) de doigté
2773 (commande @code{\finger} :
2774
2775 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
2776 c4-1 c-2 c-3 c-4
2777 c^\markup { \finger "2 - 3" }
2778 @end lilypond
2779
2780
2781 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
2782 dans une partition de violoncelle, si une note doit être jouée
2783 avec le pouce (@q{thumb} en anglais) :
2784
2785 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2786 <a_\thumb a'-3>8 <b_\thumb b'-3>
2787 @end lilypond
2788
2789
2790 Les doigtés des accords peuvent être saisis note par note,
2791 en les indiquant après chaque hauteur de note :
2792
2793 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2794 < c-1 e-2 g-3 b-5 >4
2795 @end lilypond
2796
2797
2798 @commonprop
2799
2800 On peut contrôler précisément les doigtés des accords en réglant
2801 la propriété @code{fingeringOrientations} :
2802
2803 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
2804 \set fingeringOrientations = #'(left down)
2805 <c-1 es-2 g-4 bes-5 > 4
2806 \set fingeringOrientations = #'(up right down)
2807 <c-1 es-2 g-4 bes-5 > 4
2808 @end lilypond
2809
2810
2811 Cette propriété permet également, dans de la musique monophonique,
2812 d'indiquer des doigtés très proches des têtes de notes.
2813
2814 @lilypond[verbatim,ragged-right,quote,fragment]
2815 \set fingeringOrientations = #'(right)
2816 <es'-2>4
2817 @end lilypond
2818
2819
2820 @seealso
2821
2822 Référence du programme : @internalsref{Fingering}.
2823
2824 D'autres exemples : @lsr{expressive,fingering-chords.ly}.
2825
2826
2827 @node Dynamics
2828 @subsection Dynamics
2829
2830 @cindex Dynamics
2831 @funindex \pppp
2832 @funindex \ppp
2833 @funindex \pp
2834 @funindex \p
2835 @funindex \mp
2836 @funindex \mf
2837 @funindex \f
2838 @funindex \ff
2839 @funindex \fff
2840 @funindex \ffff
2841 @funindex \fp
2842 @funindex \sf
2843 @funindex \sff
2844 @funindex \sp
2845 @funindex \spp
2846 @funindex \sfz
2847 @funindex \rfz
2848
2849
2850 À chaque nuance absolue correspond une commande, qui peut être
2851 indiquée après une note : @code{c4\ff} par exemple.
2852 Les commandes de nuances disponibles sont
2853 @code{\ppppp}, @code{\pppp}, @code{\ppp},
2854 @code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f},
2855 @code{\ff}, @code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf},
2856 @code{\sff}, @code{\sp}, @code{\spp}, @code{\sfz}, et @code{\rfz}.
2857
2858 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2859 c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
2860 c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
2861 @end lilypond
2862
2863 @funindex \<
2864 @funindex \>
2865 @funindex \!
2866
2867
2868 Un crescendo est délimité par @code{\<} et @code{\!}, ou peut se
2869 terminer par une commande de nuance.  Au lieu de @code{\<}
2870 ou @code{\>}, on peut aussi utiliser @code{\cr} et @code{\decr}.
2871 Ces indications sont attachées aux notes ; aussi si l'on veut
2872 faire se succéder plusieurs nuances pendant une note tenue, il faudra
2873 avoir recours à des silences invisibles :
2874
2875 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2876 c\< c\! d\> e\!
2877 << f1 { s4 s4\< s4\! \> s4\! } >>
2878 @end lilypond
2879
2880 @noindent
2881
2882 En principe, un crescendo --- s'il est imprimé sous forme graphique --
2883 commence au bord gauche de la note de départ, et se termine au
2884 bord droit de la note d'arrivée.  Cependant, si la note d'arrivée
2885 est sur un premier temps, le crescendo s'arrêtera au niveau de la
2886 barre de mesure qui la précède.  Ce comportement peut être annulé
2887 en définissant comme fausse (lettre @q{f}) la propriété
2888 @code{hairpinToBarline} :
2889
2890 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2891 \set hairpinToBarline = ##f
2892 c4\< c2. c4\!
2893 @end lilypond
2894
2895 @c VERIF sens de soufflet
2896 On peut avoir recours à l'indication @code{\espressivo} pour
2897 indiquer un @qq{soufflet} --- crescendo puis decrescendo --- sur
2898 une seule note.
2899
2900 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2901 c2 b4 a g1\espressivo
2902 @end lilypond
2903
2904
2905 Cependant, ces deux indications graphiques peuvent se trouver
2906 très comprimées.  Pour les rallonger, on peut modifier la propriété
2907 @code{minimum-length} dans @internalsref{Voice}.@internalsref{Hairpin}
2908 --- @internalsref{Voice} étant le contexte, et @internalsref{Hairpin}
2909 l'objet affecté. Par exemple :
2910
2911 @example
2912 \override Voice.Hairpin #'minimum-length = #5
2913 @end example
2914
2915 @cindex al niente
2916 @cindex niente, al
2917
2918
2919 Des crescendos ou decrescendos @qq{al niente} peuvent être indiqués
2920 de manière graphique, en définissant comme vraie (lettre @q{t}) la
2921 propriété  @code{circled-tip}, ce qui affiche un cercle à leur
2922 extrémité.
2923
2924 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2925 \override Hairpin #'circled-tip = ##t
2926 c2\< c\!
2927 c4\> c\< c2\!
2928 @end lilypond
2929
2930
2931 @cindex crescendo
2932 @cindex decrescendo
2933 @cindex diminuendo
2934
2935
2936 Au lieu d'une notation graphique des crescendos, on peu utiliser
2937 une notation textuelle comme @emph{cresc.} :
2938
2939 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2940 \setTextCresc
2941 c\< d e f\!
2942 \setHairpinCresc
2943 e\> d c b\!
2944 \setTextDecresc
2945 c\> d e f\!
2946 \setTextDim
2947 e\> d c b\!
2948 @end lilypond
2949
2950
2951 On peut même ajouter ses propres indications textuelles :
2952
2953 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2954 \set crescendoText = \markup { \italic "cresc. poco" }
2955 \set crescendoSpanner = #'dashed-line
2956 a'2\< a a a\!\mf
2957 @end lilypond
2958
2959
2960 Pour créer des indications de nuances qui restent alignées
2961 avec les nuances habituelles, voir @ref{New dynamic marks}.
2962
2963 Le positionnement vertical des nuances est géré par
2964 @internalsref{DynamicLineSpanner}.
2965
2966 @commonprop
2967
2968
2969 Des nuances différentes situées --- ou commençant --- sur une même
2970 note seront alignées verticalement.  Pour aligner des nuances qui ne
2971 se situeraient pas sur une même note, il est possible d'augmenter
2972 la propriété @code{staff-padding}.
2973
2974 @example
2975 \override DynamicLineSpanner #'staff-padding = #4
2976 @end example
2977
2978
2979 Cette propriété peut aussi servir à régler des problèmes de
2980 collisions entre des nuances et d'autres objets.
2981
2982
2983 Les crescendos ou decrescendos qui aboutissent sur la première note
2984 d'une nouvelle ligne ne sont imprimés que jusqu'à la fin de la ligne
2985 précédente.  Ce comportement peut être outrepassé en définissant :
2986
2987 @example
2988 \override Score.Hairpin #'after-line-breaking = ##t
2989 @end example
2990
2991
2992 Les crescendos et decrescendos indiqués textuellement --- tels que
2993 @emph{cresc.} ou @emph{dim.} --- sont suivis de pointillés qui montrent
2994 leur étendue.  On peut empêcher l'impression de ces pointillés avec :
2995
2996 @example
2997 \override DynamicTextSpanner #'dash-period = #-1.0
2998 @end example
2999
3000
3001 @refcommands
3002
3003 @funindex \dynamicUp
3004 @code{\dynamicUp},
3005 @funindex \dynamicDown
3006 @code{\dynamicDown},
3007 @funindex \dynamicNeutral
3008 @code{\dynamicNeutral}.
3009
3010
3011 @seealso
3012
3013 Référence du programme : @internalsref{DynamicText}, @internalsref{Hairpin}.
3014
3015 Le placement vertical de ces éléments graphiques est géré par le
3016 @internalsref{DynamicLineSpanner}.
3017
3018
3019 @node Breath marks
3020 @subsection Breath marks
3021
3022
3023 Les indications de respiration sont indiquées par la commande @code{\breathe}.
3024
3025 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3026 c'4 \breathe d4
3027 @end lilypond
3028
3029
3030 @commonprop
3031
3032
3033 On peut choisir le glyphe imprimé par cette commande, en
3034 modifiant la propriété @code{text} relative à l'objet
3035 @code{BreathingSign} pour lui affecter n'importe quelle indication.
3036 Par exemple :
3037
3038 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
3039 c'4
3040 \override BreathingSign #'text
3041   = #(make-musicglyph-markup "scripts.rvarcomma")
3042 \breathe
3043 d4
3044 @end lilypond
3045
3046 @seealso
3047
3048 Référence du programme : @internalsref{BreathingSign}.
3049
3050 D'autres exemples : @inputfileref{input/@/regression,breathing@/-sign@/.ly}.
3051
3052
3053 @node Trills
3054 @subsection Trills
3055
3056 Les trilles brefs s'indiquent comme n'importe quelle ponctuation :
3057 voir @ref{Articulations}.
3058
3059
3060 Les trilles plus longs sont délimités par @code{\startTrillSpan} et
3061 @code{\stopTrillSpan} :
3062
3063 @lilypond[verbatim,ragged-right,relative=2,quote,fragment]
3064 \new Voice {
3065   << { c1 \startTrillSpan }
3066      { s2. \grace { d16[\stopTrillSpan e] } } >>
3067   c4 }
3068 @end lilypond
3069
3070 @cindex Pitched trills
3071
3072
3073 Les trilles qui font intervenir une hauteur précise peuvent être
3074 indiqués par la commande @code{pitchedTrill}.
3075
3076 @lilypond[ragged-right,verbatim,fragment,relative=1,quote]
3077 \pitchedTrill c4\startTrillSpan fis
3078 f\stopTrillSpan
3079 @end lilypond
3080
3081
3082 La premier argument est la note réelle ; le second est une
3083 hauteur qui sera imprimée entre parenthèses et sans hampe.
3084
3085
3086 @refcommands
3087
3088 @code{\startTrillSpan},
3089 @funindex \startTrillSpan
3090 @code{\stopTrillSpan}.
3091 @funindex \stopTrillSpan
3092
3093
3094 @seealso
3095
3096 Référence du programme : @internalsref{TrillSpanner}.
3097
3098
3099 @node Glissando
3100 @subsection Glissando
3101
3102 @cindex Glissando
3103 @funindex \glissando
3104
3105
3106 Un glissando relie une hauteur à une autre en passant par chaque
3107 hauteur intermédiaire.  Il est indiqué graphiquement, par une ligne ou
3108 des vaguelettes entre ces deux notes. On l'obtient en accolant la
3109 commande @code{\glissando} à la première note.
3110
3111 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
3112 c2\glissando c'
3113 \override Glissando #'style = #'zigzag
3114 c2\glissando c,
3115 @end lilypond
3116
3117
3118 @seealso
3119
3120 Référence du programme : @internalsref{Glissando}.
3121
3122 D'autres exemples : @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}.
3123
3124
3125 @refbugs
3126
3127
3128 Il n'est pas possible d'imprimer un texte (tel que @emph{gliss.})
3129 sur la ligne de glissando.
3130
3131 @node Arpeggio
3132 @subsection Arpeggio
3133
3134 @cindex Arpeggio
3135 @cindex broken chord
3136 @funindex \arpeggio
3137
3138
3139 On peut indiquer qu'un accord doit être arpégé en lui accolant la
3140 commande @code{\arpeggio} :
3141
3142 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3143 <c e g c>\arpeggio
3144 @end lilypond
3145
3146
3147 Pour spécifier qu'un autre accord doit être joué plaqué et non
3148 arpégé, on peut remplacer ce signe par un crochet :
3149
3150 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3151 \arpeggioBracket
3152 <c' e g c>\arpeggio
3153 @end lilypond
3154
3155
3156 Le sens de l'arpège est parfois indiqué, par une flèche suivant la
3157 vaguelette :
3158
3159 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3160 \new Voice {
3161   \arpeggioUp
3162   <c e g c>\arpeggio
3163   \arpeggioDown
3164   <c e g c>\arpeggio
3165 }
3166 @end lilypond
3167
3168
3169 @commonprop
3170
3171 Quand un arpège se lit sur plusieurs portées, il est possible
3172 d'indiquer l'arpège sur chacune des portées, puis de relier la
3173 ligne de vaguelettes en définissant comme vraie la propriété
3174 @code{connectArpeggios}, par exemple dans le contexte
3175 @internalsref{PianoStaff} :
3176
3177 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3178 \new PianoStaff <<
3179   \set PianoStaff.connectArpeggios = ##t
3180   \new Staff { <c' e g c>\arpeggio }
3181   \new Staff { \clef bass <c,, e g>\arpeggio }
3182 >>
3183 @end lilypond
3184
3185
3186 @refcommands
3187
3188 @code{\arpeggio},
3189 @funindex \arpeggioUp
3190 @code{\arpeggioUp},
3191 @funindex \arpeggioDown
3192 @code{\arpeggioDown},
3193 @funindex \arpeggioNeutral
3194 @code{\arpeggioNeutral},
3195 @funindex \arpeggioBracket
3196 @code{\arpeggioBracket}.
3197
3198
3199 @seealso
3200
3201 Dans ce même manuel : @ref{Ties}, pour d'autres notations des
3202 arpèges.
3203
3204 Référence du programme : @internalsref{Arpeggio}.
3205
3206
3207 @refbugs
3208
3209 Il est impossible de mêler au même moment, dans un contexte
3210 @internalsref{PianoStaff}, des lignes d'arpèges
3211 connectées et d'autres non connectées.
3212
3213 @node Falls and doits
3214 @subsection Falls and doits
3215
3216
3217 Des indications de désinence peuvent être obtenues au moyen de la
3218 commande @code{\bendAfter} :
3219
3220 @lilypond[fragment,ragged-right,relative=2]
3221 \override Score.SpacingSpanner #'shortest-duration-space = #3.0
3222 c4-\bendAfter #+5
3223 c4-\bendAfter #-3
3224 @end lilypond
3225
3226
3227 @node Repeats
3228 @section Repeats
3229
3230
3231 Une des notions essentielles, dans la musique, est le fait que des
3232 éléments soient joués plusieurs fois. Il existe de nombreuses façons
3233 de noter ces reprises.
3234
3235 @menu
3236 * Repeat types::
3237 * Repeat syntax::
3238 * Repeats and MIDI::
3239 * Manual repeat commands::
3240 * Tremolo repeats::
3241 * Tremolo subdivisions::
3242 * Measure repeats::
3243 @end menu
3244
3245
3246 @node Repeat types
3247 @subsection Repeat types
3248
3249 @cindex repeats
3250 @funindex \repeat
3251
3252 On peut indiquer des répétitions de toutes les façons suivantes :
3253
3254 @table @code
3255 @item unfold
3256 La musique qui doit être répétée sera entièrement imprimée (et jouée).
3257 Ceci est particulièrement utile dans de la musique répétitive.  Cette
3258 reprise est la seule à être prise en compte dans le rendu MIDI.
3259
3260 @item volta
3261 Le passage répété ne sera pas écrit explicitement, mais il sera 
3262 encadré sur la partition par des barres de reprises, et peut
3263 se terminer par plusieurs fins alternatives, imprimées de gauche
3264 à droite sous des crochets.  Il s'agit là de la notation courante
3265 des reprises avec des fins alternatives.  Ces dernières, par défaut,
3266 ne seront pas jouées dans le rendu MIDI.
3267
3268 @item tremolo
3269 Pour réaliser des trémolos.  Ceux-ci, par défaut, ne seront pas
3270 joués dans le rendu MIDI.
3271
3272 @item percent
3273 Pour répéter des temps ou des mesures, sous forme de signes de
3274 pourcentage.  Ceux-ci, par défaut, ne seront pas joués dans le rendu
3275 MIDI.  Les répétitions indiquées par ces symboles doivent être
3276 déclarées dans un contexte @code{Voice}.
3277
3278 @end table
3279
3280
3281 @node Repeat syntax
3282 @subsection Repeat syntax
3283
3284 @cindex volta
3285 @cindex prima volta
3286 @cindex seconda volta
3287
3288 Tous les différents types de reprises se spécifient dans
3289 LilyPond avec une même construction syntaxique, qui est :
3290
3291
3292 @example
3293 \repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{fragment_à_répéter}
3294 @end example
3295
3296 On peut ajouter, pour indiquer une fin alternative :
3297 @funindex \alternative
3298 @example
3299 \alternative @{
3300  @var{alternative1}
3301  @var{alternative2}
3302  @var{alternative3}
3303  @dots{}
3304 @}
3305 @end example
3306
3307 @noindent
3308 chaque @var{alternative} étant une expression musicale.  Si l'on donne
3309 trop peu d'alternatives en regard du nombre de fois où le passage doit
3310 être rejoué, la première alternative sera jouée plusieurs fois.
3311
3312
3313 Les reprises courantes s'indiquent comme ceci :
3314
3315 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3316 c1
3317 \repeat volta 2 { c4 d e f }
3318 \repeat volta 2 { f e d c }
3319 @end lilypond
3320
3321
3322 Et avec des fins alternatives :
3323
3324 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3325 c1
3326 \repeat volta 2 {c4 d e f}
3327 \alternative { {d2 d} {f f,} }
3328 @end lilypond
3329
3330 Il est possible de créer des répétitions avec une levée.
3331
3332 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3333 \new Staff {
3334   \partial 4
3335   \repeat volta 4 { e | c2 d2 | e2 f2 | }
3336   \alternative { { g4 g g } { a | a a a a | b2. } }
3337 }
3338 @end lilypond
3339
3340 @funindex \repeatTie
3341 Des liaisons de tenue peuvent être ajoutées à toute alternative :
3342
3343 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3344 c1
3345 \repeat volta 2 {c4 d e f ~ }
3346 \alternative { {f2 d} {f\repeatTie f,} }
3347 @end lilypond
3348
3349
3350 On peut raccourcir les crochets indiquant les fins alternatives,
3351 en définissant la propriété @code{voltaSpannerDuration}.  Dans 
3352 l'exemple suivant, le crochet ne se prolonge que sur une mesure
3353 à 3/4.
3354
3355 @lilypond[verbatim,ragged-right,quote]
3356 \relative c''{
3357   \time 3/4
3358   c c c
3359   \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
3360   \repeat "volta" 5 { d d d }
3361   \alternative { { e e e f f f }
3362   { g g g } }
3363 }
3364 @end lilypond
3365
3366 Si l'on souhaite à la fois terminer une ligne par une double barre et
3367 débuter la ligne suivante avec une section reprise, on peut utiliser
3368 @example
3369 @dots{} \bar "||:" \break
3370 \repeat volta 2 @{ @dots{}
3371 @end example
3372
3373 Consultez @ref{Bar lines} pour plus d'informations.
3374
3375 @seealso
3376
3377 D'autres exemples :
3378
3379 Les crochets précédant une reprise s'impriment d'ordinaire
3380 seulement au-dessus de la portée du haut.  On peut ajuster cela
3381 en définissant la propriété @code{voltaOnThisStaff} : voir
3382 @lsr{repeats,volta@/-multi@/-staff@/.ly}
3383
3384 @refbugs
3385
3386 @cindex repeat, ambiguous
3387
3388 Des reprises enchassées telles que
3389
3390 @example
3391 \repeat @dots{}
3392 \repeat @dots{}
3393 \alternative
3394 @end example
3395
3396 @noindent
3397 présentent une ambiquïté, dans la mesure où l'on ne sait à quelle
3398 section @code{\repeat} attribuer la section @code{\alternative}.
3399 Pour résoudre cette ambiguïté, il convient de toujours insérer
3400 la commande @code{\alternative} à l'intérieur de la section @code{\repeat}.  
3401 Il est préférable, dans une telle situation, 
3402 d'utiliser des accolades pour plus de clarté.
3403
3404
3405 Lorsqu'une alternative commence, les informations de métrique sont
3406 perdues, il faut donc les rappeler après une reprise, par exemple
3407 en définissant @code{Score.measurePosition} ou en invoquant la commande
3408 @code{\partial}.  De même, aucune liaison (de tenue ou autre)
3409 n'est répétée.
3410
3411 Les crochets qui indiquent les alternatives ne sont pas alignés 
3412 verticalement.
3413
3414
3415 @node Repeats and MIDI
3416 @subsection Repeats and MIDI
3417
3418 @cindex expanding repeats
3419 @funindex \unfoldRepeats
3420
3421 Au prix de quelques réglages, les reprises de toutes sortes peuvent
3422 être rendues dans le fichier MIDI.  Il suffit pour cela d'avoir
3423 recours à la fonction @code{\unfoldRepeats}, qui rend toutes les
3424 reprises explicites --- comme celles du type @code{unfold}.
3425
3426
3427 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
3428 \unfoldRepeats {
3429   \repeat tremolo 8 {c'32 e' }
3430   \repeat percent 2 { c''8 d'' }
3431   \repeat volta 2 {c'4 d' e' f'}
3432   \alternative {
3433     { g' a' a' g' }
3434     {f' e' d' c' }
3435   }
3436 }
3437 \bar "|."
3438 @end lilypond
3439
3440
3441 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour
3442 le rendu MIDI, il faut établir deux blocs @code{\score} : un pour le 
3443 MIDI, avec des reprises explicites, et l'autre pour la partition, avec
3444 des reprises notées sous forme de barres de reprises, de trémolos ou
3445 de symboles de pourcentage.  Par exemple
3446
3447 @example
3448 \score @{
3449  @var{..musique..}
3450  \layout @{ ..  @}
3451 @}
3452 \score @{
3453  \unfoldRepeats @var{..musique..}
3454  \midi @{ ..  @}
3455 @}
3456 @end example
3457
3458
3459 @node Manual repeat commands
3460 @subsection Manual repeat commands
3461
3462 @funindex repeatCommands
3463
3464
3465 La propriété @code{repeatCommands} sert à contrôler la mise en forme
3466 des reprises.  On la définit par une suite de commandes
3467 Scheme contrôlant les reprises.
3468
3469 @table @asis
3470 @item @code{start-repeat}
3471 Pour imprimer une barre de reprise @code{|:}
3472
3473 @item @code{end-repeat}
3474 Pour imprimer une barre de reprise @code{:|}
3475
3476 @item @code{(volta @var{texte})}
3477 Pour imprimer un crochet indiquant une alternative.  Le texte 
3478 @var{texte} mentionné dans le crochet peut être n'importe quelle
3479 chaîne de caractères, ou une indication musicale 
3480 --- voir @ref{Text markup}.
3481 Attention cependant à changer la police : la police employée par défaut
3482 pour les chiffres ne contient aucun caractère alphabétique.
3483
3484 @item @code{(volta #f)}
3485
3486 Pour terminer un crochet indiquant une alternative.
3487 @end table
3488
3489 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
3490 c4
3491   \set Score.repeatCommands = #'((volta "93") end-repeat)
3492 c4 c4
3493   \set Score.repeatCommands = #'((volta #f))
3494 c4 c4
3495 @end lilypond
3496
3497
3498 @seealso
3499
3500 Référence du programme : @internalsref{VoltaBracket},
3501 @internalsref{RepeatedMusic},
3502 @internalsref{VoltaRepeatedMusic},
3503 @internalsref{UnfoldedRepeatedMusic}, et
3504 @internalsref{FoldedRepeatedMusic}.
3505
3506
3507 @node Tremolo repeats
3508 @subsection Tremolo repeats
3509
3510 @cindex tremolo beams
3511
3512
3513 On peut placer une notation de trémolo entre deux notes, avec la
3514 commande @code{\repeat} suivie du style de trémolo désiré :
3515 @lilypond[quote,verbatim,ragged-right]
3516 \new Voice \relative c' {
3517   \repeat "tremolo" 8 { c16 d16 }
3518   \repeat "tremolo" 4 { c16 d16 }
3519   \repeat "tremolo" 2 { c16 d16 }
3520 }
3521 @end lilypond
3522
3523
3524 On peut aussi indiquer un trémolo sur une seule note, qu'il faudra
3525 alors laisser sans accolades.
3526
3527 @lilypond[quote,verbatim,ragged-right]
3528 \repeat "tremolo" 4 c'16
3529 @end lilypond
3530
3531
3532 La subdivision des trémolos aboutit à un résultat semblable : voir
3533 @ref{Tremolo subdivisions}.
3534
3535
3536 @seealso
3537
3538 Dans ce manuel : @ref{Tremolo subdivisions}, @ref{Repeats}.
3539
3540 Référence du programme : @internalsref{Beam}, @internalsref{StemTremolo}.
3541
3542
3543 @node Tremolo subdivisions
3544 @subsection Tremolo subdivisions
3545
3546 @cindex tremolo marks
3547 @funindex tremoloFlags
3548
3549 Un trémolo peut être indiqué sur une seule note, en la faisant suivre
3550 de deux points et d'un nombre :
3551
3552 @code{note:}[@var{nombre}]. 
3553
3554 Le nombre en question correspond à la valeur de la subdivision ;
3555 il doit être au moins de 8, auquel cas la hampe sera barrée par une 
3556 seule ligature.  Si ce nombre est omis, la dernière valeur --- telle
3557 que mémorisée dans @code{tremoloFlags}) --- sera utilisée.
3558
3559 @lilypond[quote,ragged-right,verbatim,fragment]
3560 c'2:8 c':32 | c': c': |
3561 @end lilypond
3562
3563
3564 @refbugs
3565
3566 Les trémolos entrés de cette manière ne sont pas rendus dans
3567 le fichier MIDI.
3568
3569
3570 @seealso
3571
3572 Dans ce manuel : @ref{Tremolo repeats}.
3573
3574 Référence du programme : @internalsref{StemTremolo}.
3575
3576
3577 @node Measure repeats
3578 @subsection Measure repeats
3579
3580 @cindex percent repeats
3581 @cindex measure repeats
3582
3583 Le style de reprises @code{percent} sert à répéter une 
3584 séquence de notes.  Elle sera imprimée une fois, puis remplacée par
3585 un symbole spécial.  Les séquences d'une ou deux mesures sont
3586 remplacées par un symbole qui ressemble au symbole de pourcentage, 
3587 tandis que les séquences inférieures à une mesure sont remplacées par
3588 une barre oblique.  Toutes ces répétitions doivent être déclarées dans un contexte @code{Voice}.
3589
3590 @lilypond[quote,verbatim,ragged-right]
3591 \new Voice \relative c' {
3592   \repeat "percent" 4 { c4 }
3593   \repeat "percent" 2 { c2 es2 f4 fis4 g4 c4 }
3594 }
3595 @end lilypond
3596
3597 Les répétitions de plus de 2 mesures sont surmontées d'un compteur,
3598 si l'on définit comme vraie (lettre @q{t}) la propriété
3599 @code{countPercentRepeats}.
3600
3601 @lilypond[relative=2,fragment,quote,verbatim,ragged-right]
3602 \new Voice {
3603 \set countPercentRepeats = ##t
3604   \repeat "percent" 4 { c1 }
3605 }
3606 @end lilypond
3607
3608 Des symboles de pourcentage isolés peuvent aussi être obtenus, au
3609 moyen d'un silence multi-mesures dont on modifie l'aspect :
3610
3611 @lilypond[fragment,verbatim,quote]
3612 \override MultiMeasureRest #'stencil
3613   = #ly:multi-measure-rest::percent
3614 R1
3615 @end lilypond
3616
3617
3618 @seealso
3619
3620 Référence du programme : @internalsref{RepeatSlash},
3621 @internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
3622 @internalsref{DoublePercentRepeatCounter},
3623 @internalsref{PercentRepeatCounter},
3624 @internalsref{PercentRepeatedMusic}.