@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-
@ignore
- Translation of GIT committish: 90a367b11c50bd1fe242656715f807d1445225d7
+ Translation of GIT committish: a042d99cd2251b2b9121e1b8ad30307c4ce28863
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
@c \version "2.12.0"
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
@c Translation status: post-GDP
-@node Tweaking output
-@chapter Tweaking output
+@node Retouche de partition
+@chapter Retouche de partition
+@translationof Tweaking output
Ce chapitre indique comment modifier le résultat obtenu.
LilyPond offre de nombreuses possibilités de réglages, permettant
théoriquement de modifier chaque élément de votre partition.
@menu
-* Tweaking basics::
-* The Internals Reference manual::
-* Appearance of objects::
-* Placement of objects::
-* Collisions of objects::
-* Further tweaking::
+* Retouches élémentaires::
+* Le manuel des références internes::
+* Apparence des objets::
+* Positionnement des objets::
+* Collisions d'objets::
+* Autres retouches::
@end menu
-@node Tweaking basics
-@section Tweaking basics
+@node Retouches élémentaires
+@section Retouches élémentaires
+@translationof Tweaking basics
@menu
-* Introduction to tweaks::
-* Objects and interfaces::
-* Naming conventions of objects and properties::
-* Tweaking methods::
+* Introduction aux retouches::
+* Objets et interfaces::
+* Conventions de nommage des objets et propriétés::
+* Méthodes de retouche::
@end menu
-@node Introduction to tweaks
-@subsection Introduction to tweaks
+@node Introduction aux retouches
+@subsection Introduction aux retouches
+@translationof Introduction to tweaks
LilyPond regroupe sous le terme de @qq{retouches} (@emph{tweaks} en
anglais) les différents moyens dont dispose l'utilisateur pour
vos propres retouches.
Avant de vous lancer dans ce chapitre, il peut être utile de revoir la
-section @ref{Contexts and engravers}, dans la mesure où les contextes,
+section @ref{Contextes et graveurs}, dans la mesure où les contextes,
graveurs et autres propriétés qui y sont décrits, sont indispensables
pour comprendre et construire les retouches.
-@node Objects and interfaces
-@subsection Objects and interfaces
+@node Objets et interfaces
+@subsection Objets et interfaces
+@translationof Objects and interfaces
@cindex objet
@cindex grob
Ainsi s'achève le tour des principaux termes relatifs aux objets et
que nous serons amenés à utiliser dans ce chapitre.
-@node Naming conventions of objects and properties
-@subsection Naming conventions of objects and properties
+@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
@cindex conventions de nommage des objets
@cindex conventions de nommage des propriétés
@cindex objets, conventions de nommage des
@cindex propriétés, conventions de nommage des
-Nous avons eu un aperçu, dans @ref{Contexts and engravers}, de
+Nous avons eu un aperçu, dans @ref{Contextes et graveurs}, de
la façon de nommer les objets. Voici maintenant une liste de
référence des types d'objets et de propriétés les plus courants,
-avec leur convention de nommage et quelques exemples
-de cas concrets. La lettre @code{A} représente n'importe quel
-caractère alphabétique majuscule, et les lettres @code{aaa}
+avec leurs conventions de nommage et quelques exemples
+de cas concrets. La lettre @var{A} représente n'importe quel
+caractère alphabétique majuscule, et les lettres @var{aaa}
un nombre indéterminé de caractères alphabétiques minuscules.
-Les autres caractères sont à prendre comme ils se présentent.
+Les autres caractères sont à prendre tels qu'ils se présentent.
@multitable @columnfractions .33 .33 .33
@headitem Type d'objet/propriété
- @tab Convention de désignation
+ @tab Convention de nommage
@tab Exemples
@item Contextes
@tab Aaaa ou AaaaAaaaAaaa
@end multitable
Comme nous le verrons bientôt, les propriétés des différents
-types d'objets sont modifiées par des commandes différentes, si bien
-qu'il est bon de savoir reconnaître le type d'objet en fonction du nom
+types d'objet sont modifiées par des commandes différentes, si bien
+qu'il est bon de savoir reconnaître le type d'un objet en fonction du nom
de ses propriétés.
-@node Tweaking methods
-@subsection Tweaking methods
+@node Méthodes de retouche
+@subsection Méthodes de retouche
+@translationof Tweaking methods
@cindex retouches, méthodologie
@cindex méthodes de retouche
@funindex \override
@funindex override
-Dans @ref{Modifying context properties} et dans
-@ref{Adding and removing engravers}, nous avons déjà rencontré les
+Dans @ref{Modification des propriétés d'un contexte} et dans
+@ref{Ajout et suppression de graveurs}, nous avons déjà rencontré les
commandes @code{\set} et @code{\with}, qui servent à changer les
propriétés des @strong{contextes} et à supprimer ou ajouter des
@strong{graveurs}. Voici maintenant d'autres commandes plus
l'utiliser. L'exemple ci-dessous change la couleur des têtes de
notes :
-@cindex couleur,exemple de propriété
+@cindex couleur,exemple d'utilisation de la propriété
@cindex NoteHead, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
nombreux exemples ci-dessous. Voici un exemple qui ramène la
couleur des deux dernières notes à leur valeur par défaut :
-@cindex couleur,exemple de propriété
+@cindex couleur,exemple d'utilisation de la propriété
@cindex NoteHead, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
sa valeur par défaut. Toujours à partir du même exemple, il est
possible de ne changer la couleur que d'une seule note :
-@cindex couleur,exemple de propriété
+@cindex couleur,exemple d'utilisation de la propriété
@cindex NoteHead, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
Il existe une autre forme de commande @code{\override},
@code{\overrideProperty}, qui est parfois utile. Nous la mentionnons
-ici par souci d'exhaustivité ; pour le détail, voir @ruser{Difficult tweaks}.
+ici par souci d'exhaustivité ; pour le détail, voir
+@ruser{Retouches complexes}.
@c Maybe explain in a later iteration -td
@code{\tweak}. Elle sert à changer les propriétés d'objets qui
surviennent simultanément dans la musique, comme par exemple les
notes d'un accord. La commande @code{\override} modifierait toutes
-les notes de l'accord, tandis que @code{\tweak} ne modifie que
-l'élément suivant dans la chaîne de saisie.
+les notes de l'accord, tandis que @code{\tweak} permet de ne modifier
+que l'élément suivant dans la chaîne de saisie.
Voici un exemple. Supposons que nous voulions changer la taille de
la tête de note du milieu (le mi) dans un accord de do majeur. Voyons
d'abord ce que donnerait @code{\once \override} :
-@cindex font-size, exemple de propriété
+@cindex font-size, exemple d'utilisation de la propriété
@cindex NoteHead, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
Pour reprendre notre exemple, la taille de la note du milieu d'un
accord peut être modifiée de cette manière :
-@cindex font-size, exemple de propriété
+@cindex font-size, exemple d'utilisation de la propriété
@cindex @code{\tweak}, exemple
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
La commande @code{\tweak} est aussi utilisée quand on veut, dans
une série d'articulations, n'en modifier qu'une seule. Ainsi :
-@cindex couleur, exemple de propriété
+@cindex couleur, exemple d'utilisation de la propriété
@cindex @code{\tweak}, exemple
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
premier crochet de triolet court.
@cindex @code{\tweak}, exemple
-@cindex direction, exemple de propriété
-@cindex couleur, exemple de propriété
+@cindex direction, exemple d'utilisation de la propriété
+@cindex couleur, exemple d'utilisation de la propriété
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
\tweak #'direction #up
leur apparence peut alors être modifiée de la façon habituelle,
avec la commande @code{\override} :
-@cindex texte, exemple de propriété
-@cindex tuplet-number, example de fonction
-@cindex transparence, example de propriété
+@cindex texte, exemple d'utilisation de la propriété
+@cindex tuplet-number, exemple de fonction
+@cindex transparence, exemple d'utilisation de la propriété
@cindex TupletNumber, exemple de dérogation
@c NOTE Tuplet brackets collide if notes are high on staff
@seealso
Manuel de notation :
-@ruser{The tweak command}.
+@ruser{La commande d'affinage (@emph{tweak})}.
-@node The Internals Reference manual
-@section The Internals Reference manual
+@node Le manuel des références internes
+@section Le manuel des références internes
+@translationof The Internals Reference manual
@cindex Références internes
@menu
-* Properties of layout objects::
-* Properties found in interfaces::
-* Types of properties::
+* Propriétés des objets de rendu::
+* Propriétés listées par interface::
+* Types de propriétés::
@end menu
-@node Properties of layout objects
-@subsection Properties of layout objects
+@node Propriétés des objets de rendu
+@subsection Propriétés des objets de rendu
+@translationof Properties of layout objects
@cindex propriétés des objets de rendu
@cindex propriétés des objets graphiques (grobs)
RPI correspondant à votre version du programme. Allez sur la page
Documentation et cliquez sur Référence des propriétés internes.
Pour l'apprentissage, mieux vaut utiliser la version HTML standard,
-et non la @q{page unique en anglais} ou le PDF. Durant la lecture
+et non la @qq{page unique en anglais} ou le PDF. Durant la lecture
des prochains paragraphes, il vous est conseillé de vous y reporter
réellement afin que les explications prennent tout leur sens.
Voilà qui semble approprié pour changer l'épaisseur (@emph{thickness} en
anglais). On apprend que la valeur de @code{thickness}
-est un simple nombre (@emph{number}), qu'elle est par défaut
+est un simple nombre (@emph{number}), qu'elle est par défaut définie
à 1,2 et que l'unité de mesure est fixée par une autre propriété
appelée @code{line-thickness}.
Comme il a été indiqué, on ne trouve que peu, voire pas du tout
-d'explications dans la RPI, mais nous en savons assez pour essayer
+d'explication dans la RPI, mais nous en savons assez pour essayer
de changer l'épaisseur de la liaison. Comme nous l'avons vu, le
nom de l'objet est @code{Slur}, le nom de la propriété à changer
est @code{thickness} et la nouvelle valeur sera un nombre supérieur
-à 1.2 si l'on veut augmenter l'épaisseur du trait.
+à @code{1.2} si l'on veut augmenter l'épaisseur du trait.
Pour construire la commande @code{\override}, il suffit donc de
remplacer les valeurs que nous avons trouvées en guise de noms, en
proche d'elle.} Essayons :
@cindex Slur, exemple de dérogation
-@cindex thickness, exemple de propriété
+@cindex thickness, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,relative=2]
{
commandes -- mais il faut encore s'exercer. Les exemples
suivants sont là dans cette intention.
-@subheading Finding the context
+@subheading Détermination du contexte adéquat
@cindex contexte, détermination du
@cindex contexte, identification correcte du
elles sont étroitement liées à une ligne mélodique, mais
comment en être sûr ? Pour répondre à cette question,
revenons en haut de la page de la RPI consacrée aux liaisons ;
-il est écrit : @q{Les objets Liaison sont créés par le graveur
+il est écrit : @qq{Les objets Liaison sont créés par le graveur
Slur_engraver}. Ainsi les liaisons seront créées dans n'importe
quel contexte où se trouve le @code{Slur_engraver}. Suivons
le lien vers la page @code{Slur_engraver}. Tout en bas, on
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 Overriding once only
+@subheading Redéfinition pour une seule occurence
@cindex dérogation pour une seule fois
@cindex usage unique, dérogation à
@cindex Slur, exemple de dérogation
-@cindex thickness, exemple de propriété
+@cindex thickness, exemple d'utilisation de la propriété
@cindex Liaison, exemple de dérogation
-@cindex Épaisseur, exemple de propriété
+@cindex Épaisseur, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,relative=2]
{
@code{\set}.
-@subheading Reverting
+@subheading Rétablissement
@cindex revert
@cindex retour
@cindex Slur, exemple de dérogation
-@cindex thickness, exemple de propriété
+@cindex thickness, exemple d'utilisation de la propriété
@cindex Liaison, exemple de dérogation
-@cindex Épaisseur, exemple de propriété
+@cindex Épaisseur, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,relative=2]
{
@code{thickness} à sa valeur par défaut .
@cindex Slur, exemple de dérogation
-@cindex thickness, exemple de propriété
+@cindex thickness, exemple d'utilisation de la propriété
@cindex Liaison, exemple de dérogation
-@cindex Épaisseur, exemple de propriété
+@cindex Épaisseur, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,relative=2]
{
exemples seront progressivement accompagnés d'explications et
introduiront des termes nouveaux.
-@node Properties found in interfaces
-@subsection Properties found in interfaces
+@node Propriétés listées par interface
+@subsection Propriétés listées par interface
+@translationof Properties found in interfaces
@cindex interface
@cindex interfaces, propriétés des
Supposons maintenant que nous voulions imprimer des paroles en italique.
Quelle formulation de la commande @code{\override} allons-nous utiliser ?
Nous consultons en premier lieu, comme précédemment, la page de la RPI
-qui contient la liste @q{Tous les objets de rendu}, et recherchons
+qui contient la liste @qq{Tous les objets de rendu}, et recherchons
un objet qui contrôle les paroles. Nous trouvons @code{LyricText}, qui
semble approprié. Nous cliquons dessus et nous voyons apparaître les
différentes propriétés des paroles, parmi lesquelles @code{font-series}
interface, qui sont en même temps les propriétés de tous les objets qui
s'y rapportent, parmi lesquels LyricText.
-Nous avons alors sous les yeux tous les réglages de propriétés qui
+Nous avons alors sous les yeux tous les réglages des propriétés qui
contrôlent les polices de caractères, et notamment
@code{font-shape(symbole)}, où @code{symbole} peut prendre la valeur
@code{upright}, @code{italics} ou @code{caps}.
d'autres sont des valeurs à attribuer aux propriétés, comme
@code{italic}. À ne pas confondre avec les chaînes de caractères libres,
qui se présentent comme @code{"un texte libre"} ; pour plus de détails
-sur les symboles et les chaînes de caractères, voir @ref{Scheme
-tutorial}.
+sur les symboles et les chaînes de caractères, voir @ref{Tutoriel Scheme}.
Ainsi, la commande @code{\override} pour mettre les paroles en italique
est :
@end example
@noindent
-et elle doit être placée juste devant et tout près des paroles à modifier,
+et doit être placée juste devant et tout près des paroles à modifier,
comme ceci :
-@cindex font-shape, exemple de propriété
+@cindex font-shape, exemple d'utilisation de la propriété
@cindex italic, exemple
@cindex LyricText, exemple de dérogation
@cindex @code{\addlyrics}, exemple
@noindent
et voilà les paroles en italiques.
-@subheading Specifying the context in lyric mode
+@subheading Spécification du contexte en mode lyrique
@cindex contexte, spécification en mode lyrique
@cindex mode lyrique, spécification de contexte en
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, @q{.}, qui sépare le nom de
+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 correcte est
donc :
autour du point qui sépare le nom de contexte du nom d'objet.}
@seealso
-Manuel d'initiation : @ref{Scheme tutorial}.
+Manuel d'initiation : @ref{Tutoriel Scheme}.
-@node Types of properties
-@subsection Types of properties
+@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 :
-@code{nombre} et @code{symbol}. Pour pouvoir fonctionner, la valeur
+@code{nombre} et @code{symbole}. Pour pouvoir fonctionner, la valeur
associée à une propriété doit correspondre au type attendu et suivre les
règles liées à ce type. Le type de propriété est toujours donné entre
parenthèses après le nom de propriété dans la RPI. Voici une liste des
@headitem Type de propriété
@tab Règles
@tab Exemples
-@item Booléenne (anglais @emph{Boolean})
+@item Booléenne (@emph{Boolean} en anglais)
@tab Vrai (@emph{true} en anglais) ou Faux (@emph{false} en anglais),
-sous la forme #t ou #f
+ sous la forme #t ou #f
@tab @code{#t}, @code{#f}
@item Dimension (en lignes 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 Une direction valide ou son équivalent numérique (valeur décimale
-comprise entre -1 et 1 seulement)
+ comprise entre -1 et 1 seulement)
@tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @code{-1}
-@item Durée (@emph{Moment} en anglais)
- @tab Une durée de note construite avec la fonction make-moment
- @tab @code{(ly:make-moment 1 4)}, @code{(ly:make-moment 3 8)}
@item Entier (@emph{Integer} en anglais)
@tab Un nombre entier positif
@tab @code{3}, @code{1}
-@item Inconnu (@emph{Unknown} en anglais)
- @tab Un processus, ou @code{#f} pour empêcher toute action
- @tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f}
@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
@item Markup (ou étiquette)
@tab Toute commande @code{\markup} valide
@tab @code{\markup @{ \italic "cresc." @}}
+@item Durée (@emph{Moment} en anglais)
+ @tab Une durée de note construite avec la fonction make-moment
+ @tab @code{(ly:make-moment 1 4)}, @code{(ly:make-moment 3 8)}
@item Nombre
@tab Une valeur décimale positive ou négative
@tab @code{3.5}, @code{-2.45}
@item Paire (de nombres)
- @tab Deux nombres séparées par @q{espace . espace}, encadrés
+ @tab Deux nombres séparées par @qq{espace point espace}, encadrés
par des parenthèses et précédés par une apostrophe
@tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
@item Symbole
@tab L'un des symboles autorisés pour cette propriété, précédé par une
apostrophe
@tab @code{'italic}, @code{'inside}
+@item Inconnu (@emph{Unknown} en anglais)
+ @tab Un processus, ou @code{#f} pour empêcher toute action
+ @tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f}
@item Vecteur
@tab Une liste de trois éléments encadrés par des parenthèses et
précédés par apostrophe-hash, @code{'#}
@tab @code{'#(#t #t #f)}
@end multitable
+
@seealso
-Manuel d'initiation : @ref{Scheme tutorial}.
+Manuel d'initiation : @ref{Tutoriel Scheme}.
-@node Appearance of objects
-@section Appearance of objects
+@node Apparence des objets
+@section Apparence des objets
+@translationof Appearance of objects
Il est temps de mettre en pratique les notions apprises précédemment
pour modifier l'allure de la partition ; les exemples qui suivent
montrent l'utilisation des différentes méthodes de retouche.
@menu
-* Visibility and color of objects::
-* Size of objects::
-* Length and thickness of objects::
+* Visibilité et couleur des objets::
+* Taille des objets::
+* Longueur et épaisseur des objets::
@end menu
-@node Visibility and color of objects
-@subsection Visibility and color of objects
+@node Visibilité et couleur des objets
+@subsection Visibilité et couleur des objets
+@translationof Visibility and color of objects
Dans un but pédagogique, on peut être amené à masquer certains éléments
d'une partition, que les élèves doivent ensuite compléter. Imaginons,
Avant de nous y attaquer, souvenons-nous que les propriétés d'objets
sont parfois groupées dans ce qu'on appelle des @emph{interfaces} --
-voir @ref{Properties found in interfaces}. Cela permet de rapprocher
+voir @ref{Propriétés listées par interface}. Cela permet de rapprocher
toutes les propriétés susceptibles d'être utilisées ensemble pour
modifier un objet graphique -- si l'une d'elles est choisie pour un
objet, elle s'appliquera à tous les autres. Certains objets tirent
RPI, en bas de la page de description du @emph{grob} ; pour voir ces
propriétés, il faut aller voir ces interfaces.
-Nous avons vu, dans @ref{Properties of layout objects}, comment trouver
+Nous avons vu, dans @ref{Propriétés des objets de rendu}, comment trouver
les informations sur les @emph{grobs}. Nous procédons de la même manière
et consultons la RPI pour connaître l'objet chargé d'imprimer les barres
de mesure. En cliquant sur @emph{Backend} puis sur @emph{Tous les
encore, le contexte concerné (@code{Voice} en l'occurrence) :
@cindex BarLine, exemple de dérogation
-@cindex stencil, exemple de propriété
+@cindex stencil, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@code{\override} n'a pas fonctionné comme prévu, c'est parce que
@code{Barline} n'appartient pas au contexte par défaut, @code{Voice}.
Si le contexte spécifié est erroné, la commande ne fonctionne pas. Cela
-n'entraîne pas de message d'erreur, et rien n'apparaît sur le fichier log.
+n'entraîne pas de message d'erreur, et rien n'apparaît dans le fichier log.
Essayons de corriger en mentionnant le bon contexte :
@cindex BarLine, exemple de dérogation
-@cindex stencil, exemple de propriété
+@cindex stencil, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
Cette fois, les barres de mesure ont disparu.
-@subheading break-visibility
+@subheading visibilité des barres (break-visibility)
@cindex break-visibility, propriété
contenant un vecteur, et le premier @code{#} est là, comme toujours avec
la commande @code{\override}, pour introduire la valeur elle-même.
-@cindex BarLine, example of overriding
-@cindex break-visibility property, example
+@cindex BarLine, exemple de dérogation
+@cindex break-visibility exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
Comme on peut le constater, cette solution-là aussi supprime les barres
de mesure.
-@subheading transparent
+@subheading transparence
@cindex transparent, propriété
@cindex transparence
essayons de rendre transparente la métrique (@emph{time signature} en
anglais) plutôt que les barres de mesure. Pour cela, il nous faut
trouver le nom du @emph{grob} chargé de l'indication de mesure. De
-retour sur la page @q{Tous les objets de rendu} de la RPI, nous
+retour sur la page @qq{Tous les objets de rendu} de la RPI, nous
cherchons les propriétés de l'objet @code{TimeSignature}. Celui-ci est
géré par le graveur @code{Time_signature_engraver} qui, comme vous
pouvez le constater, appartient au contexte @code{Staff} et peut se
pour rendre la métrique transparente est :
@cindex TimeSignature, exemple de dérogation
-@cindex transparent, exemple de propriété
+@cindex transparent, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@noindent
La métrique a bien disparu mais la commande a laissé un blanc en lieu et
place du chiffrage. Ce peut être souhaitable dans le cadre d'un
-exercice, afin que les élèves aient la place à compléter, mais dans
+exercice, afin que les élèves aient la place pour compléter, mais dans
d'autres circonstances, ce peut être gênant. Pour y remédier,
attribuons plutôt au stencil des métriques la valeur @code{#f} :
@cindex TimeSignature, exemple de dérogation
-@cindex stencil, exemple de propriété
+@cindex stencil, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@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 color
+@subheading couleur
@cindex color, propriété
croisent. Vous verrez dans les exemples ci-dessous que cela peut se
produire, sans qu'on le sache à l'avance. Les explications de ce
phénomène et les solutions pour y remédier sont exposées dans
-@ruser{Painting objects white}. Pour le moment, acceptons cet
+@ruser{Blanchiment des objets}. Pour le moment, acceptons cet
inconvénient et concentrons-nous sur l'apprentissage de la gestion des
couleurs.
liste est une liste de valeurs en unités internes ; pour éviter d'avoir
à chercher ce qu'il faut y mettre, il existe différents moyens
d'indiquer la couleur. Le premier moyen consiste à utiliser l'une des
-couleurs @emph{normales} de la première @ruser{List of colors}. Pour
+couleurs @emph{normales} de la première @ruser{Liste des couleurs}. Pour
mettre les barres de mesure en blanc, on écrit :
@cindex BarLine, exemple de dérogation
-@cindex color, exemple de propriété
+@cindex color, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@noindent
et nous constatons que les barres de mesure sont une fois de plus
invisibles. Attention : aucune apostrophe ne précède @code{white} -- il
-ne s'agit pas d'un symbole mais d'une @emph{fonction}. Quand on
+ne s'agit pas d'un symbole mais d'une @strong{fonction}. Quand on
l'invoque, elle fournit une liste de valeurs internes requises pour
changer la couleur en blanc. Les autres couleurs aussi, dans la
@qq{liste normale}, sont des fonctions. Pour en être certain, vous
@funindex x11-color
Le deuxième moyen de changer la couleur consiste à utiliser la deuxième
-@ruser{List of colors}, dite noms de couleurs X11. Ceux-ci doivent
+@ruser{Liste des couleurs}, dite noms de couleurs X11. Ceux-ci doivent
obligatoirement être précédés d'une autre fonction, qui convertit les
noms de couleurs X11 en une liste de valeurs internes, @code{x11-color},
comme ceci :
@cindex BarLine, exemple de dérogation
-@cindex color, exemple de propriété
+@cindex color, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@funindex rgb-color
-Il existe une troisième fonction, écrite pour convertir les valeurs RGB
+Il existe une troisième fonction, écrite pour convertir les valeurs RVB
en couleurs internes -- la fonction @code{rgb-color}. Elle comporte
trois arguments, donnant respectivement l'intensité du rouge, du vert et
du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1.
Ainsi, pour choisir la couleur rouge, la valeur serait
-@code{(rgb-color1 0 0)} ; pour le blanc, ce serait
+@code{(rgb-color 1 0 0)} ; pour le blanc, ce serait
@code{(rgb-color 1 1 1)} :
@cindex BarLine, exemple de dérogation
-@cindex color, exemple de propriété
+@cindex color, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@cindex NoteHead, exemple de dérogation
@cindex Stem, exemple de dérogation
@cindex BarLine, exemple de dérogation
-@cindex color, exemple de propriété
+@cindex color, exemple d'utilisation de la propriété
@cindex x11-color, exemple d'utilisation
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
graveur se trouve normalement.
-@node Size of objects
-@subsection Size of objects
+@node Taille des objets
+@subsection Taille des objets
+@translationof Size of objects
@cindex modification de la taille des objets
@cindex taille d'objets
@cindex objets, modification de taille
Pour commencer, reprenons l'exemple qui se trouvait dans
-@ref{Nesting music expressions}, qui montrait comment créer une nouvelle
-portée temporaire, du type @rglos{ossia}.
+@ref{Expressions musicales imbriquées}, qui montrait comment créer une
+nouvelle portée temporaire, du type @rglos{ossia}.
-@cindex alignAboveContext, exemple de propriété
+@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
}
@end lilypond
-Normalement, les ossia ne comportent ni clef ni indication de mesure, et
+Normalement, les ossias ne comportent ni clef ni indication de mesure, et
elles sont imprimées légèrement plus petit que la portée principale.
Nous avons déjà appris à enlever la clef et la métrique -- il suffit de
régler le stencil de chacun sur @code{#f}, comme ceci :
-@cindex alignAboveContext, exemple de propriété
+@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
-@cindex stencil, exemple de propriété
+@cindex stencil, exemple d'utilisation de la propriété
@cindex Clef, exemple de dérogation
@cindex TimeSignature, exemple de dérogation
@code{\set} ou @code{\override} insérées dans la musique sont dynamiques
-- elles provoquent des changements synchronisés avec un point
particulier de la musique. Si les changements sont annulés ou
-désactivés par @code{\unset} ou@code{\revert}, les réglages reprennent
-les valeurs par défaut, c'est-à-dire celles qui ont été fixées dans la
+désactivés par @code{\unset} ou @code{\revert}, les réglages reprennent
+leurs valeurs par défaut, c'est-à-dire celles qui ont été fixées dans la
clause @code{\with}, ou, en l'absence de celle-ci, les valeurs par
défaut normales.
Remplaçons donc l'exemple ci-dessus par celui-ci :
-@cindex alignAboveContext, exemple de propriété
+@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
@cindex Clef, exemple de dérogation
-@cindex TimeSignature, exemple dérogation
+@cindex TimeSignature, exemple de dérogation
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
Essayons sur l'exemple d'ossia :
-@cindex alignAboveContext, exemple de propriété
+@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
@cindex Clef, exemple de dérogation
@cindex TimeSignature, exemple de dérogation
-@cindex fontSize, exemple de propriété
+@cindex fontSize, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
Ce n'est pas encore parfait. Les têtes de notes et les crochets sont
plus petits mais, proportionnellement, les hampes sont trop longues et
-les lignes de portée trop espacées. Il faut donc les réduire dans les
+les lignes de la portée trop espacées. Il faut donc les réduire dans les
mêmes proportions que les polices de caractères. La prochaine
sous-section montrera comment faire.
-@node Length and thickness of objects
-@subsection Length and thickness of objects
+@node Longueur et épaisseur des objets
+@subsection Longueur et épaisseur des objets
+@translationof Length and thickness of objects
@cindex distance
@cindex épaisseur
précisément dans ce but. Elle comporte un argument, le changement de
taille de police (#-2 dans l'exemple précédent), à partir duquel elle
applique un facteur de mise à l'échelle qui réduit, ou augmente, les
-objets en proportion. Voici comment elle s'utilise :
+objets en question. Voici comment elle s'utilise :
-@cindex alignAboveContext, exemple de propriété
+@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
@cindex Clef, exemple de dérogation
@cindex TimeSignature, exemple de dérogation
-@cindex fontSize , exemple de propriété
+@cindex fontSize , exemple d'utilisation de la propriété
@cindex StaffSymbol, exemple de dérogation
@cindex magstep, exemple d'utilisation de la fonction
-@cindex staff-space, exemple de propriété
-@cindex stencil, exemple de propriété
+@cindex staff-space, exemple d'utilisation de la propriété
+@cindex stencil, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
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é
@code{thickness}. Nous avons vu plus haut, dans
-@ref{Properties of layout objects}, un exemple de modification de
+@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 Placement of objects
-@section Placement of objects
+@node Positionnement des objets
+@section Positionnement des objets
+@translationof Placement of objects
@menu
-* Automatic behavior::
-* Within-staff objects::
-* Outside staff objects::
+* Comportement automatique::
+* Objets inclus dans la portée::
+* Objets hors de la portée::
@end menu
-@node Automatic behavior
-@subsection Automatic behavior
+@node Comportement automatique
+@subsection Comportement automatique
+@translationof Automatic behavior
-@cindex within-staff objects
-@cindex outside-staff objects
-@cindex objects, within-staff
-@cindex objects, outside-staff
+@cindex objets de la portée
+@cindex objets extérieurs à la portée
+@cindex portée, objets de la
+@cindex portée, objets extérieurs à la
Dans la notation musicale, il y a des objets qui appartiennent à la
portée et d'autres qui sont placés à l'extérieur de la portée. On les
-appelle respectivement les @q{objets de la portée} (@emph{within-staff
-objects} en anglais) et les @q{objets extérieurs à la portée}
-(@emph{outside-staff objects}en anglais).
+appelle respectivement les @qq{objets de la portée} (@emph{within-staff
+objects} en anglais) et les @qq{objets extérieurs à la portée}
+(@emph{outside-staff objects} en anglais).
Les objets de la portée sont ceux qui sont placés sur la portée
-- les têtes de notes et les hampes, les altérations, etc. Leur
d'autres objets placés de cette manière. Normalement, les collisions
entre les têtes et queues de notes et les altérations dans des accords
proches sont évitées automatiquement. Comme nous le verrons rapidement,
-il existe des commandes et des possibilités de retouches qui permettent
+il existe des commandes et des possibilités de retouche qui permettent
de modifier ce comportement automatique.
Parmi les objets extérieurs à la portée, on compte des éléments comme
@end lilypond
-@node Within-staff objects
-@subsection Within-staff objects
+@node Objets inclus dans la portée
+@subsection Objets inclus dans la portée
+@translationof Within-staff objects
Nous avons vu que les commandes @code{\voiceXXX} jouent sur la
direction des liaisons, des doigtés et sur toute autre chose liée à
-l'orientation des queues de notes. Ces commandes sont essentielles dans
+l'orientation des hampes. Ces commandes sont essentielles dans
la musique polyphonique pour distinguer des lignes mélodiques
entremêlées. Mais il arrive qu'on ait besoin de modifier ce comportement
automatique. On peut le faire pour toutes les parties de la musique ou
de nouveau avec le comportement par défaut.
@cindex Stem, exemple de dérogation
-@cindex direction, exemple de propriété
+@cindex direction, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
a4 g c a
correspondent respectivement aux valeurs @code{-1} et @code{+1},
que l'on peut utiliser à la place. La valeur @code{0} peut aussi être
utilisée dans certains cas. Elle est interprétée comme un @code{UP}
-pour les hampes, et comme un @q{centré} pour d'autres objets. Il
+pour les hampes, et comme un @qq{centré} pour d'autres objets. Il
existe une direction, @code{CENTER}, qui correspond à la valeur
@code{0}.
utiliser la commande prédéfinie, suivie, après la note à modifier, de la
commande @code{\xxxNeutral} correspondante.
-@subheading Fingering
+@subheading Doigtés
@cindex doigtés, positionnement
@cindex doigtés, accords
@code{UP} :
@cindex doigtés, exemple de dérogation
-@cindex direction, exemple de propriété
+@cindex direction, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,relative=2]
c-5 a-3 f-1 c'-5
@end lilypond
On peut aller encore plus loin dans le positionnement des doigtés pour
-chacune des notes d'un accord grâce à la commande @code{\set
-fingeringOrientations}. La syntaxe de cette commande est :
+chacune des notes d'un accord grâce à la commande
+@code{\set@tie{}fingeringOrientations}. La syntaxe de cette commande
+est :
@example
@code{\set fingeringOrientations = #'([up] [left/right] [down])}
placée au-dessus (lorsque @code{up} apparaît dans la liste), au-dessous
(lorsque @code{down} apparaît), à gauche (lorsque @code{left} apparaît)
ou à droite (lorsque @code{right} apparaît). En revanche, si une valeur
-n'est pas sur la liste, aucun doigté n'ira à cet emplacement. LilyPond
+n'est pas dans la liste, aucun doigté n'ira à cet emplacement. LilyPond
garde ces contraintes en mémoire et recherche le meilleur emplacement
pour le doigté des notes des accords suivants. Vous remarquerez que
@code{left} et @code{right} s'excluent l'un l'autre -- l'indication de
doigté ne peut être placée que d'un côté ou de l'autre, pas des deux.
-@warning{Ppour contrôler à l'aide de cette commande le placement du
+@warning{Pour contrôler à l'aide de cette commande le placement du
doigté sur une note simple, il faut la saisir comme un accord composé
d'une note unique, en l'encadrant de chevrons.}
@cindex doigtés, exemple
@cindex @code{\set}, exemple d'utilisation
-@cindex fingeringOrientations, exemple de propriété
+@cindex fingeringOrientations, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
\set fingeringOrientations = #'(left)
@end lilypond
-@node Outside staff objects
-@subsection Outside staff objects
+@node Objets hors de la portée
+@subsection Objets hors de la portée
+@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
Voici un exemple qui montre le placement par défaut de certains
d'entre eux.
-@cindex text spanner
-@cindex ottava bracket
+@cindex extension de texte
+@cindex indication d'octaviation
@funindex \startTextSpan
@funindex startTextSpan
@funindex stopTextSpan
@cindex TextSpanner, exemple de dérogation
-@cindex bound-details, exemple de propriété
+@cindex bound-details, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
% Set details for later Text Spanner
passage musical. L'extension s'étend depuis la commande
@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{Text spanners}.
+Pour de plus amples détails, voir @ruser{Extensions de texte}.
Il montre aussi comment créer des marques d'octaviation.
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} oule
-@code{Mark_engraver} du contexte @code{Score} et les placer en haut du
+@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 :
@code{Staff} :
@cindex TextSpanner, exemple de dérogation
-@cindex bound-details, exemple de propriété
+@cindex bound-details, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
% Set details for later Text Spanner
c, c c c
@end lilypond
+@cindex liaisons et outside-staff-priority
+@cindex liaisons et articulations
+@cindex articulations et liaisons
+
+Les liaisons sont intrinsèquement des objets membres de la portée
+(@emph{within-staff objects}) bien qu'elles la surplombent lorsque les
+notes auxquelles elles se rattachent sont relativement hautes. Ceci
+peut avoir pour conséquence de remonter d'autant les objets externes
+(@emph{outside-staff objects}) tels les articulations. La propriété
+@code{avoid-slur} de l'articulation en question peut se voir déterminée
+à @code{'inside} dans le but de @qq{ramener} cette articulation à
+l'intérieur de la liaison. Cette propriété @code{avoid-slur} ne sera
+toutefois effective que dans la mesure où la
+@code{outside-staff-priority} est désactivée (valeur @code{#f}). Dans
+le même esprit, il est possible d'affecter une valeur numérique
+particulière à la propriété @code{outside-staff-priority} d'une
+liaison dans le but de regrouper la liaison avec les objets externes.
+L'exemple suivant illustre ces deux différentes méthodes.
+
+@lilypond[quote,verbatim,relative=2]
+c4( c^\markup\tiny\sharp d4.) c8
+c4(
+\once \override TextScript #'avoid-slur = #'inside
+\once \override TextScript #'outside-staff-priority = ##f
+c^\markup\tiny\sharp d4.) c8
+\once \override Slur #'outside-staff-priority = #500
+c4( c^\markup\tiny\sharp d4.) c8
+@end lilypond
+
Le fait de changer la @code{outside-staff-priority} peut aussi servir à
contrôler le positionnement vertical des objets individuels, quoique le
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
-Comportement automatique, plus haut (voir @ref{Automatic behavior}). 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 :
+@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 :
@cindex TextScript, exemple de dérogation
-@cindex outside-staff-priority, exemple de propriété
+@cindex outside-staff-priority, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
c2^"Text1"
@emph{markup} (ou d'étiquette) n'est pas pris en compte, dans la mesure
où ce qui est concerné n'entre pas dans la musique. La commande
@code{\textLengthOn} inverse ce comportement, faisant en sorte que les
-notes soient espacées autant qu'il faut pour s'adapter au texte :
+notes soient espacées autant qu'il le faut pour s'adapter au texte :
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\textLengthOn % Cause notes to space out to accommodate text
@code{\unset}, et donc ne peut pas être utilisé avec
@code{\textLengthOn}.
-@cindex markup text, allowing collisions
+@cindex étiquette de texte et collision
Les textes des @emph{markup} éviteront également les notes qui
s'échappent au-dessus de la portée. Si ce n'est pas notre souhait, il
est possible de supprimer ce déplacement automatique vers le haut en
attribuant à la priorité la valeur @code{#f}. Voici un exemple qui
montre comment les textes des @emph{markup} interagissent avec ces types
-de notes.
+de note.
@cindex TextScript, exemple de dérogation
-@cindex outside-staff-priority, exemple de propriété
+@cindex outside-staff-priority, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
% This markup is short enough to fit without collision
@end lilypond
-@subheading Dynamics
+@subheading Nuances
@cindex modifier le positionnement des nuances
@cindex nuances, modifier le positionnement
-Les indications de nuances 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
pas d'équivalent pour les indications de nuance. Il nous faut donc
chercher à faire cela avec la commande @code{\override}.
-@subheading Grob sizing
+@subheading Dimensionnement des objets graphiques
@cindex grob, dimensionnement
@cindex dimensionnement des grobs
Tout d'abord, nous devons apprendre ce qui détermine la dimension des
-grobs. Tous les grobs portent en eux un point de référence qui est
-utilisé pour les positionner par rapport à leur objet parent. Ce point du
-grob est placé à une distance horizontale, @code{X-offset},
-et à une distance verticale, @code{Y-offset}, de son parent.
-L'étendue horizontale de l'objet est fixée par une paire de
+@emph{grobs}. Tous les @emph{grobs} portent en eux un point de référence
+qui est utilisé pour les positionner par rapport à leur objet parent. Ce
+point du @emph{grob} est placé à une distance horizontale,
+@code{X-offset}, et à une distance verticale, @code{Y-offset}, de son
+parent. L'étendue horizontale de l'objet est fixée par une paire de
nombres, @code{X-extent}, qui donnent la position du coin
gauche et du coin droit par rapport au point de référence. De
même, l'étendue verticale est fixée par une paire de nombre,
-@code{Y-extent}. Ce sont des propriétés communes à tous les
-grobs et que gère la @code{grob-interface}.
+@code{Y-extent}. Ce sont des propriétés communes à tous les
+@emph{grobs} et que gère la @code{grob-interface}.
@cindex @code{extra-spacing-width}
Par défaut, la largeur des objets extérieurs à la portée est donnée
comme étant nulle, si bien qu'ils peuvent se chevaucher
-horizontalement. Pour arriver à cela, on a ajouté l'infini à
+horizontalement. Pour reméfier à cela, on a ajouté l'infini à
l'extension gauche et moins l'infini à l'extension droite, en
attribuant à @code{extra-spacing-width} la valeur
- @code{'(+inf.0 . -inf.0)}. Pour être sûr que les objets ne se
+@w{@code{'(+inf.0 . -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 @code{'(0 . 0)},
+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 indications de nuances est :
@noindent
Voyons si ça marche sur notre exemple précédent :
-@cindex DynamicText, example of overriding
-@cindex extra-spacing-width property, example
+@cindex DynamicText, exemple de dérogation
+@cindex extra-spacing-width, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
de portée, donc en écartant le bord gauche d'une demi-unité
et le bord droit d'une demi-unité, on obtient :
-@cindex DynamicText, example of overriding
-@cindex extra-spacing-width property, example
+@cindex DynamicText, exemple de dérogation
+@cindex extra-spacing-width, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
@noindent
C'est mieux mais nous voulons peut-être aligner les indications de
-nuances sur une même ligne plutôt que de les voir monter et
+nuance sur une même ligne plutôt que de les voir monter et
descendre avec les notes. La propriété qui gère cela est
@code{staff-padding} ; la section suivante lui est consacrée.
-@node Collisions of objects
-@section Collisions of objects
-
+@node Collisions d'objets
+@section Collisions d'objets
+@translationof Collisions of objects
@menu
-* Moving objects::
-* Fixing overlapping notation::
-* Real music example::
+* Déplacement d'objets::
+* Correction des collisions d'objets::
+* Exemple concret::
@end menu
-@node Moving objects
-@subsection Moving objects
+@node Déplacement d'objets
+@subsection Déplacement d'objets
+@translationof Moving objects
+
+@cindex déplacement d'objets se chevauchant
+@cindex déplacement d'objets en collision
+@cindex déplacement de grobs en collision
+@cindex objets, évitement des collisions
+@cindex grobs, évitement des collisions
Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
Certains éléments sur la partition peuvent se chevaucher, ce qui est
d'esthétique -- ils rendraient mieux avec un peu plus ou un peu moins
d'espace autour d'eux.
-Il y a trois façons de résoudre les problèmes de chevauchement. Il est
+Il y a trois façons de résoudre les problèmes de chevauchement. Il est
préférable de les aborder dans l'ordre suivant :
@enumerate
@item
L'@strong{orientation} d'un objet qui en chevauche un autre peut être
changée grâce aux commandes prédéfinies dont la liste a été donnée
-plus haut à propos des objets de portée (voir @ref{Within-staff objects}).
-Les queues de notes, les liaisons de phrasé et de prolongation, les
+plus haut à propos des objets de portée (voir
+@ref{Objets inclus dans la portée}).
+Les queues de note, les liaisons de phrasé et de prolongation, les
crochets, les nuances et les nolets peuvent facilement être repositionnés
de cette manière. En contrepartie, vous n'avez le choix qu'entre deux
positions, sans personnalisation possible.
@item
Les @strong{propriétés d'objet}, auxquelles LilyPond a recours pour
-positionner les objets, sont modifiables avec @code{\override}. Il y a deux
+positionner les objets, sont modifiables avec @code{\override}. Il y a deux
avantages à changer ces propriétés : (a) d'autres objets pourront être
déplacés automatiquement si nécessaire pour faire de la place, et (b)
la même retouche peut s'appliquer à toutes les occurrences du même
-type d'objet. Ces propriétés sont :
+type d'objet. Ces propriétés sont :
@itemize
@item
@code{direction}
-Ce point a déjà été traité en détails -- voir @ref{Within-staff objects}.
+Ce point a déjà été traité en détails -- voir
+@ref{Objets inclus dans la portée}.
@item
@code{padding}, @code{left-padding},
@code{right-padding}, @code{staff-padding}
-@cindex padding
-@cindex left-padding property
-@cindex padding property
-@cindex right-padding property
-@cindex staff-padding property
+@cindex décalage (padding)
+@cindex left-padding, propriété
+@cindex padding, propriété
+@cindex right-padding, propriété
+@cindex staff-padding, propriété
Au moment de positionner un objet, la valeur de sa propriété
@code{padding} détermine l'espace à laisser libre entre celui-ci et le
processus de composition, les têtes de notes sont composées en premier,
puis les altérations, s'il y en a, sont ajoutées à gauche des têtes de notes
suivant la propriété @code{right-padding} qui détermine l'espacement par
-rapport aux têtes de notes. C'est pourquoi seule la propriété
+rapport aux têtes de note. C'est pourquoi seule la propriété
@code{right-padding} de l'objet @code{AccidentalPlacement} joue sur le
positionnement des altérations.
rapport à une note ; il est toutefois possible de le régler pour
fonctionner avec ces derniers.
-Pour trouver quelle propriété @q{padding} employer pour l'objet que vous
+Pour trouver quelle propriété @code{padding} employer pour l'objet que vous
cherchez à repositionner, il vous faut consulter les propriétés de l'objet dans
-la RPI. Prenez garde que les propriétés @q{padding} ne sont pas forcément
+la RPI. Prenez garde que les propriétés @code{padding} ne sont pas forcément
traitées dans l'objet en question ; il faut alors regarder les objets
qui semblent s'en rapprocher.
-Toutes les valeurs @q{padding} sont exprimées en espaces de portée.
-Pour la plupart des objets, la valeur par défaut est aux alentours de 1.0,
-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 petit).
+Toutes les valeurs @code{padding} sont exprimées en espaces 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 petit).
@item
@code{self-alignment-X}
-@cindex self-alignment-X property
+@cindex self-alignment-X, propriété
+
Cette propriété sert à aligner les objets sur la gauche, sur la droite ou
à les centrer par rapport au point de référence des objets parents.
Elle peut être utilisée avec tous les objets qui acceptent la
@item
@code{extra-spacing-width}
-@cindex extra-spacing-width property
+@cindex extra-spacing-width, propriété
+
Cette propriété est utilisée pour tous les objets qui acceptent la
@code{item-interface}. Elle reçoit deux nombres, le premier étant
-ajouté au bord gauche et le second au bord droit. Des nombres
+ajouté au bord gauche et le second au bord droit. Des nombres
négatifs déplacent le coin vers la gauche, des nombres positifs
vers la droite, si bien que pour élargir un objet, le premier nombre
-doit être négatif et le second positif. Attention : tous les objets
-n'acceptent pas forcément les deux nombres. Par exemple, l'objet
+doit être négatif et le second positif. Attention : tous les objets
+n'acceptent pas forcément les deux nombres. Par exemple, l'objet
@code{Accidental} ne retient que le premier nombre (coin gauche).
@item
@code{staff-position}
-@cindex staff-position property
+@cindex staff-position, propriété
+
@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
@item
@code{force-hshift}
-@cindex force-hshift property
+@cindex force-hshift, propriété
+
Des notes très proches dans un accord, ou des notes simultanées dans
différentes voix, peuvent être disposées sur deux colonnes, rarement
plus, pour éviter que les têtes de notes ne se chevauchent. On parle
-alors de colonnes de notes et un objet appelé @code{NoteColumn}
-est créé pour placer les notes sur la colonne.
+alors de colonnes (ou empilement) de notes et un objet appelé
+@code{NoteColumn} est créé pour placer les notes sur la colonne.
La propriété @code{force-hshift} appartient à @code{NoteColumn} (en
réalité à la @code{note-column-interface}). Le fait de la modifier permet
-de déplacer une colonne de notes selon l'unité appropriée aux colonnes
-de notes, à savoir la largeur des têtes de notes de la première voix. Son
-utilisation est réservée à des situations complexes dans lesquelles les
-commandes habituelles @code{\shiftOn}
-(voir @ref{Explicitly instantiating voices}) 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 les notes à
-l'intérieur ou à l'extérieur d'une @code{NoteColumn} affecte d'autres
-actions comme les fusionnements de notes.
+de déplacer un empilement selon l'unité appropriée aux colonnes
+de notes, à savoir la largeur des têtes de note de la première voix.
+Son utilisation est réservée à des situations complexes dans lesquelles
+les commandes habituelles @code{\shiftOn}
+(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
+les notes à l'intérieur ou à l'extérieur d'une @code{NoteColumn} affecte
+d'autres actions comme les fusionnements de notes.
@end itemize
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
+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
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 collisions
-qui pourraient survenir. Et le pire avec cette méthode est que, le jour
-où la musique est modifiée, il faut de nouveau rechercher les
-valeurs de repositionnement. Les propriétés à utiliser pour ce type de
-repositionnement manuel sont :
+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
+que, le jour où la musique est modifiée, il faut de nouveau rechercher
+les valeurs de repositionnement. Les propriétés à utiliser pour ce type
+de repositionnement manuel sont :
@table @code
@item extra-offset
-@cindex extra-offset property
-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 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 qu'un objet peut être repositionné à n'importe
-quel endroit sans que ça perturbe quoi que ce soit.
+@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
+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
+qu'un objet peut être repositionné à n'importe quel endroit sans
+perturber quoi que ce soit.
@item positions
-@cindex positions property
+@cindex positions, propriété
+
Cette propriété est très utile pour ajuster manuellement l'inclinaison et
-la hauteur des barres de croches, des liaisons et des nolets. Elle est
+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. 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 liaison qui @qq{semble
-la meilleure}. Si la propriété @code{positions} a été retouchée, la
-liaison la plus proche de la position demandée sera retenue dans la
-liste.
+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.
+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
+liaison qui @qq{semble la meilleure}. Si la propriété @code{positions}
+a été retouchée, la liaison la plus proche de la position demandée sera
+retenue dans la liste.
@end table
@end enumerate
-Il est possible qu'un objet ne dispose pas de toutes ces propriétés. Il
+Il est possible qu'un objet ne dispose pas de toutes ces propriétés. Il
est donc nécessaire de consulter la RPI pour vérifier quelles sont les
propriétés disponibles pour l'objet en question.
Voici une liste d'objets les plus couramment impliqués dans les
-collisions, avec le nom de l'objet à consulter dans la RPI afin de trouver
-les propriétés à retoucher pour obtenir un déplacement.
+collisions, avec le nom de l'objet à consulter dans la RPI afin de
+trouver les propriétés à retoucher pour obtenir un déplacement.
@multitable @columnfractions .5 .5
@headitem Type d'objet @tab Nom d'objet
@item Articulations @tab @code{Script}
-@item Barres de croches @tab @code{Beam}
+@item Barres de ligature @tab @code{Beam}
@item Doigté @tab @code{Fingering}
@item Liaisons de phrasé @tab @code{Slur}
@item Liaisons de prolongation @tab @code{Tie}
@end multitable
-@node Fixing overlapping notation
-@subsection Fixing overlapping notation
+@node Correction des collisions d'objets
+@subsection Correction des collisions d'objets
+@translationof Fixing overlapping notation
Voyons maintenant comment les propriétés décrites dans la section
précédente peuvent nous aider à résoudre les collisions.
-@subheading padding property
+@subheading la propriété padding
-@cindex padding
-@cindex fixing overlapping notation
-@cindex overlapping notation
+@cindex décalage (padding)
+@cindex résolution des chevauchements de notation
+@cindex chevauchement de notation
En jouant sur la propriété @code{padding} (littéralement
-@q{rembourrage}), on augmente (ou on diminue) la distance entre
+@qq{rembourrage}), on augmente (ou on diminue) la distance entre
des symboles qui sont imprimés au-dessus ou en dessous des notes.
-@cindex Script, example of overriding
-@cindex padding property, example
+@cindex Script, exemple de dérogation
+@cindex padding, exemple d'utilisation de la propriété
@lilypond[quote,fragment,relative=1,verbatim]
c2\fermata
b2\fermata
@end lilypond
-@cindex MetronomeMark, example of overriding
-@cindex padding property, example
+@cindex MetronomeMark, exemple de dérogation
+@cindex padding, exemple d'utilisation de la propriété
@lilypond[quote,fragment,relative=1,verbatim]
% This will not work, see below:
@end lilypond
Vous remarquerez dans le second exemple à quel point il est important de
-préciser le nom du contexte qui contient l'objet. Puisque l'objet
+préciser le nom du contexte qui contient l'objet. Puisque l'objet
@code{MetronomeMark} appartient au contexte @code{Score}, le fait de
modifier la propriété dans le contexte @code{Voice} passera inaperçu.
-Pour plus de détails, voir @ruser{Modifying properties}.
+Pour plus de détails, voir @ruser{Modification de propriétés}.
Si on augmente la propriété @code{padding} d'un objet alors que celui-ci
fait partie d'un ensemble d'objets positionnés en fonction de leur
-@code{outside-staff-priority}, cet objet sera déplacé, ainsi que tous les
-autres objets du groupe.
+@code{outside-staff-priority}, cet objet sera déplacé, ainsi que tous
+les autres objets du groupe.
-@subheading left-padding and right-padding
+@subheading left-padding et right-padding
-@cindex left-padding property
-@cindex right-padding property
+@cindex left-padding, propriété
+@cindex right-padding, propriété
La propriété @code{right-padding} joue sur l'espacement entre une
-altération et la note sur laquelle elle porte. On ne l'utilise pas souvent,
-mais l'exemple ci-dessous montre une situation où elle est nécessaire.
-Imaginons que nous voulions faire apparaître un accord qui contienne
-à la fois un si bécarre et un si bémol. Pour qu'il n'y ait pas de doute,
-nous chercherions à précéder la note d'un signe bécarre et d'un signe
-bémol. Voici différentes tentatives pour y parvenir :
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-<b bes>
-<b! bes>
-<b? bes>
-@end lilypond
-
-Pas une ne convient, et la seconde se solde même par une collision
-entre les deux signes.
-
-Une solution pour arriver à nos fins consiste à retoucher le stencil des
-altérations grâce à un markup qui contient les symboles bécarre et
-bémol, dans l'ordre que nous souhaitons, comme ceci :
+altération et la note sur laquelle elle porte. On ne l'utilise pas
+souvent, mais l'espacement par défaut peut se révéler inadéquat avec
+certaines altérations ou certains glyphes utilisés en musique
+microtonale. Le stencil de l'altération devra alors être construit sous
+la forme d'un @code{markup} qui contiendra le ou les symboles requis,
+comme ceci :
-@cindex Accidental, example of overriding
-@cindex text property, example
-@cindex stencil property, example
-@cindex AccidentalPlacement, example of overriding
-@cindex right-padding property, example
+@cindex Accidental, exemple de dérogation
+@cindex text, exemple d'utilisation de la propriété
+@cindex stencil, exemple d'utilisation de la propriété
+@cindex AccidentalPlacement, exemple de dérogation
+@cindex right-padding, exemple d'utilisation de la propriété
@lilypond[quote,ragged-right,verbatim]
-naturalplusflat = \markup { \natural \flat }
+sesquisharp = \markup { \sesquisharp }
\relative c'' {
+ c
+ % This prints a sesquisharp but the spacing is too small
\once \override Accidental
#'stencil = #ly:text-interface::print
- \once \override Accidental #'text = #naturalplusflat
- \once \override Score.AccidentalPlacement #'right-padding = #1.5
- <b bes>
+ \once \override Accidental #'text = #sesquisharp
+ cis c
+ % This improves the spacing
+ \once \override Score.AccidentalPlacement #'right-padding = #0.6
+ \once \override Accidental
+ #'stencil = #ly:text-interface::print
+ \once \override Accidental #'text = #sesquisharp
+ cis
}
@end lilypond
@noindent
Cette méthode utilise, pour le stencil des altérations, une retouche
-qui ne sera par reprise par la suite. Le type de stencil est obligatoirement
-une procédure, qui consiste ici à imprimer le contenu de la propriété
-@code{text} de @code{Accidental}, déclaré comme étant un signe
-bécarre suivi d'un signe bémol. Celui-ci est ensuite repoussé devant la
-tête de note par la retouche de @code{right-padding}.
+qui ne sera pas reprise par la suite. Le type de stencil est
+obligatoirement une procédure, qui consiste ici à imprimer le contenu de
+la propriété @code{text} de @code{Accidental}, déclaré comme étant un
+signe sesqui-dièse. Celui-ci est ensuite repoussé devant la tête de
+note par la retouche de @code{right-padding}.
@noindent
-@subheading staff-padding property
+@subheading la propriété staff-padding
-@cindex aligning objects on a baseline
-@cindex objects, aligning on a baseline
+@cindex alignement d'objets sur une ligne de base
+@cindex objets, alignement sur une ligne de base
@code{staff-padding} sert à aligner des objets tels que des nuances
-sur une ligne fictive à une hauteur donnée par rapport à la portée, plutôt
-qu'à une hauteur qui varie en fonction de la position de la note sur laquelle
-porte l'objet. Ce n'est pas une propriété de @code{DynamicText} mais de
-@code{DynamicLineSpanner}. Car la ligne fictive est destinée à s'appliquer
-autant à @strong{toutes} les nuances, notamment celles qui sont créées
-comme des bandeaux en longueur (en anglais @q{Spanners}). Tel est donc
-le moyen d'aligner les indications de nuances, comme dans cet exemple
-repris de la section précédente :
-
-@cindex DynamicText, example of overriding
-@cindex extra-spacing-width property, example
-@cindex DynamicLineSpanner, example of overriding
-@cindex staff-padding property, example
+sur une ligne fictive à une hauteur donnée par rapport à la portée,
+plutôt qu'à une hauteur qui varie en fonction de la position de la note
+sur laquelle porte l'objet. Ce n'est pas une propriété de
+@code{DynamicText} mais de @code{DynamicLineSpanner}, car la ligne
+fictive est destinée à s'appliquer autant à @strong{toutes} les nuances,
+notamment celles qui sont créées comme des bandeaux en longueur (en
+anglais @emph{Spanners}). Tel est donc le moyen d'aligner les
+indications de nuance, comme dans cet exemple repris de la section
+précédente :
+
+@cindex DynamicText, exemple de dérogation
+@cindex extra-spacing-width, exemple d'utilisation de la propriété
+@cindex DynamicLineSpanner, exemple de dérogation
+@cindex staff-padding, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
@end lilypond
-@subheading self-alignment-X property
-L'exemple suivant montre comment résoudre une collision entre une indication
-de corde et une queue de note, en alignant le coin droit sur le point de
-référence de la note parente :
+@subheading la propriété self-alignment-X
+
+L'exemple suivant montre comment résoudre une collision entre une
+indication de corde et une hampe, en alignant le coin droit sur le point
+de référence de la note parente :
-@cindex StringNumber, example of overriding
-@cindex self-alignment-X property, example
+@cindex StringNumber, exemple de dérogation
+@cindex self-alignment-X, exemple d'utilisation de la propriété
@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
\voiceOne
< a \2 >
@end lilypond
-@subheading staff-position property
+@subheading la propriété staff-position
-@cindex object collision within a staff
-Dans une voix, un silence valant une mesure entière peut chevaucher les
-notes d'une autre voix. Vu que ces silences sont centrés entre les deux
-barres de mesure, il serait très compliqué de programmer LilyPond pour repérer
-ces risques de collisions, dans la mesure où, normalement, toutes les collisions
-entre notes ou entre notes et silences se produisent sur des notes et silences
-simultanés. Voici un exemple de collision de ce type :
+@cindex collision d'objets à l'intérieur d'une portée
+
+Dans une voix, un silence valant une mesure entière peut chevaucher les
+notes d'une autre voix. Vu que ces silences sont centrés entre les deux
+barres de mesure, il serait très compliqué de programmer LilyPond pour
+repérer ces risques de collision, dans la mesure où, normalement, toutes
+les collisions entre notes ou entre notes et silences se produisent sur
+des notes et silences simultanés. Voici un exemple de collision de ce
+type :
@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
<< {c c c c} \\ {R1} >>
@end lilypond
Ici, la meilleure solution consiste à déplacer le symbole de pause vers
-le bas -- puisque cette pause appartient à la voix deux. Par défaut, dans la
-@code{\voiceTwo} (c'est-à-dire dans la seconde voix d'une construction
-@code{<<@{...@} \\ @{...@}>>}), la propriété @code{staff-position} est
-réglée sur -4 pour les MultiMeasureRest ; nous avons donc besoin de la
-déplacer, disons, de quatre demi-intervalles vers le bas, ce qui donne
-@code{-8}.
+le bas -- puisque cette pause appartient à la voix deux. Par défaut,
+dans la @code{\voiceTwo} (c'est-à-dire dans la seconde voix d'une
+construction @w{@code{<<@{...@} \\ @{...@}>>}}), la propriété
+@code{staff-position} est réglée sur @code{-4} pour les
+@code{MultiMeasureRest} ; nous avons donc besoin de la déplacer, disons,
+de quatre demi-intervalles vers le bas, ce qui donne @code{-8}.
-@cindex MultiMeasureRest, example of overriding
-@cindex staff-position property, example
+@cindex MultiMeasureRest, exemple de dérogation
+@cindex staff-position, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
<<
car la ligne supplémentaire au-dessus du silence est insérée
automatiquement.
-@subheading extra-offset property
+@subheading la propriété extra-offset
-@cindex positioning objects
-@cindex positioning grobs
-@cindex objects, positioning
-@cindex grobs, positioning
+@cindex positionnement des objets
+@cindex positionnement des grobs
+@cindex objets, positionnement
+@cindex grobs, positionnement
-La propriété @code{extra-offset}
La propriété @code{extra-offset} offre la possibilité de contrôler
entièrement le placement d'un objet, aussi bien horizontalement que
verticalement.
Dans l'exemple suivant, la seconde indication de doigté est déplacée
-légèrement vers la gauche et de 1.8 intervalle de lignes vers le bas :
+légèrement vers la gauche et de 1,8 intervalle de lignes vers le bas :
-@cindex Fingering, example of overriding
-@cindex extra-offset property, example
+@cindex Fingering, exemple de dérogation
+@cindex extra-offset, exemple d'utilisation de la propriété
@lilypond[quote,fragment,relative=1,verbatim]
\stemUp
@end lilypond
-@subheading positions property
+@subheading la propriété positions
-@cindex controlling tuplets, slurs, phrasing slurs, and beams manually
-@cindex manually controlling tuplets, slurs, phrasing slurs, and beams
-@cindex tuplet beams, controlling manually
-@cindex slurs, controlling manually
-@cindex phrasing slurs, controlling manually
-@cindex beams, controlling manually
+@cindex contrôle des nolets, liaisons, phrasés et ligatures
+@cindex gestion manuelle des nolets, liaisons, phrasés et ligatures
+@cindex ligatures de nolet, gestion manuelle
+@cindex liaisons, gestion manuelle
+@cindex phrasés, gestion manuelle
+@cindex ligatures, gestion manuelle
La propriété @code{positions} permet de contrôler manuellement la
-position et l'inclinaison des nolets, coulés, liaisons de phrasé et barres
-de croches. Voici un exemple avec une horrible liaison de phrasé --
-horrible pour avoir tenté de contourner la liaison de l'acciaccature.
+position et l'inclinaison des nolets, coulés, liaisons de phrasé et
+barres de ligature. Voici un exemple avec une horrible liaison de
+phrasé -- horrible pour avoir tenté de contourner la liaison de
+l'acciaccature.
@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
r4 \acciaccatura e8\( d8 c ~c d c d\)
Mais si, pour une quelconque raison, cette solution n'était pas
envisageable, l'autre solution consiste à déplacer légèrement vers le
bas l'extrémité gauche de la liaison de phrasé, grâce à la propriété
-@code{positions}. Cela corrige en même temps la forme plutôt
+@code{positions}. Cela corrige en même temps la forme plutôt
disgracieuse de la liaison.
-@cindex PhrasingSlur, example of overriding
-@cindex positions property, example
+@cindex PhrasingSlur, exemple de dérogation
+@cindex positions, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
r4
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 croches chevauchent les notes les plus hautes :
+constater, les barres de ligature chevauchent les notes les plus hautes :
@lilypond[quote,verbatim,fragment,ragged-right]
{
@noindent
On peut y remédier en déplaçant manuellement vers le haut les deux
-extrémités des barres de croches, non plus à 2 intervalles au-dessus
+extrémités des ligatures de croches, non plus à 2 intervalles au-dessus
de la ligne médiane mais, disons, à 3 :
-@cindex Beam, example of overriding
-@cindex positions property, example
+@cindex Beam, exemple de dérogation
+@cindex positions, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,fragment,ragged-right]
{
second bloc de croches de la première voix mais qu'il ne s'applique
à aucune barre de la deuxième voix.
-@subheading force-hshift property
+@subheading la propriété force-hshift
@c FIXME: formatting stuff (ie not important right now IMO)
@c @a nchor Chopin finally corrected TODOgp
Maintenant, nous sommes prêts à appliquer les dernières corrections à
-l'exemple de Chopin présenté à la fin de @ref{I'm hearing Voices}, que
+l'exemple de Chopin présenté à la fin de @ref{J'entends des Voix}, que
nous avions laissé dans cet état :
@lilypond[quote,verbatim,fragment,ragged-right]
@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 la colonne des deux
-plus hautes notes. Pour y remédier, nous réglons le @code{force-hshift}
+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.
+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.
Et voici le résultat final :
-@cindex NoteColumn, example of overriding
-@cindex force-hshift property, example
+@cindex NoteColumn, exemple de dérogation
+@cindex force-hshift, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,fragment,ragged-right]
\new Staff \relative c'' {
@end lilypond
-@node Real music example
-@subsection Real music example
+@node Exemple concret
+@subsection Exemple concret
+@translationof Real music example
Pour terminer ce chapitre consacré aux retouches, voici, étape par
étape, la mise en forme d'un exemple concret nécessitant un certain
-nombre de retouches jusqu'à l'obtention du résultat attendu. Cet exemple
-a été choisi en raison des problèmes inhabituels de notation qu'il soulevait
-et pour vous apprendre à les résoudre grâce au Manuel de notation. Il
-n'est pas représentatif d'une opération normale de gravure ; que ces
-difficultés ne vous découragent donc pas ! Des difficultés comme celles-ci
-ne sont, heureusement, pas courantes !
+nombre de retouches jusqu'à l'obtention du résultat attendu. Cet
+exemple a été choisi en raison des problèmes inhabituels de notation
+qu'il soulevait et pour vous apprendre à les résoudre grâce au Manuel de
+notation. Il n'est pas représentatif d'une opération normale de gravure ;
+que ces difficultés ne vous découragent donc pas ! Des difficultés comme
+celles-ci ne sont, heureusement, pas courantes !
Cet exemple est tiré de la Première Ballade de Chopin, Op. 23, mesures
6 à 9 ; cela correspond à la transition entre le Lento d'ouverture et le
-Moderato. Voici, pour commencer, ce à quoi nous voulons que la
+Moderato. Voici, pour commencer, ce à quoi nous voulons que la
partition ressemble ; pour limiter les complications, nous n'avons pas
-fait apparaître les indications de nuances, de doigté ni de pédale.
+fait apparaître les indications de nuance, de doigté ni de pédale.
@c The following should appear as music without code
droite compte quatre voix. Ce sont les cinq croches avec une barre,
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
+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{I'm hearing Voices}. Commençons par saisir les notes comme
+@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 score et voyons ce que LilyPond propose par
défaut :
@end lilypond
Toutes les notes sont correctes mais l'allure générale est loin d'être
-satisfaisante. La liaison se heurte à l'indication de mesure lors du
-changement de chiffrage, la barre des croches n'est pas bonne dans la
+satisfaisante. La liaison se heurte à l'indication de mesure lors du
+changement de métrique, la ligature des croches n'est pas bonne dans la
troisième mesure, les notes ne sont pas fusionnées et il manque plusieurs
-éléments de notation. Commençons par le plus simple. Nous pouvons
-corriger la barre des croches en la créant manuellement et nous pouvons
+éléments de notation. Commençons par le plus simple. Nous pouvons
+corriger la ligature des croches en la créant manuellement et nous pouvons
facilement ajouter les limites droite et gauche de la liaison de phrasé,
-puisque tout cela a déjà été traité dans le tutoriel. Voici le résultat :
+puisque tout cela a déjà été traité dans le tutoriel. Voici le résultat :
@lilypond[quote,verbatim,ragged-right]
rhMusic = \relative c'' {
}
@end lilypond
-La première mesure est maintenant correcte. La seconde contient un arpège
-et doit se terminer par une double barre. Comment faire, puisque cela n'a pas
-été traité dans le Manuel d'initiation ? C'est alors qu'il faut nous
-reporter au Manuel de notation. Quand on cherche @q{arpège} et @q{barre
-de mesure} dans l'index, on voit aisément qu'il faut ajouter
+La première mesure est maintenant correcte. La seconde contient un
+arpège et doit se terminer par une double barre. Comment faire, puisque
+cela n'a pas été traité dans le Manuel d'initiation ? C'est alors qu'il
+faut nous reporter au Manuel de notation. Quand on cherche @qq{arpège}
+et @qq{barre de mesure} dans l'index, on voit aisément qu'il faut ajouter
@code{\arpeggio} à un accord pour produire un arpège et qu'une double
barre est le résultat de la commande @code{\bar "||"}. Rien de plus
-facile ! Nous devons ensuite corriger la collision entre la liaison et
-l'indication de mesure. Le mieux est de déplacer la liaison vers le
-haut. La méthode pour déplacer les objets a déjà été présentée dans
-@ref{Moving objects}, et l'on sait que, pour des objets positionnés par
-rapport à la portée, il nous faut modifier leur propriété
-@code{staff-position}, exprimée en demi-intervalles de lignes par
-rapport à la ligne médiane de la portée. Voici donc la retouche à
+facile ! Nous devons ensuite corriger la collision entre la liaison et
+l'indication de mesure. Le mieux est de déplacer la liaison vers le
+haut. La méthode pour déplacer les objets a déjà été présentée dans
+@ref{Déplacement d'objets}, et l'on sait que, pour des objets
+positionnés par rapport à la portée, il nous faut modifier leur
+propriété @code{staff-position}, exprimée en demi-intervalles de lignes
+par rapport à la ligne médiane de la portée. Voici donc la retouche à
insérer juste devant la première note liée ; elle est censée déplacer la
liaison vers le haut de 3,5 demi-intervalles de lignes au-dessus de la
ligne médiane :
}
@end lilypond
-Venons-en à la troisième mesure et au début de la section Moderato. Dans
-le Tutoriel, il est indiqué comment insérer du texte en gras à l'aide de la
-commande @code{\markup} ; pas de problème, du coup, pour ajouter
-@q{Moderato} en gras. Mais comment faire pour fusionner les notes de
-différentes voix ? C'est là que le Manuel de notation peut nous venir en
-aide. Une recherche sur @q{fusionnement de notes} dans l'index nous renvoie,
-dans @ruser{Collision resolution}, aux commandes pour fusionner les notes,
-différentes en fonction du type de note et selon que celles-ci sont
-pointées ou non. Dans notre exemple, pour la durée de la polyphonie de
-la troisième mesure, nous avons besoin de fusionner deux types de notes
-; grâce aux informations trouvées dans le Manuel de notation, nous
-ajoutons
+Venons-en à la troisième mesure et au début de la section Moderato. Dans
+le Tutoriel, il est indiqué comment insérer du texte en gras à l'aide de
+la commande @code{\markup} ; pas de problème, du coup, pour ajouter
+@qq{Moderato} en gras. Mais comment faire pour fusionner les notes de
+différentes voix ? C'est là que le Manuel de notation peut nous venir
+en aide. Une recherche sur @qq{fusionnement de notes} dans l'index nous
+renvoie au chapitre @ruser{Résolution des collisions}, et plus
+précisément aux commandes permettant de fusionner des notes en fonction
+de leur type et selon qu'elles sont pointées ou non. Dans notre
+exemple, pour la durée de la polyphonie de la troisième mesure, nous
+avons besoin de fusionner deux types de notes ; grâce aux informations
+trouvées dans le Manuel de notation, nous ajoutons
@example
\mergeDifferentlyHeadedOn
@end lilypond
Ces retouches ont permis de fusionner les deux fa dièse mais pas les
-deux ré. Pourquoi ? La réponse se trouve dans la même section du
-Manuel de notation : les notes à fusionner doivent avoir des queues dans
-des directions opposées et deux notes ne peuvent pas être fusionnées s'il
-y a une troisième note dans la même colonne. Ici, les deux ré ont leur
-queue orientée vers le haut et il y a une troisième note, do. Nous
-savons changer l'orientation de la queue avec @code{\stemDown} et
+deux ré. Pourquoi ? La réponse se trouve dans la même section du
+Manuel de notation : les notes à fusionner doivent avoir des hampes dans
+des directions opposées et deux notes ne peuvent pas être fusionnées
+s'il y a une troisième note dans la même colonne. Ici, les deux ré ont
+leur hampe orientée vers le haut et il y a une troisième note, do. Nous
+savons changer l'orientation de la hampe avec @code{\stemDown} et
le Manuel de notation nous indique également comment déplacer le do
-- en produisant un décalage grâce à l'une des commandes @code{\shift}.
-Mais laquelle ? Le do appartient à la deuxième voix et n'est pas décalé ;
+Mais laquelle ? Le do appartient à la deuxième voix et n'est pas décalé ;
les deux ré appartiennent respectivement à la première et à la troisième
-voix, et l'un n'est pas décalé tandis que l'autre l'est. Il nous faut donc
-décaler largement le do avec la commande @code{\shiftOnn} pour
-éviter une interférence avec les deux ré. Voici ce que donnent ces
+voix, et l'un n'est pas décalé tandis que l'autre l'est. Il nous faut
+donc décaler largement le do avec la commande @code{\shiftOnn} pour
+éviter une interférence avec les deux ré. Voici ce que donnent ces
modifications :
-@cindex Tie, example of overriding
-@cindex staff-position property, example
+@cindex Tie, exemple de dérogation
+@cindex staff-position, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,ragged-right]
rhMusic = \relative c'' {
}
@end lilypond
-Pas loin. Il ne reste plus que deux problèmes : les ré une fois fusionnés
-ne devraient plus avoir de queue vers le bas, et le do serait mieux à la
-droite des ré. Nous savons remédier à ces deux problèmes grâce aux
-retouches précédentes : nous allons rendre la queue transparente et
-déplacer le do avec la propriété @code{force-hshift}. Et voici le
-résultat final :
+Pas loin. Il ne reste plus que deux problèmes : les ré une fois
+fusionnés ne devraient plus avoir de hampe vers le bas, et le do serait
+mieux à la droite des ré. Nous savons remédier à ces deux problèmes
+grâce aux retouches précédentes : nous allons rendre la hampe
+transparente et déplacer le do avec la propriété @code{force-hshift}.
+Et voici le résultat final :
-@cindex NoteColumn, example of overriding
-@cindex force-hshift property, example
-@cindex Stem, example of overriding
-@cindex transparent property, example
+@cindex NoteColumn, exemple de dérogation
+@cindex force-hshift, exemple d'utilisation de la propriété
+@cindex Stem, exemple de dérogation
+@cindex transparent, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,ragged-right]
rhMusic = \relative c'' {
@end lilypond
-@node Further tweaking
-@section Further tweaking
+@node Autres retouches
+@section Autres retouches
+@translationof Further tweaking
@menu
-* Other uses for tweaks::
-* Using variables for tweaks::
-* Other sources of information::
-* Avoiding tweaks with slower processing::
-* Advanced tweaks with Scheme::
+* Autres utilisations des retouches::
+* Utilisation de variables dans les retouches::
+* Feuilles de style::
+* Autres sources de documentation::
+* Options ralentissant le traitement::
+* Retouches avancées avec Scheme::
@end menu
-@node Other uses for tweaks
-@subsection Other uses for tweaks
+@node Autres utilisations des retouches
+@subsection Autres utilisations des retouches
+@translationof Other uses for tweaks
-@cindex transparent property, use of
-@cindex objects, making invisible
-@cindex removing objects
-@cindex objects, removing
-@cindex hiding objects
-@cindex objects, hiding
-@cindex invisible objects
-@cindex objects, invisible
-@cindex tying notes across voices
+@cindex transparent, utilisation de la propriété
+@cindex création d'objet invisible
+@cindex suppression d'objets
+@cindex objets, suppression d'
+@cindex masquage d'objets
+@cindex objets, masquage d'
+@cindex invisibles, objets
+@cindex objets, invisibles
+@cindex liaison de tenue avec changement de voix
-@subheading Tying notes across voices
+@subheading Liaison entre plusieurs voix
Voici un exemple qui montre comment créer une liaison de
-prolongation entre des notes appartenant à des voix différentes. En
+prolongation entre des notes appartenant à des voix différentes. En
temps normal, seules deux notes appartenant à une même voix
-peuvent être ainsi liées. La solution consiste à utiliser deux voix,
+peuvent être ainsi liées. La solution consiste à utiliser deux voix,
dont l'une avec les notes liées
@lilypond[quote,fragment,relative=2]
@end lilypond
@noindent
-et à rendre transparente la première queue de note de cette voix ;
+et à rendre transparente la première hampe de cette voix ;
on a alors l'impression que la liaison couvre les deux voix.
-@cindex Stem, example of overriding
-@cindex transparent propery, example
+@cindex Stem, exemple de dérogation
+@cindex transparent, exemple d'utilisation de la propriété
@lilypond[quote,fragment,relative=2,verbatim]
<<
>>
@end lilypond
-Pour être sûr que la queue que nous avons rendue transparente
+Pour être sûr que la hampe que nous avons rendue transparente
n'empiète pas trop sur le trait de liaison, nous pouvons l'allonger en
réglant la longueur (@code{length}) sur @code{8},
>>
@end lilypond
-@subheading Simulating a fermata in MIDI
+@subheading Rendu MIDI d'un point d'orgue
-@cindex stencil property, use of
-@cindex fermata, implementing in MIDI
+@cindex stencil, utilisation de la propriété
+@cindex point d'orgue, rendu en MIDI
En ce qui concerne les objets extérieurs à la portée, quand on veut les
-faire disparaître de la partition imprimée , il est généralement préférable
-de modifier leur propriété @code{stencil} plutôt que leur propriété
-@code{transparent}. Le fait d'attribuer à la propriété @code{stencil}
-d'un objet la valeur @code{#f} supprimera entièrement celui-ci de la
-partition. Il ne risquera donc pas de gêner le placement d'autres objets.
+faire disparaître de la partition imprimée , il est généralement
+préférable de modifier leur propriété @code{stencil} plutôt que leur
+propriété @code{transparent}. Le fait d'attribuer à la propriété
+@code{stencil} d'un objet la valeur @code{#f} supprimera entièrement
+celui-ci de la partition. Il ne risquera donc pas de gêner le placement
+d'autres objets.
Par exemple, si nous voulons changer le réglage de métronome pour
simuler un point d'orgue dans le fichier MIDI, nous ne voulons surtout
pas que cette indication métronomique apparaisse sur la partition ni
qu'elle influence l'espacement entre les deux systèmes ou la position
-des annotations voisines sur la portée. Le fait d'attribuer à la propriété
-@code{stencil} la valeur @code{#f} est donc la bonne solution. Nous
+des annotations voisines sur la portée. Le fait d'attribuer à la propriété
+@code{stencil} la valeur @code{#f} est donc la bonne solution. Nous
montrons ci-dessous le résultat des deux méthodes :
-@cindex MetronomeMark, example of overriding
-@cindex transparent property, example
+@cindex MetronomeMark, exemple de dérogation
+@cindex transparent, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,ragged-right]
\score {
}
@end lilypond
-@cindex MetronomeMark, example of overriding
-@cindex stencil property, example
+@cindex MetronomeMark, exemple de dérogation
+@cindex stencil, exemple d'utilisation de la propriété
@lilypond[quote,verbatim,ragged-right]
\score {
@end lilypond
@noindent
-Les deux méthodes permettent l'enlever l'indication métronomique qui allonge
-le point d'orgue de la partition, et toutes deux modifient le rythme MIDI comme
-souhaité, mais, dans la première, l'indication métronomique transparente
-repousse vers le haut l'indication de tempo, contrairement à la seconde (avec
-le stencil désactivé) qui la laisse à sa place.
+Les deux méthodes permettent d'enlever l'indication métronomique qui
+allonge le point d'orgue de la partition, et toutes deux modifient le
+rythme MIDI comme souhaité mais, dans la première, l'indication
+métronomique transparente repousse vers le haut l'indication de tempo,
+contrairement à la seconde (avec le stencil désactivé) qui la laisse à
+sa place.
-@node Using variables for tweaks
-@subsection Using variables for tweaks
+@node Utilisation de variables dans les retouches
+@subsection Utilisation de variables dans les retouches
+@translationof Using variables for tweaks
-@cindex variables, using for tweaks
-@cindex using variables for tweaks
-@cindex tweaks, using variables for
+@cindex variables, utilisation dans les retouches
+@cindex utilisation de variables dans les retouches
+@cindex retouches et utilisation de variables
Les commandes de retouche sont souvent longues et pénibles à
-taper, et ne tolèrent pas la moindre erreur. Lorsqu'on a besoin de
+taper, et ne tolèrent pas la moindre erreur. Lorsqu'on a besoin de
faire plusieurs fois les mêmes retouches, il est préférable de
-définir des variables qui les contiennent. Imaginons que nous
-voulions accentuer certains mots dans des paroles en les mettant
-en italiques. Au lieu des commandes @code{\italic} et
-@code{\bold}, qui ne fonctionnent dans les paroles que si elles
-sont enchâssées dans un @code{\markup}, ce qui les rend
-pénibles à saisir, pouvons-nous employer les commandes
-@code{\override} et @code{\revert}?
+définir des variables qui les contiennent.
+
+Imaginons que nous voulions accentuer certains mots dans des paroles en
+les mettant en italique. Au lieu des commandes @code{\italic} et
+@code{\bold}, qui ne fonctionnent dans les paroles que si elles sont
+enchâssées dans un @code{\markup}, ce qui les rend pénibles à saisir,
+pouvons-nous employer les commandes @code{\override} et @code{\revert} ?
@example
@code{\override Lyrics . LyricText #'font-shape = #'italic}
@end example
Là encore, ce serait extrêmement pénible à saisir, surtout s'il y avait
-beaucoup de mots à retoucher de cette façon. Plutôt que cette
+beaucoup de mots à retoucher de cette façon. Plutôt que cette
solution, nous déclarons ces commandes comme étant deux variables
-et les utilisons comme suit -- quoique on choisirait sans doute pour les
-variables des noms plus courts pour simplifier la frappe :
+et les utilisons comme suit -- quoique on choisirait sans doute pour
+les variables des noms plus courts pour simplifier la frappe :
-@cindex LyricText, example of overriding
-@cindex font-shape property, example
-@cindex font-series property, example
+@cindex LyricText, exemple de dérogation
+@cindex font-shape, exemple d'utilisation de la propriété
+@cindex font-series, exemple d'utilisation de la propriété
@lilypond[quote,verbatim]
emphasize = {
@end lilypond
-@node Other sources of information
-@subsection Other sources of information
+@node Feuilles de style
+@subsection Feuilles de style
+@translationof Style sheets
+
+La sortie que produit LilyPond peut être largement modifiée -- voir
+@ref{Retouche de partition} pour plus de détails. Mais que faire si
+vous avez beaucoup de fichiers auxquels vous souhaitez appliquer vos
+retouches ? Ou si vous souhaitez simplement séparer les retouches de
+la musique elle-même@tie{}? Rien de plus facile.
+
+Prenons un exemple. Ne vous inquiétez pas si vous ne comprenez pas
+les parties avec tous les @code{#()}. Celles-ci sont expliquées dans
+@ref{Retouches avancées avec Scheme}.
+
+@lilypond[quote,verbatim,ragged-right]
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line(#:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+\relative c'' {
+ \tempo 4=50
+ a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
+ \inst "Clarinet"
+ cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
+}
+@end lilypond
+
+Il y a quelques problèmes de chevauchement ; 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}
+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
+fichier, mais c'est fastidieux. De plus, cela laisse les définitions
+dans nos fichiers de musique, et je trouve personnellement tous ces
+@code{#()} assez laids. Stockons-les dans un autre fichier@tie{}:
+
+@example
+%%% enregistrez ceci dans un fichier nommé "definitions.ily"
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line(#:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+@end example
+
+Nous rappellerons ce fichier par une simple commande @code{\include} au
+début de notre fichier de musique. Lui attribuer l'extension
+@code{.ily} nous permet de distinguer aisément qu'il s'agit d'un fichier
+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}).
+
+@c We have to do this awkward example/lilypond-non-verbatim
+@c because we can't do the \include stuff in the manual.
+
+@example
+\include "definitions.ily"
+
+\relative c'' @{
+ \tempo 4=50
+ a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
+ \inst "Clarinet"
+ cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
+@}
+@end example
+
+@lilypond[quote,ragged-right]
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line(#:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+\relative c'' {
+ \tempo 4=50
+ a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
+ \inst "Clarinet"
+ cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
+}
+@end lilypond
+
+C'est mieux, mais effectuons encore quelques retouches. Le glissando
+est peu visible, c'est pourquoi nous allons l'épaissir et le
+rapprocher des têtes de note. Déplaçons l'indication métronomique
+au-dessus de la clef, au lieu de la laisser au-dessus de la première
+note. Et pour finir, mon professeur de composition déteste les
+chiffrages de mesure en @qq{C}, nous allons donc le transformer en
+@qq{4/4}.
+
+Cependant, ne changez pas le fichier @file{musique.ly}. Remplacez le
+fichier @file{definitions.ily} par ceci@tie{}:
+
+@example
+%%% definitions.ily
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line( #:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+\layout@{
+ \context @{ \Score
+ \override MetronomeMark #'extra-offset = #'(-9 . 0)
+ \override MetronomeMark #'padding = #'3
+ @}
+ \context @{ \Staff
+ \override TimeSignature #'style = #'numbered
+ @}
+ \context @{ \Voice
+ \override Glissando #'thickness = #3
+ \override Glissando #'gap = #0.1
+ @}
+@}
+@end example
+
+@lilypond[quote,ragged-right]
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line( #:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+\layout{
+ \context { \Score
+ \override MetronomeMark #'extra-offset = #'(-9 . 0)
+ \override MetronomeMark #'padding = #'3
+ }
+ \context { \Staff
+ \override TimeSignature #'style = #'numbered
+ }
+ \context { \Voice
+ \override Glissando #'thickness = #3
+ \override Glissando #'gap = #0.1
+ }
+}
+
+\relative c'' {
+ \tempo 4=50
+ a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
+ \inst "Clarinet"
+ cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
+}
+@end lilypond
+
+C'est encore mieux ! Mais supposons maintenant que je veuille publier
+cette pièce. Mon professeur de composition n'aime pas les chiffrages
+de mesure en @qq{C}, mais moi je les aime bien. Copions l'actuel
+@file{definitions.ily} dans le fichier @file{publication-web.ily}, et
+modifions ce dernier. Puisque la musique est destinée à produire un
+fichier PDF affiché sur écran, nous allons aussi augmenter la taille
+globale de police.
+
+@example
+%%% definitions.ily
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line( #:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+#(set-global-staff-size 23)
+\layout@{
+ \context @{ \Score
+ \override MetronomeMark #'extra-offset = #'(-9 . 0)
+ \override MetronomeMark #'padding = #'3
+ @}
+ \context @{ \Staff
+ @}
+ \context @{ \Voice
+ \override Glissando #'thickness = #3
+ \override Glissando #'gap = #0.1
+ @}
+@}
+@end example
+
+@lilypond[quote,ragged-right]
+mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
+ #:line( #:dynamic "mp" #:text #:italic "dolce" )))
+
+inst = #(define-music-function (parser location string) (string?)
+ (make-music
+ 'TextScriptEvent
+ 'direction UP
+ 'text (markup #:bold (#:box string))))
+
+#(set-global-staff-size 23)
+\layout{
+ \context { \Score
+ \override MetronomeMark #'extra-offset = #'(-9 . 0)
+ \override MetronomeMark #'padding = #'3
+ }
+ \context { \Voice
+ \override Glissando #'thickness = #3
+ \override Glissando #'gap = #0.1
+ }
+}
+
+\relative c'' {
+ \tempo 4=50
+ a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
+ \inst "Clarinet"
+ cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
+}
+@end lilypond
+
+Il ne nous reste plus qu'à remplacer @code{\include "definitions.ily"}
+par @code{\include "publication-web.ily"} dans notre fichier de musique.
-La Référence du programme contient beaucoup d'informations sur
-LilyPond. Cependant vous pouvez en découvrir
-encore plus en consultant les fichiers internes de LilyPond. Pour cela,
-il vous faut d'abord connaître le répertoire ad hoc sur votre système.
-L'emplacement du répertoire dépend (a) du fait que, pour vous procurer
-LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou
-vous l'avez installé grâce à votre gestionnaire de paquetages (c'est-à-dire
-distribué avec Linux ou installé avec fink ou cygwin), ou encore vous l'avez
-compilé directement à partir des sources ; et (b) du système d'exploitation
-sous lequel il tourne.
+Il est possible, bien sûr, de rendre cela encore plus pratique. Nous
+pourrions créer un fichier @file{definitions.ily} qui ne contiendrait
+que les définitions de @code{mpdolce} et de @code{inst}, un
+fichier @file{publication-web.ily} qui ne contiendrait que la section
+@code{layout} décrite ci-dessus et un fichier @file{universite.ily} qui
+ne contiendrait que les retouches pour produire le résultat que mon
+professeur préfère. Le début du fichier @file{musique.ly} ressemblerait
+alors à
+
+@example
+\include "definitions.ily"
+
+%%% Décommentez seulement une de ces deux lignes !
+\include "publication-web.ily"
+%\include "universite.ily"
+@end example
+
+Cette approche peut être utile même si vous ne produisez qu'un seul
+jeu de partitions. J'utilise personnellement une demi-douzaine de
+fichiers de @qq{feuille de style} pour mes projets. Je commence
+chaque fichier de musique par @code{\include "../global.ily"} qui
+contient@tie{}:
+
+@example
+%%% global.ily
+\version @w{"@version{}"}
+#(ly:set-option 'point-and-click #f)
+\include "../init/init-defs.ly"
+\include "../init/init-mise-en-page.ly"
+\include "../init/init-en-tetes.ly"
+\include "../init/init-papier.ly"
+@end example
+
+
+@node Autres sources de documentation
+@subsection Autres sources de documentation
+@translationof Other sources of information
+
+Le Manuel d'utilisation des programmes contient beaucoup d'informations
+sur LilyPond. Cependant vous pouvez en découvrir encore plus en
+consultant les fichiers internes de LilyPond. Pour cela, il vous faut
+d'abord connaître le répertoire @emph{ad hoc} sur votre système.
+L'emplacement du répertoire dépend (a) du fait que, pour vous procurer
+LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou
+vous l'avez installé grâce à votre gestionnaire de paquetages
+(c'est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou
+encore vous l'avez compilé directement à partir des sources ; et (b) du
+système d'exploitation sur lequel il tourne.
@strong{Téléchargé depuis lilypond.org}
@item MacOS X
-@file{@var{INSTALLDIR}/LilyPond.app/Contents/Resources/share/lilypond/current/}
+@code{@var{INSTALLDIR}/LilyPond.app/Contents/Resources/share/lilypond/current/}
Pour accéder à ce dossier, deux possibilités : soit, dans un Terminal,
taper @code{cd} suivi du chemin complet ci-dessus ; soit
Control-cliquer (ou clic droit) sur l'application LilyPond
-et sélectionner @q{Afficher le contenu du paquet}.
+et sélectionner @qq{Afficher le contenu du paquet}.
@item Windows
Dans l'Explorateur Windows, voir
-@file{@var{INSTALLDIR}/LilyPond/usr/share/lilypond/current/}
+@code{@var{INSTALLDIR}/LilyPond/usr/share/lilypond/current/}
@end itemize
@strong{Installé par un gestionnaire de paquetages ou compilé d'après
les sources}
-@file{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où
-@var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par le script
-@code{configure}, et @var{X.Y.Z} est le numéro de version de LilyPond.
+@code{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où
+@var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par
+le script @code{configure}, et @var{X.Y.Z} est le numéro de version de
+LilyPond.
@smallspace
-Dans ce répertoire, deux sous-répertoires sont particulièrement intéressants :
+Dans ce répertoire, deux sous-répertoires sont particulièrement
+intéressants :
@itemize
-@item @file{ly/} - contient les fichiers en format LilyPond
-@item @file{scm/} - contient les fichiers en format Scheme
+@item @code{ly/} --- contient les fichiers en format LilyPond
+@item @code{scm/} --- contient les fichiers en format Scheme
@end itemize
-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 @code{.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
+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}
+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
que des définitions de variables composées d'un ou plusieurs groupes
-de commandes @code{\override}. Par exemple, @code{\tieDotted}
+de commandes @code{\override}. Par exemple, @code{\tieDotted}
est défini comme :
@example
@}
@end example
-Si vous n'aimez pas les valeurs par défaut, les commandes prédéfinies
-peuvent être facilement redéfinies, comme n'importe quelle autre variable,
-en tête de votre fichier d'entrée.
+Si vous n'aimez pas les valeurs par défaut, les commandes prédéfinies
+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 @file{ly/}:
+Voici les fichiers les plus utiles dans le répertoire @code{ly/} :
@multitable @columnfractions .4 .6
@headitem Nom de fichier
@tab Contenu
-@item @file{ly/engraver-init.ly}
+@item @code{ly/engraver-init.ly}
@tab Définitions des Contextes de graveurs
-@item @file{ly/paper-defaults-init.ly}
+@item @code{ly/paper-defaults-init.ly}
@tab Réglages papier par défaut
-@item @file{ly/performer-init.ly}
+@item @code{ly/performer-init.ly}
@tab Définitions des Contextes d'interprétation
-@item @file{ly/property-init.ly}
+@item @code{ly/property-init.ly}
@tab Définitions de toutes les commandes prédéfinies courantes
-@item @file{ly/spanner-init.ly}
+@item @code{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 markup) sont
-conservés comme fichiers @code{.scm} (Scheme). Le langage de
+Les autres réglages (comme les définitions de commandes @emph{markup})
+sont conservés comme fichiers @code{.scm} (Scheme). Le langage de
programmation Scheme offre une interface programmable dans le
-processus interne de LilyPond. De plus amples explications sur ces
+processus interne de LilyPond. De plus amples explications sur ces
fichiers dépasseraient le cadre de ce manuel, dans la mesure où elles
-requièrent la connaissance du langage Scheme. Les utilisateurs qui
+requièrent la connaissance du langage Scheme. Les utilisateurs qui
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
-@ref{Scheme tutorial}).
+substantielles et beaucoup de temps sont nécessaires (voir le
+@ref{Tutoriel Scheme}).
Si c'est votre cas, les fichiers Scheme les plus utiles à connaître sont :
@multitable @columnfractions .4 .6
@headitem Nom de fichier
@tab Contenu
-@item @file{scm/auto-beam.scm}
+@item @code{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 grobs
-@item @file{scm/define-markup-commands.scm}
+@item @code{scm/define-grobs.scm}
+ @tab Réglages par défaut des propriétés de @emph{grobs}
+@item @code{scm/define-markup-commands.scm}
@tab Spécification de toutes les commandes de @emph{markup}
-@item @file{scm/midi.scm}
+@item @code{scm/midi.scm}
@tab Réglages par défaut pour les sorties MIDI
-@item @file{scm/output-lib.scm}
+@item @code{scm/output-lib.scm}
@tab Réglages affectant l'apparence des frets, couleurs, altérations,
- barres de mesure, etc
-@item @file{scm/parser-clef.scm}
+ barres de mesure, etc.
+@item @code{scm/parser-clef.scm}
@tab Définition des clefs prises en charge
-@item @file{scm/script.scm}
+@item @code{scm/script.scm}
@tab Réglages par défaut des articulations
@end multitable
-@node Avoiding tweaks with slower processing
-@subsection Avoiding tweaks with slower processing
+@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 ; 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 serrer la ligne suffisamment pour faire
-tenir le texte entre les marges.
-
-Pour pouvoir fonctionner en toutes circonstances, ces vérifications doivent
-être activées ; il faut pour cela placer les retouches dans un bloc Score
-@code{\with}, plutôt qu'à l'intérieur du fragment musical, comme ceci :
+traitement des fichiers ; 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 serrer la ligne
+suffisamment pour faire tenir le texte entre les marges.
+
+Pour pouvoir fonctionner en toutes circonstances, ces vérifications
+doivent être activées ; il faut pour cela placer les retouches dans un
+bloc @code{Score \with}, plutôt qu'à l'intérieur du fragment musical,
+comme ceci :
@example
\new Score \with @{
@end example
-@node Advanced tweaks with Scheme
-@subsection Advanced tweaks with Scheme
+@node Retouches avancées avec Scheme
+@subsection Retouches avancées avec Scheme
+@translationof Advanced tweaks with Scheme
Nous avons vu à quel point le résultat obtenu avec LilyPond peut
être largement personnalisé à l'aide de commandes comme
@code{\override} et @code{\tweak}. Et pourtant l'utilisation de
Scheme ouvre des possibilités encore plus grandes.
Le code écrit dans le langage de programmation Scheme peut être
-intégré directement dans le processus interne de LilyPond. Bien sûr,
+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
-@ref{Scheme tutorial}.
+Scheme. Pour des explications complètes là-dessus, consultez le
+@ref{Tutoriel Scheme}.
-En guise d'illustration - et ce n'est qu'une possibilité parmi tant
+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
préétablie mais une procédure Scheme qui sera lancée à chaque
-utilisation de la propriété par LilyPond. De cette façon, nous obtenons
+utilisation de la propriété par LilyPond. De cette façon, nous obtenons
un réglage dynamique de la propriété par le simple fait d'invoquer la
-procédure. Dans cet exemple, nous colorons les têtes de notes en fonction
-de leur position sur la portée.
+procédure. Dans cet exemple, nous colorons les têtes de notes en
+fonction de leur position sur la portée.
-@cindex x11-color function, example of using
-@cindex NoteHead, example of overriding
-@cindex color property, setting to Scheme procedure
+@cindex x11-color, exemple d'utilisaation de la fonction
+@cindex NoteHead, exemple de dérogation
+@cindex color, détermination de la propriété par une procédure Scheme
@lilypond[quote,verbatim,ragged-right]
#(define (color-notehead grob)
}
@end lilypond
-Vous trouverez dans @ref{Tweaking with Scheme} d'autres exemples d'utilisation de ces interfaces programmables.
+Vous trouverez dans @ref{Scheme et les retouches} d'autres exemples
+d'utilisation de ces interfaces programmables.
projects / lilypond.git / blobdiff