]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/staff.itely
Doc-fr: updates NR
[lilypond.git] / Documentation / fr / notation / staff.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2
3 @ignore
4    Translation of GIT committish: caa4700b4acbc870158d70ee257efaa723c550f0
5
6    When revising a translation, copy the HEAD committish of the
7    version that you are working on.  For details, see the Contributors'
8    Guide, node Updating translation committishes..
9 @end ignore
10
11 @c \version "2.19.21"
12
13 @c Translators: Valentin Villenave, Jean-Charles Malahieude
14 @c Translation checkers: John Mandereau
15
16 @node Notation sur la portée
17 @section Notation sur la portée
18 @translationof Staff notation
19
20 @c The line width is a bit of a hack to allow space for the
21 @c  instrument names.
22 @lilypondfile[quote,ragged-right,line-width=14.5\cm,staffsize=16]
23 {staff-headword.ly}
24
25 Cette section aborde les détails de gravure de la portée, la
26 réalisation de partitions comprenant plusieurs portées et l'ajout
27 d'indications globales d'exécution, présentes sur certaines portées
28 seulement.
29
30 @menu
31 * Gravure des portées::
32 * Modification de portées individuelles::
33 * Écriture de parties séparées::
34 @end menu
35
36
37 @node Gravure des portées
38 @subsection Gravure des portées
39 @translationof Displaying staves
40
41 Nous allons voir ici comment créer des portées et comment les regrouper.
42
43 @menu
44 * Initialisation de nouvelles portées::
45 * Regroupement de portées::
46 * Imbrication de regroupements de portées::
47 * Séparation des systèmes::
48 @end menu
49
50
51 @node Initialisation de nouvelles portées
52 @unnumberedsubsubsec Initialisation de nouvelles portées
53 @translationof Instantiating new staves
54
55 @cindex nouvelle portée
56 @cindex portée, initialisation
57 @cindex portée, instanciation
58 @cindex portée, nouvelle
59 @cindex portée simple
60 @cindex portée de batterie
61 @cindex portée de percussion
62 @cindex batterie, portée
63 @cindex percussion, portée
64 @cindex portée, transcription de grégorien
65 @cindex portée rythmique
66 @cindex portée de tablature
67 @cindex tablature
68
69 @funindex \drummode
70 @funindex drummode
71 @funindex DrumStaff
72 @funindex RhythmicStaff
73 @funindex TabStaff
74 @funindex MensuralStaff
75 @funindex VaticanaStaff
76 @funindex GregorianTranscriptionStaff
77
78 Les @notation{portées} -- en anglais @emph{staff} (@emph{staves}
79 au pluriel) -- sont créées à l'aide des commandes @code{\new} ou
80 @code{\context}.  Pour de plus amples détails, consultez
81 @ref{Création et référencement d'un contexte}.
82
83 Le contexte de portée standard s'appelle @code{Staff} :
84
85 @lilypond[verbatim,quote]
86 \new Staff \relative { c''4 d e f }
87 @end lilypond
88
89 Le contexte @code{DrumStaff} crée une portée à cinq lignes correspondant
90 à une batterie traditionnelle et chacun des instruments est représenté
91 par un symbole spécifique.  Les éléments sont saisis en mode batterie,
92 initialisé par la commande @code{\drummode}, chaque composante étant
93 spécifiée par son nom.  Pour de plus amples détails, consultez
94 @ref{Portées de percussion}.
95
96 @lilypond[verbatim,quote]
97 \new DrumStaff {
98   \drummode { cymc hh ss tomh }
99 }
100 @end lilypond
101
102 Un @code{RhythmicStaff} est composé d'une portée à ligne unique chargée
103 de présenter les valeurs rythmiques saisies.  Seules sont imprimées les
104 durées.  Pour de plus amples détails, consultez
105 @ref{Gravure de lignes rythmiques}.
106
107 @lilypond[verbatim,quote]
108 \new RhythmicStaff { c4 d e f }
109 @end lilypond
110
111 Un @code{TabStaff} crée une portée de tablature correspondant aux six
112 cordes d'une guitare standard.  Pour de plus amples détails, consultez
113 @ref{Tablatures par défaut}.
114
115 @lilypond[verbatim,quote]
116 \new TabStaff \relative { c''4 d e f }
117 @end lilypond
118
119 LilyPond dispose aussi de deux contextes dédiés à la musique
120 ancienne : @code{MensuralStaff} et @code{VaticanaStaff}.  Ils sont
121 abordés plus en détails au chapitre @ref{Contextes prédéfinis}.
122
123 Le contexte @code{GregorianTranscriptionStaff} permet d'obtenir des
124 éditions modernes du grégorien.  Bien entendu, il est dépourvu de barres
125 de mesure.
126
127 @lilypond[verbatim,quote]
128 \new GregorianTranscriptionStaff \relative { c''4 d e f e d }
129 @end lilypond
130
131 Vous pourrez toujours définir d'autres contextes de portée selon vos
132 besoins, en suivant les indications fournies au chapitre
133 @ref{Définition de nouveaux contextes}.
134
135 @seealso
136 Glossaire musicologique :
137 @rglos{staff},
138 @rglosnamed{staves,portées}.
139
140 Manuel de notation :
141 @ref{Contextes de musique mensurale},
142 @ref{Contextes du chant grégorien},
143 @ref{Contextes prédéfinis},
144 @ref{Création et référencement d'un contexte},
145 @ref{Définition de nouveaux contextes},
146 @ref{Gravure de lignes rythmiques},
147 @ref{Portées de percussion},
148 @ref{Symbole de la portée},
149 @ref{Tablatures par défaut}.
150
151 Morceaux choisis :
152 @rlsrnamed{Staff notation, Notation sur la portée}.
153
154 Référence des propriétés internes :
155 @rinternals{Staff},
156 @rinternals{DrumStaff},
157 @rinternals{GregorianTranscriptionStaff},
158 @rinternals{RhythmicStaff},
159 @rinternals{TabStaff},
160 @rinternals{MensuralStaff},
161 @rinternals{VaticanaStaff},
162 @rinternals{StaffSymbol}.
163
164
165 @node Regroupement de portées
166 @unnumberedsubsubsec Regroupement de portées
167 @translationof Grouping staves
168
169 @cindex système, début de
170 @cindex crochet vertical
171 @cindex accolade verticale
172 @cindex portée multiple
173 @cindex portées, groupe de
174 @cindex portées, regroupement
175 @cindex chœur, système
176 @cindex piano, système
177 @cindex système choral
178 @cindex système pianistique
179 @cindex système, grand
180 @cindex système
181
182 LilyPond dispose de différents contextes permettant de regrouper des
183 portées individuelles et d'obtenir ainsi des « systèmes ».  Chacun de
184 ces contextes définira le style de regroupement, avec son signe
185 particulier en début de portée et ses règles de gestion des barres de
186 mesure.
187
188 Lorsqu'aucun contexte particulier n'est spécifié, les propriétés
189 suivantes s'appliqueront par défaut : les portées du groupe ne sont
190 pas reliées, hormis par une simple ligne verticale en début de ligne, et
191 les barres de mesure sont indépendantes.
192
193 @lilypond[verbatim,quote]
194 <<
195   \new Staff \relative { c''1 c }
196   \new Staff \relative { c''1 c }
197 >>
198 @end lilypond
199
200 Dans un @code{StaffGroup}, le groupe de portées est signifié par un
201 crochet, et les barres de mesure sont d'un seul tenant.
202
203 @lilypond[verbatim,quote]
204 \new StaffGroup <<
205   \new Staff \relative { c''1 c }
206   \new Staff \relative { c''1 c }
207 >>
208 @end lilypond
209
210 Dans un @code{ChoirStaff}, le groupe de portées est signifié par un
211 crochet sur la gauche, et les barres de mesure sont individuelles.
212
213 @lilypond[verbatim,quote]
214 \new ChoirStaff <<
215   \new Staff \relative { c''1 c }
216   \new Staff \relative { c''1 c }
217 >>
218 @end lilypond
219
220 Dans un @code{GrandStaff}, le groupe de portées est signifié par une
221 accolade sur la gauche, et les barres de mesure sont d'un seul tenant.
222
223 @lilypond[verbatim,quote]
224 \new GrandStaff <<
225   \new Staff \relative { c''1 c }
226   \new Staff \relative { c''1 c }
227 >>
228 @end lilypond
229
230 Le contexte @code{PianoStaff} est identique au @code{GrandStaff}, sauf
231 qu'il gère automatiquement l'affichage du nom d'instrument -- voir
232 @ref{Noms d'instrument} pour plus de détails.
233
234 @lilypond[verbatim,quote]
235 \new PianoStaff <<
236   \set PianoStaff.instrumentName = #"Piano"
237   \new Staff \relative { c''1 c }
238   \new Staff \relative { \clef bass c1 c }
239 >>
240 @end lilypond
241
242 Les barres de mesure au début de chaque système adoptent l'un des styles
243 @code{SystemStartBar}, @code{SystemStartBrace} ou
244 @code{SystemStartBracket}.  Dans chaque contexte, seul l'un de ces
245 styles est utilisé, et c'est la propriété @code{systemStartDelimiter}
246 qui détermine lequel.  Un quatrième style, @code{SystemStartSquare},
247 doit quant à lui être spécifié de manière explicite.
248
249 Vous pouvez aussi créer vos propres contextes de regroupement, comme
250 l'explique @ref{Définition de nouveaux contextes}.
251
252 @snippets
253 @lilypondfile[verbatim,quote,texidoc,doctitle]
254 {use-square-bracket-at-the-start-of-a-staff-group.ly}
255
256 @lilypondfile[verbatim,quote,texidoc,doctitle]
257 {display-bracket-with-only-one-staff-in-a-system.ly}
258
259 @cindex présentation mensurale
260 @cindex renaissance, musique
261 @cindex transcription de musique ancienne
262 @cindex musique ancienne, transcription
263
264 @lilypondfile[verbatim,quote,texidoc,doctitle]
265 {mensurstriche-layout-bar-lines-between-the-staves.ly}
266
267 @seealso
268 Glossaire musicologique :
269 @rglosnamed{brace,accolade},
270 @rglosnamed{bracket,crochet},
271 @rglosnamed{grand staff,système}.
272
273 Manuel de notation :
274 @ref{Définition de nouveaux contextes},
275 @ref{Noms d'instrument}.
276
277 Morceaux choisis :
278 @rlsrnamed{Staff notation, Notation sur la portée}.
279
280 Référence des propriétés internes :
281 @rinternals{Staff},
282 @rinternals{StaffGroup},
283 @rinternals{ChoirStaff},
284 @rinternals{GrandStaff},
285 @rinternals{PianoStaff},
286 @rinternals{SystemStartBar},
287 @rinternals{SystemStartBrace},
288 @rinternals{SystemStartBracket},
289 @rinternals{SystemStartSquare}.
290
291
292 @node Imbrication de regroupements de portées
293 @unnumberedsubsubsec Imbrication de regroupements de portées
294 @translationof Nested staff groups
295
296 @cindex portées, regroupement et imbrication
297 @cindex systèmes imbriqués
298 @cindex imbrication de systèmes
299 @cindex délimitation, systèmes imbriqués
300
301 Les accolades et crochets qui délimitent les systèmes peuvent être
302 imbriqués en profondeur.  Chaque niveau inférieur aura son propre
303 délimiteur, en plus de celui du niveau supérieur.
304
305 @lilypond[verbatim,quote]
306 \new StaffGroup <<
307   \new Staff \relative { c''2 c | c2 c }
308   \new StaffGroup <<
309     \new Staff \relative { g'2 g | g2 g }
310     \new StaffGroup \with {
311       systemStartDelimiter = #'SystemStartSquare
312     }
313     <<
314       \new Staff \relative { e'2 e | e2 e }
315       \new Staff \relative { c'2 c | c2 c }
316     >>
317   >>
318 >>
319 @end lilypond
320
321 Vous pouvez aussi créer vos propres contextes d'imbrication, comme
322 l'explique @ref{Définition de nouveaux contextes}.
323
324 @snippets
325 @lilypondfile[verbatim,quote,texidoc,doctitle]
326 {nesting-staves.ly}
327
328 @seealso
329 Manuel de notation :
330 @ref{Définition de nouveaux contextes},
331 @ref{Noms d'instrument},
332 @ref{Regroupement de portées}.
333
334 Morceaux choisis :
335 @rlsrnamed{Staff notation,Notation sur la portée}.
336
337 Référence des propriétés internes :
338 @rinternals{StaffGroup},
339 @rinternals{ChoirStaff},
340 @rinternals{SystemStartBar},
341 @rinternals{SystemStartBrace},
342 @rinternals{SystemStartBracket},
343 @rinternals{SystemStartSquare}.
344
345
346 @node Séparation des systèmes
347 @unnumberedsubsubsec Séparation des systèmes
348 @translationof Separating systems
349
350 @cindex système, indicateur de séparation
351
352 Le nombre de systèmes peut varier d'une page à l'autre ; vous
353 pouvez, en pareil cas, rendre plus évidente la séparation entre les
354 systèmes en l'indiquant visuellement.  Ce « séparateur » est absent par
355 défaut, mais vous pouvez l'activer par une option au sein du bloc
356 @code{\paper}.
357
358 @c \book is required here to display the system separator
359 @c ragged-right is required as there are two systems
360 @lilypond[verbatim,quote,ragged-right]
361 \book {
362   \score {
363     \new StaffGroup <<
364       \new Staff {
365         \relative {
366           c''4 c c c
367           \break
368           c4 c c c
369         }
370       }
371       \new Staff {
372         \relative {
373           c''4 c c c
374           \break
375           c4 c c c
376         }
377       }
378     >>
379   }
380   \paper {
381     system-separator-markup = \slashSeparator
382     % following commands are needed only to format this documentation
383     paper-width = 100\mm
384     paper-height = 100\mm
385     tagline = ##f
386   }
387 }
388 @end lilypond
389
390 @seealso
391 Manuel de notation :
392 @ref{Mise en forme de la page}.
393
394 Morceaux choisis :
395 @rlsrnamed{Staff notation,Notation sur la portée}.
396
397
398 @node Modification de portées individuelles
399 @subsection Modification de portées individuelles
400 @translationof Modifying single staves
401
402 Cette section explique le réglage de la gravure de chaque portée,
403 comme la taille de portée ou le nombre de lignes ; sont aussi
404 décrits la suspension et la reprise de portées, ainsi que les portées
405 d'@emph{ossia}.
406
407 @menu
408 * Symbole de la portée::
409 * Portées d'ossia::
410 * Masquage de portées::
411 @end menu
412
413
414 @node Symbole de la portée
415 @unnumberedsubsubsec Symbole de la portée
416 @translationof Staff symbol
417
418 @cindex symbole de portée
419 @cindex portée, lignes de
420 @cindex lignes de portée, nombre de
421 @cindex suspension de portée
422 @cindex portée, suspension
423 @cindex reprise de portée
424 @cindex portée, reprise
425 @cindex lignes de portée, épaisseur
426 @cindex ligne supplémentaire
427
428 @funindex \startStaff
429 @funindex startStaff
430 @funindex \stopStaff
431 @funindex stopStaff
432
433 Les commandes @code{\stopStaff} et @code{\startStaff} permettent
434 respectivement de clôturer et (re)démarrer une portée n'importe où dans
435 une partition.
436
437 @lilypond[verbatim,quote]
438 \relative {
439   \stopStaff f''4 d \startStaff g, e
440   f'4 d \stopStaff g, e
441   f'4 d \startStaff g, e
442 }
443 @end lilypond
444
445 @predefined
446 @code{\startStaff},
447 @code{\stopStaff}.
448 @endpredefined
449
450 Les notes, nuances, etc. sont regroupées dans un assemblage de lignes
451 horizontales, que l'on nomme la portée (en anglais @emph{staff}, et
452 @emph{staves} au pluriel).  Dans LilyPond, ces lignes sont dessinées au
453 moyen d'un objet graphique (@emph{grob}) à part entière, nommé
454 @code{StaffSymbol} -- symbole de portée.  Modifier les propriétés d'un
455 @code{StaffSymbol} changera l'apparence de la portée, dès lors qu'elles
456 auront été définies avant de créer la portée en question.
457
458 Vous pouvez modifier le nombre de lignes d'une portée :
459
460 @lilypond[verbatim,quote]
461 \relative {
462   f''4 d \stopStaff
463   \override Staff.StaffSymbol.line-count = #2
464   \startStaff g, e |
465
466   f'4 d \stopStaff
467   \revert Staff.StaffSymbol.line-count
468   \startStaff g, e |
469 }
470 @end lilypond
471
472 Le positionnement de chacune des lignes de la portée est modifiable.
473 Une liste de nombres détermine le positionnement de chaque ligne.
474 Le @code{0} correspond à la ligne médiane d'une portée habituelle, pour
475 laquelle la liste est donc @code{(-4 -2 0 2 4)}.
476 Une ligne sera donc imprimée pour chaque valeur exprimée ; le nombre de
477 lignes, ainsi que leur position dans la portée, peut donc se modifier à
478 l'aide d'une seule commande.
479
480 @lilypond[verbatim,quote]
481 \relative {
482   f''4 d \stopStaff
483   \override Staff.StaffSymbol.line-positions = #'(1 3 5 -1 -3)
484   \startStaff g, e |
485   f'4 d \stopStaff
486   \override Staff.StaffSymbol.line-positions = #'(8 6.5 -6 -8 -0.5)
487   \startStaff g, e |
488 }
489 @end lilypond
490
491 Afin de préserver l'orientation habituelle des hampes -- ascendantes
492 dans la partie inférieure de la portée, descendantes dans la partie
493 supérieure -- la ligne (ou l'interligne) centrale de la portée
494 personnalisée devra être en phase avec avec la ligne médiane d'une
495 portée classique (0).  La position de la clef et celle du do médium
496 demanderont parfois un ajustement afin d'être en phase avec cette
497 nouvelle portée.  Pour plus d'explications, reportez-vous aux exemples
498 du chapitre @ref{Clefs}.
499
500 Lorsque vous modifierez l'épaisseur des lignes, gardez à l'esprit que
501 les lignes supplémentaires et les hampes seront aussi modifiées.
502
503 @lilypond[verbatim,quote,relative=1]
504 \new Staff \with {
505   \override StaffSymbol.thickness = #3
506 }
507 { e4 d c b }
508 @end lilypond
509
510 L'épaisseur des lignes supplémentaires (@emph{ledger lines}) peut être
511 déterminée indépendamment des lignes de la portée.
512
513 @lilypond[verbatim,quote]
514 \new Staff \with {
515   \override StaffSymbol.thickness = #2
516   \override StaffSymbol.ledger-line-thickness = #'(0.5 . 0.4)
517 } \relative {
518   f'''4 a, a,, f
519 }
520 @end lilypond
521
522 @noindent
523 La première valeur est multipliée par l'épaisseur de ligne de portée, la
524 seconde par l'espace d'interligne ; ces deux valeurs sont alors
525 combinées pour donner la nouvelle épaisseur des lignes supplémentaires.
526
527 L'emplacement des lignes supplémentaires est réglable :
528
529 @lilypond[verbatim,quote]
530 \new Staff \with {
531   \override StaffSymbol.ledger-positions = #'(-3 -2 -1 2 5 6)
532 } \relative {
533   f'''4 a, a,, f
534 }
535 @end lilypond
536
537 Vous pouvez faire apparaître des lignes supplémentaires additionnelles
538 au-dessus ou en dessous des têtes de note selon leur positionnement
539 relatif aux autres notes, qu'elles aient ou non elles-mêmes des lignes
540 supplémentaires.
541
542 @lilypond[verbatim,quote]
543 \new Staff \with {
544   \override StaffSymbol.ledger-extra = #4
545 } \relative {
546   f'''4 a, d, f,
547 }
548 @end lilypond
549
550 Des lignes supplémentaires peuvent apparaître y compris au sein d'une
551 portée, notamment lorsque vous l'avez personnalisée.  L'exemple suivant
552 illustre deux cas de figure quant au positionnement des lignes
553 supplémentaires selon que la propriété @code{legder-position} est
554 définie explicitement ou non.  La présence du @code{\stopStaff} est ici
555 rendue nécessaire pour annuler les effets de la commande
556 @code{\override} qui s'applique à l'intégralité du @code{StaffSymbol}.
557
558 @lilypond[verbatim,quote,relative=1]
559 \override Staff.StaffSymbol.line-positions =   #'(-8 0 2 4)
560 d4 e f g
561 \stopStaff
562 \startStaff
563 \override Staff.StaffSymbol.ledger-positions = #'(-8 -6 (-4 -2) 0)
564 d4 e f g
565 @end lilypond
566
567 Modifier l'équidistance des lignes de la portée affectera aussi les
568 lignes supplémentaires.
569
570 @lilypond[verbatim,quote]
571 \new Staff \with {
572   \override StaffSymbol.staff-space = #1.5
573 } \relative {
574   f'''4 d, g, e,
575 }
576 @end lilypond
577
578 @snippets
579 @lilypondfile[verbatim,quote,texidoc,doctitle]
580 {making-some-staff-lines-thicker-than-the-others.ly}
581
582 @seealso
583 Glossaire musicologique :
584 @rglosnamed{line,ligne},
585 @rglosnamed{ledger line,ligne supplémentaire},
586 @rglosnamed{staff,portée}.
587
588 Manuel de notation :
589 @ref{Clefs}.
590
591 Morceaux choisis :
592 @rlsrnamed{Staff notation,Notation sur la portée}.
593
594 Référence des propriétés internes :
595 @rinternals{StaffSymbol},
596 @rinternals{staff-symbol-interface}.
597
598
599 @node Portées d'ossia
600 @unnumberedsubsubsec Portées d'ossia
601 @translationof Ossia staves
602
603 @cindex portée à la française
604 @cindex ossia
605 @cindex variante
606 @cindex portées, nombre variable de
607 @cindex nombre de portées
608
609 @funindex \startStaff
610 @funindex startStaff
611 @funindex \stopStaff
612 @funindex stopStaff
613
614 Une portée d'@notation{ossia} -- ou de variante -- s'obtient en créant,
615 à l'endroit approprié, une nouvelle portée simultanée :
616
617 @lilypond[verbatim,quote]
618 \new Staff \relative {
619   c''4 b d c
620   <<
621     { c4 b d c }
622     \new Staff { e4 d f e }
623   >>
624   c4 b c2
625 }
626 @end lilypond
627
628 @noindent
629 L'exemple ci-dessus n'est probablement pas ce qui vous conviendra le
630 plus.  Afin que cette ossia se place au-dessus de la portée à laquelle
631 elle se réfère, étant par ailleurs dépourvue de métrique et de clef, et
632 d'une taille légèrement inférieure, vous devrez avoir recours à quelques
633 retouches.  Le manuel d'initiation aborde une technique particulière
634 pour obtenir ce résultat, au chapitre
635 @rlearning{Expressions musicales imbriquées}.
636
637 L'exemple qui suit utilise, pour aligner la portée d'ossia, la propriété
638 @code{alignAboveContext}.  Cette méthode est tout à fait appropriée
639 lorsqu'il y a un nombre restreint d'ossias.
640
641 @lilypond[verbatim,quote]
642 \new Staff = "main" \relative {
643   c''4 b d c
644   <<
645     { c4 b d c }
646
647     \new Staff \with {
648       \remove "Time_signature_engraver"
649       alignAboveContext = #"main"
650       \magnifyStaff #2/3
651       firstClef = ##f
652     }
653     { e4 d f e }
654   >>
655   c4 b c2
656 }
657 @end lilypond
658
659 Dans le cas où de nombreux et courts fragments d'ossia affecteraient
660 une même portée, il est judicieux de créer un contexte @code{Staff} vide
661 auquel sera attribué un @emph{identifiant}. Il suffira alors, pour
662 entamer un fragment d'ossia, de « faire appel » à ce contexte grâce
663 aux commandes @code{\startStaff} et @code{\stopStaff}.  Vous vous
664 rendrez compte à l'utilisation des avantages que procure cette façon de
665 procéder, bien plus que dans l'exemple suivant.
666
667 @lilypond[verbatim,quote,ragged-right]
668 <<
669   \new Staff = "ossia" \with {
670     \remove "Time_signature_engraver"
671     \hide Clef
672     \magnifyStaff #2/3
673   }
674   { \stopStaff s1*6 }
675
676   \new Staff \relative {
677     c'4 b c2
678     <<
679       { e4 f e2 }
680       \context Staff = "ossia" {
681         \startStaff e4 g8 f e2 \stopStaff
682       }
683     >>
684     g4 a g2 \break
685     c4 b c2
686     <<
687       { g4 a g2 }
688       \context Staff = "ossia" {
689         \startStaff g4 e8 f g2 \stopStaff
690       }
691     >>
692     e4 d c2
693   }
694 >>
695 @end lilypond
696
697 Vous pourriez aussi recourir à la commande
698 @code{\Staff \RemoveEmptyStaves} pour créer votre portée d'ossia.
699 Cependant, cette méthode reste limitée à l'apparition de ces ossias en
700 début de ligne.  Pour plus d'information au sujet de la commande
701 @code{\Staff \RemoveEmptyStaves}, reportez-vous au chapitre
702 @ref{Masquage de portées}.
703
704 @lilypond[verbatim,quote,ragged-right]
705 <<
706   \new Staff = "ossia" \with {
707     \remove "Time_signature_engraver"
708     \hide Clef
709     \magnifyStaff #2/3
710   } \relative {
711     R1*3
712     c''4 e8 d c2
713   }
714   \new Staff \relative {
715     c'4 b c2
716     e4 f e2
717     g4 a g2 \break
718     c4 b c2
719     g4 a g2
720     e4 d c2
721   }
722 >>
723
724 \layout {
725   \context {
726     \Staff \RemoveEmptyStaves
727     \override VerticalAxisGroup.remove-first = ##t
728   }
729 }
730 @end lilypond
731
732 @snippets
733 @lilypondfile[verbatim,quote,texidoc,doctitle]
734 {vertically-aligning-ossias-and-lyrics.ly}
735
736 @seealso
737 Glossaire musicologique :
738 @rglos{ossia},
739 @rglosnamed{staff,portée},
740 @rglos{Frenched staff}.
741
742 Manuel d'initiation :
743 @rlearning{Expressions musicales imbriquées},
744 @rlearning{Longueur et épaisseur des objets},
745 @rlearning{Taille des objets}.
746
747 Manuel de notation :
748 @ref{Masquage de portées}.
749
750 Morceaux choisis :
751 @rlsrnamed{Staff notation,Notation sur la portée}.
752
753 Référence des propriétés internes :
754 @rinternals{StaffSymbol}.
755
756
757 @node Masquage de portées
758 @unnumberedsubsubsec Masquage de portées
759 @translationof Hiding staves
760
761 @cindex Frenched scores
762 @cindex masquage de portée
763 @cindex portée vide
764
765 @funindex \RemoveEmptyStaves
766 @funindex Staff_symbol_engraver
767 @funindex \stopStaff
768 @funindex stopStaff
769
770 Désactiver le graveur @code{Staff_symbol_engraver} dans un contexte
771 @code{Staff} permet de masquer des lignes.  La commande
772 @code{\stopStaff} aura le même effet.
773
774 @lilypond[verbatim,quote]
775 \new Staff \with {
776   \remove "Staff_symbol_engraver"
777 }
778 \relative { a''8 f e16 d c b a2 }
779 @end lilypond
780
781 L'instruction @code{\Staff \RemoveEmptyStaves} placée dans un bloc
782 @code{\layout} aura pour effet de masquer toute portée qui ne contient
783 rien.  Dans les partitions d'orchestre, les portées qui n'ont que des
784 silences sont habituellement masquées afin de gagner de la place.  Ce
785 style d'édition s'appelle en anglais « French Score ».
786 Cette fonctionnalité masque et supprime toutes les portées vides d'une
787 partition, hormis celles du premier système.
788
789 @warning{Une portée est considérée comme vide dès lors qu'elle ne
790 contient que des silences multimesures, des silences visibles ou
791 invisibles (ou d'espacement -- les @emph{@bs{}skip}) ou bien une
792 combinaison de ces éléments.}
793
794 @lilypond[verbatim,quote,ragged-right]
795 \layout {
796   \context {
797     \Staff \RemoveEmptyStaves
798   }
799 }
800
801 \relative <<
802   \new Staff {
803     e'4 f g a \break
804     b1 \break
805     a4 b c2
806   }
807   \new Staff {
808     c,4 d e f \break
809     R1 \break
810     f4 g c,2
811   }
812 >>
813 @end lilypond
814
815 @cindex ossia
816
817 @noindent
818 @code{\Staff \RemoveEmptyStaves} permet aussi de gérer des fragments
819 d'ossia attachés à une portée.  Pour plus de détails, voir
820 @ref{Portées d'ossia}.
821
822 @cindex musique ancienne, masquage de portée
823 @cindex portées rythmiques, masquage
824
825 @funindex \RemoveEmptyStaves
826
827 La commande @code{\VaticanaStaff \RemoveEmptyStaves} permet de masquer des
828 portées vides dans les contextes de musique ancienne.  Pour des
829 contextes @code{RhythmicStaff}, il faudra utiliser
830 @code{\RhythmicStaff \RemoveEmptyStaves}.
831
832 @predefined
833 @code{\Staff \RemoveEmptyStaves},
834 @code{\VaticanaStaff \RemoveEmptyStaves},
835 @code{\RhythmicStaff \RemoveEmptyStaves}.
836 @endpredefined
837
838 @snippets
839 @lilypondfile[verbatim,quote,texidoc,doctitle]
840 {removing-the-first-empty-line.ly}
841
842 @seealso
843 Glossaire musicologique :
844 @rglos{Frenched staff}.
845
846 Manuel d'initiation:
847 @rlearning{Visibilité et couleur des objets}.
848
849 Manuel de notation :
850 @ref{Dictée à trous},
851 @ref{Modification des réglages par défaut d'un contexte},
852 @ref{Portées d'ossia},
853 @ref{Silences invisibles},
854 @ref{Symbole de la portée},
855 @ref{Visibilité des objets}.
856
857 Morceaux choisis :
858 @rlsrnamed{Staff notation,Notation sur la portée}.
859
860 Référence des propriétés internes :
861 @rinternals{ChordNames},
862 @rinternals{FiguredBass},
863 @rinternals{Lyrics},
864 @rinternals{Staff},
865 @rinternals{VerticalAxisGroup},
866 @rinternals{Staff_symbol_engraver}.
867
868 @knownissues
869 Supprimer le @code{Staff_symbol_engraver} aura pour effet de masquer les
870 barres de mesure.  Forcer leur visibilité peut entraîner des problèmes
871 de formatage.  En pareil cas il vaut mieux, au lieu de supprimer le
872 graveur, recourir aux dérogations suivantes :
873
874 @example
875 \omit StaffSymbol
876 \override NoteHead.no-ledgers = ##t
877 @end example
878
879 En ce qui concerne les désagréments et messages liés à l'utilisation de
880 l'instruction @code{\Staff \RemoveEmptyStaves}, consultez
881 @ref{Modification des réglages par défaut d'un contexte}.
882
883
884 @node Écriture de parties séparées
885 @subsection Écriture de parties séparées
886 @translationof Writing parts
887
888 Nous allons voir, au fil des lignes qui suivent, comment insérer des
889 indications de tempo ou des noms d'instrument dans une partition.  Nous
890 aborderons aussi la citation d'autres voix, et comment la mettre en
891 forme.
892
893 @menu
894 * Noms d'instrument::
895 * Citation d'autres voix::
896 * Mise en forme d'une citation::
897 @end menu
898
899
900 @node Noms d'instrument
901 @unnumberedsubsubsec Noms d'instrument
902 @translationof Instrument names
903
904 @cindex instrument, noms
905 @cindex nom d'instrument
906 @cindex instrument, noms abrégés
907
908 Dans un conducteur, les noms d'instrument sont portés en regard de
909 chacune des portées, qu'il s'agisse d'un contexte @code{Staff},
910 @code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff} ou
911 @code{ChoirStaff} .  La première ligne affichera la valeur de
912 @code{instrumentName}, et les suivantes celle de
913 @code{shortInstrumentName}.
914
915 @lilypond[verbatim,quote,ragged-right]
916 \new Staff \with {
917   instrumentName = #"Violin "
918   shortInstrumentName = #"Vln. "
919 } \relative {
920   c'4.. g'16 c4.. g'16 \break | c1 |
921 }
922 @end lilypond
923
924 Le recours à la commande @code{\markup} permet de construire des noms
925 d'instrument particuliers, tels que
926
927 @lilypond[verbatim,quote]
928 \new Staff \with {
929   instrumentName = \markup {
930     \column { "Clarinetti"
931       \line { "in B" \smaller \flat }
932     }
933   }
934 } \relative {
935   c''4 c,16 d e f g2
936 }
937 @end lilypond
938
939 @cindex noms d'instrument, centrés
940
941 Lorsque plusieurs contextes de portée sont regroupés, les noms
942 d'instrument, que ce soit sous leur forme développée ou abrégée, sont
943 par défaut centrés.  Si l'un d'entre eux est libellé sur plusieurs
944 lignes, il faudra recourir à l'instruction @code{\center-column} :
945
946 @lilypond[verbatim,quote,indent=1.5\cm,relative=2]
947 <<
948   \new Staff \with {
949     instrumentName = #"Flute"
950   }
951   { f2 g4 f }
952   \new Staff \with {
953     instrumentName = \markup {
954       \center-column { "Clarinet"
955       \line { "in B" \smaller \flat }
956       }
957     }
958   }
959   { c4 b c2 }
960 >>
961 @end lilypond
962
963 @funindex indent
964 @funindex short-indent
965
966 Lorsque le nom d'un instrument est relativement long, il est judicieux
967 d'augmenter les retraits -- @emph{indent} -- au sein du bloc
968 @code{\layout} à l'aide des commandes @code{indent} et
969 @code{short-indent}.  Pour plus de plus amples détails sur ces réglages,
970 reportez-vous au chapitre @ref{Variables d'indentation et de décalage}.
971
972 @lilypond[verbatim,quote,ragged-right]
973 <<
974   \new Staff \with {
975     instrumentName = #"Alto Flute in G"
976     shortInstrumentName = #"Flt."
977   } \relative {
978     f''2 g4 f \break
979     g4 f g2
980   }
981   \new Staff \with {
982     instrumentName = #"Clarinet"
983     shortInstrumentName = #"Clar."
984   } \relative {
985     c''4 b c2 \break
986     c2 b4 c
987   }
988 >>
989
990 \layout {
991   indent = 3.0\cm
992   short-indent = 1.5\cm
993 }
994 @end lilypond
995
996 @cindex noms d'instrument, autres contextes
997
998 Des noms d'instrument peuvent s'utiliser dans d'autres contextes, tels
999 que @code{ChordNames} ou @code{FiguredBass}, dès lors qu'on leur adjoint
1000 le graveur @code{Instrument_name_engraver}.  Pour de plus amples
1001 informations sur la manière d'activer ou désactiver un graveur, voir
1002 @ref{Modification des greffons de contexte}.
1003
1004 @cindex instrument, changement de nom
1005 @cindex changement de nom d'instrument
1006
1007 Le nom abrégé d'un instrument (@code{shortInstrumentName}) peut changer
1008 en cours de morceau, en même temps que les autres réglages propres au
1009 nouvel instrument.  Notez cependant que la valeur de
1010 @code{instrumentName} ne s'affichera que sur la première portée :
1011
1012 @lilypond[verbatim,quote,ragged-right]
1013 prepPiccolo = <>^\markup \italic { muta in Piccolo }
1014
1015 setPiccolo = {
1016   \set Staff.instrumentName = #"Piccolo"
1017   \set Staff.shortInstrumentName = #"Picc."
1018   \set Staff.midiInstrument = #"piccolo"
1019   <>^\markup \bold { Piccolo }
1020   \transposition c''
1021 }
1022
1023 prepFlute = <>^\markup \italic { muta in Flauto }
1024
1025 setFlute = {
1026   \set Staff.instrumentName = #"Flute"
1027   \set Staff.shortInstrumentName = #"Flt."
1028   \set Staff.midiInstrument = #"flute"
1029   <>^\markup \bold { Flute }
1030   \transposition c'
1031 }
1032
1033 \new Staff \with {
1034   instrumentName = #"Flute"
1035   shortInstrumentName = #"Flt."
1036   midiInstrument = #"flute"
1037 }
1038 \relative {
1039   g'1 g g g \break
1040   g1 g \prepPiccolo R R \break
1041   \setPiccolo
1042   g1 g g g \break
1043   g1 g \prepFlute R R \break
1044   \setFlute
1045   g1 g g g
1046 }
1047 @end lilypond
1048
1049 @seealso
1050 Manuel de notation :
1051 @ref{Modification des greffons de contexte},
1052 @ref{Variables d'indentation et de décalage}.
1053
1054 Morceaux choisis :
1055 @rlsrnamed{Staff notation,Notation sur la portée}.
1056
1057 Référence des propriétés internes :
1058 @rinternals{InstrumentName},
1059 @rinternals{PianoStaff},
1060 @rinternals{Staff}.
1061
1062
1063 @node Citation d'autres voix
1064 @unnumberedsubsubsec Citation d'autres voix
1065 @translationof Quoting other voices
1066
1067 @cindex répliques
1068 @cindex citation
1069 @cindex petites notes
1070
1071 @funindex \addQuote
1072 @funindex addQuote
1073 @funindex \quoteDuring
1074 @funindex quoteDuring
1075 @funindex \transposition
1076 @funindex transposition
1077
1078 Il est assez courant qu'une voix soit doublée par une autre.  Par
1079 exemple, les premiers et seconds violons peuvent jouer les mêmes notes
1080 durant un moment.  LilyPond gère parfaitement ces situations où une
1081 voix est la @emph{réplique} d'une autre, sans devoir ressaisir la
1082 musique en question.
1083
1084 L'instruction @code{\addQuote}, placée au niveau le plus haut -- c'est à
1085 dire en dehors de tout bloc de musique -- définit la musique dont il
1086 sera possible de répliquer des fragments.
1087
1088 Au cours d'une partie, des extraits de répliques peuvent être cités en
1089 utilisant la commande @code{\quoteDuring}.  Cette commande prend deux
1090 arguments : le nom de la voix reproduite, tel que défini par
1091 @code{\addQuote}, et une expression musicale qui indique la durée de
1092 cette citation.
1093
1094 @lilypond[verbatim,quote]
1095 fluteNotes = \relative {
1096   a'4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1097 }
1098
1099 oboeNotes = \relative {
1100   c''4 cis c b \quoteDuring #"flute" { s1 }
1101 }
1102
1103 \addQuote "flute" { \fluteNotes }
1104
1105 \score {
1106   <<
1107     \new Staff \with { instrumentName = "Flute" } \fluteNotes
1108     \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1109   >>
1110 }
1111 @end lilypond
1112
1113 Si l'expression musicale utilisée pour @code{\quoteDuring} contenait
1114 autre chose que du silence, il en résulterait une situation
1115 polyphonique, ce qui n'est pas le but recherché :
1116
1117 @lilypond[verbatim,quote]
1118 fluteNotes = \relative {
1119   a'4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1120  }
1121
1122 oboeNotes = \relative {
1123   c''4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
1124 }
1125
1126 \addQuote "flute" { \fluteNotes }
1127
1128 \score {
1129   <<
1130     \new Staff \with { instrumentName = "Flute" } \fluteNotes
1131     \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1132   >>
1133 }
1134 @end lilypond
1135
1136 L'instruction @code{\quoteDuring} prendra en compte les réglages d'une
1137 commande @code{\transposition}, qu'elle apparaisse au niveau de la voix
1138 répliquée ou dans celle qui réplique.
1139
1140 @lilypond[verbatim,quote]
1141 clarinetNotes = \relative c'' {
1142   \transposition bes
1143   \key d \major
1144   b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
1145 }
1146
1147 oboeNotes = \relative {
1148   c''4 cis c b \quoteDuring #"clarinet" { s1 }
1149  }
1150 \addQuote "clarinet" { \clarinetNotes }
1151
1152 \score {
1153   <<
1154     \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
1155     \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1156   >>
1157 }
1158 @end lilypond
1159
1160 @cindex note-event
1161 @cindex articulation-event
1162 @cindex dynamic-event
1163 @cindex rest-event
1164 @cindex slur-event
1165 @cindex crescendo-event
1166
1167 @funindex quotedEventTypes
1168 @funindex quotedCueEventTypes
1169
1170 LilyPond répliquera, par défaut, tous les éléments -- articulations,
1171 nuances, @emph{markups}, etc. La propriété @code{quotedEventTypes}
1172 permet de définir plus précisément quels éléments de la voix originelle
1173 seront reproduits.
1174
1175 @lilypond[verbatim,quote]
1176 fluteNotes = \relative {
1177   a'2 g2 |
1178   b4\<^"quoted" r8 ais a4\f( c->)
1179  }
1180
1181 oboeNotes = \relative {
1182   c''2. b4 |
1183   \quoteDuring #"flute" { s1 }
1184 }
1185
1186 \addQuote "flute" { \fluteNotes }
1187
1188 \score {
1189   <<
1190     \set Score.quotedEventTypes = #'(note-event articulation-event
1191                                      crescendo-event rest-event
1192                                      slur-event dynamic-event)
1193     \new Staff \with { instrumentName = "Flute" } \fluteNotes
1194     \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1195   >>
1196  }
1197 @end lilypond
1198
1199 Les citations peuvent être « balisées » par un nom particulier afin de
1200 les utiliser de différentes manières.  Pour de plus amples détails à ce
1201 propos, consultez le chapitre @ref{Utilisation de balises}.
1202
1203 @seealso
1204 Manuel de notation :
1205 @ref{Instruments transpositeurs},
1206 @ref{Utilisation de balises}.
1207
1208 Fichiers d'initialisation :
1209 @file{scm/define-event-classes.scm}.
1210
1211 Morceaux choisis :
1212 @rlsrnamed{Staff notation, Notation sur la portée}.
1213
1214 Référence des propriétés internes :
1215 @rinternals{Music classes},
1216 @rinternals{QuoteMusic},
1217 @rinternals{Voice}.
1218
1219 @knownissues
1220 Seul le contenu de la première @code{Voice} rencontrée dans la
1221 partie marquée d'une commande @code{\addQuote} pourra être retenu.  Par
1222 voie de conséquence, @code{@var{musique}} ne saurait comprendre de
1223 @code{\new} ou une instance @code{\context Voice} qui la ferait
1224 passer à une autre voix.
1225
1226 Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
1227 un blocage de LilyPond.
1228
1229 Citer des triolets imbriqués peut entraîner un résultat de piètre
1230 qualité.
1231
1232
1233 @node Mise en forme d'une citation
1234 @unnumberedsubsubsec Mise en forme d'une citation
1235 @translationof Formatting cue notes
1236
1237 @cindex petites notes, formater des
1238 @cindex répliques, formatage
1239 @cindex voix, citation
1240 @cindex voix, réplication
1241 @cindex CueVoice
1242
1243 @funindex \cueDuring
1244 @funindex cueDuring
1245 @funindex \cueClef
1246 @funindex cueClef
1247 @funindex \cueDuringWithClef
1248 @funindex cueDuringWithClef
1249 @funindex \quoteDuring
1250 @funindex quoteDuring
1251
1252 Le moyen le plus simple pour mettre en forme des notes provenant d'une
1253 autre voix consiste à déclarer explicitement un contexte @code{CueVoice}
1254 au sein de la voix où elle apparaît.
1255
1256 @lilypond[verbatim]
1257 \relative {
1258   R1
1259   <<
1260     { e'2\rest r4. e8 }
1261     \new CueVoice {
1262       \stemUp d'8^"flute" c d e fis2
1263     }
1264   >>
1265   d,4 r a r
1266 }
1267 @end lilypond
1268
1269 L'instruction @code{\cueClef}, utilisée conjointement à un contexte
1270 @code{CueVoice} explicite permet d'indiquer la clef, dans une taille
1271 réduite, propre à la voix citée.  Le retour à la clef d'origine
1272 s'effectue à l'aide de l'instruction @code{\cueClefUnset}.
1273
1274 @lilypond[verbatim,noragged-right]
1275 \relative {
1276   \clef "bass"
1277   R1
1278   <<
1279     { e'2\rest r4. \cueClefUnset e,8 }
1280     \new CueVoice {
1281       \cueClef "treble" \stemUp d''8^"flute" c d e fis2
1282     }
1283   >>
1284   d,,4 r a r
1285 }
1286 @end lilypond
1287
1288 Notez que les deux instructions @code{\cueClef} et @code{\cueClefUnset}
1289 sont disponibles si nécessaire en dehors d'un @code{CueVoice}.
1290
1291 @lilypond[verbatim,noragged-right]
1292 \relative {
1293   \clef "bass"
1294   R1
1295   \cueClef "treble"
1296   d''8^"flute" c d e fis2
1297   \cueClefUnset
1298   d,,4 r a r
1299 }
1300 @end lilypond
1301
1302 Lorsque la situation est plus complexe, instrument transpositeur ou
1303 citations de plusieurs sources, vous disposez des instructions
1304 @code{\cueDuring} et @code{\cueDuringWithClef}, versions spécifiques de
1305 la commande @code{\quoteDuring} -- voir la rubrique précédente
1306 (@ref{Citation d'autres voix}).
1307
1308 Leur syntaxe est :
1309
1310 @example
1311 \cueDuring #@var{origine} #@var{position} #@var{musique}
1312 @end example
1313
1314 et
1315
1316 @example
1317 \cueDuringWithClef #@var{origine} #@var{position} #@var{clef} #@var{musique}
1318 @end example
1319
1320 Des mesures issues de la partie d'@code{@var{origine}} seront recopiées
1321 dans un contexte de @code{CueVoice} et synchronisées avec
1322 @code{@var{musique}} -- habituellement un silence.  L'apparition des
1323 petites notes initialise une polyphonie temporaire pour la portée
1324 concernée.  L'argument @code{@var{position}} détermine si ces petites
1325 notes seront attachées à la première ou à la seconde voix -- @code{UP}
1326 pour la première, @code{DOWN} pour la seconde.
1327
1328 @lilypond[verbatim,quote]
1329 fluteNotes = \relative {
1330   r2. c''4 | d8 c d e fis2 | g2 d |
1331 }
1332
1333 oboeNotes = \relative c'' {
1334   R1
1335   <>^\markup \tiny { flute }
1336   \cueDuring #"flute" #UP { R1 }
1337   g2 c,
1338 }
1339
1340 \addQuote "flute" { \fluteNotes }
1341
1342 \new Staff {
1343   \oboeNotes
1344 }
1345 @end lilypond
1346
1347 @noindent
1348 La propriété @code{quotedCueEventTypes} permet de définir précisément
1349 quels éléments de la voix originelle seront reproduits.  Sa valeur par
1350 défaut est @code{'(note-event rest-event tie-event beam-event
1351 tuplet-span-event)}.  LilyPond reproduira donc les notes, silences,
1352 liaisons de prolongation, ligatures et n-olets, mais pas les
1353 articulations, annotations ni nuances.
1354
1355 @warning{Dans l'exemple précédent, il était nécessaire de déclarer
1356 explicitement le contexte @code{Voice}, sinon l'intégralité de
1357 l'expression musicale se serait retrouvée dans le contexte
1358 @code{CueVoice}.}
1359
1360 @lilypond[verbatim,quote]
1361 oboeNotes = \relative {
1362   r2 r8 d''16(\f f e g f a)
1363   g8 g16 g g2.
1364 }
1365 \addQuote "oboe" { \oboeNotes }
1366
1367 \new Voice \relative c'' {
1368   \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
1369                                       beam-event tuplet-span-event
1370                                       dynamic-event slur-event)
1371   \cueDuring #"oboe" #UP { R1 }
1372   g2 c,
1373 }
1374 @end lilypond
1375
1376 Le nom de l'instrument qui est répliqué peut s'indiquer à l'aide d'un
1377 @emph{markup}.  Par ailleurs, si la citation nécessite l'apparition
1378 d'une clef différente, celle-ci devra être introduite manuellement, tout
1379 comme l'originale qui devra être rappelée en fin de citation.
1380
1381 @lilypond[verbatim,quote]
1382 fluteNotes = \relative {
1383   r2. c''4 d8 c d e fis2 g2 d2
1384 }
1385
1386 bassoonNotes = \relative c {
1387   \clef bass
1388   R1
1389   \clef treble
1390   <>^\markup \tiny { flute }
1391   \cueDuring #"flute" #UP { R1 }
1392   \clef bass
1393   g4. b8 d2
1394 }
1395
1396 \addQuote "flute" { \fluteNotes }
1397
1398 \new Staff {
1399   \bassoonNotes
1400 }
1401 @end lilypond
1402
1403 L'instruction @code{\cueDuringWithClef} se chargera quant à elle, et
1404 grâce à un argument supplémentaire, de gérer le changement de clef
1405 nécessaire à la citation et le retour à la clef originelle.
1406
1407 @lilypond[verbatim,quote]
1408 fluteNotes = \relative {
1409   r2. c''4 d8 c d e fis2 g2 d2
1410 }
1411
1412 bassoonNotes = \relative c {
1413   \clef bass
1414   R1
1415   <>^\markup { \tiny "flute" }
1416   \cueDuringWithClef #"flute" #UP #"treble" { R1 }
1417   g4. b8 d2
1418 }
1419
1420 \addQuote "flute" { \fluteNotes }
1421
1422 \new Staff {
1423   \bassoonNotes
1424 }
1425 @end lilypond
1426
1427 @funindex \transposedCueDuring
1428 @funindex transposedCueDuring
1429
1430 L'instruction @code{\cueDuring}, à l'instar de la commande
1431 @code{\quoteDuring}, tient compte des instruments transpositeurs.  La
1432 citation s'effectue aux hauteurs correspondant à l'instrument où elles
1433 apparaissent.
1434
1435 L'instruction @code{\transposedCueDuring} est particulièrement adaptée
1436 pour des instrument ayant une tessiture éloignée, comme dans le cas d'un
1437 piccolo cité dans une partie de clarinette basse.  Sa syntaxe  est
1438 identique à celle de @code{\cueDuring}, à ceci près qu'elle nécessite un
1439 argument supplémentaire afin de spécifier la transposition à effectuer
1440 en hauteur absolue.
1441
1442 @lilypond[verbatim,quote]
1443 piccoloNotes = \relative {
1444   \clef "treble^8"
1445   R1
1446   c'''8 c c e g2
1447   c4 g g2
1448 }
1449
1450 bassClarinetNotes = \relative c' {
1451   \key d \major
1452   \transposition bes,
1453   d4 r a r
1454   \transposedCueDuring #"piccolo" #UP d { R1 }
1455   d4 r a r
1456 }
1457
1458 \addQuote "piccolo" { \piccoloNotes }
1459
1460 <<
1461   \new Staff \piccoloNotes
1462   \new Staff \bassClarinetNotes
1463 >>
1464 @end lilypond
1465
1466 @cindex citation, fin
1467 @cindex fin de citation
1468 @cindex réplique, fin
1469 @cindex fin de réplique
1470
1471 @funindex \killCues
1472 @funindex killCues
1473
1474 La commande @code{killCues} permet de supprimer les notes d'une
1475 citation.  Ceci est utile lorsque cette citation n'est pas imprimée dans
1476 le conducteur entre autres.  @code{killCues} supprimera les notes et
1477 autres événements pris en charge par @code{\cueDuring}.  Pour les
1478 autres annotations telles que changement de clef ou instrument concerné,
1479 faites appel à des balises -- voir @ref{Utilisation de balises} à ce
1480 sujet.
1481
1482 @lilypond[verbatim,quote]
1483 fluteNotes = \relative {
1484   r2. c''4 d8 c d e fis2 g2 d2
1485 }
1486
1487 bassoonNotes = \relative c {
1488   \clef bass
1489   R1
1490   \tag #'part {
1491     \clef treble
1492     <>^\markup \tiny { flute }
1493   }
1494   \cueDuring #"flute" #UP { R1 }
1495   \tag #'part \clef bass
1496   g4. b8 d2
1497 }
1498
1499 \addQuote "flute" { \fluteNotes }
1500
1501 \new Staff {
1502   \bassoonNotes
1503 }
1504
1505 \new StaffGroup <<
1506   \new Staff {
1507     \fluteNotes
1508   }
1509   \new Staff {
1510     \removeWithTag #'part { \killCues { \bassoonNotes } }
1511   }
1512 >>
1513 @end lilypond
1514
1515 Lorsque la citation comporte une étiquette indiquant l'instrument qui
1516 joue et un changement de clef, ces éléments peuvent se regrouper à
1517 l'aide de la commande @code{\addInstrumentDefinition}.  Pour plus
1518 d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
1519
1520 @seealso
1521 Manuel de notation :
1522 @ref{Citation d'autres voix},
1523 @ref{Citation-repère},
1524 @ref{Clefs},
1525 @ref{Instruments transpositeurs},
1526 @ref{Noms d'instrument},
1527 @ref{Utilisation de balises}.
1528
1529 Morceaux choisis :
1530 @rlsrnamed{Staff notation, Notation sur la portée}.
1531
1532 Référence des propriétés internes :
1533 @rinternals{CueVoice},
1534 @rinternals{Voice}.
1535
1536 @knownissues
1537 La commande @code{\cueDuring} ne sait pas gérer les collisions de
1538 silence entre les contextes @code{Voice} et @code{CueVoice}.
1539
1540 Dans le cadre d'un @code{\cueDuringWithClef} ou d'un
1541 @code{\transposedCueDuring}, l'argument supplémentaire doit intervenir
1542 après l'origine et la position.