1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of ../user/lilypond.tely
4 Translation of GIT committish: 76de7e168dbc9ffc7671d99663c5ce50dae42abb
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Valentin Villenave
13 @c Translation checkers: Gilles Thibault
15 @node Changing defaults
16 @chapter Changing defaults
18 LilyPond est conçu pour engendrer, par défaut, des partitions de la
19 plus haute qualité. Cependant, on peut parfois avoir à modifier cette
20 mise en page par défaut. Celle-ci est réglée par tout un ensemble de
21 @qq{leviers et manettes}, dont ce chapitre ne cherche pas à faire
22 l'inventaire exhaustif. Le propos est plutôt ici de mettre en évidence
23 les différents groupes auxquels s'apparentent ces contrôles, et d'expliquer
24 comment trouver le bon levier pour obtenir tel ou tel effet en particulier.
26 @cindex Référence du programme
28 Les moyens de contrôle des différents réglages sont décrits dans un document
31 référence du programme
34 @ref{Top,Référence du programme,,lilypond-internals}.
36 Ce guide répertorie toutes les variables, fonctions et autres options que
37 LilyPond met à votre disposition. Il est consultable
38 @c leave the @uref as one long line.
39 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,en@tie{}ligne},
40 au format HTML, mais est également inclus dans la documentation
41 fournie avec le logiciel.
43 Il est quatre domaines dans lesquels on peut modifier les réglages par défaut :
47 La notation automatique, ce qui revient à modifier la manière dont les éléments
48 de notation sont automatiquement créés -- par exemple, les règles de ligatures.
51 L'apparence, qui se rapporte aux objets pris individuellement -- ainsi de la direction
52 des hampes, du placement des indications textuelles.
55 Les contextes, qui recouvrent la manière dont les évènements musicaux sont représentés sous forme de
56 notation -- par exemple, le fait d'attribuer un chiffre de mesure distinct à chaque portée.
59 La mise en page, autrement dit les marges, l'espacement, la taille du papier ; tous ces facteurs
60 font l'objet des chapitres @ref{General input and output} et @ref{Spacing issues}.
63 En sous-main, LilyPond se sert du langage Scheme (un dérivé du LISP) comme
64 infrastructure. Modifier les choix de mise en page revient à pénétrer dans
65 les entrailles du programme, et de ce fait requiert l'emploi du Scheme.
66 Les fragments de Scheme, dans un fichier @code{.ly}, sont introduits par le
67 caractère @q{hash}, (@code{#}, improprement surnommé @q{dièse}).@footnote{Le
68 @rlearning{Scheme tutorial} fournit quelques notions de base pour saisir des nombres,
69 des listes, des chaînes de caractères ou des symboles, en Scheme.}
73 * Automatic notation::
74 * Interpretation contexts::
75 * The \override command::
79 @node Automatic notation
80 @section Automatic notation
82 Cette section s'intéresse au réglage de l'impression automatique des
83 altérations accidentelles et ligatures.
86 * Automatic accidentals::
87 * Setting automatic beam behavior::
90 @node Automatic accidentals
91 @subsection Automatic accidentals
92 @cindex Altérations accidentelles automatiques
94 Une fonction a été créée pour regrouper les règles suivant lesquelles
95 s'impriment les altérations. Elle s'invoque de la manière suivante :
97 @funindex set-accidental-style
99 #(set-accidental-style 'REGLE)
102 @c TODO: check the context stuff below
103 @c -does it *really* work?
104 @c -the default contexts as specified in
105 @c scm/music-function.scm seem to be different -vv
107 Cette fonction prend pour argument le nom de la règle d'altérations,
108 auquel peut s'ajouter, comme argument facultatif, le contexte
109 devant être affecté :
112 #(set-accidental-style 'REGLE #('CONTEXTE#))
115 Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ;
116 cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu
119 Les régles d'altérations suivantes sont possibles :
123 C'est la règle d'impression par défaut, qui se rapporte à l'usage
124 en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
125 une mesure, et uniquement à leur propre octave.
128 @lilypond[quote,ragged-right]
129 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
130 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
132 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
133 \change Staff = up cis' \change Staff = down <fis, a>
134 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
139 << \context Staff = "up" {
140 %#(set-accidental-style 'default)
142 \context Staff = "down"{
143 %#(set-accidental-style 'default)
145 \header { piece = \markup {\fill-line { \fontsize #3 "'default" }}}
150 En principe, LilyPond se souvient de toutes les altérations présentes sur la
151 portée (contexte Staff). Avec cette règle, cependant, les altérations sont indépendantes
152 pour chacune des voix.
157 #(set-accidental-style 'voice)
162 De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
163 ce qui peut donner lieu à un résultat malencontreux. Dans l'exemple suivant,
164 il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
166 @lilypond[quote,ragged-right]
167 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
168 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
170 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
171 \change Staff = up cis' \change Staff = down <fis, a>
172 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
177 << \context Staff = "up" {
178 #(set-accidental-style 'voice)
180 \context Staff = "down"{
181 #(set-accidental-style 'voice)
183 \header { piece = \markup {\fill-line { \fontsize #3 "'voice" }}}
187 La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
188 des musiciens différents. S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
189 à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
193 @funindex modern style accidentals
194 Cette règle est la plus courante au XXème siècle. Les altérations accidentelles
195 sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
196 apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
197 sont ajoutés. Dans l'exemple suivant, notez ainsi les deux bécarres dans la
198 deuxième mesure de la main droite.
200 @lilypond[quote,ragged-right]
201 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
202 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
204 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
205 \change Staff = up cis' \change Staff = down <fis, a>
206 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
211 << \context Staff = "up" {
212 #(set-accidental-style 'modern)
214 \context Staff = "down"{
215 #(set-accidental-style 'modern)
217 \header { piece = \markup {\fill-line { \fontsize #3 "'modern" }}}
221 @item @code{modern-cautionary}
222 @funindex modern-cautionary
223 Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
224 imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
225 Il est possible de le définir au moyen de la propriété @code{cautionary-style}
226 pour l'objet @rinternals{AccidentalSuggestion}.
228 @lilypond[quote,ragged-right]
229 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
230 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
232 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
233 \change Staff = up cis' \change Staff = down <fis, a>
234 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
239 << \context Staff = "up" {
240 #(set-accidental-style 'modern-cautionary)
242 \context Staff = "down"{
243 #(set-accidental-style 'modern-cautionary)
245 \header { piece = \markup {\fill-line { \fontsize #3 "'modern-cautionary" }}}
249 @funindex modern-voice
251 Cette règle sert aux altérations dans de la musique polyphonique destinée
252 autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
253 Les altérations sont imprimées voix par voix, mais les autres voix, dans le même
254 contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
256 @lilypond[quote,ragged-right]
257 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
258 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
260 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
261 \change Staff = up cis' \change Staff = down <fis, a>
262 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
267 << \context Staff = "up" {
268 #(set-accidental-style 'modern-voice)
270 \context Staff = "down"{
271 #(set-accidental-style 'modern-voice)
273 \header { piece = \markup {\fill-line { \fontsize #3 "'modern-voice" }}}
277 @funindex modern-voice-cautionary
278 @item modern-voice-cautionary
279 Cette régle est similaire à la précédente, mais les altérations de précautions
280 (celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
281 particulière. On retrouve donc toutes les altérations qu'imprimerait
282 @code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
284 @lilypond[quote,ragged-right]
285 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
286 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
288 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
289 \change Staff = up cis' \change Staff = down <fis, a>
290 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
295 << \context Staff = "up" {
296 #(set-accidental-style 'modern-voice-cautionary)
298 \context Staff = "down"{
299 #(set-accidental-style 'modern-voice-cautionary)
301 \header { piece = \markup {\fill-line { \fontsize #3 "'modern-voice-cautionary" }}}
306 @funindex piano accidentals
307 Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier
308 pour chaque portée individuelle au sein du contexte GrandStaff.
311 \new GrandStaff @{ <<
312 \new Staff = "up" @{ <<
313 #(set-accidental-style 'piano)
316 \new Staff = "down"@{ <<
317 #(set-accidental-style 'piano)
323 Cette règle est communément employée pour les partitions de piano au XXème siècle.
324 Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
325 les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
326 @rinternals{PianoStaff}.
328 @lilypond[quote,ragged-right]
329 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
330 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
332 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
333 \change Staff = up cis' \change Staff = down <fis, a>
334 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
339 << \context Staff = "up" {
340 #(set-accidental-style 'piano)
342 \context Staff = "down"{
343 #(set-accidental-style 'piano)
345 \header { piece = \markup {\fill-line { \fontsize #3 "'piano" }}}
349 @item piano-cautionary
350 @funindex #(set-accidental-style 'piano-cautionary)
351 Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
352 sont imprimées différemment.
354 @lilypond[quote,ragged-right]
355 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
356 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
358 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
359 \change Staff = up cis' \change Staff = down <fis, a>
360 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
365 << \context Staff = "up" {
366 #(set-accidental-style 'piano-cautionary)
368 \context Staff = "down"{
369 #(set-accidental-style 'piano-cautionary)
371 \header { piece = \markup {\fill-line { \fontsize #3 "'piano-cautionary" }}}
376 @funindex no-reset accidental style
377 C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
378 ne cesse jamais, même dans les mesures suivantes.
379 @lilypond[quote,ragged-right]
380 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
381 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
383 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
384 \change Staff = up cis' \change Staff = down <fis, a>
385 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
390 << \context Staff = "up" {
391 #(set-accidental-style 'no-reset)
393 \context Staff = "down"{
394 #(set-accidental-style 'no-reset)
396 \header { piece = \markup {\fill-line { \fontsize #3 "'no-reset" }}}
401 Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
402 et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
403 imprimées, en fonction de l'éventuelle armure.
405 @lilypond[quote,ragged-right]
406 musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
407 \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
409 musicB = { \clef bass \new Voice { \voiceTwo \relative { < fis, a cis>4
410 \change Staff = up cis' \change Staff = down <fis, a>
411 \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis
416 << \context Staff = "up" {
417 #(set-accidental-style 'forget)
419 \context Staff = "down"{
420 #(set-accidental-style 'forget)
422 \header { piece = \markup {\fill-line { \fontsize #3 "'forget" }}}
430 Référence du programme : @rinternals{Accidental_engraver},
431 @rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
436 Les notes simultanées sont considérées comme des évènements séquentiels.
437 Ce qui implique que, dans un accord, les altérations accidentelles seront
438 imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
439 de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
440 sein d'un accord certaines altérations dépendent les unes des autres.
441 Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
445 @node Setting automatic beam behavior
446 @subsection Setting automatic beam behavior
448 @funindex autoBeamSettings
449 @funindex (end * * * *)
450 @funindex (begin * * * *)
451 @cindex ligatures automatiques, réglage
452 @cindex réglage des ligatures automatiques
454 @c [TODO: use \applyContext]
456 Dans les métriques courantes, les ligatures automatiques peuvent commencer
457 sur n'importe quelle note, mais ne peuvent se terminer qu'à certains points précis
458 dans la mesure : sur une pulsation, ou après toute durée spécifiée par les propriétés
459 nommées @code{autoBeamSettings}. Ces propriétés consistent en une liste de règles
460 relatives au début ou à la fin des ligatures. Par défaut, elles sont définies dans
462 @file{scm/@/auto@/-beam@/.scm}.
464 On peut ajouter à cette liste une nouvelle règle, au moyen de la commande
466 #(override-auto-beam-setting '(extrémité p q n m) a b [contexte])
471 @item @code{extrémité} désigne le début (@code{begin}) ou la fin (@code{end}) de la ligature.
473 @item @code{p/q} désigne la valeur rythmique de la note que l'on veut affecter, ou de la
474 plus brève des notes concernées. Si cette règle doit s'appliquer à toutes les ligatures,
475 remplacez @code{p} et @code{q} par des étoiles @qq{@code{*}}.
478 @item @code{n/m} est le chiffre de mesure dans lequel la règle doit
479 s'appliquer. Si celle-ci doit s'appliquer dans toutes les métriques,
480 remplacez @code{n} et @code{m} par des étoiles @qq{@code{*}}.
482 @item @code{a/b} est l'emplacement, dans la mesure, auquel les ligatures doivent
483 débuter ou s'achever (suivant la valeur @q{extrémité} que nous venons de voir).
486 @item @code{contexte} est un argument facultatif, qui détermine le contexte dans lequel
487 la règle doit s'appliquer. Par défaut, il s'agit de @code{'Voice}.
488 @code{#(score-override-auto-beam-setting '(A B C D) E F)} équivaut à
489 @code{#(override-auto-beam-setting '(A B C D) E F 'Score)}.
493 Par exemple, si l'on veut que les ligatures s'achèvent toujours après la première noire :
497 #(override-auto-beam-setting '(end * * * *) 1 4)
500 On peut obliger une règle de ligatures à ne s'appliquer qu'à des groupes dont la note
501 la plus brève est d'une valeur précise :
503 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
505 #(override-auto-beam-setting '(end 1 16 * *) 1 16)
507 a32 a a a a16 a a a a a |
508 #(override-auto-beam-setting '(end 1 32 * *) 1 16)
509 a32 a a a a16 a a a a a |
512 On peut obliger une règle de ligatures à ne s'appliquer que pour un chiffre de mesure
515 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
517 #(override-auto-beam-setting '(end * * 5 8) 2 8)
525 Enfin, on peut désactiver une règle de ligatures au moyen du réglage suivant :
528 #(revert-auto-beam-setting '(extrémité p q n m) a b [contexte])
532 @code{extrémité}, @code{p}, @code{q}, @code{n}, @code{m}, @code{a}, @code{b} et @code{contexte}
533 étant les mêmes que plus haut. Il est même possible de désactiver des règles que l'on n'a pas
534 explicitement créées : les règles par défaut, qui se trouvent dans le fichier @file{scm/@/auto@/-beam@/.scm}.
538 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
540 a16 a a a a a a a a a a a a a a a
541 #(revert-auto-beam-setting '(end 1 16 4 4) 1 4)
542 a16 a a a a a a a a a a a a a a a
545 La commande @code{revert-auto-beam-setting} requiert exactement les mêmes arguments
546 que la règle d'origine. En d'autres termes, les étoiles ne seront pas prises en compte ici.
548 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
550 #(override-auto-beam-setting '(end 1 16 1 4) 1 8)
552 #(revert-auto-beam-setting '(end 1 16 * *) 1 8) % ceci ne désactive pas la règle !
554 #(revert-auto-beam-setting '(end 1 16 1 4) 1 8) % ceci marche
560 @c TODO: old material -- not covered by above stuff, I think.
561 Si, dans une mesure à 5/4, l'on veut que les ligatures soient regroupées temps par temps,
562 il est nécessaire d'indiquer toutes les terminaisons de ligatures.
564 #(override-auto-beam-setting '(end * * * *) 1 4 'Staff)
565 #(override-auto-beam-setting '(end * * * *) 1 2 'Staff)
566 #(override-auto-beam-setting '(end * * * *) 3 4 'Staff)
567 #(override-auto-beam-setting '(end * * * *) 5 4 'Staff)
571 La même syntaxe peut servir à définir les points de départ des ligatures.
572 Dans l'exemple suivant, les ligatures automatiques ne peuvent se terminer
573 que sur une noire pointée.
575 #(override-auto-beam-setting '(end * * * *) 3 8)
576 #(override-auto-beam-setting '(end * * * *) 1 2)
577 #(override-auto-beam-setting '(end * * * *) 7 8)
579 @c ???? Je n'y comprends rien --vv
580 Dans une mesure à 4/4, cela implique que les ligatures ne peuvent se terminer que sur
581 la troisième croche, ou sur le quatrième temps (après la valeur de deux fois trois croches).
583 Si une ligature se fait de manière inattendue, pensez à vérifer les règles automatiques
584 dans le fichier @file{scm/@/auto@/-beam@/.scm} pour rechercher d'éventuels conflits, dans
585 la mesure ou les règles par défaut s'ajoutent à vos propres règles. Il est alors nécessaire
586 de désactiver toute règle par défaut conduisant à des ligatures indésirables.
588 Ainsi, pour obtenir des ligatures en groupes de @code{(3 4 3 2)} croches, dans une mesure à 12/8,
589 il faudra préalablement utiliser :
592 %%% annulons les réglages par défaut relatifs à 12/8, dans scm/auto-beam.scm
593 #(revert-auto-beam-setting '(end * * 12 8) 3 8)
594 #(revert-auto-beam-setting '(end * * 12 8) 3 4)
595 #(revert-auto-beam-setting '(end * * 12 8) 9 8)
597 %%% puis ajoutons nos propres règles
598 #(override-auto-beam-setting '(end 1 8 12 8) 3 8)
599 #(override-auto-beam-setting '(end 1 8 12 8) 7 8)
600 #(override-auto-beam-setting '(end 1 8 12 8) 10 8)
603 @cindex ligatures automatiques
604 @cindex groupes de notes
605 @funindex autoBeaming
608 Si des ligatures sont utilisées dans les paroles d'une chanson (pour indiquer des mélismes),
609 les ligatures automatiques doivent être désactivées, avec @code{\autoBeamOff}.
614 @funindex \autoBeamOff
616 @funindex \autoBeamOn
621 Les groupes de notes reliées par les ligatures peuvent être spécifiés au moyen
622 de la propriété @code{beatGrouping}.
624 @lilypond[quote,verbatim,relative=2,fragment,ragged-right]
626 \set beatGrouping = #'(2 3)
628 \set beatGrouping = #'(3 2)
635 Si une partition se termine alors qu'une ligature automatique est restée inachevée,
636 cette dernière ligature ne sera pas imprimée du tout. C'est également valable dans
637 le cas d'une musique polyphonique, saisie avec la syntaxe @code{<< @dots{} \\ @dots{}
638 >>}, où une voix se terminerait sans que la dernière ligature
641 @node Interpretation contexts
642 @section Interpretation contexts
644 Cette section traite des contextes.
647 * Changing context properties on the fly::
648 * Modifying context plug-ins::
649 * Layout tunings within contexts::
650 * Changing context default settings::
651 * Defining new contexts::
652 * Aligning contexts::
653 * Vertical grouping of grobs::
657 @node Changing context properties on the fly
658 @subsection Changing context properties on the fly
662 @cindex modifier des propriétés
664 Chaque contexte peut avoir plusieurs @emph{propriétés}, c'est-à-dire
665 des variables qu'il inclut. Ces dernières peuvent être modifiées @qq{à la volée},
666 c'est-à-dire pendant que la compilation s'accomplit. C'est là le rôle de la
667 commande @code{\set}.
670 \set @var{contexte}.@var{propriété} = #@var{valeur}
674 @lilypond[quote,verbatim,relative=2,fragment]
676 \set Score.skipBars = ##t
680 Cette commande permet de condenser les mesures vides de notes, en des silences
681 multi-mesures. Il s'agit d'un objet Scheme, auquel on attribue la valeur booléenne
682 @q{vrai}, c'est-à-dire la lettre @code{#t} pour @q{True} en anglais.
684 Ce changement étant appliqué @q{à la volée}, il n'affecte que le second groupe de notes.
686 Si l'argument @var{contexte} n'est pas spécifié, alors la propriété cherchera à s'appliquer
687 dans le contexte le plus restreint où elle est employée : le plus souvent
688 @context{ChordNames}, @context{Voice}, ou @context{Lyrics}. Dans l'exemple suivant,
690 @lilypond[quote,verbatim,relative=2,fragment]
692 \set autoBeaming = ##f
697 aucun argument @var{contexte} n'a été donné à la commande @code{\set}.
698 De ce fait, les ligatures automatiques sont désactivées dans le
699 contexte actuel, c'est-à-dire @rinternals{Voice}. Notez que le
700 contexte le plus restreint n'est pas toujours le bon,
701 et peut ne pas contenir la propriété qui vous intéresse : ainsi, la propriété
702 @code{skipBars}, évoquée plus haut, ne relève pas du contexte @code{Voice},
703 et le code suivant ne fonctionnera pas.
705 @lilypond[quote,verbatim,relative=2,fragment]
711 Les contextes s'organisent de façon hiérarchique : aussi, lorsqu'un contexte de niveau
712 supérieur est spécifié (par exemple @context{Staff}), la propriété sera modifée dans
713 tous les contextes inférieurs (tous les contextes @context{Voice}, par exemple)
718 La commande @code{\unset} permet d'annuler la définition d'une propriété :
721 \unset @var{contexte}.@var{propriété}
725 si et seulement si cette propriété à été définie dans ce @var{contexte}
729 \set Staff.autoBeaming = ##f
733 même s'il s'applique à tous les contextes @code{Voice} contenus dans le
734 contexte @code{Staff}, ne peut être annulé au niveau @code{Voice}. Le code
735 suivant sera sans effet.
738 \unset Voice.autoBeaming
742 En d'autres termes, la commande @code{\unset} doit impérativement être
743 accompagnée du même contexte que la commande @code{\set} d'origine.
744 Pour annuler l'effet, dans notre exemple, de @code{Staff.autoBeaming = ##f},
745 il faut donc entrer :
747 \unset Staff.autoBeaming
750 Si l'on se trouve dans le contexte le plus restreint, il n'est pas obligatoire,
751 là encore, de spécifier le @var{contexte}. Ainsi, les deux lignes suivantes sont équivalentes.
755 \set Voice.autoBeaming = ##t
756 \set autoBeaming = ##t
761 Pour modifier une propriété de façon à ce qu'elle ne s'applique qu'une seule fois,
762 il convient d'employer la commande @code{\once} :
764 @lilypond[quote,verbatim,relative=2,fragment]
766 \once \set fontSize = #4.7
771 Ici le changement de taille est annulé aussitôt après la note concernée.
773 La référence du programme contient une description exhaustive de toutes les
774 propriétés contexte par contexte : voir
776 @rinternals{Tunable context properties}.
779 Translation @expansion{} Tunable context properties.
783 @node Modifying context plug-ins
784 @subsection Modifying context plug-ins
786 Les contextes, tels que @code{Score} ou @code{Staff}, ne contiennent
787 pas que des propriétés ; ils mettent également en œuvre certains
788 sous-programmes (@q{plug-ins}, pour employer le terme consacré) nommés
789 @q{graveurs} (@q{engravers}, pour reprendre le terme anglais).
790 Ces sous-programmes sont chargés de créer les différents éléments de notation :
791 On trouve ainsi dans le contexte @code{Voice}, un graveur @code{Note_head_engraver},
792 chargé des têtes de notes, et dans le contexte @code{Staff}, un graveur
793 @code{Key_signature_engraver}, chargé de l'armure.
795 Vous trouverez une description exhaustive de chaque graveur dans
797 @rinternals{Engravers}.
800 Program reference @expansion Translation @expansion{} Engravers.
802 Chaque contexte mentionné dans
804 @rinternals{Contexts}
807 Program reference @expansion Translation @expansion{} Context.
809 répertorie les graveurs mis en œuvre.
812 On peut faire, au moyen de ces graveurs, sa propre @qq{cuisine}, en
813 modifiant les contextes à volonté.
816 Lorsque un contexte est créé, par la commande @code{\new} ou @code{\context}, on peut
817 y adjoindre un bloc @code{\with} (en anglais @q{avec}), dans lequel il est possible
818 d'ajouter (commande @code{\consists}) ou d'enlever (commande @code{\remove})
824 \new @var{contexte} \with @{
837 Ici les points de suspension @dots{} devront être remplacés par les noms
838 des graveurs désirés. Dans l'exemple suivant, on enlève du contexte
839 @code{Staff}, le chiffre de mesure (graveur @code{Time_signature_engraver})
840 et la clé (graveur @code{Clef_engraver}).
842 @lilypond[quote,relative=1,verbatim,fragment]
848 \remove "Time_signature_engraver"
849 \remove "Clef_engraver"
856 La clé et le chiffre de mesure ont disparu de la deuxième portée. C'est une méthode
857 quelque peu radicale, puisqu'elle affectera toute la portée jusqu'à la fin de la
858 partition. L'espacement s'en trouve également affecté, ce qui peut être ou non
859 l'effet recherché. Une méthode plus sophistiquée aurait été de rendre ces objets
860 transparents (voir @rlearning{Common tweaks}).
862 Dans l'exemple suivant, voici une mise en pratique plus utile. En temps
863 normal, les barres de mesure et la métrique sont synchronisées verticalement
864 dans toute la partition. Les graveurs qui en sont responsables se nomment
865 @code{Timing_translator} et @code{Default_bar_line_engraver}.
866 En les enlevant du contexte @code{Score} pour les attribuer au contexte
867 @code{Staff}, chaque portée peut désormais avoir sa propre métrique.
869 @cindex polymétrique, partition
870 @cindex Chiffres de mesure multiples
872 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
874 \remove "Timing_translator"
875 \remove "Default_bar_line_engraver"
878 \consists "Timing_translator"
879 \consists "Default_bar_line_engraver"
885 \consists "Timing_translator"
886 \consists "Default_bar_line_engraver"
895 @node Layout tunings within contexts
896 @subsection Layout tunings within contexts
898 Chaque contexte est chargé de créer plusieurs types d'objets graphiques.
899 Il contient également les réglages nécessaires pour chacun de ces objets.
900 Si l'on modifie ces réglages, les objets n'auront plus la même apparence.
902 La syntaxe employée pour ce faire est
905 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
908 Ici @var{objet} est un objet graphique, tel que @code{Stem} (les hampes)
909 ou @code{NoteHead} (les têtes de note) ; @var{propriété} est une variable
910 (désignée par un symbole, ce qui explique l'apostrophe) employée par le système
911 de mise en page. La sous-section @ref{Constructing a tweak} vous
912 aidera à savoir quoi mettre à la place de @var{objet}, @var{propriété} et
913 @var{valeur} ; notre propos n'est ici que d'examiner l'emploi de cette commande.
915 La commande suivante :
918 \override Staff.Stem #'thickness = #4.0
922 rend les hampes plus épaisses (la valeur par défaut est 1.3, ce qui signifie qu'elles
923 sont 1,3 fois plus épaisses que les lignes de la portée). Dans la mesure où nous avons
924 indiqué @context{Staff} comme contexte, ce réglage ne s'appliquera qu'à la portée courante ;
925 les autres portées demeureront intactes.
928 @lilypond[quote,verbatim,relative=2,fragment]
930 \override Staff.Stem #'thickness = #4.0
936 La commande @code{\override} modifie donc la définition de l'objet @code{Stem}
937 dans le contexte @context{Staff} ; toutes les hampes qui suivent seront affectées.
939 Tout comme avec la commande @code{\set}, l'argument @var{contexte} peut être omis, auquel
940 cas le contexte par défaut (ici, @context{Voice}) sera employé. La commande @code{\once}
941 permet de n'appliquer la modification qu'une seule fois.
943 @lilypond[quote,fragment,verbatim,relative=2]
945 \once \override Stem #'thickness = #4.0
950 La commande @code{\override} doit être entrée @emph{avant} l'objet concerné.
951 Ainsi, lorsque l'on veut altérer un objet qui se prolonge, tel qu'une liaison,
952 une ligature ou tout autre objet dit @emph{Spanner}, la commande @code{\override}
953 doit être saisie avant que l'objet soit créé.
955 @lilypond[quote,fragment,verbatim,relative=2]
956 \override Slur #'thickness = #3.0
958 \override Beam #'thickness = #0.6
963 Dans cet exemple, la liaison (@emph{Slur}) est épaissie, mais non la ligature
964 (@emph{Beam}). En effet, le code qui lui est relatif n'a pas été inséré avant le début de
965 la ligature, et demeure donc sans effet.
967 De même que la commande @code{\unset}, la commande @code{\revert} défait
968 ce qui a été fait par une commande @code{\override}. Tout comme avec @code{\unset},
969 elle ne peut annuler que les réglages effectués dans le même contexte.
970 Ainsi dans l'exemple suivant, la commande @code{\revert} est sans effet.
973 \override Voice.Stem #'thickness = #4.0
974 \revert Staff.Stem #'thickness
977 Il existe, à l'intérieur même de certaines propriétés, des options que l'on
978 nomme @q{sous-propriétés}. La syntaxe est alors
980 @c leave this as a long long
982 \override @var{contexte}.@var{objet} #'@var{propriété} #'@var{sous-propriété} = #@var{valeur}
989 \override Stem #'details #'beamed-lengths = #'(4 4 3)
995 Référence du programme : @rinternals{OverrideProperty}, @rinternals{RevertProperty},
996 @rinternals{PropertySet}, @rinternals{Backend}, et
997 @rinternals{All layout objects}.
1002 La sous-couche Scheme ne vérifie pas la saisie des propriétés de façon
1003 très stricte. Des références cycliques dans des valeurs Scheme peuvent
1004 de ce fait interrompre, ou faire planter le programme -- ou bien les deux.
1007 @node Changing context default settings
1008 @subsection Changing context default settings
1010 Les réglages montrés dans les sous-sections @ref{Changing context
1011 properties on the fly}, @ref{Modifying context plug-ins} et
1012 @ref{Layout tunings within contexts} peuvent également être saisis indépendamment
1013 de la musique dans le bloc @code{\layout}, au moyen de la commande @code{\context} :
1022 \override Stem #'thickness = #4.0
1023 \remove "Time_signature_engraver"
1028 Le raccourci @code{\Staff} invoque les définitions inhérentes au contexte
1029 @context{Staff}, de façon à ce qu'elles puissent être modifiées.
1031 Les lignes suivantes affecteront toutes les portées (tous les contextes @context{Staff})
1035 \override Stem #'thickness = #4.0
1036 \remove "Time_signature_engraver"
1040 Les autres contextes peuvent être modifiés de même manière.
1042 La commande @code{\set}, dans le bloc @code{\layout}, est facultative ; aussi
1043 les lignes suivantes produiront-elles le même effet.
1055 Il est impossible de stocker des modifications de contexte dans un identificateur.
1057 Le raccourci @code{\RemoveEmptyStaffContext} détruit tous les réglages
1058 du contexte @code{\Staff}. Pour modifier des propriétés de portées gouvernées
1059 par @code{\RemoveEmptyStaffContext}, il faut le faire impérativement @emph{après}
1060 avoir invoqué @code{\RemoveEmptyStaffContext} :
1065 \RemoveEmptyStaffContext
1067 \override Stem #'thickness = #4.0
1073 @node Defining new contexts
1074 @subsection Defining new contexts
1076 Les contextes tels que @context{Staff} ou @code{Voice} sont faits
1077 de briques de constructions empilées. En combinant divers graveurs,
1078 il est possible de créer de nouveaux types de contextes.
1080 Dans l'exemple suivant, on construit, de zéro, un nouveau contexte très
1081 semblable à @context{Voice}, mais qui n'imprime que des têtes de notes en forme
1082 de barres obliques au centre de la portée. Un tel contexte, par exemple, peut
1083 servir à indiquer un passage improvisé dans un morceau de jazz.
1086 @lilypond[quote,ragged-right]
1087 \layout { \context {
1089 \type "Engraver_group"
1090 \consists "Note_heads_engraver"
1091 \consists "Text_engraver"
1092 \consists Pitch_squash_engraver
1093 squashedPosition = #0
1094 \override NoteHead #'style = #'slash
1095 \override Stem #'transparent = ##t
1099 \accepts "ImproVoice"
1103 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1104 c4 c^"dévêtez-vous" c_"tout en jouant :)" c }
1110 On a rassemblé les réglages dans un bloc @code{\context}, lui-même dans
1111 le bloc @code{\layout} :
1121 En lieu et place des points (@dots{}), voici les éléments à saisir :
1124 @item Tout d'abord, il convient de donner un nom @code{\name} à notre nouveau contexte :
1130 @item Comme il est très semblable à @context{Voice}, nous souhaitons que toutes les
1131 commandes associées au @context{Voice} déjà existant, restent valables. D'où nécessité
1132 de la commande @code{\alias}, qui va l'associer au contexte @context{Voice} :
1138 @item Ce contexte doit pouvoir imprimer des notes, et des indications textuelles ;
1139 on ajoute donc les graveurs appropriés.
1142 \consists Note_heads_engraver
1143 \consists Text_engraver
1146 @item Cependant, on veut que les notes s'affichent toutes au centre de la portée :
1149 \consists Pitch_squash_engraver
1150 squashedPosition = #0
1154 Le graveur @rinternals{Pitch_squash_engraver} intercepte les notes créées par
1155 @rinternals{Note_heads_engraver}, et les @q{écrase} pour qu'elles aient toutes la
1156 même position verticale, définie par @code{squashedPosition} : ici il s'agit de la
1157 valeur@tie{}@code{0}, c'est-à-dire la ligne du milieu.
1159 @item On veut que les notes aient la forme d'une barre oblique, sans aucune hampe :
1162 \override NoteHead #'style = #'slash
1163 \override Stem #'transparent = ##t
1166 @item Afin que tous ces graveurs puissent travailler de concert, on leur adjoint un
1167 sous-programme spécial, introduit par la commande @code{\type} : il s'agit de
1168 @rinternals{Engraver_group},
1171 \type "Engraver_group"
1176 Récapitulons -- on se retrouve avec le bloc suivant :
1181 \type "Engraver_group"
1182 \consists "Note_heads_engraver"
1183 \consists "Text_engraver"
1184 \consists Pitch_squash_engraver
1185 squashedPosition = #0
1186 \override NoteHead #'style = #'slash
1187 \override Stem #'transparent = ##t
1193 Ce n'est pas tout. En effet, on veut intégrer le nouveau contexte
1194 @context{ImproVoice} dans la hiérarchie des contextes. Tout comme le
1195 contexte @code{Voice}, sa place est au sein du contexte @code{Staff}.
1196 Nous allons donc modifier le contexte @context{Staff},
1197 au moyen de la commande @code{\accepts} :
1207 Le contraire de @code{\accepts} est @code{\denies},
1208 qui est parfois utile lorsque l'on recycle des définitions de
1209 contextes déjà existantes.
1211 Enfin, tout cela doit prendre place dans le bloc @code{\layout},
1222 \accepts "ImproVoice"
1227 On peut alors saisir la musique, comme dans l'exemple plus haut :
1235 c c_"tout en jouant :)"
1242 @node Aligning contexts
1243 @subsection Aligning contexts
1245 Il est possible d'aligner verticalement chaque nouveau contexte,
1246 en-dessous ou au-dessus, par exemple dans le cas de musique vocale
1247 (@rlearning{Vocal ensembles}) ou d'@qq{ossias}.
1250 @findex alignAboveContext
1251 @findex alignBelowContext
1253 @lilypond[quote,ragged-right]
1254 ossia = { f4 f f f }
1256 \relative c' \new Staff = "main" {
1259 \new Staff \with {alignAboveContext=main} \ossia
1260 { d8 f d f d f d f }
1267 @node Vertical grouping of grobs
1268 @subsection Vertical grouping of grobs
1270 Les objets @code{VerticalAlignment} et @code{VerticalAxisGroup}
1271 travaillent de concert. Comme leurs noms anglais l'indiquent,
1272 @code{VerticalAxisGroup} regroupe différents objets tels que les portées
1273 (@code{Staff}), les paroles (@code{Lyrics}) et ainsi de suite ; puis
1274 @code{VerticalAlignment} synchronise verticalement ces différents groupes.
1275 En général, il n'y a qu'un seul @code{VerticalAlignment} pour l'ensemble
1276 de la partition, mais chaque contexte @context{Staff}, @context{Lyrics}, etc.
1277 possède son propre @code{VerticalAxisGroup}.
1280 @node The \override command
1281 @section The @code{\override} command
1283 La commande @code{\override} permet de modifier la mise en page
1284 en détail. Examinons son utilisation concrètementet dans les détails.
1285 La syntaxe de cette commande ressemble généralement à :
1288 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
1291 La propriété @var{propriété} de l'objet @var{objet}, appartenant au contexte
1292 @var{contexte}, se voit ainsi attribuer la valeur @var{valeur}.
1295 * Constructing a tweak::
1296 * Navigating the program reference::
1297 * Layout interfaces::
1298 * Determining the grob property::
1299 * Objects connected to the input::
1300 * Using Scheme code instead of \tweak::
1301 * \set versus \override::
1302 * Difficult tweaks::
1307 @node Constructing a tweak
1308 @subsection Constructing a tweak
1310 Les commandes permettant de modifier l'apparence de la partition
1311 ressemblent en général à
1314 \override Voice.Stem #'thickness = #3.0
1318 Pour élaborer un réglage de ce type, on a besoin de connaître précisément :
1321 @item le contexte : ici @context{Voice} (la voix).
1322 @item l'objet à affecter : ici @code{Stem} (les hampes).
1323 @item la propriété à modifier : ici @code{thickness} (l'épaisseur du trait).
1324 @item la valeur désirée : ici @code{3.0} (par défaut, elle est de 1.3).
1327 Certaines @q{sous-propriétés} sont parfois contenues dans une propriété.
1328 La commande devient alors :
1331 \override Stem #'details #'beamed-lengths = #'(4 4 3)
1334 @cindex documentation exhaustive
1335 @cindex trouver des objets graphiques
1336 @cindex objets graphiques, description
1340 Pour bien des propriétés, quel que soit le type de valeur requise,
1341 attribuer la valeur @q{faux} (@code{##f} en Scheme) reviendra à désactiver
1342 complètement l'action de la propriété qui se trouve ainsi purement
1343 ignorée par LilyPond. Cela peut s'avérer fort utile pour des propriétés
1344 causant des désagréments.
1346 @c such announcements are to be avoided -vv
1348 We demonstrate how to glean this information from the notation manual
1349 and the program reference.
1354 @node Navigating the program reference
1355 @subsection Navigating the program reference
1357 Comment, par exemple, déplacer le doigté dans le fragment suivant ?
1359 @lilypond[quote,fragment,relative=2,verbatim]
1365 Sur la page de la documentation relative aux doigtés, c'est-à-dire
1366 @ref{Fingering instructions}, se trouve l'indication suivante :
1371 Référence du programme : @rinternals{Fingering}.
1376 @c outdated info; probably will delete.
1378 This fragment points to two parts of the program reference: a page
1379 on @code{FingerEvent} and one on @code{Fingering}.
1381 The page on @code{FingerEvent} describes the properties of the music
1382 expression for the input @code{-2}. The page contains many links
1383 forward. For example, it says
1386 Accepted by: @rinternals{Fingering_engraver},
1390 That link brings us to the documentation for the Engraver, the
1394 This engraver creates the following layout objects: @rinternals{Fingering}.
1397 In other words, once the @code{FingerEvent}s are interpreted, the
1398 @code{Fingering_engraver} plug-in will process them.
1402 @c I can't figure out what this is supposed to mean. -gp
1404 The @code{Fingering_engraver} is also listed to create
1405 @rinternals{Fingering} objects,
1407 @c old info? it doesn't make any sense to me with our current docs.
1409 second bit of information listed under @b{See also} in the Notation
1414 Ladite référence est disponible au format HTML, ce qui rend la navigation bien
1415 plus aisée. Il est possible soit de la lire en ligne, soit de la télécharger
1416 dans ce format. La démarche présentée ici sera plus difficle à comprendre
1417 dans un document au format PDF.
1420 Suivons le lien @rinternals{Fingering}. En haut de la nouvelle page,
1424 Fingering objects are created by: @rinternals{Fingering_engraver} and
1425 @rinternals{New_fingering_engraver}.
1428 En d'autres termes, @emph{Les indications de doigtés}
1429 (@code{Fingering} en anglais) @emph{sont créées par les graveurs
1430 @rinternals{Fingering_engraver} et @rinternals{New_fingering_engraver}.}
1432 En suivant derechef les liens propres à la référence du programme, on suit en fait
1433 le cheminement qui aboutit à la création de la partition :
1437 @item @rinternals{Fingering}:
1438 @rinternals{Fingering} objects are created by:
1439 @rinternals{Fingering_engraver}
1441 @item @rinternals{Fingering_engraver}:
1442 Music types accepted: @rinternals{fingering-event}
1444 @item @rinternals{fingering-event}:
1445 Music event type @code{fingering-event} is in Music expressions named
1446 @rinternals{FingerEvent}
1449 Ce cheminement se produit, bien sûr, en sens inverse : nous sommes ici partis
1450 du résultat, et avons abouti aux évènements (en anglais @q{Events}) engendrés
1451 par le fichier d'entrée. L'inverse est également possible : on peut partir d'un
1452 évènement, et suivre le cheminement de LilyPond qui aboutit à la création d'un
1453 ou plusieurs objets graphiques.
1455 La référence du programme peut également se parcourir comme un document normal.
1456 On y trouve des chapitres tels que
1458 @rinternals{Music definitions},
1461 @code{Music definitions}
1463 @rinternals{Translation}, ou encore @rinternals{Backend}. Chaque chapitre
1464 recense toutes les définitions employées, et les propriétés sujettes à
1467 @c -- what about adding a link to the glossary here ? -vv
1469 La Référence du programme n'est pas traduite en français -- notamment du fait
1470 qu'elle est en évolution constante, tout comme LilyPond. En revanche, les termes
1471 musicaux font l'objet d'un @commentfairelelien{glossaire} fort utile pour les utilisateurs
1476 @node Layout interfaces
1477 @subsection Layout interfaces
1479 @cindex interfaces de rendu
1480 @cindex rendu, interfaces de
1481 @cindex objets graphiques
1483 Tous les éléments de notation sont considérés comme des objets graphiques
1484 (en anglais @q{Graphical Object}, d'où le diminutif @emph{Grob}).
1485 Chaque objet est doté d'un certain nombre de propriétés (l'épaisseur du trait,
1486 l'orientation, etc.), et lié à d'autres objets.
1487 Le fonctionnement de ces objets est décrit en détail dans @rinternals{grob-interface}.
1489 Prenons l'exemple des doigtés (en anglais @q{Fingering}).
1490 La page @code{Fingering} de la Référence du programme établit une liste de définitions
1491 propres à ce type d'objets :
1494 @code{padding} (dimension, in staff space):
1500 Ce qui signifie que les doigtés doivent être maintenus à une certaine distance (@emph{padding})
1501 des notes : 0,5 unités @emph{staff-space} (espace de portée).
1504 Chaque objet peut avoir plusieurs attributs, en tant qu'élément typographique
1505 ou musical. Ainsi, un doigté (objet @q{Fingering}) possède les attributs suivants :
1510 Sa taille ne dépend pas de l'espacement horizontal, contrairement aux liaisons ou ligatures.
1513 C'est du texte -- un texte vraiment court, certes.
1516 Ce texte est imprimé au moyen d'une fonte, contrairement aux liaisons ou ligatures.
1519 Sur l'axe horizontal, le centre de ce symbole doit être aligné avec le centre de la note.
1522 Sur l'axe vertical, le symbole doit être proche de la note et de la portée.
1525 Sur l'axe vertical encore, il doit également s'ordonner avec les éventuels
1526 autres symboles, ponctuations, ou éléments textuels.
1529 Faire appliquer ces différents attributs est le rôle des @emph{interfaces},
1530 que l'on trouve en bas de la page @rinternals{Fingering}.
1533 This object supports the following interfaces:
1534 @rinternals{item-interface},
1535 @rinternals{self-alignment-interface},
1536 @rinternals{side-position-interface}, @rinternals{text-interface},
1537 @rinternals{text-script-interface}, @rinternals{font-interface},
1538 @rinternals{finger-interface}, and @rinternals{grob-interface}.
1545 Cet objet admet les interfaces suivantes :
1548 Suit la liste des interfaces en question, présentées comme autant de liens,
1549 qui conduisent sur les pages dédiées à chacune d'entre elles.
1550 Chaque interface est dotée d'un certain nombre de propriétés, dont certaines
1551 peuvent être modifiées, et d'autres non (les @q{Internal properties}, ou
1552 propriétés internes).
1554 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
1555 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
1556 son âme même, dans les fichiers source de LilyPond (voir
1557 @rlearning{Default files}), en l'occurence le fichier
1558 @file{scm/@/define@/-grobs@/.scm} :
1563 (avoid-slur . around)
1564 (slur-padding . 0.2)
1565 (staff-padding . 0.5)
1566 (self-alignment-X . 0)
1567 (self-alignment-Y . 0)
1568 (script-priority . 100)
1569 (stencil . ,ly:text-interface::print)
1570 (direction . ,ly:script-interface::calc-direction)
1571 (font-encoding . fetaNumber)
1572 (font-size . -5) ; don't overlap when next to heads.
1573 (meta . ((class . Item)
1574 (interfaces . (finger-interface
1576 text-script-interface
1578 side-position-interface
1579 self-alignment-interface
1580 item-interface))))))
1584 @dots{}où l'on découvre que l'objet @code{Fingering} n'est rien de plus qu'un
1585 amas de variables et de réglages. La page de la Référence du programme est
1586 en fait directement engendrée par cette définition.
1588 @node Determining the grob property
1589 @subsection Determining the grob property
1591 Nous voulions changer la position du chiffre @b{2} dans le fragment suivant :
1593 @lilypond[quote,fragment,relative=2,verbatim]
1599 Dans la mesure où le @b{2} est placé, verticalement, à proximité de la note qui lui
1600 correspond, nous allons devoir trouver l'interface en charge de ce placement, qui se
1601 trouve être @code{side-position-interface}. Sur la page de cette interface, on
1605 @code{side-position-interface}
1607 Position a victim object (this one) next to other objects (the
1608 support). The property @code{direction} signifies where to put the
1609 victim object relative to the support (left or right, up or down?)
1615 @code{side-position-interface}
1617 Placer l'objet affecté à proximité d'autres objets. La propriété
1618 @code{direction} indique où placer l'objet (à droite ou à gauche,
1624 En-dessous de cette description se trouve décrite la variable @code{padding} :
1629 (dimension, in staff space)
1631 Add this much extra space between objects that are next to each other.
1638 Ajouter tel espace supplémentaire entre des objets proches les uns des
1643 En augmentant la valeur de @code{padding}, on peut donc éloigner le doigté de la
1644 note. La commande suivante insère trois unités d'espace vide entre la note et le doigté :
1647 \once \override Voice.Fingering #'padding = #3
1650 En ajoutant cette commande avant la création du doigté (de l'objet @q{Fingering}),
1651 donc avant @code{c2}, on obtient le résultat suivant :
1653 @lilypond[quote,relative=2,fragment,verbatim]
1654 \once \override Voice.Fingering #'padding = #3
1661 Dans le cas présent, le réglage intervient dans le contexte @context{Voice},
1662 ce qui pouvait également se déduire de la Référence du programme, où la page
1663 du graveur @rinternals{Fingering_engraver} indique :
1666 Fingering_engraver is part of contexts: @dots{} @rinternals{Voice}
1672 Le graveur Fingering_engraver fait partie des contextes : @dots{} @rinternals{Voice}
1676 @node Objects connected to the input
1677 @subsection Objects connected to the input
1681 Dans certains cas, on peut passer par un raccourci pour arranger les
1682 objets graphiques. Lorsqu'un objet est directement engendré par un élément distinct
1683 du fichier source, on peut utiliser la commande @code{\tweak}.
1685 Dans l'accord suivant, les notes sont modifiées une par une :
1687 @lilypond[relative=2,fragment,verbatim,ragged-right]
1690 \tweak #'color #red d
1692 \tweak #'duration-log #1 a
1693 >4-\tweak #'padding #10 -.
1696 Comme on peut le voir, les propriétés sont ici modifiées directement
1697 en même temps que les objets sont saisis. Il n'est plus besoin de spécifier ni
1698 le nom de l'objet (@emph{grob}), ni le contexte dans lequel cela doit s'appliquer.
1700 Ce procédé ne marche que pour des objets directement liés aux évènements
1701 (@rinternals{Event}) du fichier source. Par exemple :
1704 @item Les têtes de notes au sein d'un accord, qui sont directement engendrées par
1705 les hauteurs indiquées
1706 @item Les signes d'articulation, engendrés par les indications de ponctuation.
1709 En revanche, les hampes ou les altérations sont engendrées par les têtes de notes,
1710 et non par des évènements dans le fichier source. De même pour les clés, qui ne
1711 sont pas directement engendrées par le fichier source, mais plutôt par le
1712 changement d'une propriété interne.
1714 En fait, très peu d'objets passent @emph{directement} du code source à la partition.
1715 Une note toute simple, par exemple @code{c4}, fait l'objet d'un traitement et n'est donc
1716 pas directement rendue ; c'est pourquoi le code suivant ne sera d'aucun effet :
1719 \tweak #'color #red c4
1723 Voir pour plus de détails @ref{Displaying music expressions}.
1726 @node Using Scheme code instead of \tweak
1727 @subsection Using Scheme code instead of @code{\tweak}
1729 L'inconvénient principal de la commande @code{\tweak} est la rigidité de sa
1730 syntaxe. Par exemple, le code suivant produit une erreur.
1733 F = \tweak #'font-size #-3 -\flageolet
1741 En d'autres termes, @code{\tweak} ne se comporte pas comme une articulation :
1742 il ne peut notamment pas être accolé avec les symboles @samp{^} ou @samp{_}.
1744 C'est en se servant du langage Scheme que l'on peut résoudre ce problème.
1745 Dans cet exemple, on a recours aux méthodes décrites dans @ref{Adding
1746 articulation to notes (example)}, en particulier quant à l'emploi de
1747 @code{\displayMusic}.
1750 F = #(let ((m (make-music 'ArticulationEvent
1751 'articulation-type "flageolet")))
1752 (set! (ly:music-property m 'tweaks)
1753 (acons 'font-size -3
1754 (ly:music-property m 'tweaks)))
1763 Ici les propriétés @code{tweak} de l'objet flageolet nommé
1764 @samp{m} (créé au moyen de @code{make-music}) sont extraites par
1765 @code{ly:music-property}, une nouvelle valeur de la taille de fonte
1766 est ajoutée à la liste de ses propriétés (grâce à la fonction Scheme
1767 @code{acons}), et le résultat de cette opération est renvoyé par @code{set!}.
1768 Le dernier élément, dans ce bloc @code{let}, est la valeur finale de
1772 @node \set versus \override
1773 @subsection @code{\set} vs. @code{\override}
1775 Si les propriétés peuvent être modifiées de deux façons, par les commandes
1776 @code{\set} et @code{\override}, c'est qu'il y a deux types de propriétés.
1778 Les contextes peuvent avoir des propriétés, dont les noms commencent par une
1779 minuscule puis comprennent une ou plusieurs majuscules (de style
1780 @code{totoTutu}). Elles ont surtout trait
1781 à la notation des éléments musicaux : par exemple, @code{localKeySignature} permet
1782 de choisir s'il faut ou non imprimer une altération, ou @code{measurePosition} permet
1783 de choisir quand il faut imprimer une barre de mesure. Ces propriétés de contextes
1784 sont appelées à changer au long de l'interprétation de la partition :
1785 @code{measurePosition} en est un exemple évident. Ces propriétés doivent
1786 être modifiées avec la commande @code{\set}.
1788 Il existe un type particulier de propriétés : les descriptions
1789 d'éléments. Ces propriétés, dont les noms commencent par une majuscule, puis comprennent
1790 une ou plusieurs majuscules (de style @code{TotoTata}), contiennent les réglages
1791 @q{par défaut} pour les objets graphiques. Ces réglages sont sous forme de liste Scheme ; on
1792 peut les consulter dans le fichier @file{scm/@/define@/-grobs@/.scm}.
1793 Les descriptions d'éléments doivent être modifiées avec la commande @code{\override}.
1795 @code{\override} est en fait un raccourci :
1798 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
1802 est plus ou moins l'équivalent de
1804 @c leave this long line -gp
1806 \set @var{contexte}.@var{objet} #'@var{propriété} = #(cons (cons '@var{propriété} @var{valeur}) <valeur précédente de @var{contexte})
1809 La valeur de @code{context} (la liste Scheme, ou @q{alist}) sert à initialiser
1810 les propriétés des objets un par un. Les objets eux-même ont leurs propriétés,
1811 dont les noms, dans la tradition du langage Scheme, comprennent un trait d'union
1812 (@code{toto-titi}). Ces propriétés internes changent constamment au cours de la mise
1813 en page : en fait, la gravure d'une page n'est autre que le calcul de toutes
1814 ces propriétés, au moyen de fonctions de rappel.
1816 La propriété @code{fontSize} est une exception : c'est un raccourci, qui équivaudrait
1817 à saisir @code{\override @dots{} #'font-size} pour tous les objets
1818 textuels. Dans la mesure où il s'agit d'une manipulation très
1819 courante, une propriété spéciale a été créée. Elle doit
1820 être modifiée avec la commande @code{\set}.
1823 @node Difficult tweaks
1824 @subsection Difficult tweaks
1826 Certains réglages sont plus délicats que d'autres.
1832 L'un d'entre eux est l'apparence des objets dits @q{spanner}, qui s'étendent
1833 horizontalement, tels que les liaisons. Si, en principe, un seul de ces objets
1834 est créé à la fois et peut donc être modifié de façon habituelle, lorsque ces
1835 objets doivent enjamber un changement de ligne, ils sont dupliqués au début
1836 du ou des systèmes suivants. Comme ces objets sont des clones de l'objet d'origine,
1837 ils en héritent toutes les propriétés, y compris les éventuelles commandes @code{\override}.
1840 En d'autres termes, une commande @code{\override} affecte toujours les deux extrémités
1841 d'un objet @q{spanner}. Pour ne modifier que la partie précédant ou suivant le changement
1842 de ligne, il faut intervenir directement dans le processus de mise en page.
1843 La fonction de rappel @code{after-line-breaking} contient toute l'opération Scheme
1844 effectuée lorsque les sauts de lignes ont été déterminés, et que des objets graphiques
1845 ont été divisés sur des systèmes différents.
1847 Dans l'exemple suivant, on définit une nouvelle opération nommée
1848 @code{my-callback}. Cette opération
1852 détermine si l'objet a été divisé à l'occasion d'un changement de ligne
1854 si oui, recherche les différents morceaux de l'objet
1856 vérifie si l'objet considéré est bien la deuxième moitié d'un objet divisé
1858 si oui, applique un espacement supplémentaire (@code{extra-offset}).
1861 On ajoute cette procédure à l'objet @rinternals{Tie} (liaison de tenue),
1862 de façon à ce que le deuxième morceau d'une liaison divisée soit rehaussé.
1865 @lilypond[quote,verbatim,ragged-right]
1866 #(define (my-callback grob)
1868 ; l'objet a-t-il été divisé ?
1869 (orig (ly:grob-original grob))
1871 ; si oui, rechercher les morceaux frères (siblings)
1872 (siblings (if (ly:grob? orig)
1873 (ly:spanner-broken-into orig) '() )))
1875 (if (and (>= (length siblings) 2)
1876 (eq? (car (last-pair siblings)) grob))
1877 (ly:grob-set-property! grob 'extra-offset '(-2 . 5)))))
1880 \override Tie #'after-line-breaking =
1887 Lorsque cette astuce va être appliquée, notre nouvelle fonction de rappel
1888 @code{after-line-breaking} devra également appeler celle d'origine
1889 (@code{after-line-breaking}), si elle existe.
1890 Ainsi, pour l'utiliser dans le cas d'un crescendo (objet @code{Hairpin}),
1891 il faudra appeler également @code{ly:hairpin::after-line-breaking}.
1894 @item Pour des raisons d'ordre technique, certains objets ne peuvent être modifiés par
1895 @code{\override}. Parmi ceux-là, les objets @code{NonMusicalPaperColumn}
1896 et @code{PaperColumn}. La commande @code{\overrideProperty} sert à les modifier, de
1897 façon similaire à @code{\once \override}, mais avec une syntaxe différente :
1901 #"Score.NonMusicalPaperColumn" % Nom de l'objet
1902 #'line-break-system-details % Nom de la propriété
1903 #'((next-padding . 20)) % valeur
1906 Notez cependant que la commande @code{\override} peut tout de même être appliquée
1907 à @code{NoteMusicalPaperColumn} et @code{PaperColumn} dans un bloc @code{\context}.