1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Valentin Villenave, Nicolas Klutchnikoff, Damien Heurtebise
13 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
14 @c Translation status: post-GDP
16 @node Retouche de partition
17 @chapter Retouche de partition
18 @translationof Tweaking output
20 Ce chapitre indique comment modifier le résultat obtenu.
21 LilyPond offre de nombreuses possibilités de réglages, permettant
22 théoriquement de modifier chaque élément de votre partition.
25 * Retouches élémentaires::
26 * Le manuel de référence des propriétés internes::
27 * Apparence des objets::
28 * Positionnement des objets::
29 * Collisions d'objets::
34 @node Retouches élémentaires
35 @section Retouches élémentaires
36 @translationof Tweaking basics
39 * Introduction aux retouches::
40 * Objets et interfaces::
41 * Conventions de nommage des objets et propriétés::
42 * Méthodes de retouche::
46 @node Introduction aux retouches
47 @subsection Introduction aux retouches
48 @translationof Introduction to tweaks
50 LilyPond regroupe sous le terme de @qq{retouches} (@emph{tweaks} en
51 anglais) les différents moyens dont dispose l'utilisateur pour
52 intervenir sur l'interprétation du fichier d'entrée et pour modifier
53 l'apparence du fichier de sortie. Certaines retouches sont très
54 simples à mettre en œuvre@tie{}; d'autres sont plus complexes. Mais
55 à elles toutes, elles permettent d'obtenir tout ce qu'on veut en matière
58 Dans ce chapitre, nous traitons des concepts de base nécessaires
59 pour comprendre l'art de la retouche. Puis nous présentons de
60 nombreuses commandes déjà prêtes, qu'il suffit de recopier pour
61 obtenir un résultat identique dans vos partitions@tie{}; nous en
62 profitons pour expliquer comment ces commandes ont été construites, si
63 bien que vous pouvez apprendre par la même occasion à développer
64 vos propres retouches.
66 Avant de vous lancer dans ce chapitre, il peut être utile de revoir la
67 section @ref{Contextes et graveurs}, dans la mesure où les contextes,
68 graveurs et autres propriétés qui y sont décrits, sont indispensables
69 pour comprendre et construire les retouches.
72 @node Objets et interfaces
73 @subsection Objets et interfaces
74 @translationof Objects and interfaces
81 @cindex propriétés des objets
82 @cindex objet, propriétés
83 @cindex objet de rendu
84 @cindex rendu, objets de
86 Toute retouche implique que l'on modifie les opérations internes
87 et les structures du programme LilyPond. Nous allons donc, pour
88 commencer, présenter certains termes qui servent à décrire ces
89 opérations internes et ces structures.
91 Le terme @qq{Objet} est un terme générique qui fait référence à
92 une multitude de structures internes mises en place par LilyPond
93 durant la compilation d'un fichier d'entrée. Ainsi, quand une
94 commande du type @code{\new Staff} apparaît, un nouvel objet
95 du type @code{Staff} est créé. Cet objet @code{Staff} contient
96 alors toutes les propriétés associées à cette portée, par exemple son
97 nom et son armure, ainsi que le détail des graveurs qui ont été
98 désignés pour fonctionner dans ce contexte de portée.
99 Certains objets peuvent contenir les propriétés de tous les autres
100 contextes, comme les objets @code{Voice}, les objets @code{Score},
101 les objets @code{Lyrics}@tie{}; d'autres se rapportent à tous les
102 éléments de notation, comme les barres de mesure, les liaisons, les
103 nuances, etc. Chaque objet dispose de son propre échantillon de valeurs
104 pour le réglage des propriétés.
106 Certains types d'objet portent des noms spécifiques. Les objets qui se
107 rapportent à des éléments de notation sur le fichier de sortie, comme
108 les notes, les hampes, les liaisons de phrasé ou de prolongation, les
109 doigtés, les clefs, etc. sont appelés @qq{Objets de rendu}@tie{}; ils
110 sont aussi connus sous le nom d'@qq{Objets graphiques} (en
111 anglais@tie{}: @emph{Graphical objects} ou @emph{Grobs} pour faire
112 court). Ce sont bien des objets au sens générique ci-dessus et, en
113 tant que tels, ils reçoivent des propriétés qui leur sont associées,
114 comme leur position, leur taille, leur couleur, etc.
116 Certains objets de rendu, comme les liaisons de phrasé, les soufflets
117 de crescendo, les marques d'octaviation et beaucoup d'autres
118 @emph{grobs}, ont pour particularité de ne pas se situer à un seul et
119 unique endroit -- ils ont un point de départ, un point d'arrivée, et
120 éventuellement d'autres propriétés relatives à leur forme. Ces objets
121 avec une forme étendue sont appelés des bandeaux (@emph{Spanners} en
124 Il reste à expliquer ce que sont les @qq{interfaces}. De nombreux
125 objets, qui peuvent être très différents les uns des autres, ont pour
126 point commun de devoir être compilés simultanément. Par exemple, tous
127 les @emph{grobs} ont une couleur, une taille, une position, etc., et
128 toutes ces propriétés sont compilées simultanément durant
129 l'interprétation du fichier d'entrée par LilyPond. Pour alléger ces
130 opérations internes, ces actions et propriétés communes sont regroupées
131 en un objet appelé @code{grob-interface}. Il existe beaucoup d'autres
132 regroupements de propriétés communes dans le genre de celui-ci, chacun
133 portant un nom qui se termine par @code{interface}. En tout, on en
134 compte plus d'une centaine. Nous verrons plus loin en quoi c'est
135 intéressant et utile pour l'utilisateur.
137 Ainsi s'achève le tour des principaux termes relatifs aux objets
138 que nous serons amenés à utiliser dans ce chapitre.
141 @node Conventions de nommage des objets et propriétés
142 @subsection Conventions de nommage des objets et propriétés
143 @translationof Naming conventions of objects and properties
145 @cindex conventions de nommage des objets
146 @cindex conventions de nommage des propriétés
147 @cindex objets, conventions de nommage des
148 @cindex propriétés, conventions de nommage des
150 Nous avons eu un aperçu, dans @ref{Contextes et graveurs}, de
151 la façon de nommer les objets. Voici maintenant une liste de
152 référence des types d'objets et de propriétés les plus courants,
153 avec leurs conventions de nommage et quelques exemples
154 de cas concrets. La lettre @var{A} représente n'importe quel
155 caractère alphabétique majuscule, et les lettres @var{aaa}
156 un nombre indéterminé de caractères alphabétiques minuscules.
157 Les autres caractères sont à prendre tels qu'ils se présentent.
159 @multitable @columnfractions .33 .33 .33
160 @headitem Type d'objet/propriété
161 @tab Convention de nommage
164 @tab Aaaa ou AaaaAaaaAaaa
165 @tab Staff, GrandStaff
166 @item Objets de rendu
167 @tab Aaaa ou AaaaAaaaAaaa
170 @tab Aaaa_aaa_engraver
171 @tab Clef_engraver, Note_heads_engraver
173 @tab aaa-aaa-interface
174 @tab grob-interface, break-aligned-interface
175 @item Propriétés de contexte
176 @tab aaa ou aaaAaaaAaaa
177 @tab alignAboveContext, skipBars
178 @item Propriétés d'objet de rendu
179 @tab aaa ou aaa-aaa-aaa
180 @tab direction, beam-thickness
183 Comme nous le verrons bientôt, les propriétés des différents
184 types d'objet sont modifiées par des commandes différentes, si bien
185 qu'il est bon de savoir reconnaître le type d'un objet en fonction du
186 nom de ses propriétés.
189 @node Méthodes de retouche
190 @subsection Méthodes de retouche
191 @translationof Tweaking methods
193 @cindex retouches, méthodologie
194 @cindex méthodes de retouche
196 @strong{La commande \override}
198 @cindex override, commande
199 @cindex override, syntaxe
204 Dans @ref{Modification des propriétés d'un contexte} et dans
205 @ref{Ajout et suppression de graveurs}, nous avons déjà rencontré les
206 commandes @code{\set} et @code{\with}, qui servent à changer les
207 propriétés des @strong{contextes} et à supprimer ou ajouter des
208 @strong{graveurs}. Voici maintenant d'autres commandes plus
211 La commande pour changer les propriétés des @strong{objets de rendu}
212 est @code{\override}. Du fait que cette commande modifie en profondeur
213 les propriétés internes de LilyPond, sa syntaxe n'est pas aussi simple
214 que pour les commandes vues précédemment. Elle a besoin de savoir avec
215 précision quelle est la propriété à modifier, pour quel objet et dans
216 quel contexte, et quelle doit être sa nouvelle valeur. Voyons de quoi
219 La syntaxe générale de cette commande est@tie{}:
222 \override @var{Contexte}.@var{ObjetDeRendu} #'@var{propriété-rendu} = #@var{valeur}
226 Elle attribue à la propriété appelée @var{propriété-rendu}, associée à
227 l'objet @var{ObjetDeRendu}, appartenant lui-même au contexte
228 @var{Contexte}, une valeur @var{valeur}.
230 Le contexte @var{Contexte} peut être omis (c'est généralement
231 le cas) quand il n'y a pas d'ambiguïté et qu'il s'agit d'un contexte
232 de très bas niveau, comme @code{Voice}, @code{ChordNames}
233 ou @code{Lyrics}. Dans les exemples qui suivent, le contexte sera
234 très souvent omis. Nous verrons plus tard dans quelles
235 circonstances il doit impérativement être indiqué.
237 Les sections ci-dessous traitent largement des propriétés et de leurs
238 valeurs -- voir @ref{Types de propriétés} -- mais, pour illustrer la
239 mise en forme et l'utilisation de ces commandes, nous nous limiterons à
240 n'employer que quelques propriétés et valeurs simples, facilement
243 Nous ne parlerons dans l'immédiat ni du @code{#'}, qui précède
244 toujours la propriété, ni du @code{#}, qui précède toujours la
245 valeur. Ces deux éléments doivent obligatoirement être
246 présents sous cette forme. Voici la commande la plus fréquente
247 pour faire des retouches, et pratiquement tout le reste de ce
248 chapitre aura pour but montrer, à travers des exemples, comment
249 l'utiliser. L'exemple ci-dessous change la couleur des têtes de
252 @cindex couleur,exemple d'utilisation de la propriété
253 @cindex NoteHead, exemple de dérogation
255 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
257 \override NoteHead #'color = #red
259 \override NoteHead #'color = #green
263 @strong{La commande \revert}
265 @cindex revert, commande
270 Une fois qu'elle a été modifiée, la propriété conserve sa nouvelle
271 valeur jusqu'à ce qu'elle soit à nouveau modifiée ou qu'elle rencontre
272 la commande @code{\revert}. La commande @code{\revert} obéit à
273 la syntaxe ci-dessous et ramène la valeur de la propriété à sa valeur
274 d'origine. Attention@tie{}: dans le cas où plusieurs @code{\override}
275 ont été employés, il ne s'agit pas de la valeur précédente mais bien de
276 la valeur par défaut.
279 \revert @var{Contexte}.@var{ObjetDeRendu} #'@var{propriété-de-rendu}
282 Tout comme pour la commande @code{\override}, la mention du
283 @var{Contexte} est souvent facultative. Elle sera omise dans de
284 nombreux exemples ci-dessous. Voici un exemple qui ramène la
285 couleur des deux dernières notes à leur valeur par défaut@tie{}:
287 @cindex couleur,exemple d'utilisation de la propriété
288 @cindex NoteHead, exemple de dérogation
290 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
292 \override NoteHead #'color = #red
294 \override NoteHead #'color = #green
296 \revert NoteHead #'color
300 @strong{Le préfixe \once}
305 Les commandes @code{\override} et @code{\set} peuvent supporter
306 toutes les deux le préfixe @code{\once}. Celui-ci a pour fonction de
307 n'appliquer la commande @code{\override} ou @code{\set} qu'à
308 l'instant musical en cours, avant que la propriété ne reprenne
309 sa valeur antérieure -- qui n'est pas forcément la valeur par défaut
310 lorsqu'un autre @code{\override} est toujours effectif. Toujours à
311 partir du même exemple, il est possible de ne changer la couleur que
312 d'une seule note@tie{}:
314 @cindex couleur,exemple d'utilisation de la propriété
315 @cindex NoteHead, exemple de dérogation
317 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
319 \override NoteHead #'color = #red
321 \once \override NoteHead #'color = #green
323 \revert NoteHead #'color
327 @strong{La commande \overrideProperty}
329 @cindex overrideProperty, commande
331 @funindex \overrideProperty
332 @funindex overrideProperty
334 Il existe une autre forme de commande @code{\override},
335 @code{\overrideProperty}, qui est parfois utile. Nous la mentionnons
336 ici par souci d'exhaustivité@tie{}; pour le détail, voir
337 @rextend{Retouches complexes}.
339 @c Maybe explain in a later iteration -td
341 @strong{La commande \tweak}
343 @cindex tweak, commande
348 La dernière commande disponible pour les retouches est
349 @code{\tweak}. Elle sert à changer les propriétés d'objets qui
350 surviennent simultanément dans la musique, comme par exemple les
351 notes d'un accord. La commande @code{\override} modifierait toutes
352 les notes de l'accord, tandis que @code{\tweak} permet de ne modifier
353 que l'élément suivant dans la chaîne de saisie.
355 Voici un exemple. Supposons que nous voulions changer la taille de
356 la tête de note du milieu (le mi) dans un accord de do majeur. Voyons
357 d'abord ce que donnerait @code{\once \override}@tie{}:
359 @cindex font-size, exemple d'utilisation de la propriété
360 @cindex NoteHead, exemple de dérogation
362 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
364 \once \override NoteHead #'font-size = #-3
369 Nous voyons que @code{\override} modifie @emph{toutes} les têtes
370 de notes de l'accord, car toutes les notes de l'accord surviennent au
371 même @emph{instant musical} et que la fonction de @code{\once}
372 est de faire porter la modification sur tous les objets du type spécifié
373 qui surviennent au même instant musical, comme le fait la commande
374 @code{\override} elle-même.
376 La commande @code{\tweak} opère différemment. Elle agit
377 sur l'élément immédiatement suivant dans la chaîne de saisie. Elle ne
378 fonctionne toutefois que sur des objets créés directement à partir de
379 la chaîne de saisie, c'est-à-dire essentiellement des têtes de notes et
380 des articulations@tie{}; des objets comme les hampes ou les
381 altérations accidentelles sont créés ultérieurement et ne peuvent
382 être retouchés de cette manière. En outre, quand la retouche porte
383 sur une tête de note, celle-ci @emph{doit} appartenir à un accord,
384 c'est-à-dire être comprise à l'intérieur de chevrons gauche/droite.
385 Pour retoucher une note isolée, il faut donc placer la commande
386 @code{\tweak} avec la note à l'intérieur des chevrons gauche/droite.
388 Pour reprendre notre exemple, la taille de la note du milieu d'un
389 accord peut être modifiée de cette manière@tie{}:
391 @cindex font-size, exemple d'utilisation de la propriété
392 @cindex @code{\tweak}, exemple
394 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
396 <c \tweak #'font-size #-3 e g>4
399 Vous noterez que la syntaxe de @code{\tweak} est différente de
400 celle de la commande @code{\override}. Ni le contexte,
401 ni l'objet n'ont besoin d'être spécifiés@tie{}; au contraire, cela
402 produirait une erreur si on le faisait. Tous deux sont sous-entendus
403 par l'élément suivant dans la chaîne de saisie. La syntaxe générale
404 de la commande @code{\tweak} est donc, tout simplement@tie{}:
407 \tweak #'@var{propriété-de-rendu} = #@var{valeur}
410 La commande @code{\tweak} est aussi utilisée quand on veut, dans
411 une série d'articulations, n'en modifier qu'une seule. Ainsi@tie{}:
413 @cindex couleur, exemple d'utilisation de la propriété
414 @cindex @code{\tweak}, exemple
416 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
418 -\tweak #'color #red ^"Red"
419 -\tweak #'color #green _"Green"
423 Attention@tie{}: la commande @code{\tweak} doit être précédée d'une
424 marque d'articulation, comme si elle-même était une articulation.
426 @cindex nolets imbriqués
427 @cindex triolets imbriqués
428 @cindex crochet de nolet
429 @cindex nolet, crochet
430 @cindex triolet, crochet
432 @funindex TupletBracket
434 Quand plusieurs nolets sont imbriqués et commencent au même instant
435 musical, c'est encore la commande @code{\tweak} qui est utilisée pour
436 changer l'apparence de l'un d'entre eux. Dans l'exemple suivant, le
437 long crochet de nolet et le premier des trois crochets courts commencent
438 au même instant musical@tie{}; une commande @code{\override}
439 s'appliquerait donc à la fois aux deux. En revanche, @code{\tweak}
440 permet de les dissocier. La première commande @code{\tweak} indique que
441 le long crochet doit être placé au-dessus des notes, et la seconde
442 indique que le coefficient de nolet doit être imprimé en rouge sur le
443 premier crochet de triolet court.
445 @cindex @code{\tweak}, exemple
446 @cindex direction, exemple d'utilisation de la propriété
447 @cindex couleur, exemple d'utilisation de la propriété
449 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
450 \tweak #'direction #up
453 \times 2/3 { c8[ c c] }
454 \times 2/3 { c8[ c c] }
455 \times 2/3 { c8[ c c] }
459 Si les nolets imbriqués ne commencent pas au même moment,
460 leur apparence peut alors être modifiée de la façon habituelle,
461 avec la commande @code{\override}@tie{}:
463 @cindex texte, exemple d'utilisation de la propriété
464 @cindex tuplet-number, exemple de fonction
465 @cindex transparence, exemple d'utilisation de la propriété
466 @cindex TupletNumber, exemple de dérogation
468 @c NOTE Tuplet brackets collide if notes are high on staff
470 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
471 \times 2/3 { c8[ c c] }
472 \once \override TupletNumber
473 #'text = #tuplet-number::calc-fraction-text
477 \once \override TupletNumber #'transparent = ##t
478 \times 2/3 { c8[ c c] }
479 \times 2/3 { c8[ c c] }
486 @ruser{La commande d'affinage (@emph{tweak})}.
489 @node Le manuel de référence des propriétés internes
490 @section Le manuel de référence des propriétés internes
491 @translationof The Internals Reference manual
493 @cindex Références internes
496 * Propriétés des objets de rendu::
497 * Propriétés listées par interface::
498 * Types de propriétés::
502 @node Propriétés des objets de rendu
503 @subsection Propriétés des objets de rendu
504 @translationof Properties of layout objects
506 @cindex propriétés des objets de rendu
507 @cindex propriétés des objets graphiques (grobs)
508 @cindex grobs, propriétés
509 @cindex objets de rendu, propriétés
510 @cindex Manuel des références internes
512 Imaginons que votre partition contienne une liaison trop fine à votre
513 goût et que vous vouliez la rendre plus épaisse. Comment vous y
514 prendre@tie{}? Vous êtes convaincu, avec tout ce qui a été dit sur la
515 souplesse de LilyPond, qu'une telle retouche est réalisable et
516 vous vous dites qu'elle fera sans doute intervenir la commande
517 @code{\override}. Mais existe-t-il une propriété épaisseur qui
518 s'applique à une liaison et, dans l'affirmative, comment faire pour la
519 modifier@tie{}? C'est là qu'intervient la Référence des propriétés
520 internes. Elle contient toutes les informations dont vous avez besoin
521 pour construire n'importe quelle commande @code{\override}.
523 Avant de nous plonger dans la Référence des propriétés
524 internes, un mot d'avertissement. Il s'agit d'un document de
525 @strong{références}, de sorte qu'il ne contient pas ou peu
526 d'explications@tie{}: son but est de présenter les informations de
527 façon précise et concise. Cela peut paraître décourageant
528 à première vue. Pas d'inquiétude@tie{}! Les conseils et les
529 explications fournis ici vous permettent de retrouver par vous-même les
530 informations dans la Référence des propriétés internes. Il
531 suffit d'un peu de pratique.
533 @cindex override, exemple
534 @cindex dérogation, exemple
535 @cindex Références internes, exemple d'utilisation
536 @cindex @code{\addlyrics} -- exemple
538 Prenons un exemple concret tiré d'un morceau de musique connu@tie{}:
540 @c Mozart, Die Zauberflöte Nr.7 Duett
542 @lilypond[quote,verbatim,relative=2]
547 r4 bes8 bes[( g]) g |
548 g8[( es]) es d[( f]) as |
552 The man who | feels love's sweet e -- | mo -- tion
557 Admettons que nous voulions rendre les traits de liaison plus épais.
558 Est-ce possible@tie{}? Une liaison est assurément un objet de rendu, si
559 bien que la question est @qq{Existe-t-il une propriété attachée aux
560 liaisons et qui en contrôle l'épaisseur@tie{}?} Pour y répondre, nous
561 consultons la Référence des propriétés internes (ou RPI pour faire
564 Vous trouverez sur le site de LilyPond @uref{http://lilypond.org} la
565 RPI correspondant à votre version du programme. Allez sur la page
566 Documentation et cliquez sur Référence des propriétés internes.
567 Pour l'apprentissage, mieux vaut utiliser la version HTML standard,
568 et non la @qq{page unique en anglais} ou le PDF. Durant la lecture
569 des prochains paragraphes, il vous est conseillé de vous y reporter
570 réellement afin que les explications prennent tout leur sens.
572 En dessous du bandeau d'en-tête figurent cinq liens. Cliquez sur le
573 lien vers le @emph{Backend}, où se trouvent les informations sur les
574 objets de rendu. En dessous du titre @strong{Backend}, choisissez
575 alors le lien vers @emph{Tous les objets de rendu}. La page qui s'ouvre
576 énumère, dans l'ordre alphabétique, tous les objets utilisés dans votre
577 version de LilyPond. Cliquez sur Liaisons (@emph{Slurs} en anglais),
578 et les propriétés des liaisons apparaîtront.
580 Il existe un autre moyen de trouver cette page, à partir du Manuel de
581 notation. Une des pages qui traitent des liaisons contient un lien vers
582 la Référence des propriétés internes, qui mène directement à cette
583 page. Mais lorsque vous connaissez le nom de l'objet à retoucher, le
584 plus simple est de consulter la RPI.
586 La page de la RPI sur les liaisons commence par préciser que les objets
587 Liaison sont créés par le graveur Slur_engraver. Vient ensuite la liste
588 des réglages standard. Attention@tie{}: ceux-ci @strong{ne suivent pas}
589 l'ordre alphabétique. Il faut donc les parcourir en entier pour trouver
590 la propriété susceptible de contrôler l'épaisseur des traits de liaison.
593 @code{thickness} (nombre)
595 Épaisseur de ligne, généralement mesurée en @code{line-thickness}
598 Voilà qui semble approprié pour changer l'épaisseur (@emph{thickness} en
599 anglais). On apprend que la valeur de @code{thickness}
600 est un simple nombre (@emph{number}), qu'elle est par défaut définie
601 à 1,2 et que l'unité de mesure est fixée par une autre propriété
602 appelée @code{line-thickness}.
604 Comme il a été indiqué, on ne trouve que peu, voire pas du tout
605 d'explication dans la RPI, mais nous en savons assez pour essayer
606 de changer l'épaisseur de la liaison. Comme nous l'avons vu, le
607 nom de l'objet est @code{Slur}, le nom de la propriété à changer
608 est @code{thickness} et la nouvelle valeur sera un nombre supérieur
609 à @code{1.2} si l'on veut augmenter l'épaisseur du trait.
611 Pour construire la commande @code{\override}, il suffit donc de
612 remplacer les valeurs que nous avons trouvées en guise de noms, en
613 laissant de côté le contexte. Commençons par une valeur très élevée
614 dans un premier temps, pour nous assurer que la commande fonctionne.
618 \override Slur #'thickness = #5.0
621 N'oublions pas le @code{#'} qui doit précéder le nom de la propriété et
622 le @code{#} qui doit précéder la nouvelle valeur.
624 La dernière question est@tie{}: @qq{Où placer cette commande@tie{}?}
625 Tant qu'on n'est pas sûr de soi, la meilleure réponse est @qq{À
626 l'intérieur de l'expression musicale, avant la première liaison et
627 proche d'elle.} Essayons@tie{}:
629 @cindex Slur, exemple de dérogation
630 @cindex thickness, exemple d'utilisation de la propriété
632 @lilypond[quote,verbatim,relative=2]
637 % Increase thickness of all following slurs from 1.2 to 5.0
638 \override Slur #'thickness = #5.0
639 r4 bes8 bes[( g]) g |
640 g8[( es]) es d[( f]) as |
644 The man who | feels love's sweet e -- | mo -- tion
650 et nous constatons que le trait de liaison est beaucoup plus épais.
652 Telle est la façon normale de construire les commandes
653 @code{\override}. Comme nous aurons l'occasion de le voir
654 par la suite, le problème est parfois plus complexe. Dans
655 l'immédiat, nous en savons assez pour construire nos propres
656 commandes -- mais il faut encore s'exercer. Les exemples
657 suivants sont là dans cette intention.
660 @subheading Détermination du contexte adéquat
662 @cindex contexte, détermination du
663 @cindex contexte, identification correcte du
665 Tout d'abord, de quoi avions-nous besoin pour préciser le
666 contexte@tie{}? À quoi devait-il ressembler@tie{}? Gageons que les
667 liaisons appartiennent au contexte Voix, dans la mesure où
668 elles sont étroitement liées à une ligne mélodique, mais
669 comment en être sûr@tie{}? Pour répondre à cette question,
670 revenons en haut de la page de la RPI consacrée aux liaisons@tie{};
671 il est écrit@tie{}: @qq{Les objets Liaison sont créés par le graveur
672 Slur_engraver}. Ainsi les liaisons seront créées dans n'importe
673 quel contexte où se trouve le @code{Slur_engraver}. Suivons
674 le lien vers la page @code{Slur_engraver}. Tout en bas, on
675 lit que le @code{Slur_engraver} est un élément appartenant
676 à cinq contextes Voix, dont le contexte de voix
677 standard, @code{Voice}. Notre hypothèse était donc juste.
678 Et parce que @code{Voice} est un contexte de très bas
679 niveau, qu'il est activé sans ambiguïté par le fait que l'on est
680 en train de saisir des notes, on peut ici ne pas le mentionner.
683 @subheading Redéfinition pour une seule occurrence
685 @cindex dérogation pour une seule fois
686 @cindex usage unique, dérogation à
691 Dans le dernier exemple ci-dessus, @emph{toutes} les liaisons étaient
692 plus épaisses. Et si on veut épaissir uniquement la première
693 liaison@tie{}? On recourt alors à la commande @code{\once}. Placée
694 juste avant la commande @code{\override}, elle lui indique de ne changer
695 que la liaison commençant avec la note @strong{juste après}. Si la note
696 juste après n'ouvre pas une liaison, la commande sera sans aucun effet
697 -- elle ne reste pas en mémoire jusqu'à la prochaine liaison, elle est
698 purement et simplement ignorée. Il faut donc que la commande introduite
699 par @code{\once} soit insérée comme suit@tie{}:
702 @cindex Slur, exemple de dérogation
703 @cindex thickness, exemple d'utilisation de la propriété
704 @cindex Liaison, exemple de dérogation
705 @cindex Épaisseur, exemple d'utilisation de la propriété
707 @lilypond[quote,verbatim,relative=2]
713 % Increase thickness of immediately following slur only
714 \once \override Slur #'thickness = #5.0
716 g8[( es]) es d[( f]) as |
720 The man who | feels love's sweet e -- | mo -- tion
726 Alors seule la première liaison est rendue plus épaisse.
728 La commande @code{\once} peut aussi être utilisée devant la commande
732 @subheading Rétablissement
735 @cindex rétablissement
737 @cindex défaut, retour aux propriétés par
742 Et si l'on voulait que les deux premières liaisons soient plus
743 épaisses@tie{}? On pourrait bien sûr utiliser deux commandes, chacune
744 précédée de @code{\once}, et placées juste avant la note par laquelle
745 débute la liaison@tie{}:
748 @cindex Slur, exemple de dérogation
749 @cindex thickness, exemple d'utilisation de la propriété
750 @cindex Liaison, exemple de dérogation
751 @cindex Épaisseur, exemple d'utilisation de la propriété
753 @lilypond[quote,verbatim,relative=2]
759 % Increase thickness of immediately following slur only
760 \once \override Slur #'thickness = #5.0
762 % Increase thickness of immediately following slur only
763 \once \override Slur #'thickness = #5.0
764 g8[( es]) es d[( f]) as |
768 The man who | feels love's sweet e -- | mo -- tion
774 mais on peut aussi, au lieu de la commande @code{\once}, utiliser après
775 la seconde liaison la commande @code{\revert}, qui ramène la propriété
776 @code{thickness} à sa valeur par défaut@tie{}:
778 @cindex Slur, exemple de dérogation
779 @cindex thickness, exemple d'utilisation de la propriété
780 @cindex Liaison, exemple de dérogation
781 @cindex Épaisseur, exemple d'utilisation de la propriété
783 @lilypond[quote,verbatim,relative=2]
789 % Increase thickness of all following slurs from 1.2 to 5.0
790 \override Slur #'thickness = #5.0
793 % Revert thickness of all following slurs to default of 1.2
794 \revert Slur #'thickness
799 The man who | feels love's sweet e -- | mo -- tion
805 N'importe quelle propriété modifiée par @code{\override} peut ainsi
806 être ramenée, grâce à la commande @code{\revert}, à sa valeur par
809 Ici s'achève notre introduction à la RPI et aux retouches
810 simples. Vous trouverez d'autres exemples dans les prochaines
811 sections de ce chapitre@tie{}; ils vous permettront, d'une part,
812 d'apprendre à connaître un peu mieux la RPI et, d'autre part, de
813 vous entraîner un peu plus à y chercher les informations. Ces
814 exemples seront progressivement accompagnés d'explications et
815 introduiront des termes nouveaux.
818 @node Propriétés listées par interface
819 @subsection Propriétés listées par interface
820 @translationof Properties found in interfaces
823 @cindex interfaces, propriétés des
824 @cindex propriétés des interfaces
826 Supposons maintenant que nous voulions imprimer des paroles en italique.
827 Quelle formulation de la commande @code{\override} allons-nous
828 utiliser@tie{}? Nous consultons en premier lieu, comme précédemment, la
829 page de la RPI qui contient la liste @qq{Tous les objets de rendu}, et
830 recherchons un objet qui contrôle les paroles. Nous trouvons
831 @code{LyricText}, qui semble approprié. Nous cliquons dessus et nous
832 voyons apparaître les différentes propriétés des paroles, parmi
833 lesquelles @code{font-series} et @code{font-size}. Mais aucune ne
834 propose l'italique. Car la mise en forme des caractères est une
835 propriété commune à tous les objets d'écriture, si bien que, au lieu de
836 figurer dans tous les objets de rendu, elle est regroupée avec d'autres
837 propriétés semblables et placée dans une @strong{Interface}, la
838 @code{font-interface}.
840 Il nous faut donc apprendre à trouver les propriétés des interfaces
841 et découvrir les objets qui utilisent les propriétés de ces interfaces.
843 Retournons à la page de la RPI qui traite des paroles
844 (@emph{LyricText}). En bas de la page est dressée sous forme de liens
845 la liste des interfaces qui concernent LyricText. Cette liste comporte
846 plusieurs entrées, dont @code{font-interface}. En cliquant dessus, nous
847 voyons apparaître les différentes propriétés associées à cette
848 interface, qui sont en même temps les propriétés de tous les objets qui
849 s'y rapportent, parmi lesquels LyricText.
851 Nous avons alors sous les yeux tous les réglages des propriétés qui
852 contrôlent les polices de caractères, et notamment
853 @code{font-shape(symbole)}, où @code{symbole} peut prendre la valeur
854 @code{upright}, @code{italics} ou @code{caps}.
856 Vous remarquerez que @code{font-series} et @code{font-size} figurent
857 aussi dans la liste. La question qui ne manque pas de se poser
858 est@tie{}: @qq{Comment se fait-il que les propriétés @code{font-series}
859 et @code{font-size} se retrouvent à la fois dans @code{LyricText} et
860 dans l'interface @code{font-interface} alors que ce n'est pas le cas
861 pour @code{font-shape}@tie{}?} La réponse est que lorsqu'un objet
862 @code{LyricText} est créé, les valeurs globales par défaut de
863 @code{font-series} et @code{font-size} sont modifiées, mais pas celles
864 de @code{font-shape}. Les possibilités de modification dans
865 @code{LyricText} ne concernent donc que les valeurs à appliquer à
866 @code{LyricText}. Les autres objets qui dépendent de
867 @code{font-interface} fixeront leurs propriétés différemment lorsqu'ils
870 Voyons maintenant si nous sommes en mesure de formuler la commande
871 @code{\override} pour mettre les paroles en italique. L'objet est
872 @code{LyricText}, la propriété est @code{font-shape} et la valeur est
873 @code{italic}. Comme auparavant, nous laissons de côté le contexte.
875 Signalons rapidement -- même si cette remarque est importante -- que,
876 puisque les valeurs de @code{font-shape} se présentent sous forme de
877 symboles, elles doivent être précédées d'une simple apostrophe,
878 @code{'}. C'est pour cette raison qu'il fallait une apostrophe devant
879 @code{thickness} dans l'exemple précédent, et qu'il en faut une devant
880 @code{font-shape}. Ce sont à chaque fois des symboles, qui sont
881 interprétés comme tels par LilyPond. Certains symboles peuvent être des
882 noms de propriété, comme @code{thickness} ou @code{font-shape},
883 d'autres sont des valeurs à attribuer aux propriétés, comme
884 @code{italic}. À ne pas confondre avec les chaînes de caractères
885 libres, qui se présentent comme @code{"un texte libre"}@tie{}; pour plus
886 de détails sur les symboles et les chaînes de caractères, voir le
887 @rextend{Tutoriel Scheme}.
889 Ainsi, la commande @code{\override} pour mettre les paroles en italique
893 \override LyricText #'font-shape = #'italic
897 et doit être placée juste devant et tout près des paroles à modifier,
900 @cindex font-shape, exemple d'utilisation de la propriété
901 @cindex italic, exemple
902 @cindex LyricText, exemple de dérogation
903 @cindex @code{\addlyrics}, exemple
905 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
910 r4 bes8 bes[( g]) g |
911 g8[( es]) es d[( f]) as |
915 \override LyricText #'font-shape = #'italic
916 The man who | feels love's sweet e -- | mo -- tion
922 et voilà les paroles en italiques.
925 @subheading Spécification du contexte en mode lyrique
927 @cindex contexte, spécification en mode lyrique
928 @cindex mode lyrique, spécification de contexte en
930 Lorsqu'il s'agit de paroles et qu'on cherche à préciser le contexte
931 sur le modèle de ce qui a été fait précédemment, la commande échoue.
932 Car une syllabe saisie en mode Paroles (lyricmode) se termine
933 obligatoirement par une espace, un saut de ligne ou un nombre. Tout
934 autre caractère compte comme un élément de la syllabe. C'est pourquoi
935 il faut une espace ou un saut de ligne avant le @code{@}} final, pour
936 éviter qu'il ne soit assimilé à la dernière syllabe. De même, il faut
937 insérer des espaces de part et d'autre du point, @qq{.}, qui sépare le
938 nom de contexte du nom de l'objet, faute de quoi les deux noms seront
939 joints et l'interpréteur ne pourra pas les reconnaître. La formulation
940 correcte est donc@tie{}:
943 \override Lyrics . LyricText #'font-shape = #'italic
946 @warning{Dans la saisie des paroles, pensez à toujours laisser une
947 espace entre la dernière syllabe et l'accolade fermante.}
949 @warning{Lorsqu'on retouche des paroles, toujours placer des espaces
950 autour du point qui sépare le nom de contexte du nom d'objet.}
954 @rextend{Tutoriel Scheme}.
957 @node Types de propriétés
958 @subsection Types de propriétés
959 @translationof Types of properties
961 @cindex propriété, types de
963 Nous avons vu jusqu'à maintenant deux types de propriétés@tie{}:
964 @code{nombre} et @code{symbole}. Pour pouvoir fonctionner, la valeur
965 associée à une propriété doit correspondre au type attendu et suivre les
966 règles liées à ce type. Le type de propriété est toujours donné entre
967 parenthèses après le nom de propriété dans la RPI. Voici une liste des
968 différents types de propriétés, avec les règles qui les régissent et
969 quelques exemples d'utilisation. Il faut, bien sûr, toujours ajouter un
970 symbole @emph{hash}, @code{#}, devant ces valeurs lors de la saisie de
971 la commande @code{\override}.
973 @multitable @columnfractions .2 .45 .35
974 @headitem Type de propriété
977 @item Booléenne (@emph{Boolean} en anglais)
978 @tab Vrai (@emph{true} en anglais) ou Faux (@emph{false} en anglais),
979 sous la forme @code{#t} ou @code{#f}
980 @tab @code{#t}, @code{#f}
981 @item Dimension (en espaces de portée)
982 @tab Un nombre positif décimal (en unités de lignes de portée)
983 @tab @code{2.5}, @code{0.34}
985 @tab Une direction valide ou son équivalent numérique (valeur décimale
986 comprise entre -1 et 1 seulement)
987 @tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @code{-1}
988 @item Entier (@emph{Integer} en anglais)
989 @tab Un nombre entier positif
990 @tab @code{3}, @code{1}
992 @tab Plusieurs valeurs séparées par une espace, encadrées par des
993 parenthèses et précédées par une apostrophe
994 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
995 @code{'(1.0 0.25 0.5)}
996 @item Markup (ou étiquette)
997 @tab Toute commande @code{\markup} valide
998 @tab @code{\markup @{ \italic "cresc." @}}
999 @item Durée (@emph{Moment} en anglais)
1000 @tab Une durée de note construite avec la fonction make-moment
1001 @tab @code{(ly:make-moment 1 4)}, @code{(ly:make-moment 3 8)}
1003 @tab Une valeur décimale positive ou négative
1004 @tab @code{3.5}, @code{-2.45}
1005 @item Paire (de nombres)
1006 @tab Deux nombres séparées par @qq{espace point espace}, encadrés
1007 par des parenthèses et précédés par une apostrophe
1008 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1010 @tab L'un des symboles autorisés pour cette propriété, précédé par une
1012 @tab @code{'italic}, @code{'inside}
1013 @item Inconnu (@emph{Unknown} en anglais)
1014 @tab Un processus, ou @code{#f} pour empêcher toute action
1015 @tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f}
1017 @tab Une liste de trois éléments encadrés par des parenthèses et
1018 précédés par apostrophe-hash, @code{'#}
1019 @tab @code{'#(#t #t #f)}
1024 Manuel d'extension :
1025 @rextend{Tutoriel Scheme}.
1028 @node Apparence des objets
1029 @section Apparence des objets
1030 @translationof Appearance of objects
1032 Il est temps de mettre en pratique les notions apprises précédemment
1033 pour modifier l'allure de la partition@tie{}; les exemples qui suivent
1034 montrent l'utilisation des différentes méthodes de retouche.
1037 * Visibilité et couleur des objets::
1038 * Taille des objets::
1039 * Longueur et épaisseur des objets::
1043 @node Visibilité et couleur des objets
1044 @subsection Visibilité et couleur des objets
1045 @translationof Visibility and color of objects
1047 Dans un but pédagogique, on peut être amené à masquer certains éléments
1048 d'une partition, que les élèves doivent ensuite compléter. Imaginons,
1049 par exemple, un exercice dans lequel il faudrait rétablir les barres de
1050 mesure dans un morceau de musique. En temps normal, les barres de
1051 mesure s'insèrent automatiquement. Comment faire pour les effacer de la
1054 Avant de nous y attaquer, souvenons-nous que les propriétés d'objets
1055 sont parfois groupées dans ce qu'on appelle des @emph{interfaces} --
1056 voir @ref{Propriétés listées par interface}. Cela permet de rapprocher
1057 toutes les propriétés susceptibles d'être utilisées ensemble pour
1058 modifier un objet graphique -- si l'une d'elles est choisie pour un
1059 objet, elle s'appliquera à tous les autres. Certains objets tirent
1060 alors leurs propriétés de telle ou telle interface, d'autres objets de
1061 telle ou telle autre interface. La liste des interfaces qui contiennent
1062 les propriétés liées à un objet graphique (@emph{grob}) figure dans la
1063 RPI, en bas de la page de description du @emph{grob}@tie{}; pour voir
1064 ces propriétés, il faut aller voir ces interfaces.
1066 Nous avons vu, dans @ref{Propriétés des objets de rendu}, comment
1067 trouver les informations sur les @emph{grobs}. Nous procédons de la
1068 même manière et consultons la RPI pour connaître l'objet chargé
1069 d'imprimer les barres de mesure. En cliquant sur @emph{Backend} puis
1070 sur @emph{Tous les objets de rendu}, nous trouvons un objet appelé
1071 @code{BarLine}. Parmi ses propriétés, deux d'entre elles déterminent
1072 son aspect visuel@tie{}: @code{break-visibility} et @code{stencil}.
1073 L'objet @code{BarLine} est également lié à plusieurs interfaces, dont la
1074 @code{grob-interface} où figurent les propriétés @code{transparent} et
1075 @code{color}. Toutes peuvent modifier l'aspect visuel des barres de
1076 mesure -- et de beaucoup d'autres objets, bien sûr. Examinons chacune
1077 d'elles tour à tour.
1082 @cindex stencil, propriété
1084 Cette propriété contrôle l'apparence des barres de mesure en précisant
1085 le type de symbole (glyphe) à imprimer. Comme pour de nombreuses
1086 autres propriétés, on peut lui indiquer de ne rien imprimer en lui
1087 attribuant la valeur @code{#f}. Essayons en laissant de côté, une fois
1088 encore, le contexte concerné (@code{Voice} en l'occurrence)@tie{}:
1090 @cindex BarLine, exemple de dérogation
1091 @cindex stencil, exemple d'utilisation de la propriété
1093 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1096 \override BarLine #'stencil = ##f
1098 g,8 a16 b8 c d4 e16 |
1103 Les barres de mesure sont encore là@tie{}! Pourquoi@tie{}? Retournons
1104 à la RPI et regardons de nouveau la page qui traite des propriétés de
1105 BarLine. En haut de la page, il est précisé que @qq{Les objets BarLine
1106 sont créés par le graveur Bar_engraver}. Allons à la page de
1107 @code{Bar_engraver}. Tout en bas se trouve la liste des contextes dans
1108 lesquels fonctionne ce graveur. Tous sont du type @code{Staff}, de
1109 sorte que, si la commande @code{\override} n'a pas fonctionné comme
1110 prévu, c'est parce que @code{Barline} n'appartient pas au contexte par
1111 défaut, @code{Voice}. Si le contexte spécifié est erroné, la commande
1112 ne fonctionne pas. Cela n'entraîne pas de message d'erreur, et rien
1113 n'apparaît dans le fichier log. Essayons de corriger en mentionnant le
1116 @cindex BarLine, exemple de dérogation
1117 @cindex stencil, exemple d'utilisation de la propriété
1119 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1122 \override Staff.BarLine #'stencil = ##f
1124 g,8 a16 b8 c d4 e16 |
1129 Cette fois, les barres de mesure ont disparu.
1131 Vous remarquerez que l'affectation de la valeur @code{#f} à la propriété
1132 @code{stencil} déclenchera une erreur dès lors que l'objet en question se
1133 doit d'avoir des dimensions pour les nécessités du traitement. Ce sera
1134 le cas, par exemple, si vous effacez le @code{stencil} d'un objet
1135 @code{NoteHead}. Il vaut mieux, en pareil cas, utiliser la fonction
1136 @code{point-stencil} qui, quant à elle, attribue à l'objet une taille à
1139 @lilypond[quote,verbatim,relative=2]
1142 \once \override NoteHead #'stencil = #point-stencil
1148 @subheading visibilité des barres (break-visibility)
1150 @cindex break-visibility, propriété
1152 La RPI mentionne, à la page sur @code{BarLine}, que la propriété
1153 @code{break-visibility} attend comme argument un vecteur de trois
1154 booléens. Ceux-ci indiquent respectivement si les barres de mesure
1155 doivent être imprimées ou non à la fin de la ligne, à l'intérieur de la
1156 ligne et au début de la ligne. Dans notre cas, nous voulons que toutes
1157 les barres soient supprimées, si bien que la valeur dont nous avons
1158 besoin est @code{'#(#f@tie{}#f@tie{}#f)}. Essayons, sans oublier
1159 d'ajouter le contexte @code{Staff}. Vous remarquerez que, en plus de
1160 cette valeur, nous ajoutons @code{#'#} devant la parenthèse ouvrante.
1161 Le @code{'#} est nécessaire car il fait partie intégrante de la valeur
1162 contenant un vecteur, et le premier @code{#} est là, comme toujours avec
1163 la commande @code{\override}, pour introduire la valeur elle-même.
1165 @cindex BarLine, exemple de dérogation
1166 @cindex break-visibility exemple d'utilisation de la propriété
1168 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1171 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1173 g,8 a16 b8 c d4 e16 |
1178 Comme on peut le constater, cette solution-là aussi supprime les barres
1182 @subheading transparence
1184 @cindex transparent, propriété
1185 @cindex transparence
1187 La RPI mentionne, à la page sur @code{grob-interface}, que la propriété
1188 @code{transparent} attend comme argument un booléen. Il faudrait donc
1189 mettre @code{#t} pour rendre l'objet transparent. Dans cet exemple,
1190 essayons de rendre transparente la métrique (@emph{time signature} en
1191 anglais) plutôt que les barres de mesure. Pour cela, il nous faut
1192 trouver le nom du @emph{grob} chargé de l'indication de mesure. De
1193 retour sur la page @qq{Tous les objets de rendu} de la RPI, nous
1194 cherchons les propriétés de l'objet @code{TimeSignature}. Celui-ci est
1195 géré par le graveur @code{Time_signature_engraver} qui, comme vous
1196 pouvez le constater, appartient au contexte @code{Staff} et peut se
1197 rattacher à la @code{grob-interface}. Dans ces conditions, la commande
1198 pour rendre la métrique transparente est@tie{}:
1200 @cindex TimeSignature, exemple de dérogation
1201 @cindex transparent, exemple d'utilisation de la propriété
1203 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1206 \override Staff.TimeSignature #'transparent = ##t
1208 g,8 a16 b8 c d4 e16 |
1214 La métrique a bien disparu mais la commande a laissé un blanc en lieu et
1215 place du chiffrage. Ce peut être souhaitable dans le cadre d'un
1216 exercice, afin que les élèves aient la place pour compléter, mais dans
1217 d'autres circonstances, ce peut être gênant. Pour y remédier,
1218 attribuons plutôt au stencil des métriques la valeur @code{#f}@tie{}:
1220 @cindex TimeSignature, exemple de dérogation
1221 @cindex stencil, exemple d'utilisation de la propriété
1223 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1226 \override Staff.TimeSignature #'stencil = ##f
1228 g,8 a16 b8 c d4 e16 |
1234 La différence est flagrante@tie{}: le fait d'attribuer au stencil la
1235 valeur @code{#f} supprime totalement l'objet, tandis que le fait de le
1236 rendre @code{transparent} le laisse en place, mais de façon invisible.
1241 @cindex color, propriété
1243 Essayons enfin de rendre les barres de mesure invisibles en les colorant
1244 en blanc. La difficulté est de savoir si les barres blanches vont
1245 couper ou non les lignes de la portée aux endroits où elles se
1246 croisent. Vous verrez dans les exemples ci-dessous que cela peut se
1247 produire, sans qu'on le sache à l'avance. Les explications de ce
1248 phénomène et les solutions pour y remédier sont exposées dans
1249 @ruser{Blanchiment des objets}. Pour le moment, acceptons cet
1250 inconvénient et concentrons-nous sur l'apprentissage de la gestion des
1253 La @code{grob-interface} indique que la valeur de la propriété
1254 @code{color} est une liste, sans plus d'explication. En fait, cette
1255 liste est une liste de valeurs en unités internes@tie{}; pour éviter
1256 d'avoir à chercher ce qu'il faut y mettre, il existe différents moyens
1257 d'indiquer la couleur. Le premier moyen consiste à utiliser l'une des
1258 couleurs @emph{normales} de la première @ruser{Liste des couleurs}.
1259 Pour mettre les barres de mesure en blanc, on écrit@tie{}:
1261 @cindex BarLine, exemple de dérogation
1262 @cindex color, exemple d'utilisation de la propriété
1264 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1267 \override Staff.BarLine #'color = #white
1269 g,8 a16 b8 c d4 e16 |
1275 et nous constatons que les barres de mesure sont une fois de plus
1276 invisibles. Attention@tie{}: aucune apostrophe ne précède @code{white}
1277 -- il ne s'agit pas d'un symbole mais d'une @strong{fonction}. Quand on
1278 l'invoque, elle fournit une liste de valeurs internes requises pour
1279 changer la couleur en blanc. Les autres couleurs aussi, dans la
1280 @qq{liste normale}, sont des fonctions. Pour en être certain, vous
1281 pouvez faire l'essai en choisissant une autre fonction de la liste en
1285 @cindex X11, couleurs
1289 Le deuxième moyen de changer la couleur consiste à utiliser la deuxième
1290 @ruser{Liste des couleurs}, dite noms de couleurs X11. Ceux-ci doivent
1291 obligatoirement être précédés d'une autre fonction, qui convertit les
1292 noms de couleurs X11 en une liste de valeurs internes, @code{x11-color},
1295 @cindex BarLine, exemple de dérogation
1296 @cindex color, exemple d'utilisation de la propriété
1298 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1301 \override Staff.BarLine #'color = #(x11-color 'white)
1303 g,8 a16 b8 c d4 e16 |
1309 Vous noterez que, dans ce cas, la fonction @code{x11-color} admet un
1310 symbole comme argument@tie{}; il faut donc placer une apostrophe devant
1311 le symbole et insérer les deux à l'intérieur de parenthèses.
1313 @cindex rgb, couleur
1314 @cindex couleurs rgb
1318 Il existe une troisième fonction, écrite pour convertir les valeurs RVB
1319 en couleurs internes -- la fonction @code{rgb-color}. Elle comporte
1320 trois arguments, donnant respectivement l'intensité du rouge, du vert et
1321 du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1.
1322 Ainsi, pour choisir la couleur rouge, la valeur serait
1323 @code{(rgb-color 1 0 0)}@tie{}; pour le blanc, ce serait
1324 @code{(rgb-color 1 1 1)}@tie{}:
1326 @cindex BarLine, exemple de dérogation
1327 @cindex color, exemple d'utilisation de la propriété
1329 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1332 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1334 g,8 a16 b8 c d4 e16 |
1339 Enfin, il existe une échelle de gris parmi les possibilités de couleurs
1340 X11. Elle va du noir (@code{'grey0}) au blanc (@code{'grey100}), avec
1341 un pas de 1. Essayons de l'utiliser en attribuant à tous les objets de
1342 notre exemple différentes nuances de gris@tie{}:
1344 @cindex StaffSymbol, exemple de dérogation
1345 @cindex TimeSignature, exemple de dérogation
1346 @cindex Clef, exemple de dérogation
1347 @cindex NoteHead, exemple de dérogation
1348 @cindex Stem, exemple de dérogation
1349 @cindex BarLine, exemple de dérogation
1350 @cindex color, exemple d'utilisation de la propriété
1351 @cindex x11-color, exemple d'utilisation
1353 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1356 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1357 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1358 \override Staff.Clef #'color = #(x11-color 'grey60)
1359 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1360 \override Voice.Stem #'color = #(x11-color 'grey85)
1361 \override Staff.BarLine #'color = #(x11-color 'grey10)
1363 g,8 a16 b8 c d4 e16 |
1369 Vous remarquerez le contexte associé à chacun des objets. Une erreur
1370 sur ce point empêcherait la commande de fonctionner. Souvenez-vous que
1371 le contexte est celui dans lequel est placé le graveur approprié. Pour
1372 chaque graveur, on peut trouver son contexte par défaut en partant de
1373 l'objet lui-même, puis en cherchant le graveur qui le produit@tie{}; la
1374 page du graveur dans la RPI nous indique alors le contexte dans lequel
1375 le graveur se trouve normalement.
1378 @node Taille des objets
1379 @subsection Taille des objets
1380 @translationof Size of objects
1382 @cindex modification de la taille des objets
1383 @cindex taille d'objets
1384 @cindex objets, taille
1385 @cindex objets, modification de taille
1387 Pour commencer, reprenons l'exemple qui se trouvait dans
1388 @ref{Expressions musicales imbriquées}, qui montrait comment créer une
1389 nouvelle portée temporaire, du type @rglos{ossia}.
1391 @cindex alignAboveContext, exemple d'utilisation de la propriété
1392 @cindex @code{\with}, exemple
1394 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1395 \new Staff ="main" {
1402 alignAboveContext = #"main" }
1410 Normalement, les ossias ne comportent ni clef ni indication de mesure,
1411 et elles sont imprimées légèrement plus petit que la portée principale.
1412 Nous avons déjà appris à enlever la clef et la métrique -- il suffit de
1413 régler le stencil de chacun sur @code{#f}, comme ceci@tie{}:
1415 @cindex alignAboveContext, exemple d'utilisation de la propriété
1416 @cindex @code{\with}, exemple
1417 @cindex stencil, exemple d'utilisation de la propriété
1418 @cindex Clef, exemple de dérogation
1419 @cindex TimeSignature, exemple de dérogation
1421 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1422 \new Staff ="main" {
1429 alignAboveContext = #"main"
1432 \override Staff.Clef #'stencil = ##f
1433 \override Staff.TimeSignature #'stencil = ##f
1443 La paire d'accolades ajoutée après la clause @code{\with} est nécessaire
1444 pour être sûr que les retouches (@code{\override}) ainsi que la musique
1445 qui se trouvent à l'intérieur soient bien appliquées à la portée
1448 Mais alors, quelle différence y a-t-il à modifier le contexte de portée
1449 au moyen de @code{\with} ou à modifier les stencils de la clef et de la
1450 métrique avec @code{\override}@tie{}? La principale différence est que
1451 les changements opérés dans une clause @code{\with} sont réalisés au
1452 moment où le contexte est créé et restent par la suite les valeurs
1453 @strong{par défaut} aussi longtemps que ce contexte existe, tandis que
1454 les commandes @code{\set} ou @code{\override} insérées dans la musique
1455 sont dynamiques -- elles provoquent des changements synchronisés avec un
1456 point particulier de la musique. Si les changements sont annulés ou
1457 désactivés par @code{\unset} ou @code{\revert}, les réglages reprennent
1458 leurs valeurs par défaut, c'est-à-dire celles qui ont été fixées dans la
1459 clause @code{\with}, ou, en l'absence de celle-ci, les valeurs par
1462 Certaines propriétés de contexte ne peuvent être modifiées que dans une
1463 clause @code{\with}. Il s'agit des propriétés qu'on ne peut évidemment
1464 plus changer après que le contexte a été créé. C'est le cas de
1465 @code{alignAboveContext} et de son pendant, @code{alignBelowContext}
1466 -- une fois que la portée a été créée, son alignement est décidé et cela
1467 n'aurait aucun sens de vouloir le modifier par la suite.
1469 Dans une clause @code{\with}, on peut aussi régler les valeurs par
1470 défaut des propriétés d'un objet. Il suffit d'utiliser la commande
1471 @code{\override} normale, sans s'occuper du nom de contexte
1472 puisqu'il ne fait pas de doute qu'il s'agit du contexte en cours de
1473 modification par la clause @code{\with}. Il se produirait même une
1474 erreur si le contexte était précisé.
1476 Remplaçons donc l'exemple ci-dessus par celui-ci@tie{}:
1478 @cindex alignAboveContext, exemple d'utilisation de la propriété
1479 @cindex @code{\with}, exemple
1480 @cindex Clef, exemple de dérogation
1481 @cindex TimeSignature, exemple de dérogation
1483 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1484 \new Staff ="main" {
1491 alignAboveContext = #"main"
1492 % Don't print clefs in this staff
1493 \override Clef #'stencil = ##f
1494 % Don't print time signatures in this staff
1495 \override TimeSignature #'stencil = ##f
1504 Venons-en finalement au changement de taille des objets.
1506 Certains objets sont créés comme des glyphes choisis dans une police de
1507 caractères. C'est le cas des têtes de notes, des altérations, des
1508 @emph{markup}, des clefs, des métriques, des nuances et des paroles.
1509 Pour changer leur taille, on modifie la propriété @code{font-size},
1510 comme nous le verrons rapidement. D'autres objets, comme les liaisons
1511 de phrasé ou de prolongation -- en général les objets étendus -- sont
1512 dessinés à la demande, si bien qu'aucune @code{font-size} ne leur est
1513 associée. Ces objets tirent généralement leur dimension des objets
1514 auxquels ils sont rattachés, de sorte qu'on ne doit pas avoir à les
1515 redimensionner à la main. D'autres propriétés, comme la hauteur des
1516 hampes et des barres de mesure, l'épaisseur des ligatures et d'autres
1517 lignes, et l'écartement des lignes de portée, doivent encore être
1518 modifiées de façon particulière.
1520 Si l'on revient à l'exemple d'ossia, commençons par changer la taille de
1521 police. Nous pouvons employer deux méthodes. Soit nous changeons la
1522 taille de police de chaque type d'objet avec des commandes comme
1523 celle-ci pour les têtes de notes (@code{NoteHead})@tie{}:
1526 \override NoteHead #'font-size = #-2
1529 soit nous changeons la taille de toutes les polices à la fois grâce à la
1530 propriété @code{fontSize}, en utilisant @code{\set} ou en l'insérant
1531 dans une clause @code{\with} (mais alors sans le @code{\set}).
1537 Chacune de ces méthodes réduira la taille de police de deux points par
1538 rapport à sa valeur précédente, sachant que chaque point réduit ou
1539 augmente la taille d'environ 12@tie{}%.
1541 Essayons sur l'exemple d'ossia :
1543 @cindex alignAboveContext, exemple d'utilisation de la propriété
1544 @cindex @code{\with}, exemple
1545 @cindex Clef, exemple de dérogation
1546 @cindex TimeSignature, exemple de dérogation
1547 @cindex fontSize, exemple d'utilisation de la propriété
1549 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1550 \new Staff ="main" {
1557 alignAboveContext = #"main"
1558 \override Clef #'stencil = ##f
1559 \override TimeSignature #'stencil = ##f
1560 % Reduce all font sizes by ~24%
1570 Ce n'est pas encore parfait. Les têtes de notes et les crochets sont
1571 plus petits mais, proportionnellement, les hampes sont trop longues et
1572 les lignes de la portée trop espacées. Il faut donc les réduire dans
1573 les mêmes proportions que les polices de caractères. La prochaine
1574 sous-section montrera comment faire.
1577 @node Longueur et épaisseur des objets
1578 @subsection Longueur et épaisseur des objets
1579 @translationof Length and thickness of objects
1585 @cindex taille, modification
1586 @cindex hampe, modification de longueur
1587 @cindex écartement des lignes, modification
1589 Dans LilyPond, les écartements et longueurs sont généralement mesurés en
1590 @qq{intervalles de lignes} (@emph{staff-spaces} en anglais),
1591 c'est-à-dire l'écartement qui sépare deux lignes adjacentes dans la
1592 portée -- plus rarement, il est question de demi-intervalles de lignes.
1593 Les propriétés d'épaisseur (@code{thickness}), quant à elles, sont
1594 généralement mesurées en unités d'une propriété interne appelée
1595 @qq{épaisseur de ligne} (@code{line-thickness}). Par exemple, les
1596 lignes de crescendo/decrescendo présentent par défaut une épaisseur de
1597 1@tie{}unité de @code{line-thickness}, alors que l'épaisseur d'une hampe
1598 est de 1,3. Toutefois, certaines propriétés d'épaisseur sont
1599 différentes@tie{}: par exemple, l'épaisseur des ligature --
1600 @code{beam-thickness} -- se mesure en espaces de portée.
1602 Dans ces conditions, comment ajuster les longueurs à la taille des
1603 polices de caractères@tie{}? La solution consiste à utiliser une
1604 fonction spéciale appelée @code{magstep} -- pseudo facteur de zoom --,
1605 créée précisément dans ce but. Elle comporte un argument, le changement
1606 de taille de police (#-2 dans l'exemple précédent), à partir duquel elle
1607 applique un facteur de mise à l'échelle qui réduit, ou augmente, les
1608 objets en question. Voici comment elle s'utilise@tie{}:
1610 @cindex alignAboveContext, exemple d'utilisation de la propriété
1611 @cindex @code{\with}, exemple
1612 @cindex Clef, exemple de dérogation
1613 @cindex TimeSignature, exemple de dérogation
1614 @cindex fontSize , exemple d'utilisation de la propriété
1615 @cindex StaffSymbol, exemple de dérogation
1616 @cindex magstep, exemple d'utilisation de la fonction
1617 @cindex staff-space, exemple d'utilisation de la propriété
1618 @cindex stencil, exemple d'utilisation de la propriété
1620 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1621 \new Staff ="main" {
1628 alignAboveContext = #"main"
1629 \override Clef #'stencil = ##f
1630 \override TimeSignature #'stencil = ##f
1632 % Reduce stem length and line spacing to match
1633 \override StaffSymbol #'staff-space = #(magstep -2)
1643 Puisque la longueur des hampes et plusieurs autres propriétés de
1644 longueur sont calculées par rapport à la valeur de la propriété
1645 @code{staff-space}, elles sont automatiquement mises à l'échelle. Vous
1646 remarquerez que cela n'affecte que la dimension verticale de l'ossia --
1647 la dimension horizontale étant déterminée par les objets de la portée
1648 principale de façon à rester synchronisée vis-à-vis d'elle, elle n'est
1649 pas affectée par tous ces changements de taille. Bien sûr, si l'échelle
1650 de toute la portée principale était modifiée, tout le placement
1651 horizontal s'en trouverait affecté. Il en sera question plus bas dans
1654 Voilà qui complète la création d'une ossia. Les taille et longueur de
1655 tous les objets peuvent être modifiées de manière analogue.
1657 Pour de petits changements d'échelle, comme dans l'exemple ci-dessus, il
1658 n'est généralement pas utile d'ajuster l'épaisseur des différentes
1659 lignes telles que les barres de mesure, les ligatures, les soufflets de
1660 crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet
1661 en particulier doit être ajustée, le mieux est de modifier sa propriété
1662 @code{thickness}. Nous avons vu plus haut, dans
1663 @ref{Propriétés des objets de rendu}, un exemple de modification de
1664 l'épaisseur des liaisons. L'épaisseur de tous les objets tracés
1665 (c'est-à-dire ceux qui ne proviennent pas d'une police de caractère)
1666 peut être changée de la même manière.
1669 @node Positionnement des objets
1670 @section Positionnement des objets
1671 @translationof Placement of objects
1674 * Comportement automatique::
1675 * Objets inclus dans la portée::
1676 * Objets hors de la portée::
1680 @node Comportement automatique
1681 @subsection Comportement automatique
1682 @translationof Automatic behavior
1684 @cindex objets de la portée
1685 @cindex objets extérieurs à la portée
1686 @cindex portée, objets de la
1687 @cindex portée, objets extérieurs à la
1689 Dans la notation musicale, il y a des objets qui appartiennent à la
1690 portée et d'autres qui sont placés à l'extérieur de la portée. On les
1691 appelle respectivement les @qq{objets de la portée} (@emph{within-staff
1692 objects} en anglais) et les @qq{objets extérieurs à la portée}
1693 (@emph{outside-staff objects} en anglais).
1695 Les objets de la portée sont ceux qui sont placés sur la portée
1696 -- les têtes de notes et les hampes, les altérations, etc. Leur
1697 position est généralement déterminée par la musique elle-même -- ils
1698 sont placés verticalement sur des lignes spécifiques ou sont liés à
1699 d'autres objets placés de cette manière. Normalement, les collisions
1700 entre les têtes et queues de notes et les altérations dans des accords
1701 proches sont évitées automatiquement. Comme nous le verrons rapidement,
1702 il existe des commandes et des possibilités de retouche qui permettent
1703 de modifier ce comportement automatique.
1705 Parmi les objets extérieurs à la portée, on compte des éléments comme
1706 les marques de reprise, les indications de texte ou de nuance. Dans
1707 LilyPond, la règle est de placer verticalement ces objets extérieurs à
1708 la portée le plus près possible de la portée, tout en évitant la
1709 collision avec d'autres objets. LilyPond utilise la propriété
1710 @code{outside-staff-priority} pour déterminer l'ordre selon lequel
1711 placer ces objets, de la manière suivante@tie{}:
1713 D'abord, LilyPond dresse la liste de tous les objets extérieurs à la
1714 portée. Puis ceux-ci sont classés suivant leur
1715 @code{outside-staff-priority}. Enfin, ils sont pris un par un, en
1716 commençant par les objets avec la @code{outside-staff-priority} la plus
1717 basse, et placés de façon à ne pas entrer en collision avec d'autres
1718 objets déjà placés. Cela signifie que, si deux @emph{grobs} extérieurs
1719 à la portée doivent occuper la même place, c'est celui qui a la
1720 @code{outside-staff-priority} la plus basse qui est placé le plus près
1721 de la portée. Et si deux objets ont la même
1722 @code{outside-staff-priority}, le premier rencontré sera placé au plus
1725 Dans l'exemple suivant, tous les @emph{markup} ont la même priorité,
1726 dans la mesure où rien n'est indiqué explicitement. Vous remarquerez
1727 que @code{Text3} est également positionné près de la portée, juste
1728 en-dessous de @code{Text2}.
1730 @cindex markup, exemple
1732 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1739 Les portées aussi sont positionnées, par défaut, le plus près possible
1740 les unes des autres, en ménageant tout de même une certaine séparation.
1741 Si des notes se rapprochent nettement d'une portée adjacente, elles ne
1742 forceront les portées à s'écarter que s'il y a un risque de
1745 @lilypond[quote,ragged-right,verbatim]
1748 \relative c' { c4 a, }
1751 \relative c'''' { c4 a, }
1757 @node Objets inclus dans la portée
1758 @subsection Objets inclus dans la portée
1759 @translationof Within-staff objects
1761 Nous avons vu que les commandes @code{\voiceXXX} jouent sur la
1762 direction des liaisons, des doigtés et sur toute autre chose liée à
1763 l'orientation des hampes. Ces commandes sont essentielles dans
1764 la musique polyphonique pour distinguer des lignes mélodiques
1765 entremêlées. Mais il arrive qu'on ait besoin de modifier ce
1766 comportement automatique. On peut le faire pour toutes les parties de
1767 la musique ou juste pour une note. La propriété qui contrôle ce
1768 comportement est la propriété @code{direction} de chaque objet.
1769 Expliquons d'abord ce qu'elle fait, puis nous présenterons un certain
1770 nombre de commandes déjà prêtes qui évitent, pour les modifications les
1771 plus courantes, d'avoir à encoder les retouches.
1773 Certains objets comme les traits des liaisons se recourbent tantôt
1774 vers le haut, tantôt vers le bas@tie{}; d'autres encore, comme les
1775 hampes et les crochets, peuvent se décaler vers la gauche ou vers la
1776 droite selon qu'ils pointent vers le haut ou vers le bas. Ce
1777 comportement est géré automatiquement dès lors que @code{direction} est
1785 L'exemple ci-dessous montre dans la première mesure le comportement par
1786 défaut des hampes -- celles des notes les plus hautes pointant vers le
1787 bas et celles des notes les plus basses pointant vers le haut@tie{};
1788 viennent ensuite quatre notes avec les hampes forcées vers le bas, puis
1789 quatre autres avec les hampes forcées vers le haut, et pour finir quatre
1790 notes de nouveau avec le comportement par défaut.
1792 @cindex Stem, exemple de dérogation
1793 @cindex direction, exemple d'utilisation de la propriété
1795 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1797 \override Stem #'direction = #DOWN
1799 \override Stem #'direction = #UP
1801 \revert Stem #'direction
1805 Nous utilisons ici les directions @code{DOWN} et @code{UP}. Elles
1806 correspondent respectivement aux valeurs @code{-1} et @code{+1},
1807 que l'on peut utiliser à la place. La valeur @code{0} peut aussi être
1808 utilisée dans certains cas. Elle est interprétée comme un @code{UP}
1809 pour les hampes, et comme un @qq{centré} pour d'autres objets. Il
1810 existe une direction, @code{CENTER}, qui correspond à la valeur
1813 Quoi qu'il en soit, ces retouches manuelles sont rarement utilisées car
1814 il existe des équivalents sous forme de commandes prédéfinies. Voici un
1815 tableau des plus courantes. Lorsque ce n'est pas évident, leur
1816 signification est précisée.
1818 @multitable @columnfractions .2 .2 .25 .35
1819 @headitem Bas/Gauche
1823 @item @code{\arpeggioArrowDown}
1824 @tab @code{\arpeggioArrowUp}
1825 @tab @code{\arpeggioNormal}
1826 @tab Flèche en bas, en haut, ou pas de flèche
1827 @item @code{\dotsDown}
1829 @tab @code{\dotsNeutral}
1830 @tab Déplacement des points pour éviter les lignes de portée
1831 @item @code{\dynamicDown}
1832 @tab @code{\dynamicUp}
1833 @tab @code{\dynamicNeutral}
1835 @item @code{\phrasingSlurDown}
1836 @tab @code{\phrasingSlurUp}
1837 @tab @code{\phrasingSlurNeutral}
1838 @tab Attention@tie{}: à distinguer des commandes de liaison ci-dessous
1839 @item @code{\slurDown}
1841 @tab @code{\slurNeutral}
1843 @item @code{\stemDown}
1845 @tab @code{\stemNeutral}
1847 @item @code{\textSpannerDown}
1848 @tab @code{\textSpannerUp}
1849 @tab @code{\textSpannerNeutral}
1850 @tab Le texte saisi en tant qu'extension est au-dessous/au-dessus de la portée
1851 @item @code{\tieDown}
1853 @tab @code{\tieNeutral}
1855 @item @code{\tupletDown}
1856 @tab @code{\tupletUp}
1857 @tab @code{\tupletNeutral}
1858 @tab Les nolets sont au-dessous/au-dessus des notes
1861 Attention : ces commandes prédéfinies @strong{ne doivent pas} être
1862 précédées de @code{\once}. Pour limiter l'effet à une seule note, il
1863 faut soit utiliser la commande équivalente @code{\once \override}, soit
1864 utiliser la commande prédéfinie, suivie, après la note à modifier, de la
1865 commande @code{\xxxNeutral} correspondante.
1870 @cindex doigtés, positionnement
1871 @cindex doigtés, accords
1873 Le placement des doigtés sur des notes simples peut aussi être contrôlé
1874 par la propriété @code{direction}, mais le changement de
1875 @code{direction} n'a pas d'effet sur les accords. Comme nous le
1876 verrons, il existe des commandes qui permettent de contrôler le doigté
1877 sur chaque note d'un accord, en plaçant l'indication de doigté
1878 au-dessus, en dessous, à gauche ou à droite de chaque note.
1880 Tout d'abord, voici l'effet de @code{direction} sur le doigté lié à une
1881 note simple. La première mesure montre le comportement par défaut, et
1882 les deux suivantes montrent l'effet lorsqu'on indique @code{DOWN} et
1885 @cindex doigtés, exemple de dérogation
1886 @cindex direction, exemple d'utilisation de la propriété
1888 @lilypond[quote,verbatim,relative=2]
1890 \override Fingering #'direction = #DOWN
1892 \override Fingering #'direction = #UP
1896 Le fait d'intervenir sur la propriété @code{direction} n'est sûrement
1897 pas la façon la plus simple de placer manuellement les doigtés au-dessus
1898 ou en dessous des notes@tie{}; mieux vaut utiliser @code{_} ou @code{^}
1899 devant le chiffre de doigté plutôt que @code{-}. Voici ce que donne
1900 l'exemple précédent avec cette méthode@tie{}:
1902 @cindex doigtés, exemple
1904 @lilypond[quote,verbatim,relative=2]
1910 La propriété @code{direction} ne fonctionne pas pour les accords alors
1911 que les préfixes de direction, @code{_} et @code{^}, fonctionnent. Par
1912 défaut, le doigté est placé automatiquement à la fois au-dessus et
1913 au-dessous des notes d'un accord, comme ceci@tie{}:
1915 @cindex doigtés, exemple
1917 @lilypond[quote,verbatim,relative=2]
1924 mais il est possible de forcer manuellement vers le haut ou vers le bas
1925 le placement de tous ou certains chiffres de doigté, comme ceci@tie{}:
1927 @cindex doigtés, exemple
1929 @lilypond[quote,verbatim,relative=2]
1935 On peut aller encore plus loin dans le positionnement des doigtés pour
1936 chacune des notes d'un accord grâce à la commande
1937 @code{\set@tie{}fingeringOrientations}. La syntaxe de cette commande
1941 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1945 On utilise @code{\set} car @code{fingeringOrientations} est une
1946 propriété du contexte @code{Voice}, créée et utilisée par le graveur
1947 @code{New_fingering_engraver}.
1949 On peut attribuer à cette propriété une liste composée de une à trois
1950 valeurs. Celles-ci déterminent si l'indication de doigté doit être
1951 placée au-dessus (lorsque @code{up} apparaît dans la liste), au-dessous
1952 (lorsque @code{down} apparaît), à gauche (lorsque @code{left} apparaît)
1953 ou à droite (lorsque @code{right} apparaît). En revanche, si une valeur
1954 n'est pas dans la liste, aucun doigté n'ira à cet emplacement. LilyPond
1955 garde ces contraintes en mémoire et recherche le meilleur emplacement
1956 pour le doigté des notes des accords suivants. Vous remarquerez que
1957 @code{left} et @code{right} s'excluent l'un l'autre -- l'indication de
1958 doigté ne peut être placée que d'un côté ou de l'autre, pas des deux.
1960 @warning{Pour contrôler à l'aide de cette commande le placement du
1961 doigté sur une note simple, il faut la saisir comme un accord composé
1962 d'une note unique, en l'encadrant de chevrons.}
1964 Voici quelques exemples :
1966 @cindex doigtés, exemple
1967 @cindex @code{\set}, exemple d'utilisation
1968 @cindex fingeringOrientations, exemple d'utilisation de la propriété
1970 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1971 \set fingeringOrientations = #'(left)
1974 \set fingeringOrientations = #'(left)
1976 <c-1 e-2 g-3 b-5>4 |
1977 \set fingeringOrientations = #'(up left down)
1980 \set fingeringOrientations = #'(up left)
1982 <c-1 e-2 g-3 b-5>4 |
1983 \set fingeringOrientations = #'(right)
1989 Si les indications de doigtés paraissent un peu serrées, on peut
1990 toujours réduire la taille de police (@code{font-size}). La valeur
1991 par défaut donnée dans la RPI à la page de l'objet
1992 @code{Fingering} étant @code{-5}, essayons @code{-7}@tie{}:
1994 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1995 \override Fingering #'font-size = #-7
1996 \set fingeringOrientations = #'(left)
1999 \set fingeringOrientations = #'(left)
2001 <c-1 e-2 g-3 b-5>4 |
2002 \set fingeringOrientations = #'(up left down)
2005 \set fingeringOrientations = #'(up left)
2007 <c-1 e-2 g-3 b-5>4 |
2008 \set fingeringOrientations = #'(right)
2014 @node Objets hors de la portée
2015 @subsection Objets hors de la portée
2016 @translationof Outside-staff objects
2018 Les objets extérieurs à la portée sont placés automatiquement de façon à
2019 éviter les collisions. Les objets avec la plus petite valeur de la
2020 propriété @code{outside-staff-priority} sont placés au plus près de la
2021 portée, tandis que les autres sont écartés autant qu'il faut pour éviter
2022 les collisions. La @code{outside-staff-priority} est définie dans la
2023 @code{grob-interface}@tie{}; elle est donc une propriété commune à tous
2024 les objets de rendu. Par défaut, elle est réglée sur @code{#f} pour
2025 tous les objets de la portée, et porte une valeur numérique appropriée à
2026 chacun des objets extérieurs à la portée, à mesure qu'ils sont créés.
2027 Le tableau suivant montre la valeur numérique par défaut pour
2028 quelques-uns des objets extérieurs à la portée les plus courant.
2033 Vous noterez au passage certaines particularités quant au nom des
2034 objets. En effet, des objets à extension sont automatiquement créés
2035 dans le but de pouvoir contrôler le positionnement vertical des
2036 extrémités d'un @emph{grob} qui commencerait et se terminerait à des
2037 instants musicaux différents. C'est la raison pour laquelle modifier le
2038 @code{outside-staff-priority} du @emph{grob} sous-jacent n'aura aucun
2039 effet. C'est par exemple le cas lorsque vous modifiez l'alignement d'un
2040 objet @code{Hairpin} à l'aide de @code{outside-staff-priority}@tie{};
2041 puisque le soufflet est associé à un objet @code{DynamicLineSpanner},
2042 c'est sur celui-ci que doit porter l'effet de
2043 @code{outside-staff-priority}. L'instruction dérogatoire se place au
2044 début du bandeau qui constitue une ligne de base susceptible de contenir
2045 plusieurs soufflets ou indications de nuance.
2047 @multitable @columnfractions .3 .3 .3
2048 @headitem Objet de rendu
2050 @tab Contrôle la position de :
2051 @item @code{RehearsalMark}
2054 @item @code{MetronomeMark}
2056 @tab Indication métronomique
2057 @item @code{VoltaBracketSpanner}
2059 @tab Bandeau de répétition
2060 @item @code{TextScript}
2062 @tab Texte des @emph{markup} (ou étiquettes)
2063 @item @code{MultiMeasureRestText}
2065 @tab Texte sur les silences qui couvrent des mesures entières
2066 @item @code{OttavaBracket}
2068 @tab Indication d'octaviation
2069 @item @code{TextSpanner}
2071 @tab Bandeau ou extension de texte
2072 @item @code{DynamicLineSpanner}
2074 @tab Toutes les marques de nuances
2075 @item @code{BarNumber}
2077 @tab Numéro de mesure
2078 @item @code{TrillSpanner}
2080 @tab Bandeau de trille
2083 Voici un exemple qui montre le placement par défaut de certains
2086 @cindex extension de texte
2087 @cindex indication d'octaviation
2089 @funindex \startTextSpan
2090 @funindex startTextSpan
2091 @funindex \stopTextSpan
2092 @funindex stopTextSpan
2094 @cindex TextSpanner, exemple de dérogation
2095 @cindex bound-details, exemple d'utilisation de la propriété
2097 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2098 % Set details for later Text Spanner
2099 \override TextSpanner #'(bound-details left text)
2100 = \markup { \small \bold Slower }
2101 % Place dynamics above staff
2103 % Start Ottava Bracket
2106 % Add Dynamic Text and hairpin
2112 % Add Dynamic Text and terminate hairpin
2113 c4\ff c \stopTextSpan |
2114 % Stop Ottava Bracket
2119 Cet exemple montre comment créer des extensions de texte (@emph{Text
2120 Spanners} en anglais) -- texte avec des longues lignes au-dessus d'un
2121 passage musical. L'extension s'étend depuis la commande
2122 @code{\startTextSpan} jusqu'à la commande @code{\stopTextSpan} et le
2123 format de texte est défini par la commande @code{\override TextSpanner}.
2124 Pour de plus amples détails, voir
2125 @ruser{Indication textuelle avec extension}.
2127 Il montre aussi comment créer des marques d'octaviation.
2129 @cindex modification du positionnement des numéros de mesure
2130 @cindex numéros de mesure, modification du positionnement
2131 @cindex modification du positionnement des indications métronomiques
2132 @cindex indications métronomiques, modification du positionnement
2133 @cindex modification du positionnement des marques de repère
2134 @cindex marques de repère, modification du positionnement
2136 Si les valeurs de @code{outside-staff-priority} par défaut ne donnent
2137 pas les résultats escomptés, il suffit de modifier la priorité
2138 de l'un de ces objets. Supposons que vous vouliez placer l'indication
2139 d'octaviation sous le bandeau de texte, dans l'exemple précédent. Tout
2140 ce que nous devons faire, c'est regarder la priorité de
2141 @code{OttavaBracket} dans la Référence des propriétés internes ou dans
2142 le tableau plus haut, et la ramener à une valeur plus basse que celle de
2143 @code{TextSpanner}, en gardant à l'esprit que @code{OttavaBracket} est
2144 créé dans le contexte @code{Staff}@tie{}:
2146 @cindex TextSpanner, exemple de dérogation
2147 @cindex bound-details, exemple d'utilisation de la propriété
2149 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2150 % Set details for later Text Spanner
2151 \override TextSpanner #'(bound-details left text)
2152 = \markup { \small \bold Slower }
2153 % Place dynamics above staff
2155 % Place following Ottava Bracket below Text Spanners
2156 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2157 % Start Ottava Bracket
2162 % Add Dynamic Line Spanner
2168 c4\ff c \stopTextSpan |
2169 % Stop Ottava Bracket
2174 N'oublions pas que certains objets, tels les numéros de mesure,
2175 indications métronomiques et marques-repères, sont par défaut attachés
2176 au contexte @code{Score}.
2178 @cindex liaisons et outside-staff-priority
2179 @cindex liaisons et articulations
2180 @cindex articulations et liaisons
2182 Les liaisons sont intrinsèquement des objets membres de la portée
2183 (@emph{within-staff objects}) bien qu'elles la surplombent lorsque les
2184 notes auxquelles elles se rattachent sont relativement hautes. Ceci
2185 peut avoir pour conséquence de remonter d'autant les objets externes
2186 (@emph{outside-staff objects}) tels les articulations. La propriété
2187 @code{avoid-slur} de l'articulation en question peut se voir déterminée
2188 à @code{'inside} dans le but de @qq{ramener} cette articulation à
2189 l'intérieur de la liaison. Cette propriété @code{avoid-slur} ne sera
2190 toutefois effective que dans la mesure où la
2191 @code{outside-staff-priority} est désactivée (valeur @code{#f}). Dans
2192 le même esprit, il est possible d'affecter une valeur numérique
2193 particulière à la propriété @code{outside-staff-priority} d'une
2194 liaison dans le but de regrouper la liaison avec les objets externes.
2195 L'exemple suivant illustre ces deux différentes méthodes.
2197 @lilypond[quote,verbatim,relative=2]
2198 c4( c^\markup { \tiny \sharp } d4.) c8 |
2200 \once \override TextScript #'avoid-slur = #'inside
2201 \once \override TextScript #'outside-staff-priority = ##f
2202 c4^\markup { \tiny \sharp } d4.) c8 |
2203 \once \override Slur #'outside-staff-priority = #500
2204 c4( c^\markup { \tiny \sharp } d4.) c8 |
2207 Le fait de changer la @code{outside-staff-priority} peut aussi servir à
2208 contrôler le positionnement vertical des objets individuels, quoique le
2209 résultat ne soit pas toujours formidable. Imaginons que nous voulions
2210 placer @qq{Text3} au-dessus de @qq{Text4} dans l'exemple de la section
2211 @ref{Comportement automatique}, plus haut. Il nous suffit pour cela de
2212 regarder dans la Référence des propriétés internes ou dans le tableau
2213 plus haut la priorité de @code{TextScript}, et d'augmenter la priorité
2214 de @qq{Text3} jusqu'à une valeur très haute@tie{}:
2216 @cindex TextScript, exemple de dérogation
2217 @cindex outside-staff-priority, exemple d'utilisation de la propriété
2219 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2222 \once \override TextScript #'outside-staff-priority = #500
2227 S'il est vrai que cela place @qq{Text3} au-dessus de @qq{Text4}, ça le
2228 place aussi plus haut que @qq{Text2} tandis que @qq{Text4} dégringole.
2229 Ce n'est peut-être pas si bien que ça. En fait, ce que nous aimerions
2230 faire, c'est placer toutes les annotations à égale distance de la
2231 portée. Pour cela, nous avons besoin d'espacer horizontalement les
2232 notes pour laisser plus de place au texte. C'est possible grâce à la
2233 commande @code{textLengthOn}.
2236 @subheading \textLengthOn
2238 @cindex notes, répartition selon le texte
2240 @funindex \textLengthOn
2241 @funindex textLengthOn
2242 @funindex \textLengthOff
2243 @funindex textLengthOff
2245 Par défaut, l'espacement horizontal d'un texte produit sous forme de
2246 @emph{markup} (ou d'étiquette) n'est pas pris en compte, dans la mesure
2247 où ce qui est concerné n'entre pas dans la musique. La commande
2248 @code{\textLengthOn} inverse ce comportement, faisant en sorte que les
2249 notes soient espacées autant qu'il le faut pour s'adapter au
2252 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2253 \textLengthOn % Cause notes to space out to accommodate text
2260 La commande qui permet de revenir au comportement par défaut est
2261 @code{\textLengthOff}. Rappelez-vous que @code{\once} ne
2262 fonctionne qu'avec @code{\override}, @code{\set}, @code{\revert} ou
2263 @code{\unset}, et donc ne peut pas être utilisé avec
2264 @code{\textLengthOn}.
2266 @cindex étiquette de texte et collision
2268 Les textes des @emph{markup} éviteront également les notes qui
2269 s'échappent au-dessus de la portée. Si ce n'est pas notre souhait, il
2270 est possible de supprimer ce déplacement automatique vers le haut en
2271 attribuant à la priorité la valeur @code{#f}. Voici un exemple qui
2272 montre comment les textes des @emph{markup} interagissent avec ces types
2275 @cindex TextScript, exemple de dérogation
2276 @cindex outside-staff-priority, exemple d'utilisation de la propriété
2278 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2279 % This markup is short enough to fit without collision
2283 % This is too long to fit, so it is displaced upwards
2287 % Turn off collision avoidance
2288 \once \override TextScript #'outside-staff-priority = ##f
2289 c,,2^"Long Text " c'' |
2292 % Turn off collision avoidance
2293 \once \override TextScript #'outside-staff-priority = ##f
2294 \textLengthOn % and turn on textLengthOn
2295 c,,2^"Long Text " % Spaces at end are honored
2302 @cindex modification du positionnement des nuances
2303 @cindex nuances, modification du positionnement
2305 Les indications de nuance se placent normalement sous la portée, mais on
2306 peut les placer au-dessus avec la commande @code{dynamicUp}. Elles se
2307 positionnent verticalement par rapport à la note à laquelle elles sont
2308 liées et se décalent vers le bas (ou le haut) en fonction des objets de
2309 la portée comme les liaisons de phrasé ou les numéros de mesure. Cela
2310 peut donner d'assez bons résultats, comme le montre cet exemple@tie{}:
2312 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2317 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2318 ees,2.~\)\mf ees4 r8 |
2321 De toute façon, si les notes et les nuances qui leur sont liées sont
2322 trop proches, le positionnement automatique évitera les collisions en
2323 déplaçant davantage les nuances suivantes, mais le résultat peut ne
2324 pas être très satisfaisant, comme le montre cet exemple
2327 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2333 Si une telle situation devait survenir dans de la musique @qq{réelle},
2334 il serait préférable d'espacer un peu plus les notes, de façon que les
2335 indications de nuance puissent toutes se situer à la même distance de la
2336 portée. S'il est possible de faire cela pour les textes de
2337 @emph{markup} grâce à la commande @code{\textLengthOn}, il n'existe
2338 pas d'équivalent pour les indications de nuance. Il nous faut donc
2339 chercher à faire cela avec la commande @code{\override}.
2342 @subheading Dimensionnement des objets graphiques
2344 @cindex grob, dimensionnement
2345 @cindex dimensionnement des grobs
2347 Tout d'abord, nous devons apprendre ce qui détermine la dimension des
2348 @emph{grobs}. Tous les @emph{grobs} portent en eux un point de référence
2349 qui est utilisé pour les positionner par rapport à leur objet parent. Ce
2350 point du @emph{grob} est placé à une distance horizontale,
2351 @code{X-offset}, et à une distance verticale, @code{Y-offset}, de son
2352 parent. L'étendue horizontale de l'objet est fixée par une paire de
2353 nombres, @code{X-extent}, qui donnent la position du coin
2354 gauche et du coin droit par rapport au point de référence. De
2355 même, l'amplitude verticale est fixée par une paire de nombres,
2356 @code{Y-extent}. Ce sont des propriétés communes à tous les
2357 @emph{grobs} et que gère la @code{grob-interface}.
2359 @cindex @code{extra-spacing-width}
2361 Par défaut, la largeur des objets extérieurs à la portée est donnée
2362 comme étant nulle, si bien qu'ils peuvent se chevaucher
2363 horizontalement. Pour remédier à cela, on a ajouté l'infini à
2364 l'extension gauche et moins l'infini à l'extension droite, en
2365 attribuant à @code{extra-spacing-width} la valeur
2366 @code{'(+inf.0@tie{}.@tie{}-inf.0)}. Pour être sûr que les objets ne se
2367 chevaucheront pas horizontalement, nous devons donc corriger cette
2368 valeur de @code{extra-spacing-width} en @w{@code{'(0 . 0)}}, afin que
2369 leur vraie largeur se manifeste. La commande pour y parvenir avec des
2370 indications de nuances est@tie{}:
2373 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2377 Voyons si ça marche sur notre exemple précédent@tie{}:
2379 @cindex DynamicText, exemple de dérogation
2380 @cindex extra-spacing-width, exemple d'utilisation de la propriété
2382 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2384 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2385 a4\f b\mf c\mp b\p |
2389 Bon, cela a mis un terme aux déplacements verticaux des
2390 nuances mais il reste deux problèmes. Il faudrait que les
2391 nuances soient un peu plus écartées et ce serait mieux si
2392 elles étaient toutes à la même distance de la portée. Le
2393 premier problème est simple à résoudre. Au lieu d'attribuer
2394 à @code{extra-spacing-width} la valeur zéro, nous pourrions
2395 mettre un peu plus. L'unité est la distance entre deux lignes
2396 de portée, donc en écartant le bord gauche d'une demi-unité
2397 et le bord droit d'une demi-unité, on obtient@tie{}:
2399 @cindex DynamicText, exemple de dérogation
2400 @cindex extra-spacing-width, exemple d'utilisation de la propriété
2402 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2404 % Extend width by 1 staff space
2405 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2410 C'est mieux mais nous voulons peut-être aligner les indications de
2411 nuance sur une même ligne plutôt que de les voir monter et
2412 descendre avec les notes. La propriété qui gère cela est
2413 @code{staff-padding}@tie{}; la section suivante lui est consacrée.
2416 @node Collisions d'objets
2417 @section Collisions d'objets
2418 @translationof Collisions of objects
2421 * Déplacement d'objets::
2422 * Correction des collisions d'objets::
2427 @node Déplacement d'objets
2428 @subsection Déplacement d'objets
2429 @translationof Moving objects
2431 @cindex déplacement d'objets se chevauchant
2432 @cindex déplacement d'objets en collision
2433 @cindex déplacement de grobs en collision
2434 @cindex objets, évitement des collisions
2435 @cindex grobs, évitement des collisions
2437 Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
2438 Certains éléments sur la partition peuvent se chevaucher, ce qui est
2439 regrettable mais, le plus souvent, facile à corriger. En général, quand
2440 on déplace des objets, c'est pour des raisons de lisibilité ou
2441 d'esthétique -- ils rendraient mieux avec un peu plus ou un peu moins
2442 d'espace autour d'eux.
2444 Il y a trois façons de résoudre les problèmes de chevauchement. Il est
2445 préférable de les aborder dans l'ordre suivant@tie{}:
2449 L'@strong{orientation} d'un objet qui en chevauche un autre peut être
2450 changée grâce aux commandes prédéfinies dont la liste a été donnée
2451 plus haut à propos des objets de portée (voir
2452 @ref{Objets inclus dans la portée}).
2453 Les queues de note, les liaisons de phrasé et de prolongation, les
2454 crochets, les nuances et les nolets peuvent facilement être
2455 repositionnés de cette manière. En contrepartie, vous n'avez le choix
2456 qu'entre deux positions, sans personnalisation possible.
2459 Les @strong{propriétés d'objet}, auxquelles LilyPond a recours pour
2460 positionner les objets, sont modifiables avec @code{\override}. Il y a
2461 deux avantages à changer ces propriétés@tie{}: (a) d'autres objets
2462 pourront être déplacés automatiquement si nécessaire pour faire de la
2463 place, et (b) la même retouche peut s'appliquer à toutes les occurrences
2464 du même type d'objet. Ces propriétés sont@tie{}:
2471 Ce point a déjà été traité en détails -- voir
2472 @ref{Objets inclus dans la portée}.
2476 @code{padding}, @code{right-padding}, @code{staff-padding}
2478 @cindex décalage (padding)
2479 @cindex padding, propriété
2480 @cindex right-padding, propriété
2481 @cindex staff-padding, propriété
2483 Au moment de positionner un objet, la valeur de sa propriété
2484 @code{padding} détermine l'espace à laisser libre entre celui-ci et le
2485 coin le plus proche de l'objet à côté duquel il est placé. Vous
2486 remarquerez que c'est la valeur @code{padding} de l'objet @strong{à
2487 placer} qui compte@tie{}; la valeur @code{padding} de l'objet déjà placé
2488 est ignorée. Les espaces libres déterminés par @code{padding}
2489 s'appliquent à tous les objets associés à la
2490 @code{side-position-interface}.
2492 Le positionnement de groupes d'altérations est contrôlé par
2493 @code{right-padding}, et non plus @code{padding}. Cette propriété
2494 appartient à l'objet @code{AccidentalPlacement} qui, vous le
2495 remarquerez, prend place dans le contexte @strong{Staff}. Dans le
2496 processus de composition, les têtes de notes sont disposées en premier,
2497 puis les altérations, s'il y en a, sont ajoutées à gauche des têtes de
2498 note suivant la propriété @code{right-padding} qui détermine
2499 l'espacement par rapport aux têtes de note. C'est pourquoi seule la
2500 propriété @code{right-padding} de l'objet @code{AccidentalPlacement}
2501 joue sur le positionnement des altérations.
2503 La propriété @code{staff-padding} est très proche de la propriété
2504 @code{padding}@tie{}: @code{padding} contrôle l'espace minimum entre un
2505 objet qui accepte la @code{side-position-interface} et l'objet le plus
2506 proche (généralement une note ou une ligne de portée)@tie{};
2507 @code{staff-padding} ne s'applique qu'aux objets qui sont toujours
2508 placés en-dehors de la portée -- il contrôle l'espace minimum à insérer
2509 entre l'objet et la portée. Attention@tie{}: par défaut,
2510 @code{staff-padding} concerne les objets positionnés par rapport
2511 à la portée et n'a aucun effet sur les objets qui sont positionnés par
2512 rapport à une note@tie{}; il est toutefois possible de le régler pour
2513 fonctionner avec ces derniers.
2515 Pour trouver quelle propriété @code{padding} employer pour l'objet que
2516 vous cherchez à repositionner, il vous faut consulter les propriétés de
2517 l'objet dans la RPI. Prenez garde que les propriétés @code{padding} ne
2518 sont pas forcément traitées dans l'objet en question@tie{}; il faut
2519 alors regarder les objets qui semblent s'en rapprocher.
2521 Toutes les valeurs @code{padding} sont exprimées en espace de portée.
2522 Pour la plupart des objets, la valeur par défaut est aux alentours de
2523 1,0 et parfois moins (cela dépend de chaque objet). Il est possible de
2524 la modifier lorsqu'on a besoin d'un espace vide plus grand (ou plus
2529 @code{self-alignment-X}
2531 @cindex self-alignment-X, propriété
2533 Cette propriété sert à aligner les objets sur la gauche, sur la droite
2534 ou à les centrer par rapport au point de référence des objets parents.
2535 Elle peut être utilisée avec tous les objets qui acceptent la
2536 @code{self-alignment-interface}. Il s'agit, en général, des objets qui
2537 contiennent du texte. Les valeurs admises sont @code{LEFT},
2538 @code{RIGHT} et @code{CENTER}. On peut aussi attribuer à
2539 la place une valeur numérique entre @code{-1} et @code{+1},
2540 où @code{-1} signifie alignement sur la gauche, @code{+1}
2541 alignement sur la droite, et les nombres intermédiaires déplacent
2542 progressivement le texte de la gauche vers la droite. Des valeurs
2543 numériques supérieures à @code{1} sont également admises
2544 pour déplacer le texte encore plus loin vers la gauche, ou des
2545 valeurs inférieures à @code{-1} pour déplacer le texte encore
2546 plus loin vers la droite. Un écart de @code{1} en valeur
2547 correspond à un déplacement de la moitié de la longueur du
2552 @code{extra-spacing-width}
2554 @cindex extra-spacing-width, propriété
2556 Cette propriété est utilisée pour tous les objets qui acceptent la
2557 @code{item-interface}. Elle reçoit deux nombres, le premier étant
2558 ajouté au bord gauche et le second au bord droit. Des nombres
2559 négatifs déplacent le coin vers la gauche, des nombres positifs
2560 vers la droite, si bien que pour élargir un objet, le premier nombre
2561 doit être négatif et le second positif. Attention@tie{}: tous les
2562 objets n'acceptent pas forcément les deux nombres. Par exemple, l'objet
2563 @code{Accidental} ne retient que le premier nombre (coin gauche).
2567 @code{staff-position}
2569 @cindex staff-position, propriété
2571 @code{staff-position} est une propriété de la
2572 @code{staff-symbol-referencer-interface}, qui s'applique aux objets
2573 positionnés par rapport à la portée. Elle indique, en demi-espace de
2574 portée, la position verticale des objets par rapport à la ligne médiane
2575 de la portée. C'est bien pratique pour résoudre des problèmes de
2576 collision entre des objets comme les silences valant mesure entière,
2577 les liaisons et les notes de différentes voix.
2583 @cindex force-hshift, propriété
2585 Des notes très proches dans un accord, ou des notes simultanées dans
2586 différentes voix, peuvent être disposées sur deux colonnes, rarement
2587 plus, pour éviter que les têtes de notes ne se chevauchent. On parle
2588 alors de colonnes (ou empilement) de notes et un objet appelé
2589 @code{NoteColumn} est créé pour placer les notes sur la colonne.
2591 La propriété @code{force-hshift} appartient à @code{NoteColumn} (en
2592 réalité à la @code{note-column-interface}). Le fait de la modifier
2593 permet de déplacer un empilement selon l'unité appropriée aux colonnes
2594 de notes, à savoir la largeur des têtes de note de la première voix.
2595 Son utilisation est réservée à des situations complexes dans lesquelles
2596 les commandes habituelles @code{\shiftOn}
2597 (voir @ref{Instanciation explicite des voix}) ne suffisent plus à
2598 résoudre les conflits. Elle est alors préférable à l'utilisation de la
2599 propriété @code{extra-offset}, dans la mesure où on n'a pas besoin
2600 d'exprimer la distance en espace de portée et où le fait de déplacer
2601 les notes à l'intérieur ou à l'extérieur d'une @code{NoteColumn} affecte
2602 d'autres actions comme les fusions de notes.
2608 Pour terminer, quand toutes les autres méthodes ont échoué, il est
2609 possible de repositionner verticalement les objets à la main par rapport
2610 à la ligne médiane de la portée, ou en les déplaçant à une distance
2611 donnée vers une nouvelle position. Les inconvénients sont qu'il faut
2612 individuellement, pour chaque objet, trouver les valeurs correctes de
2613 repositionnement souvent par tâtonnement et que, puisque le
2614 mouvement est opéré après que LilyPond a placé tous les autres
2615 objets, c'est à l'utilisateur de résoudre tous les problèmes de
2616 collision qui pourraient survenir. Et le pire avec cette méthode est
2617 que, le jour où la musique est modifiée, il faut de nouveau rechercher
2618 les valeurs de repositionnement. Les propriétés à utiliser pour ce type
2619 de repositionnement manuel sont@tie{}:
2625 @cindex extra-offset, propriété
2627 Cette propriété s'applique à tout objet acceptant la
2628 @code{grob-interface}. Elle reçoit une paire de nombres qui indiquent
2629 le déplacement supplémentaire dans le sens horizontal et vertical. Des
2630 nombres négatifs déplacent l'objet vers la gauche ou vers la droite.
2631 L'unité utilisée est l'espace de portée. Le déplacement supplémentaire
2632 intervient une fois que la composition des objets est achevée, si bien
2633 qu'un objet peut être repositionné à n'importe quel endroit sans
2634 perturber quoi que ce soit.
2638 @cindex positions, propriété
2640 Cette propriété est très utile pour ajuster manuellement l'inclinaison
2641 et la hauteur des barres de ligature, des liaisons et des nolets. Elle
2642 est suivie de deux nombres qui donnent la position des extrémités gauche
2643 et droite des barres, liaisons, etc. par rapport à la ligne médiane de
2644 la portée. L'unité de référence est l'intervalle de lignes de portée.
2645 Attention toutefois au fait que les liaisons et phrasés ne peuvent pas
2646 être repositionnés n'importe où. LilyPond commence par dresser la liste
2647 des emplacements possibles pour les liaisons et choisit par défaut la
2648 liaison qui @qq{semble la meilleure}. Si la propriété @code{positions}
2649 a été retouchée, la liaison la plus proche de la position demandée sera
2650 retenue dans la liste.
2655 Il est possible qu'un objet ne dispose pas de toutes ces propriétés. Il
2656 est donc nécessaire de consulter la RPI pour vérifier quelles sont les
2657 propriétés disponibles pour l'objet en question.
2659 Voici une liste d'objets les plus couramment impliqués dans les
2660 collisions, avec le nom de l'objet à consulter dans la RPI afin de
2661 trouver les propriétés à retoucher pour obtenir un déplacement.
2664 @multitable @columnfractions .5 .5
2665 @headitem Type d'objet @tab Nom d'objet
2666 @item Articulations @tab @code{Script}
2667 @item Barres de ligature @tab @code{Beam}
2668 @item Doigté @tab @code{Fingering}
2669 @item Liaisons de phrasé @tab @code{Slur}
2670 @item Liaisons de prolongation @tab @code{Tie}
2671 @item Nolets @tab @code{TupletBracket}
2672 @item Nuances (verticalement) @tab @code{DynamicLineSpanner}
2673 @item Nuances (horizontalement) @tab @code{DynamicText}
2674 @item Reprises / marques de texte @tab @code{RehearsalMark}
2675 @item Texte, p.ex. @code{^"texte"} @tab @code{TextScript}
2679 @node Correction des collisions d'objets
2680 @subsection Correction des collisions d'objets
2681 @translationof Fixing overlapping notation
2683 Voyons maintenant comment les propriétés décrites dans la section
2684 précédente peuvent nous aider à résoudre les collisions.
2687 @subheading la propriété padding
2689 @cindex décalage (padding)
2690 @cindex résolution des chevauchements de notation
2691 @cindex chevauchement de notation
2693 En jouant sur la propriété @code{padding} (littéralement
2694 @qq{rembourrage}), on augmente (ou on diminue) la distance entre
2695 des symboles qui sont imprimés au-dessus ou en dessous des notes.
2697 @cindex Script, exemple de dérogation
2698 @cindex padding, exemple d'utilisation de la propriété
2700 @lilypond[quote,fragment,relative=1,verbatim]
2702 \override Script #'padding = #3
2706 @cindex MetronomeMark, exemple de dérogation
2707 @cindex padding, exemple d'utilisation de la propriété
2709 @lilypond[quote,fragment,relative=1,verbatim]
2710 % This will not work, see below:
2711 \override MetronomeMark #'padding = #3
2715 \override Score.MetronomeMark #'padding = #3
2720 Vous remarquerez dans le second exemple à quel point il est important de
2721 préciser le nom du contexte qui contient l'objet. Puisque l'objet
2722 @code{MetronomeMark} appartient au contexte @code{Score}, le fait de
2723 modifier la propriété dans le contexte @code{Voice} passera inaperçu.
2724 Pour plus de détails, voir @ruser{Modification de propriétés}.
2726 Si on augmente la propriété @code{padding} d'un objet alors que celui-ci
2727 fait partie d'un ensemble d'objets positionnés en fonction de leur
2728 @code{outside-staff-priority}, cet objet sera déplacé, ainsi que tous
2729 les autres objets du groupe.
2732 @subheading right-padding
2734 @cindex right-padding, propriété
2736 La propriété @code{right-padding} joue sur l'espacement entre une
2737 altération et la note sur laquelle elle porte. On ne l'utilise pas
2738 souvent, mais l'espacement par défaut peut se révéler inadéquat avec
2739 certaines altérations ou certains glyphes utilisés en musique
2740 microtonale. Le stencil de l'altération devra alors être construit sous
2741 la forme d'un @code{markup} qui contiendra le ou les symboles requis,
2744 @cindex Accidental, exemple de dérogation
2745 @cindex text, exemple d'utilisation de la propriété
2746 @cindex stencil, exemple d'utilisation de la propriété
2747 @cindex AccidentalPlacement, exemple de dérogation
2748 @cindex right-padding, exemple d'utilisation de la propriété
2750 @lilypond[quote,ragged-right,verbatim]
2751 sesquisharp = \markup { \sesquisharp }
2754 % This prints a sesquisharp but the spacing is too small
2755 \once \override Accidental
2756 #'stencil = #ly:text-interface::print
2757 \once \override Accidental #'text = #sesquisharp
2759 % This improves the spacing
2760 \once \override Score.AccidentalPlacement #'right-padding = #0.6
2761 \once \override Accidental
2762 #'stencil = #ly:text-interface::print
2763 \once \override Accidental #'text = #sesquisharp
2769 Cette méthode utilise, pour le stencil des altérations, une retouche
2770 qui ne sera pas reprise par la suite. Le type de stencil est
2771 obligatoirement une procédure, qui consiste ici à imprimer le contenu de
2772 la propriété @code{text} de @code{Accidental}, déclaré comme étant un
2773 signe sesqui-dièse. Celui-ci est ensuite repoussé devant la tête de
2774 note par la retouche de @code{right-padding}.
2779 @subheading la propriété staff-padding
2781 @cindex alignement d'objets sur une ligne de base
2782 @cindex objets, alignement sur une ligne de base
2784 @code{staff-padding} sert à aligner des objets tels que des nuances
2785 sur une ligne fictive à une hauteur donnée par rapport à la portée
2786 plutôt qu'à une hauteur qui varie en fonction de la position de la note
2787 sur laquelle porte l'objet. Ce n'est pas une propriété de
2788 @code{DynamicText} mais de @code{DynamicLineSpanner}, car la ligne
2789 fictive est destinée à s'appliquer autant à @strong{toutes} les nuances,
2790 notamment celles qui sont créées comme des bandeaux en longueur (en
2791 anglais @emph{Spanners}). Tel est donc le moyen d'aligner les
2792 indications de nuance, comme dans cet exemple repris de la section
2795 @cindex DynamicText, exemple de dérogation
2796 @cindex extra-spacing-width, exemple d'utilisation de la propriété
2797 @cindex DynamicLineSpanner, exemple de dérogation
2798 @cindex staff-padding, exemple d'utilisation de la propriété
2800 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2802 % Extend width by 1 unit
2803 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2804 % Align dynamics to a base line 2 units above staff
2805 \override DynamicLineSpanner #'staff-padding = #2
2810 @subheading la propriété self-alignment-X
2812 L'exemple suivant montre comment résoudre une collision entre une
2813 indication de corde et une hampe, en alignant le coin droit sur le point
2814 de référence de la note parente@tie{}:
2816 @cindex StringNumber, exemple de dérogation
2817 @cindex self-alignment-X, exemple d'utilisation de la propriété
2819 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2822 \once \override StringNumber #'self-alignment-X = #RIGHT
2827 @subheading la propriété staff-position
2829 @cindex collision d'objets à l'intérieur d'une portée
2831 Dans une voix, un silence valant une mesure entière peut chevaucher les
2832 notes d'une autre voix. Vu que ces silences sont centrés entre les deux
2833 barres de mesure, il serait très compliqué de programmer LilyPond pour
2834 repérer ces risques de collision dans la mesure où, normalement, toutes
2835 les collisions entre notes ou entre notes et silences se produisent sur
2836 des notes et silences simultanés. Voici un exemple de collision de ce
2839 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2840 << { c4 c c c } \\ { R1 } >>
2843 Ici, la meilleure solution consiste à déplacer le symbole de pause vers
2844 le bas -- puisque cette pause appartient à la voix deux. Par défaut,
2845 dans la @code{\voiceTwo} (c'est-à-dire dans la seconde voix d'une
2846 construction @code{<<@{@dots{}@}@tie{}\\@tie{}@{@dots{}@}>>}), la
2847 propriété @code{staff-position} est réglée sur @code{-4} pour les
2848 @code{MultiMeasureRest}@tie{}; nous avons donc besoin de la déplacer,
2849 disons, de quatre demi-intervalles vers le bas, ce qui donne @code{-8}.
2851 @cindex MultiMeasureRest, exemple de dérogation
2852 @cindex staff-position, exemple d'utilisation de la propriété
2854 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2858 \override MultiMeasureRest #'staff-position = #-8
2863 C'est mieux que d'utiliser, par exemple, @code{extra-offset},
2864 car la ligne supplémentaire au-dessus du silence est insérée
2868 @subheading la propriété extra-offset
2870 @cindex positionnement des objets
2871 @cindex positionnement des grobs
2872 @cindex objets, positionnement
2873 @cindex grobs, positionnement
2875 La propriété @code{extra-offset} offre la possibilité de contrôler
2876 entièrement le placement d'un objet, aussi bien horizontalement que
2879 Dans l'exemple suivant, la seconde indication de doigté est déplacée
2880 légèrement vers la gauche et de 1,8 intervalle de lignes vers le
2883 @cindex Fingering, exemple de dérogation
2884 @cindex extra-offset, exemple d'utilisation de la propriété
2886 @lilypond[quote,fragment,relative=1,verbatim]
2889 \once \override Fingering #'extra-offset = #'(-0.3 . -1.8)
2894 @subheading la propriété positions
2896 @cindex contrôle des nolets, liaisons, phrasés et ligatures
2897 @cindex gestion manuelle des nolets, liaisons, phrasés et ligatures
2898 @cindex ligatures de nolet, gestion manuelle
2899 @cindex liaisons, gestion manuelle
2900 @cindex phrasés, gestion manuelle
2901 @cindex ligatures, gestion manuelle
2903 La propriété @code{positions} permet de contrôler manuellement la
2904 position et l'inclinaison des nolets, coulés, liaisons de phrasé et
2905 barres de ligature. Voici un exemple avec une horrible liaison de
2906 phrasé -- horrible pour avoir tenté de contourner la liaison de
2909 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2910 r4 \acciaccatura e8\( d8 c~ c d c d\)
2914 Nous pourrions tout simplement déplacer la liaison de phrasé au-dessus
2915 des notes, et ce serait la meilleure solution@tie{}:
2917 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2920 \acciaccatura e8\( d8 c~ c d c d\)
2924 Mais si, pour une quelconque raison, cette solution n'était pas
2925 envisageable, l'autre solution consiste à déplacer légèrement vers le
2926 bas l'extrémité gauche de la liaison de phrasé, grâce à la propriété
2927 @code{positions}. Cela corrige en même temps la forme plutôt
2928 disgracieuse de la liaison.
2930 @cindex PhrasingSlur, exemple de dérogation
2931 @cindex positions, exemple d'utilisation de la propriété
2933 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2935 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2936 \acciaccatura e8\( d8 c~ c d c d\)
2939 Voici un autre exemple. Comme nous pouvons le constater, les barres de
2940 ligature chevauchent les liaisons de tenue@tie{}:
2942 @lilypond[quote,verbatim,fragment,ragged-right]
2946 { c'1 ~ c'2. e'8 f' }
2948 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
2951 { c'1 ~ c'2. e'8 f' }
2953 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
2959 On peut y remédier en déplaçant manuellement vers le haut les deux
2960 extrémités des ligatures de croches, non plus à 1,81 intervalle
2961 au-dessous de la ligne médiane mais, disons, à 1@tie{}:
2963 @cindex Beam, exemple de dérogation
2964 @cindex positions, exemple d'utilisation de la propriété
2966 @lilypond[quote,verbatim,fragment,ragged-right]
2970 { c'1 ~ c'2. e'8 f' }
2973 \override Beam #'positions = #'(-1 . -1)
2974 e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g''
2978 { c'1 ~ c'2. e'8 f' }
2980 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
2986 Vous remarquerez que la retouche continue de s'appliquer au
2987 second bloc de croches de la première voix mais qu'il ne s'applique
2988 à aucune mesure de la deuxième voix.
2991 @subheading la propriété force-hshift
2993 Maintenant, nous sommes prêts à appliquer les dernières corrections à
2994 l'exemple de Chopin présenté à la fin de @ref{J'entends des Voix}, que
2995 nous avions laissé dans cet état@tie{}:
2997 @lilypond[quote,verbatim,fragment,ragged-right]
2998 \new Staff \relative c'' {
3013 La note intermédiaire du premier accord, le la bémol à la quatrième
3014 voix, doit rester dans le même empilement avec la note haute. Pour y
3015 remédier, nous réglons le @code{force-hshift} -- qui est une propriété
3016 de @code{NoteColumn} -- de cette note sur zéro.
3018 Quant au second accord, il serait préférable que le fa s'aligne avec le
3019 la et que la note la plus basse se positionne un peu plus sur la droite
3020 pour éviter que les hampes se chevauchent. Pour cela, nous réglons le
3021 @code{force-hshift} au niveau du @code{NoteColumn} du ré bémol de telle
3022 sorte qu'il se déplace de la moitié d'un espace de portée vers la
3025 Et voici le résultat final :
3027 @cindex NoteColumn, exemple de dérogation
3028 @cindex force-hshift, exemple d'utilisation de la propriété
3030 @lilypond[quote,verbatim,fragment,ragged-right]
3031 \new Staff \relative c'' {
3038 \once \override NoteColumn #'force-hshift = #0.5
3044 \override NoteColumn #'force-hshift = #0
3053 @node Exemple concret
3054 @subsection Exemple concret
3055 @translationof Real music example
3057 Pour terminer ce chapitre consacré aux retouches, voici, étape par
3058 étape, la mise en forme d'un exemple concret nécessitant un certain
3059 nombre de retouches jusqu'à l'obtention du résultat attendu. Cet
3060 exemple a été choisi en raison des problèmes inhabituels de notation
3061 qu'il soulevait et pour vous apprendre à les résoudre grâce au Manuel de
3062 notation. Il n'est pas représentatif d'une opération normale de
3063 gravure@tie{}; que ces difficultés ne vous découragent donc pas@tie{}!
3064 Des difficultés comme celles-ci ne sont, heureusement, pas
3067 Cet exemple est tiré de la Première Ballade de Chopin, Op. 23, mesures
3068 6 à 9@tie{}; cela correspond à la transition entre le Lento d'ouverture
3069 et le Moderato. Voici, pour commencer, ce à quoi nous voulons que la
3070 partition ressemble@tie{}; pour limiter les complications, nous n'avons
3071 pas fait apparaître les indications de nuance, de doigté ni de pédale.
3074 @c The following should appear as music without code
3075 @c This example should not be indexed
3076 @c line-width ensures no break
3077 @lilypond[quote,ragged-right,line-width=6\in]
3078 rhMusic = \relative c'' {
3081 \once \override Tie #'staff-position = #3.5
3085 \mergeDifferentlyHeadedOn
3086 \mergeDifferentlyDottedOn
3087 bes2.^\markup { \bold "Moderato" } r8
3093 % Reposition the c2 to the right of the merged note
3094 \once \override NoteColumn #'force-hshift = #1.0
3095 % Move the c2 out of the main note column
3096 % so the merge will work
3103 % Stem on the d2 must be down to permit merging
3105 % Stem on the d2 should be invisible
3106 \once \override Stem #'transparent = ##t
3107 \once \override Flag #'transparent = ##t
3115 \mergeDifferentlyHeadedOff
3116 \mergeDifferentlyDottedOff
3121 lhMusic = \relative c' {
3123 <d g, d>1)\arpeggio |
3130 \new Staff = "RH" <<
3134 \new Staff = "LH" <<
3143 Nous constatons tout d'abord que, dans la troisième mesure, la main
3144 droite compte quatre voix. Ce sont les cinq croches avec une barre,
3145 le do avec liaison, le ré blanche qui se fond avec le ré croche, et le
3146 fa dièse noire pointée qui se fond lui aussi avec la croche de même
3147 hauteur. Tout le reste se réduit à une seule voix. Le plus simple est
3148 donc de créer temporairement ces trois voix supplémentaires au moment
3149 opportun. Si vous avez oublié comment faire, reportez-vous à
3150 @ref{J'entends des Voix} et @ref{Instanciation explicite des voix}.
3151 Nous opterons ici pour une déclaration explicite des voix du passage
3152 polyphonique, puisque LilyPond est alors plus performant en matière
3153 d'évitement des collisions.
3155 Commençons par saisir les notes comme appartenant à deux variables,
3156 mettons en place l'ossature des portées dans un bloc @code{\Score} et
3157 voyons ce que LilyPond propose par défaut@tie{}:
3159 @c line-width ensures no break
3160 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3161 rhMusic = \relative c'' {
3167 % Start polyphonic section of four voices
3169 { c,8 d fis bes a } % continuation of main voice
3183 g2. % continuation of main voice
3187 lhMusic = \relative c' {
3196 \new Staff = "RH" <<
3200 \new Staff = "LH" <<
3209 Toutes les notes sont correctes mais l'allure générale est loin d'être
3210 satisfaisante. La liaison se heurte à l'indication de mesure lors du
3211 changement de métrique, la ligature des croches n'est pas bonne dans la
3212 troisième mesure, les notes ne sont pas fusionnées et il manque
3213 plusieurs éléments de notation. Commençons par le plus simple. Nous
3214 pouvons corriger la ligature des croches en la créant manuellement et
3215 nous pouvons facilement ajouter les limites droite et gauche de la
3216 liaison de phrasé, puisque tout cela a déjà été traité dans le tutoriel.
3217 Voici le résultat@tie{}:
3219 @c line-width ensures no break
3220 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3221 rhMusic = \relative c'' {
3227 % Start polyphonic section of four voices
3229 { c,8 d fis bes a } % continuation of main voice
3243 g2.\) % continuation of main voice
3247 lhMusic = \relative c' {
3256 \new Staff = "RH" <<
3260 \new Staff = "LH" <<
3269 La première mesure est maintenant correcte. La seconde contient un
3270 arpège et doit se terminer par une double barre. Comment faire, puisque
3271 cela n'a pas été traité dans le Manuel d'initiation@tie{}? C'est alors
3272 qu'il faut nous reporter au Manuel de notation. Quand on cherche
3273 @qq{arpège} et @qq{barre de mesure} dans l'index, on voit aisément qu'il
3274 faut ajouter @code{\arpeggio} à un accord pour produire un arpège et
3275 qu'une double barre est le résultat de la commande
3276 @code{\bar@tie{}"||"}. Rien de plus facile@tie{}! Nous devons ensuite
3277 corriger la collision entre la liaison et l'indication de mesure. Le
3278 mieux est de déplacer la liaison vers le haut. La méthode pour déplacer
3279 les objets a déjà été présentée dans @ref{Déplacement d'objets}, et l'on
3280 sait que, pour des objets positionnés par rapport à la portée, il nous
3281 faut modifier leur propriété @code{staff-position}, exprimée en
3282 demi-intervalles de lignes par rapport à la ligne médiane de la portée.
3283 Voici donc la retouche à insérer juste devant la première note
3284 liée@tie{}; elle est censée déplacer la liaison vers le haut de 3,5
3285 demi-intervalles de lignes au-dessus de la ligne médiane@tie{}:
3287 @code{\once \override Tie #'staff-position = #3.5}
3289 Cela s'adjoint à la deuxième mesure, pour donner@tie{}:
3291 @c line-width ensures no break
3292 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3293 rhMusic = \relative c'' {
3296 \once \override Tie #'staff-position = #3.5
3301 % Start polyphonic section of four voices
3303 { c,8 d fis bes a } % continuation of main voice
3317 g2.\) % continuation of main voice
3321 lhMusic = \relative c' {
3323 <d g, d>1)\arpeggio |
3330 \new Staff = "RH" <<
3334 \new Staff = "LH" <<
3343 Venons-en à la troisième mesure et au début de la section Moderato.
3344 Dans le Tutoriel, il est indiqué comment insérer du texte en gras à
3345 l'aide de la commande @code{\markup}@tie{}; pas de problème, du coup,
3346 pour ajouter @qq{Moderato} en gras. Mais comment faire pour fusionner
3347 les notes de différentes voix@tie{}? C'est là que le Manuel de notation
3348 peut nous venir en aide. Une recherche sur @qq{fusionnement de notes}
3349 dans l'index nous renvoie au chapitre @ruser{Résolution des collisions},
3350 et plus précisément aux commandes permettant de fusionner des notes en
3351 fonction de leur type et selon qu'elles sont pointées ou non. Dans
3352 notre exemple, pour la durée de la polyphonie de la troisième mesure,
3353 nous avons besoin de fusionner deux types de notes@tie{}; grâce aux
3354 informations trouvées dans le Manuel de notation, nous ajoutons
3357 \mergeDifferentlyHeadedOn
3358 \mergeDifferentlyDottedOn
3362 au début de cette section et
3365 \mergeDifferentlyHeadedOff
3366 \mergeDifferentlyDottedOff
3370 à la fin, ce qui donne :
3372 @c line-width ensures no break
3373 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3374 rhMusic = \relative c'' {
3377 \once \override Tie #'staff-position = #3.5
3381 bes2.^\markup { \bold "Moderato" } r8
3382 \mergeDifferentlyHeadedOn
3383 \mergeDifferentlyDottedOn
3384 % Start polyphonic section of four voices
3386 { c,8 d fis bes a } % continuation of main voice
3400 \mergeDifferentlyHeadedOff
3401 \mergeDifferentlyDottedOff
3402 g2.\) % continuation of main voice
3406 lhMusic = \relative c' {
3408 <d g, d>1)\arpeggio |
3415 \new Staff = "RH" <<
3419 \new Staff = "LH" <<
3428 Ces retouches ont permis de fusionner les deux fa dièse mais pas les
3429 deux ré. Pourquoi@tie{}? La réponse se trouve dans la même section du
3430 Manuel de notation@tie{}: les notes à fusionner doivent avoir des hampes
3431 dans des directions opposées et deux notes ne peuvent pas être
3432 fusionnées s'il y a une troisième note dans la même colonne. Ici, les
3433 deux ré ont leur hampe orientée vers le haut et il y a une troisième
3434 note, do. Nous savons changer l'orientation de la hampe avec
3435 @code{\stemDown} et le Manuel de notation nous indique également comment
3436 déplacer le do -- en produisant un décalage grâce à l'une des commandes
3437 @code{\shift}. Mais laquelle@tie{}? Le do appartient à la deuxième
3438 voix et n'est pas décalé@tie{}; les deux ré appartiennent respectivement
3439 à la première et à la troisième voix, et l'un n'est pas décalé tandis
3440 que l'autre l'est. Il nous faut donc décaler largement le do avec la
3441 commande @code{\shiftOnn} pour éviter une interférence avec les deux ré.
3442 Voici ce que donnent ces modifications@tie{}:
3444 @cindex Tie, exemple de dérogation
3445 @cindex staff-position, exemple d'utilisation de la propriété
3447 @c line-width ensures no break
3448 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3449 rhMusic = \relative c'' {
3452 \once \override Tie #'staff-position = #3.5
3456 bes2.^\markup { \bold "Moderato" } r8
3457 \mergeDifferentlyHeadedOn
3458 \mergeDifferentlyDottedOn
3459 % Start polyphonic section of four voices
3461 { c,8 d fis bes a } % continuation of main voice
3464 % Move the c2 out of the main note column
3465 % so the merge will work
3470 % Stem on the d2 must be down to permit merging
3478 \mergeDifferentlyHeadedOff
3479 \mergeDifferentlyDottedOff
3480 g2.\) % continuation of main voice
3484 lhMusic = \relative c' {
3486 <d g, d>1)\arpeggio |
3493 \new Staff = "RH" <<
3497 \new Staff = "LH" <<
3506 Pas loin@tie{}! Il ne reste plus que deux problèmes@tie{}: les ré une
3507 fois fusionnés ne devraient plus avoir de hampe vers le bas, et le do
3508 serait mieux à la droite des ré. Nous savons remédier à ces deux
3509 problèmes grâce aux retouches précédentes@tie{}: nous allons rendre la
3510 hampe transparente et déplacer le do avec la propriété
3511 @code{force-hshift}. Et voici le résultat final@tie{}:
3513 @cindex NoteColumn, exemple de dérogation
3514 @cindex force-hshift, exemple d'utilisation de la propriété
3515 @cindex Stem, exemple de dérogation
3516 @cindex transparent, exemple d'utilisation de la propriété
3518 @c line-width ensures no break
3519 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3520 rhMusic = \relative c'' {
3523 \once \override Tie #'staff-position = #3.5
3527 bes2.^\markup { \bold "Moderato" } r8
3528 \mergeDifferentlyHeadedOn
3529 \mergeDifferentlyDottedOn
3530 % Start polyphonic section of four voices
3532 { c,8 d fis bes a } % continuation of main voice
3536 % Reposition the c2 to the right of the merged note
3537 \once \override NoteColumn #'force-hshift = #1.0
3538 % Move the c2 out of the main note column
3539 % so the merge will work
3546 % Stem on the d2 must be down to permit merging
3548 % Stem on the d2 should be invisible
3549 \once \override Stem #'transparent = ##t
3550 \once \override Flag #'transparent = ##t
3558 \mergeDifferentlyHeadedOff
3559 \mergeDifferentlyDottedOff
3560 g2.\) % continuation of main voice
3564 lhMusic = \relative c' {
3566 <d g, d>1)\arpeggio |
3573 \new Staff = "RH" <<
3577 \new Staff = "LH" <<
3587 @node Autres retouches
3588 @section Autres retouches
3589 @translationof Further tweaking
3592 * Autres utilisations des retouches::
3593 * Utilisation de variables dans les retouches::
3594 * Feuilles de style::
3595 * Autres sources de documentation::
3596 * Retouches avancées avec Scheme::
3599 @node Autres utilisations des retouches
3600 @subsection Autres utilisations des retouches
3601 @translationof Other uses for tweaks
3603 @cindex transparent, utilisation de la propriété
3604 @cindex création d'objet invisible
3605 @cindex suppression d'objets
3606 @cindex objets, suppression d'
3607 @cindex masquage d'objets
3608 @cindex objets, masquage d'
3609 @cindex invisibles, objets
3610 @cindex objets, invisibles
3611 @cindex liaison de tenue avec changement de voix
3614 @subheading Liaison entre plusieurs voix
3616 Voici un exemple qui montre comment créer une liaison de
3617 prolongation entre des notes appartenant à des voix différentes. En
3618 temps normal, seules deux notes appartenant à une même voix
3619 peuvent être ainsi liées. La solution consiste à utiliser deux voix,
3620 dont l'une avec les notes liées
3622 @lilypond[quote,fragment,relative=2]
3623 << { b8~ b8\noBeam } \\ { b[ g8] } >>
3627 et à rendre transparente la première hampe de cette voix@tie{};
3628 on a alors l'impression que la liaison couvre les deux voix.
3630 @cindex Stem, exemple de dérogation
3631 @cindex transparent, exemple d'utilisation de la propriété
3633 @lilypond[quote,fragment,relative=2,verbatim]
3636 \once \override Stem #'transparent = ##t
3637 \once \override Flag #'transparent = ##t
3645 Pour être sûr que la hampe que nous avons rendue transparente
3646 n'empiète pas trop sur le trait de liaison, nous pouvons l'allonger en
3647 réglant la longueur (@code{length}) sur @code{8},
3649 @lilypond[quote,fragment,relative=2,verbatim]
3652 \once \override Stem #'transparent = ##t
3653 \once \override Flag #'transparent = ##t
3654 \once \override Stem #'length = #8
3663 @subheading Rendu MIDI d'un point d'orgue
3665 @cindex stencil, utilisation de la propriété
3666 @cindex point d'orgue, rendu en MIDI
3668 En ce qui concerne les objets extérieurs à la portée, quand on veut les
3669 faire disparaître de la partition imprimée, il est généralement
3670 préférable de modifier leur propriété @code{stencil} plutôt que leur
3671 propriété @code{transparent}. Le fait d'attribuer à la propriété
3672 @code{stencil} d'un objet la valeur @code{#f} supprimera entièrement
3673 celui-ci de la partition. Il ne risquera donc pas de gêner le placement
3676 Par exemple, si nous voulons changer le réglage de métronome pour
3677 simuler un point d'orgue dans le fichier MIDI, nous ne voulons surtout
3678 pas que cette indication métronomique apparaisse sur la partition ni
3679 qu'elle influence l'espacement entre les deux systèmes ou la position
3680 des annotations voisines sur la portée. Le fait d'attribuer à la
3681 propriété @code{stencil} la valeur @code{#f} est donc la bonne solution.
3682 Nous montrons ci-dessous le résultat des deux méthodes@tie{}:
3684 @cindex MetronomeMark, exemple de dérogation
3685 @cindex transparent, exemple d'utilisation de la propriété
3687 @lilypond[quote,verbatim,ragged-right]
3690 % Visible tempo marking
3693 \once \override Score.MetronomeMark #'transparent = ##t
3694 % Invisible tempo marking to lengthen fermata in MIDI
3697 % New tempo for next section
3706 @cindex MetronomeMark, exemple de dérogation
3707 @cindex stencil, exemple d'utilisation de la propriété
3709 @lilypond[quote,verbatim,ragged-right]
3712 % Visible tempo marking
3715 \once \override Score.MetronomeMark #'stencil = ##f
3716 % Invisible tempo marking to lengthen fermata in MIDI
3719 % New tempo for next section
3729 Les deux méthodes permettent d'enlever l'indication métronomique qui
3730 allonge le point d'orgue de la partition, et toutes deux modifient le
3731 rythme MIDI comme souhaité mais, dans la première, l'indication
3732 métronomique transparente repousse vers le haut l'indication de tempo,
3733 contrairement à la seconde (avec le stencil désactivé) qui la laisse à
3738 Glossaire musicologique :
3739 @rglosnamed{system,système}.
3742 @node Utilisation de variables dans les retouches
3743 @subsection Utilisation de variables dans les retouches
3744 @translationof Using variables for tweaks
3746 @cindex variables, utilisation dans les retouches
3747 @cindex utilisation de variables dans les retouches
3748 @cindex retouches et utilisation de variables
3750 Les commandes de retouche sont souvent longues et pénibles à
3751 taper, et ne tolèrent pas la moindre erreur. Lorsqu'on a besoin de
3752 faire plusieurs fois les mêmes retouches, il est préférable de
3753 définir des variables qui les contiennent.
3755 Imaginons que nous voulions accentuer certains mots dans des paroles en
3756 les mettant en italique. Au lieu des commandes @code{\italic} et
3757 @code{\bold}, qui ne fonctionnent dans les paroles que si elles sont
3758 enchâssées dans un @code{\markup} -- ce qui les rend pénibles à saisir
3759 -- pouvons-nous employer les commandes @code{\override} et
3760 @code{\revert}@tie{}?
3763 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3764 @code{\override Lyrics . LyricText #'font-series = #'bold}
3766 @code{\revert Lyrics . LyricText #'font-shape}
3767 @code{\revert Lyrics . LyricText #'font-series}
3770 Là encore, ce serait extrêmement pénible à saisir, surtout s'il y avait
3771 beaucoup de mots à retoucher de cette façon. Plutôt que cette
3772 solution, nous déclarons ces commandes comme étant deux variables,
3773 et les utilisons comme ci-après -- quoique on choisirait sans doute pour
3774 les variables des noms plus courts pour simplifier la frappe. Par
3775 ailleurs, le fait de recourir à une variable ne nous expose plus à
3776 l'oubli des espaces entourant les points lorsqu'explicités au beau
3777 milieu d'un bloc @code{\lyricmode}@tie{}!
3779 @cindex LyricText, exemple de dérogation
3780 @cindex font-shape, exemple d'utilisation de la propriété
3781 @cindex font-series, exemple d'utilisation de la propriété
3783 @lilypond[quote,verbatim]
3785 \override Lyrics.LyricText #'font-shape = #'italic
3786 \override Lyrics.LyricText #'font-series = #'bold
3790 \revert Lyrics.LyricText #'font-shape
3791 \revert Lyrics.LyricText #'font-series
3794 global = { \key c \major \time 4/4 \partial 4 }
3796 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a4 a g }
3797 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f4 f e }
3798 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3799 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3801 VerseOne = \lyrics {
3802 E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
3805 VerseTwo = \lyricmode {
3806 O | \emphasize Christ, \normal whose voice the | wa -- ters heard,
3809 VerseThree = \lyricmode {
3810 O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
3813 VerseFour = \lyricmode {
3814 O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
3821 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3822 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3823 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3824 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3825 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3826 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3830 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3831 \new Voice = "Bass" { \voiceTwo \BassMusic }
3838 @node Feuilles de style
3839 @subsection Feuilles de style
3840 @translationof Style sheets
3842 La sortie que produit LilyPond peut être largement modifiée -- voir
3843 @ref{Retouche de partition} pour plus de détails. Mais que faire si
3844 vous avez beaucoup de fichiers auxquels vous souhaitez appliquer vos
3845 retouches@tie{}? Ou si vous souhaitez simplement séparer les retouches
3846 de la musique elle-même@tie{}? Rien de plus facile.
3848 Prenons un exemple. Ne vous inquiétez pas si vous ne comprenez pas
3849 les parties avec tous les @code{#()}. Celles-ci sont expliquées dans
3850 @ref{Retouches avancées avec Scheme}.
3852 @lilypond[quote,verbatim,ragged-right]
3854 #(make-dynamic-script
3856 #:translate '(5 . 0)
3857 #:line (#:dynamic "mp"
3858 #:text #:italic "dolce")))
3861 #(define-music-function
3862 (parser location string)
3867 'text (markup #:bold (#:box string))))
3871 a4.\mpdolce d8 cis4--\glissando a |
3875 g8(\! fis)-. e( d)-. cis2 |
3879 On peut faire quelque chose pour les définitions de @code{mpdolce}
3880 et @code{inst}. Elles produisent le résultat que nous désirons,
3881 mais nous pourrions aussi vouloir les utiliser dans une autre pièce.
3882 Il suffirait de les copier et coller au début de chaque
3883 fichier, mais c'est fastidieux. De plus, cela laisse les définitions
3884 dans nos fichiers de musique, et je trouve personnellement tous ces
3885 @code{#()} assez laids. Stockons-les dans un autre fichier@tie{}:
3888 %%% enregistrez ceci dans un fichier nommé "definitions.ily"
3890 #(make-dynamic-script
3892 #:translate '(5 . 0)
3893 #:line (#:dynamic "mp"
3894 #:text #:italic "dolce")))
3897 #(define-music-function
3898 (parser location string)
3903 'text (markup #:bold (#:box string))))
3906 Nous rappellerons ce fichier par une simple commande @code{\include} au
3907 début de notre fichier de musique. Lui attribuer l'extension
3908 @code{.ily} nous permet de distinguer aisément qu'il s'agit d'un fichier
3909 voué à être inclus dans un fichier maître@tie{}; il n'est pas destiné à
3910 être compilé isolément.@*
3911 Maintenant, modifions notre musique (enregistrez ce fichier
3912 sous @file{musique.ly}).
3914 @c We have to do this awkward example/lilypond-non-verbatim
3915 @c because we can't do the \include stuff in the manual.
3918 \include "definitions.ily"
3922 a4.\mpdolce d8 cis4--\glissando a |
3926 g8(\! fis)-. e( d)-. cis2 |
3930 @lilypond[quote,ragged-right]
3932 #(make-dynamic-script
3934 #:translate '(5 . 0)
3935 #:line (#:dynamic "mp"
3936 #:text #:italic "dolce")))
3939 #(define-music-function
3940 (parser location string)
3945 'text (markup #:bold (#:box string))))
3949 a4.\mpdolce d8 cis4--\glissando a |
3953 g8(\! fis)-. e( d)-. cis2 |
3957 C'est mieux, mais effectuons encore quelques retouches. Le glissando
3958 est peu visible, c'est pourquoi nous allons l'épaissir et le
3959 rapprocher des têtes de note. Déplaçons l'indication métronomique
3960 au-dessus de la clef, au lieu de la laisser au-dessus de la première
3961 note. Et pour finir, mon professeur de composition déteste les
3962 chiffrages de mesure en @qq{C}, nous allons donc le transformer en
3965 Cependant, ne changez pas le fichier @file{musique.ly}. Remplacez le
3966 fichier @file{definitions.ily} par ceci@tie{}:
3971 #(make-dynamic-script
3973 #:translate '(5 . 0)
3974 #:line (#:dynamic "mp"
3975 #:text #:italic "dolce")))
3978 #(define-music-function
3979 (parser location string)
3984 'text (markup #:bold (#:box string))))
3989 \override MetronomeMark #'extra-offset = #'(-9 . 0)
3990 \override MetronomeMark #'padding = #'3
3994 \override TimeSignature #'style = #'numbered
3998 \override Glissando #'thickness = #3
3999 \override Glissando #'gap = #0.1
4004 @lilypond[quote,ragged-right]
4006 #(make-dynamic-script
4008 #:translate '(5 . 0)
4009 #:line (#:dynamic "mp"
4010 #:text #:italic "dolce")))
4013 #(define-music-function
4014 (parser location string)
4019 'text (markup #:bold (#:box string))))
4024 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4025 \override MetronomeMark #'padding = #'3
4029 \override TimeSignature #'style = #'numbered
4033 \override Glissando #'thickness = #3
4034 \override Glissando #'gap = #0.1
4040 a4.\mpdolce d8 cis4--\glissando a |
4044 g8(\! fis)-. e( d)-. cis2 |
4048 C'est encore mieux@tie{}! Mais supposons maintenant que je veuille
4049 publier cette pièce. Mon professeur de composition n'aime pas les
4050 chiffrages de mesure en @qq{C}, mais moi je les aime bien. Copions
4051 l'actuel @file{definitions.ily} dans le fichier
4052 @file{publication-web.ily}, et modifions ce dernier. Puisque la musique
4053 est destinée à produire un fichier PDF affiché sur écran, nous allons
4054 aussi augmenter la taille globale de police.
4059 #(make-dynamic-script
4061 #:translate '(5 . 0)
4062 #:line (#:dynamic "mp"
4063 #:text #:italic "dolce")))
4066 #(define-music-function
4067 (parser location string)
4072 'text (markup #:bold (#:box string))))
4074 #(set-global-staff-size 23)
4079 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4080 \override MetronomeMark #'padding = #'3
4087 \override Glissando #'thickness = #3
4088 \override Glissando #'gap = #0.1
4093 @lilypond[quote,ragged-right]
4095 #(make-dynamic-script
4097 #:translate '(5 . 0)
4098 #:line (#:dynamic "mp"
4099 #:text #:italic "dolce")))
4102 #(define-music-function
4103 (parser location string)
4108 'text (markup #:bold (#:box string))))
4110 #(set-global-staff-size 23)
4114 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4115 \override MetronomeMark #'padding = #'3
4118 \override Glissando #'thickness = #3
4119 \override Glissando #'gap = #0.1
4125 a4.\mpdolce d8 cis4--\glissando a |
4129 g8(\! fis)-. e( d)-. cis2 |
4133 Il ne nous reste plus qu'à remplacer
4134 @code{\include@tie{}"definitions.ily"} par
4135 @code{\include@tie{}"publication-web.ily"} dans notre fichier de
4138 Il est possible, bien sûr, de rendre cela encore plus pratique. Nous
4139 pourrions créer un fichier @file{definitions.ily} qui ne contiendrait
4140 que les définitions de @code{mpdolce} et de @code{inst}, un
4141 fichier @file{publication-web.ily} qui ne contiendrait que la section
4142 @code{layout} décrite ci-dessus et un fichier @file{universite.ily} qui
4143 ne contiendrait que les retouches pour produire le résultat que mon
4144 professeur préfère. Le début du fichier @file{musique.ly} ressemblerait
4148 \include "definitions.ily"
4150 %%% Décommentez seulement une de ces deux lignes !
4151 \include "publication-web.ily"
4152 %\include "universite.ily"
4155 Cette approche peut être utile même si vous ne produisez qu'un seul
4156 jeu de partitions. J'utilise personnellement une demi-douzaine de
4157 fichiers de @qq{feuille de style} pour mes projets. Je commence
4158 chaque fichier de musique par @code{\include@tie{}"../global.ily"} qui
4163 \version @w{"@version{}"}
4165 #(ly:set-option 'point-and-click #f)
4167 \include "../init/init-defs.ly"
4168 \include "../init/init-mise-en-page.ly"
4169 \include "../init/init-en-tetes.ly"
4170 \include "../init/init-papier.ly"
4174 @node Autres sources de documentation
4175 @subsection Autres sources de documentation
4176 @translationof Other sources of information
4178 La référence des propriétés internes contient beaucoup d'informations
4179 sur LilyPond. Cependant vous pouvez en découvrir encore plus en
4180 consultant les fichiers internes de LilyPond. Pour cela, il vous faut
4181 d'abord connaître le répertoire @emph{ad hoc} sur votre système.
4182 L'emplacement du répertoire dépend (a) du fait que, pour vous procurer
4183 LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou
4184 vous l'avez installé grâce à votre gestionnaire de paquetages
4185 (c'est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou
4186 encore vous l'avez compilé directement à partir des sources@tie{}; et
4187 (b) du système d'exploitation sur lequel il tourne.
4189 @strong{Téléchargé depuis lilypond.org}
4195 @file{@var{INSTALLDIR}/lilypond/usr/@/share/lilypond/current/}
4201 @file{@var{INSTALLDIR}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4204 Pour accéder à ce dossier, deux possibilités@tie{}: soit, dans un
4205 Terminal, taper @code{cd} suivi du chemin complet ci-dessus@tie{}; soit
4206 Control-cliquer (ou clic droit) sur l'application LilyPond
4207 et sélectionner @qq{Afficher le contenu du paquet}.
4211 Dans l'Explorateur Windows, voir
4213 @file{@var{INSTALLDIR}/LilyPond/usr/@/share/lilypond/current/}
4218 @strong{Installé par un gestionnaire de paquetages ou compilé d'après
4221 @code{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où
4222 @var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par
4223 le script @code{configure}, et @var{X.Y.Z} est le numéro de version de
4228 Dans ce répertoire, deux sous-répertoires sont particulièrement
4232 @item @code{ly/} -- contient les fichiers en format LilyPond
4233 @item @code{scm/} -- contient les fichiers en format Scheme
4236 Commençons par examiner quelques fichiers contenus dans @file{ly/}.
4237 Nous ouvrons @file{ly/property-init.ly} dans un éditeur de texte --
4238 celui que vous avez l'habitude d'utiliser pour les fichiers @file{.ly}
4239 fera très bien l'affaire. Ce fichier contient les définitions de toutes
4240 les commandes standard prédéfinies de LilyPond, comme @code{\stemUp} et
4241 @code{\slurDotted}. Vous pouvez constater que ce n'est rien d'autre
4242 que des définitions de variables composées d'un ou plusieurs groupes
4243 de commandes @code{\override}. Par exemple, @code{\tieDotted}
4244 est défini comme@tie{}:
4248 \override Tie #'dash-period = #0.75
4249 \override Tie #'dash-fraction = #0.1
4253 Si vous n'aimez pas les valeurs par défaut, les commandes prédéfinies
4254 peuvent être facilement redéfinies, comme n'importe quelle autre
4255 variable, en tête de votre fichier d'entrée.
4257 Voici les fichiers les plus utiles dans le répertoire @file{ly/}@tie{}:
4259 @multitable @columnfractions .4 .6
4260 @headitem Nom de fichier
4262 @item @file{ly/engraver-init.ly}
4263 @tab Définitions des Contextes de graveurs
4264 @item @file{ly/paper-defaults-init.ly}
4265 @tab Réglages papier par défaut
4266 @item @file{ly/performer-init.ly}
4267 @tab Définitions des Contextes d'interprétation
4268 @item @file{ly/property-init.ly}
4269 @tab Définitions de toutes les commandes prédéfinies courantes
4270 @item @file{ly/spanner-init.ly}
4271 @tab Définitions des commandes prédéfinies pour les bandeaux
4274 Les autres réglages (comme les définitions de commandes @emph{markup})
4275 sont conservés comme fichiers @file{.scm} (Scheme). Le langage de
4276 programmation Scheme offre une interface programmable dans le
4277 processus interne de LilyPond. De plus amples explications sur ces
4278 fichiers dépasseraient le cadre de ce manuel dans la mesure où elles
4279 requièrent la connaissance du langage Scheme. Les utilisateurs qui
4280 souhaiteraient comprendre le fonctionnement de ces fichiers de
4281 configuration doivent être avertis que des connaissances techniques
4282 substantielles et beaucoup de temps sont nécessaires (voir le
4283 @rextend{Tutoriel Scheme}).
4285 Si c'est votre cas, les fichiers Scheme les plus utiles à connaître
4288 @multitable @columnfractions .4 .6
4289 @headitem Nom de fichier
4291 @item @file{scm/auto-beam.scm}
4292 @tab Règles par défaut des ligatures subalternes
4293 @item @file{scm/define-grobs.scm}
4294 @tab Réglages par défaut des propriétés de @emph{grobs}
4295 @item @file{scm/define-markup-commands.scm}
4296 @tab Spécification de toutes les commandes de @emph{markup}
4297 @item @file{scm/midi.scm}
4298 @tab Réglages par défaut pour les sorties MIDI
4299 @item @file{scm/output-lib.scm}
4300 @tab Réglages affectant l'apparence des frets, couleurs, altérations,
4301 barres de mesure, etc.
4302 @item @file{scm/parser-clef.scm}
4303 @tab Définition des clefs prises en charge
4304 @item @file{scm/script.scm}
4305 @tab Réglages par défaut des articulations
4309 @node Retouches avancées avec Scheme
4310 @subsection Retouches avancées avec Scheme
4311 @translationof Advanced tweaks with Scheme
4313 Nous avons vu à quel point le résultat obtenu avec LilyPond peut
4314 être largement personnalisé à l'aide de commandes comme
4315 @code{\override} et @code{\tweak}. Et pourtant l'utilisation de
4316 Scheme ouvre des possibilités encore plus grandes.
4317 Le code écrit dans le langage de programmation Scheme peut être
4318 intégré directement dans le processus interne de LilyPond. Bien sûr,
4319 il faut pour cela connaître un minimum de programmation en langage
4320 Scheme. Pour des explications complètes là-dessus, consultez le
4321 @rextend{Tutoriel Scheme}.
4323 En guise d'illustration -- et ce n'est qu'une possibilité parmi tant
4324 d'autres -- nous allons attribuer à une propriété non pas une valeur
4325 préétablie mais une procédure Scheme qui sera lancée à chaque
4326 utilisation de la propriété par LilyPond. De cette façon, nous obtenons
4327 un réglage dynamique de la propriété par le simple fait d'invoquer la
4328 procédure. Dans cet exemple, nous colorons les têtes de notes en
4329 fonction de leur position sur la portée.
4332 @cindex x11-color, exemple d'utilisation de la fonction
4333 @cindex NoteHead, exemple de dérogation
4334 @cindex color, détermination de la propriété par une procédure Scheme
4336 @lilypond[quote,verbatim,ragged-right]
4337 #(define (color-notehead grob)
4338 "Color the notehead according to its position on the staff."
4339 (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4342 ;; Return rainbow colors
4343 ((1) (x11-color 'red )) ; for C
4344 ((2) (x11-color 'orange )) ; for D
4345 ((3) (x11-color 'yellow )) ; for E
4346 ((4) (x11-color 'green )) ; for F
4347 ((5) (x11-color 'blue )) ; for G
4348 ((6) (x11-color 'purple )) ; for A
4349 ((0) (x11-color 'violet )) ; for B
4353 % Arrange to obtain color from color-notehead procedure
4354 \override NoteHead #'color = #color-notehead
4355 a2 b | c2 d | e2 f | g2 a |
4359 Vous trouverez dans @rextend{Fonctions de rappel} d'autres exemples
4360 d'utilisation de ces interfaces programmables.