1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: db449e3935bc8b765979e1d4a4ab3018908cbbd8
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..
13 @c Translators: Valentin Villenave, Jean-Charles Malahieude
14 @c Translation checkers: John Mandereau
15 @c Translation status: post-GDP
17 @node Concepts fondamentaux
18 @chapter Concepts fondamentaux
19 @translationof Fundamental concepts
21 Le tutoriel nous a montré comment obtenir une édition de toute beauté à
22 partir d'un simple fichier texte. Nous nous intéresserons dans cette
23 partie aux concepts et techniques qui permettent d'obtenir des
24 partitions complexes de même qualité.
27 * Organisation des fichiers LilyPond::
28 * Les voix contiennent la musique::
29 * Contextes et graveurs::
30 * Extension des modèles::
34 @node Organisation des fichiers LilyPond
35 @section Organisation des fichiers LilyPond
36 @translationof How LilyPond input files work
38 La mise en forme des fichiers d'entrée de LilyPond est vraiment peu
39 astreignante, afin d'offrir assez de souplesse aux utilisateurs
40 expérimentés pour qu'ils puissent organiser leurs fichiers comme ils
41 l'entendent. Cependant, les nouveaux utilisateurs peuvent parfois se
42 perdre en raison de cette souplesse. Cette section présente sommairement
43 l'organisation du code LilyPond, en privilégiant la simplicité au
44 détriment de certains détails. Vous trouverez une description plus
45 complète dans @ruser{Structure de fichier}.
48 * Introduction à la structure de fichier LilyPond::
49 * La partition est une (unique) expression musicale composée::
50 * Expressions musicales imbriquées::
51 * Non-imbrication des crochets et liaisons::
55 @node Introduction à la structure de fichier LilyPond
56 @subsection Introduction à la structure de fichier LilyPond
57 @translationof Introduction to the LilyPond file structure
59 @cindex format d'entrée
60 @cindex structure de ficher
62 Un fichier d'entrée LilyPond ressemble à :
65 \version @w{"@version{}"}
68 @var{ @dots{} expression musicale composite @dots{} } % c'est là qu'est la musique !
75 Il existe de nombreuses variantes à ce schéma simpliste, mais cet
76 exemple est un préambule à notre propos.
81 @cindex book, livre, ouvrage
83 @cindex score, partition
86 Jusqu'à présent, les exemples que nous avons pu voir ne faisaient pas
87 appel à la commande @code{\score@{@}}. En fait, LilyPond ajoute
88 automatiquement les commandes nécessaires au traitement d'un code
89 simpliste. LilyPond considère
115 En d'autres termes, si le code n'est constitué que d'une expression
116 musicale simple, LilyPond interprétera le fichier tout comme si cette
117 expression était incluse dans les commandes de notre premier exemple.
119 @cindex contextes implicites
120 @cindex implicites, contextes
122 @strong{Attention :} de nombreux exemples, dans la documentation de
123 LilyPond, ne font pas apparaître les commandes @code{\new Staff} ou
124 @code{\new Voice}, qui sont créées implicitement. Ce qui
125 n'est pas primordial pour des exemples simples le devient dès que la
126 situation se complexifie un tant soit peu. Le fait de ne pas déclarer
127 explicitement un contexte peut alors amener à des résultats quelque peu
128 surprenants, comme la création d'une portée supplémentaire et
129 indésirable. La manière de créer explicitement des contextes est
130 traitée plus en détails au chapitre @ref{Contextes et graveurs}.
132 @warning{Dès lors que votre musique dépasse quelques lignes, nous vous
133 engageons fortement à créer explicitement les voix et portées.}
135 Mais revenons à notre premier exemple, et penchons-nous tout d'abord sur
136 la commande @code{\score}.
138 Un bloc @code{\score} doit contenir une et une seule expression
139 musicale, exprimée immédiatement à la suite de la commande
140 @code{\score}. Rappelez-vous que cette expression peut être n'importe
141 quoi, d'une note isolée à un gigantesque
146 @var{ @dots{} collez ici la partition complète d'un opéra de Wagner@dots{} }
152 Dès lors que tout cela est entre accolades : @code{@{ @dots{} @}},
153 LilyPond le considère comme une et une seule expression musicale.
155 Comme nous l'avons vu précédemment, un bloc @code{\score} peut contenir
156 d'autres informations :
174 @cindex mise en forme
178 Gardez à l'esprit que ces trois commandes -- @code{\header},
179 @code{\layout} et @code{\midi} -- sont spécifiques : à l'inverse de
180 toutes les commandes débutant par une oblique inversée @code{\}
181 (@emph{backslash} en anglais), @strong{elles ne constituent pas} des
182 expressions musicales et ne peuvent pas faire partie d'expressions
183 musicales. Elles peuvent de ce fait être placées à l'intérieur du
184 bloc @code{\score}, ou bien à l'extérieur. En réalité, ces commandes
185 sont la plupart du temps indépendantes du bloc @code{\score} -- par
186 exemple, la commande @code{\header} intervient souvent avant le bloc
187 @code{\score}, comme le montre l'exemple ci-dessus.
189 Les deux autres commandes -- @code{\layout @{@}} et @code{\midi @{@}}
190 -- que nous n'avons pas détaillées pour l'instant, auront respectivement
191 pour effet, lorsqu'elles interviennent, de produire une sortie
192 imprimable et un fichier MIDI. Nous nous y intéressons plus
193 particulièrement dans le manuel de notation, aux chapitres
194 @ruser{Mise en forme de la partition} et
195 @ruser{Génération de fichiers MIDI}.
197 @cindex partitions multiples
198 @cindex book, bloc implicite
199 @cindex implicite, bloc book
203 Vous pouvez tout à fait mentionner plusieurs blocs @code{\score}. Ils
204 seront traités comme autant de partitions indépendantes qui seront
205 regroupées dans un seul fichier résultant. La commande @code{\book}
206 (@emph{recueil} ou @emph{ouvrage}) n'est pas obligatoire -- elle sera
207 créée implicitement. Néanmoins, le recours à la commande @code{\book}
208 vous permettra d'obtenir des fichiers résultants distincts à partir
209 d'un même fichier source @file{.ly} -- par exemple un fichier par
214 Dès que LilyPond rencontre un bloc @code{\book}, il crée un fichier
215 distinct (@file{.pdf} par exemple). Dans le cas où il n'est pas
216 mentionné explicitement, LilyPond regroupera l'intégralité du code dans
217 un bloc @code{\book}.
219 Tout bloc @code{\score} inclus dans un bloc @code{\book} constitue un
220 fragment de musique, par exemple un mouvement d'une symphonie.
222 @cindex layout, effets selon l'emplacement
224 Tout bloc @code{\layout} affecte le bloc @code{\score} ou @code{\book}
225 au sein duquel il intervient : si c'est à l'intérieur d'un bloc
226 @code{\score}, seul celui-ci en sera affecté. Dans le cas où le bloc
227 @code{\layout} se trouve à l'extérieur du bloc @code{\score}, que le
228 bloc @code{\book} soit explicite ou non, il affectera chacun des
229 @code{\score} compris dans ce @code{\book}.
231 Pour plus de détail à ce sujet, consultez
232 @ruser{Plusieurs partitions dans un même ouvrage}.
237 Un autre raccourci pratique est la possibilité de définir
238 des variables, également appelées @qq{identificateurs} -- voir
239 @ref{Organisation du code source avec des variables} à ce sujet. Dans
240 tous les modèles, vous trouverez :
243 melodie = \relative @{
252 Lorsque LilyPond examinera ce fichier, il va prendre la valeur de la
253 variable @code{melodie}, c'est-à-dire tout ce qui suit le signe
254 @code{=}, et l'insérer partout où il rencontrera @code{\melodie}. Vous
255 êtes libre de choisir comment dénommer vos variables@footnote{Les noms
256 de variables sont sensibles à la casse, et ne peuvent contenir ni
257 chiffre, ni ponctuation, ni caractère accentué, ni espace.} ; ce peut
258 être @code{melodie}, @code{global}, @code{maindroitepiano}, ou
259 @code{laTeteAToto}, tant qu'il ne s'agit pas de @qq{mot réservé}. Pour
260 plus de détails, voir
261 @ref{Économie de saisie grâce aux identificateurs et fonctions}.
264 Pour une description complète du format des fichiers d'entrée, voir
265 @ruser{Structure de fichier}.
268 @node La partition est une (unique) expression musicale composée
269 @subsection La partition est une (unique) expression musicale composée
270 @translationof Score is a (single) compound musical expression
275 @cindex bloc score, contenu
276 @cindex expression musicale composite
278 Dans la section précédente,
279 @ref{Introduction à la structure de fichier LilyPond}, nous
280 avons vu l'organisation générale des fichiers d'entrée de LilyPond.
281 Mais c'est comme si nous avions éludé la question essentielle :
282 comment diable peut-on savoir quoi mettre après @code{\score} ?
284 En fait, nous ne l'avons pas éludée du tout : le grand mystère est
285 tout simplement qu'@strong{il n'y a pas} de mystère. Allez,
286 expliquons-le en une ligne :
289 @emph{Un bloc @code{\score} doit contenir une et une seule expression
294 Peut-être serait-il judicieux de relire la section
295 @ref{Les expressions musicales en clair}, dans laquelle vous avez
296 appris à construire de grandes expressions musicales petit bout
297 par petit bout -- nous avons vu les notes, puis les accords, etc.
298 Maintenant, nous allons partir d'une grande expression musicale,
299 et remonter la pente. Pour rester simple, nous nous contenterons d'un
300 chanteur accompagné au piano. On n'a pas besoin d'une partition
301 d'orchestre -- c.-à-d. des portées regroupées en @code{StaffGroup} --
302 donc laissons cela de côté. Par contre, nous voulons bien une voix et
303 une double portée de piano.
309 \new Staff = "chanteur" <<
311 \new PianoStaff = "piano" <<
319 Nous avons ici attribué des noms aux portées -- @qq{chanteur} et
320 @qq{piano}. Bien que cela ne soit pas primordial, c'est une
321 habitude qu'il est bon d'adopter dès le départ : vous saurez au
322 premier coup d'œil à quoi correspond chaque portée.
324 Vous vous souvenez que nous avons recours à @code{<<} et @code{>>}
325 en lieu et place de @code{@{ @dots{} @}} pour gérer des musiques
326 simultanées. Et, pour le coup, on aimerait @emph{vraiment} que la
327 partie vocale et l'accompagnement soient imprimés ensemble@dots{} Bien
328 que faire appel à @code{<< @dots{} >>} ne soit pas réellement nécessaire
329 pour la portée du chanteur, dans la mesure où elle ne contient qu'une
330 seule expression musicale, nous vous recommandons de prendre l'habitude
331 de l'encadrer ainsi plutôt que par de simples accolades -- une portée
332 peut en effet contenir plusieurs voix, ou bien des notes @strong{et} des
333 paroles. Dans la mesure où nous y ajouterons des paroles, les chevrons
334 sont donc obligatoires. Si vous avez oublié comment ajouter des
335 paroles à l'aide de la commande @code{\addlyrics}, relisez le chapitre
336 @ref{Écriture de chants simples}.
338 @lilypond[verbatim,quote,ragged-right]
341 \new Staff = "singer" <<
342 \new Voice = "vocal" { c'1 }
345 \new PianoStaff = "piano" <<
346 \new Staff = "upper" { c'1 }
347 \new Staff = "lower" { c'1 }
354 On y voit nettement plus clair maintenant. Nous voici donc avec la
355 partie du chanteur, qui contient un ensemble @code{Voice}, ce qui dans
356 LilyPond correspond à une voix, au sens de voix d'une polyphonie plutôt
357 que de voix chantée -- ce pourrait être une partie de violon par
358 exemple --, et des paroles. Nous avons également une partie de piano,
359 qui contient deux portées : une pour la main droite, une autre pour la
360 main gauche. Il nous faudra d'ailleurs ajouter une clef de fa à cette
363 À ce point, on pourrait commencer à ajouter les notes. Dans les
364 accolades qui suivent @code{\new Voice = "chant"}, on pourrait
369 r4 d''8\noBeam g, c4 r
373 Mais si l'on procédait ainsi, la section @code{\score} deviendrait
374 vite assez touffue, et très rapidement on ne s'y retrouverait plus.
375 C'est pourquoi on utilisera plutôt des variables, ou identificateurs,
376 comme nous l'avons vu plus haut. Pour s'assurer que le contenu de la
377 variable @code{texte} soit bien interprété comme des paroles, nous le
378 préfixons d'un @code{\lyricmode}. Sans cette précaution, LilyPond
379 tenterait d'interpréter le contenu de cette variable comme des notes, ce
380 qui déclencherait immanquablement des erreurs. LilyPond dispose de
381 différents types de données -- voir @ruser{Modes de saisie} pour plus de
384 Avec quelques notes de plus et une clef de fa, nous pourrions avoir :
386 @lilypond[verbatim,quote,ragged-right]
387 melody = \relative { r4 d''8\noBeam g, c4 r }
388 text = \lyricmode { And God said, }
389 upper = \relative { <g' d g,>2~ <g d g,> }
390 lower = \relative { b,2 e2 }
394 \new Staff = "singer" <<
395 \new Voice = "vocal" { \melody }
398 \new PianoStaff = "piano" <<
399 \new Staff = "upper" { \upper }
400 \new Staff = "lower" {
410 Quand on écrit ou que l'on lit une section @code{\score}, mieux vaut
411 y aller lentement et soigneusement. Commencez par le niveau le plus
412 large, puis travaillez sur chaque niveau plus détaillé. À ce propos,
413 une indentation stricte et propre est vraiment d'une aide précieuse :
414 assurez-vous que chaque élément d'un même niveau a le même décalage
415 horizontal dans votre éditeur de texte !
419 @ruser{Structure d'une partition}.
422 @node Expressions musicales imbriquées
423 @subsection Expressions musicales imbriquées
424 @translationof Nesting music expressions
426 @cindex portées, temporaires
429 Déclarer toutes les portées dès le départ n'est pas une
430 obligation ; elles peuvent intervenir temporairement n'importe où
431 dans la partition. Ceci est tout à fait indiqué pour créer des sections
432 @rglos{ossia}. L'exemple suivant illustre la manière de créer
433 temporairement une nouvelle portée, l'espace de trois notes :
435 @lilypond[verbatim,quote,ragged-right]
452 Vous noterez la taille de la clef, identique à celle que l'on trouve
453 lors d'un changement en cours de ligne -- légèrement plus petite que
454 celle imprimée en tête de ligne.
456 @cindex portée, positionnement
458 Une section ossia se placera au dessus de la portée en procédant ainsi :
460 @lilypond[verbatim,quote,ragged-right]
461 \new Staff = "main" {
468 alignAboveContext = #"main" }
476 Cet exemple recourt à @code{\with}, que nous verrons en détail plus
477 avant. C'est un moyen de modifier le comportement par défaut d'une
478 portée individuelle. Nous indiquons ici que la nouvelle portée doit se
479 placer au-dessus de la portée @qq{principal} plutôt qu'en dessous, ce
480 qui est le comportement par défaut.
483 Les ossias apparaissent souvent sans clef ni métrique, et dans une
484 taille plus petite. Ceci requiert des commandes dont nous n'avons pas
485 encore parlé. Voir @ref{Taille des objets} et @ruser{Portées d'ossia}.
488 @node Non-imbrication des crochets et liaisons
489 @subsection Non-imbrication des crochets et liaisons
490 @translationof On the un-nestedness of brackets and ties
492 @cindex crochets, imbrication
493 @cindex crochets, types de
495 Nous avons déjà rencontré plusieurs types de crochets au fil de nos
496 fichiers LilyPond. Ils obéissent à des règles différentes qui peuvent
497 paraître déroutantes de prime abord. Avant d'examiner ces règles, voici
498 une liste des différents types de crochet :
500 @c attempt to force this onto a new page
502 @multitable @columnfractions .3 .7
503 @headitem Type de crochet
505 @item @code{@{ @dots{} @}}
506 @tab Délimite un segment de musique séquentielle
507 @item @code{< @dots{} >}
508 @tab Délimite les notes d'un accord
509 @item @code{<< @dots{} >>}
510 @tab Délimite des sections simultanées
511 @item @code{( @dots{} )}
512 @tab Marque le début et la fin d'une liaison
513 @item @code{\( @dots{} \)}
514 @tab Marque le début et la fin d'une liaison de phrasé
515 @item @code{[ @dots{} ]}
516 @tab Marque le début et la fin d'une ligature manuelle
519 D'autres constructions permettent d'obtenir des lignes regroupant ou en
520 travers des notes : les liaisons de prolongation indiquées par un tilde
521 (@code{~}), les marques de n-olet avec @code{\tuplet x/y @{ @dots{} @}},
522 ou encore les notes d'ornement avec @code{\grace@{ @dots{} @}}.
524 En dehors de LilyPond, l'imbrication correcte de différents types de
525 crochets exige un strict respect des conventions, telles que
526 @code{<< [ @{ ( @dots{} ) @} ] >>}, où les marques de fermeture
527 interviennent obligatoirement dans l'ordre exactement inverse à celles
528 d'ouverture. Ceci @strong{doit} être rigoureusement respecté pour les
529 trois types de crochets utilisés pour @strong{délimiter} comme l'indique
530 le tableau ci-dessus. Une telle rigueur dans l'imbrication n'est
531 @strong{pas} requise pour les types de crochets dont la fonction est de
532 @strong{marquer}, selon le tableau ci-dessus, lorsqu'il sont utilisés en
533 combinaison avec des liaisons de prolongation ou des n-olets. En effet,
534 il ne s'agit pas de crochets ayant pour fonction de borner quelque
535 chose ; ils agissent plutôt comme marquant le début de quelque chose et
538 Ainsi, et bien que ce ne soit pas très musical, une liaison de phrasé
539 peut débuter avant l'insertion d'une ligature manuelle et s'arrêter
540 avant la fin de la ligature :
542 @lilypond[quote,verbatim,ragged-right]
543 \relative { g'8\( a b[ c b\) a] g4 }
546 De manière générale, différents types de crochets, notamment s'ils
547 indiquent des n-olets, liaisons de prolongation ou notes d'ornement,
548 peuvent se mélanger entre eux. L'exemple suivant montre une ligature
549 qui se prolonge sur un triolet (ligne 1), puis une liaison qui se
550 prolonge sur un triolet (ligne 2) et enfin une ligature et une liaison
551 qui s'étendent sur un triolet, lui-même lié à un quintolet agrémenté
552 d'une liaison de phrasé se poursuivant (lignes 3 et 4).
554 @lilypond[quote,verbatim,ragged-right]
556 r16[ g' \tuplet 3/2 { r16 e'8] }
557 g,16( a \tuplet 3/2 { b16 d) e }
558 g,8[( a \tuplet 3/2 { b8 d) e~] } |
559 \tuplet 5/4 { e32\( a, b d e } a4.\)
564 @node Les voix contiennent la musique
565 @section Les voix contiennent la musique
566 @translationof Voices contain music
568 Les chanteurs utilisent leur voix pour chanter ; il en va de même
569 pour LilyPond. En fait, la musique de chacun des instruments d'une
570 partition est contenue dans des voix (@emph{Voices} en anglais), qui
571 se trouvent être le concept fondamental de LilyPond.
574 * J'entends des Voix::
575 * Instanciation explicite des voix::
580 @node J'entends des Voix
581 @subsection J'entends des Voix
582 @translationof I'm hearing Voices
585 @cindex calques (layers)
586 @cindex voix multiples
587 @cindex Voice, contexte
588 @cindex contexte de voix
589 @cindex musique simultanée
590 @cindex musique concurrente
591 @cindex voix ou accords
592 @cindex accords ou voix
594 Dans une partition gérée par LilyPond, le niveau le plus bas, ou bien
595 élémentaire ou fondamental, est le @qq{contexte de voix} -- @emph{Voice
596 context} en anglais. Pour d'autres logiciels, on fait tantôt référence
597 à la notion de @qq{couche} ou de @qq{calque}.
599 En réalité, le contexte de voix est le seul à pouvoir contenir de la
600 musique. S'il n'est pas déclaré explicitement, il sera créé
601 automatiquement comme nous l'avons vu au début de ce chapitre. Certains
602 instruments, le hautbois par exemple, ne peuvent jouer qu'une seule note
603 à la fois. Nous n'aurons besoin, pour ces instruments monodiques, que
604 d'une seule voix. Les instruments qui, comme le piano, peuvent émettre
605 plusieurs sons en même temps sont polyphoniques et nécessitent de
606 recourir à plusieurs voix pour gérer efficacement l'alignement des notes
607 et rythmes différents.
609 Si une voix unique peut tout à fait contenir plusieurs notes dans un
610 accord, à partir de quand aurons-nous vraiment besoin de plusieurs
611 voix ? Considérons déjà ces quatre accords :
613 @lilypond[quote,verbatim,ragged-right]
616 <d' g>4 <d fis> <d a'> <d g>
620 Nous exprimons ici chacun des accords par l'utilisation de
621 chevrons gauche et droite simples, @code{< @dots{} >}, puisque nous
622 n'avons besoin que d'une seule voix. Supposons maintenant que le fa
623 dièse soit une croche, suivie d'un sol croche -- une note de passage
624 vers le la ? Nous avons alors deux notes qui débutent au même moment,
625 mais dont la durée est différente : un ré noire et un fa dièse croche.
626 Comment coder cela ? Dans la mesure où toutes les notes d'un accord
627 doivent avoir la même durée, nous ne pouvons pas écrire un accord. Nous
628 ne pouvons pas non plus écrire deux notes séparées, puisqu'elles
629 débutent en même temps. Nous avons alors besoin de deux voix.
631 Voyons comment cela se pratique selon la grammaire de LilyPond.
636 Le plus sûr moyen de saisir un fragment où plusieurs voix cohabitent
637 sur la même portée, consiste à saisir chacune des voix séquentiellement
638 (avec @code{@{ @dots{} @}}), puis à les combiner en simultané à l'aide
639 de doubles chevrons gauche/droite, @code{<< @dots{} >>}. Les fragments
640 devront être séparés par une double oblique inversée, @code{\\}, pour
641 les affecter à des voix séparées. Dans le cas contraire, les notes
642 seraient toutes affectées à une même voix, ce qui pourrait générer des
643 erreurs. Cette manière de procéder est tout à fait indiquée dans le cas
644 d'une pièce homophonique ne comportant que quelques courts passages de
647 Voici comment éclater les accords en deux voix, avec la note de passage
650 @lilypond[quote,verbatim,ragged-right]
653 % Voice = "1" Voice = "2"
654 << { g'4 fis8( g) a4 g } \\ { d4 d d d } >>
658 Notez que les hampes de la seconde voix sont dirigées vers le bas.
662 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
664 % Voice = "1" Voice = "2"
665 << { r4 g g4. a8 } \\ { d,2 d4 g } >> |
666 << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
667 << { a2. r4 } \\ { fis2. s4 } >> |
670 Le recours à une construction @code{<< \\ >>} particulière à chaque
671 mesure n'est pas nécessaire. Bien qu'on y gagne en lisibilité si chaque
672 mesure ne contient que quelques notes, il est plus judicieux de
673 carrément séparer chaque voix :
675 @lilypond[quote,verbatim,ragged-right]
678 \relative { % Voice = "1"
683 \relative { % Voice = "2"
691 @cindex voix, nommage
692 @cindex voix et constructions simultanées
693 @cindex liaisons et constructions simultanées
695 Cet exemple ne comporte que deux voix, mais il peut être étendu pour
696 traiter trois voix ou plus en ajoutant autant de séparateurs @code{\\}
699 Les contextes @code{Voice} portent les noms @code{"1"}, @code{"2"}, etc.
700 Les premiers contextes définissent les voix @emph{extrêmes}, la plus
701 haute au contexte @code{"1"}, le plus basse au contexte @code{"2"}. Les
702 voix intermédiaires seront affectées aux contextes @code{"3"} et
703 @code{"4"}. Pour chacun de ces contextes, le positionnement et
704 l'orientation des liaisons, hampes, nuances, etc. est définie
707 @lilypond[quote,verbatim]
708 \new Staff \relative {
711 % Voice = "1" Voice = "2" Voice = "3"
712 << { g4 f e } \\ { r8 e4 d c8~ } >> |
713 << { d2 e } \\ { c8 b16 a b8 g~ 2 } \\ { s4 b c2 } >> |
718 Les voix peuvent se saisir dans un ordre différent, comme par exemple du
719 haut vers le bas, auquel cas leurs numéros respectifs seront spécifiés
720 dès avant la construction @code{<< @dots{} >>} à l'aide de la commande
721 @code{\voices} comme ici :
723 @lilypond[quote,verbatim]
724 \new Staff \relative {
727 % Voice = "1" Voice = "2"
728 << { g4 f e } \\ { r8 e4 d c8~ } >> |
730 % Voice = "1" Voice = "3" Voice = "2"
731 << { d2 e } \\ { s4 b c2 } \\ { c8 b16 a b8 g~ 2 } >> |
735 Ces voix sont séparées de la voix principale, laquelle contient les
736 notes en dehors de la construction @code{<< @dots{} >>} -- que nous
737 appellerons @emph{construction simultanée}. Les liaisons, de
738 prolongation ou non, ne peuvent relier des notes que si elles
739 appartiennent à la même voix ; elles ne peuvent ni pénétrer une
740 construction simultanée, ni en sortir. Inversement, les voix parallèles
741 issues de constructions simultanées apparaissant sur une même portée
742 appartiennent à la même voix. Les autres propriétés liées au contexte
743 de voix s'appliquent tout au long des constructions simultanées.
744 Reprenons notre exemple, en affectant une couleur et une allure
745 différentes aux notes de chacune des voix. Vous noterez qu'un
746 changement apporté à une voix ne se propage pas aux autres, et qu'il se
747 reporte jusqu'au bout, et que la voix aux triangles bleus comporte une
748 liaison de prolongation entre deux constructions.
750 @lilypond[quote,verbatim]
751 \new Staff \relative {
780 @funindex \voiceOneStyle
781 @funindex \voiceTwoStyle
782 @funindex \voiceThreeStyle
783 @funindex \voiceFourStyle
784 @funindex \voiceNeutralStyle
786 Les commandes @code{\voiceXXXStyle} sont principalement dédiées à une
787 utilisation pédagogique, comme l'est ce document. Elles modifient la
788 couleur des hampes et ligatures et le style de tête des note, pour
789 permettre une meilleure distinction entre les différentes voix. La
790 première voix comporte des têtes en losange rouge, la deuxième en
791 triangle bleu, la troisième en cercle barré vert, la quatrième (non
792 utilisée ici) en croix magenta ; @code{\voiceNeutralStyle} (non utilisé
793 ici) revient au style par défaut. Nous verrons plus tard comment créer
794 de telles commandes. Voir @ref{Visibilité et couleur des objets} et
795 @ref{Utilisation de variables dans les retouches}.
797 @cindex polyphonie et mode relatif
798 @cindex mode relatif et polyphonie
800 La polyphonie ne modifie en rien la relation entre les notes au sein
801 d'un bloc @code{\relative}. Chaque note est calculée par rapport à
802 celle qui la précède, ou bien par rapport à la première note de l'accord
803 qui précède. Ainsi, dans
806 \relative c' @{ noteA << < noteB noteC > \\ noteD >> noteE @}
810 @code{noteB} est relative à @code{noteA} @*
811 @code{noteC} est relative à @code{noteB}, pas à @code{noteA} @*
812 @code{noteD} est relative à @code{noteB}, pas à @code{noteA} ni
814 @code{noteE} est relative à @code{noteD}, pas à @code{noteA}
816 Une méthode alternative, et qui peut simplifier les choses si les notes
817 des différentes voix sont espacées, consiste à placer une commande
818 @code{\relative} au début de chacune des voix :
821 \relative @{ noteA @dots{} @}
823 \relative @{ < noteB noteC > @dots{} @}
825 \relative @{ noteD @dots{} @}
827 \relative @{ noteE @dots{} @}
830 Pour finir, analysons le principe d'utilisation des voix dans une pièce
831 complexe. Nous allons nous concentrer sur les deux premières mesures du
832 second des Deux nocturnes, opus 32 de Chopin. Cet exemple nous servira
833 à plusieurs reprises, y compris dans le chapitre suivant, pour illustrer
834 certaines techniques de notation. Aussi, ne prêtez pas trop d'attention
835 à ce qui pour l'instant pourrait vous paraître vraiment mystérieux dans
836 le code, et intéressons-nous uniquement à ce qui concerne la musique et
837 les voix -- ce qui est plus compliqué sera décortiqué plus tard.
839 @c The following should appear as music without code
840 @lilypond[quote,ragged-right]
841 \new Staff \relative {
843 \voices 1,2,4 % No voice three
848 % Ignore these for now - they are explained in Ch 4
849 \once \override NoteColumn.ignore-collision = ##t
851 \once \override NoteColumn.force-hshift = #0.5
856 \override NoteColumn.force-hshift = #0
864 La direction des hampes sert souvent à indiquer dans la continuité deux
865 lignes mélodiques simultanées. Ici, les hampes des notes les plus
866 hautes vont vers le haut, et celles des notes plus basses vers le
867 bas. C'est une première indication de ce que nous avons eu recours à
870 Mais le réel besoin de multiples voix se fait sentir dès lors que
871 plusieurs notes qui débutent en même temps ont des durées différentes.
872 C'est évident au troisième temps de la première mesure : le la bémol est
873 une noire pointée, le fa une noire, et le ré bémol une blanche. On ne
874 peut les grouper dans un accord, puisque toutes les notes composant un
875 accord doivent être de même durée. On ne peut non plus les écrire
876 séquentiellement, puisqu'elles débutent toutes au même instant. Ce
877 fragment de mesure nécessite trois voix, et une bonne pratique voudrait
878 que l'intégralité de la mesure soit sur trois voix, comme ci-dessous où
879 nous avons une allure et une couleur différentes aux notes de chacune
880 d'entre elles. Une fois de plus, nous reviendrons plus tard sur le code
881 que vous ne comprendriez pas.
883 @c The following should appear as music without code
884 @c The three voice styles should be defined in -init
885 @lilypond[quote,ragged-right]
886 \new Staff \relative {
888 \voices 1,2,4 % No Voice three (we want stems down)
896 % Ignore these for now - they are explained in Ch 4
897 \once \override NoteColumn.ignore-collision = ##t
899 \once \override NoteColumn.force-hshift = #0.5
904 \override NoteColumn.force-hshift = #0
912 Essayons à présent de coder cette musique en partant de zéro. Comme
913 nous le verrons, certaines difficultés vont se présenter. Partons de ce
914 que nous avons appris : utilisons la construction @code{<< \\ >>} pour
915 saisir la première mesure dans trois voix :
917 @lilypond[quote,verbatim,ragged-right]
918 \new Staff \relative {
921 { c''2 aes4. bes8 } \\ { <ees, c>2 des } \\ { aes'2 f4 fes }
928 @cindex hampes en bas
930 @cindex hampes en haut
931 @cindex voix et direction des hampes
932 @cindex direction des hampes et voix
934 La direction des hampes est attribuée automatiquement : les voix
935 impaires portent des hampes vers le haut, les voix paires des hampes
936 vers le bas. Les hampes des voix 1 et 2 sont orientées comme il faut
937 mais celles de la voix 3 devraient, dans le cas qui nous occupe, aller
938 vers le bas. Nous pouvons corriger cela en sautant la voix 3 et en
939 plaçant la musique dans la voix 4. Ceci pourrait s'obtenir à l'aide
940 d'un @code{\\} supplémentaire, mais nous utiliserons plutôt la commande
941 @code{\voices} qui, par ailleurs, nous permettrait de saisir les voix
942 dans un autre ordre selon notre convenance :
944 @lilypond[quote,verbatim,ragged-right]
945 \new Staff \relative {
947 \voices 1,2,4 % Omit Voice three
960 Cette manipulation nous permet de régler la direction des hampes, mais
961 le positionnement horizontal des notes n'est pas satisfaisant. LilyPond
962 décale les notes des voix intermédiaires lorsque leur tête ou leur hampe
963 viendrait à chevaucher celles des voix extrêmes. Bien entendu, ce n'est
964 pas souhaitable dans le cas d'une partition pour piano. Dans d'autres
965 situations, les décalages que LilyPond applique peuvent ne pas éviter
966 certaines collisions. LilyPond met à notre disposition plusieurs moyens
967 d'ajuster le positionnement horizontal des notes. Nous ne sommes pas
968 encore tout à fait prêts pour voir comment corriger cela, aussi nous
969 examinerons ce problème dans un autre chapitre (voir la propriété
970 @code{force-hshift} dans @ref{Correction des collisions d'objets}).
972 @warning{Paroles et objets étendus (liaisons, soufflets, etc.) ne peuvent
973 passer d'une voix à l'autre.}
977 @ruser{Plusieurs voix}.
980 @node Instanciation explicite des voix
981 @subsection Instanciation explicite des voix
982 @translationof Explicitly instantiating voices
986 @funindex \voiceThree
990 @cindex Voice, création de contextes
992 Les contextes @rinternals{Voice} peuvent être déclarés manuellement
993 dans un bloc @code{<< >>} pour créer de la musique polyphonique, en
994 utilisant @code{\voiceOne}@dots{} jusqu'à @code{\voiceFour} pour
995 assigner des directions de hampes et un déplacement horizontal pour
996 chaque partie. Cette méthode apporte de la clarté pour des partitions
997 plus importantes puisqu'elle permet de bien séparer les voix et de leur
998 affecter un nom plus parlant.
1000 En particulier, la construction @code{<< \\ >>} que nous avons vue
1006 << @{ e'4 f g a @} \\ @{ c,4 d e f @} >>
1016 \new Voice = "1" @{ \voiceOne \relative @{ e'4 f g a @} @}
1017 \new Voice = "2" @{ \voiceTwo \relative @{ c'4 d e f @} @}
1021 Toutes deux produiront
1023 @c The following example should not display the code
1024 @lilypond[ragged-right,quote]
1026 \new Voice = "1" { \voiceOne \relative { e'4 f g a } }
1027 \new Voice = "2" { \voiceTwo \relative { c'4 d e f } }
1031 @cindex Voice, retour à un seul contexte
1032 @cindex retour à un contexte Voice unique
1034 Les commandes @code{\voiceXXX} fixent la direction des hampes, des
1035 liaisons de prolongation et de phrasé, des articulations, des
1036 annotations, des points d'augmentation des notes pointées et des
1037 doigtés. @code{\voiceOne} et @code{\voiceThree} font pointer ces objets
1038 vers le haut, alors que @code{\voiceTwo} et @code{\voiceFour} les font
1039 pointer vers le bas. Ces commandes génèrent par ailleurs un décalage
1040 horizontal de chacune des voix pour éviter tout risque de chevauchement
1041 entre plusieurs notes. La commande @code{\oneVoice} les ramène aux
1044 Voyons, à l'aide de ces exemples simples, les effets respectifs de
1045 @code{\oneVoice}, @code{\voiceOne} et @code{\voiceTwo} sur les
1046 annotations, liaisons de prolongation ou de phrasé, et sur les nuances.
1048 @lilypond[quote,ragged-right,verbatim]
1050 % Default behavior or behavior after \oneVoice
1051 c'4 d8~ 8 e4( f | g4 a) b-> c |
1055 @lilypond[quote,ragged-right,verbatim]
1058 c'4 d8~ 8 e4( f | g4 a) b-> c |
1060 c,4 d8~ 8 e4( f | g4 a) b-> c |
1064 @lilypond[quote,ragged-right,verbatim]
1067 c'4 d8~ 8 e4( f | g4 a) b-> c |
1069 c,4 d8~ 8 e4( f | g4 a) b-> c |
1073 Voyons à présent quatre différentes façons d'exprimer un passage
1074 polyphonique, à partir d'un exemple de la section précédente. Chacune
1075 d'elles aura ses avantages selon les circonstances.
1077 Une expression séquentielle qui apparaît en premier dans un @code{<< >>}
1078 -- attention, @strong{pas} dans une construction @code{<< \\ >>} --
1079 appartient à la voix principale. Ceci est utile lorsque des voix
1080 supplémentaires apparaissent pendant que la voix principale est jouée.
1081 Voici une meilleure réalisation de notre exemple. Les notes colorées et
1082 en croix mettent en évidence le fait que la mélodie principale est
1083 maintenant dans un seul contexte de voix, ce qui permet d'ajouter une
1084 liaison de phrasé à l'ensemble.
1086 @lilypond[quote,ragged-right,verbatim]
1087 \new Staff \relative {
1089 % The following notes are homophonic
1091 % Start simultaneous section of three voices
1093 % Continue the main voice in parallel
1094 { g4 f e | d2 e) | }
1095 % Initiate second voice
1097 % Set stems, etc., down
1099 r8 e4 d c8~ | 8 b16 a b8 g~ 2 |
1101 % Initiate third voice
1103 % Set stems, etc, up
1111 @cindex voix, continuation
1114 La commande @code{\voices} peut aussi servir à maintenir une voix
1115 principale dans une construction simultanée :
1117 @lilypond[quote,ragged-right,verbatim]
1118 \new Staff \relative {
1119 \new Voice = "main" {
1121 % This section is homophonic
1123 % Start simultaneous section of three voices
1126 % Continue the main voice in parallel
1127 { g4 f e | d2 e) | }
1128 % Initiate second voice
1130 % Set stems, etc., down
1131 { r8 e4 d c8~ | 8 b16 a b8 g~ 2 | }
1133 % Initiate third voice
1134 % Set stems, etc, up
1141 @cindex imbrication d'expressions musicales
1142 @cindex imbrication de constructions simultanées
1143 @cindex voix temporaires
1144 @cindex voix, imbrication
1146 Dans certaines circonstances de polyphonie complexe, vous pourrez être
1147 amené à recourir à une voix temporaire, ce qui peut être une manière
1148 plus naturelle de saisir la musique :
1150 @lilypond[quote,ragged-right,verbatim]
1151 \new Staff \relative {
1154 { g4 f e | d2 e) | }
1159 { c8 b16 a b8 g~ 2 | }
1170 @cindex espacement des notes
1172 Cette manière de brièvement imbriquer des voix est bien utile pour de
1173 courts fragments de musique polyphonique. Mais lorsqu'une portée est
1174 très souvent polyphonique, on peut y gagner en clarté si l'on utilise
1175 plusieurs voix sur l'ensemble de cette portée et que l'on positionne des
1176 silences invisibles pour sauter les moments où il n'y a rien dans cette
1179 @lilypond[quote,ragged-right,verbatim]
1180 \new Staff \relative <<
1181 % Initiate first voice
1184 c'16^( d e f g4 f e | d2 e2) |
1186 % Initiate second voice
1188 % Set stems, etc, down
1190 s4 r8 e4 d c8 ~ | 8 b16 a b8 g ~ 2 |
1192 % Initiate third voice
1194 % Set stems, etc, up
1202 @subsubheading Empilement des notes
1203 @translationof Note columns
1206 @cindex empilement de notes
1207 @cindex collisions de notes
1208 @cindex shift, commandes
1209 @cindex décalage, commandes
1214 @funindex \shiftOnnn
1216 Les notes rapprochées d'un accord, ou des notes de différentes voix qui
1217 tombent ensemble, seront rangées sur deux colonnes, voire plus, pour
1218 palier d'éventuels chevauchements des têtes. On appelle cela des
1219 empilements de notes. Chaque voix dispose de plusieurs empilements, et
1220 l'attribution d'un décalage à une voix en particulier s'appliquera à
1221 l'empilement en question s'il y avait risque de collision.
1222 Nous en avons une illustration à la deuxième mesure de l'exemple
1223 ci-dessus : le do de la deuxième voix est décalé à droite du ré de
1224 la première voix et, dans l'accord final, le do de la troisième voix est
1225 lui aussi décalé à droite des autres notes.
1227 Les commandes @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn} et
1228 @code{\shiftOff} spécifient le degré nécessaire de décalage qui sera
1229 appliqué aux notes ou accords de la voix en question afin d'éviter une
1230 collision. Par défaut, les voix extérieures -- normalement les
1231 première et deuxième -- se verront attribuer @code{\shiftOff}, alors
1232 que les voix intérieures -- trois et quatre -- se verront attribuer
1233 @code{\shiftOn}. Lorsqu'un décalage s'applique, les voix un et trois
1234 iront vers la droite, et les voix deux et quatre vers la gauche.
1236 @code{\shiftOnn} et @code{\shiftOnnn} définissent des degrés augmentés
1237 de décalage auquel on peut devoir temporairement recourir dans des
1238 situations complexes -- voir @ref{Exemple concret}.
1240 Un empilement peut ne contenir qu'une note ou un accord dans une voix
1241 aux hampes vers le haut, et une note ou un accord dans une voix
1242 aux hampes vers le bas. Dans le cas où des notes, issues de deux voix
1243 ayant toutes deux des hampes dans la même direction, se retrouvent au
1244 même moment et qu'aucun décalage n'a été spécifié ou qu'ils sont
1245 identiques, LilyPond vous le signalera par le message « Cette voix
1246 requiert un @code{@bs{}voiceXx} ou un réglage @code{@bs{}shiftXx} ».
1249 Manuel d'initiation :
1250 @ref{Déplacement d'objets}
1252 Manuel de notation :
1253 @ruser{Plusieurs voix}.
1256 @node Voix et paroles
1257 @subsection Voix et paroles
1258 @translationof Voices and vocals
1260 La musique vocale est une gageure en soi : il nous faut combiner
1261 deux expressions différentes -- des notes et des paroles.
1263 @funindex \new Lyrics
1267 @cindex Lyrics, création d'un contexte
1268 @cindex paroles, affectation à une voix
1270 Nous avons déjà abordé la commande @code{\addlyrics@{@}}, qui permet de
1271 gérer des partitions simples. Cette technique est cependant
1272 relativement limitée. Pour de la musique un peu plus compliquée, il
1273 vous faudra contenir les paroles dans un contexte @code{Lyrics}, créé
1274 par la commande @code{\new Lyrics} ; vous relierez ensuite ces paroles
1275 aux notes grâce à la commande @code{\lyricsto@{@}} et au nom assigné à
1276 la voix en question.
1278 @lilypond[quote,verbatim]
1280 \new Voice = "one" {
1284 c''4 b8. a16 | g4. f8 | e4 d | c2 |
1287 \new Lyrics \lyricsto "one" {
1288 No more let | sins and | sor -- rows | grow. |
1293 Notez bien que les paroles sont liées à un contexte de voix
1294 (@code{Voice}), @strong{non} à un contexte de portée (@code{Staff}). Il
1295 est donc nécessaire de créer explicitement les contextes @code{Staff}
1298 @cindex paroles et ligatures
1299 @cindex ligatures et paroles
1301 @funindex \autoBeamOff
1303 Si la ligature automatique que LilyPond applique par défaut est
1304 pleinement adaptée en matière de musique instrumentale, il n'en va pas
1305 de même dans le cas d'une musique associée à des paroles, et pour
1306 laquelle soit les ligatures sont carrément absentes, soit elles servent
1307 à indiquer un mélisme -- plusieurs notes pour une même syllabe.
1308 Dans l'exemple qui suit, nous utilisons la commande @code{\autoBeamOff}
1309 afin de désactiver les ligatures automatiques.
1311 @funindex \new ChoirStaff
1312 @funindex ChoirStaff
1313 @funindex \lyricmode
1315 @cindex structure d'une partition vocale
1316 @cindex chœur, partie de
1318 Nous allons reprendre un extrait de Judas Maccabæus pour illustrer ce
1319 que cette technique apporte en flexibilité. Nous commençons par
1320 utiliser des variables -- ou identificateurs -- afin de séparer de la
1321 structure de la portée aussi bien la musique que les paroles. Nous
1322 ajoutons par la même occasion un crochet spécifique aux portées pour
1323 chœur (@code{ChoirStaff}). Quant aux blocs de paroles, nous les faisons
1324 précéder de la commande @code{\lyricmode} pour nous assurer qu'elles
1325 seront interprétées comme telles, et non comme de la musique.
1327 @lilypond[quote,verbatim]
1328 global = { \key f \major \time 6/8 \partial 8 }
1330 SopOneMusic = \relative {
1331 c''8 | c8([ bes)] a a([ g)] f | f'4. b, | c4.~ 4
1333 SopOneLyrics = \lyricmode {
1334 Let | flee -- cy flocks the | hills a -- dorn, __
1336 SopTwoMusic = \relative {
1337 r8 | r4. r4 c'8 | a'8([ g)] f f([ e)] d | e8([ d)] c bes'
1339 SopTwoLyrics = \lyricmode {
1340 Let | flee -- cy flocks the | hills a -- dorn,
1346 \new Voice = "SopOne" {
1350 \new Lyrics \lyricsto "SopOne" {
1355 \new Voice = "SopTwo" {
1359 \new Lyrics \lyricsto "SopTwo" {
1367 Voici donc la structure de base valable pour toute partition vocale. On
1368 peut y ajouter d'autres portées si besoin est, d'autres voix à chaque
1369 portée, plusieurs couplets aux paroles, et les variables contenant la
1370 musique peuvent même être stockées dans des fichiers indépendants dès
1371 lors que leur longueur devient conséquente.
1373 @cindex structure d'hymne
1374 @cindex SATB, structure
1375 @cindex partition vocale avec plusieurs couplets
1376 @cindex couplets multiples et musique vocale
1378 Voici maintenant la première ligne d'une hymne pour chœur à quatre voix
1379 mixtes, comportant quatre couplets. Les paroles sont ici identiques
1380 pour les quatre voix. Vous remarquerez le recours aux variables afin de
1381 séparer de la structure de portée aussi bien les notes que les paroles.
1382 Vous noterez aussi une variable particulière, que nous avons appelée
1383 @qq{ArmureMetrique}, et qui contient plusieurs commandes que nous
1384 utiliserons dans les deux portées. Dans de nombreux autres exemples,
1385 elle s'appelle @qq{global}.
1387 @lilypond[quote,verbatim]
1388 keyTime = { \key c \major \time 4/4 \partial 4 }
1390 SopMusic = \relative { c'4 | e4. e8 g4 g | a4 a g }
1391 AltoMusic = \relative { c'4 | c4. c8 e4 e | f4 f e }
1392 TenorMusic = \relative { e4 | g4. g8 c4. b8 | a8 b c d e4 }
1393 BassMusic = \relative { c4 | c4. c8 c4 c | f8 g a b c4 }
1396 \lyricmode { E -- | ter -- nal fa -- ther, | strong to save, }
1398 \lyricmode { O | Christ, whose voice the | wa -- ters heard, }
1400 \lyricmode { O | Ho -- ly Spi -- rit, | who didst brood }
1402 \lyricmode { O | Tri -- ni -- ty of | love and pow'r }
1408 \new Voice = "Sop" { \voiceOne \keyTime \SopMusic }
1409 \new Voice = "Alto" { \voiceTwo \AltoMusic }
1410 \new Lyrics \lyricsto "Sop" { \VerseOne }
1411 \new Lyrics \lyricsto "Sop" { \VerseTwo }
1412 \new Lyrics \lyricsto "Sop" { \VerseThree }
1413 \new Lyrics \lyricsto "Sop" { \VerseFour }
1417 \new Voice = "Tenor" { \voiceOne \keyTime \TenorMusic }
1418 \new Voice = "Bass" { \voiceTwo \BassMusic }
1425 Manuel de notation :
1426 @ruser{Musique vocale}.
1429 @node Contextes et graveurs
1430 @section Contextes et graveurs
1431 @translationof Contexts and engravers
1433 Nous avons évoqué rapidement les contextes et graveurs dans les
1434 chapitres précédents ; examinons en détail ces concepts essentiels
1435 à la maîtrise de LilyPond.
1438 * Tout savoir sur les contextes::
1439 * Création d'un contexte::
1440 * Tout savoir sur les graveurs::
1441 * Modification des propriétés d'un contexte::
1442 * Ajout et suppression de graveurs::
1446 @node Tout savoir sur les contextes
1447 @subsection Tout savoir sur les contextes
1448 @translationof Contexts explained
1450 @cindex contextes, les différents
1452 Imprimer de la musique impose d'ajouter un certain nombre d'éléments de
1453 notation. Par exemple, voici un fragment de partition, précédé du code
1456 @lilypond[quote,verbatim]
1457 \relative { cis''4 cis2. | a4 a2. | }
1460 Si le code est assez austère, dans la partition ont été ajoutés un
1461 chiffre de mesure, des barres de mesure, des altérations et une clé.
1462 Pour une bonne raison : LilyPond @emph{interprète} le code. Il le
1463 compulse dans l'ordre chronologique, de même qu'on lit une partition de
1464 gauche à droite ; et pendant ce traitement, le logiciel garde en
1465 mémoire les limites des mesures, ou encore quelles hauteurs de note
1466 demandent des altérations accidentelles. Ces informations se présentent
1467 à plusieurs niveaux : ainsi, une altération n'a d'effet que sur une
1468 seule portée, tandis qu'une barre de mesure doit être synchronisée sur
1469 toute l'étendue verticale de la partition.
1471 LilyPond regroupe ces règles et ces fragments d'information dans des
1472 @emph{Contextes}. Certains contextes sont les voix (contexte
1473 @code{Voice}), les portées (contexte @code{Staff}), ou la partition dans
1474 son ensemble (contexte @code{Score}). Ils sont ordonnés
1475 hiérarchiquement : ainsi un contexte @code{Staff} peut contenir
1476 plusieurs contextes @code{Voice}, et un contexte @code{Score} peut
1477 contenir plusieurs contextes @code{Staff}.
1480 @sourceimage{context-example,5cm,,}
1483 Chaque contexte est chargé de faire appliquer certaines règles de
1484 gravure, de créer certains objets, et de prendre en compte les
1485 propriétés qui leur sont associées. Ainsi, le contexte @code{Voice}
1486 peut faire intervenir une altération accidentelle, puis le contexte
1487 @code{Staff} devra déterminer s'il faudra imprimer ou non cette dernière
1488 dans la suite de la mesure.
1490 Les barres de mesure, quant à elles, sont alignées verticalement grâce
1491 au contexte @code{Score} par défaut. En revanche, dans une musique
1492 polymétrique, par exemple mêlant une portée à 3/4 et une autre à 4/4,
1493 les barres de mesures n'ont plus à être alignées : il faut alors
1494 modifier les comportement par défaut des contextes @code{Score} et
1497 Dans une partition très simple, les contextes sont créés implicitement
1498 et peuvent être ignorés. Mais lorsqu'il s'agit de morceaux plus amples
1499 -- entendons par là tout ce qui s'écrit sur plus d'une portée -- il faut
1500 les créer explicitement pour être sûr d'obtenir toutes les portées
1501 nécessaires, et dans le bon ordre. Enfin, pour des morceaux impliquant
1502 une notation spéciale, modifier les contextes ou en créer de nouveaux
1503 devient extrêmement utile.
1505 En plus des contextes @code{Score}, @code{Staff} et @code{Voice} sont
1506 disponibles d'autres contextes intermédiaires entre les niveaux
1507 partition et portée, chargés de gérer certains regroupement, tels que
1508 @code{PianoStaff} ou @code{ChoirStaff}. Vous disposez aussi d'autres
1509 contextes de portée ou de voix alternatifs, ainsi que des contextes
1510 spécifiques pour les paroles, les percussions, les diagrammes pour
1511 instruments frettés, la basse chiffrée, etc.
1513 Le nom de chacun des contextes est formé d'un ou plusieurs mots aux
1514 initiales en capitale et directement accolés les uns aux autres sans
1515 ponctuation, comme par exemple @code{GregorianTranscriptionStaff}.
1518 Manuel de notation :
1519 @ruser{Tout savoir sur les contextes}.
1522 @node Création d'un contexte
1523 @subsection Création d'un contexte
1524 @translationof Creating contexts
1528 @cindex nouveaux contextes
1529 @cindex contextes, création de
1531 Il en va des contextes comme de toute hiérarchie : il faut un sommet --
1532 le contexte @code{Score} en l'occurrence. La commande @code{\score} est
1533 chargée de le créer, mais pour des partitions simples, il le sera
1534 automatiquement. Le bloc @code{\score} contient donc une expression
1535 musicale unique ainsi que, éventuellement, la définition des supports à
1536 produire -- @code{\layout} pour du visuel, @code{\midi} pour de
1537 l'acoustique, ou bien les deux.
1539 Lorsqu'une partition ne comporte qu'une voix et une seule portée, vous
1540 pouvez laisser LilyPond créer automatiquement les contextes @code{Voice}
1541 et @code{Staff} ; mais leur présence explicite devient indispensable dès
1542 que la situation se complique. Le moyen le plus simple est d'utiliser
1543 la commande @code{\new}. Elle doit intervenir avant une expression
1547 \new @var{type} @var{expression-musicale}
1551 où @var{type} correspond au nom du contexte (tels @code{Staff} ou
1552 @code{Voice}). Cette commande crée un nouveau contexte, puis
1553 interprète l'@var{expression-musicale} contenue dans ledit
1556 @warning{La commande @bs{}@code{new Score} ne devrait jamais servir en
1557 début de partition, puisque le contexte premier que constitue
1558 @code{Score} est créé automatiquement par l'interprétation de
1559 l'@var{expression-musicale} contenue dans le bloc @code{\score}. Les
1560 adaptations affectant les propriétés des différents contextes et qui
1561 s'appliqueront à l'ensemble de la partition trouvent leur place au sein
1562 d'un bloc @bs{}@code{layout}, en suivant les préceptes énoncés au
1563 chapitre @ref{Modification des propriétés d'un contexte}.}
1565 Nous avons déjà vu au cours des chapitres précédents de nombreux
1566 exemples où des contextes @code{Staff} ou @code{Voice} étaient créés au
1567 besoin. Dans un but didactique, voici maintenant une application
1568 complète et abondamment commentée :
1570 @lilypond[quote,verbatim,ragged-right]
1571 \score { % start of single compound music expression
1572 << % start of simultaneous staves section
1574 \new Staff { % create RH staff
1577 \new Voice { % create voice for RH notes
1578 \relative { % start of RH notes
1584 \new Staff << % create LH staff; needs two simultaneous voices
1587 \new Voice { % create LH voice one
1589 \relative { % start of LH voice one notes
1590 g8 <bes d> ees, <g c> |
1591 g8 <bes d> ees, <g c> |
1592 } % end of LH voice one notes
1593 } % end of LH voice one
1594 \new Voice { % create LH voice two
1596 \relative { % start of LH voice two notes
1599 } % end of LH voice two notes
1600 } % end of LH voice two
1601 >> % end of LH staff
1602 >> % end of simultaneous staves section
1603 } % end of single compound music expression
1606 Notez que toute déclaration qui ouvre un bloc par une accolade,
1607 @code{@{}, ou un double chevron gauche, @code{<<}, est indentée de deux
1608 espaces supplémentaires, et de deux autres pour sa marque de fermeture.
1609 Bien que ceci ne soit pas obligatoire, nous vous invitons à adopter
1610 cette pratique qui vous évitera nombre d'erreurs @qq{accolades non
1611 appariées}. La structure de la musique apparaît ainsi au premier coup
1612 d'œil, et les défauts de parité sont plus facilement repérables. Vous
1613 remarquerez que la portée MG est créée à l'aide d'un double chevron
1614 gauche -- nécessaire pour gérer ses deux voix -- alors que la portée MD
1615 ne contient qu'une seule expression musicale -- il n'y a qu'une voix --
1616 bornée par des accolades simples.
1618 @cindex contexte, nommage
1619 @cindex nommage des contextes
1621 La commande @code{\new} peut aussi permettre de nommer le contexte créé,
1622 et ainsi le distinguer des autres contextes déjà existants :
1625 \new @var{type} = @var{"UnNom"} @var{expression-musicale}
1628 Vous noterez la distinction entre le nom du type de contexte,
1629 @code{Staff}, @code{Voice}, etc. et le nom -- une simple suite de
1630 lettres au bon gré de l'utilisateur -- permettant d'identifier une
1631 instance particulière du type en question. Vous pouvez utiliser des
1632 chiffres et espaces, à la stricte condition d'englober le tout dans des
1633 guillemets ; l'identificateur suivant est tout à fait valide :
1634 @code{\new Staff = "MaPortee 1" @var{expression-musicale}}.
1635 Comme nous l'avons déjà vu dans le chapitre consacré aux paroles
1636 (@ref{Voix et paroles}), cet identifiant permettra ensuite de se
1637 référer à ce contexte particulier.
1640 Manuel de notation :
1641 @ruser{Création et référencement d'un contexte}.
1644 @node Tout savoir sur les graveurs
1645 @subsection Tout savoir sur les graveurs
1646 @translationof Engravers explained
1651 Tout point qui compose une partition générée par LilyPond est
1652 produit par un graveur (@emph{engraver} en anglais). Ainsi, il y en a
1653 un qui imprime les portées, un autre les têtes de note, un autre les
1654 hampes, un autre encore pour les ligatures, etc. LilyPond dispose de
1655 plus de 120 graveurs ! La plupart des partitions ne requièrent de
1656 s'intéresser qu'à quelques-uns seulement, et pour des partitions
1657 simples, vous n'aurez même pas à vous en préoccuper.
1659 Les graveurs résident et opèrent au sein des contextes.
1660 Les graveurs tels que le @code{Metronome_mark_engraver}, dont les effets
1661 s'appliquent à la partition dans son intégralité, opèrent au sein du
1662 contexte de plus haut niveau -- le contexte @code{Score}.
1664 Les graveurs @code{Clef_engraver} et @code{Key_engraver} seront logés
1665 dans chacun des contextes @code{Staff} ; deux portées peuvent
1666 requérir des clefs et des armures différentes.
1668 Les graveurs @code{Note_heads_engraver} et @code{Stem_engraver} résident
1669 dans chacun des contextes @code{Voice}, contexte du plus bas niveau.
1671 Chaque graveur confectionne les objets spécifiquement associés à sa
1672 fonction et traite les propriétés attachées à cette fonction. Ces
1673 propriétés, tout comme celles relatives aux contextes, peuvent être
1674 modifiées afin d'influencer le comportement du graveur et par voie de
1675 conséquence le rendu des éléments dont il a la charge.
1677 Les graveurs ont tous un nom composé, formé des différents mots
1678 décrivant leur fonction. Seule l'initiale du premier mot est en
1679 majuscule, et les mots qui le composent sont joints par un caractère
1680 souligné. Ainsi, le @code{Staff_symbol_engraver} est chargé de créer
1681 les lignes de la portée, et le @code{Clef_engraver} détermine la hauteur
1682 de référence de la portée en dessinant le symbole de la clef.
1684 Voici quelques-uns des graveurs les plus courants, ainsi que leur
1685 fonction. Vous noterez qu'il est facile d'en connaître la fonction à
1686 partir du nom, et vice versa.
1688 @multitable @columnfractions .3 .7
1691 @item Accidental_engraver
1692 @tab Crée les altérations, y compris de précaution, accidentelles ou
1695 @tab Grave les ligatures (@emph{beams})
1697 @tab Grave les clefs
1698 @item Completion_heads_engraver
1699 @tab Divise les notes qui dépassent de la mesure
1700 @item Dynamic_engraver
1701 @tab Crée les soufflets et textes de nuance
1702 @item Forbid_line_break_engraver
1703 @tab Empêche un saut de ligne si un élément musical est toujours actif
1706 @item Metronome_mark_engraver
1707 @tab Grave les indications métronomiques
1708 @item Note_heads_engraver
1709 @tab Grave les têtes de note
1711 @tab Grave les silences
1712 @item Staff_symbol_engraver
1713 @tab Grave les cinq lignes (par défaut) de la portée
1715 @tab Crée les hampes et les trémolos sur une hampe unique
1716 @item Time_signature_engraver
1717 @tab Crée les métriques
1722 Nous verrons plus avant comment le résultat de LilyPond peut changer
1723 lorsqu'on modifie l'action des graveurs.
1726 Référence des propriétés internes :
1727 @rinternals{Engravers and Performers}.
1730 @node Modification des propriétés d'un contexte
1731 @subsection Modification des propriétés d'un contexte
1732 @translationof Modifying context properties
1734 @cindex contexte, propriétés
1735 @cindex propriétés d'un contexte, modification
1736 @cindex modification des propriétés d'un contexte
1741 Les contextes gèrent les différentes valeurs des nombreuses
1742 @emph{propriétés} qui leur sont attachées. Beaucoup d'entre elles
1743 sont susceptibles d'être modifiées afin d'influer sur l'interprétation
1744 de l'input et ainsi changer l'apparence du résultat. On les modifie
1745 grâce à la commande @code{\set}, qui s'utilise ainsi :
1748 \set @emph{ContexteNommé}.@emph{propriétéNommée} = #@emph{valeur}
1751 où @emph{ContexteNommé} est habituellement @code{Score},
1752 @code{Staff} ou @code{Voice}. S'il n'est pas mentionné, il sera
1753 considéré comme étant @code{Voice}.
1755 Les noms des propriétés de contexte sont composés de mots accolés sans
1756 trait d'union ni caractère souligné, et dont seul le premier n'aura pas
1757 d'initiale en majuscule. Voici quelques exemples de celles les plus
1758 communément utilisées.
1760 @c attempt to force this onto a new page
1762 @multitable @columnfractions .25 .15 .45 .15
1763 @headitem propriétéNommée
1766 @tab Exemple de valeur
1769 @tab Si vrai, ajoute un bécarre avant une altération accidentelle
1770 @tab @code{#t}, @code{#f}
1771 @item currentBarNumber
1773 @tab Détermine le numéro de la mesure en cours
1777 @tab Si vrai, imprime les liaisons au-dessous @strong{et} au-dessus
1779 @tab @code{#t}, @code{#f}
1780 @item instrumentName
1782 @tab Détermine le nom à afficher en début de portée
1783 @tab @code{"Cello I"}
1786 @tab Augmente ou diminue la taille de la fonte
1790 @tab Détermine le texte à imprimer avant le début d'un couplet
1795 où un booléen correspond soit à vrai (@code{#t} pour @emph{True} en
1796 anglais) ou faux (@code{#f} pour @emph{False} en anglais), un entier est
1797 un nombre entier positif, un réel est un nombre décimal positif ou
1798 négatif, et texte correspond à une suite de caractères encadrée par des
1799 apostrophes doubles. Attention à la présence des signes dièse
1800 (@code{#}) dans deux cas particuliers : ils sont partie intégrante
1801 des valeurs booléennes et précèdent les @code{t} ou @code{f}, mais
1802 doivent aussi précéder @emph{valeur} dans le libellé de la commande
1803 @code{\set}. Il faudra donc, dans le cas d'une valeur booléenne, ne pas
1804 oublier de saisir deux signes dièse -- par exemple @code{##t}.
1806 @cindex propriétés et contextes
1807 @cindex réglage de propriétés au sein des contextes
1809 Avant de déterminer l'une de ces propriétés, nous devons savoir dans
1810 quel contexte elle intervient. Si cela est bien souvent évident, il
1811 peut arriver que cela tourne au cauchemar. Lorsque vous ne spécifiez
1812 pas le bon contexte, aucun message d'erreur ne s'affiche et l'effet
1813 attendu n'est pas au rendez-vous. Par exemple, le @code{clefGlyph} est
1814 de manière incontestable membre du contexte @code{Staff}, puisque c'est
1815 bien le glyphe de clef de la portée qui doit être changé.
1816 Dans l'exemple suivant, la première portée affiche effectivement la
1817 bonne clef, alors que ce n'est pas le cas pour la deuxième -- qui porte
1818 la clef de sol par défaut au lieu d'une clef de basse (clef de fa) --
1819 dans la mesure où le contexte n'a pas été spécifié.
1821 @lilypond[quote,verbatim,ragged-right]
1823 \new Staff \relative {
1824 \set Staff.clefGlyph = "clefs.C"
1827 \new Staff \relative {
1828 \set clefGlyph = "clefs.F" % Wrong!
1834 Dans la mesure où le nom de contexte par défaut est @code{Voice}, la
1835 deuxième commande @code{\set} a défini la propriété @code{clefGlyph}
1836 dans le contexte de voix. Puisque LilyPond n'ira pas chercher une telle
1837 propriété dans le contexte @code{Voice}, celle-ci ne sera pas
1838 interprétée. Il ne s'agit pas d'une erreur, aucun message d'erreur ne
1839 sera ni émis ni enregistré.
1841 De la même manière, une faute d'orthographe dans le nom de la propriété
1842 ne générera aucun message d'erreur et l'action escomptée ne se produira
1843 pas. Vous pourriez déterminer par la commande @code{\set} n'importe
1844 quelle @qq{propriété}, même fictive, à partir de n'importe quel nom et
1845 dans n'importe lequel des contextes disponibles. Mais tant que ce nom
1846 est inconnu de LilyPond, rien ne se passera. Certains éditeurs de texte
1847 disposent d'une prise en charge spécifique aux fichiers source LilyPond,
1848 à l'instar de LilyPondTool couplé à JEdit et qui documente les noms des
1849 propriétés dans une infobulle lorsque vous les survolez à la souris, ou
1850 les souligne différemment s'ils sont inconnus, comme ConTEXT. Dans le
1851 cas où votre éditeur ne dispose pas de ces fonctionnalités, nous vous
1852 recommandons de vérifier le nom des propriétés que vous manipulez dans
1853 la Référence des propriétés internes -- voir
1854 @rinternals{Tunable context properties}, ou @rinternals{Contexts}.
1856 La propriété @code{clefGlyph} ne sera prise en compte que si elle
1857 est définie dans un contexte @code{Staff} ; d'autres propriétés
1858 peuvent par contre être définies dans plusieurs contextes différents.
1859 C'est le cas de la propriété @code{extraNatural} qui est définie par
1860 défaut à @code{##t} (vrai) pour toutes les portées. Si vous lui
1861 attribuez la valeur @code{##f} (faux) dans un contexte @code{Staff}
1862 particulier, elle ne s'appliquera qu'aux altérations de la portée en
1863 question ; si vous lui attribuez la valeur @qq{faux} au niveau du
1864 contexte @code{Score}, cela s'appliquera alors à toutes les portées.
1866 Voici comment supprimer les bécarres supplémentaires pour une portée :
1868 @lilypond[quote,verbatim,ragged-right]
1870 \new Staff \relative {
1873 \new Staff \relative {
1874 \set Staff.extraNatural = ##f
1881 et pour toutes les portées :
1883 @lilypond[quote,verbatim,ragged-right]
1885 \new Staff \relative {
1888 \new Staff \relative {
1889 \set Score.extraNatural = ##f
1895 Autre exemple, si la propriété @code{clefTransposition} est déterminée
1896 au niveau du contexte @code{Score}, elle modifiera la valeur de la
1897 transposition en cours pour toutes les portées actives ; cette valeur
1898 sera considérée comme étant la nouvelle valeur par défaut pour toutes
1899 les portées à venir.
1901 La commande opposée, @code{\unset}, efface la propriété du contexte ; la
1902 plupart des propriétés reviennent de ce fait à leur valeur par défaut.
1903 En règle générale, la commande @code{\unset} n'est pas nécessaire dès
1904 lors que vous faites appel à une nouvelle commande @code{\set} pour
1905 modifier le réglage.
1907 Les commandes @code{\set} et @code{\unset} peuvent intervenir n'importe
1908 où dans votre fichier source. Elles seront effectives dès leur
1909 apparition et jusqu'à la fin de la partition, à moins d'être affectées
1910 par un @code{\unset} ou un nouveau @code{\set}. À titre d'exemple, nous
1911 allons jouer avec la taille des fontes, ce qui affecte entre autres la
1912 grosseur des têtes de note. Les modifications s'appliquent toujours par
1913 rapport à la valeur par défaut, non par rapport à la dernière valeur
1916 @lilypond[quote,verbatim,ragged-right]
1919 % make note heads smaller
1922 % make note heads larger
1923 \set fontSize = #2.5
1925 % return to default size
1931 Nous venons de voir comment déterminer la valeur de différents types de
1932 propriété. N'oubliez pas que les nombres, entiers ou réels, doivent
1933 être précédés d'un signe dièse (@code{#}) et les valeurs vrai ou faux de
1934 deux signes dièse -- respectivement @code{##t} et @code{##f} --. Une
1935 valeur textuelle doit être encadrée de guillemets anglais,
1936 @code{"@dots{}"}, bien que, comme nous le constaterons plus tard, la
1937 commande @code{\markup} permet aussi de spécifier du texte.
1940 @subsubheading Définition des propriétés de contexte avec @code{\with}
1941 @translationof Setting context properties with @code{\with}
1945 @cindex propriétés d'un contexte, définition avec \with
1947 Les propriétés d'un contexte peuvent aussi être réglées lors de la
1948 création de ce contexte. Ceci constitue parfois une façon plus claire
1949 de spécifier les valeurs d'une propriété pour la durée de vie du
1950 contexte. Lorsque vous créez un contexte à l'aide de la commande
1951 @code{\new}, vous pouvez la faire suivre immédiatement d'un bloc
1952 @code{\with @{ @dots{} @}} qui contiendra les réglages des différentes
1953 propriétés. Ainsi, si nous voulions par exemple annuler l'impression
1954 des bécarres supplémentaires sur la durée d'une portée, nous
1958 \new Staff \with @{ extraNatural = ##f @}
1964 @lilypond[quote,verbatim,ragged-right]
1968 gisis'4 gis aeses aes
1970 \new Staff \with { extraNatural = ##f } {
1972 gisis'4 gis aeses aes
1978 Les propriétés réglées de cette manière peuvent néanmoins être modifiées
1979 de façon dynamique grâce à @code{\set} ; un @code{\unset} les ramènera à
1980 leur valeur initialisée par @code{\with}.
1982 @cindex fontSize, valeur par défaut et réglage
1984 La propriété @code{fontSize} constitue une exception : lorsqu'elle
1985 est déterminée au sein d'un bloc @code{\with}, cela redéfinit la valeur
1986 par défaut de la taille de fonte. Une modification est possible par la
1987 commande @code{\set}, mais la commande @code{\unset fontSize} fera
1988 revenir à la nouvelle valeur par défaut.
1991 @subsubheading Définition des propriétés de contexte avec @code{\context}
1992 @translationof Setting context properties with @code{\context}
1994 @cindex propriétés d'un contexte, définition avec \context
1998 Vous pouvez régler les valeurs des propriétés de contexte en une seule
1999 fois pour tous les contextes d'un même type, par exemple tous les
2000 contextes @code{Staff}. Le type du contexte doit être donné
2001 explicitement d'après son nom, par exemple @code{Staff}, précédé d'une
2002 oblique inverse, donc nous saisirons @code{\Staff}. La manière de
2003 régler la valeur des propriétés est la même que ce que nous avons vu
2004 avec la commande @code{\with}, puisqu'on se place dans un bloc
2005 @code{\context} inclus dans un bloc @code{\layout}. Chaque bloc
2006 @code{\context} affectera tous les contextes concernés par le bloc
2007 @code{\score} ou @code{\book} au sein duquel apparaît ce bloc
2008 @code{\layout}. Voici comment le mettre en place :
2010 @lilypond[verbatim,quote]
2026 Dans le cas où ces ajustements de propriété doivent affecter
2027 toutes les portées de la partition, nous utiliserons alors :
2029 @lilypond[quote,verbatim]
2034 gisis'4 gis aeses aes
2039 gisis'4 gis aeses aes
2045 \Score extraNatural = ##f
2052 Les propriétés de contexte ainsi définies peuvent être adaptées pour
2053 chacun des contextes en particulier grâce à un bloc @code{\with} ou bien
2054 une commande @code{\set} au fil des notes.
2057 Manuel de notation :
2058 @ruser{Modification des réglages par défaut d'un contexte},
2059 @ruser{La commande de fixation (set)}.
2061 Référence des propriétés internes :
2062 @rinternals{Contexts},
2063 @rinternals{Tunable context properties}.
2066 @node Ajout et suppression de graveurs
2067 @subsection Ajout et suppression de graveurs
2068 @translationof Adding and removing engravers
2070 @cindex graveurs, ajout
2071 @cindex graveurs, suppression
2076 Nous avons vu que chaque contexte met en œuvre plusieurs graveurs, et
2077 que chacun de ces graveurs est chargé de générer une composante
2078 particulière du fichier de sortie, qui les barres de mesure, qui la
2079 portée, qui les têtes de note, les hampes, etc. Le fait de supprimer un
2080 graveur d'un contexte éliminera sa contribution au fichier de sortie.
2081 Bien que ce soit là un moyen radical de modifier le résultat, cette
2082 pratique est dans quelques cas fort utile.
2085 @subsubheading Modification d'un seul contexte
2086 @translationof Changing a single context
2088 Nous utilisons, pour supprimer un graveur d'un contexte, la commande
2089 @code{\with} dès la création du-dit contexte, comme nous l'avons vu dans
2090 la section précédente.
2092 Illustrons notre propos en reprenant un exemple du chapitre précédent,
2093 duquel nous supprimerons les lignes de la portée. Pour mémoire, les
2094 lignes d'une portée sont générées par le @code{Staff_symbol_engraver}.
2096 @lilypond[quote,verbatim,ragged-right]
2098 \remove "Staff_symbol_engraver"
2102 \set fontSize = #-4 % make note heads smaller
2104 \set fontSize = #2.5 % make note heads larger
2106 \unset fontSize % return to default size
2111 @cindex ambitus, graveur
2113 Vous pouvez aussi ajouter individuellement un graveur à un contexte. La
2114 commande se formule ainsi :
2116 @code{\consists @var{Nom_du_graveur}}
2119 et se place dans un bloc @code{\with}. Certaines partitions vocales
2120 font apparaître un @rglos{ambitus} au début de la portée, afin
2121 d'indiquer ses notes extrêmes. L'ambitus est généré par
2122 l'@code{Ambitus_engraver}, que l'on peut adjoindre à n'importe quel
2123 contexte. Si nous l'ajoutons au contexte @code{Voice}, seule la
2124 tessiture de cette voix sera calculée :
2126 @lilypond[quote,verbatim,ragged-right]
2129 \consists "Ambitus_engraver"
2146 alors que si nous l'ajoutons au contexte @code{Staff},
2147 l'@code{Ambitus_engraver} calculera l'écart maximal à partir de toutes
2148 les notes de toutes les voix de la portée :
2150 @lilypond[quote,verbatim,ragged-right]
2152 \consists "Ambitus_engraver"
2171 @subsubheading Modification de tous les contextes d'un même type
2172 @translationof Changing all contexts of the same type
2176 Les exemples ci-dessus nous ont montré comment ajouter ou retirer des
2177 graveurs à des contextes individuels. Nous pourrions aussi ajouter ou
2178 supprimer des graveurs à tous les contextes d'un même type en insérant
2179 les commandes pour le contexte approprié au sein d'un bloc
2180 @code{\layout}. Si nous voulions afficher un ambitus pour chacune des
2181 portées d'un système à quatre portées, il nous suffirait d'écrire :
2183 @lilypond[quote,verbatim,ragged-right]
2212 \consists "Ambitus_engraver"
2219 Vous réglerez de la même manière les propriétés de tous les contextes
2220 d'un type particulier si vous insérez les commandes @code{\set} dans un
2221 bloc @code{\context}.
2224 Manuel de notation :
2225 @ruser{Modification des greffons de contexte},
2226 @ruser{Modification des réglages par défaut d'un contexte}.
2229 Dans la mesure où les @code{Stem_engraver} et @code{Beam_engraver}
2230 rattachent à des têtes de note les objets qu'ils créent, désactiver le
2231 @code{Note_heads_engraver} entraîne l'absence de hampe et de ligature.
2234 @node Extension des modèles
2235 @section Extension des modèles
2236 @translationof Extending the templates
2238 Bon, vous avez lu le tutoriel, vous savez écrire de la musique. Mais
2239 comment obtenir les portées que vous voulez ? Les @ref{Modèles}, c'est
2240 bien beau, mais que faire quand ils ne traitent pas ce que l'on veut
2243 Les exemples qui suivent vous donneront des méthodes générales pour
2244 adapter des modèles.
2247 * Soprano et violoncelle::
2248 * Partition pour chœur à quatre voix mixtes::
2249 * Écriture d'une partition à partir de zéro::
2250 * Économie de saisie grâce aux identificateurs et fonctions::
2251 * Conducteurs et parties::
2255 @node Soprano et violoncelle
2256 @subsection Soprano et violoncelle
2257 @translationof Soprano and cello
2259 @cindex modèles, modification des
2261 Commencez par le modèle qui vous semblera le plus proche de ce à quoi
2262 vous voulez aboutir. Disons par exemple que vous voulez écrire une pièce
2263 pour soprano et violoncelle : dans ce cas, on pourrait commencer par les
2264 @qq{notes et paroles}, pour la partie de soprano.
2267 \version @w{"@version{}"}
2269 melodie = \relative @{
2276 texte = \lyricmode @{
2282 \new Voice = "un" @{
2286 \new Lyrics \lyricsto "un" \texte
2293 Maintenant, on veut ajouter une partie de violoncelle.
2294 Jetons un coup d'œil sur l'exemple avec les notes seules :
2297 \version @w{"@version{}"}
2299 melodie = \relative @{
2313 On n'a pas besoin de deux commandes @code{\version}. Ce dont on a
2314 besoin, c'est de la section @code{melodie}. De même, on n'a pas besoin
2315 de deux sections @code{\score} -- si nous les gardions toutes les deux,
2316 on obtiendrait deux parties séparées ; mais nous voulons un vrai duo,
2317 avec les deux parties ensemble. Dans la section @code{\score}, on n'a
2318 pas besoin non plus de deux @code{\layout} ni de deux @code{\midi}.
2320 Si on se contente de couper et coller les sections @code{melodie}, on se
2321 retrouvera avec deux sections de ce nom ; il nous faut donc les
2322 renommer. Appelons la section pour la soprano @code{sopranoMusique} et
2323 celle pour le violoncelle @code{violoncelleMusique}. Tant qu'on y est,
2324 renommons @code{texte} en @code{sopranoParoles}. Attention à bien
2325 renommer les deux occurrences de chacune de ces dénominations :
2326 c'est-à-dire la définition de départ, où l'on trouve
2327 @code{melodie = \relative @{ }, et l'endroit où cette dénomination
2328 est utilisée, dans la section @code{\score}.
2330 Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de fa,
2331 comme le veut l'usage, et donnons-lui d'autres notes.
2334 \version @w{"@version{}"}
2336 sopranoMusique = \relative @{
2343 sopranoParoles = \lyricmode @{
2347 violoncelleMusique = \relative @{
2356 \new Voice = "un" @{
2360 \new Lyrics \lyricsto "un" \sopranoParoles
2367 Voilà qui est mieux, mais la partie de violoncelle n'apparaît pas sur
2368 la partition -- en effet, nous n'y avons pas fait appel dans la section
2369 @code{\score}. Si l'on veut que la partie de violoncelle s'imprime sous
2370 la partie de soprano, on va devoir ajouter :
2373 \new Staff \musiqueVioloncelle
2377 en dessous de tout ce qui concerne la soprano. Il nous faut également
2378 encadrer la musique par des @code{<<} et @code{>>}, qui feront comprendre
2379 à LilyPond que plusieurs événements -- ici, des objets @code{Staff} --
2380 se déroulent en même temps. Le bloc @code{\score} ressemble maintenant à
2382 @c Indentation in this example is deliberately poor
2387 \new Voice = "un" @{
2391 \new Lyrics \lyricsto "un" \sopranoParoles
2393 \new Staff \violoncelleMusique
2401 C'est un peu le bazar dans tout ça ; mais il vous sera facile de
2402 mettre un peu d'ordre dans l'indentation. Voici le modèle pour
2403 soprano et violoncelle au complet :
2405 @lilypond[quote,verbatim,ragged-right,addversion]
2406 sopranoMusic = \relative {
2413 sopranoLyrics = \lyricmode {
2417 celloMusic = \relative {
2427 \new Voice = "one" {
2431 \new Lyrics \lyricsto "one" \sopranoLyrics
2433 \new Staff \celloMusic
2441 Les patrons originaux sont disponibles à l'annexe
2442 @ref{Modèles pour portée unique}.
2445 @node Partition pour chœur à quatre voix mixtes
2446 @subsection Partition pour chœur à quatre voix mixtes
2447 @translationof Four-part SATB vocal score
2449 @cindex exemple, SATB
2450 @cindex SATB, squelette
2452 La plupart des œuvres écrites pour chœur à quatre voix mixtes et
2453 orchestre, comme Elias de Mendelssohn ou le Messie de Haendel, disposent
2454 la musique et les paroles du chœur sur quatre portées -- soprano, alto,
2455 ténor et basse -- surmontant une réduction pour piano de
2456 l'accompagnement orchestral. En voici un exemple, tiré du Messie de
2459 @c The following should appear as music without code
2460 @lilypond[quote,ragged-right]
2461 global = { \key d \major \time 4/4 }
2463 sopranoMusic = \relative {
2465 r4 d''2 a4 | d4. d8 a2 | cis4 d cis2 |
2467 sopranoWords = \lyricmode {
2468 Wor -- thy | is the lamb | that was slain |
2471 altoMusic = \relative {
2473 r4 a'2 a4 | fis4. fis8 a2 | g4 fis e2 |
2475 altoWords = \sopranoWords
2477 tenorMusic = \relative {
2479 r4 fis'2 e4 | d4. d8 d2 | e4 a, cis2 |
2481 tenorWords = \sopranoWords
2483 bassMusic = \relative {
2485 r4 d'2 cis4 | b4. b8 fis2 | e4 d a'2 |
2487 bassWords = \sopranoWords
2492 r4 <a' d fis>2 <a e' a>4 |
2493 <d fis d'>4. <d fis d'>8 <a d a'>2 |
2494 <g cis g'>4 <a d fis> <a cis e>2 |
2500 <d, d'>4 <d d'>2 <cis cis'>4 |
2501 <b b'>4. <b' b'>8 <fis fis'>2 |
2502 <e e'>4 <d d'> <a' a'>2 |
2506 << % combine ChoirStaff and PianoStaff in parallel
2508 \new Staff = "sopranos"
2509 \with { instrumentName = #"Soprano" }
2511 \new Voice = "sopranos" {
2516 \new Lyrics \lyricsto "sopranos" {
2519 \new Staff = "altos"
2520 \with { instrumentName = #"Alto" }
2522 \new Voice = "altos" {
2527 \new Lyrics \lyricsto "altos" {
2530 \new Staff = "tenors"
2531 \with { instrumentName = #"Tenor" }
2533 \new Voice = "tenors" {
2538 \new Lyrics \lyricsto "tenors" {
2541 \new Staff = "basses"
2542 \with { instrumentName = #"Bass" }
2544 \new Voice = "basses" {
2549 \new Lyrics \lyricsto "basses" {
2553 \new PianoStaff \with { instrumentName = #"Piano" }
2555 \new Staff = "upper" \upper
2556 \new Staff = "lower" \lower
2562 @warning{Cette présentation s'obtient facilement à l'aide du gabarit
2563 préprogrammé @code{satb.ly} -- voir @ref{Gabarits préprogrammés}. Il
2564 masque, dans un but de simplification, totalement la structure des
2565 contextes nécessaires et les génère automatiquement. Pour les besoins
2566 de la démonstration et à titre didactique nous procèderons ici pas à
2567 pas, ce gabarit préprogrammé ne correspondant pas forcément à vos
2570 Le gabarit qui se rapprocherait le plus de cette mise en forme est
2571 @ref{Partition pour chœur SATB avec réduction pour piano} -- voir
2572 @ref{Modèles pour ensemble vocal} -- mais encore faudrait-il en
2573 modifier la mise en forme et refaire la partie de piano qui n'est
2574 plus une simple reprise des parties vocales. Les variables qui
2575 gèrent la musique et les paroles du chœur ne nécessitent pas de
2576 modification, mais il nous faut d'autres variables pour la
2579 L'ordre dans lequel apparaissent les contextes dans le @code{ChoirStaff}
2580 du modèle ne correspond pas à ce que nous voyons ci-dessus. Il nous
2581 faudra y revenir pour obtenir quatre portées avec des paroles en dessous
2582 de chacune d'elles. Toutes les voix devraient être @code{\voiceOne},
2583 ce qui est la position par défaut ; il nous faudra donc éliminer toutes
2584 les commandes @code{\voiceXXX}. Les ténors auront besoin d'une clé
2585 spécifique. Enfin, nous n'avons pas encore abordé la façon dont les
2586 paroles sont présentées dans le modèle ; nous procéderons donc comme
2587 nous en avons l'habitude. Il faudra aussi ajouter un nom à chaque
2590 Une fois tout ceci accompli, voici notre @code{ChoirStaff} :
2594 \new Staff = "sopranos"
2595 \with @{ instrumentName = #"Soprano" @}
2597 \new Voice = "sopranos" @{
2602 \new Lyrics \lyricsto "sopranos" @{
2605 \new Staff = "altos"
2606 \with @{ instrumentName = #"Alto" @}
2608 \new Voice = "altos" @{
2613 \new Lyrics \lyricsto "altos" @{
2616 \new Staff = "tenors"
2617 \with @{ instrumentName = #"Tenor" @}
2619 \new Voice = "tenors" @{
2624 \new Lyrics \lyricsto "tenors" @{
2627 \new Staff = "basses"
2628 \with @{ instrumentName = #"Bass" @}
2630 \new Voice = "basses" @{
2635 \new Lyrics \lyricsto "basses" @{
2641 Il nous faut maintenant nous occuper de la partie de piano. Nous allons
2642 nous contenter de récupérer la partie de piano du modèle @qq{Solo
2646 \new PianoStaff \with @{ instrumentName = #"Piano" @}
2648 \new Staff = "upper" \superieur
2649 \new Staff = "lower" \inferieur
2653 puis d'ajouter les définitions de variable pour @code{superieur} et
2656 Les systèmes pour chœur et pour piano doivent être combinés à l'aide de
2657 doubles chevrons gauche/droite puisqu'ils doivent s'empiler :
2660 << % combine ChoirStaff and PianoStaff one above the other
2662 \new Staff = "sopranos" <<
2663 \new Voice = "sopranos" @{
2668 \new Lyrics \lyricsto "sopranos" @{
2671 \new Staff = "altos" <<
2672 \new Voice = "altos" @{
2677 \new Lyrics \lyricsto "altos" @{
2680 \new Staff = "tenors" <<
2681 \clef "G_8" % tenor clef
2682 \new Voice = "tenors" @{
2687 \new Lyrics \lyricsto "tenors" @{
2690 \new Staff = "basses" <<
2692 \new Voice = "basses" @{
2697 \new Lyrics \lyricsto "basses" @{
2702 \new PianoStaff \with @{ instrumentName = #"Piano" @}
2704 \new Staff = "upper" \upper
2705 \new Staff = "lower" \lower
2710 Une fois tout cela mis en place, et après avoir ajouté les notes et les
2711 paroles de ces trois mesures du Messie, nous obtenons :
2713 @lilypond[quote,verbatim,ragged-right,addversion]
2714 global = { \key d \major \time 4/4 }
2715 sopranoMusic = \relative {
2717 r4 d''2 a4 | d4. d8 a2 | cis4 d cis2 |
2719 sopranoWords = \lyricmode {
2720 Wor -- thy | is the lamb | that was slain |
2722 altoMusic = \relative {
2724 r4 a'2 a4 | fis4. fis8 a2 | g4 fis fis2 |
2726 altoWords = \sopranoWords
2727 tenorMusic = \relative {
2729 r4 fis'2 e4 | d4. d8 d2 | e4 a, cis2 |
2731 tenorWords = \sopranoWords
2732 bassMusic = \relative {
2734 r4 d'2 cis4 | b4. b8 fis2 | e4 d a'2 |
2736 bassWords = \sopranoWords
2740 r4 <a' d fis>2 <a e' a>4 |
2741 <d fis d'>4. <d fis d'>8 <a d a'>2 |
2742 <g cis g'>4 <a d fis> <a cis e>2 |
2747 <d, d'>4 <d d'>2 <cis cis'>4 |
2748 <b b'>4. <b' b'>8 <fis fis'>2 |
2749 <e e'>4 <d d'> <a' a'>2 |
2753 << % combine ChoirStaff and PianoStaff in parallel
2755 \new Staff = "sopranos"
2756 \with { instrumentName = #"Soprano" }
2758 \new Voice = "sopranos" {
2763 \new Lyrics \lyricsto "sopranos" {
2766 \new Staff = "altos"
2767 \with { instrumentName = #"Alto" }
2769 \new Voice = "altos" {
2774 \new Lyrics \lyricsto "altos" {
2777 \new Staff = "tenors"
2778 \with { instrumentName = #"Tenor" }
2780 \new Voice = "tenors" {
2785 \new Lyrics \lyricsto "tenors" {
2788 \new Staff = "basses"
2789 \with { instrumentName = #"Bass" }
2791 \new Voice = "basses" {
2796 \new Lyrics \lyricsto "basses" {
2802 \with { instrumentName = #"Piano " }
2804 \new Staff = "upper" \upper
2805 \new Staff = "lower" \lower
2812 @node Écriture d'une partition à partir de zéro
2813 @subsection Écriture d'une partition à partir de zéro
2814 @translationof Building a score from scratch
2816 @cindex modèles, création
2817 @cindex squelettes, création
2819 Après avoir acquis une certaine dextérité dans l'écriture de code
2820 LilyPond, vous devez vous sentir suffisamment prêt à vous lancer dans
2821 la création d'une partition à partir de zéro, autrement dit en ne
2822 partant pas d'un exemple. Vous pourrez ainsi vous construire vos
2823 propres patrons selon le type de musique que vous affectionnez plus
2824 particulièrement. Pour voir comment procéder, nous allons monter la
2825 partition d'un prélude pour orgue.
2827 Nous débutons par une section d'en-tête ; nous y mettrons entre
2828 autres le titre et le nom du compositeur. Puis viennent toutes les
2829 définitions de toutes les variables. Nous terminons par le bloc
2830 @code{\score}. Attelons-nous pour cette aventure, en gardant bien à
2831 l'esprit ce que nous venons de dire ; nous nous occuperons des
2832 détails en temps voulu.
2834 Nous nous appuyons sur les deux premières mesures du prélude sur
2835 @emph{Jesu, meine Freude}, écrit pour orgue avec pédalier. Vous pouvez
2836 voir ces deux mesures au bas de cette page. La main droite comporte
2837 deux voix, la main gauche et le pédalier une seule. Il nous faut donc
2838 quatre définitions de musique, plus une qui contiendra la métrique et
2842 \version @w{"@version{}"}
2844 title = "Jesu, meine Freude"
2845 composer = "J S Bach"
2847 ArmureMetrique = @{ \key c \minor \time 4/4 @}
2848 ManuelUnVoixUnMusique = @{ s1 @}
2849 ManuelUnVoixDeuxMusique = @{ s1 @}
2850 ManuelDeuxMusique = @{ s1 @}
2851 PedalierOrgueMusique = @{ s1 @}
2857 Pour l'instant, nous utilisons des silences invisibles, @code{s1}, en
2858 lieu et place des notes réelles. On verra plus tard.
2860 Passons maintenant au bloc @code{\score} et à ce qu'il devrait contenir.
2861 Nous y recopions simplement la structure des portées que nous voulons.
2862 La musique pour orgue se présente généralement sous la forme de trois
2863 portées, une pour chaque main et une pour le pédalier. Les portées du
2864 manuel sont regroupées, nous utiliserons donc un @code{PianoStaff}. La
2865 première partie du manuel requiert deux voix et la seconde une seule.
2869 \new Staff = "ManuelUn" <<
2871 \ManuelUnVoixUnMusique
2874 \ManuelUnVoixDeuxMusique
2876 >> % fin du contexte de portée ManuelUn
2877 \new Staff = "ManuelDeux" <<
2881 >> % fin du contexte de portée ManuelDeux
2882 >> % fin du contexte PianoStaff
2885 Il nous faut ajouter à cela une portée pour le pédalier. Elle se place
2886 sous le système de piano, mais puisqu'elle doit rester synchrone avec
2887 lui, nous utilisons des doubles chevrons pour les regrouper.
2888 Négliger ceci nous renverrait une erreur, et personne n'est à l'abri de
2889 cette faute ! Pour preuve, il vous suffit de copier l'exemple
2890 complet en fin de chapitre, de supprimer ces @code{<<} et @code{>>}, et
2891 de le compiler, pour voir de quoi il retourne.
2894 << % Système pianistique et portée de pédalier sont synchrones
2896 \new Staff = "ManuelUn" <<
2898 \ManuelUnVoixUnMusique
2901 \ManuelUnVoixDeuxMusique
2903 >> % fin du contexte de portée ManuelUn
2904 \new Staff = "ManuelDeux" <<
2908 >> % fin du contexte de portée ManuelDeux
2909 >> % fin du contexte PianoStaff
2910 \new Staff = "PedalierOrgue" <<
2912 \PedalierOrgueMusique
2918 La construction en simultané -- @code{<< @dots{} >>} -- n'est pas
2919 strictement obligatoire pour les portées manuel deux et pédalier, qui ne
2920 contiennent chacune qu'une seule expression musicale ; mais cela ne
2921 mange pas de pain, et c'est une bonne habitude que de toujours encadrer
2922 par des doubles chevrons gauche/droite ce qui suit une commande
2923 @code{\new Staff} au cas où il y aurait plusieurs voix. Il en va
2924 autrement pour les contextes @code{Voice} : ils doivent être toujours
2925 suivis d'accolades -- @code{@{ @dots{} @}} -- au cas où vous auriez
2926 employé plusieurs variables qui doivent intervenir consécutivement.
2928 Ajoutons donc cette structure au bloc @code{\score}, tout en fignolant
2929 l'indentation. Nous en profitons pour ajouter les clefs appropriées,
2930 effectuer les réglages concernant les hampes et liaisons de la portée
2931 supérieure grâce à @code{\voiceOne} et @code{\voiceTwo}, et mettre en
2932 place la métrique et l'armure de chaque portée grâce à notre variable
2933 @code{\MetriqueArmure}.
2937 << % Système pianistique et portée de pédalier sont synchrones
2939 \new Staff = "ManuelUn" <<
2940 \ArmureMetrique % définition de l'armure et de la métrique
2944 \ManuelUnVoixUnMusique
2948 \ManuelUnVoixDeuxMusique
2950 >> % fin du contexte de la portée ManuelUn
2951 \new Staff = "ManuelDeux" <<
2957 >> % fin du contexte de la portée ManuelDeux
2958 >> % fin du contexte PianoStaff
2959 \new Staff = "PedalierOrgue" <<
2963 \PedalierOrgueMusique
2965 >> % fin du contexte de la portée PedalOrgan
2967 @} % fin du contexte Score
2970 @cindex espacement des portées
2971 @cindex portées, espacement
2973 Cette partition pour orgue est presque parfaite. Reste juste ce petit
2974 défaut qui ne se remarque pas lorsque l'on considère un seul système :
2975 la distance qui sépare la portée de pédalier de celle de la main gauche
2976 devrait être plus ou moins égale à celle qui sépare les deux mains. En
2977 fait, la distance entre les deux portées d'un @code{PianoStaff} ne
2978 saurait trop se dilater ; le pédalier devrait adopter le même
2981 @cindex sous-propriétés
2982 @cindex propriétés et sous-propriétés
2983 @cindex graphical objects
2984 @cindex objets graphiques
2987 La propension des portées à se dilater se contrôle à l'aide de la
2988 propriété @code{staff-staff-spacing}, attachée à @qq{l'objet graphique}
2989 @code{VerticalAxisGroup} -- la documentation de LilyPond utilise souvent
2990 l'abréviation @emph{grob} pour @emph{graphical object}. Pas de
2991 panique ! Tout ceci sera expliqué plus tard -- pour les curieux,
2992 jetez un œil au chapitre
2993 @ruser{Vue d'ensemble de la modification des propriétés}.
2994 Revenons à notre propos : nous voulons modifier uniquement la
2995 sous-propriété @code{stretchability}. Les impatients trouveront les
2996 valeurs par défaut de la propriété @code{staff-staff-spacing} dans le
2997 fichier @file{scm/define-grobs.scm}, en examinant la définition du
2998 @emph{grob} @code{VerticalAxisGroup}. La valeur que nous affecterons à
2999 @code{stretchability} est celle que contient la définition du contexte
3000 @code{PianoStaff} telle qu'elle apparaît dans le fichier
3001 @file{ly/engraver-init.ly}).
3005 << % Système pianistique et portée de pédalier sont synchrones
3007 \new Staff = "ManuelUn" <<
3008 \ArmureMetrique % définition de l'armure et de la métrique
3012 \ManuelUnVoixUnMusique
3016 \ManuelUnVoixDeuxMusique
3018 >> % fin du contexte de la portée ManuelUn
3019 \new Staff = "ManuelDeux" \with @{
3020 \override VerticalAxisGroup.staff-staff-spacing.stretchability = 5
3027 >> % fin du contexte de la portée ManuelDeux
3028 >> % fin du contexte PianoStaff
3029 \new Staff = "PedalierOrgue" <<
3033 \PedalierOrgueMusique
3035 >> % fin du contexte de la portée PedalOrgan
3037 @} % fin du contexte Score
3040 Nous en avons fini avec la structure. Toutes les partitions pour orgue
3041 auront cette structure, même si le nombre de voix peut changer. Tout ce
3042 qui nous reste à faire maintenant consiste à saisir la musique et à
3043 regrouper toutes les parties.
3045 @lilypond[quote,verbatim,ragged-right,addversion]
3047 title = "Jesu, meine Freude"
3048 composer = "J S Bach"
3050 keyTime = { \key c \minor \time 4/4 }
3051 ManualOneVoiceOneMusic = \relative {
3055 ManualOneVoiceTwoMusic = \relative {
3056 ees'16 d ees8~ 16 f ees d c8 d~ d c~ |
3057 8 c4 b8 c8. g16 c b c d |
3059 ManualTwoMusic = \relative {
3060 c'16 b c8~ 16 b c g a8 g~ 16 g aes ees |
3061 f16 ees f d g aes g f ees d ees8~ 16 f ees d |
3063 PedalOrganMusic = \relative {
3064 r8 c16 d ees d ees8~ 16 a, b g c b c8 |
3065 r16 g ees f g f g8 c,2 |
3069 << % PianoStaff and Pedal Staff must be simultaneous
3071 \new Staff = "ManualOne" <<
3072 \keyTime % set key and time signature
3076 \ManualOneVoiceOneMusic
3080 \ManualOneVoiceTwoMusic
3082 >> % end ManualOne Staff context
3083 \new Staff = "ManualTwo" \with {
3084 \override VerticalAxisGroup.staff-staff-spacing.stretchability = 5
3091 >> % end ManualTwo Staff context
3092 >> % end PianoStaff context
3093 \new Staff = "PedalOrgan" <<
3099 >> % end PedalOrgan Staff context
3101 } % end Score context
3105 Glossaire musicologique :
3106 @rglosnamed{system,système}.
3109 @node Économie de saisie grâce aux identificateurs et fonctions
3110 @subsection Économie de saisie grâce aux identificateurs et fonctions
3111 @translationof Saving typing with variables and functions
3114 @cindex identificateurs
3116 Jusqu'à maintenant, vous avez vu ce type de code :
3118 @lilypond[quote,verbatim,ragged-right]
3119 hornNotes = \relative { c''4 b dis c }
3127 Vous comprendrez combien cela peut être utile pour écrire de la
3128 musique minimaliste :
3130 @lilypond[quote,verbatim,ragged-right]
3131 fragmentA = \relative { a'4 a8. b16 }
3132 fragmentB = \relative { a'8. gis16 ees4 }
3134 violin = \new Staff { \fragmentA \fragmentA \fragmentB \fragmentA }
3143 Néanmoins vous pouvez aussi utiliser ces identificateurs -- aussi connus
3144 sous le nom de variables, macros, ou commandes (définies par
3145 l'utilisateur) -- pour des retouches :
3147 @lilypond[quote,verbatim,ragged-right]
3148 dolce = \markup { \italic \bold dolce }
3150 centerText = { \once \override TextScript.self-alignment-X = #CENTER }
3153 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
3156 violin = \relative {
3158 c''4._\dolce b8 a8 g a b |
3160 c4.^"hi there!" d8 e f g d |
3161 c4.\fthenp b8 c4 c-. |
3172 Ces identificateurs sont évidemment utiles pour économiser de la
3173 frappe. Mais ils peuvent l'être même si vous ne les utilisez qu'une
3174 seule fois : ils réduisent la complexité. Regardons l'exemple
3175 précédent sans aucun identificateur. C'est beaucoup plus laborieux à
3176 lire, et particulièrement la dernière ligne.
3179 violin = \relative @{
3181 c''4._\markup @{ \italic \bold dolce @} b8 a8 g a b |
3182 \once \override TextScript.self-alignment-X = #CENTER
3183 c4.^"hi there!" d8 e f g d |
3185 \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p
3192 Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond
3193 rencontre @code{\centerText}, il le remplace par le contenu que nous lui
3194 avons défini -- c'est-à-dire le contenu à droite de @code{centerText=}.
3196 LilyPond gère également des substitutions non-statiques -- vous
3197 pouvez les voir comme des fonctions.
3199 @lilypond[quote,verbatim,ragged-right]
3201 #(define-music-function
3205 \once \override TextScript.padding = #padding
3209 c''4^"piu mosso" b a b
3211 c4^"piu mosso" b a b
3213 c4^"piu mosso" b a b
3217 Utiliser des identificateurs est aussi un bon moyen pour vous épargner
3218 du travail si la syntaxe de LilyPond change un jour -- voir
3219 @rprogram{Mise à jour avec convert-ly}. Si vous avez une seule
3220 définition, par exemple @code{\dolce}, pour tous vos fichiers (voir
3221 @ref{Feuilles de style}) et que la syntaxe change, alors vous n'aurez
3222 qu'à mettre à jour votre seule définition @code{\dolce}, au lieu de
3223 devoir modifier chaque fichier @file{.ly}.
3226 @node Conducteurs et parties
3227 @subsection Conducteurs et parties
3228 @translationof Scores and parts
3230 Dans la musique d'orchestre, toutes les notes sont imprimées deux fois.
3231 D'abord dans les parties séparées destinées aux musiciens, et ensuite
3232 dans le conducteur destiné au chef. Les variables sont là pour vous
3233 éviter un double travail. La musique n'est entrée qu'une seule fois, et
3234 stockée dans une variable, dont le contenu servira à imprimer à la fois
3235 la partie séparée et la partition d'orchestre.
3237 Il est judicieux de définir les notes dans un fichier séparé. Par
3238 exemple, supposons que le fichier @file{musique-Cor.ly} contienne la
3239 partie suivante pour un duo cor/@/basson.
3242 notesCor = \relative @{
3244 r4 f8 a | cis4 f | e d |
3249 On établira alors une partie séparée en constituant un nouveau fichier :
3252 \include "musique-Cor.ly"
3255 instrument = "Cor en Fa"
3259 \transpose f c' \notesCor
3266 \include "musique-Cor.ly"
3270 sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
3271 fait la variable @code{notesCor} se trouvera définie. La commande
3272 @code{\transpose f c'} indique que son argument @code{\notesCor} sera
3273 transposé à la quinte supérieure : le son réel @code{f} s'écrit
3274 @code{c'}, ce qui est la caractéristique d'un Cor en fa. La
3275 transposition est visible comme suit :
3277 @lilypond[quote,ragged-right]
3278 \transpose f c' \relative {
3280 r4 f8 a | cis4 f | e d |
3284 Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
3285 pendant plusieurs mesures. Un silence spécial, appelé silence
3286 multimesures, l'indique alors. On l'obtient par un @code{R} majuscule,
3287 suivi d'une durée : @code{1} pour une pause, @code{2} pour une
3288 demi-pause, etc. Cette durée peut être multipliée pour établir de plus
3289 longs silences. Par exemple, le silence suivant dure trois mesures
3296 Dans une partie séparée, les silences multimesure sont compressés.
3297 LilyPond dispose d'une commande à cet effet :
3300 \compressMMRests @{ ... @}
3303 Si l'on ajoute dans la musique ci-dessus le silence multimesure et cette
3304 instruction, on obtient le résultat suivant :
3306 @lilypond[quote,ragged-right]
3307 \compressMMRests \transpose f c' \relative {
3310 r4 f8 a | cis4 f | e d |
3314 Le conducteur rassemble toute la musique. Si l'on suppose que l'autre
3315 voix de notre duo se trouve dans le fichier @file{musique-Basson.ly} en
3316 tant que variable @code{notesBasson}, on établira un conducteur avec
3319 \include "musique-Basson.ly"
3320 \include "musique-Cor.ly"
3323 \new Staff \notesCor
3324 \new Staff \notesBasson
3331 @lilypond[quote,ragged-right]
3337 r4 f8 a | cis4 f | e4 d |
3342 r4 d,8 f | gis4 c | b4 bes |
3343 a8 e f4 | g4 d | gis4 f |
3349 Manuel d'initiation :
3350 @ref{Organisation du code source avec des variables}.
3352 Manuel de notation :
3353 @ruser{Écriture de parties séparées},
3354 @ruser{Insertion de fichiers LilyPond},
3355 @ruser{Silences valant une mesure},
3356 @ruser{Transposition}.