Documentation/fr/user/repeats.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @c Translators: Valentin Villenave
  10 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
  11
  12 @node Repeats
  13 @section Repeats
  14
  15 Une des notions essentielles, dans la musique, est le fait que des
  16 éléments soient joués plusieurs fois. Il existe de nombreuses façons
  17 de noter ces reprises.
  18
  19 @menu
  20 * Writing repeats::
  21 * Other repeats::
  22 @end menu
  23
  24 @node Writing repeats
  25 @subsection Writing repeats
  26
  27 @menu
  28 * Repeat types::
  29 * Repeat syntax::
  30 * Manual repeat commands::
  31 @end menu
  32
  33
  34 @node Repeat types
  35 @unnumberedsubsubsec Repeat types
  36
  37 @cindex reprises et répétitions
  38
  39 On peut indiquer des répétitions des façons suivantes :
  40
  41 @table @code
  42 @item unfold
  43 La musique qui doit être répétée sera entièrement imprimée (et jouée).
  44 Ceci est particulièrement utile dans de la musique répétitive.  Ce type
  45 de reprise est le seul pris en compte dans le rendu MIDI.
  46
  47 @item volta
  48 Le passage répété ne sera pas écrit explicitement, mais il sera encadré
  49 sur la partition par des barres de reprises, et peut se terminer par
  50 plusieurs fins alternatives, imprimées de gauche à droite sous des
  51 crochets.  Il s'agit là de la notation courante des reprises avec des
  52 fins alternatives.  Ces dernières, par défaut, ne sont pas jouées dans
  53 le rendu MIDI.
  54
  55 @item tremolo
  56 Pour réaliser des trémolos.  Ceux-ci, par défaut, ne sont pas joués dans
  57 le rendu MIDI.
  58
  59 @item percent
  60 Pour répéter des temps ou des mesures, imprimés sous la forme de signes de
  61 pourcentage.  Ceux-ci, par défaut, ne sont pas joués dans le rendu MIDI.
  62 Les répétitions indiquées par ces symboles doivent être déclarées dans
  63 un contexte @code{Voice}.
  64
  65 @end table
  66
  67
  68 @node Repeat syntax
  69 @unnumberedsubsubsec Repeat syntax
  70
  71 @cindex volta
  72 @cindex première fois
  73 @cindex seconde fois
  74 @funindex \repeat
  75
  76 Tous les différents types de reprise se spécifient dans
  77 LilyPond avec une même construction syntaxique, qui est :
  78
  79
  80 @example
  81 \repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{expression_à_répéter}
  82 @end example
  83
  84 On peut ajouter, pour indiquer une fin alternative :
  85 @funindex \alternative
  86 @example
  87 \alternative @{
  88  @var{alternative1}
  89  @var{alternative2}
  90  @var{alternative3}
  91  @dots{}
  92 @}
  93 @end example
  94
  95 @noindent
  96 chaque @var{alternative} étant une expression musicale.  Si l'on donne
  97 trop peu d'alternatives en regard du nombre de fois où le passage doit
  98 être rejoué, la première alternative sera jouée plusieurs fois.
  99
 100
 101 Les reprises courantes s'indiquent comme ceci :
 102
 103 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 104 c1
 105 \repeat volta 2 { c4 d e f }
 106 \repeat volta 2 { f e d c }
 107 @end lilypond
 108
 109 Et avec des fins alternatives :
 110
 111 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 112 c1
 113 \repeat volta 2 {c4 d e f}
 114 \alternative { {d2 d} {f f,} }
 115 @end lilypond
 116
 117 Il est possible de créer des répétitions avec une levée.
 118
 119 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 120 \new Staff {
 121   \partial 4 e |
 122   \repeat volta 4 { c2 d2 | e2 f2 | }
 123   \alternative { { g4 g g e } { a a a a | b2. } }
 124 }
 125 @end lilypond
 126
 127 @noindent
 128 ou
 129
 130 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 131 \new Staff {
 132   \partial 4
 133   \repeat volta 4 { e | c2 d2 | e2 f2 | }
 134   \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
 135 }
 136 @end lilypond
 137
 138
 139
 140 @funindex \repeatTie
 141 Des liaisons de tenue peuvent être ajoutées à toute alternative :
 142
 143 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 144 c1
 145 \repeat volta 2 {c4 d e f ~ }
 146 \alternative { {f2 d} {f\repeatTie f,} }
 147 @end lilypond
 148
 149
 150 On peut raccourcir les crochets indiquant les fins alternatives,
 151 en définissant la propriété @code{voltaSpannerDuration}.  Dans
 152 l'exemple suivant, le crochet ne se prolonge que sur une mesure
 153 à 3/4.
 154
 155 @lilypond[verbatim,ragged-right,quote]
 156 \relative c''{
 157   \time 3/4
 158   c c c
 159   \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
 160   \repeat volta 5 { d d d }
 161   \alternative { { e e e f f f }
 162   { g g g } }
 163 }
 164 @end lilypond
 165
 166 Si l'on souhaite à la fois terminer une ligne par une double barre et
 167 débuter la ligne suivante avec une section reprise, on peut utiliser
 168 @example
 169 @dots{} \bar "||:" \break
 170 \repeat volta 2 @{ @dots{}
 171 @end example
 172
 173 Consultez @ref{Bar lines} pour plus d'informations.
 174
 175 @seealso
 176
 177 Program reference: @internalsref{VoltaBracket},
 178 @internalsref{RepeatedMusic},
 179 @internalsref{VoltaRepeatedMusic}, et
 180 @internalsref{UnfoldedRepeatedMusic}.
 181
 182
 183 Examples
 184
 185 Les crochets précédant une reprise s'impriment d'ordinaire seulement
 186 au-dessus de la portée du haut.  On peut ajuster cela en déplaçant le
 187 graveur @code{Volta_engraver} vers les contextes de portée
 188 (@code{Staff}) qui doivent comporter ces crochets ;
 189 voir @ref{Modifying context plug-ins} et
 190 @lsr{repeats,volta@/-multi@/-staff@/.ly}.
 191
 192
 193 @refbugs
 194
 195 @cindex reprises ambigües
 196
 197 Des reprises imbriquées telles que
 198
 199 @example
 200 \repeat @dots{}
 201 \repeat @dots{}
 202 \alternative
 203 @end example
 204
 205 @noindent
 206 présentent une ambiguïté, dans la mesure où l'on ne sait à quelle
 207 section @code{\repeat} attribuer la section @code{\alternative}.  Pour
 208 résoudre cette ambiguïté, il convient de toujours insérer la commande
 209 @code{\alternative} à l'intérieur de la section @code{\repeat}.  Il est
 210 préférable, dans une telle situation, d'utiliser des accolades pour plus
 211 de clarté.
 212
 213 Lorsqu'une alternative commence, les informations de métrique sont
 214 perdues, il faut donc les rappeler après une reprise, par exemple
 215 en définissant @code{Score.measurePosition} ou en invoquant la commande
 216 @code{\partial}.  De même, aucune liaison (de tenue ou autre)
 217 n'est répétée.
 218
 219 Les crochets qui indiquent les alternatives ne sont pas alignés
 220 verticalement.
 221
 222
 223 @node Manual repeat commands
 224 @unnumberedsubsubsec Manual repeat commands
 225
 226 @funindex repeatCommands
 227
 228 La propriété @code{repeatCommands} sert à contrôler la mise en forme des
 229 reprises.  On la définit par une suite de commandes de reprise Scheme.
 230
 231 @table @asis
 232 @item @code{start-repeat}
 233 Pour imprimer une barre de reprise @code{|:}
 234
 235 @item @code{end-repeat}
 236 Pour imprimer une barre de reprise @code{:|}
 237
 238 @item @code{(volta @var{texte})}
 239 Pour imprimer un crochet indiquant une alternative.  L'argument
 240 @var{texte} mentionné dans le crochet peut être n'importe quelle chaîne
 241 de caractères ou indication textuelle --- voir @ref{Text markup}.
 242 Attention cependant à changer la police, car la police employée par
 243 défaut pour les chiffres ne contient aucun caractère alphabétique.
 244
 245 @item @code{(volta #f)}
 246 Pour terminer un crochet indiquant une alternative.
 247 @end table
 248
 249 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 250 c4
 251   \set Score.repeatCommands = #'((volta "93") end-repeat)
 252 c4 c4
 253   \set Score.repeatCommands = #'((volta #f))
 254 c4 c4
 255 @end lilypond
 256
 257
 258 @seealso
 259
 260 Référence du programme : @internalsref{VoltaBracket},
 261 @internalsref{RepeatedMusic},
 262 @internalsref{VoltaRepeatedMusic}, et
 263 @internalsref{UnfoldedRepeatedMusic}.
 264
 265
 266 @node Other repeats
 267 @subsection Other repeats
 268
 269 @menu
 270 * Tremolo repeats::
 271 * Tremolo subdivisions::
 272 * Measure repeats::
 273 @end menu
 274
 275 @node Tremolo repeats
 276 @unnumberedsubsubsec Tremolo repeats
 277
 278 @cindex ligatures de trémolo
 279 @cindex trémolo, ligatures de
 280
 281 On peut placer une notation de trémolo entre deux notes, avec la
 282 commande @code{\repeat} suivie du style trémolo :
 283 @lilypond[quote,verbatim,ragged-right]
 284 \new Voice \relative c' {
 285   \repeat tremolo 8 { c16 d16 }
 286   \repeat tremolo 4 { c16 d16 }
 287   \repeat tremolo 2 { c16 d16 }
 288 }
 289 @end lilypond
 290
 291
 292 On peut aussi indiquer un trémolo sur une seule note, qu'il faudra
 293 alors laisser sans accolades.
 294
 295 @lilypond[quote,verbatim,ragged-right]
 296 \repeat tremolo 4 c'16
 297 @end lilypond
 298
 299
 300 La subdivision des trémolos aboutit à un résultat semblable : voir
 301 @ref{Tremolo subdivisions}.
 302
 303
 304 @seealso
 305
 306 Dans ce manuel : @ref{Tremolo subdivisions}, @ref{Repeats}.
 307
 308 Référence du programme : @internalsref{Beam}, @internalsref{StemTremolo}.
 309
 310
 311 @node Tremolo subdivisions
 312 @unnumberedsubsubsec Tremolo subdivisions
 313
 314 @cindex trémolo, indication de
 315 @funindex tremoloFlags
 316
 317 Un trémolo peut être indiqué sur une seule note, en la faisant suivre
 318 de deux points et d'un nombre :
 319
 320 @code{note:}[@var{nombre}].
 321
 322 Le nombre en question correspond à la valeur de la subdivision ;
 323 il doit être au moins de 8, auquel cas la hampe sera barrée par un
 324 seul trait de ligature.  Si ce nombre est omis, la dernière valeur ---
 325 telle que mémorisée dans @code{tremoloFlags} --- sera utilisée.
 326
 327 @lilypond[quote,ragged-right,verbatim,fragment]
 328 c'2:8 c':32 | c': c': |
 329 @end lilypond
 330
 331
 332 @refbugs
 333
 334 Les trémolos entrés de cette manière ne sont pas rendus dans
 335 le fichier MIDI.
 336
 337
 338 @seealso
 339
 340 Dans ce manuel : @ref{Tremolo repeats}.
 341
 342 Référence du programme : @internalsref{StemTremolo}.
 343
 344
 345 @node Measure repeats
 346 @unnumberedsubsubsec Measure repeats
 347
 348 @cindex percent repeats
 349 @cindex measure repeats
 350
 351 Le style de @qq{reprise en pourcent} sert à répéter une séquence de
 352 notes.  Elle sera imprimée une fois, puis remplacée par un symbole
 353 spécial.  Les séquences d'une ou deux mesures sont remplacées par un
 354 symbole qui ressemble au symbole de pourcentage, tandis que les
 355 séquences inférieures à une mesure sont remplacées par une barre
 356 oblique.  Toutes ces répétitions doivent être déclarées dans un contexte
 357 @code{Voice}.
 358
 359 @lilypond[quote,verbatim,ragged-right]
 360 \new Voice \relative c' {
 361   \repeat percent 4 { c4 }
 362   \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
 363 }
 364 @end lilypond
 365
 366 Les répétitions de plus de 2 mesures sont surmontées d'un compteur,
 367 si l'on assigne @emph{vrai} (lettre @q{t}) à la propriété
 368 @code{countPercentRepeats}.
 369
 370 @lilypond[relative=2,fragment,quote,verbatim,ragged-right]
 371 \new Voice {
 372 \set countPercentRepeats = ##t
 373   \repeat percent 4 { c1 }
 374 }
 375 @end lilypond
 376
 377 Des symboles de pourcentage isolés peuvent aussi être obtenus, au
 378 moyen d'un silence multi-mesures dont on modifie l'aspect :
 379
 380 @lilypond[fragment,verbatim,quote]
 381 \override MultiMeasureRest #'stencil
 382   = #ly:multi-measure-rest::percent
 383 R1
 384 @end lilypond
 385
 386
 387 @seealso
 388
 389 Référence du programme : @internalsref{RepeatSlash},
 390 @internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
 391 @internalsref{DoublePercentRepeatCounter},
 392 @internalsref{PercentRepeatCounter},
 393 @internalsref{PercentRepeatedMusic}.
 394