1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 612f465a01ed6b9bd806f00e450c82f314eafd91
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Valentin Villenave, Jean-Charles Malahieude
14 @c Translation checkers: Gilles Thibault
17 @node Modification des réglages prédéfinis
18 @chapter Modification des réglages prédéfinis
19 @translationof Changing defaults
21 LilyPond est conçu pour engendrer, par défaut, des partitions de la
22 plus haute qualité. Cependant, on peut parfois avoir à modifier cette
23 mise en forme par défaut. Celle-ci est réglée par tout un ensemble de
24 @qq{leviers et manettes} plus connus sous le terme de @qq{propriétés},
25 dont ce chapitre ne cherche pas à faire l'inventaire exhaustif -- le
26 chapitre @rlearning{Retouche de partition} du manuel d'initiation vous
27 en propose un aperçu. Le propos est plutôt ici de mettre en évidence
28 les différents groupes auxquels s'apparentent ces contrôles, et
29 d'expliquer comment trouver le bon levier pour obtenir tel ou tel effet
32 @cindex Référence des propriétés internes
34 Les moyens de contrôle des différents réglages sont décrits dans un
35 document séparé, @rinternalsnamed{Top,la référence des propriétés
36 internes}. Ce guide répertorie toutes les variables, fonctions et
37 autres options que 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@tie{}; il est également inclus dans la documentation
41 fournie avec le logiciel.
43 En sous-main, LilyPond se sert du langage Scheme (un dérivé du LISP)
44 comme infrastructure. Modifier les choix de mise en page revient à
45 pénétrer dans les entrailles du programme, et de ce fait requiert
46 l'emploi du Scheme. Les fragments de Scheme, dans un fichier
47 @file{.ly}, sont introduits par le caractère @emph{hash} (@code{#}),
48 improprement surnommé @qq{dièse}.
49 @footnote{Le @rextendnamed{Scheme tutorial,Tutoriel Scheme} fournit
50 quelques notions de base pour saisir des nombres, des listes, des
51 chaînes de caractères ou des symboles, en Scheme.}
54 * Contextes d'interprétation::
55 * En quoi consiste la référence des propriétés internes::
56 * Modification de propriétés::
57 * Propriétés et contextes utiles::
58 * Retouches avancées::
59 * Utilisation de fonctions musicales::
63 @node Contextes d'interprétation
64 @section Contextes d'interprétation
65 @translationof Interpretation contexts
67 Cette section traite des contextes.
70 * Tout savoir sur les contextes::
71 * Création d'un contexte::
72 * Conservation d'un contexte::
73 * Modification des greffons de contexte::
74 * Modification des réglages par défaut d'un contexte::
75 * Définition de nouveaux contextes::
76 * Ordonnancement des contextes::
82 @rlearning{Contextes et graveurs}.
84 Fichiers d'initialisation :
85 @file{ly/engraver-init.ly},
86 @file{ly/performer-init.ly}.
89 @rlsrnamed{Contexts and engravers, Contextes et graveurs}.
91 Référence des propriétés internes :
92 @rinternals{Contexts},
93 @rinternals{Engravers and Performers}.
96 @node Tout savoir sur les contextes
97 @subsection Tout savoir sur les contextes
98 @translationof Contexts explained
101 @c TODO Rethink and rewrite
103 >> > > - list of contexts: my *danger unmaintainable*
104 >> > > alarm just went off. I'm
106 I knew it would... And leaving out some of them is perfectly fine
108 I do think that a list like this, with the main contexts and a
110 description of what they do (perhaps also with a note about what
112 behavior is associated with each of them, but this may be
114 should be there, and then we could simply list the remaining ones
116 further explanation and with links to the IR.
119 @c TODO Improve layout, order and consistency of wording -td
121 @c TODO Add introduction which explains contexts in generality -td
123 @c TODO Describe propagation of property values -td
125 Les contextes sont hiérarchisés :
128 * Score -- le père de tous les contextes::
129 * Contextes de haut niveau -- les systèmes::
130 * Contextes de niveau intermédiaire -- les portées::
131 * Contextes de bas niveau -- les voix::
134 @node Score -- le père de tous les contextes
135 @unnumberedsubsubsec Score -- le père de tous les contextes
136 @translationof Score - the master of all contexts
138 Il s'agit en l'occurence du contexte le plus élevé, autrement dit le
139 plus important, en matière de notation. En effet, c'est au niveau de la
140 partition -- @emph{score} en anglais -- que se gèrent le temps et la
141 tonalité@tie{}; c'est donc là qu'il faut s'assurer que les différents
142 éléments, tels les clefs, métriques et armures sont bien répercutés sur
145 Dès lors que LilyPond rencontre un bloc @code{\score@tie{}@{@dots{}@}}
146 ou @code{\layout@tie{}@{@dots{}@}}, se crée implicitement un contexte
150 @node Contextes de haut niveau -- les systèmes
151 @unnumberedsubsubsec Contextes de haut niveau -- les systèmes
152 @translationof Top-level contexts - staff containers
154 De nombreuses partitions sont écrites sur plus d'une portée. Ces
155 portées peuvent être regroupées de différentes manières.
157 @strong{@emph{StaffGroup}}
159 Le groupe de portées est attaché par un crochet, et les barres de mesure
160 sont d'un seul tenant, de la première à la dernière portée. Le
161 @code{StaffGroup} constitue le regroupement le plus simple.
163 @strong{@emph{ChoirStaff}}
165 Ce regroupement est identique au @code{StaffGroup}, à ceci près que les
166 barres de mesure ne traversent pas l'espace inter-portées.
168 @strong{@emph{GrandStaff}}
170 Le groupe de portées est attaché par une accolade sur la gauche, et les
171 barres de mesure sont d'un seul tenant.
173 @strong{@emph{PianoStaff}}
175 Ce regroupement est identique au @code{GrandStaff}, à ceci près que le
176 nom de l'instrument sera directement attaché au système.
179 @node Contextes de niveau intermédiaire -- les portées
180 @unnumberedsubsubsec Contextes de niveau intermédiaire -- les portées
181 @translationof Intermediate-level contexts - staves
183 @strong{@emph{Staff}}
185 La portée prend en charge les clefs, barres de mesure, armures et les
186 altérations accidentelles. Un contexte @code{Staff} peut contenir
187 plusieurs contextes @code{Voice}.
189 @strong{@emph{RhythmicStaff}}
191 De même nature qu'un @code{Staff}, mais destiné à n'imprimer que du
192 rythme. Quelle que soit la hauteur, les notes seront imprimées sur une
193 même et unique ligne.
195 @strong{@emph{TabStaff}}
197 Ce contexte permet de générer des tablatures. La mise en forme par
198 défaut correspond à une tablature pour guitare, sur six lignes.
200 @strong{@emph{DrumStaff}}
202 Contexte dévolu tout spécialement aux parties de percussion@tie{}; il
203 peut contenir plusieurs @code{DrumVoice}.
205 @strong{@emph{VaticanaStaff}}
207 Identique au contexte @code{Staff}, à ceci près qu'il est tout
208 particulièrement adapté au grégorien.
210 @strong{@emph{MensuralStaff}}
212 Identique au contexte @code{Staff}, à ceci près qu'il est tout
213 particulièrement adapté au style mensural de musique ancienne.
216 @node Contextes de bas niveau -- les voix
217 @unnumberedsubsubsec Contextes de bas niveau -- les voix
218 @translationof Bottom-level contexts - voices
220 Les contextes de niveau @qq{voix} initialisent un certain nombre de
221 propriétés et activent les graveurs appropriés. S'agissant de contextes
222 du plus bas niveau, ils ne sauraient contenir d'autre contexte.
224 @strong{@emph{Voice}}
226 Correspond à une voix positionnée sur une portée. Le contexte
227 @code{Voice} s'occupe des indications de nuance, des hampes, des
228 ligatures, des scripts placés au-dessus ou au-dessous de la portée, des
229 différentes liaisons et des silences. Lorsque plusieurs voix doivent
230 cohabiter sur la même portée, il est indispensable de les instancier
233 @strong{@emph{VaticanaVoice}}
235 Fonctionnant comme le contexte @code{Voice}, il est tout
236 particulièrement destiné à gérer le grégorien.
238 @strong{@emph{MensuralVoice}}
240 Fonctionnant comme le contexte @code{Voice}, il est tout
241 particulièrement adapté aux musiques anciennes.
243 @strong{@emph{Lyrics}}
245 Correspond à une voix contenant des paroles. Le contexte @code{Lyrics}
246 gère l'impression d'une ligne de paroles.
248 @strong{@emph{DrumVoice}}
250 Contexte de voix dévolu à une portée de percussions.
252 @strong{@emph{FiguredBass}}
254 Contexte prenant en charge les objets @code{BassFigure} -- la basse
255 chiffrée -- créés à partir de ce qui a été saisi en mode
258 @strong{@emph{TabVoice}}
260 Contexte de voix dévolu au contexte @code{TabStaff}, il est
261 habituellement créé explicitement.
263 @strong{@emph{CueVoice}}
265 Contexte de voix utilisé essentiellement dans le cadre de citations
266 ajoutées à une portée -- voir @ref{Mise en forme d'une citation}. Il
267 est habituellement créé explicitement.
269 @strong{@emph{ChordNames}}
271 Permet d'imprimer des noms d'accord.
276 Then the following, which I don't know what to do with:
278 * GregorianTranscriptionVoice
279 * GregorianTranscriptionStaff
282 Engraves fretboards from chords. Not easy... Not
284 There is now some documentation on FretBoards in the NR, under
285 instrument-specific notation -- cds.
290 Hard coded entry point for LilyPond. Cannot be tuned.
292 Silently discards all musical information given to this
298 @node Création d'un contexte
299 @subsection Création d'un contexte
300 @translationof Creating contexts
302 @c TODO more complete descriptions rather than learning style
304 Lorsqu'une partition ne comporte qu'une portée avec une seule voix, les
305 contextes sont créés automatiquement. Dès que la structure s'étoffe, il
306 devient nécessaire de les créer explicitement, en suivant l'une des
307 trois méthodes suivantes@tie{}:
312 La commande la plus simple à utiliser est @code{\new}@tie{}; c'est aussi
313 la plus courte. Elle se place juste avant une expression musicale et se
317 @cindex nouveau contexte
318 @cindex contexte, création
321 \new @var{type} @var{expression_musicale}
325 où @var{type} est le nom d'un contexte (par ex. @code{Staff} ou
326 @code{Voice}). Cette commande crée un nouveau contexte et y interprète
327 le contenu de l'@var{expression_musicale}.
329 C'est ce qui se passe lorsqu'une partition comporte plusieurs
330 portées@tie{}: chaque partie qui doit apparaître sur une portée
331 spécifique est précédée d'un @code{\new@tie{}Staff}.
333 @lilypond[quote,verbatim,relative=2,ragged-right]
340 La commande @code{\new} vous permet aussi d'attribuer un nom au
341 contexte que vous créez.
344 \new @var{type} = @var{nom} @var{musique}
346 Le nom que vous spécifiez ne pourra être utilisé que s'il n'a pas déjà
347 été attribué à un autre contexte.
351 Tout comme @code{\new}, la commande @code{\context} affectera une
352 expression musicale à un objet contextuel@tie{}; elle lui attribuera de
353 surcroît un nom. La commande @code{\context} s'emploie de la façon
357 \context @var{type} = @var{nom} @var{musique}
360 LilyPond va dans un premier temps vérifier l'existence d'un contexte du
361 type @var{type} appelé @var{nom}. En l'absence d'un tel contexte,
362 LilyPond crée un nouveau contexte du nom que vous avez spécifié. Cette
363 procédure est tout à fait pertinente lorsque vous faites appel à ce
364 contexte particulier par la suite. Prenons le cas d'un chant@tie{}:
365 nous commençons par nommer la ligne mélodique,
368 \context Voice = "@b{tenor}" @var{musique}
372 de telle sorte que le texte s'aligne correctement sur les notes@tie{}:
375 \new Lyrics \lyricsto "@b{tenor}" @var{paroles}
380 L'une des autres utilisations de contextes explicitement nommés consiste
381 à fusionner deux expressions musicales dans un même contexte. Dans
382 l'exemple qui suit, notes et articulations sont saisies indépendamment.
386 arts = @{ s4-. s4-> @}
389 Elles sont ensuites fusionnées par affectation au même contexte
394 \new Staff \context Voice = "A" \music
395 \context Voice = "A" \arts
398 @lilypond[quote,ragged-right]
402 \new Staff \context Voice = "A" \music
403 \context Voice = "A" \arts
407 Grâce à ce mécanisme, vous pouvez tout à fait générer une version
408 @qq{Urtext} (édition originale) et optionnellement ajouter distinctement
409 des articulations à ces mêmes notes.
411 @cindex création de contextes
414 Voici une troisième manière de créer un contexte@tie{}:
417 \context @var{type} @var{musique}
421 Très comparable à une déclaration @code{\context@tie{}=@tie{}@var{nom}},
422 cette méthode permet de s'affranchir du type de contexte.
424 Cette variante s'utilise lorsque les expression musicales peuvent être
425 interprétées à différents niveaux, comme par exemple lorsque intervient
426 la commande @code{\applyOutput} -- pour de plus amples détails, voir
427 @rextendnamed{Running a function on all layout objects, Application
428 d'une fonction à tous les objets de mise en forme}. En l'absence de
429 @code{\context} explicite, LilyPond considère qu'il s'agit de
433 \applyOutput #'@var{contexte} #@var{fonction} % s'applique à Voice
436 Vous devrez respecter ces formulations si votre fonction doit
437 s'interpréter au niveau @code{Score} ou @code{Staff}@tie{}:
440 \applyOutput #'Score #@var{fonction}
441 \applyOutput #'Staff #@var{fonction}
447 @node Conservation d'un contexte
448 @subsection Conservation d'un contexte
449 @translationof Keeping contexts alive
451 @cindex contextes, maintien actif
452 @cindex contextes, durée de vie
454 En règle générale, un contexte disparaît dès qu'il n'y a plus rien à
455 faire. Autrement dit, un contexte @code{Voice} disparaît dès après le
456 dernier événement qu'il contient, et un contexte @code{Staff} dès que
457 les contextes @code{Voice} qu'il supporte ne contiennent plus rien.
458 Ceci peut avoir des conséquences néfastes lorsqu'il est fait référence à
459 un contexte alors disparu, comme dans le cas d'un changement de portée
460 introduit par la commande @code{\change}, l'association de paroles à
461 l'aide de la commande @code{\lyricsto} ou si des événements surviennent
462 à nouveau pour ce contexte précédemment actif.
464 Une exception cependant à cette règle@tie{}: en présence d'un contexte
465 @code{Staff} ou dans une construction @code{<<...>>}, un seul des
466 contextes @code{Voice} inclus restera actif jusqu'à la fin du contexte
467 @code{Staff} ou de la construction @code{<<...>>}, y compris s'il y
468 a des @qq{trous}. Le contexte alors persistant sera le premier
469 rencontré dans la construction @code{@{...@}} sans tenir compte des
470 éventuels @code{<<...>>} qu'elle pourrait contenir.
472 Un contexte restera actif dès lors qu'il s'y passera toujours quelque
473 chose. Un contexte @code{Staff} restera actif si l'une des voix qu'il
474 supporte est toujours active. L'un des moyens de s'en assurer
475 consiste à ajouter des silences invisibles parallèlement à la musique.
476 Vous devrez les ajouter dans tous les contextes @code{Voice} qui doivent
477 rester actifs. Nous vous conseillons, lorsque plusieurs voix
478 interviennent de manière sporadique, de toutes les maintenir actives
479 plutôt que de vous fier aux exceptions mentionnées plus haut.
481 Dans l'exemple suivant, les deux voix A et B sont maintenues actives
482 jusqu'à la fin du morceau@tie{}:
484 @lilypond[quote,verbatim]
485 musicA = \relative c'' { d4 d d d }
486 musicB = \relative c'' { g4 g g g }
489 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
490 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
495 \context Voice = "A" {
499 \context Voice = "B" {
503 \context Voice = "A" { \musicA }
504 \context Voice = "B" { \musicB }
505 \context Voice = "A" { \musicA }
516 @cindex paroles, alignement sur une mélodie épisodique
518 L'exemple suivant illustre la manière d'écrire selon cette méthode une
519 mélodie discontinue à laquelle se rattachent des paroles. Dans la
520 réalité, mélodie et accompagnement feraient l'objet de portées séparées.
522 @lilypond[quote,verbatim]
523 melody = \relative c'' { a4 a a a }
524 accompaniment = \relative c' { d4 d d d }
525 words = \lyricmode { These words fol -- low the mel -- o -- dy }
528 \new Staff = "music" {
530 \new Voice = "melody" {
532 s1*4 % Keep Voice "melody" alive for 4 bars
535 \new Voice = "accompaniment" {
540 \context Voice = "melody" { \melody }
541 \context Voice = "accompaniment" { \accompaniment }
543 \context Voice = "accompaniment" { \accompaniment }
545 \context Voice = "melody" { \melody }
546 \context Voice = "accompaniment" { \accompaniment }
551 \new Lyrics \with { alignAboveContext = #"music" }
552 \lyricsto "melody" { \words }
557 Une autre méthode, qui s'avère plus productive dans nombre de cas,
558 consiste à maintenir active la ligne mélodique en y insérant des
559 silences invisibles tout au long de l'accompagnement@tie{}:
561 @lilypond[quote,verbatim]
562 melody = \relative c'' {
568 accompaniment = \relative c' {
574 words = \lyricmode { These words fol -- low the mel -- o -- dy }
578 \new Staff = "music" {
580 \new Voice = "melody" {
584 \new Voice = "accompaniment" {
590 \new Lyrics \with { alignAboveContext = #"music" }
591 \lyricsto "melody" { \words }
597 @node Modification des greffons de contexte
598 @subsection Modification des greffons de contexte
599 @translationof Modifying context plug-ins
601 @c TODO Should this be Modifying engravers or Modifying contexts?
603 Les contextes, tels que @code{Score} ou @code{Staff}, ne contiennent
604 pas que des propriétés@tie{}; ils mettent également en œuvre certains
605 sous-programmes (@emph{plug-ins} pour employer le terme consacré) nommés
606 @qq{graveurs} (@emph{engravers} pour reprendre le terme anglais).
607 Ces sous-programmes sont chargés de créer les différents éléments de
608 notation@tie{}: on trouve ainsi dans le contexte @code{Voice} un graveur
609 @code{Note_heads_engraver}, chargé des têtes de notes et, dans le
610 contexte @code{Staff}, un graveur @code{Key_signature_engraver}, chargé
613 Vous trouverez une description exhaustive de chaque graveur dans
615 @rinternals{Engravers and Performers}.
618 Référence des propriétés internes @expansion{} Translation @expansion{} Engravers.
620 Chaque contexte mentionné dans
622 @rinternals{Contexts}
625 Référence des propriétés internes @expansion{} Translation @expansion{} Context.
627 répertorie les graveurs mis en œuvre.
629 On peut faire, au moyen de ces graveurs, sa propre @qq{cuisine}, en
630 modifiant les contextes à volonté.
632 Lorsqu'un contexte est créé, par la commande @code{\new} ou
633 @code{\context}, on peut y adjoindre un bloc @code{\with} (en anglais
634 @qq{avec}), dans lequel il est possible d'ajouter (commande
635 @code{\consists}) ou d'enlever (commande @code{\remove}) des
641 \new @var{contexte} \with @{
654 Ici les points de suspension @dots{} devront être remplacés par le nom
655 des graveurs désirés. Dans l'exemple suivant, on enlève du contexte
656 @code{Staff}, la métrique (graveur @code{Time_signature_engraver})
657 et la clé (graveur @code{Clef_engraver}).
659 @lilypond[quote,relative=1,verbatim]
665 \remove "Time_signature_engraver"
666 \remove "Clef_engraver"
673 La clé et le chiffre de mesure ont disparu de la deuxième portée. C'est
674 une méthode quelque peu radicale, puisqu'elle affectera toute la portée
675 jusqu'à la fin de la partition. L'espacement s'en trouve également
676 affecté, ce qui peut être ou non l'effet recherché. Une méthode plus
677 sophistiquée aurait été de rendre ces objets transparents (voir
678 @rlearning{Visibilité et couleur des objets}).
680 Dans l'exemple suivant, voici une mise en pratique plus utile. En temps
681 normal, les barres de mesure et la métrique sont synchronisées
682 verticalement dans toute la partition. Les graveurs qui en sont
683 responsables se nomment @code{Timing_translator} et
684 @code{Default_bar_line_engraver}. En les enlevant du contexte
685 @code{Score} pour les attribuer au contexte @code{Staff}, chaque portée
686 peut désormais avoir sa propre métrique.
688 @cindex polymétrique, partition
689 @cindex chiffres de mesure multiples
691 @lilypond[quote,verbatim]
695 \consists "Timing_translator"
696 \consists "Default_bar_line_engraver"
702 \consists "Timing_translator"
703 \consists "Default_bar_line_engraver"
712 \remove "Timing_translator"
713 \remove "Default_bar_line_engraver"
719 En règle générale, l'ordre dans lequel les graveurs sont mentionnés
720 importe peu. Il se peut toutefois qu'un graveur écrive une propriété
721 qui sera interprétée par un autre, ou qu'un graveur crée un objet
722 graphique qui sera traité par un autre@tie{}; l'ordre d'apparition de
723 ces graveurs prendra alors tout son importance.
725 Pour information, les ordonnancements suivants sont importants@tie{}:
726 le @code{Bar_engraver} devrait toujours être le premier@tie{}; le
727 @code{New_fingering_engraver} doit toujours précéder le
728 @code{Script_column_engraver}. Nous vous conseillons, pour les autres,
729 de vérifier les éventuelles dépendances.
733 @node Modification des réglages par défaut d'un contexte
734 @subsection Modification des réglages par défaut d'un contexte
735 @translationof Changing context default settings
737 La personnalisation des réglages par défaut d'un contexte, qu'il
738 s'agisse de @code{Score}, @code{Staff} ou @code{Voice}, peut se réaliser
739 indépendamment de la musique dans un bloc @code{\layout} -- placé dans
740 le bloc @code{\score} auquel ces modifications doivent s'appliquer -- au
741 moyen de la commande @code{\context}.
743 Point n'est besoin d'utiliser la commande
744 @code{\set@tie{}@var{contexte}} lorsque les réglages par défaut d'un
745 contexte sont ainsi modifiés@tie{}:
748 @lilypond[quote,verbatim]
751 a4^"Petite police, hampes épaisses, sans métrique" a a a
758 \override Stem #'thickness = #4.0
759 \remove "Time_signature_engraver"
765 Le raccourci @code{\Staff} invoque les définitions inhérentes au
766 contexte @code{Staff}, de façon à ce qu'elles puissent être modifiées.
767 Ces nouvelles spécifications affecteront toutes les portées (tous les
768 contextes @code{Staff}) de ce bloc @code{\score}.
770 Les adaptations peuvent aussi bien se faire au niveau du contexte
771 @code{Score} qu'au niveau de tous les contextes @code{Voice}.
773 Il est possible de stocker des modifications de contexte dans un
774 identificateur. Sa définition devra être précédée de l'instruction
777 @lilypond[quote,verbatim]
780 \override Stem #'thickness = #4.0
781 \remove "Time_signature_engraver"
786 \override Stem #'thickness = #-2.0
789 melody = \relative c'' {
798 s1*0^"Small, thicker stems, no time signature"
814 @c TODO: add \with in here.
817 @node Définition de nouveaux contextes
818 @subsection Définition de nouveaux contextes
819 @translationof Defining new contexts
821 @cindex contexte, création
822 @cindex graveur, affectation à un contexte
837 Les contextes tels que @code{Staff} ou @code{Voice} sont faits
838 de briques de construction empilées. En combinant divers graveurs,
839 il est possible de créer de nouveaux types de contextes.
841 Dans l'exemple suivant on construit, de zéro, un nouveau contexte très
842 semblable à @code{Voice}, mais qui n'imprime que des têtes de notes en
843 forme de barre oblique au centre de la portée. Un tel contexte peut
844 servir, par exemple, à indiquer un passage improvisé dans un morceau de
848 @lilypond[quote,ragged-right]
851 \type "Engraver_group"
852 \consists "Note_heads_engraver"
853 \consists "Rhythmic_column_engraver"
854 \consists "Text_engraver"
855 \consists Pitch_squash_engraver
856 squashedPosition = #0
857 \override NoteHead #'style = #'slash
858 \override Stem #'transparent = ##t
859 \override Flag #'transparent = ##t
863 \accepts "ImproVoice"
867 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
868 c4 c^"dévêtez-vous" c_"tout en jouant :)" c }
874 On a rassemblé les réglages dans un bloc @code{\context}, lui-même placé
875 dans le bloc @code{\layout}@tie{}:
885 En lieu et place des points (@dots{}), voici les éléments à
888 Tout d'abord, il convient de donner un nom à notre nouveau
895 Comme il est très semblable à @code{Voice}, nous souhaitons que
896 toutes les commandes associées au @code{Voice} déjà existant restent
897 valables. D'où nécessité de la commande @code{\alias}, qui va
898 l'associer au contexte @code{Voice}@tie{}:
904 Ce contexte doit pouvoir imprimer des notes et des indications
905 textuelles@tie{}; on ajoute donc les graveurs appropriés@tie{}:
908 \consists Note_heads_engraver
909 \consists Text_engraver
912 Cependant, on veut que les notes s'affichent toutes au centre de
916 \consists Pitch_squash_engraver
917 squashedPosition = #0
920 Le graveur @rinternals{Pitch_squash_engraver} intercepte les notes
921 créées par le @rinternals{Note_heads_engraver}, et les @qq{écrase} pour
922 qu'elles aient toutes la même position verticale, définie par
923 @code{squashedPosition}@tie{}: ici il s'agit de la valeur@tie{}@code{0},
924 c'est-à-dire la ligne du milieu.
926 On veut que les notes aient la forme d'une barre oblique, sans
930 \override NoteHead #'style = #'slash
931 \override Stem #'transparent = ##t
932 \override Flag #'transparent = ##t
935 Afin que tous ces graveurs puissent travailler de concert, on leur
936 adjoint un sous-programme spécial, introduit par la commande
937 @code{\type}@tie{}: il s'agit de @code{Engraver_group},
940 \type "Engraver_group"
943 Récapitulons@tie{}; on se retrouve avec le bloc suivant@tie{}:
948 \type "Engraver_group"
949 \consists "Note_heads_engraver"
950 \consists "Text_engraver"
951 \consists Pitch_squash_engraver
952 squashedPosition = #0
953 \override NoteHead #'style = #'slash
954 \override Stem #'transparent = ##t
955 \override Flag #'transparent = ##t
962 Ce n'est pas tout. En effet, on veut intégrer le nouveau contexte
963 @code{ImproVoice} dans la hiérarchie des contextes. Tout comme le
964 contexte @code{Voice}, sa place est au sein du contexte @code{Staff}.
965 Nous allons donc modifier le contexte @code{Staff},
966 au moyen de la commande @code{\accepts}@tie{}:
977 Le contraire de @code{\accepts} est @code{\denies}@tie{}; il est parfois
978 utile lorsque l'on recycle des définitions de contextes déjà existantes.
980 Enfin, tout cela doit prendre place dans le bloc @code{\layout},
991 \accepts "ImproVoice"
996 On peut alors saisir la musique, comme dans l'exemple plus haut@tie{}:
1004 c c_"tout en jouant :)"
1011 @node Ordonnancement des contextes
1012 @subsection Ordonnancement des contextes
1013 @translationof Context layout order
1015 @cindex contextes, ordonnancement
1020 Les contextes viennent en principe se positionner selon leur ordre
1021 d'apparition dans le fichier source. Lorsque plusieurs contextes sont
1022 imbriqués, le contexte englobant supportera les différents contextes
1023 mentionnés dans le fichier source, à la stricte condition qu'ils soient
1024 dûment @qq{agréés}. Les contextes imbriqués qui ne font pas partie de
1025 la @qq{liste d'agréments} du contexte englobant se retrouveront en
1026 dessous de celui-ci au lieu d'y être imbriqués.
1028 La liste des @qq{agréments} d'un contexte se gère à l'aide des
1029 instructions @code{\accepts} et @code{\denies} -- @code{\accepts} pour
1030 ajouter un contexte à la liste, et @code{\denies} pour retirer
1031 l'agrément. Il est par exemple peu conventionnel que les accords nommés
1032 apparaissent dans un contexte @code{Staff}@tie{}; autrement dit, le
1033 contexte @code{ChordNames} ne fait pas partie de la @qq{liste
1034 d'agréments} du contexte @code{Staff} par défaut. Néanmoins, et s'il
1035 devait en être ainsi, vous pourriez le spécifier.
1038 @lilypond[verbatim,quote]
1042 \chords { d1:m7 b1:min7.5- }
1047 @lilypond[verbatim,quote]
1051 \chords { d1:m7 b1:min7.5- }
1056 \accepts "ChordNames"
1062 L'instruction @code{\denies} permet, lorsqu'un nouveau contexte reprend
1063 les définitions d'un contexte existant, d'en ajuster les composantes.
1064 C'est par exemple le cas du contexte @code{VaticanaStaff}, réplique du
1065 contexte @code{Staff} au sein duquel le contexte @code{VaticanaVoice} se
1066 substitue au contexte @code{Voice} dans la @qq{liste d'agrément}.
1068 Gardez à l'esprit que, face à une instruction qui ne s'appliquerait à
1069 aucun contexte déjà existant, LilyPond créera un nouveau contexte
1070 implicite. Ceci peut engendrer une nouvelle portée ou une autre
1075 Manuel d'utilisation :
1076 @rprogram{Apparition d’une portée supplémentaire}.
1078 Fichiers d'initialisation :
1079 @file{ly/engraver-init.ly}.
1082 @node En quoi consiste la référence des propriétés internes
1083 @section En quoi consiste la référence des propriétés internes
1084 @translationof Explaining the Internals Reference
1087 * Navigation dans les références du programme::
1088 * Interfaces de rendu::
1089 * Détermination de la propriété d'un objet graphique (grob)::
1090 * Conventions de nommage::
1093 @node Navigation dans les références du programme
1094 @subsection Navigation dans les références du programme
1095 @translationof Navigating the program reference
1097 @c TODO remove this (it's in the LM)
1098 @c Replace with more factual directions
1100 Comment, par exemple, déplacer le doigté dans le fragment suivant@tie{}?
1102 @lilypond[quote,relative=2,verbatim]
1108 Sur la page de la documentation relative aux doigtés, c'est-à-dire
1109 @ref{Doigtés}, se trouve l'indication suivante@tie{}:
1115 Référence des propriétés internes : @rinternals{Fingering}.
1118 @c outdated info; probably will delete.
1120 This fragment points to two parts of the program reference: a page
1121 on @code{FingerEvent} and one on @code{Fingering}.
1123 The page on @code{FingerEvent} describes the properties of the music
1124 expression for the input @code{-2}. The page contains many links
1125 forward. For example, it says
1128 Accepted by: @rinternals{Fingering_engraver},
1132 That link brings us to the documentation for the Engraver, the
1136 This engraver creates the following layout objects: @rinternals{Fingering}.
1139 In other words, once the @code{FingerEvent}s are interpreted, the
1140 @code{Fingering_engraver} plug-in will process them.
1144 @c I can't figure out what this is supposed to mean. -gp
1146 The @code{Fingering_engraver} is also listed to create
1147 @rinternals{Fingering} objects,
1149 @c old info? it doesn't make any sense to me with our current docs.
1151 second bit of information listed under @b{See also} in the Notation
1156 Ladite référence est disponible au format HTML, ce qui rend la
1157 navigation bien plus aisée. Il est possible soit de la lire en ligne,
1158 soit de la télécharger dans ce format. La démarche présentée ici sera
1159 plus difficile à comprendre dans un document au format PDF.
1162 Suivons le lien @rinternals{Fingering}. En haut de la nouvelle page,
1166 Fingering objects are created by: @rinternals{Fingering_engraver} and
1167 @rinternals{New_fingering_engraver}.
1170 En d'autres termes, @emph{Les indications de doigtés}
1171 (@code{Fingering} en anglais) @emph{sont créées par les graveurs
1172 @rinternals{Fingering_engraver} et @rinternals{New_fingering_engraver}.}
1174 En suivant derechef les liens propres à la référence du programme, on
1175 suit en fait le cheminement qui aboutit à la création de la
1180 @item @rinternals{Fingering}:
1181 @rinternals{Fingering} objects are created by:
1182 @rinternals{Fingering_engraver}
1184 @item @rinternals{Fingering_engraver}:
1185 Music types accepted: @rinternals{fingering-event}
1187 @item @rinternals{fingering-event}:
1188 Music event type @code{fingering-event} is in Music expressions named
1189 @rinternals{FingeringEvent}
1192 Ce cheminement se produit, bien sûr, en sens inverse@tie{}: nous sommes
1193 ici partis du résultat, et avons abouti aux évènements (en anglais
1194 @emph{Events}) engendrés par le fichier d'entrée. L'inverse est
1195 également possible@tie{}: on peut partir d'un évènement, et suivre le
1196 cheminement de LilyPond qui aboutit à la création d'un ou plusieurs
1199 La référence des propriétés internes peut également se parcourir comme
1200 un document normal. On y trouve des chapitres tels que
1202 @rinternals{Music definitions},
1205 @code{Music definitions}
1207 @rinternals{Translation}, ou encore @rinternals{Backend}. Chaque
1208 chapitre recense toutes les définitions employées, et les propriétés
1209 sujettes à ajustements.
1211 @c -- what about adding a link to the glossary here ? -vv
1212 La Référence des propriétés internes n'est pas traduite en français --
1213 notamment du fait qu'elle est en évolution constante, tout comme
1214 LilyPond. En revanche, les termes musicaux font l'objet d'un
1215 @rglosnamed{Top, glossaire} fort utile pour les utilisateurs
1219 @node Interfaces de rendu
1220 @subsection Interfaces de rendu
1221 @translationof Layout interfaces
1223 @cindex interfaces de rendu
1224 @cindex rendu, interfaces de
1225 @cindex objets graphiques
1227 Tous les éléments de notation sont considérés comme des objets
1228 graphiques (en anglais @emph{Graphical Object}, d'où le diminutif
1229 @emph{Grob}). Chaque objet est doté d'un certain nombre de propriétés
1230 (l'épaisseur du trait, l'orientation, etc.), et lié à d'autres objets.
1231 Le fonctionnement de ces objets est décrit en détail dans
1232 @rinternals{grob-interface}.
1234 Prenons l'exemple des doigtés (en anglais @emph{Fingering}). La page
1235 @code{Fingering} de la Référence des propriétés internes établit une
1236 liste de définitions propres à ce type d'objet@tie{}:
1239 @code{padding} (dimension, in staff space):
1245 Ce qui signifie que les doigtés doivent être maintenus à une certaine
1246 distance (@emph{padding}) des notes@tie{}: 0,5 unités @emph{staff-space}
1249 Chaque objet peut avoir plusieurs attributs, en tant qu'élément
1250 typographique ou musical. Ainsi, un doigté (objet @emph{Fingering})
1251 possède les attributs suivants@tie{}:
1256 Sa taille ne dépend pas de l'espacement horizontal, contrairement aux
1257 liaisons ou ligatures.
1260 C'est du texte -- un texte vraiment court, certes.
1263 Ce texte est imprimé au moyen d'une fonte, contrairement aux liaisons ou
1267 Sur l'axe horizontal, le centre de ce symbole doit être aligné avec le
1271 Sur l'axe vertical, le symbole doit être proche de la note et de la
1275 Sur l'axe vertical encore, il doit également s'ordonner avec les
1276 éventuels autres symboles, ponctuations ou éléments textuels.
1279 Faire appliquer ces différents attributs est le rôle des
1280 @emph{interfaces}, que l'on trouve en bas de la page
1281 @rinternals{Fingering}.
1284 This object supports the following interfaces:
1285 @rinternals{item-interface},
1286 @rinternals{self-alignment-interface},
1287 @rinternals{side-position-interface}, @rinternals{text-interface},
1288 @rinternals{text-script-interface}, @rinternals{font-interface},
1289 @rinternals{finger-interface}, and @rinternals{grob-interface}.
1296 Cet objet admet les interfaces suivantes@tie{}:
1299 Suit la liste des interfaces en question, présentées comme autant de
1300 liens qui conduisent aux pages dédiées à chacune d'entre elles.
1301 Chaque interface est dotée d'un certain nombre de propriétés, dont
1302 certaines peuvent être modifiées, et d'autres non (les @emph{Internal
1303 properties}, ou propriétés internes).
1305 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
1306 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller
1307 explorer son âme même, dans les fichiers source de LilyPond (voir
1308 @rlearning{Autres sources de documentation}), en l'occurence le fichier
1309 @file{scm/define-grobs.scm}@tie{}:
1314 (avoid-slur . around)
1315 (slur-padding . 0.2)
1316 (staff-padding . 0.5)
1317 (self-alignment-X . 0)
1318 (self-alignment-Y . 0)
1319 (script-priority . 100)
1320 (stencil . ,ly:text-interface::print)
1321 (direction . ,ly:script-interface::calc-direction)
1322 (font-encoding . fetaText)
1323 (font-size . -5) ; don't overlap when next to heads.
1324 (meta . ((class . Item)
1325 (interfaces . (finger-interface
1327 text-script-interface
1329 side-position-interface
1330 self-alignment-interface
1331 item-interface))))))
1335 @dots{}où l'on découvre que l'objet @code{Fingering} n'est rien de plus
1336 qu'un amas de variables et de réglages. La page de la Référence des
1337 propriétés internes est en fait directement engendrée par cette
1341 @node Détermination de la propriété d'un objet graphique (grob)
1342 @subsection Détermination de la propriété d'un objet graphique (grob)
1343 @translationof Determining the grob property
1345 @c TODO remove this (it's in the LM)
1346 @c Replace with more factual directions
1348 Nous voulions changer la position du chiffre @b{2} dans le fragment
1351 @lilypond[quote,relative=2,verbatim]
1357 Dans la mesure où le @b{2} est placé, verticalement, à proximité de la
1358 note qui lui correspond, nous allons devoir trouver l'interface en
1359 charge de ce placement, qui se trouve être
1360 @code{side-position-interface}. Sur la page de cette interface, on peut
1364 @code{side-position-interface}
1366 Position a victim object (this one) next to other objects (the
1367 support). The property @code{direction} signifies where to put the
1368 victim object relative to the support (left or right, up or down?)
1374 @code{side-position-interface}
1376 Placer l'objet affecté à proximité d'autres objets. La propriété
1377 @code{direction} indique où positionner l'objet (à droite ou à gauche,
1383 En-dessous de cette description se trouve décrite la variable
1384 @code{padding}@tie{}:
1389 (dimension, in staff space)
1391 Add this much extra space between objects that are next to each other.
1398 Ajouter tel espace supplémentaire entre des objets proches les uns des
1403 En augmentant la valeur de @code{padding}, on peut donc éloigner le
1404 doigté de la note. La commande suivante insère trois unités d'espace
1405 vide entre la note et le doigté@tie{}:
1408 \once \override Voice.Fingering #'padding = #3
1411 En ajoutant cette commande avant la création du doigté (de l'objet
1412 @code{Fingering}), donc avant @code{c2}, on obtient le résultat
1415 @lilypond[quote,relative=2,verbatim]
1416 \once \override Voice.Fingering #'padding = #3
1422 Dans le cas présent, le réglage intervient dans le contexte @code{Voice},
1423 ce qui pouvait également se déduire de la Référence des propriétés
1424 internes, où la page du graveur @rinternals{Fingering_engraver}
1428 Fingering_engraver is part of contexts: @dots{} @rinternals{Voice}
1434 Le graveur Fingering_engraver fait partie des contextes@tie{}: @dots{}
1439 @node Conventions de nommage
1440 @subsection Conventions de nommage
1441 @translationof Naming conventions
1443 Afin de s'y retrouver plus aisément et d'éviter les erreurs de frappe,
1444 voici quelques conventions en matière de nommage@tie{}:
1447 @item fonctions scheme :
1448 minuscule-avec-trait-d-union (y compris noms en mot-unique)
1449 @item fonctions scheme :
1450 ly:plus-style-scheme
1451 @item événements, classes et propriétés musicaux :
1452 identique-aux-fonctions-scheme
1453 @item interfaces d'objet graphique :
1455 @item propriétés d'arrière plan :
1456 style-scheme (mais X et Y pour les axes)
1457 @item contextes (ainsi que MusicExpressions et grobs) :
1458 Capitale initiale ou Camélisation (CamelCase)
1459 @item propriétés de contexte :
1460 minusculeSuivieDeCamélisation
1462 Capitale_initiale_puis_minuscules_séparées_par_un_souligné
1465 Les questions que vous devez vous poser sont@tie{}:
1467 @item Qu'est-ce qui relève des conventions, et qu'est-ce qui relève de
1469 @item Qu'est-ce qui relève des règles du langage sous-jascent, et
1470 qu'est-ce qui est propre à LilyPond@tie{}?
1474 @node Modification de propriétés
1475 @section Modification de propriétés
1476 @translationof Modifying properties
1478 @c TODO change the menu and subsection node names to use
1479 @c backslash once the new macro to handle the refs
1480 @c is available. Need to find and change all refs at
1481 @c the same time. -td
1484 * Vue d'ensemble de la modification des propriétés::
1485 * La commande de fixation (set)::
1486 * La commande de dérogation (override)::
1487 * La commande d'affinage (tweak)::
1489 * Modification de listes associatives::
1492 @node Vue d'ensemble de la modification des propriétés
1493 @subsection Vue d'ensemble de la modification des propriétés
1494 @translationof Overview of modifying properties
1496 Chaque contexte est chargé de créer plusieurs types d'objets graphiques.
1497 Il contient également les réglages nécessaires pour chacun de ces
1498 objets. Si l'on modifie ces réglages, les objets n'auront plus la même
1501 Les contextes comportent deux types différents de propriétés@tie{}: des
1502 propriétés de contexte et des propriétés d'objet graphique. Les
1503 propriétés de contexte sont celles qui s'appliqueront globalement au
1504 contexte en tant que tel@tie{}; elles gèrent la manière dont le contexte
1505 apparaîtra. Les propriétés d'objet graphique, par contre, s'appliquent
1506 à des types particuliers d'objet qui apparaissent dans le contexte en
1509 Les commandes @code{\set} et @code{\unset} permettent de modifier les
1510 valeurs des propriétés de contexte. Les commandes @code{\override} et
1511 @code{\revert} permettent de modifier les valeurs des propriétés des
1515 La syntaxe employée pour ce faire est
1518 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
1521 Ici @var{objet} est un objet graphique, tel que @code{Stem} (les hampes)
1522 ou @code{NoteHead} (les têtes de note)@tie{}; @var{propriété} est une
1523 variable (désignée par un symbole, ce qui explique l'apostrophe)
1524 employée par le système de mise en page. La sous-section
1525 @ref{Élaboration d'une retouche} vous aidera à savoir quoi mettre à la
1526 place de @var{objet}, @var{propriété} et @var{valeur}@tie{}; notre
1527 propos n'est ici que d'examiner l'emploi de cette commande.
1529 La commande suivante@tie{}:
1532 \override Staff.Stem #'thickness = #4.0
1536 rend les hampes plus épaisses (la valeur par défaut est 1.3, ce qui
1537 signifie qu'elles sont 1,3 fois plus épaisses que les lignes de la
1538 portée). Dans la mesure où nous avons indiqué @code{Staff} comme
1539 contexte, ce réglage ne s'appliquera qu'à la portée courante@tie{}; les
1540 autres portées demeureront intactes.
1543 @lilypond[quote,verbatim,relative=2,fragment]
1545 \override Staff.Stem #'thickness = #4.0
1551 La commande @code{\override} modifie donc la définition de l'objet
1552 @code{Stem} dans le contexte @code{Staff}@tie{}; toutes les hampes qui
1553 suivent seront affectées. Tout comme avec la commande @code{\set},
1554 l'argument @var{contexte} peut être omis, auquel cas le contexte par
1555 défaut (ici, @code{Voice}) sera employé. La commande @code{\once}
1556 permet de n'appliquer la modification qu'une seule fois.
1558 @lilypond[quote,fragment,verbatim,relative=2]
1560 \once \override Stem #'thickness = #4.0
1565 La commande @code{\override} doit être entrée @emph{avant} l'objet
1566 concerné. Ainsi, lorsque l'on veut altérer un objet qui se prolonge,
1567 tel qu'une liaison, une ligature ou tout autre objet dit @emph{Spanner},
1568 la commande @code{\override} doit être saisie avant que l'objet soit
1571 @lilypond[quote,fragment,verbatim,relative=2]
1572 \override Slur #'thickness = #3.0
1574 \override Beam #'beam-thickness = #0.6
1579 Dans cet exemple, la liaison (@emph{Slur}) est épaissie, mais non la
1580 ligature (@emph{Beam}). En effet, le code qui lui est relatif n'a pas
1581 été inséré avant le début de la ligature, et demeure donc sans effet.
1583 De même que la commande @code{\unset}, la commande @code{\revert} défait
1584 ce qui a été fait par une commande @code{\override}. Tout comme avec
1585 @code{\unset}, elle ne peut annuler que les réglages effectués dans le
1586 même contexte. Ainsi dans l'exemple suivant, la commande @code{\revert}
1590 \override Voice.Stem #'thickness = #4.0
1591 \revert Staff.Stem #'thickness
1594 Il existe, à l'intérieur même de certaines propriétés, des options que
1595 l'on nomme @q{sous-propriétés}. La syntaxe est alors
1597 @c leave this as a long long
1599 \override @var{contexte}.@var{objet} #'@var{propriété} #'@var{sous-propriété} = #@var{valeur}
1603 Ainsi, par exemple@tie{}:
1606 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1612 Référence des propriétés internes :
1613 @rinternals{Backend},
1614 @rinternals{All layout objects},
1615 @rinternals{OverrideProperty},
1616 @rinternals{RevertProperty},
1617 @rinternals{PropertySet}.
1622 La sous-couche Scheme ne vérifie pas la saisie des propriétés de façon
1623 très stricte. Des références cycliques dans des valeurs Scheme peuvent
1624 de ce fait interrompre ou faire planter le programme -- ou bien les
1628 @node La commande de fixation (set)
1629 @subsection La commande de fixation @code{@bs{}set}
1630 @translationof The set command
1633 @cindex modifier des propriétés
1636 Chaque contexte peut avoir plusieurs @emph{propriétés}, c'est-à-dire
1637 des variables qu'il inclut. Ces dernières peuvent être modifiées @qq{à
1638 la volée}, c'est-à-dire pendant que la compilation s'accomplit. C'est
1639 là le rôle de la commande @code{\set}.
1642 \set @var{contexte}.@var{propriété} = #@var{valeur}
1645 Dans la mesure où @var{valeur} est constituée d'un objet Scheme, elle
1646 doit être précédée du caractère@tie{}@code{#}.
1648 Les propriétés des contextes se libellent sous la forme
1649 @code{minusculeMajuscule}. Leur rôle consiste principalement à traduire
1650 la musique en notation@tie{}: par exemple, @code{localKeySignature}
1651 déterminera quand imprimer une altération accidentelle, et
1652 @code{measurePosition} quand imprimer une barre de mesure. La valeur
1653 des propriétés des contextes peuvent évoluer au fur et à mesure que l'on
1654 avance dans le morceau -- @code{measurePosition} en est l'illustration
1657 Ainsi la propriété de contexte @code{skipBars} permet de condenser les
1658 mesures vides de notes, en des silences multimesures. Il s'agit d'un
1659 objet Scheme, auquel on attribue la valeur booléenne @qq{vrai},
1660 c'est-à-dire la lettre @code{#t} pour @qq{True} en anglais@tie{}:
1662 @lilypond[quote,verbatim,relative=2]
1664 \set Score.skipBars = ##t
1668 Si l'argument @var{contexte} n'est pas spécifié, alors la propriété
1669 cherchera à s'appliquer dans le contexte le plus restreint où elle est
1670 employée@tie{}: le plus souvent @code{ChordNames}, @code{Voice} ou
1673 @lilypond[quote,verbatim,relative=2]
1674 \set Score.autoBeaming = ##f
1678 \set autoBeaming = ##t
1686 Ce changement étant appliqué @qq{à la volée}, il n'affecte que le second
1689 Notez que le contexte le plus restreint n'est pas toujours le bon, et
1690 peut ne pas contenir la propriété qui vous intéresse@tie{}: ainsi, la
1691 propriété @code{skipBars}, évoquée plus haut, ne relève pas du contexte
1692 @code{Voice}, mais du contexte @code{Score} -- le code suivant ne
1695 @lilypond[quote,verbatim,relative=2]
1701 Les contextes s'organisent de façon hiérarchique@tie{}: aussi, lorsqu'un
1702 contexte de niveau supérieur est spécifié (par exemple @code{Staff}), la
1703 propriété sera modifée dans tous les contextes inférieurs (tous les
1704 contextes @code{Voice}, par exemple) qu'il contient.
1708 La commande @code{\unset} permet d'annuler la définition d'une
1712 \unset @var{contexte}.@var{propriété}
1716 si et seulement si cette propriété a été définie dans ce @var{contexte}
1717 précis. En d'autres termes, la commande @code{\unset} doit
1718 impérativement affecter le même contexte que la commande @code{\set}
1719 d'origine, même en cas d'imbrication.
1721 @lilypond[quote,verbatim,relative=2]
1722 \set Score.autoBeaming = ##t
1727 \unset Score.autoBeaming
1735 Si l'on se trouve dans le contexte le plus restreint, il n'est pas
1736 obligatoire, là encore, de spécifier le @var{contexte}. Ainsi, les deux
1737 lignes suivantes sont équivalentes.
1740 \set Voice.autoBeaming = ##t
1741 \set autoBeaming = ##t
1746 Pour modifier une propriété de façon à ce que l'accommodement ne
1747 s'applique qu'une seule fois, il convient d'adjoindre l'instruction
1748 @code{\once} à la commande @code{\set}@tie{}:
1750 @lilypond[quote,verbatim,relative=2]
1752 \once \set fontSize = #4.7
1757 Ici le changement de taille est annulé aussitôt après la note concernée.
1759 La référence des propriétés internes contient une description exhaustive
1760 de toutes les propriétés, contexte par contexte@tie{}: voir
1762 @rinternals{Tunable context properties}.
1765 Translation @expansion{} Tunable context properties.
1771 Référence des propriétés internes :
1772 @rinternals{Tunable context properties}.
1775 @node La commande de dérogation (override)
1776 @subsection La commande de dérogation @code{@bs{}override}
1777 @translationof The override command
1779 @cindex grob, propriétés
1780 @cindex objet graphique, propriétés
1781 @cindex propriétés d'un grob
1782 @cindex propriétés d'objet graphique
1786 La commande @code{\override} permet de modifier la mise en forme des
1787 objets graphiques. Les descriptions d'objet graphique, dont les noms
1788 commencent par une majuscule, puis comprennent une ou plusieurs
1789 majuscules (de style @code{TotoTata}), contiennent les réglages @qq{par
1790 défaut} pour les objets graphiques. Ces réglages sont sous forme de
1791 liste Scheme@tie{}; on peut les consulter dans le fichier
1792 @file{scm/define-grobs.scm}.
1794 @code{\override} est en fait un raccourci@tie{}:
1797 \override @var{contexte}.@var{NomObjet} #'@var{propriété} = #@var{valeur}
1801 plus ou moins équivalent à
1803 @c leave this long line -gp
1805 \set @var{contexte}.@var{NomObjet} =
1806 #(cons (cons '@var{propriété} @var{valeur})
1807 <valeur antérieure de @var{contexte}.@var{NomObjet}>)
1810 La valeur de @var{contexte}.@var{NomObjet} (une liste associative, ou
1811 @emph{alist}) permet d'initialiser les propriétés des objets un par un.
1812 Les objets eux-même ont leurs propriétés, dont les noms, dans la
1813 tradition du langage Scheme, comprennent un trait d'union
1814 (@code{toto-titi}). Ces propriétés internes changent constamment au
1815 cours de la mise en page@tie{}: en fait, la gravure d'une page n'est
1816 autre que le calcul de toutes ces propriétés au moyen de fonctions de
1819 Nous pouvons donc par exemple accroître l'épaisseur des hampes en jouant
1820 sur la propriété @code{thickness} de l'objet @code{stem}@tie{}:
1822 @lilypond[quote,verbatim,relative=2]
1824 \override Voice.Stem #'thickness = #3.0
1828 Lorsqu'aucun contexte n'est spécifié dans une clause @code{\override},
1829 celle-ci s'appliquera au contexte le plus bas@tie{}:
1831 @lilypond[quote,verbatim,relative=2]
1832 { \override Staff.Stem #'thickness = #3.0
1836 \override Stem #'thickness = #0.5
1845 @cindex annulation d'un override
1846 @cindex override, annulation des effets
1849 Les effets d'un @code{\override} prennent fin à l'aide de l'instruction
1850 @code{\revert}@tie{}:
1852 @lilypond[quote,verbatim,relative=2]
1854 \override Voice.Stem #'thickness = #3.0
1856 \revert Voice.Stem #'thickness
1860 Les effets d'un @code{\override} ou d'un @code{\revert} s'appliquent dès
1861 l'endroit où ils apparaissent, et à tous les objets dans le contexte
1864 @lilypond[quote,verbatim,relative=2]
1869 \override Staff.Stem #'thickness = #3.0
1873 \revert Staff.Stem #'thickness
1880 @cindex override ponctuel
1883 L'instruction @code{\override} doit être précédée d'un @code{\once} dès
1884 lors que les effets de l'accomodement ne concernent que l'événement qui
1885 la suit directement@tie{}:
1887 @lilypond[quote,verbatim,relative=2]
1891 \override Stem #'thickness = #3.0
1895 \once \override Stem #'thickness = #3.0
1903 Les commandes permettant de modifier l'apparence de la partition
1904 ressemblent en général à
1907 \override Voice.Stem #'thickness = #3.0
1911 Pour élaborer un réglage de ce type, on a besoin de connaître
1915 @item le contexte@tie{}: ici @code{Voice} (la voix).
1916 @item l'objet à affecter@tie{}: ici @code{Stem} (les hampes).
1917 @item la propriété à modifier@tie{}: ici @code{thickness} (l'épaisseur
1919 @item la valeur désirée@tie{}: ici @code{3.0} (par défaut, elle est de
1923 Certaines @q{sous-propriétés} sont parfois contenues dans une propriété.
1924 La commande devient alors@tie{}:
1927 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1930 @cindex documentation exhaustive
1931 @cindex trouver des objets graphiques
1932 @cindex objets graphiques, description
1936 Pour bien des propriétés, quel que soit le type de valeur requise,
1937 attribuer la valeur @q{faux} (@code{##f} en Scheme) reviendra à
1938 désactiver complètement l'action de la propriété qui se trouve ainsi
1939 purement ignorée par LilyPond. Cela peut s'avérer fort utile pour des
1940 propriétés causant des désagréments.
1947 Référence des propriétés internes :
1948 @rinternals{Backend}
1951 @node La commande d'affinage (tweak)
1952 @subsection La commande d'affinage @code{@bs{}tweak}
1953 @translationof The tweak command
1955 @cindex retouche (tweak)
1956 @cindex affinage (tweak)
1957 @cindex tweak (retouche, affinage)
1960 L'utilisation d'un @code{\override} pour modifier les propriétés d'un
1961 objet graphique affectera toutes les instances de l'objet en question au
1962 sein du contexte, et ce dès son apparition. Il peut parfois être
1963 préférable de n'affecter qu'un seul objet en particulier plutôt que tous
1964 les objets du contexte. C'est là rôle de l'instruction @code{\tweak},
1965 dont la syntaxe est@tie{}:
1968 \tweak #'@code{objet-propriété} #@code{valeur}
1971 La commande @code{\tweak} s'applique à l'objet qui apparait
1972 immédiatement après @code{valeur}.
1975 Dans certains cas, on peut passer par un raccourci pour arranger les
1976 objets graphiques. Lorsqu'un objet est directement engendré par un
1977 élément distinct du fichier source, on peut utiliser la commande
1980 Dans l'accord suivant, les notes sont modifiées une par une@tie{}:
1982 @lilypond[relative=2,verbatim,ragged-right]
1988 \tweak #'duration-log #1
1991 -\tweak #'padding #8
1995 Comme on peut le voir, les propriétés sont ici modifiées directement
1996 en même temps que les objets sont saisis. Il n'est plus besoin de
1997 spécifier ni le nom de l'objet (@emph{grob}), ni le contexte dans lequel
1998 cela doit s'appliquer. Ce procédé ne marche que pour des objets
1999 directement liés aux évènements (@rinternals{Event}) du fichier source.
2003 @item Les têtes de notes au sein d'un accord, qui sont directement
2004 engendrées par les hauteurs indiquées
2006 @item Les signes d'articulation, engendrés par les indications de
2010 En revanche, les hampes ou les altérations sont engendrées par les têtes
2011 de notes, et non par des évènements dans le fichier source. De même
2012 pour les clés, qui ne sont pas directement engendrées par le fichier
2013 source, mais plutôt par le changement d'une propriété interne.
2015 En fait, très peu d'objets passent @emph{directement} du code source à
2016 la partition. Une note toute simple, par exemple @code{c4}, fait l'objet
2017 d'un traitement et n'est donc pas directement rendue@tie{}; c'est
2018 pourquoi le code suivant ne sera d'aucun effet@tie{}:
2021 \tweak #'color #red c4
2025 Voir pour plus de détails
2026 @rextendnamed{Displaying music expressions,Affichage d'expressions musicales}.
2029 Pour une introduction à la syntaxe et l'utilisation des retouches, voir
2030 le chapitre @rlearning{Méthodes de retouche}.
2032 Lorsque plusieurs éléments de même nature surviennent au même instant,
2033 il devient impossible d'utiliser l'instruction @code{\override} pour
2034 n'en modifier qu'un seul individuellement, d'où l'intérêt de la commande
2035 @code{\tweak}. Entre autres éléments qui sont susceptibles de se
2036 produire au même instant, nous citerons@tie{}:
2038 @c TODO expand to include any further uses of \tweak
2040 @item les têtes de notes au sein d'un accord,
2041 @item les signes d'articulation,
2042 @item les liaisons de prolongation sur des notes d'un accord,
2043 @item les crochets de nolets démarrant au même instant
2046 @c TODO add examples of these
2048 Dans l'exemple suivant, l'une des têtes de note de l'accord est
2049 colorisée, et l'aspect d'une autre est changé.
2051 @lilypond[relative=2,verbatim,quote]
2056 \tweak #'duration-log #1
2061 L'instruction @code{\tweak} permet aussi de modifier l'aspect d'une
2064 @lilypond[verbatim,quote,relative=1]
2065 c-\tweak #'thickness #5 ( d e f)
2068 La commande @code{\tweak} ne sera pleinement fonctionnelle que si elle
2069 est directement rattachée à l'objet auquel elle doit s'appliquer alors
2070 que le fichier source est converti en flux musical. LilyPond peut
2071 parfois être amené à ajouter d'autres éléments au flux musical lors de
2072 la phase d'analyse. C'est la raison pour laquelle, puisque LilyPond
2073 peut insérer une note dans un accord alos qu'elle n'en fait pas partie
2074 explicitement, il est impératif d'adopter une construction d'accord
2075 lorsque l'instruction @code{\tweak} concerne une note isolée@tie{}:
2077 @lilypond[relative=2,verbatim,quote]
2078 \tweak #'color #red c4
2079 <\tweak #'color #red c>4
2082 La commande @code{\tweak} ne saurait servir à modifier un élément qui ne
2083 serait pas explicitement mentionné dans le fichier source. C'est
2084 notamment le cas des hampes, ligatures ou altérations, dans la mesure où
2085 elles seront ultérieurement générées et après les têtes de note, plutôt
2086 qu'au fil des éléments musicaux saisis. La commande @code{\tweak} ne
2087 peut non plus servir à modifier clefs ou métriques, puisqu'elles seront
2088 immanquablement séparées du @code{\tweak} par l'insertion automatique
2089 d'autres éléments requis pour spécifier le contexte.
2091 Plusieurs commandes @code{\tweak} en enfilade permettent d'affecter un
2092 même élément de notation@tie{}:
2094 @lilypond[verbatim,quote,relative=1]
2096 -\tweak #'style #'dashed-line
2097 -\tweak #'dash-fraction #0.2
2098 -\tweak #'thickness #3
2099 -\tweak #'color #red
2104 Vous pouvez examiner le flux musical généré par une portion de votre
2105 fichier source, y compris les éléments automatiquement insérés, en
2106 suivant les indications portées à la rubrique
2107 @rextendnamed{Displaying music expressions,Affichage d'expressions
2108 musicales}. Ceci s'avère tout à fait approprié pour déterminer ce qui
2109 peut se modifier à l'aide d'un @code{\tweak} ou bien vous aider à
2110 rectifier votre source de telle sorte que le @code{\tweak} produise ses
2115 Manuel d'initiation :
2116 @rlearning{Méthodes de retouche}.
2118 Manuel d'extension :
2119 @rextendnamed{Displaying music expressions, Affichage d'expressions musicales}.
2124 @cindex tweak et identificateur
2125 La commande @code{\tweak} ne peut s'utiliser dans une variable.
2127 @cindex tweaks et paroles
2128 La commande @code{\tweak} est inopérante en mode @code{\lyricmode}.
2130 @cindex tweaking control points
2131 @cindex control points, tweaking
2132 Lorsqu'il y a plusieurs liaisons de prolongation dans un accord, la
2133 commande @code{\tweak} ne s'applique qu'à la première.
2136 @node set ou override
2137 @subsection @code{\set} ou @code{\override}
2138 @translationof set versus override
2140 @c TODO -- This section is probably unnecessary now.
2143 Si les propriétés peuvent être modifiées de deux façons, par les
2144 commandes @code{\set} et @code{\override}, c'est qu'il y a deux types de
2147 La propriété @code{fontSize} est une exception@tie{}: c'est un
2148 raccourci, qui équivaudrait à saisir @w{@code{\override @dots{}
2149 #'font-size}} pour tous les objets textuels. Dans la mesure où il
2150 s'agit d'une manipulation très courante, une propriété spéciale a été
2151 créée. Elle doit être modifiée avec la commande @code{\set}.
2156 @node Modification de listes associatives
2157 @subsection Modification de listes associatives
2158 @translationof Modifying alists
2160 Certaines propriétés configurables par l'utilisateur se présentent en
2161 interne comme étant des listes associatives -- les puristes diront des
2162 @emph{alists}. Une @emph{alist} est en fait constituée de plusieurs
2163 paires de @emph{clés} et @emph{valeurs}@tie{}; sa structure ressemble
2167 '((@var{clé1} . @var{valeur1})
2168 (@var{clé2} . @var{valeur2})
2169 (@var{clé3} . @var{valeur3})
2173 Dans le cas où cette liste représente les propriétés d'un objet
2174 graphique ou bien l'une des variables du bloc @code{\paper}, chaque clé
2175 peut être modifiée individuellement sans que cela n'affecte les autres.
2177 Par exemple, pour réduire l'espacement entre deux portées adjacentes
2178 d'un même système, on utilisera la propriété @code{staff-staff-spacing}
2179 qui est attachée à l'objet graphique @code{StaffGrouper}. Cette
2180 propriété est constituée d'une liste de quatre clés@tie{}:
2181 @code{basic-distance}, @code{minimum-distance}, @code{padding} et
2182 @code{stretchability}. Ses réglages par défaut tels que mentionnés à la
2183 rubrique @emph{Backend} de la référence des propriétés internes -- voir
2184 @rinternals{StaffGrouper} -- sont@tie{}:
2187 '((basic-distance . 9)
2188 (minimum-distance . 7)
2190 (stretchability . 5))
2193 Afin de rapprocher nos deux portées, il suffit de réduire la valeur
2194 (@code{9}) de la clé @code{basic-distance} au niveau de celle de la clé
2195 @code{minimum-distance} (@code{7}). La modification d'une seule clé
2196 individuellement peut se réaliser sous la forme d'une @emph{déclaration
2199 @lilypond[quote,verbatim]
2200 % default space between staves
2202 \new Staff { \clef treble c''1 }
2203 \new Staff { \clef bass c1 }
2206 % reduced space between staves
2207 \new PianoStaff \with {
2208 % this is the nested declaration
2209 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
2211 \new Staff { \clef treble c''1 }
2212 \new Staff { \clef bass c1 }
2216 Le recours à une déclaration imbriquée touchera la clé indiquée
2217 (@code{basic-distance} dans l'exemple ci-dessus) sans pour autant
2218 modifier les autres clés de la propriété considérée.
2220 Considérons maintenant que nous souhaitions que les portées soient le
2221 plus proche possible les unes des autres, à la limite du chevauchement.
2222 Il suffirait de mettre les quatre clés à zéro. Nous pourrions saisir
2223 quatre déclarations, chacune d'elles touchant une clé. Nous pouvons
2224 tout aussi bien redéfinir la propriété en une seule clause, sous la
2225 forme d'une liste associative@tie{}:
2227 @lilypond[quote,verbatim]
2228 \new PianoStaff \with {
2229 \override StaffGrouper #'staff-staff-spacing =
2230 #'((basic-distance . 0)
2231 (minimum-distance . 0)
2233 (stretchability . 0))
2235 \new Staff { \clef treble c''1 }
2236 \new Staff { \clef bass c1 }
2240 N'oubliez pas que dès lors qu'une clé n'apparaît pas dans la liste, elle
2241 retourne à sa valeur @emph{sauf-mention-contraire}. Autrement dit, dans
2242 le cas de @code{staff-staff-spacing} qui nous occupe, toutes les clés
2243 non mentionnées seront ramenées à zéro -- à l'exception de
2244 @code{stretchability} qui prend par défaut la valeur de
2245 @code{basic-distance}. Les deux assertions suivantes sont donc
2249 \override StaffGrouper #'staff-staff-spacing =
2250 #'((basic-distance . 7))
2252 \override StaffGrouper #'staff-staff-spacing =
2253 #'((basic-distance . 7)
2254 (minimum-distance . 0)
2256 (stretchability . 7))
2259 L'une des conséquences, parfois involontaire, de ceci est la supression
2260 de réglages standards effectués par un fichier d'initialisation chargé à
2261 chaque compilation de votre fichier source. Dans l'exemple précédent,
2262 les réglages standards de @code{padding} et @code{minimum-distance},
2263 tels que déterminés par @file{scm/define-grobs.scm}, se voient ramenés à
2264 leur valeur @emph{si-non-définie}@tie{}; autrement dit, les deux clés
2265 sont mises à zéro. La définition d'une propriété ou d'une variable sous
2266 forme de liste associative, quelle qu'en soit la taille, réinitialisera
2267 toujours les clés non mentionnées à leur valeur @emph{si-non-définie}.
2268 Si telle n'est pas votre intention, nous vous recommandons alors de
2269 régler la valeur des clés individuellement par des déclarations
2272 @warning{Les déclarations imbriquées ne sont pas fonctionnelles dans le
2273 cas des listes associatives des propriétés de contexte -- telles
2274 @code{beamExceptions}, @code{keySignature},
2275 @code{timeSignatureSettings}, etc. Ces propriétés ne sont modifiables
2276 qu'au travers d'une complète redéfinition de leur liste associative.}
2279 @node Propriétés et contextes utiles
2280 @section Propriétés et contextes utiles
2281 @translationof Useful concepts and properties
2286 * Direction et positionnement::
2287 * Distances et unités de mesure::
2288 * Propriétés des symboles de la portée::
2289 * Extenseurs et prolongateurs::
2290 * Visibilité des objets::
2292 * Rotation des objets::
2295 @node Modes de saisie
2296 @subsection Modes de saisie
2297 @translationof Input modes
2302 @node Direction et positionnement
2303 @subsection Direction et positionnement
2304 @translationof Direction and placement
2309 @node Distances et unités de mesure
2310 @subsection Distances et unités de mesure
2311 @translationof Distances and measurements
2316 @node Propriétés des symboles de la portée
2317 @subsection Propriétés des symboles de la portée
2318 @translationof Staff symbol properties
2323 @node Extenseurs et prolongateurs
2324 @subsection Extenseurs et prolongateurs
2325 @translationof Spanners
2330 @unnumberedsubsubsec Utilisation de @code{spanner-interface}
2331 @unnumberedsubsubsec Utilisation de @code{line-spanner-interface}
2332 @node Visibilité des objets
2333 @subsection Visibilité des objets
2334 @translationof Visibility of objects
2340 * Suppression des stencils::
2341 * Transparence des objets::
2342 * Blanchiment des objets::
2343 * Utilisation de break-visibility::
2344 * Considérations spécifiques::
2347 @node Suppression des stencils
2348 @unnumberedsubsubsec Suppression des stencils
2349 @translationof Removing the stencil
2354 @node Transparence des objets
2355 @unnumberedsubsubsec Transparence des objets
2356 @translationof Making objects transparent
2361 @node Blanchiment des objets
2362 @unnumberedsubsubsec Blanchiment des objets
2363 @translationof Painting objects white
2368 @node Utilisation de break-visibility
2369 @unnumberedsubsubsec Utilisation de break-visibility
2370 @translationof Using break-visibility
2375 @node Considérations spécifiques
2376 @unnumberedsubsubsec Considérations spécifiques
2377 @translationof Special considerations
2382 @node Styles de ligne
2383 @subsection Styles de ligne
2384 @translationof Line styles
2389 @node Rotation des objets
2390 @subsection Rotation des objets
2391 @translationof Rotating objects
2397 * Rotation des objets de mise en forme::
2398 * Rotation des étiquettes::
2401 @node Rotation des objets de mise en forme
2402 @unnumberedsubsubsec Rotation des objets de mise en forme
2403 @translationof Rotating layout objects
2408 @node Rotation des étiquettes
2409 @unnumberedsubsubsec Rotation des étiquettes
2410 @translationof Rotating markup
2415 @node Retouches avancées
2416 @section Retouches avancées
2417 @translationof Advanced tweaks
2423 * Alignement des objets::
2424 * Regroupement vertical d'objets graphiques::
2425 * Modification des stencils::
2426 * Modification de l'allure des éléments::
2429 @node Alignement des objets
2430 @subsection Alignement des objets
2431 @translationof Aligning objects
2437 * Détermination directe de @code{X-offset} et @code{Y-offset}::
2438 * Utilisation de @code{side-position-interface}::
2439 * Utilisation de @code{self-alignment-interface}::
2440 * Utilisation de @code{aligned-on-parent}::
2441 * Utilisation de @code{centered-on-parent}::
2442 * Utilisation de @code{break-aligned-interface}::
2445 @node Détermination directe de @code{X-offset} et @code{Y-offset}
2446 @unnumberedsubsubsec Détermination directe de @code{X-offset} et @code{Y-offset}
2447 @translationof Setting @code{X-offset} and @code{Y-offset} directly
2452 @node Utilisation de @code{side-position-interface}
2453 @unnumberedsubsubsec Utilisation de @code{side-position-interface}
2454 @translationof Using the @code{side-position-interface}
2459 @node Utilisation de @code{self-alignment-interface}
2460 @unnumberedsubsubsec Utilisation de @code{self-alignment-interface}
2461 @translationof Using the @code{self-alignment-interface}
2465 @node Utilisation de @code{aligned-on-parent}
2466 @unnumberedsubsubsec Utilisation de @code{aligned-on-parent}
2467 @translationof Using the @code{centered-on-parent} procedures
2471 @node Utilisation de @code{centered-on-parent}
2472 @unnumberedsubsubsec Utilisation de @code{centered-on-parent}
2473 @translationof Using the @code{centered-on-parent} procedures
2477 @node Utilisation de @code{break-aligned-interface}
2478 @unnumberedsubsubsec Utilisation de @code{break-aligned-interface}
2479 @translationof Using the @code{break-alignable-interface}
2484 @node Regroupement vertical d'objets graphiques
2485 @subsection Regroupement vertical d'objets graphiques
2486 @translationof Vertical grouping of grobs
2488 Les objets @code{VerticalAlignment} et @code{VerticalAxisGroup}
2489 travaillent de concert. Comme leurs noms anglais l'indiquent,
2490 @code{VerticalAxisGroup} regroupe différents objets tels que les portées
2491 (@code{Staff}), les paroles (@code{Lyrics}) et ainsi de suite@tie{};
2492 puis @code{VerticalAlignment} synchronise verticalement ces différents
2493 groupes. En général, il n'y a qu'un seul @code{VerticalAlignment} pour
2494 l'ensemble de la partition, mais chaque contexte @code{Staff},
2495 @code{Lyrics}, etc. possède son propre @code{VerticalAxisGroup}.
2498 @node Modification des stencils
2499 @subsection Modification des stencils
2500 @translationof Modifying stencils
2505 @node Modification de l'allure des éléments
2506 @subsection Modification de l'allure des éléments
2507 @translationof Modifying shapes
2510 * Modification des liaisons::
2513 @node Modification des liaisons
2514 @unnumberedsubsubsec Modification des liaisons
2515 @translationof Modifying ties and slurs
2520 @node Utilisation de fonctions musicales
2521 @section Utilisation de fonctions musicales
2522 @translationof Using music functions
2525 * Syntaxe d'une fonction de substitution::
2526 * Exemples de fonction de substitution::
2529 @node Syntaxe d'une fonction de substitution
2530 @subsection Syntaxe d'une fonction de substitution
2531 @translationof Substitution function syntax
2536 @node Exemples de fonction de substitution
2537 @subsection Exemples de fonction de substitution
2538 @translationof Substitution function examples