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