1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 34f7824737173f1b485c8989dd0de6b45c8b7c2a
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Frédéric Chiasson, Jean-Charles Malahieude
18 Negative numbers are allowed:
19 > Are you sure? The following works well
21 > first-page-number = -2
23 > and prints page number -1 on the second page, for example.
26 In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
29 "@code{layout-set-staff-size} does not change the distance between
32 Could we add a sentence:
33 "Use instead the pair fontSize = #@var{N}
34 \override StaffSymbol.staff-space = #(magstep @var{N})
35 inside the Staff context to change the size of the font and the
36 distance between staff lines accordingly."
38 Actually I found, that the @internalsref{StaffSymbol} at line 481
39 sends to an incomplete documentation. The property staff-space is not
40 explained here. I thought Y-extent might be of help, but it is in turn
41 explained by x-space which again is missing from the list. Who has the
42 knowledge to fix this?
46 http://code.google.com/p/lilypond/issues/detail?id=68
51 @node Gestion de l'espace
52 @chapter Gestion de l'espace
53 @translationof Spacing issues
55 L'agencement général d'une partition dépend de trois facteurs
56 interdépendants : la mise en page, les sauts de ligne et l'espacement.
57 Les choix faits en matière d'espacement détermineront la densité de
58 chacun des systèmes, ce qui influera sur le positionnement des sauts de
59 ligne et, par voie de conséquence, sur le nombre de pages de la
62 En pratique, cette procédure comporte quatre étapes. Dans un premier
63 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
64 base des durées. Sont alors calculées différentes possibilités de saut
65 de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
66 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
67 la combinaison entre sauts de page et de ligne qui offre la meilleure
68 occupation de l'espace, tant horizontalement que verticalement.
70 Les réglages qui influencent la mise en forme se placent dans deux blocs
71 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
72 @ref{Mise en forme de la page} contient les réglages applicables à
73 toutes les partitions d'une partie ou de l'intégralité d'un ouvrage --
74 tels que format du papier, impression ou non des numéros de page, etc.
75 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
76 rubrique @ref{Mise en forme de la partition}, il détermine la mise en
77 forme de la musique : le nombre de systèmes utilisés, l'espacement des
78 regroupements de portées, etc.
81 * Mise en forme de la page::
82 * Mise en forme de la partition::
84 * Espacement vertical::
85 * Espacement horizontal::
86 * Réduction du nombre de pages de la partition::
89 @cindex ragged, aligné
90 @cindex aligné, ragged
92 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
93 dont la traduction vous semblera assurément erronée. Il n'en est
94 cependant rien : certains termes techniques ont une histoire
95 particulière selon leur langue d'origine. Ainsi le vocable anglais
96 @emph{Ragged} signifie en lambeau, en loques ; dans l'univers
97 typographique, un maître français voit un alignement à gauche -- il dira
98 @qq{au fer à gauche} -- alors que son homologue anglophone constate un
99 @emph{ragged-right} -- donc du vide à droite.}
102 @node Mise en forme de la page
103 @section Mise en forme de la page
104 @translationof Page layout
106 Nous allons examiner ici les options qui contrôlent la mise en forme des
107 pages attachées au bloc @code{\paper}.
111 * Format du papier et adaptation automatique::
112 * Variables d'espacement vertical fixe::
113 * Variables d'espacement vertical fluctuant::
114 * Variables d'espacement horizontal::
115 * Autres variables du bloc \paper::
120 @subsection Le bloc @code{\paper}
121 @translationof The \paper block
123 Des blocs @code{\paper} peuvent apparaître à trois différents endroits
124 et former ainsi une hiérarchie :
129 En début de fichier source, avant même tout bloc @code{\book},
130 @code{\bookpart} ou @code{\score}.
133 Au sein d'un bloc @code{\book} et indépendamment de tout bloc
134 @code{\bookpart} ou @code{\score} qu'il pourrait contenir.
137 Au sein d'un bloc @code{\bookpart}, mais en dehors de tout bloc
142 Un bloc @code{\paper} ne doit donc en aucun cas prendre place au sein
143 d'un bloc @code{\score}.
145 Les valeurs des différents champs seront filtrées en respectant cette
146 hiérarchie ; les valeuers définies le plus haut persisteront à moins
147 d'être remplacées à un niveau hiérarchique inférieur.
149 Plusieurs blocs @code{\paper} peuvent cohabiter à un même niveau,
150 notamment en raison de la présence d'inclusion de fichiers. Dans une
151 telle éventualité, les champs sont regroupés par niveau, la dernière
152 valeur rencontrée ayant préséance en cas de doublon.
154 Peuvent apparaître dans un bloc @code{\paper} :
159 la fonction Scheme @code{set-paper-size},
162 des variables propres au bloc @code{\paper} qui viendront adapter la
166 la définition des différents @emph{markups} qui personnaliseront la mise
167 en forme des entêtes et pieds de page ainsi que des titrages.
171 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
172 -- @ref{Format du papier et adaptation automatique}. Les variables du
173 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
174 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
175 des entête, pied de page et titrage, elles sont étudiées à la rubrique
176 @ref{Titrages personnalisés}.
178 La plupart des variables gérant le papier ne sont fonctionnelles que
179 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
180 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
181 rubrique @ref{Le bloc \layout}.
183 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
184 correspondent à des dimensions sont exprimées en millimètre -- vous
185 pouvez bien entendu spécifier un autre système de mesure. Voici
186 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
195 Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
196 mentionner le suffixe d'unité @code{\in} :
204 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
205 @code{\in} et @code{\pt}. Ces unités sont des conversions de
206 millimètres, répertoriées dans le fichier
207 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
208 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
209 @code{\mm} à votre code lorsque vous travaillez en millimètres.
211 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
212 fonctions Scheme. Voici l'équivalent de l'exemple précédent :
216 #(define top-margin (* 0.5 in))
222 @ref{Format du papier et adaptation automatique},
223 @ref{Titrages personnalisés}.
224 @ref{Le bloc \layout}.
226 Fichiers d'initialisation :
227 @file{ly/paper-defaults-init.ly}.
230 @node Format du papier et adaptation automatique
231 @subsection Format du papier et adaptation automatique
232 @translationof Paper size and automatic scaling
234 @cindex papier, taille
241 * Adaptation automatique au format::
245 @node Format du papier
246 @unnumberedsubsubsec Format du papier
247 @translationof Setting the paper size
249 LilyPond génère par défaut, et en l'absence de mention explicite d'un
250 format de papier particulier, un fichier imprimable au format A4.
251 Vous pouvez cependant utiliser un autre format à l'aide des deux
252 fonctions @code{set-default-paper-size} et @code{set-paper-size}
253 qui, elle, se place à l'intérieur d'un bloc @code{\paper} :
256 #(set-default-paper-size "quarto")
259 qui se place en début de fichier, ou @code{set-paper-size},
263 #(set-paper-size "tabloid")
267 qui s'inscrit au sein d'un bloc @code{\paper}.
270 La seule restriction à l'utilisation isolée de la fonction
271 @code{set-default-paper-size} est qu'elle doit intervenir avant le
272 premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
273 format pour toutes les pages, alors que @code{set-paper-size} détermine
274 le format des feuilles rattachées à un bloc @code{\paper} particulier.
275 Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
276 format du papier s'appliquera à toutes les pages ; si @code{\paper}
277 apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
278 @emph{book} en question.
280 À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
281 doit intervenir avant toute autre variable. Les raisons à ceci sont
282 abordées à la rubrique @ref{Adaptation automatique au format}.
284 Différents formats de papier sont définis dans le fichier
285 @file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
286 format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
287 LilyPond. Les différents formats disponibles sont répertoriés à
288 l'annexe @ref{Formats de papier prédéfinis}.
290 @c An appendix entry exists for paper sizes but is not auto-generated
292 La commande suivante, inscrite dans votre fichier, vous permettra
293 d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
294 appel à l'aide des fonctions @code{set-default-paper-size} et
295 @code{set-paper-size} :
298 #(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
301 #(set-paper-size "mon format")
305 Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
306 @code{cm} (centimètres) ou @code{mm} (millimètres).
308 @cindex papier, orientation
309 @cindex landscape, papier
310 @cindex paysage, papier
311 @cindex à l'italienne, papier
313 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
314 stipulant le format du papier permet d'obtenir une présentation à
315 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
319 #(set-default-paper-size "a6" 'landscape)
322 L'inversion des dimensions du papier sans pour autant basculer la
323 présentation -- comme pour imprimer sur une carte postale ou créer un
324 graphique destiné à inclusion -- s'obtient en ajoutant @samp{landscape}
325 au nom du format de papier :
328 #(set-default-paper-size "a6landscape")
331 Lorsque la taille du papier comporte explicitement @samp{landscape} ou
332 @samp{portrait}, la présence d'un argument @code{'landscape} aura pour
333 seul effet de modifier l'orientation de l'image et non les dimensions de
338 @ref{Adaptation automatique au format},
339 @ref{Formats de papier prédéfinis}.
341 Fichiers d'initialisation :
342 @file{scm/paper.scm}.
345 @node Adaptation automatique au format
346 @unnumberedsubsubsec Adaptation automatique au format
347 @translationof Automatic scaling to paper size
349 Toute modification du format de papier à l'aide des fonctions Scheme
350 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
351 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
352 par l'ajustement d'un certain nombre de variables attachées au bloc
353 @code{\paper} afin qu'elles soient en concordance avec le format
354 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
355 particulière en redéfinissant sa valeur après avoir spécifié le format
356 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
357 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
358 l'étalonnage automatique, bien que spécifier une largeur de papier
359 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
360 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
361 voir avec la mise à l'échelle.
363 L'adaptation automatique affecte les dimensionnements verticaux
364 @code{top-margin} et @code{bottom-margin} -- voir
365 @ref{Variables d'espacement vertical fixe} --, ainsi que les
366 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
367 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
368 @code{indent} et @code{short-indent} -- voir
369 @ref{Variables d'espacement horizontal}.
371 Les valeurs par défaut de ces dimensionnements sont contenues dans le
372 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
373 internes @code{top-margin-default}, @code{bottom-margin-default}, etc.
374 correspondant au format par défaut -- papier A4 -- pour lequel
375 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
380 @ref{Variables d'espacement vertical fixe},
381 @ref{Variables d'espacement horizontal}.
383 Fichiers d'initialisation :
384 @file{ly/paper-defaults-init.ly},
385 @file{scm/paper.scm}.
388 @node Variables d'espacement vertical fixe
389 @subsection Variables d'espacement vertical fixe
390 @translationof Fixed vertical spacing \paper variables
392 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
393 sont automatiquement ajustés selon le format du papier, ce qui peut
394 conduire à un résultat inattendu --
395 voir @ref{Adaptation automatique au format}.}
397 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
398 @file{ly/paper-defaults-init.ly}.
402 @funindex paper-height
404 La hauteur de la feuille. Il s'agit par défaut de la dimension du
405 papier utilisé. Notez bien que cette variable n'affectera pas
406 l'ajustement automatique d'un certain nombre de dimensionnements
412 La marge entre le bord supérieur de la feuille et la surface imprimable.
413 Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
417 @funindex bottom-margin
419 La marge entre la surface imprimable et le bord inférieur de la feuille.
420 Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
424 @funindex ragged-bottom
426 L'activation de cette variable permet de ne pas répartir verticalement
427 les systèmes sur les pages hormis la dernière. La valeur par défaut
428 est @code{#f}. Lorsque la partition ne comporte que deux ou trois
429 systèmes par page, comme pour un conducteur d'orchestre, nous vous
430 conseillons d'activer cette variable.
432 @item ragged-last-bottom
433 @funindex ragged-last-bottom
435 La désactivation de cette variable permet de répartir verticalement les
436 systèmes de la dernière page d'une partition. La valeur par défaut
437 est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
438 deux pages ou plus, de désactiver cette variable.@*
439 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
440 dernière page de chacune des parties -- créées à l'aide d'un bloc
441 @code{\bookpart} -- d'un même ouvrage.
447 @ref{Adaptation automatique au format}.
449 Fichiers d'initialisation :
450 @file{ly/paper-defaults-init.ly}.
453 @rlsrnamed{Spacing, Espacements}.
456 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
457 comme des systèmes à part entière ; ils seront donc affectés par
458 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
459 ajouteront de l'espace avant le premier système de la partition.
461 La définition explicite d'un format de papier annulera tout réglage des
462 marges haute et basse.
465 @node Variables d'espacement vertical fluctuant
466 @subsection Variables d'espacement vertical fluctuant
467 @translationof Flexible vertical spacing \paper variables
469 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
470 entre différents éléments (marges, titres, systèmes ou mouvements), en
471 dilatation ou compression selon le cas. Un certain nombre de variables
472 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
473 ces dimensionnements.
475 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
476 parlons ici n'influencent en rien l'espacement des portées d'un même
477 système. L'espacement au sein des systèmes est géré par des propriétés
478 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
479 définissent au niveau du bloc @code{\score} -- voir à ce sujet
480 @ref{Espacement vertical au sein d'un système}.
483 * Structure des variables d'espacement vertical fluctuant::
484 * Liste des variables d'espacement vertical fluctuant::
488 @node Structure des variables d'espacement vertical fluctuant
489 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
490 @translationof Structure of flexible vertical spacing alists
492 Chacune de ces variables attachées au bloc @code{\paper} est constituée
493 d'une liste associative @emph{(alist)} à quatre @i{clés} :
498 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
499 par défaut, exprimée en hauteur de portée, séparant les @i{points de
500 référence} de deux éléments, qui évite tout risque de collision en
501 l'absence de dilatation ou compression. Le point de référence d'un
502 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
503 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
504 ligne de @qq{non-portée} viendrait à s'intercaler. Une
505 @code{basic-distance} inférieure à @code{padding} ou
506 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
507 résultant ne saurait être inférieur à @code{padding} ou
508 @code{minimum-distance}.
511 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
512 minimal, exprimé en hauteur de portée, entre les points de référence des
513 deux éléments alors qu'il y a déjà un effet de compression. Une
514 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
515 sans effet, dans la mesure où l'espacement résultant ne saurait être
516 inférieur au @code{padding}.
518 @c TODO: explain skylines somewhere and xref to it from here.
521 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
522 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
523 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
524 sur toute la largeur des deux éléments.
527 @code{stretchability} @emph{(dilatation)} -- le coefficient
528 d'étirement de cet espace. Un coefficient nul permet de figer
529 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
530 positif déterminera la propension d'un espacement à s'étirer, tout
531 en tenant compte du coefficient affecté aux autres espacements.
532 Par exemple, lorsque le coefficient de dilatation d'une dimension est
533 double de celui d'une autre, elle pourra s'étirer deux fois plus que
534 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
535 provoque une @code{programming_error} (erreur de programmation) et est
536 ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
537 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
538 sa valeur est par défaut égale à @code{space}. Notez bien que
539 l'utilisateur ne peut définir une propension à la compression ;
540 elle est en fait égale à
541 (@code{basic-distance} @minus{} @code{minimum-distance}).
545 Lorsque l'impression n'est pas en pleine page -- elle est donc
546 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
547 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
553 @code{basic-distance}, plus
555 @code{minimum-distance} et
557 @code{padding}, augmenté de ce qu'il faut pour éviter les
562 Cependant, lorsque la partition fait plusieurs pages, la dernière page
563 reprendra dans la mesure du possible l'espacement de la page précédente.
565 Les manières de modifier des listes associatives font l'objet d'un
566 @rusernamed{Modification de listes associatives, chapitre spécifique}.
567 L'exemple suivant indique deux façons de modifier une liste associative.
568 La première déclaration intervient sur une seule clé, alors que la
569 deuxième redéfinit complètement la variable.
573 system-system-spacing #'basic-distance = #8
575 score-system-spacing =
577 (basic-distance . 12)
578 (minimum-distance . 6)
579 (stretchability . 12))
584 @node Liste des variables d'espacement vertical fluctuant
585 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
586 @translationof List of flexible vertical spacing \paper variables
588 Le nom des dimensionnements à hauteur variable sont de la forme
589 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
590 @code{@var{après}} représentent les éléments qui doivent être espacés.
591 La distance s'établit entre les points de référence des deux éléments
592 concernés (voir la rubrique précédente pour plus de précision). Notez
593 bien que, dans les règles de nommage des variables qui suivent, le terme
594 @code{markup} fait référence aussi bien à un @i{markup de titrage}
595 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
596 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
597 distances sont exprimées en espace de portée.
599 Leurs valeurs par défaut sont inscrites dans le fichier
600 @file{ly/paper-defaults-init.ly}.
602 @c TODO: Where do headers/footers fit in? -mp
605 @item markup-system-spacing
606 @funindex markup-system-spacing
608 détermine l'espacement entre un titre ou un @emph{markup} de premier
609 niveau, et le système qui le suit.
611 @item score-markup-spacing
612 @funindex score-markup-spacing
614 détermine l'espacement entre le dernier système et le titre ou
615 @emph{markup} de haut niveau qui le suit.
617 @item score-system-spacing
618 @funindex score-system-spacing
620 détermine l'espacement entre le dernier système d'une partition et le
621 premier système de la partition suivante, en l'absence de titrage ou
622 @emph{markup} qui les sépare.
624 @item system-system-spacing
625 @funindex system-system-spacing
627 détermine l'espacement entre deux systèmes d'un même mouvement.
629 @item markup-markup-spacing
630 @funindex markup-markup-spacing
632 détermine l'espacement entre deux titres ou @emph{markups} de premier
635 @item last-bottom-spacing
636 @funindex last-bottom-spacing
638 détermine la distance entre le dernier système ou le dernier
639 @emph{markup} de haut niveau, et le bas de la surface imprimable --
640 autrement dit le haut de la marge basse.
642 @item top-system-spacing
643 @funindex top-system-spacing
645 détermine l'espace entre le haut de la surface imprimable (le bas de la
646 marge haute) et le milieu du premier système. Cette variable n'est
647 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
650 @item top-markup-spacing
651 @funindex top-markup-spacing
653 détermine l'espace entre le haut de la surface imprimable (le bas de la
654 marge haute) et le premier titre ou @emph{markup} de premier niveau.
655 Cette variable n'est effective qu'en l'absence de système en haut de
662 @ref{Espacement vertical au sein d'un système}.
665 @rlsrnamed{Spacing,Espacements}.
668 @rlsrnamed{Spacing,Espacements}.
671 @node Variables d'espacement horizontal
672 @subsection Variables d'espacement horizontal
673 @translationof Horizontal spacing \paper variables
675 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
676 sont automatiquement ajustés selon le format du papier, ce qui peut
677 conduire à un résultat inattendu --
678 voir @ref{Adaptation automatique au format}.}
681 * Variables de marge et de largeur::
682 * Variables spécifiques à l'impression recto-verso::
683 * Variables d'indentation et de décalage::
687 @node Variables de marge et de largeur
688 @unnumberedsubsubsec Variables de marge et de largeur
689 @translationof \paper variables for widths and margins
691 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
692 @file{ly/paper-defaults-init.ly}.
697 @funindex paper-width
699 La largeur de la page. Elle correspond par défaut à la largeur du
700 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
701 matière d'ajustement automatique, cette variable influe sur la variable
702 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
703 @code{paper-width} et @code{line-width}, les valeurs de
704 @code{left-margin} et @code{right-margin} seront recalculées. Voir
705 aussi @code{check-consistency}.
710 la longueur d'un système musical sans indentation et justifié sur toute
711 la largeur de la page. La valeur par défaut est égale à
712 @code{paper-width}, auquel sont retranchés @code{left-margin} et
713 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
714 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
715 marges seront alors recalculées de telle sorte que les systèmes soient
716 centrés. Voir aussi @code{check-consistency}. La variable
717 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
720 @funindex left-margin
722 la marge entre le bord gauche de la feuille et le début de chaque
723 système. La valeur par défaut est de @code{10\mm} ; elle sera
724 ajustée selon le format du papier. Lorsque vous définissez
725 @code{line-width} et @code{right-margin} sans modifier la valeur de
726 @code{left-margin}, cette dernière sera alors égale à
727 @code{(paper-width @minus{} line-width @minus{} right-margin)}.
728 Lorsque seule @code{line-width} est définie, les deux marges
730 @code{((paper-width @minus{} line-width) / 2)}, ce
731 qui a pour effet de centrer les systèmes sur la page. Voir aussi
732 @code{check-consistency}.
735 @funindex right-margin
737 La marge entre le bord droit de la page et la fin des systèmes en pleine
738 largeur (non @emph{ragged}). La valeur par défaut est de @code{10\mm}
739 et s'ajustera selon le format du papier. Lorsque vous définissez
740 @code{line-width} et @code{left-margin}, sans modifier la valeur de
741 @code{right-margin}, cette dernière sera alors égale à
742 @code{(paper-width @minus{} line-width @minus{} left-margin)}.
743 Lorsque seule @code{line-width} est définie, les deux marges
745 @code{((paper-width @minus{} line-width) / 2)}, ce
746 qui a pour effet de centrer les systèmes sur la page. Voir aussi
747 @code{check-consistency}.
749 @item check-consistency
750 @funindex check-consistency
752 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
753 @code{line-width} et @code{right-margin} sont en cohérence, et que
754 l'addition de ces trois éléments ne dépassera pas la largeur du papier
755 (@code{paper-width}). La valeur par défaut est @code{#t}. Dans
756 le cas d'une incohérence, un message d'avertissement est émis et les
757 trois variables -- marges et longueur de ligne -- rétablies à leur
758 valeur par défaut (ajustées selon le format du papier).
761 @funindex ragged-right
763 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
764 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
765 La valeur par défaut est @code{#f} mais, si la partition ne comporte
766 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
767 se gérer au sein d'un bloc @code{\layout}.
770 @funindex ragged-last
772 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
773 dernier système de façon à occuper toute la longueur de la ligne. La
774 valeur par défaut est @code{#f}. Cette variable peut aussi se
775 gérer au sein d'un bloc @code{\layout}.
781 @ref{Adaptation automatique au format}.
783 Fichiers d'initialisation :
784 @file{ly/paper-defaults-init.ly}.
787 La définition explicite d'un format de papier annulera tout réglage des
788 marges gauche et droite.
791 @node Variables spécifiques à l'impression recto-verso
792 @unnumberedsubsubsec Variables spécifiques à l'impression recto-verso
793 @translationof \paper variables for two-sided mode
795 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
796 @file{ly/paper-defaults-init.ly}.
806 Cette variable permet de gérer efficacement les impressions recto-verso.
807 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
808 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
809 différentes marges selon qu'il s'agit d'une page paire ou impaire.
810 Cette variable s'applique en lieu et place de @code{left-margin} et
811 @code{right-margin}. La valeur par défaut est @code{#f}.
814 @funindex inner-margin
816 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
817 avoir du côté intérieur. Bien entendu, cette variable n'est
818 effective que lorsque vous comptez générer un fichier imprimable en
819 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
820 défaut est de @code{10\mm} et s'ajustera selon le format du papier.
823 @funindex outer-margin
825 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
826 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
827 variable n'est effective que lorsque vous comptez générer un fichier
828 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
829 La valeur par défaut est de @code{20\mm} et s'ajustera selon le
833 @funindex binding-offset
835 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
836 valeur de la marge intérieure @code{inner-margin} de telle sorte que
837 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
838 effective que lorsque vous comptez générer un fichier imprimable en
839 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
840 défaut est de @code{0} et s'ajustera selon le format du papier.
846 @ref{Adaptation automatique au format}.
848 Fichiers d'initialisation :
849 @file{ly/paper-defaults-init.ly}.
852 @node Variables d'indentation et de décalage
853 @unnumberedsubsubsec Variables d'indentation et de décalage
854 @translationof \paper variables for shifts and indents
856 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
857 @file{ly/paper-defaults-init.ly}.
861 @item horizontal-shift
862 @funindex horizontal-shift
864 @c This default value is buried in the middle of page.scm. -mp
866 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
867 seront poussés d'autant vers la droite. La valeur par défaut est
873 Le niveau d'indentation du premier système d'une partition. La valeur
874 par défaut est de @code{15\mm} et s'ajustera selon le format du
875 papier. Cette variable peut aussi se gérer au sein d'un bloc
879 @funindex short-indent
881 Le niveau d'indentation de tous les systèmes hormis le premier. La
882 valeur par défaut est de @code{0}, et s'ajustera selon le format du
883 papier dès lors que vous lui aurez affecté une valeur. Cette
884 variable peut aussi se gérer au sein d'un bloc @code{\layout}.
890 @ref{Adaptation automatique au format}.
892 Fichiers d'initialisation :
893 @file{ly/paper-defaults-init.ly}.
896 @rlsrnamed{Spacing, Espacements}.
899 @node Autres variables du bloc \paper
900 @subsection Autres variables du bloc @code{\paper}
901 @translationof Other \paper variables
904 * Variables de gestion des sauts de ligne::
905 * Variables de gestion des sauts de page::
906 * Variables de gestion des numéros de page::
907 * Variables supplémentaires::
911 @node Variables de gestion des sauts de ligne
912 @unnumberedsubsubsec Variables de gestion des sauts de ligne
913 @translationof \paper variables for line breaking
917 @item max-systems-per-page
918 @funindex max-systems-per-page
920 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
921 variable n'est prise en compte, à ce jour, que par l'option
922 @code{ly:optimal-breaking}, et n'est pas définie.
924 @item min-systems-per-page
925 @funindex min-systems-per-page
927 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
928 cependant aux risques de débordement s'il est trop important. Cette
929 variable n'est prise en compte, à ce jour, que par l'option
930 @code{ly:optimal-breaking}, et n'est pas définie.
932 @item systems-per-page
933 @funindex systems-per-page
935 Le nombre de systèmes que devrait comporter chaque page. Cette variable
936 n'est à ce jour prise en charge que par l'algorithme
937 @code{ly:optimal-breaking} et n'est pas définie par défaut.
940 @funindex system-count
942 Le nombre de systèmes requis par la partition. Cette variable n'est pas
943 définie par défaut. Cette variable peut se gérer au sein d'un bloc
950 @ref{Sauts de ligne}.
953 @node Variables de gestion des sauts de page
954 @unnumberedsubsubsec Variables de gestion des sauts de page
955 @translationof \paper variables for page breaking
957 Les valeurs par défaut sont définies dans le fichier
958 @file{ly/paper-defaults-init.ly}.
963 @funindex page-breaking
965 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
966 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking},
967 @code{ly:one-line-breaking} et @code{ly:optimal-breaking} (activé
970 @item page-breaking-system-system-spacing
971 @funindex page-breaking-system-system-spacing
973 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
974 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
975 lorsque @code{page-breaking-system-system-spacing #'padding} a une
976 valeur nettement supérieure à @code{system-system-spacing #'padding},
977 l'algorithme en question aura tendance à disposer moins de systèmes sur
978 une même page. Cette variable est par défaut non définie.
983 Le nombre de pages que devra comporter la partition. Cette variable est
984 par défaut non définie.
988 Les variables qui suivent ne sont effectives que lorsque
989 l'algorithme @code{page-breaking} adopte la fonction
990 @code{ly:page-turn-breaking}. Les sauts de page sont alors
991 positionnés de sorte à minimiser le nombre de tournes. Dans la
992 mesure où il faut tourner la feuille pour passer d'une page
993 impaire à une page paire, sera privilégiée une répartition qui
994 présente une dernière page impaire. Les endroits où une tourne
995 serait appropriée peuvent s'indiquer à l'aide d'un
996 @code{\allowPageTurn} ou laissés à l'appréciation du
997 @code{Page_turn_engraver} -- voir @ref{Optimisation des tournes}.
999 Lorsqu'aucune option n'est satisfaisante pour placer
1000 judicieusement les tournes, LilyPond peut décider d'insérer une
1001 page blanche au milieu d'une partition ou entre deux partitions
1002 successives, voire même finir par une page paire. La valeur des
1003 trois variables qui suivent peut se voir augmentée de façon à
1004 diminuer ces risques.
1006 Il s'agit ici de pénalité ; autrement dit, au plus la valeur est
1007 élevée, au moins l'action associée sera favorisée en regard des
1012 @item blank-page-penalty
1013 @funindex blank-page-penalty
1015 Pénalité pour apparition d'une page blanche en cours de partition.
1016 L'attribution d'une valeur élevée à @code{blank-page-penalty}
1017 alors qu'a été activé @code{ly:page-turn-breaking} forcera
1018 LilyPond à éviter de placer une page blanche au mileu de la
1019 partition, quitte à espacer d'autant plus la musique pour remplir
1020 cette page blanche et la suivante. La valeur par défaut est
1023 @item blank-last-page-penalty
1024 @funindex blank-last-page-penalty
1026 Pénalité pour fin de partition intervenant sur une page paire.
1027 L'attribution d'une valeur élevée à @code{blank-last-page-penalty}
1028 alors qu'a été activé @code{ly:page-turn-breaking} forcera
1029 LilyPond à éviter de terminer la partition sur une page paire,
1030 quitte à ajuster les espacements jusqu'à obtenir une page de plus
1031 ou une de moins. La valeur par défaut est de @code{0}.
1033 @item blank-after-score-page-penalty
1034 @funindex blank-after-score-page-penalty
1036 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
1037 valeur est par défaut inférieure à celle de
1038 @code{blank-page-penalty} ; nous préférons qu'une page blanche
1039 s'insère après la fin de la partition plutôt qu'au milieu. La
1040 valeur par défaut est de @code{2}.
1045 Manuel de notation :
1046 @ref{Sauts de page},
1047 @ref{Optimisation des sauts de page},
1048 @ref{Optimisation des tournes},
1049 @ref{Minimisation des sauts de page},
1050 @ref{Présentation en rouleau}.
1052 Fichiers d'initialisation :
1053 @file{ly/paper-defaults-init.ly}.
1056 @node Variables de gestion des numéros de page
1057 @unnumberedsubsubsec Variables de gestion des numéros de page
1058 @translationof \paper variables for page numbering
1060 Les valeurs par défaut sont définies dans le
1061 fichier @file{ly/paper-defaults-init.ly}.
1065 @cindex pages, numérotation automatique
1066 @item auto-first-page-number
1067 @funindex auto-first-page-number
1069 L'algorithme qui gère les sauts de page prend en compte le fait que le
1070 premier numéro de page soit pair ou impair. Lorsque cette
1071 fonctionnalité est activée, l'algorithme des sauts de page décidera de
1072 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
1073 par un éventuel incrément de un. La valeur par défaut
1076 @cindex pages, numéro de la première
1077 @item first-page-number
1078 @funindex first-page-number
1080 Le numéro de la première page. La valeur par défaut est
1083 @item print-first-page-number
1084 @funindex print-first-page-number
1086 Cette variable permet d'imprimer le numéro de page y compris sur la
1087 première. La valeur par défaut est @code{#f}.
1089 @item print-page-number
1090 @funindex print-page-number
1092 La désactivation de cette variable permet d'obtenir des pages non
1093 numérotées. La valeur par défaut est @code{#t}.
1098 Fichiers d'initialisation :
1099 @file{ly/paper-defaults-init.ly}.
1102 Les pages au numéro impair sont toujours à droite. Pour que la musique
1103 commence en page 1, le dos de la page de garde doit être vide de telle
1104 sorte que la page une se retrouve à droite.
1107 @node Variables supplémentaires
1108 @unnumberedsubsubsec Variables supplémentaires
1109 @translationof Miscellaneous \paper variables
1113 @item page-spacing-weight
1114 @funindex page-spacing-weight
1116 Cette variable définit l'importance relative des espacements entre la
1117 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1118 privilégiera l'espacement au niveau de la page. La valeur par défaut
1121 @item print-all-headers
1122 @funindex print-all-headers
1124 Lorsque cette variable est activée, l'intégralité des champs d'entête
1125 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1126 champs @code{piece} et @code{opus}. La valeur par défaut
1129 @item system-separator-markup
1130 @funindex system-separator-markup
1132 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1133 chaque système, comme on le voit dans nombre de partitions orchestrales.
1134 Cette variable n'est pas définie par défaut. La commande
1135 @code{\slashSeparator} -- définie dans le fichier
1136 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1139 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1140 #(set-default-paper-size "a8")
1144 system-separator-markup = \slashSeparator
1150 \relative c'' { c1 \break c1 \break c1 }
1158 Fichiers d'initialisation :
1159 @file{ly/titling-init.ly}.
1162 @rlsrnamed{Spacing,Espacements}.
1165 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1166 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1169 @node Mise en forme de la partition
1170 @section Mise en forme de la partition
1171 @translationof Score layout
1173 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1174 plus particulièrement destinées à gérer la mise en forme de la
1179 * Définition de la taille de portée::
1183 @node Le bloc \layout
1184 @subsection Le bloc @code{\layout}
1185 @translationof The \layout block
1189 Alors que le bloc @code{\paper} définit le formatage des pages pour
1190 l'intégralité du document, le bloc @code{\layout} gère la mise en
1191 forme spécifique à la partition. La mise en forme de la musique peut
1192 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1193 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1194 où la mise en forme concerne une partition en particulier, un bloc
1195 @code{\layout} se placera au sein du bloc @code{\score} en question.
1196 Sont susceptibles d'apparaître dans un bloc @code{\layout} :
1200 la fonction Scheme @code{layout-set-staff-size},
1203 dans des blocs @code{\context}, les modifications apportées aux
1204 différents contextes, et
1207 les variables normalement attachées au bloc @code{\paper} qui
1208 affecteront la mise en forme de la partition.
1212 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1213 suivante, @ref{Définition de la taille de portée}. La modification des
1214 contextes est abordée dans d'autres chapitres -- voir
1215 @ref{Modification des greffons de contexte} et
1216 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1217 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1218 @code{\layout} sont :
1223 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1224 (voir @ref{Variables de marge et de largeur})
1227 @code{indent} et @code{short-indent}
1228 (voir @ref{Variables d'indentation et de décalage})
1232 (voir @ref{Variables de gestion des sauts de ligne})
1236 Voici un exemple de bloc @code{\layout} :
1243 \override StaffGrouper.staff-staff-spacing.basic-distance = #8
1247 \override TextScript.padding = #1
1248 \override Glissando.thickness = #3
1253 Il est tout à fait possible que plusieurs blocs @code{\layout}
1254 cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
1255 particulièrement utile lorsque différents réglages sont stockés dans des
1256 fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
1257 @code{\layout} est évalué, une copie de la configuration du
1258 @code{\layout} actuel est réalisée en interne, augmentée des
1259 aménagements apportés. Bien qu'on puisse considérer que le contenu des
1260 différents blocs @code{\layout} se cumule, c'est la dernière adaptation
1261 qui aura préséance en cas de situation conflictuelle -- cas typique
1262 d'une même propriété modifiée dans différents blocs.
1264 Par exemple, placer le bloc suivant
1270 \override TextScript.color = #magenta
1271 \override Glissando.thickness = #1.5
1276 après celui de l'exemple précédent aura pour effet de cumuler les
1277 adaptations de @code{'padding} et @code{'color} pour l'objet
1278 @code{TextScript}, mais la dernière adaptation apportée à la propriété
1279 @code{'thickness} de @code{Glissando} remplace, ou masque, celle
1280 précédemment établie.
1282 Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
1283 les utiliser ultérieurement. Ceci requiert toutefois une attention
1284 particulière dans la mesure où cette manière de procéder n'est pas
1285 équivalente à une définition complète et globale.
1287 Lorsque nous définissons la variable suivante,
1290 layoutVariable = \layout @{
1293 \override NoteHead.font-size = #4
1298 qui contient une configuration de @code{\layout} avec
1299 l'adaptation @code{NoteHead.font-size}, cette combinaison n'est pas
1300 enregistrée en tant que configuration courante. Notez bien que la
1301 « configuration courante » est lue lorsque la variable est définie, non
1302 lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
1303 variable dépend de l'endroit où elle se trouve dans le code source.
1305 Notre variable peut alors être utilisée au sein d'un autre bloc
1306 @code{\layout}, comme par exemple :
1313 \override NoteHead.color = #red
1318 Un bloc @code{\layout} qui contient une variable comme ci-dessus ne
1319 recopie pas la configuration actuelle ; il utilise en fait le contenu de
1320 @code{layoutVariable} en tant que configuration de base pour les
1321 adaptations ultérieures, en conséquence de quoi toute modification
1322 intervenant entre la définition et l'utilisation de la variable sera
1325 Si @code{layoutVariable} est définie, ou rapatriée par un
1326 @code{\indude}, juste avant d'être utilisée, son contenu devient la
1327 configuration actuelle augmentée des adaptations que la variable
1328 contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
1329 ci-dessus, le bloc @code{\layout} final contiendra donc :
1332 TextScript.padding = #1
1333 TextScript.color = #magenta
1334 Glissando.thickness = #1.5
1335 NoteHead.font-size = #4
1336 NoteHead.color = #red
1339 ainsi que les adaptations de @code{indent} et @code{StaffGrouper}.
1341 Cependant, si la variable avait été définie bien avant le premier bloc
1342 @code{\layout}, la configuration actuelle ne contiendrait que
1345 NoteHead.font-size= #4 % (écrit dans la définition de la variable)
1346 NoteHead.color = #red % (ajouté après l'utilisation de la variable)
1349 Une gestion attentive des variables de @code{\layout} se révèle être un
1350 outil précieux dans la mise en forme des sources et le retour à une
1351 configuration donnée.
1354 Manuel de notation :
1355 @ref{Modification des réglages par défaut d'un contexte}.
1358 @rlsrnamed{Spacing,Espacements}.
1361 @node Définition de la taille de portée
1362 @subsection Définition de la taille de portée
1363 @translationof Setting the staff size
1365 @cindex fonte, définition de la taille
1366 @cindex portée, définition de la taille
1367 @funindex layout file
1369 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1370 20 points. Il existe deux manières de la modifier :
1372 La taille des portées peut se définir globalement pour toutes les
1373 partitions d'un même fichier, ou plus précisément d'un bloc
1374 @code{\book}, à l'aide de @code{set-global-staff-size}.
1377 #(set-global-staff-size 14)
1381 Ceci définit donc la hauteur des portées à 14 points par
1382 défaut ; toutes les fontes seront ajustées en conséquence.
1384 Vous pouvez aussi spécifier une taille à une partition en particulier en
1385 procédant comme ci-dessous :
1391 #(layout-set-staff-size 15)
1396 La fonte Feta fournit les symboles musicaux dans huit tailles
1397 différentes. Chaque fonte correspond à une hauteur particulière de
1398 portée ; les petites tailles comportent des symboles plus épais
1399 pour être cohérent avec l'épaisseur relativement plus importante des
1400 lignes de la portée. Le tableau suivant répertorie les différentes
1404 @multitable @columnfractions .15 .2 .22 .2
1406 @item @b{nom de la fonte}
1407 @tab @b{hauteur de portée (pt)}
1408 @tab @b{hauteur de portée (mm)}
1409 @tab @b{utilisation}
1414 @tab format de poche
1434 @tab carnet de chant
1439 @tab partition standard
1450 @c matériel de location moderne ?
1455 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1456 contexte @code{fontSize} ainsi que la propriété de mise en forme
1457 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1458 individuellement la taille de chaque portée. La taille de chacune des
1459 portées est relative à la taille globale.
1462 Manuel de notation :
1463 @ref{Indication de la taille de fonte musicale}.
1466 @rlsrnamed{Spacing,Espacements}.
1469 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1470 lignes d'une portée.
1475 @translationof Breaks
1480 * Optimisation des sauts de page::
1481 * Optimisation des tournes::
1482 * Minimisation des sauts de page::
1483 * Présentation en rouleau::
1484 * Sauts explicites::
1485 * Recours à une voix supplémentaire pour gérer les sauts::
1489 @node Sauts de ligne
1490 @subsection Sauts de ligne
1491 @translationof Line breaking
1493 @cindex saut de ligne
1494 @cindex ligne, passer à la suivante
1496 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1497 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1498 trop aérée, et que des lignes consécutives aient à peu près la même
1501 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1502 vous le jugez utile pour @qq{forcer} le passage à la ligne suivante :
1504 @lilypond[quote,ragged-right,relative=2,verbatim]
1509 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1510 mesure ; LilyPond vous le signalera par un message si tel était le
1511 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1512 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1513 l'aide de @code{\bar ""}.
1515 @lilypond[quote,ragged-right,relative=2,verbatim]
1522 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1523 mesure dès lors que la précédente avait une note en suspend -- c'est
1524 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1525 L'instruction @code{\break} sera alors opérationnelle si vous avez
1526 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1527 @code{Voice} concerné. Notez bien qu'en pareil cas, les sauts de ligne
1528 forcés doivent être saisis au sein d'une expression polyphonique :
1530 @lilypond[quote,ragged-right,verbatim]
1532 \remove "Forbid_line_break_engraver"
1535 { c2. \tuplet 3/2 { c4 c c } c2. | }
1536 { s1 | \break s1 | }
1541 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1542 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1543 introduire la dérogation @w{@code{\override Beam.breakable = ##t}}.
1545 @lilypond[quote,ragged-right,relative=2,verbatim]
1546 \override Beam.breakable = ##t
1551 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1552 saut de ligne à la fin de la mesure où elle est explicitée.
1554 LilyPond dispose de deux variables de base pour influencer l'espacement
1555 au niveau des lignes. Toutes deux se définissent dans un bloc
1556 @code{\layout}, @code{indent} réglant l'indentation de la première
1557 ligne, et @code{line-width} la longueur des lignes.
1559 L'activation du commutateur @code{ragged-right} au sein du bloc
1560 @code{\layout} aura pour effet de terminer les systèmes là où ils
1561 prendraient fin normalement plutôt que de les étirer sur toute la
1562 longueur de la ligne. Ceci est particulièrement utile pour de petits
1563 fragments ou pour vérifier la densité induite par l'espacement naturel.
1565 @c TODO Check and add para on default for ragged-right
1567 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1568 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1578 @cindex sauts de ligne réguliers
1579 @cindex portée à quatre mesures
1581 L'utilisation conjointe de @code{\break} et de blancs dans une section
1582 @code{\repeat} vous permettra de positionner des sauts de ligne à
1583 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1584 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1590 s1 \noBreak s1 \noBreak
1591 s1 \noBreak s1 \break
1593 @{ @var{et ici la musique@dots{}} @}
1605 Manuel de notation :
1606 @ref{Variables de gestion des sauts de ligne}.
1608 Référence des propriétés internes :
1609 @rinternals{LineBreakEvent}.
1612 @rlsrnamed{Spacing,Espacements}.
1616 @subsection Sauts de page
1617 @translationof Page breaking
1619 La gestion automatique des sauts de page se contrôle à l'aide des
1620 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1621 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1622 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1623 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1624 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1627 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1628 trouver à des niveaux supérieurs, entre deux partitions ou
1629 @emph{markups} de premier rang.
1631 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1632 gérer la répartition horizontale, LilyPond dispose de commutateurs
1633 équivalents au niveau de la verticalité : @code{ragged-bottom} et
1634 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1635 affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
1636 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1637 à @ref{Variables d'espacement vertical fixe}.
1639 Les sauts de page sont générés par la fonction @code{page-breaking}.
1640 LilyPond dispose de trois différents algorithmes en la matière :
1641 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1642 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1643 activé par défaut, mais rien ne vous empêche d'en changer, par
1644 l'intermédiaire du bloc @code{\paper} :
1648 page-breaking = #ly:page-turn-breaking
1654 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1655 pages, la gestion des sauts de page finit par devenir très gourmande,
1656 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1657 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1658 sectionner l'ouvrage que vous traitez ; les sauts de page seront
1659 alors gérés individuellement au niveau de chacune des parties. Par
1660 ailleurs, cela vous autorisera une gestion différente selon les
1666 subtitle = "Préface"
1669 %% Pour une partie constituée principalement de texte
1670 %% ly:minimal-breaking est plus judicieux.
1671 page-breaking = #ly:minimal-breaking
1673 \markup @{ @dots{} @}
1677 %% Cette partie étant purement musicale,
1678 %% retour au style par défaut (optimal-breaking).
1680 subtitle = "Premier mouvement"
1682 \score @{ @dots{} @}
1688 @funindex \pageBreak
1690 @funindex \noPageBreak
1691 @code{\noPageBreak}.
1695 Manuel de notation :
1696 @ref{Variables de gestion des sauts de page}.
1699 @rlsrnamed{Spacing,Espacements}.
1702 @node Optimisation des sauts de page
1703 @subsection Optimisation des sauts de page
1704 @translationof Optimal page breaking
1706 @funindex ly:optimal-breaking
1708 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1709 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1710 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1711 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1712 n'a aucune notion de ce qu'est une @qq{tourne}.
1716 @rlsrnamed{Spacing,Espacements}.
1719 @node Optimisation des tournes
1720 @subsection Optimisation des tournes
1721 @translationof Optimal page turning
1723 @funindex ly:page-turn-breaking
1725 Aboutir à une configuration des sauts de page de telle sorte que les
1726 pages de droite se terminent toujours par un silence devient souvent une
1727 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1728 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1729 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1730 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1731 ne saurait intervenir qu'à certains endroits.
1733 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1734 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1735 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1736 informer la fonction des endroits où les sauts de page sont permis.
1738 Cette deuxième étape se réalise de deux manières différentes. Vous
1739 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1740 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1742 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1743 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1744 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1745 tournes recherchera dans le contexte en question les passages sans note.
1746 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1747 notes ; autrement dit, il ne restera pas inactif dans le cadre
1748 d'une portée polyphonique dont l'une des parties contiendrait des
1749 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1750 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1751 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1752 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1753 déposera le @code{\allowPageTurn}.
1755 @funindex minimumPageTurnLength
1757 Le @code{Page_turn_engraver} examine la propriété de contexte
1758 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1759 longueur d'un fragment sans note avant une tourne. La valeur par
1760 défaut de @code{minimumPageTurnLength} est
1761 @code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
1762 la manière suivante :
1765 \new Staff \with @{ \consists "Page_turn_engraver" @}
1768 R1 | % une tourne peut se placer ici
1770 \set Staff.minimumPageTurnLength = #(ly:make-moment 5/2)
1771 R1 | % il ne peut pas y avoir de tourne ici
1773 R1*2 | % une tourne peut se placer ici
1778 @funindex minimumRepeatLengthForPageTurn
1780 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1781 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1782 temps au début et à la fin de la reprise pour que l'exécutant ait le
1783 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1784 même capable d'interdire un tourne dans le cas d'une reprise de courte
1785 durée, ajustable au travers de la propriété de contexte
1786 @code{minimumRepeatLengthForPageTurn}.
1788 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1789 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1790 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1795 @funindex \noPageTurn
1797 @funindex \allowPageTurn
1798 @code{\allowPageTurn}.
1802 Manuel de notation :
1803 @ref{Variables de gestion des sauts de ligne}.
1806 @rlsrnamed{Spacing,Espacements}.
1809 Une partition ne devrait contenir qu'une seule instance du
1810 @code{Page_turn_engraver}, au risque de les voir se contredire.
1813 @node Minimisation des sauts de page
1814 @subsection Minimisation des sauts de page
1815 @translationof Minimal page breaking
1817 @funindex ly:minimal-breaking
1819 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1820 calculs pour positionner les sauts de page. Elle mettra le plus de
1821 systèmes possible sur une page avant de passer à la suivante. On peut
1822 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1823 lorsque les autres fonctions de gestion des sauts de page ralentissent
1824 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1825 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1830 page-breaking = #ly:minimal-breaking
1836 @rlsrnamed{Spacing,Espacements}.
1839 @node Présentation en rouleau
1840 @subsection Présentation en rouleau
1841 @translationof One-line page breaking
1843 @funindex ly:one-line-breaking
1845 La fonction @code{ly:one-line-breaking} constitue un algorithme de
1846 calcul des sauts de pages particulier en ceci que chaque partition fait
1847 l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
1848 s'affranchit de l'impression des titres et marges ; seule la partition
1851 La largeur de page est ajustée de telle sorte que la pièce la plus
1852 longue tienne sur une seule ligne. En particulier, les variables
1853 @code{paper-width}, @code{line-width} et @code{indent} du bloc
1854 @code{\paper} seront ignorées ; les @code{left-margin} et
1855 @code{right-margin} seront honorées. La hauteur de page ne sera pas
1859 @node Sauts explicites
1860 @subsection Sauts explicites
1861 @translationof Explicit breaks
1863 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1864 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1865 avec ces deux instructions dérogatoires :
1868 \override NonMusicalPaperColumn.line-break-permission = ##f
1869 \override NonMusicalPaperColumn.page-break-permission = ##f
1872 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1873 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1874 explicite, et nulle part ailleurs. De la même façon, la désactivation
1875 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1876 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1877 nulle part ailleurs.
1879 @lilypond[quote,verbatim]
1886 music = \relative c'' { c8 c c c }
1890 \repeat unfold 2 { \music } \break
1891 \repeat unfold 4 { \music } \break
1892 \repeat unfold 6 { \music } \break
1893 \repeat unfold 8 { \music } \pageBreak
1894 \repeat unfold 8 { \music } \break
1895 \repeat unfold 6 { \music } \break
1896 \repeat unfold 4 { \music } \break
1897 \repeat unfold 2 { \music }
1902 \override NonMusicalPaperColumn.line-break-permission = ##f
1903 \override NonMusicalPaperColumn.page-break-permission = ##f
1911 @rlsrnamed{Spacing,Espacements}.
1914 @node Recours à une voix supplémentaire pour gérer les sauts
1915 @subsection Recours à une voix supplémentaire pour gérer les sauts
1916 @translationof Using an extra voice for breaks
1918 La plupart du temps, les informations concernant les sauts de ligne ou
1919 de page se retrouvent directement au milieu des notes.
1922 musique = \relative c'' @{ c4 c c c @}
1926 \repeat unfold 2 @{ \musique @} \break
1927 \repeat unfold 3 @{ \musique @}
1932 Bien que cela constitue un moyen aisé de saisir les commandes
1933 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1934 mélangées à des informations qui concernent plutôt l'agencement de la
1935 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1936 purement musical et les informations concernant les sauts de ligne ou de
1937 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1938 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1939 des @code{\break}, des @code{\pageBreak} et autres informations
1940 concernant les ruptures.
1942 @lilypond[quote,verbatim]
1943 music = \relative c'' { c4 c c c }
1945 \header { tagline = ##f }
1946 \paper { left-margin = 0\mm }
1957 \repeat unfold 2 { \music }
1958 \repeat unfold 3 { \music }
1959 \repeat unfold 6 { \music }
1960 \repeat unfold 5 { \music }
1967 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1968 les @code{line-break-system-details} et autres propriétés fort
1969 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1970 le voir au chapitre @ref{Espacement vertical}.
1972 @lilypond[quote,verbatim]
1973 music = \relative c'' { c4 c c c }
1975 \header { tagline = ##f }
1976 \paper { left-margin = 0\mm }
1981 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
1985 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
1989 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
1993 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
1998 \repeat unfold 2 { \music }
1999 \repeat unfold 3 { \music }
2000 \repeat unfold 6 { \music }
2001 \repeat unfold 5 { \music }
2009 Manuel de notation :
2010 @ref{Espacement vertical}.
2013 @rlsrnamed{Spacing,Espacements}.
2016 @node Espacement vertical
2017 @section Espacement vertical
2018 @translationof Vertical spacing
2020 @cindex vertical, espacement
2021 @cindex espacement vertical
2023 L'espacement vertical dépend de trois éléments : la surface
2024 disponible -- format de papier et marges --, l'espace qui doit
2025 séparer les systèmes, et l'espace qui sépare les portées d'un même
2029 * Espacement vertical au sein d'un système::
2030 * Positionnement explicite des portées et systèmes::
2031 * Résolution des collisions verticales::
2035 @node Espacement vertical au sein d'un système
2036 @subsection Espacement vertical au sein d'un système
2037 @translationof Flexible vertical spacing within systems
2039 @cindex distance entre les portées
2040 @cindex portées, espacement
2041 @cindex espacement entre les portées
2042 @cindex espacement au sein d'un système
2044 LilyPond dispose de trois différents mécanismes permettant de contrôler
2045 l'espacement au sein d'un système selon trois catégories :
2050 @emph{portées isolées},
2053 @emph{portées regroupées} (portées d'un même groupe, telles celles
2054 d'un @code{ChoirStaff}, etc.), et
2057 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
2061 @c TODO: Clarify this. This almost implies that non-staff lines
2062 @c have NO effect on the spacing between staves. -mp
2064 La hauteur de chaque système se détermine en deux phases. Les portées
2065 sont tout d'abord espacées selon la surface disponible. Puis les lignes
2066 autres que des portées, comme les paroles ou les accords, sont réparties
2069 Les paragraphes qui suivent traitent exclusivement de la manière de
2070 gérer l'espacement entre les lignes d'un système -- portée musicale ou
2071 non. Pour ce qui a trait aux espacements entre les systèmes,
2072 mouvements, annotations et marge, ils sont contrôlés par des variables
2073 attachées au bloc @code{\paper} et font l'objet du chapitre
2074 @ref{Variables d'espacement vertical fluctuant}.
2077 * Propriétés d'espacement au sein d'un système::
2078 * Espacement de portées isolées::
2079 * Espacement de portées regroupées::
2080 * Espacement des lignes rattachées à des portées::
2084 @node Propriétés d'espacement au sein d'un système
2085 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
2086 @translationof Within-system spacing properties
2088 @funindex staff-affinity
2089 @funindex staffgroup-staff-spacing
2090 @funindex staff-staff-spacing
2091 @funindex nonstaff-unrelatedstaff-spacing
2092 @funindex nonstaff-relatedstaff-spacing
2093 @funindex nonstaff-nonstaff-spacing
2094 @funindex default-staff-staff-spacing
2095 @funindex minimum-Y-extent
2096 @funindex extra-offset
2097 @funindex self-alignment-X
2099 @funindex VerticalAxisGroup
2101 L'espacement entre les portées est géré par deux jeux de propriétés
2102 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
2103 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
2104 ou de non-portée. Le second, associé à l'objet graphique
2105 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
2106 de portées particulier. Les propriétés qui leur sont attachées sont
2107 abordées en fin de section.
2109 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
2110 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
2111 @code{@var{item2}} étant les éléments à espacer. Notez bien que
2112 @code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
2113 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
2114 l'espacement d'une ligne de non-portée alors que sa
2115 @code{staff-affinity} a été déterminée à @code{UP}.
2117 Toutes ces distances sont mesurées entre les points de référence
2118 respectifs des éléments considérés.
2119 Le @i{point de référence} d'une portée est le centre vertical du
2120 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
2121 l'interligne médian si @code{line-count} est pair.
2122 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
2123 tableau suivant présente le @i{point de référence} pour chacune
2126 @multitable {Ligne de non-portée} {Point de référence}
2127 @headitem Ligne de non-portée @tab Point de référence
2128 @item @code{ChordNames} @tab ligne de base
2129 @item @code{NoteNames} @tab ligne de base
2130 @item @code{Lyrics} @tab ligne de base
2131 @item @code{Dynamics} @tab centre vertical
2132 @item @code{FiguredBass} @tab point le plus haut
2133 @item @code{FretBoards} @tab ligne supérieure
2136 En voici une représentation graphique :
2139 @lilypond[quote,noragged-right,line-width=110\mm]
2140 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
2142 alignToZero = \with {
2143 \override VerticalAxisGroup.nonstaff-relatedstaff-spacing = #zero-space
2144 \override VerticalAxisGroup.nonstaff-nonstaff-spacing = #zero-space
2146 lowerCaseChords = \with {
2147 chordNameLowercaseMinor = ##t
2149 staffAffinityDown = \with {
2150 \override VerticalAxisGroup.staff-affinity = #DOWN
2153 #(define-music-function
2154 (parser location context)
2156 #{ s1*0^\markup { \typewriter #context } #})
2159 \context { \Dynamics \alignToZero }
2160 \context { \FiguredBass \alignToZero }
2161 \context { \Lyrics \alignToZero }
2162 \context { \NoteNames \alignToZero \staffAffinityDown }
2163 \context { \ChordNames \alignToZero
2166 \context { \FretBoards \alignToZero \staffAffinityDown }
2168 \override BarLine.stencil = ##f
2169 \override DynamicText.self-alignment-X = #-1
2170 \override FretBoard.X-offset = #1.75
2171 \override InstrumentName.minimum-Y-extent = #'(-2 . 2)
2172 \override InstrumentName.extra-offset = #'(0 . -0.5)
2173 \override TextScript.minimum-Y-extent = #'(-2 . 3)
2174 \override TimeSignature.stencil = ##f
2178 %% Contextes dont le point de référence est la ligne de base :
2179 %% ChordNames, NoteNames et Lyrics
2181 \new ChordNames { \chords { g1:m } }
2182 \new NoteNames { s1 | g1 | }
2183 \new RhythmicStaff {
2184 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
2186 \labelContext "ChordNames" s1 |
2187 \labelContext "NoteNames" s1 |
2188 \labelContext "Lyrics" s1 |
2190 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
2193 %% Le point de référence de Dynamics est le milieu de la ligne
2195 \new RhythmicStaff {
2196 \set RhythmicStaff.instrumentName = #"centre vertical "
2197 \labelContext "Dynamics" s1*3
2199 \new Dynamics { s1\mp s\fp }
2202 %% Le point de référence de FiguredBass est son point le plus haut
2204 \new RhythmicStaff {
2205 \set RhythmicStaff.instrumentName = #"point le plus haut "
2206 \labelContext "FiguredBass" s1
2208 \new FiguredBass { \figuremode { <6 5>1 } }
2211 %% Le point de référence de FretBoards est la ligne du haut
2212 \include "predefined-guitar-fretboards.ly"
2214 \new FretBoards { \chordmode { e1 } }
2215 \new RhythmicStaff {
2216 \set RhythmicStaff.instrumentName = #"ligne du haut "
2217 \labelContext "FretBoards " s1
2222 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2223 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2224 sous la forme d'une liste associative dont la structure est
2225 identique à celle des variables du bloc @code{\paper} que nous avons
2226 examinées au chapitre
2227 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2228 matière de modification d'une liste associative font l'objet d'un
2229 @rusernamed{Modification de listes associatives,chapitre particulier}.
2230 Les propriétés des objets graphiques se règlent avec un @code{\override}
2231 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2234 L'exemple suivant illustre deux façons de modifier une liste
2235 associative. La première déclaration n'agit que sur une seule clé,
2236 alors que la seconde redéfinit la propriété dans son intégralité.
2240 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2244 \override VerticalAxisGroup.default-staff-staff-spacing =
2245 #'(('basic-distance . 10)
2246 (minimum-distance . 9)
2248 (stretchability . 10))
2252 La modification d'un espacement au niveau global se mentionne au sein du
2253 bloc @code{\layout} :
2259 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2264 Les réglages concernant les propriétés d'espacement vertical des objets
2265 graphiques sont répertoriées aux chapitres
2266 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2267 Les propriétés relatives aux lignes de non-portée sont répertoriées
2268 selon la définition de leur contexte dans la
2269 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2272 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2273 @c VO Properties of the @code{VerticalAxisGroup} grob
2275 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2276 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2280 @item staff-staff-spacing
2281 Il s'agit de la distance entre la portée en cours et la portée qui suit
2282 au sein du même regroupement, qu'il y ait ou des lignes de non-portée
2283 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2284 pas à la dernière portée d'un système.
2286 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2287 d'un @code{VerticalAxisGroup} affectera les propriétés du
2288 @code{StaffGrouper} si la portée est incluse dans un regroupement ;
2289 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2290 regroupement. Les portées peuvent donc s'aligner différemment selon
2291 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2292 tenir compte des éventuels regroupements, cette fonction peut faire
2293 place à une complète redéfinition des espacements fluctuants à l'aide de
2294 règles dérogatoires comme vu précédemment.
2296 @item default-staff-staff-spacing
2297 Il s'agit de la distance qui s'appliquera par défaut aux portées
2298 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2299 explicitement par un @code{\override}.
2301 @item staff-affinity
2302 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2303 que prendra une ligne de non-portée pour aller s'accoler aux portées
2304 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2305 non-portée ira se placer à équidistance entre les portées qui
2306 l'encadrent, tout en tenant compte des éventuels risques de collision et
2307 autres contraintes d'espacement. Des lignes de non-portée
2308 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2309 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2310 Une ligne de non-portée en dessous d'un système devrait avoir sa
2311 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2312 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2313 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2314 @code{staff-affinity} : si vous affectez la valeur @code{#f} à
2315 une ligne de non-portée, cette ligne sera considérée comme étant une
2316 portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
2317 pour une portée lui fera perdre cette qualité.
2319 @item nonstaff-relatedstaff-spacing
2320 Il s'agit de la distance entre la ligne de non-portée en cours et la
2321 portée la plus proche selon la @code{staff-affinity}, à la double
2322 condition qu'il n'y ait pas déjà une autre ligne de non-portée et que la
2323 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2324 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2325 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2326 non-portée entre les deux portées adjacentes même si une autre
2327 non-portée est présente (quelque soit le côté). Le positionnement
2328 d'une ligne de non-portée dépend donc à la fois des portées tout
2329 comme des autres lignes de non-portée adjacentes. L'affectation
2330 d'une faible valeur à la propriété @code{stretchability} de l'un
2331 de ces types d'espacement les avantagera ; leur affecter une
2332 grande valeur aura pour conséquence de diminuer leur influence.
2335 @c traduction approximative des dernières phrases, qui manquent de
2336 @c précision : QUI EST AVANTAGÉ OU NON ?
2338 This means that the placement of a non-staff line depends
2339 on both the surrounding staves and the surrounding non-staff lines.
2340 Setting the @code{stretchability} of one of these types of spacing to
2341 a small value will make that spacing dominate. Setting the
2342 @code{stretchability} to a large value will make that spacing have
2346 @item nonstaff-nonstaff-spacing
2347 Il s'agit de la distance entre deux lignes de non-portée selon
2348 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2349 la même orientation. Bien entendu, ceci ne peut concerner que les
2350 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2352 @item nonstaff-unrelatedstaff-spacing
2353 Il s'agit de la distance entre une ligne de non-portée et la portée à
2354 l'opposé de l'orientation adoptée, à la double condition qu'il n'y ait
2355 pas déjà une autre ligne de non-portée et que la valeur de
2356 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2357 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2358 portée à laquelle elle ne correspond pas.
2362 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2363 @c VO Properties of the @code{StaffGrouper} grob
2365 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2366 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2370 @item staff-staff-spacing
2371 Il s'agit de la distance entre deux portées consécutives d'un même
2372 système. La propriété @code{staff-staff-spacing} de l'objet
2373 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2374 l'aide de règles dérogatoires.
2376 @item staffgroup-staff-spacing
2377 Il s'agit de la distance entre la dernière portée d'un regroupement et
2378 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2379 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2380 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2381 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2382 regroupement a été ajustée au niveau de son propre
2383 @code{VerticalAxisGroup}, cette dernière aura préséance.
2387 Manuel de notation :
2388 @ref{Variables d'espacement vertical fluctuant},
2389 @ref{Modification de listes associatives}.
2391 Fichiers d'initialisation :
2392 @file{ly/engraver-init.ly},
2393 @file{scm/define-grobs.scm}.
2395 Référence des propriétés internes :
2396 @rinternals{Contexts},
2397 @rinternals{VerticalAxisGroup},
2398 @rinternals{StaffGrouper}.
2401 @node Espacement de portées isolées
2402 @unnumberedsubsubsec Espacement de portées isolées
2403 @translationof Spacing of ungrouped staves
2405 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2406 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2409 L'espacement de ces @i{portées isolées} est géré par les propriétés
2413 @item Propriétés du @code{VerticalAxisGroup} :
2415 @item @code{default-staff-staff-spacing}
2416 @item @code{staff-staff-spacing}
2420 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2421 @ref{Propriétés d'espacement au sein d'un système}.
2423 Certaines propriétés supplémentaires s'appliqueront dès lors que
2424 ces portées sont regroupées -- voir
2425 @ref{Espacement de portées regroupées}.
2427 L'exemple suivant illustre la manière de gérer l'espacement de portées
2428 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2429 Les mêmes règles appliquées de manière dérogatoire au
2430 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2431 sein de regroupements.
2433 @lilypond[verbatim,quote,staffsize=16]
2437 \override VerticalAxisGroup.default-staff-staff-spacing =
2438 #'((basic-distance . 8)
2439 (minimum-distance . 7)
2445 % The very low note here needs more room than 'basic-distance
2446 % can provide, so the distance between this staff and the next
2447 % is determined by 'padding.
2448 \new Staff { b,2 r | }
2450 % Here, 'basic-distance provides enough room, and there is no
2451 % need to compress the space (towards 'minimum-distance) to make
2452 % room for anything else on the page, so the distance between
2453 % this staff and the next is determined by 'basic-distance.
2454 \new Staff { \clef bass g2 r | }
2456 % By setting 'padding to a negative value, staves can be made to
2457 % collide. The lowest acceptable value for 'basic-distance is 0.
2459 \override VerticalAxisGroup.default-staff-staff-spacing =
2460 #'((basic-distance . 3.5)
2462 } { \clef bass g2 r | }
2463 \new Staff { \clef bass g2 r | }
2468 Fichiers d'initialisation :
2469 @file{scm/define-grobs.scm}.
2472 @rlsrnamed{Spacing,Espacements}.
2474 Référence des propriétés internes :
2475 @rinternals{VerticalAxisGroup}.
2478 @node Espacement de portées regroupées
2479 @unnumberedsubsubsec Espacement de portées regroupées
2480 @translationof Spacing of grouped staves
2482 Dans les partitions orchestrales ou de grande ampleur, il arrive
2483 souvent que des portées soient regroupées. L'espacement est alors plus
2484 important entre deux regroupements qu'entre les portées d'un même
2487 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2488 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2489 une ou plusieurs portées.
2491 L'espacement entre les portées d'un même regroupement est géré par les
2492 propriétés suivantes :
2495 @item Propriétés du @code{VerticalAxisGroup} :
2497 @item @code{staff-staff-spacing}
2499 @item Propriétés du @code{StaffGrouper} :
2501 @item @code{staff-staff-spacing}
2502 @item @code{staffgroup-staff-spacing}
2506 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2507 @ref{Propriétés d'espacement au sein d'un système}.
2509 L'exemple suivant illustre la manière de gérer l'espacement de portées
2510 regroupées, à l'aide des propriétés de l'objet graphique
2511 @code{StaffGrouper} :
2513 @lilypond[verbatim,quote,staffsize=16]
2517 \override StaffGrouper.staff-staff-spacing.padding = #0
2518 \override StaffGrouper.staff-staff-spacing.basic-distance = #1
2523 \new PianoStaff \with {
2524 \override StaffGrouper.staffgroup-staff-spacing.basic-distance = #20
2539 Fichiers d'initialisation :
2540 @file{scm/define-grobs.scm}.
2543 @rlsrnamed{Spacing,Espacements}.
2545 Référence des propriétés internes:
2546 @rinternals{VerticalAxisGroup},
2547 @rinternals{StaffGrouper}.
2550 @node Espacement des lignes rattachées à des portées
2551 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2552 @translationof Spacing of non-staff lines
2554 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2555 @code{ChordNames} sont des contextes dont les objets de rendu sont
2556 gravés à l'instar des portées -- une ligne horizontale dans un système.
2557 En fait, les lignes de non-portée sont des contextes qui vont créer un
2558 objet de rendu @code{VerticalAxisGroup}.
2560 L'espacement des lignes de non-portée est géré par les propriétés
2564 @item Propriétés du @code{VerticalAxisGroup} :
2566 @item @code{staff-affinity}
2567 @item @code{nonstaff-relatedstaff-spacing}
2568 @item @code{nonstaff-nonstaff-spacing}
2569 @item @code{nonstaff-unrelatedstaff-spacing}
2573 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2574 @ref{Propriétés d'espacement au sein d'un système}.
2576 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2577 pour gérer l'espacement entre des lignes consécutives de non-portée.
2578 Vous noterez que la valeur élevée attribuée à la clé
2579 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2581 @lilypond[verbatim,quote,staffsize=16]
2585 \override VerticalAxisGroup.nonstaff-nonstaff-spacing.stretchability = #1000
2592 \override VerticalAxisGroup.staff-staff-spacing = #'((basic-distance . 30))
2595 \override VerticalAxisGroup.staff-affinity = #UP
2598 \override VerticalAxisGroup.staff-affinity = #CENTER
2599 } \lyricmode { center }
2601 \override VerticalAxisGroup.staff-affinity = #DOWN
2602 } \lyricmode { down }
2608 Fichiers d'initialisation :
2609 @file{ly/engraver-init.ly},
2610 @file{scm/define-grobs.scm}.
2613 @rlsrnamed{Spacing,Espacements}.
2615 @c @lsr{spacing,page-spacing.ly},
2616 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2618 Référence des propriétés internes :
2619 @rinternals{Contexts},
2620 @rinternals{VerticalAxisGroup}.
2623 @node Positionnement explicite des portées et systèmes
2624 @subsection Positionnement explicite des portées et systèmes
2625 @translationof Explicit staff and system positioning
2627 Pour bien comprendre comment fonctionnent les réglages de
2628 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2629 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2630 les différentes mises au point du décalage vertical appliqué aux portées
2631 et systèmes distribués sur une page.
2633 Une autre approche de l'espacement vertical est le recours à
2634 @code{NonMusicalPaperColumn.line-break-system-details}. Alors que
2635 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2636 @code{NonMusicalPaperColumn.line-break-system-details} spécifiera le
2637 positionnement vertical absolu sur la page.
2639 @code{NonMusicalPaperColumn.line-break-system-details} prend en charge
2640 une liste associative de trois mises au point :
2643 @item @code{X-offset}
2644 @item @code{Y-offset}
2645 @item @code{alignment-distances}
2648 Les dérogations en matière d'objet graphique, y compris celles
2649 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2650 à trois différents endroits de votre fichier source :
2653 @item directement au beau milieu des notes
2654 @item au sein d'un bloc @code{\context}
2655 @item dans un bloc @code{\with}
2658 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2659 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2660 @code{\with}. Dans le cas où il est stipulé au fil des notes, c'est la
2661 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2662 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2663 de la commande @code{\overrideProperty} :
2666 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2669 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2672 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2676 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2677 #'((alignment-distances . (15)))
2679 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2682 (alignment-distances . (15)))
2685 Nous allons maintenant voir ces différents réglages en action.
2686 Commençons par examiner un exemple dépourvu de toute mise au point.
2688 @c \book { } is required in these examples to ensure the spacing
2689 @c overrides can be seen between systems. -np
2691 @lilypond[verbatim,quote,staffsize=16]
2692 \header { tagline = ##f }
2693 \paper { left-margin = 0\mm }
2703 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2706 \repeat unfold 15 { d'4 d' d' d' }
2713 Cette partition isole les informations de saut de ligne ou de page dans
2714 une voix spécifique. La mise en forme est ainsi séparée des événements
2715 musicaux ; ceci nous permettra d'y voir plus clair au fur et à
2716 mesure que nous avancerons. Pour plus de précisions, relisez
2717 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2719 Les @code{\break} explicites répartissent la musique en lignes de six
2720 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2721 par défaut. Nous pouvons, afin de fixer explicitement le point
2722 d'attache vertical de chacun des systèmes, définir un doublet
2723 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2724 de l'objet @code{NonMusicalPaperColumn} :
2726 @lilypond[verbatim,quote,staffsize=16]
2727 \header { tagline = ##f }
2728 \paper { left-margin = 0\mm }
2734 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2737 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2740 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2744 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2747 \repeat unfold 15 { d'4 d' d' d' }
2754 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2755 si la liste associative de @code{line-break-system-details} peut en
2756 comporter un certain nombre. Vous aurez aussi noté que la propriété
2757 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2760 Maintenant que chaque système est explicitement positionné, nous pouvons
2761 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2762 à la sous-propriété @code{alignment-distances} de
2763 @code{line-break-system-details}.
2765 @lilypond[verbatim,quote,staffsize=16]
2766 \header { tagline = ##f }
2767 \paper { left-margin = 0\mm }
2773 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2775 (alignment-distances . (10)))
2777 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2779 (alignment-distances . (15)))
2781 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2783 (alignment-distances . (20)))
2786 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2789 \repeat unfold 15 { d'4 d' d' d' }
2796 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2797 @code{line-break-system-details} de l'objet
2798 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2799 prendre bien d'autres paramètres d'espacement, y compris un doublet
2800 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2801 @code{alignment-distances} pour contrôler le positionnement de chaque
2802 système et de chaque portée. Vous noterez enfin que
2803 @code{alignment-distances} traite le positionnement des portées, non
2804 d'un regroupement de portées.
2806 @lilypond[verbatim,quote,staffsize=16]
2807 \header { tagline = ##f }
2808 \paper { left-margin = 0\mm }
2814 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2816 (alignment-distances . (30 10)))
2818 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2820 (alignment-distances . (10 10)))
2822 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2824 (alignment-distances . (10 30)))
2827 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2830 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2831 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2838 Quelques points à prendre en considération :
2842 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2843 autres lignes de non-portée ne comptent pas pour une portée.
2846 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2847 @code{alignment-distances} sont considérés comme des multiples de la
2848 distance entre des portées adjacentes. Des valeurs positives remontent
2849 les portées et paroles, des valeurs négatives les descendent.
2852 Dans la mesure où @code{NonMusicalPaperColumn.line-break-system-details}
2853 permet de positionner systèmes et portées n'importe où sur une page,
2854 vous pourriez être en contradiction avec les dimensionnements de la
2855 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2856 quant aux différentes valeurs que vous affectez à ces réglages.
2862 @rlsrnamed{Spacing,Espacements}.
2865 @node Résolution des collisions verticales
2866 @subsection Résolution des collisions verticales
2867 @translationof Vertical collision avoidance
2869 @funindex outside-staff-priority
2870 @funindex outside-staff-padding
2871 @funindex outside-staff-horizontal-padding
2873 Vous savez de manière intuitive qu'un certain nombre d'objets en
2874 matière de notation musicale appartiennent à la portée, et que
2875 d'autres se placent en dehors de la portée. Entre autres objets
2876 externes, nous avons les marques repères, les textes et les
2877 nuances ; nous les appellerons @qq{objets extérieurs à la portée}.
2878 La règle adoptée par LilyPond pour positionner verticalement ces
2879 objets extérieurs consiste à les placer au plus près de la portée
2880 tout en prenant garde d'éviter qu'il y ait chevauchement.
2882 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2883 déterminer si un objet est ou non un objet extérieur à la portée :
2884 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2885 s'agit d'un objet extérieur à la portée. De plus, la propriété
2886 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2887 objets doivent être disposés.
2889 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2890 Les objets extérieurs à la portée sont alors triés selon l'ordre
2891 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2892 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2893 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2894 lorsque deux objets devraient se placer au même endroit, celui dont la
2895 @code{outside-staff-priority} est la plus faible sera disposé au plus
2898 @lilypond[quote,ragged-right,relative=2,verbatim]
2901 \once \override TextScript.outside-staff-priority = #1
2902 c4_"Text"\pp % this time the text will be closer to the staff
2904 % by setting outside-staff-priority to a non-number,
2905 % we disable the automatic collision avoidance
2906 \once \override TextScript.outside-staff-priority = ##f
2907 \once \override DynamicLineSpanner.outside-staff-priority = ##f
2908 c4_"Text"\pp % now they will collide
2911 Le décalage vertical entre des objets extérieurs à la portée se contrôle
2912 par la propriété @code{outside-staff-padding}.
2915 @lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
2916 \once \override TextScript.outside-staff-padding = #0
2917 a'4-"outside-staff-padding = #0"
2918 \once \override TextScript.outside-staff-padding = #3
2919 d-"outside-staff-padding = #3"
2920 c-"outside-staff-padding par défaut"
2921 b-"outside-staff-padding par défaut"
2925 Par défaut, les objets extérieurs à la portée sont positionnés en
2926 évitant les collisions horizontales avec des objets précédemment
2927 positionnés. Ceci peut cependant générer des situations où des objets
2928 se trouvent horizontalement trop proches. Comme l'illustre l'exemple
2929 suivant, la propriété @code{outside-staff-horizontal-padding} permet
2930 d'accroître l'espace horizontal requis et repoussera verticalement un
2931 objet pour éviter qu'il ne soit trop proche d'ventuelles lignes
2934 @lilypond[quote,ragged-right,relative=2,verbatim]
2937 \once \override TextScript.outside-staff-horizontal-padding = #1
2943 @rlsrnamed{Spacing,Espacements}.
2946 @node Espacement horizontal
2947 @section Espacement horizontal
2948 @translationof Horizontal spacing
2950 @cindex horizontal, espacement
2951 @cindex espacement horizontal
2954 * Généralités sur l'espacement horizontal::
2955 * Changement d'espacement en cours de partition::
2956 * Modification de l'espacement horizontal::
2957 * Longueur de ligne::
2958 * Notation proportionnelle::
2962 @node Généralités sur l'espacement horizontal
2963 @subsection Généralités sur l'espacement horizontal
2964 @translationof Horizontal spacing overview
2966 Le moteur d'espacement traduit les différences de durée en distances
2967 étirables (@emph{springs} pour ressorts) de différentes longueurs. Des
2968 durées importantes prennent ainsi plus de place que des durées moins
2969 longues. Les durées les plus courtes se verront attribuer un espace
2970 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2971 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2972 plus elle prendra d'espace : le doublement d'une durée attribuera à
2973 la note un espace fixé d'après la propriété @code{spacing-increment}.
2975 L'exemple suivant comporte des blanches, des noires et un certain nombre
2976 de croches. La croche est suivie d'un espace de la largeur d'une tête
2977 de note ; pour la noire , cet espace est de deux têtes ; il
2978 est de trois pour la blanche.
2980 @lilypond[quote,verbatim,relative=1]
2986 @code{spacing-increment} est normalement défini à 1,2 espace de
2987 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2988 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2989 s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
2990 @code{spacing-increment}). Le point de départ de cet espace se situe à
2991 l'extrémité gauche du symbole ; la note la plus courte est donc
2992 suivie en général d'un espace égal à la largeur d'une tête de note.
2994 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2995 croche à une partition qui comporte déjà des croches et des doubles
2996 augmentera considérablement son volume : la durée la plus
2997 courte n'est plus la double mais la triple croche, ce qui aura
2998 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2999 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
3000 courte prise en considération au niveau de l'espacement n'est pas la
3001 note la plus brève de la partition, mais celle qui apparaît le plus
3004 La courte durée la plus fréquente est déterminée à partir de la note la
3005 plus courte de chaque mesure. C'est elle qui servira de base pour
3006 l'espacement, à cette nuance près que la plus courte durée ne saurait
3007 être strictement supérieure à la croche. Cette @qq{durée de référence}
3008 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
3011 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
3012 pour les espacements grâce à la propriété
3013 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
3014 La durée maximale de cet étalon, normalement la croche, est gérée par la
3015 propriété @code{base-shortest-duration}.
3017 @funindex common-shortest-duration
3018 @funindex base-shortest-duration
3019 @funindex stem-spacing-correction
3022 Les notes plus courtes que la note témoin sont suivies d'un espace
3023 proportionnel à la durée témoin. Si donc nous ajoutions quelques
3024 doubles croches à l'exemple précédent, elles seraient suivies d'une
3025 demie largeur de tête :
3027 @lilypond[quote,verbatim,relative=2]
3028 c2 c4. c8 | c4. c16[ c] c4. c8 | c8 c c4 c c
3031 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
3032 vu comment la direction des hampes peut influencer l'espacement -- voir
3033 @ressay{Espacement}. Ceci est contrôlé par la propriété
3034 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
3035 pour chaque contexte @rinternals{Voice}. L'objet
3036 @code{StaffSpacing}, généré au niveau d'un contexte @rinternals{Staff},
3037 possède une même propriété qui contrôlera l'espacement hampe-barre de
3038 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
3039 les réglages par défaut, puis avec des corrections forcées.
3041 @lilypond[quote,ragged-right]
3045 \override Staff.NoteSpacing.stem-spacing-correction = #1.5
3046 \override Staff.StaffSpacing.stem-spacing-correction = #1.5
3052 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
3053 @rusernamed{Notation proportionnelle,rubrique dédiée}.
3056 Essai sur la gravure musicale automatisée :
3057 @ressay{Espacement}.
3060 @rlsrnamed{Spacing,Espacements}.
3062 Référence des propriétés internes :
3063 @rinternals{SpacingSpanner},
3064 @rinternals{NoteSpacing},
3065 @rinternals{StaffSpacing},
3066 @rinternals{NonMusicalPaperColumn}.
3069 Il n'existe pas de mécanisme simple et efficace qui permette de
3070 forcer manuellement l'espacement. La solution ci-dessous permet
3071 cependant @qq{d'aérer} artificiellement une partition ; il vous
3072 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
3076 \override Score.NonMusicalPaperColumn.padding = #10
3079 Il n'y a aucun moyen de diminuer l'espacement.
3082 @node Changement d'espacement en cours de partition
3083 @subsection Changement d'espacement en cours de partition
3084 @translationof New spacing area
3086 @cindex espacement, modification en cours de partition
3087 @cindex notes, espacement horizontal
3088 @funindex \newSpacingSection
3090 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
3091 substantiellement la notion de valeur brève et valeur longue. La
3092 commande @code{newSpacingSection} permet alors de réinitialiser les
3093 paramètres d'espacement.
3095 Dans l'exemple qui suit, le changement de métrique marque le début
3096 d'une nouvelle partie ; remarquez comme les doubles-croches sont
3097 alors automatiquent un peu plus espacées :
3099 @lilypond[relative,verbatim,quote]
3102 c8 c c4 c16[ c c8] c4
3108 La commande @code{\newSpacingSection} crée un nouvel objet
3109 @code{SpacingSpanner} à cet instant musical. Si toutefois les
3110 ajustements apportés à l'espacement automatique ne se révélent pas
3111 satisfaisants, ils peuvent s'adapter à l'aide d'@code{\override}s. Ces
3112 amendements doivent intervenir au même moment que la commande
3113 @code{\newSpacingSection} ; ils produiront leurs effets jusqu'à ce
3114 qu'ils soient à nouveau modifiés par une nouvelle section, comme ici :
3116 @lilypond[relative=1,verbatim,quote]
3120 \override Score.SpacingSpanner.spacing-increment = #2
3123 \revert Score.SpacingSpanner.spacing-increment
3129 @rlsrnamed{Spacing,Espacements}.
3131 Référence des propriétés internes :
3132 @rinternals{SpacingSpanner}.
3135 @node Modification de l'espacement horizontal
3136 @subsection Modification de l'espacement horizontal
3137 @translationof Changing horizontal spacing
3139 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
3140 @code{base-shortest-duration}. Comparons les deux partitions qui
3141 suivent, toutes deux montrant la même musique. La première partition
3142 applique les réglages par défaut, alors que la seconde bénéficie d'un
3143 ajustement de la propriété @code{base-shortest-duration}. Au plus la
3144 valeur de @code{ly:make-moment} est grande, au plus la musique sera
3145 resserrée. En effet, @code{ly:make-moment} construit une durée :
3146 @code{1 4} est plus long que @code{1 16}.
3148 @lilypond[verbatim,line-width=12\cm]
3151 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3152 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3153 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3154 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3159 @lilypond[verbatim,line-width=12\cm]
3162 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3163 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3164 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3165 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3170 \override SpacingSpanner.base-shortest-duration = #(ly:make-moment 1/16)
3177 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
3178 facteurs qui ne sont pas liés à la durée (altération, changement de
3179 clef, etc.). @code{Score.SpacingSpanner.uniform-stretching}
3180 permet d'ignorer ces symboles et, par voie de conséquence, de forcer
3181 l'espacement sur la simple durée. Notez bien que cette propriété
3182 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
3185 @lilypond[quote,ragged-right,verbatim]
3189 \tuplet 5/4 { c8 c8 c8 c8 c8 } c8 c8 c8 c8
3192 c8 c8 c8 c8 \tuplet 5/4 { c8 c8 c8 c8 c8 }
3198 \override SpacingSpanner.uniform-stretching = ##t
3204 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
3205 les notes sans tenir compte des clefs, barres de mesure ou notes
3206 d'ornement qui pourraient apparaître :
3208 @lilypond[quote,ragged-right,relative=2,verbatim]
3209 \override Score.SpacingSpanner.strict-note-spacing = ##t
3210 \new Staff { c8[ c \clef alto c \grace { c16 c } c8 c c] c32[ c] }
3215 @rlsrnamed{Spacing,Espacements}.
3218 @node Longueur de ligne
3219 @subsection Longueur de ligne
3220 @translationof Line length
3222 @cindex saut de page
3224 @cindex ligne, longueur
3227 @funindex line-width
3228 @funindex ragged-right
3229 @funindex ragged-last
3231 @c Although line-width can be set in \layout, it should be set in paper
3232 @c block, to get page layout right.
3233 @c Setting indent in \paper block makes not much sense, but it works.
3235 @c Bit verbose and vague, use examples?
3236 Deux réglages de base ont une influence considérable sur
3237 l'espacement : @code{line-width} et @code{indent}. Tous deux se
3238 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3239 lignes et l'indentation de la première.
3241 L'activation du commutateur @code{ragged-right} au sein du bloc
3242 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3243 de les voir s'étirer sur toute la largeur de la page. Cette option est
3244 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3245 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3246 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3249 @cindex page, mise en forme
3250 @cindex vertical, espacement
3252 Le fonctionnement de l'option @code{ragged-last} est en tout point
3253 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3254 que la dernière ligne de la partition. Il n'y a pas de restriction
3255 quant à cette ligne. Il en va de même que pour le formatage d'un
3256 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3258 @c Note that for text there are several options for the last line.
3259 @c While Knuth TeX uses natural length, lead typesetters use the same
3260 @c stretch as the previous line. eTeX uses \lastlinefit to
3261 @c interpolate between both these solutions.
3273 @rlsrnamed{Spacing,Espacements}.
3276 @node Notation proportionnelle
3277 @subsection Notation proportionnelle
3278 @translationof Proportional notation
3280 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3281 ce cas de représenter la notation selon un espacement strictement
3282 relatif aux durées. Ce type d'espacement pourrait se comparer à
3283 l'utilisation de papier millimétré pour positionner les notes au fil de
3284 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3285 utilisent cette proportionnalité dans le but de clarifier des structures
3286 rythmiques complexes, d'aider au positionnement d'indications
3287 temporelles ou autres éléments graphiques directement dans la partition.
3289 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3290 s'utiliser conjointement ou individuellement, aux fins de mettre au
3291 point cette notation proportionnelle.
3294 @item @code{proportionalNotationDuration}
3296 @item @code{uniform-stretching}
3298 @item @code{strict-note-spacing}
3300 @item @code{\remove "Separating_line_group_engraver"}
3302 @item @code{\override PaperColumn.used = ##t}
3306 Nous allons examiner, dans les différents exemples qui suivent, les
3307 effets de ces réglages et comment ils interagissent.
3309 Commençons par cette mesure toute simple qui utilise l'espacement
3310 classique et justifiée à gauche.
3312 @lilypond[quote,verbatim,ragged-right]
3315 \new RhythmicStaff {
3316 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3322 Vous constatez que la blanche qui entame la mesure prend moins de la
3323 moitié de l'espace. De même, les doubles croches et le quintolet de
3324 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3325 n'en occupent pas la moitié de l'espace horizontal.
3327 En matière de gravure traditionnelle, cet espacement correspond tout à
3328 fait à nos attentes, puisque nous pouvons rogner de l'espace sur la
3329 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3332 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3333 un autre graphisme en surplomb ou en dessous de notre partition, nous
3334 aurons besoin de la notation proportionnelle. Celle-ci s'active en
3335 définissant la propriété @code{proportionalNotationDuration}.
3337 @lilypond[quote,verbatim,ragged-right]
3340 \new RhythmicStaff {
3341 c'2 c'16 c' c' c' \tuplet 5/4 { c' c' c' c' c' }
3347 proportionalNotationDuration = #(ly:make-moment 1/20)
3353 La blanche du début et les notes plus rapides de la deuxième moitié de
3354 la mesure occupent maintenant exactement le même espace horizontal.
3355 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3356 temporelle ou autre graphisme.
3358 @code{proportionalNotationDuration} est une propriété attachée au
3359 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3360 propriétés d'un contexte à trois différents endroits de votre
3361 fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
3362 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3363 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3364 de ces trois façons, à l'instar de n'importe quelle définition de
3367 La propriété @code{proportionalNotationDuration} prend en unique
3368 argument la durée de référence qui servira de base pour espacer toute la
3369 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3370 prend deux arguments : un numérateur et un dénominateur qui
3371 représentent une fraction de ronde. L'appel de
3372 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3373 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3374 @code{(ly:make-moment 1/16)}, @code{(ly:make-moment 1/8)} ou
3375 @code{(ly:make-moment 3/97)}.
3377 Se pose alors le problème de fournir la juste durée de référence à
3378 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3379 tâtonnement, en commençant par une valeur proche de la note la plus
3380 rapide (la durée la plus courte) du morceau. Au plus la durée de
3381 référence est petite, au plus la musique sera étalée ; à l'inverse,
3382 une durée de référence élevée produira une musique resserrée.
3384 @lilypond[quote,verbatim,ragged-right]
3387 \new RhythmicStaff {
3388 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3394 proportionalNotationDuration = #(ly:make-moment 1/8)
3401 \new RhythmicStaff {
3402 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3408 proportionalNotationDuration = #(ly:make-moment 1/16)
3415 \new RhythmicStaff {
3416 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3422 proportionalNotationDuration = #(ly:make-moment 1/32)
3428 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3429 comme la croche pour la première ligne, a pour conséquence de resserrer
3430 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3431 remarquez aussi que, par principe, la notation proportionnelle occupe
3432 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3433 notation proportionnelle met en évidence le rythme au détriment de
3434 l'espacement horizontal.
3436 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3439 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3440 ajoutons lui une portée incluant un autre type de nolet.
3442 @lilypond[quote,verbatim,ragged-right]
3445 \new RhythmicStaff {
3446 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3448 \new RhythmicStaff {
3449 \tuplet 9/8 { c'8 c' c' c' c' c' c' c' c' }
3455 L'espacement est loin d'être idéal, pour la simple raison que
3456 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3457 uniformément. Il est vrai que de telles constructions complexes en
3458 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3459 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3460 @code{proportionalNotationDuration} permet d'arranger les choses.
3462 @lilypond[quote,verbatim,ragged-right]
3465 \new RhythmicStaff {
3466 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3468 \new RhythmicStaff {
3469 \tuplet 9/8 { c'8 c' c' c' c' c' c' c' c' }
3475 proportionalNotationDuration = #(ly:make-moment 1/20)
3481 Cependant, si l'on observe de près, il est évident que les notes de la
3482 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3483 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3484 allons activer le @code{uniform-stretching}, propriété attachée au
3485 @code{SpacingSpanner}.
3487 @lilypond[quote,verbatim,ragged-right]
3490 \new RhythmicStaff {
3491 c'2 c'16 c' c' c' \tuplet 5/4 { c'16 c' c' c' c' }
3493 \new RhythmicStaff {
3494 \tuplet 9/8 { c'8 c' c' c' c' c' c' c' c' }
3500 proportionalNotationDuration = #(ly:make-moment 1/20)
3501 \override SpacingSpanner.uniform-stretching = ##t
3507 L'espacement sur les deux portées est maintenant correct, les relations
3508 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3509 une indication temporelle ou autre graphisme selon notre envie.
3511 Notez bien que la prise en charge de la notation proportionnelle par
3512 LilyPond demande que, dans chaque partition, soit activée la propriété
3513 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3514 contraire, utiliser @code{proportionalNotationDuration} aura pour
3515 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3516 inséré des silences invisibles @emph{skip}.
3518 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3519 au contexte @code{Score}. Tout comme pour la propriété
3520 @code{proportionalNotationDuration}, les réglages du
3521 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3522 votre fichier : dans un bloc @code{\with}, dans un bloc
3523 @code{\context} ou au beau milieu de la musique à l'aide de la
3524 commande @code{\set}.
3526 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3527 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3528 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3529 partition. Vous pourriez toutefois avoir besoin de modifier ce
3530 comportement en cours de partition, et recourir alors à l'instruction
3531 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3532 rubrique @ref{Changement d'espacement en cours de partition}.
3534 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3535 qui est désactivé pour la plupart des partitions en notation
3536 proportionnelle. Voici ce qui apparaît dans une partition
3537 traditionnelle : il y a toujours un @qq{espace préservé} juste
3538 avant la première note de chaque portée.
3540 @lilypond[quote,verbatim,ragged-right]
3552 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3553 présent lorsqu'intervient un changement de métrique, d'armure ou de
3554 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3555 réduire cet espace à zéro.
3557 @lilypond[quote,verbatim,ragged-right]
3563 \remove "Separating_line_group_engraver"
3571 Les éléments non musicaux tels que métrique, armure, clef et
3572 altérations, posent problème lorsqu'on travaille en notation
3573 proportionnelle. Bien qu'aucune notion de durée ne leur soit
3574 attachée, ces éléments @qq{consomment} de l'espace. Différentes
3575 approches permettent cependant de gérer ce problème.
3577 Éviter les problèmes d'espacement avec l'armure est chose aisée :
3578 il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
3579 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3580 proportionnelle. Il en va de même pour la métrique, et tout
3581 particulièrement lorsque la partition comporte un quadrillage temporel
3582 ou autres graphismes. L'absence de métrique reste cependant
3583 exceptionnelle et la plupart des partitions en notation proportionnelle
3584 laissent apparaître quelques métriques. Il est par contre pratiquement
3585 impossible de se passer de clef et d'altération.
3587 L'une des options permettant de s'affranchir de l'espacement dû aux
3588 éléments non musicaux consiste en l'activation de la propriété
3589 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3590 les deux portées suivantes :
3592 @lilypond[quote,verbatim,ragged-right]
3594 \set Score.proportionalNotationDuration = #(ly:make-moment 1/16)
3595 c''8 c'' c'' \clef alto d' d'2
3599 \set Score.proportionalNotationDuration = #(ly:make-moment 1/16)
3600 \override Score.SpacingSpanner.strict-note-spacing = ##t
3601 c''8 c'' c'' \clef alto d' d'2
3605 Toutes deux affichent un espacement proportionnel. Cependant, la
3606 première ligne laisse apparaître un espacement plus lâche en raison de
3607 la présence d'un changement de clef. En ce qui concerne la deuxième
3608 ligne, l'espacement est strictement observé dès lors que la propriété
3609 @code{strict-note-spacing} a préalablement été activée. Comme vous
3610 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3611 conséquence que l'algorithme d'espacement ignore tout bonnement la
3612 largeur des métriques, armures, clefs et altérations.
3614 En plus de ceux que nous venons de voir, vous trouverez d'autres
3615 réglages en usage dans la notation proportionnelle comme, entre autres,
3618 @item @code{\override SpacingSpanner.strict-grace-spacing = ##t}
3619 @item @code{\set tupletFullLength = ##t}
3620 @item @code{\override Beam.breakable = ##t}
3621 @item @code{\override Glissando.breakable = ##t}
3622 @item @code{\override TextSpanner.breakable = ##t}
3623 @item @code{\remove "Forbid_line_break_engraver"} (dans un contexte de voix)
3626 Ces différents réglages permettent un espacement strict des notes
3627 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3628 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3629 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3630 différentes rubriques associées du manuel pour chacun de ces réglages.
3633 Manuel de notation :
3634 @ref{Changement d'espacement en cours de partition}.
3637 @rlsrnamed{Spacing,Espacements}.
3640 @node Réduction du nombre de pages de la partition
3641 @section Réduction du nombre de pages de la partition
3642 @translationof Fitting music onto fewer pages
3644 Vous pourriez un jour être confronté au problème suivant : l'une
3645 des pages de votre partition ne comporte que deux portées alors que,
3646 ce qui est d'autant plus frustrant, l'espace libre sur les autres
3647 pages aurait permis une distribution différente.
3649 L'instruction @code{annotate-spacing} se révèle être un outil
3650 indispensable pour l'analyse des problèmes de mise en forme. Cette
3651 commande met en surimpression la valeur des différentes variables
3652 d'espacement et de mise en forme, comme nous allons le voir dans la
3653 rubrique @ref{Mise en évidence de l'espacement}.
3656 * Mise en évidence de l'espacement::
3657 * Modification de l'espacement::
3661 @node Mise en évidence de l'espacement
3662 @subsection Mise en évidence de l'espacement
3663 @translationof Displaying spacing
3665 @cindex espacement, affichage des valeurs
3666 @funindex annotate-spacing
3668 Le meilleur moyen d'appréhender les différentes variables de
3669 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3670 la mise en page consiste à activer, au sein du bloc @code{\paper}, la
3671 fonction @code{annotate-spacing} :
3673 @lilypond[verbatim,quote,papersize=a6landscape]
3676 \paper { annotate-spacing = ##t }
3681 Toutes les dimensions sont exprimées en espace de portée
3682 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3683 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3684 feuille (@code{paper-height}) est de 59,75 espaces de portée
3685 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3686 20 points -- sa valeur par défaut. Notez que :
3688 @multitable {1 staff-space} {(staff-size)/4 * (25,4/72,27) mm}
3691 @tab = (25,4/72,27) mm
3694 @tab = (@code{staff-size})/4 pts
3696 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3701 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3702 1,757 millimètres. Les 59,75 @code{staff-spaces} de
3703 @code{paper-height} correspondent donc à 105 millimètres, soit la
3704 hauteur d'une feuille au format A6 à l'italienne. Les paires
3705 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3706 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3709 Manuel de notation :
3710 @ref{Définition de la taille de portée}.
3713 @rlsrnamed{Spacing,Espacements}.
3716 @node Modification de l'espacement
3717 @subsection Modification de l'espacement
3718 @translationof Changing spacing
3720 Les informations fournies par @code{annotate-spacing} en matière de
3721 dimensionnement vertical sont incomparables. Pour plus de détails sur
3722 les manières de modifier marges et autres variables connexes, consultez
3723 la rubrique @ref{Mise en forme de la page}.
3725 En dehors des marges, vous disposez de quelques moyens supplémentaires
3726 pour gagner de l'espace :
3730 Rapprocher les systèmes le plus possible les uns des autres, de telle
3731 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3732 suffisamment pour éviter le blanc en bas de page.
3736 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3737 ragged-last-bottom = ##f
3743 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3744 deux titres. D'une part, le fait de définir un nombre de systèmes --
3745 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3746 systèmes par page dans la mesure où l'une des étapes d'estimation des
3747 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3748 systèmes par page permet d'en disposer plus sur les suivantes. Par
3749 exemple, avec un nombre par défaut de 11 systèmes par pages,
3750 l'instruction suivante le force à 10.
3759 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3760 se répartir sur deux pages.
3769 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3770 Par exemple, un crochet de reprise ou d'alternative consomme de
3771 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3772 diminue d'autant l'espace disponible que si seul le premier ne
3773 comportait l'indication. Autre exemple, les indications de nuance qui
3774 se @qq{détachent} d'un système peuvent être rapprochées de la portée :
3776 @lilypond[verbatim,quote,relative=1]
3778 e4 c g-\tweak X-offset #-2.7 \f c
3782 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3783 comme indiqué à la rubrique
3784 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3785 l'espacement par défaut :
3787 @lilypond[verbatim,quote]
3800 Par contre, le fait de modifier la valeur de la propriété
3801 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3802 -- bien que la noire soit la durée la plus courante, nous prenons une
3803 valeur plus longue -- donnera un effet @qq{resserré} à la musique :
3805 @lilypond[verbatim,quote]
3817 \override SpacingSpanner.common-shortest-duration =
3818 #(ly:make-moment 1/2)
3825 La propriété @code{common-shortest-duration} ne peut être modifiée
3826 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3827 s'applique à l'intégralité de la partition.
3832 Manuel de notation :
3833 @ref{Mise en forme de la page},
3834 @ref{Modification de l'espacement horizontal}.
3837 @rlsrnamed{Spacing,Espacements}.