@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 6d618ddf527c69dc7c5309f071b115df50566121
+ Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58
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.13.36"
+@c \version "2.15.10"
@c Translators: Valentin Villenave, Nicolas Klutchnikoff, Damien Heurtebise
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
@menu
* Retouches élémentaires::
-* Le manuel des références internes::
+* Le manuel de référence des propriétés internes::
* Apparence des objets::
* Positionnement des objets::
* Collisions d'objets::
* Autres retouches::
@end menu
+
@node Retouches élémentaires
@section Retouches élémentaires
@translationof Tweaking basics
* Méthodes de retouche::
@end menu
+
@node Introduction aux retouches
@subsection Introduction aux retouches
@translationof Introduction to tweaks
graveurs et autres propriétés qui y sont décrits, sont indispensables
pour comprendre et construire les retouches.
+
@node Objets et interfaces
@subsection Objets et interfaces
@translationof Objects and interfaces
doigtés, les clefs, etc. sont appelés @qq{Objets de rendu}@tie{}; ils
sont aussi connus sous le nom d'@qq{Objets graphiques} (en
anglais@tie{}: @emph{Graphical objects} ou @emph{Grobs} pour faire
-court). Ce sont bien des objets au sens générique ci-dessus, et, en
+court). Ce sont bien des objets au sens générique ci-dessus et, en
tant que tels, ils reçoivent des propriétés qui leur sont associées,
comme leur position, leur taille, leur couleur, etc.
compte plus d'une centaine. Nous verrons plus loin en quoi c'est
intéressant et utile pour l'utilisateur.
-Ainsi s'achève le tour des principaux termes relatifs aux objets et
+Ainsi s'achève le tour des principaux termes relatifs aux objets
que nous serons amenés à utiliser dans ce chapitre.
+
@node Conventions de nommage des objets et propriétés
@subsection Conventions de nommage des objets et propriétés
@translationof Naming conventions of objects and properties
@multitable @columnfractions .33 .33 .33
@headitem Type d'objet/propriété
- @tab Convention de nommage
- @tab Exemples
+ @tab Convention de nommage
+ @tab Exemples
@item Contextes
- @tab Aaaa ou AaaaAaaaAaaa
- @tab Staff, GrandStaff
+ @tab Aaaa ou AaaaAaaaAaaa
+ @tab Staff, GrandStaff
@item Objets de rendu
- @tab Aaaa ou AaaaAaaaAaaa
- @tab Slur, NoteHead
+ @tab Aaaa ou AaaaAaaaAaaa
+ @tab Slur, NoteHead
@item Graveurs
- @tab Aaaa_aaa_engraver
- @tab Clef_engraver, Note_heads_engraver
+ @tab Aaaa_aaa_engraver
+ @tab Clef_engraver, Note_heads_engraver
@item Interfaces
- @tab aaa-aaa-interface
- @tab grob-interface, break-aligned-interface
+ @tab aaa-aaa-interface
+ @tab grob-interface, break-aligned-interface
@item Propriétés de contexte
- @tab aaa ou aaaAaaaAaaa
- @tab alignAboveContext, skipBars
+ @tab aaa ou aaaAaaaAaaa
+ @tab alignAboveContext, skipBars
@item Propriétés d'objet de rendu
- @tab aaa ou aaa-aaa-aaa
- @tab direction, beam-thickness
+ @tab aaa ou aaa-aaa-aaa
+ @tab direction, beam-thickness
@end multitable
Comme nous le verrons bientôt, les propriétés des différents
qu'il est bon de savoir reconnaître le type d'un objet en fonction du
nom de ses propriétés.
+
@node Méthodes de retouche
@subsection Méthodes de retouche
@translationof Tweaking methods
circonstances il doit impérativement être indiqué.
Les sections ci-dessous traitent largement des propriétés et de leurs
-valeurs mais, pour illustrer la mise en forme et l'utilisation de ces
-commandes, nous nous limiterons à n'employer que quelques propriétés et
-valeurs simples, facilement compréhensibles.
+valeurs -- voir @ref{Types de propriétés} -- mais, pour illustrer la
+mise en forme et l'utilisation de ces commandes, nous nous limiterons à
+n'employer que quelques propriétés et valeurs simples, facilement
+compréhensibles.
Nous ne parlerons dans l'immédiat ni du @code{#'}, qui précède
toujours la propriété, ni du @code{#}, qui précède toujours la
toutes les deux le préfixe @code{\once}. Celui-ci a pour fonction de
n'appliquer la commande @code{\override} ou @code{\set} qu'à
l'instant musical en cours, avant que la propriété ne reprenne
-sa valeur par défaut. Toujours à partir du même exemple, il est
-possible de ne changer la couleur que d'une seule note@tie{}:
+sa valeur antérieure -- qui n'est pas forcément la valeur par défaut
+lorsqu'un autre @code{\override} est toujours effectif. Toujours à
+partir du même exemple, il est possible de ne changer la couleur que
+d'une seule note@tie{}:
@cindex couleur,exemple d'utilisation de la propriété
@cindex NoteHead, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
c4 d
-\once \override NoteHead #'color = #red
+\override NoteHead #'color = #red
e4 f |
\once \override NoteHead #'color = #green
-g4 a b c |
+g4 a
+\revert NoteHead #'color
+b c |
@end lilypond
@strong{La commande \overrideProperty}
Il existe une autre forme de commande @code{\override},
@code{\overrideProperty}, qui est parfois utile. Nous la mentionnons
ici par souci d'exhaustivité@tie{}; pour le détail, voir
-@rextendnamed{Difficult tweaks,Retouches complexes}.
+@rextend{Retouches complexes}.
@c Maybe explain in a later iteration -td
}
@end lilypond
+
@seealso
Manuel de notation :
@ruser{La commande d'affinage (@emph{tweak})}.
-@node Le manuel des références internes
-@section Le manuel des références internes
+@node Le manuel de référence des propriétés internes
+@section Le manuel de référence des propriétés internes
@translationof The Internals Reference manual
@cindex Références internes
* Types de propriétés::
@end menu
+
@node Propriétés des objets de rendu
@subsection Propriétés des objets de rendu
@translationof Properties of layout objects
prendre@tie{}? Vous êtes convaincu, avec tout ce qui a été dit sur la
souplesse de LilyPond, qu'une telle retouche est réalisable et
vous vous dites qu'elle fera sans doute intervenir la commande
-@code{\override}. Mais existe-t-il une propriété lourde qui s'applique
-à une liaison et, dans l'affirmative, comment faire pour la
+@code{\override}. Mais existe-t-il une propriété épaisseur qui
+s'applique à une liaison et, dans l'affirmative, comment faire pour la
modifier@tie{}? C'est là qu'intervient la Référence des propriétés
internes. Elle contient toutes les informations dont vous avez besoin
pour construire n'importe quelle commande @code{\override}.
commandes -- mais il faut encore s'exercer. Les exemples
suivants sont là dans cette intention.
+
@subheading Détermination du contexte adéquat
@cindex contexte, détermination du
niveau, qu'il est activé sans ambiguïté par le fait que l'on est
en train de saisir des notes, on peut ici ne pas le mentionner.
-@subheading Redéfinition pour une seule occurence
+
+@subheading Redéfinition pour une seule occurrence
@cindex dérogation pour une seule fois
@cindex usage unique, dérogation à
exemples seront progressivement accompagnés d'explications et
introduiront des termes nouveaux.
+
@node Propriétés listées par interface
@subsection Propriétés listées par interface
@translationof Properties found in interfaces
est@tie{}: @qq{Comment se fait-il que les propriétés @code{font-series}
et @code{font-size} se retrouvent à la fois dans @code{LyricText} et
dans l'interface @code{font-interface} alors que ce n'est pas le cas
-pour @code{font-shape} ?} La réponse est que lorsqu'un objet
+pour @code{font-shape}@tie{}?} La réponse est que lorsqu'un objet
@code{LyricText} est créé, les valeurs globales par défaut de
@code{font-series} et @code{font-size} sont modifiées, mais pas celles
de @code{font-shape}. Les possibilités de modification dans
@code{italic}. À ne pas confondre avec les chaînes de caractères
libres, qui se présentent comme @code{"un texte libre"}@tie{}; pour plus
de détails sur les symboles et les chaînes de caractères, voir le
-@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
+@rextend{Tutoriel Scheme}.
Ainsi, la commande @code{\override} pour mettre les paroles en italique
est@tie{}:
@noindent
et voilà les paroles en italiques.
+
@subheading Spécification du contexte en mode lyrique
@cindex contexte, spécification en mode lyrique
autre caractère compte comme un élément de la syllabe. C'est pourquoi
il faut une espace ou un saut de ligne avant le @code{@}} final, pour
éviter qu'il ne soit assimilé à la dernière syllabe. De même, il faut
-insérer des espaces avant et après le point, @qq{.}, qui sépare le nom
-de contexte du nom de l'objet, faute de quoi les deux noms seront joints
-et l'interpréteur ne pourra pas les reconnaître. La formulation
+insérer des espaces de part et d'autre du point, @qq{.}, qui sépare le
+nom de contexte du nom de l'objet, faute de quoi les deux noms seront
+joints et l'interpréteur ne pourra pas les reconnaître. La formulation
correcte est donc@tie{}:
@example
@seealso
Manuel d'extension :
-@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
+@rextend{Tutoriel Scheme}.
@node Types de propriétés
@subsection Types de propriétés
@translationof Types of properties
-
@cindex propriété, types de
Nous avons vu jusqu'à maintenant deux types de propriétés@tie{}:
@tab Vrai (@emph{true} en anglais) ou Faux (@emph{false} en anglais),
sous la forme @code{#t} ou @code{#f}
@tab @code{#t}, @code{#f}
-@item Dimension (en lignes de portée)
+@item Dimension (en espaces de portée)
@tab Un nombre positif décimal (en unités de lignes de portée)
@tab @code{2.5}, @code{0.34}
@item Direction
@tab @code{3}, @code{1}
@item Liste
@tab Plusieurs valeurs séparées par une espace, encadrées par des
-parenthèses et prédédées par une apostrophe
- @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'(1.0 0.25 0.5)}
+parenthèses et précédées par une apostrophe
+ @tab @code{'(left-edge staff-bar)}, @code{'(1)},
+ @code{'(1.0 0.25 0.5)}
@item Markup (ou étiquette)
@tab Toute commande @code{\markup} valide
@tab @code{\markup @{ \italic "cresc." @}}
@seealso
Manuel d'extension :
-@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
+@rextend{Tutoriel Scheme}.
@node Apparence des objets
mesure -- et de beaucoup d'autres objets, bien sûr. Examinons chacune
d'elles tour à tour.
+
@subheading stencil
@cindex stencil, propriété
Cette fois, les barres de mesure ont disparu.
Vous remarquerez que l'affectation de la valeur @code{#f} à la propriété
-@code{stencil} déclechera une erreur dès lors que l'objet en question se
+@code{stencil} déclenchera une erreur dès lors que l'objet en question se
doit d'avoir des dimensions pour les nécessités du traitement. Ce sera
le cas, par exemple, si vous effacez le @code{stencil} d'un objet
-@code{NoteHead}. Il vaut mieux, en pareil caas, utiliser la fonction
+@code{NoteHead}. Il vaut mieux, en pareil cas, utiliser la fonction
@code{point-stencil} qui, quant à elle, attribue à l'objet une taille à
zero@tie{}:
}
@end lilypond
+
@subheading visibilité des barres (break-visibility)
@cindex break-visibility, propriété
La RPI mentionne, à la page sur @code{BarLine}, que la propriété
@code{break-visibility} attend comme argument un vecteur de trois
-boléens. Ceux-ci indiquent respectivement si les barres de mesure
+booléens. Ceux-ci indiquent respectivement si les barres de mesure
doivent être imprimées ou non à la fin de la ligne, à l'intérieur de la
ligne et au début de la ligne. Dans notre cas, nous voulons que toutes
les barres soient supprimées, si bien que la valeur dont nous avons
Comme on peut le constater, cette solution-là aussi supprime les barres
de mesure.
+
@subheading transparence
@cindex transparent, propriété
@cindex transparence
La RPI mentionne, à la page sur @code{grob-interface}, que la propriété
-@code{transparent} attend comme argument un boléen. Il faudrait donc
+@code{transparent} attend comme argument un booléen. Il faudrait donc
mettre @code{#t} pour rendre l'objet transparent. Dans cet exemple,
essayons de rendre transparente la métrique (@emph{time signature} en
anglais) plutôt que les barres de mesure. Pour cela, il nous faut
valeur @code{#f} supprime totalement l'objet, tandis que le fait de le
rendre @code{transparent} le laisse en place, mais de façon invisible.
+
@subheading couleur
@cindex color, propriété
les mêmes proportions que les polices de caractères. La prochaine
sous-section montrera comment faire.
+
@node Longueur et épaisseur des objets
@subsection Longueur et épaisseur des objets
@translationof Length and thickness of objects
Pour de petits changements d'échelle, comme dans l'exemple ci-dessus, il
n'est généralement pas utile d'ajuster l'épaisseur des différentes
lignes telles que les barres de mesure, les ligatures, les soufflets de
-crescendo/decrescendo, les liaisons, etc. Si l'épaisseur d'un objet en
-particulier doit être ajustée, le mieux est de modifier sa propriété
+crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet
+en particulier doit être ajustée, le mieux est de modifier sa propriété
@code{thickness}. Nous avons vu plus haut, dans
@ref{Propriétés des objets de rendu}, un exemple de modification de
l'épaisseur des liaisons. L'épaisseur de tous les objets tracés
(c'est-à-dire ceux qui ne proviennent pas d'une police de caractère)
peut être changée de la même manière.
+
@node Positionnement des objets
@section Positionnement des objets
@translationof Placement of objects
* Objets hors de la portée::
@end menu
+
@node Comportement automatique
@subsection Comportement automatique
@translationof Automatic behavior
de modifier ce comportement automatique.
Parmi les objets extérieurs à la portée, on compte des éléments comme
-les marques de reprise, les indications de texte ou de nuances. Dans
+les marques de reprise, les indications de texte ou de nuance. Dans
LilyPond, la règle est de placer verticalement ces objets extérieurs à
la portée le plus près possible de la portée, tout en évitant la
collision avec d'autres objets. LilyPond utilise la propriété
à la portée doivent occuper la même place, c'est celui qui a la
@code{outside-staff-priority} la plus basse qui est placé le plus près
de la portée. Et si deux objets ont la même
-@code{outside-staff-priority}, le premier rencontré sera placé le plus
+@code{outside-staff-priority}, le premier rencontré sera placé au plus
près de la portée.
Dans l'exemple suivant, tous les @emph{markup} ont la même priorité,
utiliser la commande prédéfinie, suivie, après la note à modifier, de la
commande @code{\xxxNeutral} correspondante.
+
@subheading Doigtés
@cindex doigtés, positionnement
@node Objets hors de la portée
@subsection Objets hors de la portée
-@translationof Outside staff objects
+@translationof Outside-staff objects
Les objets extérieurs à la portée sont placés automatiquement de façon à
éviter les collisions. Les objets avec la plus petite valeur de la
tous les objets de la portée, et porte une valeur numérique appropriée à
chacun des objets extérieurs à la portée, à mesure qu'ils sont créés.
Le tableau suivant montre la valeur numérique par défaut pour
-quelques-uns des objets extérieurs à la portée les plus courants qui
-sont placés, par défaut, dans les contextes @code{Staff} ou
-@code{Voice}.
+quelques-uns des objets extérieurs à la portée les plus courant.
@cindex spanners
@cindex bandeaux
@code{outside-staff-priority} du @emph{grob} sous-jacent n'aura aucun
effet. C'est par exemple le cas lorsque vous modifiez l'alignement d'un
objet @code{Hairpin} à l'aide de @code{outside-staff-priority}@tie{};
-puique le soufflet est associé à un objet @code{DynamicLineSpanner},
+puisque le soufflet est associé à un objet @code{DynamicLineSpanner},
c'est sur celui-ci que doit porter l'effet de
@code{outside-staff-priority}. L'instruction dérogatoire se place au
début du bandeau qui constitue une ligne de base susceptible de contenir
@headitem Objet de rendu
@tab Priorité
@tab Contrôle la position de :
-@item @code{MultiMeasureRestText}
- @tab @code{450}
- @tab Texte sur les silences qui couvrent des mesures entières
+@item @code{RehearsalMark}
+ @tab @code{1500}
+ @tab Repère
+@item @code{MetronomeMark}
+ @tab @code{1000}
+ @tab Indication métronomique
+@item @code{VoltaBracketSpanner}
+ @tab @code{600}
+ @tab Bandeau de répétition
@item @code{TextScript}
@tab @code{450}
@tab Texte des @emph{markup} (ou étiquettes)
+@item @code{MultiMeasureRestText}
+ @tab @code{450}
+ @tab Texte sur les silences qui couvrent des mesures entières
@item @code{OttavaBracket}
@tab @code{400}
@tab Indication d'octaviation
@item @code{DynamicLineSpanner}
@tab @code{250}
@tab Toutes les marques de nuances
-@item @code{VoltaBracketSpanner}
+@item @code{BarNumber}
@tab @code{100}
- @tab Bandeau de répétition
+ @tab Numéro de mesure
@item @code{TrillSpanner}
@tab @code{50}
@tab Bandeau de trille
@code{\startTextSpan} jusqu'à la commande @code{\stopTextSpan} et le
format de texte est défini par la commande @code{\override TextSpanner}.
Pour de plus amples détails, voir
-@ruser{Indication textuelle avec ligne d’extension}.
+@ruser{Indication textuelle avec extension}.
Il montre aussi comment créer des marques d'octaviation.
@cindex modification du positionnement des marques de repère
@cindex marques de repère, modification du positionnement
-Vous aurez remarqué que les numéros de mesure, l'indication métronomique
-et les marques de répétition n'apparaissent pas. Par défaut, ils sont
-créés dans le contexte @code{Score} et leur
-@code{outside-staff-priority} est ignorée face aux objets qui sont créés
-dans le contexte @code{Staff}. Si vous voulez faire apparaître les
-numéros de mesure, l'indication métronomique ou les marques de
-répétition conformément à la valeur de leur
-@code{outside-staff-priority}, il vous faudra retirer respectivement le
-@code{Bar_number_engraver}, le @code{Metronome_mark_engraver} ou le
-@code{Mark_engraver} du contexte @code{Score} et les placer en tête du
-contexte @code{Staff}. Après quoi ces marques porteront les valeurs de
-@code{outside-staff-priority} par défaut suivantes@tie{}:
-
-@multitable @columnfractions .3 .3
-@headitem Objet de rendu @tab Priorité
-@item @code{RehearsalMark} @tab @code{1500}
-@item @code{MetronomeMark} @tab @code{1000}
-@item @code{BarNumber} @tab @code{ 100}
-@end multitable
-
Si les valeurs de @code{outside-staff-priority} par défaut ne donnent
pas les résultats escomptés, il suffit de modifier la priorité
de l'un de ces objets. Supposons que vous vouliez placer l'indication
d'octaviation sous le bandeau de texte, dans l'exemple précédent. Tout
ce que nous devons faire, c'est regarder la priorité de
-@code{OttavaBracket} dans la RPI ou dans le tableau plus haut, et la
-ramener à une valeur plus basse que celle de @code{TextSpanner}, en
-gardant à l'esprit que @code{OttavaBracket} est créé dans le contexte
-@code{Staff}@tie{}:
+@code{OttavaBracket} dans la Référence des propriétés internes ou dans
+le tableau plus haut, et la ramener à une valeur plus basse que celle de
+@code{TextSpanner}, en gardant à l'esprit que @code{OttavaBracket} est
+créé dans le contexte @code{Staff}@tie{}:
@cindex TextSpanner, exemple de dérogation
@cindex bound-details, exemple d'utilisation de la propriété
c,4 c c c |
@end lilypond
+N'oublions pas que certains objets, tels les numéros de mesure,
+indications métronomiques et marques-repères, sont par défaut attachés
+au contexte @code{Score}.
+
@cindex liaisons et outside-staff-priority
@cindex liaisons et articulations
@cindex articulations et liaisons
résultat ne soit pas toujours formidable. Imaginons que nous voulions
placer @qq{Text3} au-dessus de @qq{Text4} dans l'exemple de la section
@ref{Comportement automatique}, plus haut. Il nous suffit pour cela de
-regarder dans la RPI ou dans le tableau plus haut la priorité de
-@code{TextScript}, et d'augmenter la priorité de @qq{Text3} jusqu'à une
-valeur très haute@tie{}:
+regarder dans la Référence des propriétés internes ou dans le tableau
+plus haut la priorité de @code{TextScript}, et d'augmenter la priorité
+de @qq{Text3} jusqu'à une valeur très haute@tie{}:
@cindex TextScript, exemple de dérogation
@cindex outside-staff-priority, exemple d'utilisation de la propriété
notes pour laisser plus de place au texte. C'est possible grâce à la
commande @code{textLengthOn}.
+
@subheading \textLengthOn
@cindex notes, répartition selon le texte
@subheading Nuances
-@cindex modifier le positionnement des nuances
-@cindex nuances, modifier le positionnement
+@cindex modification du positionnement des nuances
+@cindex nuances, modification du positionnement
-Les indications de nuance se placent normalement sous la portée mais on
+Les indications de nuance se placent normalement sous la portée, mais on
peut les placer au-dessus avec la commande @code{dynamicUp}. Elles se
positionnent verticalement par rapport à la note à laquelle elles sont
liées et se décalent vers le bas (ou le haut) en fonction des objets de
Si une telle situation devait survenir dans de la musique @qq{réelle},
il serait préférable d'espacer un peu plus les notes, de façon que les
indications de nuance puissent toutes se situer à la même distance de la
-portée. Il était possible de faire cela pour les textes de
-@emph{markup} grâce à la commande @code{\textLengthOn} mais il n'existe
+portée. S'il est possible de faire cela pour les textes de
+@emph{markup} grâce à la commande @code{\textLengthOn}, il n'existe
pas d'équivalent pour les indications de nuance. Il nous faut donc
chercher à faire cela avec la commande @code{\override}.
+
@subheading Dimensionnement des objets graphiques
@cindex grob, dimensionnement
@code{'(+inf.0@tie{}.@tie{}-inf.0)}. Pour être sûr que les objets ne se
chevaucheront pas horizontalement, nous devons donc corriger cette
valeur de @code{extra-spacing-width} en @w{@code{'(0 . 0)}}, afin que
-leur vraie largeur se manifeste. La commande pour y parvenir avec des
+leur vraie largeur se manifeste. La commande pour y parvenir avec des
indications de nuances est@tie{}:
@example
* Exemple concret::
@end menu
+
@node Déplacement d'objets
@subsection Déplacement d'objets
@translationof Moving objects
Ce point a déjà été traité en détails -- voir
@ref{Objets inclus dans la portée}.
+
@item
@code{padding}, @code{right-padding}, @code{staff-padding}
sont pas forcément traitées dans l'objet en question@tie{}; il faut
alors regarder les objets qui semblent s'en rapprocher.
-Toutes les valeurs @code{padding} sont exprimées en espaces de portée.
+Toutes les valeurs @code{padding} sont exprimées en espace de portée.
Pour la plupart des objets, la valeur par défaut est aux alentours de
1,0 et parfois moins (cela dépend de chaque objet). Il est possible de
la modifier lorsqu'on a besoin d'un espace vide plus grand (ou plus
correspond à un déplacement de la moitié de la longueur du
texte.
+
@item
@code{extra-spacing-width}
@code{staff-position} est une propriété de la
@code{staff-symbol-referencer-interface}, qui s'applique aux objets
-positionnés par rapport à la portée. Elle indique, en demi-espaces de
+positionnés par rapport à la portée. Elle indique, en demi-espace de
portée, la position verticale des objets par rapport à la ligne médiane
de la portée. C'est bien pratique pour résoudre des problèmes de
collision entre des objets comme les silences valant mesure entière,
les liaisons et les notes de différentes voix.
+
@item
@code{force-hshift}
(voir @ref{Instanciation explicite des voix}) ne suffisent plus à
résoudre les conflits. Elle est alors préférable à l'utilisation de la
propriété @code{extra-offset}, dans la mesure où on n'a pas besoin
-d'exprimer la distance en espaces de portée et où le fait de déplacer
+d'exprimer la distance en espace de portée et où le fait de déplacer
les notes à l'intérieur ou à l'extérieur d'une @code{NoteColumn} affecte
d'autres actions comme les fusions de notes.
@end itemize
+
@item
Pour terminer, quand toutes les autres méthodes ont échoué, il est
possible de repositionner verticalement les objets à la main par rapport
à la ligne médiane de la portée, ou en les déplaçant à une distance
donnée vers une nouvelle position. Les inconvénients sont qu'il faut
individuellement, pour chaque objet, trouver les valeurs correctes de
-repositionnement souvent par tâtonnement, et que, puisque le
+repositionnement souvent par tâtonnement et que, puisque le
mouvement est opéré après que LilyPond a placé tous les autres
objets, c'est à l'utilisateur de résoudre tous les problèmes de
collision qui pourraient survenir. Et le pire avec cette méthode est
@cindex extra-offset, propriété
Cette propriété s'applique à tout objet acceptant la
-@code{grob-interface}. Elle reçoit une paire de nombre qui indiquent le
-déplacement supplémentaire dans le sens horizontal et vertical. Des
+@code{grob-interface}. Elle reçoit une paire de nombres qui indiquent
+le déplacement supplémentaire dans le sens horizontal et vertical. Des
nombres négatifs déplacent l'objet vers la gauche ou vers la droite.
L'unité utilisée est l'espace de portée. Le déplacement supplémentaire
intervient une fois que la composition des objets est achevée, si bien
Cette propriété est très utile pour ajuster manuellement l'inclinaison
et la hauteur des barres de ligature, des liaisons et des nolets. Elle
-est suivie de deux nombres qui donnent la position des bords gauche et
-droit des barres, liaisons, etc. par rapport à la ligne médiane de la
-portée. L'unité de référence est l'intervalle de lignes de portée.
+est suivie de deux nombres qui donnent la position des extrémités gauche
+et droite des barres, liaisons, etc. par rapport à la ligne médiane de
+la portée. L'unité de référence est l'intervalle de lignes de portée.
Attention toutefois au fait que les liaisons et phrasés ne peuvent pas
être repositionnés n'importe où. LilyPond commence par dresser la liste
des emplacements possibles pour les liaisons et choisit par défaut la
Voyons maintenant comment les propriétés décrites dans la section
précédente peuvent nous aider à résoudre les collisions.
+
@subheading la propriété padding
@cindex décalage (padding)
@code{outside-staff-priority}, cet objet sera déplacé, ainsi que tous
les autres objets du groupe.
+
@subheading right-padding
@cindex right-padding, propriété
@noindent
+
@subheading la propriété staff-padding
@cindex alignement d'objets sur une ligne de base
<a\2>
@end lilypond
+
@subheading la propriété staff-position
@cindex collision d'objets à l'intérieur d'une portée
@code{MultiMeasureRest}@tie{}; nous avons donc besoin de la déplacer,
disons, de quatre demi-intervalles vers le bas, ce qui donne @code{-8}.
-
@cindex MultiMeasureRest, exemple de dérogation
@cindex staff-position, exemple d'utilisation de la propriété
car la ligne supplémentaire au-dessus du silence est insérée
automatiquement.
+
@subheading la propriété extra-offset
@cindex positionnement des objets
\acciaccatura e8\( d8 c~ c d c d\)
@end lilypond
-Voici un autre exemple, tiré du début de la partie de main gauche
-du Prélude de Chopin, Op. 28, No 2. Comme nous pouvons le
-constater, les barres de ligature chevauchent les notes les plus
-hautes@tie{}:
+Voici un autre exemple. Comme nous pouvons le constater, les barres de
+ligature chevauchent les liaisons de tenue@tie{}:
@lilypond[quote,verbatim,fragment,ragged-right]
{
- \clef "bass"
- << { b,8 ais, b, g, } \\ { e,8 g e, g } >>
- << { b,8 ais, b, g, } \\ { e,8 g e, g } >>
+ \time 4/2
+ <<
+ { c'1 ~ c'2. e'8 f' }
+ \\
+ { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
+ >>
+ <<
+ { c'1 ~ c'2. e'8 f' }
+ \\
+ { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
+ >>
}
@end lilypond
@noindent
On peut y remédier en déplaçant manuellement vers le haut les deux
-extrémités des ligatures de croches, non plus à 2 intervalles au-dessus
-de la ligne médiane mais, disons, à 3@tie{}:
+extrémités des ligatures de croches, non plus à 1,81 intervalle
+au-dessous de la ligne médiane mais, disons, à 1@tie{}:
@cindex Beam, exemple de dérogation
@cindex positions, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,fragment,ragged-right]
{
- \clef "bass"
+ \time 4/2
<<
- \override Beam #'positions = #'(3 . 3)
- { b,8 ais, b, g, }
- \\
- { e,8 g e, g }
+ { c'1 ~ c'2. e'8 f' }
+ \\
+ {
+ \override Beam #'positions = #'(-1 . -1)
+ e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g''
+ }
+ >>
+ <<
+ { c'1 ~ c'2. e'8 f' }
+ \\
+ { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
>>
- << { b,8 ais, b, g, } \\ { e,8 g e, g } >>
}
@end lilypond
@noindent
Vous remarquerez que la retouche continue de s'appliquer au
second bloc de croches de la première voix mais qu'il ne s'applique
-à aucune barre de la deuxième voix.
+à aucune mesure de la deuxième voix.
+
@subheading la propriété force-hshift
<<
{ c2 aes4. bes8 }
\\
- { aes2 f4 fes }
+ { <ees, c>2 des }
\\
- {
- \voiceFour
- <ees c>2 des
- }
+ \\
+ { aes'2 f4 fes }
>> |
<c ees aes c>1 |
}
@end lilypond
@noindent
-Les deux plus basses notes du premier accord (c'est-à-dire celles de la
-troisième voix) ne devraient pas être décalées de l'empilement des deux
-plus hautes notes. Pour y remédier, nous réglons le @code{force-hshift}
--- qui est une propriété de @code{NoteColumn} -- de ces notes sur zéro.
-Ensuite, la note la plus basse du second accord serait mieux à droite
-des notes plus hautes. Pour cela, nous réglons le @code{force-hshift}
-de cette note sur 0,5 -- c'est-à-dire la moitié de la largeur d'une tête
-de note vers la droite de la colonne des notes plus hautes.
+La note intermédiaire du premier accord, le la bémol à la quatrième
+voix, doit rester dans le même empilement avec la note haute. Pour y
+remédier, nous réglons le @code{force-hshift} -- qui est une propriété
+de @code{NoteColumn} -- de cette note sur zéro.
+
+Quant au second accord, il serait préférable que le fa s'aligne avec le
+la et que la note la plus basse se positionne un peu plus sur la droite
+pour éviter que les hampes se chevauchent. Pour cela, nous réglons le
+@code{force-hshift} au niveau du @code{NoteColumn} du ré bémol de telle
+sorte qu'il se déplace de la moitié d'un espace de portée vers la
+droite.
Et voici le résultat final :
<<
{ c2 aes4. bes8 }
\\
- { aes2 f4 fes }
- \\
{
- \voiceFour
- \once \override NoteColumn #'force-hshift = #0
- <ees c>2
+ <ees, c>2
\once \override NoteColumn #'force-hshift = #0.5
des2
}
+ \\
+ \\
+ {
+ \override NoteColumn #'force-hshift = #0
+ aes'2 f4 fes
+ }
>> |
<c ees aes c>1 |
}
c,8~
% Reposition the c2 to the right of the merged note
\once \override NoteColumn #'force-hshift = #1.0
- % Move the c2 out of the main note column so the merge will work
+ % Move the c2 out of the main note column
+ % so the merge will work
\shiftOnn
c2
}
\stemDown
% Stem on the d2 should be invisible
\once \override Stem #'transparent = ##t
+ \once \override Flag #'transparent = ##t
d2
}
\new Voice {
le do avec liaison, le ré blanche qui se fond avec le ré croche, et le
fa dièse noire pointée qui se fond lui aussi avec la croche de même
hauteur. Tout le reste se réduit à une seule voix. Le plus simple est
-donc de créer temporairement ces quatre voix au moment opportun.
-Si vous avez oublié comment faire, reportez-vous à
-@ref{J'entends des Voix}. Commençons par saisir les notes comme
-appartenant à deux variables, mettons en place l'ossature des
-portées dans un bloc @code{\Score} et voyons ce que LilyPond propose par
-défaut@tie{}:
+donc de créer temporairement ces trois voix supplémentaires au moment
+opportun. Si vous avez oublié comment faire, reportez-vous à
+@ref{J'entends des Voix} et @ref{Instanciation explicite des voix}.
+Nous opterons ici pour une déclaration explicite des voix du passage
+polyphonique, puisque LilyPond est alors plus performant en matière
+d'évitement des collisions.
+
+Commençons par saisir les notes comme appartenant à deux variables,
+mettons en place l'ossature des portées dans un bloc @code{\Score} et
+voyons ce que LilyPond propose par défaut@tie{}:
@c line-width ensures no break
@lilypond[quote,verbatim,ragged-right,line-width=6\in]
{ c,8 d fis bes a } % continuation of main voice
\new Voice {
\voiceTwo
- % Move the c2 out of the main note column so the merge will work
+ % Move the c2 out of the main note column
+ % so the merge will work
c,8~ \shiftOnn c2
}
\new Voice {
c,8~
% Reposition the c2 to the right of the merged note
\once \override NoteColumn #'force-hshift = #1.0
- % Move the c2 out of the main note column so the merge will work
+ % Move the c2 out of the main note column
+ % so the merge will work
\shiftOnn
c2
}
\stemDown
% Stem on the d2 should be invisible
\once \override Stem #'transparent = ##t
+ \once \override Flag #'transparent = ##t
d2
}
\new Voice {
* Utilisation de variables dans les retouches::
* Feuilles de style::
* Autres sources de documentation::
-* Options ralentissant le traitement::
* Retouches avancées avec Scheme::
@end menu
@cindex objets, invisibles
@cindex liaison de tenue avec changement de voix
+
@subheading Liaison entre plusieurs voix
Voici un exemple qui montre comment créer une liaison de
<<
{
\once \override Stem #'transparent = ##t
+ \once \override Flag #'transparent = ##t
b8~ b\noBeam
}
\\
<<
{
\once \override Stem #'transparent = ##t
+ \once \override Flag #'transparent = ##t
\once \override Stem #'length = #8
b8~ b8\noBeam
}
>>
@end lilypond
+
@subheading Rendu MIDI d'un point d'orgue
@cindex stencil, utilisation de la propriété
les variables des noms plus courts pour simplifier la frappe. Par
ailleurs, le fait de recourir à une variable ne nous expose plus à
l'oubli des espaces entourant les points lorsqu'explicités au beau
-milieu d'un bloc @code{\lyriqcmode}@tie{}!
+milieu d'un bloc @code{\lyricmode}@tie{}!
@cindex LyricText, exemple de dérogation
@cindex font-shape, exemple d'utilisation de la propriété
}
@end lilypond
-Il y a quelques problèmes de chevauchement@tie{}; nous allons arranger
-cela en utilisant les techniques de @ref{Déplacement d'objets}. On peut
-aussi faire quelque chose pour les définitions de @code{mpdolce}
+On peut faire quelque chose pour les définitions de @code{mpdolce}
et @code{inst}. Elles produisent le résultat que nous désirons,
mais nous pourrions aussi vouloir les utiliser dans une autre pièce.
Il suffirait de les copier et coller au début de chaque
voué à être inclus dans un fichier maître@tie{}; il n'est pas destiné à
être compilé isolément.@*
Maintenant, modifions notre musique (enregistrez ce fichier
-sous @code{musique.ly}).
+sous @file{musique.ly}).
@c We have to do this awkward example/lilypond-non-verbatim
@c because we can't do the \include stuff in the manual.
@itemize @bullet
@item Linux
-@file{@var{INSTALLDIR}/lilypond/usr/share/lilypond/current/}
+@example
+@file{@var{INSTALLDIR}/lilypond/usr/@/share/lilypond/current/}
+@end example
@item MacOS X
-@code{@var{INSTALLDIR}/LilyPond.app/Contents/Resources/share/lilypond/current/}
+@example
+@file{@var{INSTALLDIR}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
+@end example
+
Pour accéder à ce dossier, deux possibilités@tie{}: soit, dans un
Terminal, taper @code{cd} suivi du chemin complet ci-dessus@tie{}; soit
Control-cliquer (ou clic droit) sur l'application LilyPond
@item Windows
Dans l'Explorateur Windows, voir
-@code{@var{INSTALLDIR}/LilyPond/usr/share/lilypond/current/}
+@example
+@file{@var{INSTALLDIR}/LilyPond/usr/@/share/lilypond/current/}
+@end example
@end itemize
@item @code{scm/} -- contient les fichiers en format Scheme
@end itemize
-Commençons par examiner quelques fichiers contenus dans @code{ly/}.
-Nous ouvrons @code{ly/property-init.ly} dans un éditeur de texte --
-celui que vous avez l'habitude d'utiliser pour les fichiers @code{.ly}
+Commençons par examiner quelques fichiers contenus dans @file{ly/}.
+Nous ouvrons @file{ly/property-init.ly} dans un éditeur de texte --
+celui que vous avez l'habitude d'utiliser pour les fichiers @file{.ly}
fera très bien l'affaire. Ce fichier contient les définitions de toutes
les commandes standard prédéfinies de LilyPond, comme @code{\stemUp} et
@code{\slurDotted}. Vous pouvez constater que ce n'est rien d'autre
peuvent être facilement redéfinies, comme n'importe quelle autre
variable, en tête de votre fichier d'entrée.
-Voici les fichiers les plus utiles dans le répertoire @code{ly/}@tie{}:
+Voici les fichiers les plus utiles dans le répertoire @file{ly/}@tie{}:
@multitable @columnfractions .4 .6
@headitem Nom de fichier
@tab Contenu
-@item @code{ly/engraver-init.ly}
+@item @file{ly/engraver-init.ly}
@tab Définitions des Contextes de graveurs
-@item @code{ly/paper-defaults-init.ly}
+@item @file{ly/paper-defaults-init.ly}
@tab Réglages papier par défaut
-@item @code{ly/performer-init.ly}
+@item @file{ly/performer-init.ly}
@tab Définitions des Contextes d'interprétation
-@item @code{ly/property-init.ly}
+@item @file{ly/property-init.ly}
@tab Définitions de toutes les commandes prédéfinies courantes
-@item @code{ly/spanner-init.ly}
+@item @file{ly/spanner-init.ly}
@tab Définitions des commandes prédéfinies pour les bandeaux
@end multitable
Les autres réglages (comme les définitions de commandes @emph{markup})
-sont conservés comme fichiers @code{.scm} (Scheme). Le langage de
+sont conservés comme fichiers @file{.scm} (Scheme). Le langage de
programmation Scheme offre une interface programmable dans le
processus interne de LilyPond. De plus amples explications sur ces
fichiers dépasseraient le cadre de ce manuel dans la mesure où elles
souhaiteraient comprendre le fonctionnement de ces fichiers de
configuration doivent être avertis que des connaissances techniques
substantielles et beaucoup de temps sont nécessaires (voir le
-@rextendnamed{Scheme tutorial,Tutoriel Scheme}).
+@rextend{Tutoriel Scheme}).
Si c'est votre cas, les fichiers Scheme les plus utiles à connaître
sont@tie{}:
@multitable @columnfractions .4 .6
@headitem Nom de fichier
@tab Contenu
-@item @code{scm/auto-beam.scm}
- @tab Régles par défaut des ligatures subalternes
-@item @code{scm/define-grobs.scm}
+@item @file{scm/auto-beam.scm}
+ @tab Règles par défaut des ligatures subalternes
+@item @file{scm/define-grobs.scm}
@tab Réglages par défaut des propriétés de @emph{grobs}
-@item @code{scm/define-markup-commands.scm}
+@item @file{scm/define-markup-commands.scm}
@tab Spécification de toutes les commandes de @emph{markup}
-@item @code{scm/midi.scm}
+@item @file{scm/midi.scm}
@tab Réglages par défaut pour les sorties MIDI
-@item @code{scm/output-lib.scm}
+@item @file{scm/output-lib.scm}
@tab Réglages affectant l'apparence des frets, couleurs, altérations,
barres de mesure, etc.
-@item @code{scm/parser-clef.scm}
- @tab Définition des clefs prises en charge
-@item @code{scm/script.scm}
- @tab Réglages par défaut des articulations
+@item @file{scm/parser-clef.scm}
+ @tab Définition des clefs prises en charge
+@item @file{scm/script.scm}
+ @tab Réglages par défaut des articulations
@end multitable
-
-@node Options ralentissant le traitement
-@subsection Options ralentissant le traitement
-@translationof Avoiding tweaks with slower processing
-
-LilyPond peut effectuer des vérifications supplémentaires lors du
-traitement des fichiers@tie{}; cependant, le rendu nécessitera alors
-plus de temps. En contrepartie, il y aura moins d'ajustements manuels à
-réaliser. Si une indication textuelle ou des paroles débordent dans la
-marge, ces vérifications auront pour effet de resserrer la ligne
-suffisamment pour faire tenir le texte entre les marges.
-
-Pour pouvoir fonctionner en toutes circonstances, ces vérifications
-doivent être activées@tie{}; il faut pour cela placer les retouches dans
-un @code{\context} à l'intérieur d'un bloc @code{\layout}, plutôt que
-directement dans le fragment musical, comme ceci@tie{}:
-
-@example
-\score @{
- @{ @dots{}notes@dots{} @}
- \layout @{
- \context @{
- \Score
- % Pour s'assurer que les indications textuelles et paroles
- % seront à l'intérieur des marges de la page.
- \override PaperColumn #'keep-inside-line = ##t
- \override NonMusicalPaperColumn #'keep-inside-line = ##t
- @}
- @}
-@}
-@end example
-
-
@node Retouches avancées avec Scheme
@subsection Retouches avancées avec Scheme
@translationof Advanced tweaks with Scheme
intégré directement dans le processus interne de LilyPond. Bien sûr,
il faut pour cela connaître un minimum de programmation en langage
Scheme. Pour des explications complètes là-dessus, consultez le
-@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
+@rextend{Tutoriel Scheme}.
En guise d'illustration -- et ce n'est qu'une possibilité parmi tant
d'autres -- nous allons attribuer à une propriété non pas une valeur
fonction de leur position sur la portée.
-@cindex x11-color, exemple d'utilisaation de la fonction
+@cindex x11-color, exemple d'utilisation de la fonction
@cindex NoteHead, exemple de dérogation
@cindex color, détermination de la propriété par une procédure Scheme
}
@end lilypond
-Vous trouverez dans @rextendnamed{Callback functions,les fonctions
-callback} d'autres exemples d'utilisation de ces interfaces
-programmables.
+Vous trouverez dans @rextend{Fonctions de rappel} d'autres exemples
+d'utilisation de ces interfaces programmables.
projects / lilypond.git / blobdiff