@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 904ea9fed4c66f5b86f3ac6ffb9fa273f082f371
+ Translation of GIT committish: f199e875f7a7beb0afd17eae2038819baab767ff
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.15.39"
+@c \version "2.17.6"
@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: Gilles Thibault
@knownissues
+L'ordre dans lequel les graveurs sont spécifiés correspond à leur ordre
+d'apparition dans le processus d'élaboration de la partition.
En règle générale, l'ordre dans lequel les graveurs sont mentionnés
importe peu. Il se peut toutefois qu'un graveur écrive une propriété
qui sera interprétée par un autre, ou qu'un graveur crée un objet
ces graveurs prendra alors tout son importance.
Pour information, les ordonnancements suivants sont importants :
-le @code{Bar_engraver} devrait toujours être le premier ; le
-@code{New_fingering_engraver} doit toujours précéder le
-@code{Script_column_engraver}. Nous vous conseillons, pour les autres,
-de vérifier les éventuelles dépendances.
+
+@itemize
+@item
+le @code{Bar_engraver} devrait toujours être le premier ;
+
+@item
+le @code{New_fingering_engraver} doit toujours précéder le
+@code{Script_column_engraver} ;
+
+@item
+le @code{Timing_translator} doit toujours précéder le
+@code{Bar_number_engraver}.
+
+@end itemize
+
+@seealso
+Fichiers d'initialisation :
+@file{ly/engraver-init.ly}.
@subsection Modification des réglages par défaut d'un contexte
@translationof Changing context default settings
+@cindex réglages par défaut, modification
+@cindex contexte, modification des propriétés par défaut
+
+Les propriétés des contextes et objets graphiques se modifient à l'aide
+des commandes @code{\set} et @code{\override}, comme indiqué à la
+rubrique @ref{Modification de propriétés}. Ces commandes créent des
+événements musicaux qui feront que la modification produira ses effets
+dès l'instant où la musique est traitée.
+
+Le propos est ici de voir comment modifier les valeurs @emph{par défaut}
+des propriétés de contexte ou d'objet graphique dès la création de ces
+contextes. Deux manières de procéder sont envisageables : l'une
+consiste à modifier les valeurs pour tous les contextes d'un même type,
+l'autre s'attache à adapter les valeurs par défaut d'une instance
+particulière d'un contexte.
+
+@menu
+* Modification de tous les contextes d'un même type::
+* Modification d'un contexte particulier::
+* Ordre de préséance::
+@end menu
+
+
+@node Modification de tous les contextes d'un même type
+@unnumberedsubsubsec Modification de tous les contextes d'un même type
+@translationof Changing all contexts of the same type
+
+@cindex \context dans un bloc \layout
+
+@funindex \context
+@funindex \layout
+
La personnalisation des réglages par défaut d'un contexte, qu'il
s'agisse de @code{Score}, @code{Staff} ou @code{Voice}, peut se réaliser
indépendamment de la musique dans un bloc @code{\layout} -- placé dans
le bloc @code{\score} auquel ces modifications doivent s'appliquer -- au
-moyen de la commande @code{\context}.
+moyen d'un bloc @code{\context}.
+
+@example
+\layout @{
+ \context @{
+ \Voice
+ [réglage de contexte pour tous les contextes @emph{Voice}]
+ @}
+ \context @{
+ \Staff
+ [réglage de contexte pour tous les contextes @emph{Staff}]
+ @}
+@}
+@end example
+
+La spécification des adaptations peut se faire de différentes manières :
+
+@itemize
+@item
+à l'aide d'une commande @code{\override}, sans lui adjoindre le nom du
+contexte :
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\score {
+ \relative c'' {
+ a4^"Hampes épaisses" a a a
+ a4 a a\ff a
+ }
+ \layout {
+ \context {
+ \Staff
+ \override Stem.thickness = #4.0
+ }
+ }
+}
+@end lilypond
-Point n'est besoin d'utiliser la commande @code{\set @var{contexte}}
-lorsque les réglages par défaut d'un contexte sont ainsi modifiés :
+@item
+en définissant directement une propriété de contexte :
@c KEEP LY
@lilypond[quote,verbatim]
\score {
\relative c'' {
- a4^"Petite police, hampes épaisses, sans métrique" a a a
- a a a a
+ a4^"Fontes plus petites" a a a
+ a4 a a\ff a
}
\layout {
\context {
\Staff
fontSize = #-4
- \override Stem #'thickness = #4.0
- \remove "Time_signature_engraver"
}
}
}
@end lilypond
-Le raccourci @code{\Staff} invoque les définitions inhérentes au
-contexte @code{Staff}, de façon à ce qu'elles puissent être modifiées.
-Ces nouvelles spécifications affecteront toutes les portées (tous les
-contextes @code{Staff}) de ce bloc @code{\score}.
-Les adaptations peuvent aussi bien se faire au niveau du contexte
-@code{Score} qu'au niveau de tous les contextes @code{Voice}.
+@item
+à l'aide d'une commande prédéfinie comme @code{\dynamicUp}, ou bien une
+expression musicale telle que @code{\accidentalStyle "dodecaphonic"} :
-Il est possible de stocker des modifications de contexte dans un
-identificateur. Sa définition devra être précédée de l'instruction
-@code{\with}.
+@c KEEP LY
+@lilypond[quote,verbatim]
+\score {
+ \relative c'' {
+ a4^"Nuance en surplomb" a a a
+ a4 a a\ff a
+ }
+ \layout {
+ \context {
+ \Voice
+ \dynamicUp
+ }
+ \context {
+ \Staff
+ \accidentalStyle dodecaphonic
+ }
+ }
+}
+@end lilypond
+
+@item
+à l'aide d'une variable personnalisée contenant un bloc @code{\with} :
+pour de plus amples iformations sur le bloc @code{\with}, voir
+@ref{Modification d'un contexte particulier}.
+@c KEEP LY
@lilypond[quote,verbatim]
-blubb = \with {
+StaffDefauts = \with {
fontSize = #-4
- \override Stem #'thickness = #4.0
- \remove "Time_signature_engraver"
}
-bla = \with {
- fontSize = #3
- \override Stem #'thickness = #-2.0
+\score {
+ \new Staff {
+ \relative c'' {
+ a4^"Petite police" a a a
+ a4 a a a
+ }
+ }
+ \layout {
+ \context {
+ \Staff
+ \StaffDefauts
+ }
+ }
}
+@end lilypond
-melody = \relative c'' {
- a4 a a a |
- a4 a a a |
+@end itemize
+
+Les instructions destinées à modifier les propriétés peuvent se placer
+dans un bloc @code{\layout} sans pour autant être incluses dans un bloc
+@code{\context}. Expliciter des réglages de la sorte équivaut à inclure
+les commandes de modification des propriétés au début de chacun des
+contextes du type en question. Lorsque le contexte n'est pas spécifié,
+@emph{tous} les contextes de bas niveau seront affectés -- voir
+@ref{Contextes de bas niveau -- les voix}. La syntaxe appropriée répond
+aux mêmes critères que si la commande était écrite dans le flot
+musical.
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\score {
+ \new Staff {
+ \relative c'' {
+ a4^"Petite police" a a a
+ a4 a a a
+ }
+ }
+ \layout {
+ \accidentalStyle dodecaphonic
+ \set fontSize = #-4
+ \override Voice.Stem.thickness = #4.0
+ }
}
+@end lilypond
+
+
+@node Modification d'un contexte particulier
+@unnumberedsubsubsec Modification d'un contexte particulier
+@translationof Changing just one specific context
+
+@cindex \with
+@funindex \with
+
+Dans le cas d'un contexte pris individuellement, ses propriétés se
+modifient à l'aide d'un bloc @code{\with}. Toutes les autres instances
+de contexte appartenant au même type seront affectés des réglages
+prédéfinis par LilyPond, modifiés le cas échéant par un bloc
+@code{\layout}. Le bloc @code{\with} se place directement à la suite de
+la commande @code{\new} @var{type-de-contexte}.
+@example
+\new Staff
+\with @{
+ [réglages pour ce contexte pris individuellement]
+@} @{
+...
+@}
+@end example
+
+La spécification des adaptations peut se faire de différentes manières :
+
+@itemize
+@item
+à l'aide d'une commande @code{\override}, sans lui adjoindre le nom du
+contexte :
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\score {
+ \new Staff {
+ \new Voice
+ \with {
+ \override Stem.thickness = #4.0
+ }
+ {
+ \relative c'' {
+ a4^"Hampes épaisses" a a a
+ a4 a a a
+ }
+ }
+ }
+}
+@end lilypond
+
+@item
+en définissant directement une propriété de contexte :
+
+@lilypond[quote,verbatim]
\score {
<<
- \new Staff <<
- \melody
- s4^"Small, thicker stems, no time signature"
- >>
- \new Staff \bla <<
- \melody
- s4^"Different"
- >>
+ \new Staff {
+ \relative c'' {
+ a4^"Default font" a a a
+ a4 a a a
+ }
+ }
+ \new Staff
+ \with {
+ fontSize = #-4
+ } {
+ \relative c'' {
+ a4^"Smaller font" a a a
+ a4 a a a
+ }
+ }
>>
- \layout {
- \context {
- \Staff
- \blubb
+}
+@end lilypond
+
+@item
+à l'aide d'une commande prédéfinie comme @code{\dynamicUp} :
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff {
+ \new Voice {
+ \relative c'' {
+ a4^"Nuances en dessous" a a a
+ a4 a a\ff a
+ }
+ }
}
- }
+ \new Staff
+ \with { \accidentalStyle dodecaphonic }
+ {
+ \new Voice
+ \with { \dynamicUp }
+ {
+ \relative c'' {
+ a4^"Nuances en surplomb" a a a
+ a4 a a\ff a
+ }
+ }
+ }
+ >>
}
@end lilypond
-@c TODO: add \with in here.
+@end itemize
+
+
+@node Ordre de préséance
+@unnumberedsubsubsec Ordre de préséance
+@translationof Order of precedence
+
+La valeur d'une propriété qui doit s'appliquer à un instant particulier
+est déterminée comme suit :
+
+@itemize
+@item
+s'il y a une instruction @code{\override} ou @code{\set} active dans le
+flot d'information, sa valeur s'applique,
+
+@item
+en l'absence de quoi sera utilisée la valeur par défaut telle que
+définie dans une clause @code{\with} stipulée à l'initialisation du
+contexte,
+
+@item
+en l'absence de quoi sera retenue la valeur par défaut issue du bloc
+@code{\context} approprié le plus récent dans le bloc @code{\layout},
+
+@item
+en l'absence de quoi s'appliqueront les réglages prédéfinis de LilyPond.
+@end itemize
+
+@seealso
+Manuel d'initiation :
+@rlearning{Modification des propriétés d'un contexte}.
+
+Manuel de notation :
+@ref{Tout savoir sur les contextes},
+@ref{Contextes de bas niveau -- les voix},
+@ref{La commande de fixation (set)},
+@ref{La commande de dérogation (override)},
+@ref{Le bloc \layout}.
@node Définition de nouveaux contextes
\consists "Note_heads_engraver"
\consists "Rhythmic_column_engraver"
\consists "Text_engraver"
- \consists Pitch_squash_engraver
+ \consists "Pitch_squash_engraver"
squashedPosition = #0
- \override NoteHead #'style = #'slash
- \override Stem #'transparent = ##t
- \override Flag #'transparent = ##t
+ \override NoteHead.style = #'slash
+ \override Stem.transparent = ##t
+ \override Flag.transparent = ##t
\alias Voice
}
\context { \Staff
textuelles ; on ajoute donc les graveurs appropriés :
@example
-\consists Note_heads_engraver
-\consists Text_engraver
+\consists "Note_heads_engraver"
+\consists "Text_engraver"
@end example
Cependant, on veut que les notes s'affichent toutes au centre de
la portée :
@example
-\consists Pitch_squash_engraver
+\consists "Pitch_squash_engraver"
squashedPosition = #0
@end example
aucune hampe :
@example
-\override NoteHead #'style = #'slash
-\override Stem #'transparent = ##t
-\override Flag #'transparent = ##t
+\override NoteHead.style = #'slash
+\override Stem.transparent = ##t
+\override Flag.transparent = ##t
@end example
Afin que tous ces graveurs puissent travailler de concert, on leur
\type "Engraver_group"
\consists "Note_heads_engraver"
\consists "Text_engraver"
- \consists Pitch_squash_engraver
+ \consists "Pitch_squash_engraver"
squashedPosition = #0
- \override NoteHead #'style = #'slash
- \override Stem #'transparent = ##t
- \override Flag #'transparent = ##t
+ \override NoteHead.style = #'slash
+ \override Stem.transparent = ##t
+ \override Flag.transparent = ##t
\alias Voice
@}
@end example
implicite. Ceci peut engendrer une nouvelle portée ou une autre
partition.
+@cindex alignAboveContext
+@cindex alignBelowContext
+@funindex alignAboveContext
+@funindex alignBelowContext
+
+Il arrive qu'un contexte ne doive exister que pendant un court instant,
+ce qui est le cas par exemple pour une @emph{ossia}. Le plus simple
+consiste alors à initialiser la définition d'un contexte à l'endroit
+approprié, en parallèle avec le fragment correspondant dans la musique
+principale. Ce contexte temporaire sera par défaut positionné sous les
+autres contextes existants. Le repositionner au-dessus du contexte
+« principal » demande de le définir ainsi :
+
+@example
+@code{\new Staff \with @{ alignAboveContext = #"principal" @} }
+@end example
+
+Il en va de même pour les contextes temporaires de paroles au sein d'un
+système à plusieurs portées comme un @code{ChoirStaff} lorsque, par
+exemple, un couplet supplémentaire apparaît à l'occasion d'une
+reprise. Ce contexte de paroles temporaire se place par défaut sous les
+portées inférieures. Lui adjoindre une instruction
+@code{alignBelowContext} dès son initialisation permet de l'accoler au
+contexte de paroles (nommé) qui contient le premier couplet.
+
+Des exemples de repositionnement de contexte temporaire sont disponibles
+aux rubriques @rlearning{Expressions musicales imbriquées},
+@ref{Modification de portées individuelles} et
+@ref{Situations particulières en matière de paroles}.
+
@seealso
+Manuel d'initiation :
+@rlearning{Expressions musicales imbriquées}.
+
+Manuel de notation :
+@ref{Modification de portées individuelles},
+@ref{Situations particulières en matière de paroles}.
+
Manuel d'utilisation :
@rprogram{Apparition d'une portée supplémentaire}.
Tous les éléments de notation sont considérés comme des objets
graphiques (en anglais @emph{Graphical Object}, d'où le diminutif
@emph{Grob}). Chaque objet est doté d'un certain nombre de propriétés
-(l'épaisseur du trait, l'orientation etc.), et lié à d'autres objets.
+(l'épaisseur du trait, l'orientation, etc.), et lié à d'autres objets.
Le fonctionnement de ces objets est décrit en détail dans
@rinternals{grob-interface}.
vide entre la note et le doigté :
@example
-\once \override Voice.Fingering #'padding = #3
+\once \override Voice.Fingering.padding = #3
@end example
En ajoutant cette commande avant la création du doigté (de l'objet
suivant :
@lilypond[quote,relative=2,verbatim]
-\once \override Voice.Fingering #'padding = #3
+\once \override Voice.Fingering.padding = #3
c-2
\stemUp
f
La commande suivante :
@verbatim
-\override Staff.Stem #'thickness = #4.0
+\override Staff.Stem.thickness = #4.0
@end verbatim
@noindent
@lilypond[quote,verbatim,relative=2,fragment]
c4
-\override Staff.Stem #'thickness = #4.0
+\override Staff.Stem.thickness = #4.0
c4
c4
c4
@lilypond[quote,fragment,verbatim,relative=2]
c4
-\once \override Stem #'thickness = #4.0
+\once \override Stem.thickness = #4.0
c4
c4
@end lilypond
créé.
@lilypond[quote,fragment,verbatim,relative=2]
-\override Slur #'thickness = #3.0
+\override Slur.thickness = #3.0
c8[( c
-\override Beam #'beam-thickness = #0.6
+\override Beam.beam-thickness = #0.6
c8 c])
@end lilypond
est sans effet.
@example
-\override Voice.Stem #'thickness = #4.0
-\revert Staff.Stem #'thickness
+\override Voice.Stem.thickness = #4.0
+\revert Staff.Stem.thickness
@end example
Il existe, à l'intérieur même de certaines propriétés, des options que
Ainsi, par exemple :
@example
-\override Stem #'(details beamed-lengths) = #'(4 4 3)
+\override Stem.details.beamed-lengths = #'(4 4 3)
@end example
@end ignore
@lilypond[quote,verbatim,relative=2]
c4 c
-\override Voice.Stem #'thickness = #3.0
+\override Voice.Stem.thickness = #3.0
c4 c
@end lilypond
celle-ci s'appliquera au contexte le plus bas :
@lilypond[quote,verbatim,relative=2]
-{ \override Staff.Stem #'thickness = #3.0
+{ \override Staff.Stem.thickness = #3.0
<<
{
e4 e
- \override Stem #'thickness = #0.5
+ \override Stem.thickness = #0.5
e4 e
} \\ {
c4 c c c
@lilypond[quote,verbatim,relative=2]
c4
-\override Voice.Stem #'thickness = #3.0
+\override Voice.Stem.thickness = #3.0
c4 c
-\revert Voice.Stem #'thickness
+\revert Voice.Stem.thickness
c4
@end lilypond
<<
{
e4
- \override Staff.Stem #'thickness = #3.0
+ \override Staff.Stem.thickness = #3.0
e4 e e
} \\ {
c4 c c
- \revert Staff.Stem #'thickness
+ \revert Staff.Stem.thickness
c4
}
>>
{
<<
{
- \override Stem #'thickness = #3.0
+ \override Stem.thickness = #3.0
e4 e e e
} \\ {
c4
- \once \override Stem #'thickness = #3.0
+ \once \override Stem.thickness = #3.0
c4 c c
}
>>
ressemblent en général à
@example
-\override Voice.Stem #'thickness = #3.0
+\override Voice.Stem.thickness = #3.0
@end example
@noindent
propriété. La commande devient alors :
@example
-\override Stem #'(details beamed-lengths) = #'(4 4 3)
+\override Stem.details.beamed-lengths = #'(4 4 3)
@end example
@cindex documentation exhaustive
@lilypond[relative=2,verbatim,ragged-right]
<
c
- \tweak #'color #red
+ \tweak color #red
d
g
- \tweak #'duration-log #1
+ \tweak duration-log #1
a
>4
--\tweak #'padding #8
+-\tweak padding #8
-^
@end lilypond
pourquoi le code suivant ne sera d'aucun effet :
@example
-\tweak #'color #red c4
+\tweak color #red c4
@end example
@noindent
@lilypond[relative=2,verbatim,quote]
< c
- \tweak #'color #red
+ \tweak color #red
d
g
- \tweak #'duration-log #1
+ \tweak duration-log #1
a
> 4
@end lilypond
liaison :
@lilypond[verbatim,quote,relative=1]
-c-\tweak #'thickness #5 ( d e f)
+c-\tweak thickness #5 ( d e f)
@end lilypond
La commande @code{\tweak} ne sera pleinement fonctionnelle que si elle
@code{EventChord} (un événement d'accord) :
@lilypond[relative=2,verbatim,quote]
-\tweak #'color #red c4
-\tweak #'color #red <c e>4
-<\tweak #'color #red c>4
+\tweak color #red c4
+\tweak color #red <c e>4
+<\tweak color #red c>4
@end lilypond
La commande @code{\tweak} simple ne saurait servir à modifier un élément
forme dévelppée de la commande @code{\tweak} :
@lilypond[relative=2,verbatim,quote]
-\tweak Stem #'color #red
-\tweak Beam #'color #green c8 e
-<c e \tweak Accidental #'font-size #-3 ges>4
+\tweak Stem.color #red
+\tweak Beam.color #green c8 e
+<c e \tweak Accidental.font-size #-3 ges>4
@end lilypond
La commande @code{\tweak} ne peut non plus servir à modifier clefs ou
@lilypond[verbatim,quote,relative=1]
c
--\tweak #'style #'dashed-line
--\tweak #'dash-fraction #0.2
--\tweak #'thickness #3
--\tweak #'color #red
+-\tweak style #'dashed-line
+-\tweak dash-fraction #0.2
+-\tweak thickness #3
+-\tweak color #red
\glissando
f'
@end lilypond
@cindex points de contrôle et tweak
Lorsqu'il y a plusieurs liaisons de prolongation dans un accord, la
-commande @code{\tweak} ne s'applique qu'à la première.
+commande @code{\tweak} ne permet de modifier les points de contrôle que
+pour la première rencontrée dans le fichier source.
@node set ou override
% reduced space between staves
\new PianoStaff \with {
% this is the nested declaration
- \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
+ \override StaffGrouper.staff-staff-spacing.basic-distance = #7
} <<
\new Staff { \clef treble c''1 }
\new Staff { \clef bass c1 }
@lilypond[quote,verbatim]
\new PianoStaff \with {
- \override StaffGrouper #'staff-staff-spacing =
+ \override StaffGrouper.staff-staff-spacing =
#'((basic-distance . 0)
(minimum-distance . 0)
(padding . 0)
équivalentes.
@example
-\override StaffGrouper #'staff-staff-spacing =
+\override StaffGrouper.staff-staff-spacing =
#'((basic-distance . 7))
-\override StaffGrouper #'staff-staff-spacing =
+\override StaffGrouper.staff-staff-spacing =
#'((basic-distance . 7)
(minimum-distance . 0)
(padding . 0)
@warning{Les déclarations imbriquées ne sont pas fonctionnelles dans le
cas des listes associatives des propriétés de contexte -- telles
@code{beamExceptions}, @code{keySignature},
-@code{timeSignatureSettings}, etc. Ces propriétés ne sont modifiables
+@code{timeSignatureSettings}, etc. Ces propriétés ne sont modifiables
qu'au travers d'une complète redéfinition de leur liste associative.}
Le mode notes est le mode par défaut dans LilyPond. Il peut aussi
s'activer par la commande @code{\notemode}. Les saisies seront
-interprétées comme étant des hauteurs, durées, @emph{markups} etc. qui
+interprétées comme étant des hauteurs, durées, @emph{markups}, etc. qui
seront rendues sous forme de notation musicale sur une portée.
Nul n'est besoin de spécifier le mode notes de manière explicite, hormis
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
- \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
+ \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
}
{ a4 e' f b | d1 }
@end lilypond
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
- \override StaffSymbol #'width = #23
+ \override StaffSymbol.width = #23
}
{ a4 e' f b | d1 }
@end lilypond
a~a
a
% increase the length of the tie
--\tweak #'minimum-length #5
+-\tweak minimum-length #5
~a
@end lilypond
\compressFullBarRests
R1*23
% increase the length of the rest bar
-\once \override MultiMeasureRest #'minimum-length = #20
+\once \override MultiMeasureRest.minimum-length = #20
R1*23
a1
@end lilypond
@lilypond[verbatim,quote,relative=2]
a \< a a a \!
% increase the length of the hairpin
-\override Hairpin #'minimum-length = #20
+\override Hairpin.minimum-length = #20
a \< a a a \!
@end lilypond
@lilypond[verbatim,quote,relative=2]
a( a)
a
--\tweak #'minimum-length #5
+-\tweak minimum-length #5
( a)
a\( a\)
a
--\tweak #'minimum-length #5
+-\tweak minimum-length #5
\( a\)
@end lilypond
e \glissando c'
% not effective alone
-\once \override Glissando #'minimum-length = #20
+\once \override Glissando.minimum-length = #20
e, \glissando c'
% effective only when both overrides are present
-\once \override Glissando #'minimum-length = #20
-\once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
+\once \override Glissando.minimum-length = #20
+\once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
e, \glissando c'
@end lilypond
@lilypond[verbatim,quote,relative=1]
% not effective alone
-\once \override Beam #'minimum-length = #20
+\once \override Beam.minimum-length = #20
e8 e e e
% effective only when both overrides are present
-\once \override Beam #'minimum-length = #20
-\once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
+\once \override Beam.minimum-length = #20
+\once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
e8 e e e
@end lilypond
@lilypond[verbatim,quote,relative=2]
a \< a a a a \! a a a \break
-\override Hairpin #'to-barline = ##f
+\override Hairpin.to-barline = ##f
a \< a a a a \! a a a
@end lilypond
@lilypond[relative=2,quote,verbatim]
e2 \glissando b
-\once \override Glissando #'(bound-details left Y) = #3
-\once \override Glissando #'(bound-details right Y) = #-2
+\once \override Glissando.bound-details.left.Y = #3
+\once \override Glissando.bound-details.right.Y = #-2
e2 \glissando b
@end lilypond
ci-dessous :
@lilypond[relative=2,ragged-right,verbatim,quote]
-\override Glissando #'breakable = ##t
-\override Glissando #'(bound-details right-broken Y) = #-3
+\override Glissando.breakable = ##t
+\override Glissando.bound-details.right-broken.Y = #-3
c1 \glissando \break
f1
@end lilypond
un extenseur horizontal.
@lilypond[quote,ragged-right,relative=2,verbatim]
-\override TextSpanner #'(bound-details left text)
+\override TextSpanner.bound-details.left.text
= \markup { \small \bold Slower }
c2\startTextSpan b c a\stopTextSpan
@end lilypond
le symbole verticalement par rapport au coin de la ligne :
@lilypond[relative=1,quote,verbatim]
-\override TextSpanner
- #'(bound-details left stencil-align-dir-y) = #-2
-\override TextSpanner
- #'(bound-details right stencil-align-dir-y) = #UP
-
-\override TextSpanner
- #'(bound-details left text) = #"ggg"
-\override TextSpanner
- #'(bound-details right text) = #"hhh"
+\override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
+\override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
+
+\override TextSpanner.bound-details.left.text = #"ggg"
+\override TextSpanner.bound-details.right.text = #"hhh"
c4^\startTextSpan c c c \stopTextSpan
@end lilypond
@lilypond[quote,verbatim,relative=1]
a1 a
-\override Score.BarLine #'stencil = ##f
+\override Score.BarLine.stencil = ##f
a a
-\revert Score.BarLine #'stencil
+\revert Score.BarLine.stencil
a a a
@end lilypond
@lilypond[quote,verbatim,relative=2]
a4 a
-\once \override NoteHead #'transparent = ##t
+\once \override NoteHead.transparent = ##t
a a
@end lilypond
un fantôme de l'objet blanchi comme ci-dessous :
@lilypond[quote,verbatim,relative=2]
-\override Staff.Clef #'color = #white
+\override Staff.Clef.color = #white
a1
@end lilypond
pouvoir être dessiné avant.
@lilypond[quote,verbatim,relative=2]
-\override Staff.Clef #'color = #white
-\override Staff.Clef #'layer = #-1
+\override Staff.Clef.color = #white
+\override Staff.Clef.layer = #-1
a1
@end lilypond
@file{scm/output-lib.scm}. Le tableau suivant vous les présente ;
les trois dernières colonnes indiquent l'endroit où l'objet sera visible.
-@multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t. )}} {apres} {apres} {apres}
+@multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {apres} {apres} {apres}
@headitem Forme @tab Forme @tab Avant @tab Hors @tab Après
@headitem fonctionnelle @tab vectorielle @tab saut @tab saut @tab saut
f4 g a b
f4 g a b
% Remove bar line at the end of the current line
-\once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
+\once \override Score.BarLine.break-visibility = #'#(#f #t #t)
\break
f4 g a b
f4 g a b
\key g \major
f4 g a b
% Try to remove all key signatures
-\override Staff.KeySignature #'break-visibility = #all-invisible
+\override Staff.KeySignature.break-visibility = #all-invisible
\key bes \major
f4 g a b
\break
\key g \major
f4 g a b
\set Staff.explicitKeySignatureVisibility = #all-invisible
-\override Staff.KeySignature #'break-visibility = #all-invisible
+\override Staff.KeySignature.break-visibility = #all-invisible
\key bes \major
f4 g a b \break
f4 g a b
f4 g a b
\set Staff.explicitKeySignatureVisibility = #all-invisible
\set Staff.printKeyCancellation = ##f
-\override Staff.KeySignature #'break-visibility = #all-invisible
+\override Staff.KeySignature.break-visibility = #all-invisible
\key bes \major
f4 g a b \break
f4 g a b
@lilypond[relative=2,ragged-right,verbatim,quote]
d2 \glissando d'2
-\once \override Glissando #'style = #'dashed-line
+\once \override Glissando.style = #'dashed-line
d,2 \glissando d'2
-\override Glissando #'style = #'dotted-line
+\override Glissando.style = #'dotted-line
d,2 \glissando d'2
-\override Glissando #'style = #'zigzag
+\override Glissando.style = #'zigzag
d,2 \glissando d'2
-\override Glissando #'style = #'trill
+\override Glissando.style = #'trill
d,2 \glissando d'2
@end lilypond
@c TODO Complete
@lilypond[relative=2,ragged-right,verbatim,quote]
e2 \glissando f
-\once \override Glissando #'(bound-details right Y) = #-2
+\once \override Glissando.bound-details.right.Y = #-2
e2 \glissando f
@end lilypond
@lilypond[quote,verbatim,relative=1]
g4\< e' d' f\!
-\override Hairpin #'rotation = #'(20 -1 0)
+\override Hairpin.rotation = #'(20 -1 0)
g,,4\< e' d' f\!
@end lilypond
@c KEEP LY
@lilypond[quote,verbatim,relative=1]
-\override TextScript #'outside-staff-priority = ##f
+\override TextScript.outside-staff-priority = ##f
g4^\markup { \rotate #30 "un sol" }
b^\markup { \rotate #30 "un si" }
des^\markup { \rotate #30 "un ré bémol" }
@lilypond[verbatim,quote,relative=2]
a-3
a
--\tweak #'X-offset #0
--\tweak #'Y-offset #0
+-\tweak X-offset #0
+-\tweak Y-offset #0
-3
a
--\tweak #'X-offset #-1
--\tweak #'Y-offset #1
+-\tweak X-offset #-1
+-\tweak Y-offset #1
-3
@end lilypond
@lilypond[quote,verbatim,relative=1]
a'
--\tweak #'self-alignment-X #-1
+-\tweak self-alignment-X #-1
^"left-aligned"
--\tweak #'self-alignment-X #0
+-\tweak self-alignment-X #0
^"center-aligned"
--\tweak #'self-alignment-X #RIGHT
+-\tweak self-alignment-X #RIGHT
^"right-aligned"
--\tweak #'self-alignment-X #-2.5
+-\tweak self-alignment-X #-2.5
^"aligned further to the right"
@end lilypond
@lilypond[quote,verbatim,relative=2]
a
--\tweak #'self-alignment-X #0.5 % move horizontally left
--\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
--\tweak #'self-alignment-Y #-1 % move vertically up
+-\tweak self-alignment-X #0.5 % move horizontally left
+-\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
+-\tweak self-alignment-Y #-1 % move vertically up
-3 % third finger
@end lilypond
@lilypond[verbatim,quote,relative=1]
% The rehearsal mark will be centered above the Clef
-\override Score.RehearsalMark #'break-align-symbols = #'(clef)
+\override Score.RehearsalMark.break-align-symbols = #'(clef)
\key a \major
\clef treble
\mark "↓"
e1
% The rehearsal mark will be centered above the Time Signature
-\override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
+\override Score.RehearsalMark.break-align-symbols = #'(time-signature)
\key a \major
\clef treble
\time 3/4
\mark "↓"
e2.
% The rehearsal mark will be centered above the Breath Mark
-\override Score.RehearsalMark #'break-align-symbols = #'(breathing-sign)
+\override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
\key a \major
\clef treble
\time 4/4
@lilypond[verbatim,quote,relative=1]
% The rehearsal mark will be centered above the Key Signature
-\override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
+\override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
\key a \major
\clef treble
\mark "↓"
e1
% The rehearsal mark will be centered above the Clef
\set Staff.explicitKeySignatureVisibility = #all-invisible
-\override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
+\override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
\key a \major
\clef bass
\mark "↓"
% The rehearsal mark will be centered above the Bar Line
\set Staff.explicitKeySignatureVisibility = #all-invisible
\set Staff.explicitClefVisibility = #all-invisible
-\override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
+\override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
\key a \major
\clef treble
\mark "↓"
@lilypond[verbatim,quote,relative=1]
% The RehearsalMark will be centered above the Key Signature
-\override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+\override Score.RehearsalMark.break-align-symbols = #'(key-signature)
\key a \major
\clef treble
\time 4/4
\mark "↓"
e1
% The RehearsalMark will be aligned with the left edge of the Key Signature
-\once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
+\once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
\mark "↓"
\key a \major
e1
% The RehearsalMark will be aligned with the right edge of the Key Signature
-\once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
+\once \override Score.KeySignature.break-align-anchor-alignment = #RIGHT
\key a \major
\mark "↓"
e1
@lilypond[verbatim,quote,relative=1]
% The RehearsalMark will be aligned with the left edge of the Key Signature
% and then shifted right by 3.5 staff-spaces
-\override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-\once \override Score.KeySignature #'break-align-anchor = #3.5
+\override Score.RehearsalMark.break-align-symbols = #'(key-signature)
+\once \override Score.KeySignature.break-align-anchor = #3.5
\key a \major
\mark "↓"
e1
% The RehearsalMark will be aligned with the left edge of the Key Signature
% and then shifted left by 2 staff-spaces
-\once \override Score.KeySignature #'break-align-anchor = #-2
+\once \override Score.KeySignature.break-align-anchor = #-2
\key a \major
\mark "↓"
e1
puis @code{VerticalAlignment} synchronise verticalement ces différents
groupes. En général, il n'y a qu'un seul @code{VerticalAlignment} pour
l'ensemble de la partition, mais chaque contexte @code{Staff},
-@code{Lyrics} etc. possède son propre @code{VerticalAxisGroup}.
+@code{Lyrics}, etc. possède son propre @code{VerticalAxisGroup}.
@node Modification des stencils
@lilypond[verbatim,quote]
XinO = {
- \once \override NoteHead #'stencil = #ly:text-interface::print
- \once \override NoteHead #'text = \markup {
+ \once \override NoteHead.stencil = #ly:text-interface::print
+ \once \override NoteHead.text = \markup {
\combine
\halign #-0.7 \draw-circle #0.85 #0.2 ##f
\musicglyph #"noteheads.s2cross"
@lilypond[verbatim,quote,relative=1]
<<
{
- \once \override Tie
- #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
+ \once \override Tie.control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
e1 ~ e
}
\\
'(-0.5 . 0.5)))))
squareLineCircleSpace = {
- \override NoteHead #'stencil = #square-line-circle-space
+ \override NoteHead.stencil = #square-line-circle-space
}
smartSquareLineCircleSpace = {
\squareLineCircleSpace
- \override NoteHead #'Y-extent =
+ \override NoteHead.Y-extent =
#(ly:make-unpure-pure-container
ly:grob::stencil-height
(lambda (grob start end) (ly:grob::stencil-height grob)))
\new Voice \with { \remove "Stem_engraver" }
\relative c'' {
\squareLineCircleSpace
- cis4 ces cisis c
+ cis4 ces disis d
\smartSquareLineCircleSpace
- cis4 ces cisis c
+ cis4 ces disis d
}
@end lilypond
@item @code{@var{@dots{}musique@dots{}}}
@tab du code LilyPond tout ce qu'il y a de plus ordinaire, avec des
@code{$} (là où seule une construction LilyPond est autorisée) et des
-@code{#} (lorsqu'il s'agit d'une valeur en Scheme ou d'un argument de
-fonction musicale) pour référencer les arguments (par ex. @samp{#arg1}).
+@code{#} (lorsqu'il s'agit d'une valeur en Scheme, d'un argument de
+fonction musicale ou de musique faisant partie d'une liste) pour
+référencer les arguments (par ex. @samp{#arg1}).
@end multitable
Les arguments @code{parser} et @code{location} sont obligatoires ;
(parser location padding)
(number?)
#{
- \once \override TextScript #'padding = #padding
+ \once \override TextScript.padding = #padding
#})
\relative c''' {
(parser location note)
(ly:music?)
#{
- \tweak NoteHead #'stencil #ly:text-interface::print
- \tweak NoteHead #'text
+ \tweak NoteHead.stencil #ly:text-interface::print
+ \tweak NoteHead.text
\markup \musicglyph #"custodes.mensural.u0"
- \tweak Stem #'stencil ##f
- $note
+ \tweak Stem.stencil ##f
+ #note
#})
\relative c' { c4 d e f \custosNote g }
(parser location padding tempotext)
(number? markup?)
#{
- \once \override Score.MetronomeMark #'padding = #padding
+ \once \override Score.MetronomeMark.padding = #padding
\tempo \markup { \bold #tempotext }
#})