1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 904ea9fed4c66f5b86f3ac6ffb9fa273f082f371
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..
12 @c Translators: Valentin Villenave, Jean-Charles Malahieude
13 @c Translation checkers: John Mandereau
15 @node Notation sur la portée
16 @section Notation sur la portée
17 @translationof Staff notation
19 @lilypondfile[quote]{staff-headword.ly}
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
27 * Gravure des portées::
28 * Modification de portées individuelles::
29 * Écriture de parties séparées::
33 @node Gravure des portées
34 @subsection Gravure des portées
35 @translationof Displaying staves
37 Nous allons voir ici comment créer des portées et comment les regrouper.
40 * Initialisation de nouvelles portées::
41 * Regroupement de portées::
42 * Imbrication de regroupements de portées::
43 * Séparation des systèmes::
47 @node Initialisation de nouvelles portées
48 @unnumberedsubsubsec Initialisation de nouvelles portées
49 @translationof Instantiating new staves
51 @cindex nouvelle portée
52 @cindex portée, initialisation
53 @cindex portée, instanciation
54 @cindex portée, nouvelle
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 rythmique
62 @cindex portée de tablature
68 @funindex RhythmicStaff
70 @funindex MensuralStaff
71 @funindex VaticanaStaff
72 @funindex GregorianTranscriptionStaff
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}.
79 Le contexte de portée standard s'appelle @code{Staff}@tie{}:
81 @lilypond[verbatim,quote,relative=2]
82 \new Staff { c4 d e f }
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}.
92 @lilypond[verbatim,quote]
94 \drummode { cymc hh ss tomh }
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}.
103 @lilypond[verbatim,quote,relative=2]
104 \new RhythmicStaff { c4 d e f }
107 Un @code{TabStaff} crée une portée de tablature correspondant aux six
108 cordes d'une guitare standard. Pour de plus amples détails, consultez
109 @ref{Tablatures par défaut}.
111 @lilypond[verbatim,quote,relative=2]
112 \new TabStaff { c4 d e f }
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}.
119 Le contexte @code{GregorianTranscriptionStaff} permet d'obtenir des
120 éditions modernes du grégorien. Bien entendu, il est dépourvu de barres
123 @lilypond[verbatim,quote,relative=2]
124 \new GregorianTranscriptionStaff { c4 d e f e d }
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}.
132 Glossaire musicologique :
134 @rglosnamed{staves,portées}.
137 @ref{Création d'un contexte},
138 @ref{Portées de percussion},
139 @ref{Gravure de lignes rythmiques},
140 @ref{Tablatures par défaut},
141 @ref{Contextes prédéfinis},
142 @ref{Symbole de la portée},
143 @ref{Contextes du chant grégorien},
144 @ref{Contextes de musique mensurale},
145 @ref{Définition de nouveaux contextes}.
148 @rlsrnamed{Staff notation, Notation sur la portée}.
150 Référence des propriétés internes :
152 @rinternals{DrumStaff},
153 @rinternals{GregorianTranscriptionStaff},
154 @rinternals{RhythmicStaff},
155 @rinternals{TabStaff},
156 @rinternals{MensuralStaff},
157 @rinternals{VaticanaStaff},
158 @rinternals{StaffSymbol}.
161 @node Regroupement de portées
162 @unnumberedsubsubsec Regroupement de portées
163 @translationof Grouping staves
165 @cindex système, début de
166 @cindex crochet vertical
167 @cindex accolade verticale
168 @cindex portée multiple
169 @cindex portées, groupe de
170 @cindex portées, regroupement
171 @cindex chœur, système
172 @cindex piano, système
173 @cindex système choral
174 @cindex système pianistique
175 @cindex système, grand
178 LilyPond dispose de différents contextes permettant de regrouper des
179 portées individuelles et d'obtenir ainsi des @qq{systèmes}. Chacun de
180 ces contextes définira le style de regroupement, avec son signe
181 particulier en début de portée et ses règles de gestion des barres de
184 Lorsqu'aucun contexte particulier n'est spécifié, les propriétés
185 suivantes s'appliqueront par défaut@tie{}: les portées du groupe ne sont
186 pas reliées, hormis par une simple ligne verticale en début de ligne, et
187 les barres de mesure sont indépendantes.
189 @lilypond[verbatim,quote,relative=2]
196 Dans un @code{StaffGroup}, le groupe de portées est signifié par un
197 crochet, et les barres de mesure sont d'un seul tenant.
199 @lilypond[verbatim,quote,relative=2]
206 Dans un @code{ChoirStaff}, le groupe de portées est signifié par un
207 crochet sur la gauche, et les barres de mesure sont individuelles.
209 @lilypond[verbatim,quote,relative=2]
216 Dans un @code{GrandStaff}, le groupe de portées est signifié par une
217 accolade sur la gauche, et les barres de mesure sont d'un seul tenant.
219 @lilypond[verbatim,quote,relative=2]
226 Le contexte @code{PianoStaff} est identique au @code{GrandStaff}, sauf
227 qu'il gère automatiquement l'affichage du nom d'instrument -- voir
228 @ref{Noms d'instrument} pour plus de détails.
230 @lilypond[verbatim,quote,relative=2]
232 \set PianoStaff.instrumentName = #"Piano"
238 Les barres de mesure au début de chaque système adoptent l'un des styles
239 @code{SystemStartBar}, @code{SystemStartBrace} ou
240 @code{SystemStartBracket}. Dans chaque contexte, seul l'un de ces
241 styles est utilisé, et c'est la propriété @code{systemStartDelimiter}
242 qui détermine lequel. Un quatrième style, @code{SystemStartSquare},
243 doit quant à lui être spécifié de manière explicite.
245 Vous pouvez aussi créer vos propres contextes de regroupement, comme
246 l'explique @ref{Définition de nouveaux contextes}.
249 @lilypondfile[verbatim,quote,texidoc,doctitle]
250 {use-square-bracket-at-the-start-of-a-staff-group.ly}
252 @lilypondfile[verbatim,quote,texidoc,doctitle]
253 {display-bracket-with-only-one-staff-in-a-system.ly}
255 @cindex présentation mensurale
256 @cindex renaissance, musique
257 @cindex transcription de musique ancienne
258 @cindex musique ancienne, transcription
260 @lilypondfile[verbatim,quote,texidoc,doctitle]
261 {mensurstriche-layout-bar-lines-between-the-staves.ly}
264 Glossaire musicologique :
265 @rglosnamed{brace,accolade},
266 @rglosnamed{bracket,crochet},
267 @rglosnamed{grand staff,système}.
270 @ref{Noms d'instrument},
271 @ref{Définition de nouveaux contextes}.
274 @rlsrnamed{Staff notation, Notation sur la portée}.
276 Référence des propriétés internes :
278 @rinternals{StaffGroup},
279 @rinternals{ChoirStaff},
280 @rinternals{GrandStaff},
281 @rinternals{PianoStaff},
282 @rinternals{SystemStartBar},
283 @rinternals{SystemStartBrace},
284 @rinternals{SystemStartBracket},
285 @rinternals{SystemStartSquare}.
288 Un @code{PianoStaff} ne peut contenir, par défaut, de @code{ChordNames}.
291 @node Imbrication de regroupements de portées
292 @unnumberedsubsubsec Imbrication de regroupements de portées
293 @translationof Nested staff groups
295 @cindex portées, regroupement et imbrication
296 @cindex systèmes imbriqués
297 @cindex imbrication de systèmes
298 @cindex délimitation, systèmes imbriqués
300 Les accolades et crochets qui délimitent les systèmes peuvent être
301 imbriqués en profondeur. Chaque niveau inférieur aura son propre
302 délimiteur, en plus de celui du niveau supérieur.
304 @lilypond[verbatim,quote,relative=2]
306 \new Staff { c2 c | c2 c }
308 \new Staff { g2 g | g2 g }
309 \new StaffGroup \with {
310 systemStartDelimiter = #'SystemStartSquare
313 \new Staff { e2 e | e2 e }
314 \new Staff { c2 c | c2 c }
320 Vous pouvez aussi créer vos propres contextes d'imbrication, comme
321 l'explique @ref{Définition de nouveaux contextes}.
324 @lilypondfile[verbatim,quote,texidoc,doctitle]
329 @ref{Regroupement de portées},
330 @ref{Noms d'instrument},
331 @ref{Définition de nouveaux contextes}.
334 @rlsrnamed{Staff notation,Notation sur la portée}.
336 Référence des propriétés internes :
337 @rinternals{StaffGroup},
338 @rinternals{ChoirStaff},
339 @rinternals{SystemStartBar},
340 @rinternals{SystemStartBrace},
341 @rinternals{SystemStartBracket},
342 @rinternals{SystemStartSquare}.
345 @node Séparation des systèmes
346 @unnumberedsubsubsec Séparation des systèmes
347 @translationof Separating systems
349 @cindex système, indicateur de séparation
351 Le nombre de systèmes peut varier d'une page à l'autre@tie{}; vous
352 pouvez, en pareil cas, rendre plus évidente la séparation entre les
353 systèmes en l'indiquant visuellement. Ce @qq{séparateur} est absent par
354 défaut, mais vous pouvez l'activer par une option au sein du bloc
357 @c \book is required here to display the system separator
358 @c ragged-right is required as there are two systems
359 @lilypond[verbatim,quote,ragged-right]
380 system-separator-markup = \slashSeparator
381 % following commands are needed only to format this documentation
383 paper-height = 100\mm
391 @ref{Mise en forme de la page}.
394 @rlsrnamed{Staff notation,Notation sur la portée}.
397 @node Modification de portées individuelles
398 @subsection Modification de portées individuelles
399 @translationof Modifying single staves
401 Cette section explique le réglage de la gravure de chaque portée,
402 comme la taille de portée ou le nombre de lignes@tie{}; sont aussi
403 décrits la suspension et la reprise de portées, ainsi que les portées
407 * Symbole de la portée::
409 * Masquage de portées::
413 @node Symbole de la portée
414 @unnumberedsubsubsec Symbole de la portée
415 @translationof Staff symbol
417 @cindex symbole de portée
418 @cindex portée, lignes de
419 @cindex lignes de portée, nombre de
420 @cindex suspension de portée
421 @cindex portée, suspension
422 @cindex reprise de portée
423 @cindex portée, reprise
424 @cindex lignes de portée, épaisseur
425 @cindex ligne supplémentaire
427 @funindex \startStaff
432 Les commandes @code{\stopStaff} et @code{\startStaff} permettent
433 respectivement de clôturer et (re)démarrer une portée n'importe où dans
436 @lilypond[verbatim,quote,relative=2]
437 \stopStaff f4 d \startStaff g, e
438 f'4 d \stopStaff g, e
439 f'4 d \startStaff g, e
447 Les notes, nuances, etc. sont regroupées dans un assemblage de lignes
448 horizontales, que l'on nomme la portée (en anglais @emph{staff}, et
449 @emph{staves} au pluriel). Dans LilyPond, ces lignes sont dessinées au
450 moyen d'un objet graphique (@emph{grob}) à part entière, nommé
451 @code{StaffSymbol} -- symbole de portée. Modifier les propriétés d'un
452 @code{StaffSymbol} changera l'apparence de la portée, dès lors qu'elles
453 auront été définies avant de créer la portée en question.
455 Vous pouvez modifier le nombre de lignes d'une portée.
457 @lilypond[verbatim,quote,relative=2]
459 \override Staff.StaffSymbol #'line-count = #2
463 \revert Staff.StaffSymbol #'line-count
467 Le positionnement de chacune des lignes de la portée est modifiable.
468 Les valeurs s'expriment en @emph{demi} espace de portée, et la nouvelle
469 position est déterminée par rapport à la ligne médiane. Une ligne sera
470 donc imprimée pour chaque valeur exprimée@tie{}; le nombre de lignes,
471 ainsi que leur position dans la portée, peut donc se modifier à l'aide
472 d'une seule commande.
474 @lilypond[verbatim,quote,relative=2]
476 \override Staff.StaffSymbol #'line-positions = #'(1 3 5 -1 -3)
479 \override Staff.StaffSymbol #'line-positions = #'(8 6.5 -6 -8 -0.5)
483 La position de la clef et celle du do médium demanderont parfois un
484 ajustement afin d'être en phase avec cette nouvelle portée. Pour plus
485 d'explications, reportez-vous aux exemples du chapitre @ref{Clefs}.
487 Lorsque vous modifierez l'épaisseur des lignes, gardez à l'esprit que
488 les lignes supplémentaires et les hampes seront aussi modifiées.
490 @lilypond[verbatim,quote,relative=1]
492 \override StaffSymbol #'thickness = #3
497 L'épaisseur des lignes supplémentaires (@emph{ledger lines}) peut être
498 déterminée indépendamment des lignes de la portée. Dans l'exemple
499 suivant, les deux nombres constituent des coefficients multiplicateurs
500 de l'épaisseur de la ligne. Ils sont fournis en argument pour
501 déterminer l'épaisseur des lignes supplémentaires.
503 @lilypond[verbatim,quote,relative=2]
505 \override StaffSymbol #'thickness = #2
506 \override StaffSymbol #'ledger-line-thickness = #'(0.5 . 0.4)
511 L'emplacement des lignes supplémentaires est réglable@tie{}:
513 @lilypond[verbatim,quote,relative=2]
515 \override StaffSymbol #'ledger-positions = #'(-3 -2 -1 2 5 6)
520 Vous pouvez faire apparaître des lignes supplémentaires additionnelles
521 au-dessus ou en dessous des têtes de note selon le positionnement
522 relatif aux autres notes, qu'elles aient ou non elles-mêmes des lignes
525 @lilypond[verbatim,quote,relative=2]
527 \override StaffSymbol #'ledger-extra = #4
532 Des lignes supplémentaires peuvent apparaître y compris au sein d'une
533 portée, notamment lorsque vous l'avez personnalisée. L'exemple suivant
534 illustre deux cas de figure quant au positionnement des lignes
535 supplémentaires selon que la propriété @code{legder-position} est
536 définie explicitement ou non. La présence du @code{stopStaff} est ici
537 rendue nécessaire pour annuler les effets de la commande
538 @code{\override} qui s'applique à l'intégralité du @code{StaffSymbol}.
540 @lilypond[fragment,quote,relative=1]
541 \override Staff.StaffSymbol #'line-positions = #'(-8 0 2 4)
545 \override Staff.StaffSymbol #'ledger-positions = #'(-8 -6 (-4 -2) 0)
549 Modifier l'équidistance des lignes de la portée affectera aussi les
550 lignes supplémentaires.
552 @lilypond[verbatim,quote,relative=2]
554 \override StaffSymbol #'staff-space = #1.5
560 @lilypondfile[verbatim,quote,texidoc,doctitle]
561 {making-some-staff-lines-thicker-than-the-others.ly}
564 Glossaire musicologique :
565 @rglosnamed{line,ligne},
566 @rglosnamed{ledger line,ligne supplémentaire},
567 @rglosnamed{staff,portée}.
573 @rlsrnamed{Staff notation,Notation sur la portée}.
575 Référence des propriétés internes :
576 @rinternals{StaffSymbol},
577 @rinternals{staff-symbol-interface}.
580 @node Portées d'ossia
581 @unnumberedsubsubsec Portées d'ossia
582 @translationof Ossia staves
584 @cindex portée à la française
587 @cindex portées, nombre variable de
588 @cindex nombre de portées
590 @funindex \startStaff
595 Une portée d'@notation{ossia} -- ou de variante -- s'obtient en créant,
596 à l'endroit approprié, une nouvelle portée simultanée@tie{}:
598 @lilypond[verbatim,quote]
599 \new Staff \relative c'' {
603 \new Staff { e4 d f e }
610 L'exemple ci-dessus n'est probablement pas ce qui vous conviendra le
611 plus. Afin que cette ossia se place au-dessus de la portée à laquelle
612 elle se réfère, étant par ailleurs dépourvue de métrique et de clef, et
613 d'une taille légèrement inférieure, vous devrez avoir recours à quelques
614 retouches. Le manuel d'initiation aborde une technique particulière
615 pour obtenir ce résultat au chapitre
616 @rlearning{Expressions musicales imbriquées}.
618 L'exemple qui suit utilise, pour aligner la portée d'ossia, la propriété
619 @code{alignAboveContext}. Cette méthode est tout à fait appropriée
620 lorsqu'il y a un nombre restreint d'ossias.
622 @lilypond[verbatim,quote]
623 \new Staff = main \relative c'' {
629 \remove "Time_signature_engraver"
630 alignAboveContext = #"main"
632 \override StaffSymbol #'staff-space = #(magstep -3)
633 \override StaffSymbol #'thickness = #(magstep -3)
642 Dans le cas où de nombreux et courts fragments d'ossia affecteraient
643 une même portée, il est judicieux de créer un contexte @code{Staff} vide
644 auquel sera attribué un @emph{identifiant}. Il suffira alors, pour
645 entamer un fragment d'ossia, de @emph{faire appel} à ce contexte grâce
646 aux commandes @code{\startStaff} et @code{\stopStaff}. Vous vous
647 rendrez compte à l'utilisation des avantages que procure cette façon de
648 procéder, bien plus que dans l'exemple suivant.
650 @lilypond[verbatim,quote,ragged-right]
652 \new Staff = ossia \with {
653 \remove "Time_signature_engraver"
654 \override Clef #'transparent = ##t
656 \override StaffSymbol #'staff-space = #(magstep -3)
657 \override StaffSymbol #'thickness = #(magstep -3)
661 \new Staff \relative c' {
665 \context Staff = ossia {
666 \startStaff e4 g8 f e2 \stopStaff
673 \context Staff = ossia {
674 \startStaff g4 e8 f g2 \stopStaff
682 Vous pourriez aussi recourir à la commande
683 @code{\Staff \RemoveEmptyStaves} pour créer votre portée d'ossia.
684 Cependant, cette méthode reste limitée à l'apparition de ces ossias en
685 début de ligne. Pour plus d'information au sujet de la commande
686 @code{\Staff \RemoveEmptyStaves}, reportez-vous au chapitre
687 @ref{Masquage de portées}.
689 @lilypond[verbatim,quote,ragged-right]
691 \new Staff = ossia \with {
692 \remove "Time_signature_engraver"
693 \override Clef #'transparent = ##t
695 \override StaffSymbol #'staff-space = #(magstep -3)
696 \override StaffSymbol #'thickness = #(magstep -3)
701 \new Staff \relative c' {
713 \Staff \RemoveEmptyStaves
714 \override VerticalAxisGroup #'remove-first = ##t
720 @lilypondfile[verbatim,quote,texidoc,doctitle]
721 {vertically-aligning-ossias-and-lyrics.ly}
724 Glossaire musicologique :
726 @rglosnamed{staff,portée},
727 @rglos{Frenched staff}.
729 Manuel d'initiation :
730 @rlearning{Expressions musicales imbriquées},
731 @rlearning{Taille des objets},
732 @rlearning{Longueur et épaisseur des objets}.
735 @ref{Masquage de portées}.
738 @rlsrnamed{Staff notation,Notation sur la portée}.
740 Référence des propriétés internes :
741 @rinternals{StaffSymbol}.
744 @node Masquage de portées
745 @unnumberedsubsubsec Masquage de portées
746 @translationof Hiding staves
748 @cindex Frenched scores
749 @cindex Masquage de portée
752 @funindex \RemoveEmptyStaves
753 @funindex Staff_symbol_engraver
757 Désactiver le graveur @code{Staff_symbol_engraver} dans un contexte
758 @code{Staff} permet de masquer des lignes. La commande
759 @code{\stopStaff} aura le même effet.
761 @lilypond[verbatim,quote]
763 \remove "Staff_symbol_engraver"
765 \relative c''' { a8 f e16 d c b a2 }
768 L'instruction @code{\Staff \RemoveEmptyStaves} placée dans un bloc
769 @code{\layout} aura pour effet de masquer toute portée qui ne contient
770 rien. Dans les partitions d'orchestre, les portées qui n'ont que des
771 silences sont habituellement masquées afin de gagner de la place. Ce
772 style d'édition s'appelle en anglais @qq{French Score}.
773 Cette fonctionnalité masque et supprime toutes les portées vides d'une
774 partition, hormis celles du premier système.
776 @warning{Une portée est considérée comme vide dès lors qu'elle ne
777 contient que des silences multimesures, des silences visibles ou
778 invisibles (ou d'espacement -- les @emph{\skip}) ou bien une combinaison
781 @lilypond[verbatim,quote,ragged-right]
784 \Staff \RemoveEmptyStaves
805 @code{\Staff \RemoveEmptyStaves} permet aussi de gérer des fragments
806 d'ossia attachés à une portée. Pour plus de détails, voir
807 @ref{Portées d'ossia}.
809 @cindex musique ancienne, masquage de portée
810 @cindex portées rythmiques, masquage
812 @funindex \RemoveEmptyStaves
814 La commande @code{\VaticanaStaff \RemoveEmptyStaves} permet de masquer des
815 portées vides dans les contextes de musique ancienne. Pour des
816 contextes @code{RhythmicStaff}, il faudra utiliser
817 @code{\RhythmicStaff \RemoveEmptyStaves}.
820 @code{\Staff \RemoveEmptyStaves},
821 @code{\VaticanaStaff \RemoveEmptyStaves},
822 @code{\RhythmicStaff \RemoveEmptyStaves}.
826 @lilypondfile[verbatim,quote,texidoc,doctitle]
827 {removing-the-first-empty-line.ly}
830 Glossaire musicologique :
831 @rglos{Frenched staff}.
834 @rlearning{Visibilité et couleur des objets}.
837 @ref{Symbole de la portée},
838 @ref{Portées d'ossia},
839 @ref{Dictée à trous},
840 @ref{Silences invisibles},
841 @ref{Visibilité des objets}.
844 @rlsrnamed{Staff notation,Notation sur la portée}.
846 Référence des propriétés internes :
847 @rinternals{ChordNames},
848 @rinternals{FiguredBass},
851 @rinternals{VerticalAxisGroup},
852 @rinternals{Staff_symbol_engraver}.
855 Supprimer le @code{Staff_symbol_engraver} aura pour effet de masquer les
856 barres de mesure. Forcer leur visibilité peut entraîner des problèmes
857 de formatage. En pareil cas il vaut mieux, au lieu de supprimer le
858 graveur, recourir aux dérogations suivantes@tie{}:
861 \override StaffSymbol #'stencil = ##f
862 \override NoteHead #'no-ledgers = ##t
865 En ce qui concerne les désagréments et messages liés à l'utilisation de
866 l'instruction @code{\Staff \RemoveEmptyStaves}, consultez
867 @ref{Modification des réglages par défaut d'un contexte}.
870 @node Écriture de parties séparées
871 @subsection Écriture de parties séparées
872 @translationof Writing parts
874 Nous allons voir, au fil des lignes qui suivent, comment insérer des
875 indications de tempo ou des noms d'instrument dans une partition. Nous
876 aborderons aussi la citation d'autres voix, et comment la mettre en
880 * Noms d'instrument::
881 * Citation d'autres voix::
882 * Mise en forme d'une citation::
886 @node Noms d'instrument
887 @unnumberedsubsubsec Noms d'instrument
888 @translationof Instrument names
890 @cindex instrument, noms
891 @cindex nom d'instrument
892 @cindex instrument, noms abrégés
894 Dans un conducteur, les noms d'instrument sont portés en regard de
895 chacune des portées, qu'il s'agisse d'un contexte @code{Staff},
896 @code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff} ou
897 @code{ChoirStaff} . La première ligne affichera la valeur de
898 @code{instrumentName}, et les suivantes celle de
899 @code{shortInstrumentName}.
901 @lilypond[verbatim,quote,ragged-right,relative=1]
903 instrumentName = #"Violin "
904 shortInstrumentName = #"Vln. "
906 { c4.. g'16 c4.. g'16 \break | c1 }
909 Le recours à la commande @code{\markup} permet de construire des noms
910 d'instrument particuliers, tels que
912 @lilypond[verbatim,quote,relative=2]
914 instrumentName = \markup {
915 \column { "Clarinetti"
916 \line { "in B" \smaller \flat }
923 @cindex noms d'instrument, centrés
925 Lorsque plusieurs contextes de portée sont regroupés, les noms
926 d'instrument, que ce soit sous leur forme développée ou abrégée, sont
927 par défaut centrés. Si l'un d'entre eux est libellé sur plusieurs
928 lignes, il faudra reccourrir à l'instruction
929 @code{\center-column}@tie{}:
931 @lilypond[verbatim,quote,indent=1.5\cm,relative=2]
934 instrumentName = #"Flute"
938 instrumentName = \markup {
939 \center-column { "Clarinet" }
940 \line { "in B" \smaller \flat }
948 @funindex short-indent
950 Lorsque le nom d'un instrument est relativement long, il est judicieux
951 d'augmenter les retraits -- @emph{indent} -- au sein du bloc
952 @code{\layout} à l'aide des commandes @code{indent} et
953 @code{short-indent}. Pour plus de plus amples détails sur ces réglages,
954 reportez-vous au chapitre @ref{Variables d'indentation et de décalage}.
956 @lilypond[verbatim,quote,ragged-right]
960 instrumentName = #"Alto Flute in G"
961 shortInstrumentName = #"Flt."
968 instrumentName = #"Clarinet"
969 shortInstrumentName = #"Clar."
980 short-indent = 1.5\cm
984 @cindex noms d'instrument, autres contextes
986 Des noms d'instrument peuvent s'utiliser dans d'autres contextes, tels
987 que @code{ChordNames} ou @code{FiguredBass}, dès lors qu'on leur adjoint
988 le graveur @code{Instrument_name_engraver}. Pour de plus amples
989 informations sur la manière d'activer ou désactiver un graveur, voir
990 @ref{Modification des greffons de contexte}.
992 @cindex instrument, changement de nom
993 @cindex changement de nom d'instrument
995 Vous pouvez changer le nom d'un instrument en cours de morceau. Notez
996 cependant que la valeur de @code{instrumentName} ne s'affichera que sur
997 la première portée@tie{}:
999 @lilypond[verbatim,quote,ragged-right,relative=1]
1001 instrumentName = #"Flute"
1002 shortInstrumentName = #"Flt."
1007 \set Staff.instrumentName = #"Clarinet"
1008 \set Staff.shortInstrumentName = #"Clt."
1014 @cindex instrument, changement
1015 @cindex changement d'instrument
1017 @funindex \addInstrumentDefinition
1018 @funindex addInstrumentDefinition
1019 @funindex \instrumentSwitch
1020 @funindex instrumentSwitch
1022 Lorsqu'un musicien doit changer d'instrument -- piccolo et flûte, basson
1023 et contrebasson --, la commande @code{\addInstrumentDefinition},
1024 couplée à l'instruction @code{\instrumentSwitch} permet de spécifier en
1025 détail les modifications intervenant lors du changement. La commande
1026 @code{\addInstrumentDefinition} prend deux arguments@tie{}: une chaîne
1027 de caractères qui servira d'identifiant, et une liste d'association
1028 de valeurs aux propriétés de ce nouvel instrument. Ces définitions
1029 devront être déclarées avant tout autre élément musical. L'instruction
1030 @code{\instrumentSwitch} se placera dans la musique au moment de la
1033 @lilypond[verbatim,quote,ragged-right]
1034 \addInstrumentDefinition #"contrabassoon"
1035 #`((instrumentTransposition . ,(ly:make-pitch -1 0 0))
1036 (shortInstrumentName . "Cbsn.")
1037 (clefGlyph . "clefs.F")
1038 (middleCPosition . 6)
1040 (instrumentCueName . ,(make-bold-markup "cbsn."))
1041 (midiInstrument . "bassoon"))
1044 instrumentName = #"Bassoon"
1048 \compressFullBarRests
1051 \instrumentSwitch "contrabassoon"
1058 Manuel de notation :
1059 @ref{Variables d'indentation et de décalage},
1060 @ref{Modification des greffons de contexte}.
1063 @rlsrnamed{Staff notation,Notation sur la portée}.
1065 Référence des propriétés internes :
1066 @rinternals{InstrumentName},
1067 @rinternals{PianoStaff},
1071 @node Citation d'autres voix
1072 @unnumberedsubsubsec Citation d'autres voix
1073 @translationof Quoting other voices
1077 @cindex petites notes
1081 @funindex \quoteDuring
1082 @funindex quoteDuring
1083 @funindex \transposition
1084 @funindex transposition
1086 Il est assez courant qu'une voix soit doublée par une autre. Par
1087 exemple, les premiers et seconds violons peuvent jouer les mêmes notes
1088 durant un moment. LilyPond gère parfaitement ces situations où une
1089 voix est la @emph{réplique} d'une autre, sans devoir ressaisir la
1090 musique en question.
1092 L'instruction @code{\addQuote}, placée au niveau le plus haut -- c'est à
1093 dire en dehors de tout bloc de musique -- définit le musique dont il
1094 sera possible de répliquer des fragments.
1096 Au cours d'une partie, des extraits de répliques peuvent être cités en
1097 utilisant la commande @code{\quoteDuring}. Cette commande prend deux
1098 arguments@tie{}: le nom de la voix reproduite, tel que défini par
1099 @code{\addQuote}, et une expression musicale qui indique la durée de
1102 @lilypond[verbatim,quote]
1103 fluteNotes = \relative c'' {
1104 a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1107 oboeNotes = \relative c'' {
1108 c4 cis c b \quoteDuring #"flute" { s1 }
1111 \addQuote "flute" { \fluteNotes }
1115 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1116 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1121 Si l'expression musicale utilisée pour @code{\quoteDuring} contenait
1122 autre chose que du silence, il en résulterait une situation
1123 polyphonique, ce qui n'est pas le but recherché@tie{}:
1125 @lilypond[verbatim,quote]
1126 fluteNotes = \relative c'' {
1127 a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1130 oboeNotes = \relative c'' {
1131 c4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
1134 \addQuote "flute" { \fluteNotes }
1138 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1139 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1144 L'instruction @code{\quoteDuring} prendra en compte les réglages d'une
1145 commande @code{\transposition}, qu'elle apparaisse au niveau de la voix
1146 répliquée ou dans celle qui réplique.
1148 @lilypond[verbatim,quote]
1149 clarinetNotes = \relative c'' {
1152 b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
1155 oboeNotes = \relative c'' {
1156 c4 cis c b \quoteDuring #"clarinet" { s1 }
1158 \addQuote "clarinet" { \clarinetNotes }
1162 \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
1163 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1169 @cindex articulation-event
1170 @cindex dynamic-event
1173 @cindex crescendo-event
1175 @funindex quotedEventTypes
1176 @funindex quotedCueEventTypes
1178 LilyPond répliquera, par défaut, tous les éléments -- articulations,
1179 nuances, @emph{markups}, etc. La propriété @code{quotedEventTypes}
1180 permet de définir plus précisément quels éléments de la voix originelle
1183 @lilypond[verbatim,quote]
1184 fluteNotes = \relative c'' {
1186 b4\<^"quoted" r8 ais a4\f( c->)
1189 oboeNotes = \relative c'' {
1191 \quoteDuring #"flute" { s1 }
1194 \addQuote "flute" { \fluteNotes }
1198 \set Score.quotedEventTypes = #'(note-event articulation-event
1199 crescendo-event rest-event
1200 slur-event dynamic-event)
1201 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1202 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1207 Les citations peuvent être @qq{balisées} par un nom particulier afin de
1208 les utiliser de différentes manières. Pour de plus amples détails à ce
1209 propos, consultez le chapitre @ref{Utilisation de balises}.
1212 Manuel de notation :
1213 @ref{Instruments transpositeurs},
1214 @ref{Utilisation de balises}.
1216 Fichiers d'initialisation :
1217 @file{scm/define-event-classes.scm}.
1220 @rlsrnamed{Staff notation, Notation sur la portée}.
1222 Référence des propriétés internes :
1223 @rinternals{Music classes},
1224 @rinternals{QuoteMusic},
1228 Seul le contenu de la première @code{Voice} rencontrée dans la
1229 partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
1230 voie de conséquence, @code{@var{musique}} ne saurait comprendre de
1231 @code{\new} ou une instance @code{\context@tie{}Voice} qui la ferait
1232 passer à une autre voix.
1234 Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
1235 un blocage de LilyPond.
1237 Citer des triolets imbriqués peut entraîner un résultat de piètre
1241 @node Mise en forme d'une citation
1242 @unnumberedsubsubsec Mise en forme d'une citation
1243 @translationof Formatting cue notes
1245 @cindex petites notes, formater des
1246 @cindex répliques, formatage
1247 @cindex voix, citation
1248 @cindex voix, réplication
1251 @funindex \cueDuring
1255 @funindex \cueDuringWithClef
1256 @funindex cueDuringWithClef
1257 @funindex \quoteDuring
1258 @funindex quoteDuring
1260 Le moyen le plus simple pour mettre en forme des notes provenant d'une
1261 autre voix consiste à déclarer explicitement un contexte @code{CueVoice}
1262 au sein de la voix où elle apparaît.
1264 @lilypond[verbatim,relative=1]
1269 \stemUp d'8^"flute" c d e fis2
1275 L'instruction @code{\cueClef}, utilisée conjointement à un contexte
1276 @code{CueVoice} explicite permet d'indiquer la clef, dans une taille
1277 réduite, propre à la voix citée. Le retour à la clef d'origine
1278 s'effectue à l'aide de l'instruction @code{\cueClefUnset}.
1280 @lilypond[verbatim,noragged-right,relative=1]
1284 { e2\rest r4. \cueClefUnset e,8 }
1286 \cueClef "treble" \stemUp d''8^"flute" c d e fis2
1292 Notez que les deux instructions @code{\cueClef} et @code{\cueClefUnset}
1293 sont disponibles si nécessaire en dehors d'un @code{CueVoice}.
1295 @lilypond[verbatim,noragged-right,relative=1]
1299 d'8^"flute" c d e fis2
1304 Lorsque la situation est plus complexe, instrument transpositeur ou
1305 citations de plusieurs sources, vous disposez des instructions
1306 @code{\cueDuring} et @code{\cueDuringWithClef}, versions spécifiques de
1307 la commande @code{\quoteDuring} -- voir la rubrique précédente
1308 (@ref{Citation d'autres voix}).
1313 \cueDuring #@var{origine} #@var{position} #@var{musique}
1319 \cueDuringWithClef #@var{origine} #@var{position} #@var{clef} #@var{musique}
1322 Des mesures issues de la partie d'@code{@var{origine}} seront recopiées
1323 dans un contexte de @code{CueVoice} et synchronisées avec
1324 @code{@var{musique}} -- habituellement un silence. L'apparition des
1325 petites notes initialise une polyphonie temporaire pour la portée
1326 concernée. L'argument @code{@var{position}} détermine si ces petites
1327 notes seront attachées à la première ou à la seconde voix -- @code{UP}
1328 pour la première, @code{DOWN} pour la seconde.
1330 @lilypond[verbatim,quote]
1331 fluteNotes = \relative c'' {
1332 r2. c4 | d8 c d e fis2 | g2 d |
1335 oboeNotes = \relative c'' {
1337 \new CueVoice { \set instrumentCueName = "flute" }
1338 \cueDuring #"flute" #UP { R1 }
1342 \addQuote "flute" { \fluteNotes }
1350 La propriété @code{quotedCueEventTypes} permet de définir précisément
1351 quels éléments de la voix originelle seront reproduits. Sa valeur par
1352 défaut est @code{'(note-event rest-event tie-event beam-event
1353 tuplet-span-event)}. LilyPond reproduira donc les notes, silences,
1354 liaisons de prolongation, ligatures et nolets, mais pas les
1355 articulations, annotations ni nuances.
1357 @warning{Dans l'exemple précédent, il était nécessaire de déclarer
1358 explicitement le contexte @code{Voice}, sinon l'intégralité de
1359 l'expression musicale se serait retrouvée dans le contexte
1362 @lilypond[verbatim,quote]
1363 oboeNotes = \relative c'' {
1364 r2 r8 d16(\f f e g f a)
1367 \addQuote "oboe" { \oboeNotes }
1369 \new Voice \relative c'' {
1370 \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
1371 beam-event tuplet-span-event
1372 dynamic-event slur-event)
1373 \cueDuring #"oboe" #UP { R1 }
1378 Le nom de l'instrument qui est répliqué sera imprimé dès lors qu'aura
1379 été définie la propriété @code{instrumentCueName} d'un contexte
1380 @code{CueVoice} temporaire. Le positionnement et le style adopté par
1381 @code{instrumentCueName} dépendent de l'objet @code{\instrumentSwitch}
1382 -- voir @ref{Noms d'instrument}. Par ailleurs, si la citation nécessite
1383 l'apparition d'une clef différente, celle-ci devra être introduite
1384 manuellement, tout comme l'originale qui devra être rappelée en fin de
1387 @lilypond[verbatim,quote]
1388 fluteNotes = \relative c'' {
1389 r2. c4 d8 c d e fis2 g2 d2
1392 bassoonNotes = \relative c {
1396 \new CueVoice { \set instrumentCueName = "flute" }
1397 \cueDuring #"flute" #UP { R1 }
1402 \addQuote "flute" { \fluteNotes }
1409 L'instruction @code{\cueDuringWithClef} se chargera quant à elle, et
1410 grâce à un argument supplémentaire, de gérer le changement de clef
1411 nécessaire à la citation et le retour à la clef originelle.
1413 @lilypond[verbatim,quote]
1414 fluteNotes = \relative c'' {
1415 r2. c4 d8 c d e fis2 g2 d2
1418 bassoonNotes = \relative c {
1421 \new CueVoice { \set instrumentCueName = "flute" }
1422 \cueDuringWithClef #"flute" #UP #"treble" { R1 }
1426 \addQuote "flute" { \fluteNotes }
1433 @funindex \transposedCueDuring
1434 @funindex transposedCueDuring
1436 L'instruction @code{\cueDuring}, à l'instar de la commande
1437 @code{\quoteDuring}, tient compte des instruments transpositeurs. La
1438 citation s'effectue aux hauteurs correspondant à l'instrument où elles
1441 L'instruction @code{\transposedCueDuring} est particulièrement adaptée
1442 pour des instrument ayant une tessiture éloignée, comme dans le cas d'un
1443 piccolo cité dans une partie de clarinette basse. Sa syntaxe est
1444 identique à celle de @code{\cueDuring}, à ceci près qu'elle nécessite un
1445 argument supplémentaire afin de spécifier la transposition à effectuer
1448 @lilypond[verbatim,quote]
1449 piccoloNotes = \relative c''' {
1456 bassClarinetNotes = \relative c' {
1460 \transposedCueDuring #"piccolo" #UP d { R1 }
1464 \addQuote "piccolo" { \piccoloNotes }
1467 \new Staff \piccoloNotes
1468 \new Staff \bassClarinetNotes
1472 @cindex citation, fin
1473 @cindex fin de citation
1474 @cindex réplique, fin
1475 @cindex fin de réplique
1479 @funindex \addInstrumentDefinition
1480 @funindex addInstrumentDefinition
1482 La commande @code{killCues} permet de supprimer les notes d'une
1483 citation. Ceci est utile lorsque cette citation n'est pas imprimée dans
1484 le conducteur entre autres. @code{killCues} supprimera les notes et
1485 autres événements pris en charge par @code{\cueDuring}. Pour les
1486 autres annotations telles que changement de clef ou instrument concerné,
1487 faites appel à des balises -- voir @ref{Utilisation de balises} à ce
1490 @lilypond[verbatim,quote]
1491 fluteNotes = \relative c'' {
1492 r2. c4 d8 c d e fis2 g2 d2
1495 bassoonNotes = \relative c {
1500 \new CueVoice { \set instrumentCueName = "flute" }
1502 \cueDuring #"flute" #UP { R1 }
1503 \tag #'part \clef bass
1507 \addQuote "flute" { \fluteNotes }
1518 \removeWithTag #'part { \killCues { \bassoonNotes } }
1523 Lorsque la citation comporte une étiquette indiquant l'instrument qui
1524 joue et un changement de clef, ces éléments peuvent se regrouper à
1525 l'aide de la commande @code{\addInstrumentDefinition}. Pour plus
1526 d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
1529 Manuel de notation :
1530 @ref{Citation d'autres voix},
1531 @ref{Instruments transpositeurs},
1532 @ref{Noms d'instrument},
1534 @ref{Citation-repère},
1535 @ref{Utilisation de balises}.
1538 @rlsrnamed{Staff notation, Notation sur la portée}.
1540 Référence des propriétés internes :
1541 @rinternals{CueVoice},
1545 La commande @code{\cueDuring} ne sait pas gérer les collisions de
1546 silence entre les contextes @code{Voice} et @code{CueVoice}.
1548 Dans le cadre d'un @code{\cueDuringWithClef} ou d'un
1549 @code{\transposedCueDuring}, l'argument supplémentaire doit intervenir
1550 après l'origine et la position.