1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: e2d37f01e17101b7986c07ac41f7b00bdc590adf
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 l'intégralité du document -- à toutes les partitions 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 Un bloc @code{\paper} peut apparaître au sein d'un bloc @code{\book}.
124 Les réglages effectués à l'aide du bloc @code{\paper} s'appliqueront à
125 l'intégralité d'un ouvrage, qui peut comporter plusieurs partitions (des
126 blocs @emph{score}) ; il ne doit donc en aucun cas se trouver dans un
127 bloc @code{\score}. Peuvent apparaître dans un bloc @code{\paper} :
132 la fonction Scheme @code{set-paper-size},
135 des variables propres au bloc @code{\paper} qui viendront adapter la
139 la définition des différents @emph{markups} qui personnaliseront la mise
140 en forme des entêtes et pieds de page ainsi que des titrages.
144 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
145 -- @ref{Format du papier et adaptation automatique}. Les variables du
146 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
147 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
148 des entête, pied de page et titrage, elles sont étudiées à la rubrique
149 @ref{Titrages personnalisés}.
151 La plupart des variables gérant le papier ne sont fonctionnelles que
152 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
153 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
154 rubrique @ref{Le bloc \layout}.
156 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
157 correspondent à des dimensions sont exprimées en millimètre -- vous
158 pouvez bien entendu spécifier un autre système de mesure. Voici
159 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
168 Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
169 mentionner le suffixe d'unité @code{\in} :
177 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
178 @code{\in} et @code{\pt}. Ces unités sont des conversions de
179 millimètres, répertoriées dans le fichier
180 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
181 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
182 @code{\mm} à votre code lorsque vous travaillez en millimètres.
184 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
185 fonctions Scheme. Voici l'équivalent de l'exemple précédent :
189 #(define top-margin (* 0.5 in))
195 @ref{Format du papier et adaptation automatique},
196 @ref{Titrages personnalisés}.
197 @ref{Le bloc \layout}.
199 Fichiers d'initialisation :
200 @file{ly/paper-defaults-init.ly}.
203 @node Format du papier et adaptation automatique
204 @subsection Format du papier et adaptation automatique
205 @translationof Paper size and automatic scaling
207 @cindex papier, taille
214 * Adaptation automatique au format::
218 @node Format du papier
219 @unnumberedsubsubsec Format du papier
220 @translationof Setting the paper size
222 LilyPond génère par défaut, et en l'absence de mention explicite d'un
223 format de papier particulier, un fichier imprimable au format A4.
224 Vous pouvez cependant utiliser un autre format à l'aide des deux
225 fonctions @code{set-default-paper-size} et @code{set-paper-size}
226 qui, elle, se place à l'intérieur d'un bloc @code{\paper} :
229 #(set-default-paper-size "quarto")
232 qui se place en début de fichier, ou @code{set-paper-size},
236 #(set-paper-size "tabloid")
240 qui s'inscrit au sein d'un bloc @code{\paper}.
243 La seule restriction à l'utilisation isolée de la fonction
244 @code{set-default-paper-size} est qu'elle doit intervenir avant le
245 premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
246 format pour toutes les pages, alors que @code{set-paper-size} détermine
247 le format des feuilles rattachées à un bloc @code{\paper} particulier.
248 Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
249 format du papier s'appliquera à toutes les pages ; si @code{\paper}
250 apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
251 @emph{book} en question.
253 À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
254 doit intervenir avant toute autre variable. Les raisons à ceci sont
255 abordées à la rubrique @ref{Adaptation automatique au format}.
257 Différents formats de papier sont définis dans le fichier
258 @file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
259 format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
260 LilyPond. Les différents formats disponibles sont répertoriés à
261 l'annexe @ref{Formats de papier prédéfinis}.
263 @c An appendix entry exists for paper sizes but is not auto-generated
265 La commande suivante, inscrite dans votre fichier, vous permettra
266 d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
267 appel à l'aide des fonctions @code{set-default-paper-size} et
268 @code{set-paper-size} :
271 #(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
274 #(set-paper-size "mon format")
278 Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
279 @code{cm} (centimètres) ou @code{mm} (millimètres).
281 @cindex papier, orientation
282 @cindex landscape, papier
283 @cindex paysage, papier
284 @cindex à l'italienne, papier
286 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
287 stipulant le format du papier permet d'obtenir une présentation à
288 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
292 #(set-default-paper-size "a6" 'landscape)
295 L'inversion des dimensions du papier sans pour autant basculer la
296 présentation -- comme pour imprimer sur une carte postale ou créer un
297 graphique destiné à inclusion -- s'obtient en ajoutant @samp{landscape}
298 au nom du format de papier :
301 #(set-default-paper-size "a6landscape")
304 Lorsque la taille du papier comporte explicitement @samp{landscape} ou
305 @samp{portrait}, la présence d'un argument @code{'landscape} aura pour
306 seul effet de modifier l'orientation de l'image et non les dimensions de
311 @ref{Adaptation automatique au format},
312 @ref{Formats de papier prédéfinis}.
314 Fichiers d'initialisation :
315 @file{scm/paper.scm}.
318 @node Adaptation automatique au format
319 @unnumberedsubsubsec Adaptation automatique au format
320 @translationof Automatic scaling to paper size
322 Toute modification du format de papier à l'aide des fonctions Scheme
323 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
324 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
325 par l'ajustement d'un certain nombre de variables attachées au bloc
326 @code{\paper} afin qu'elles soient en concordance avec le format
327 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
328 particulière en redéfinissant sa valeur après avoir spécifié le format
329 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
330 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
331 l'étalonnage automatique, bien que spécifier une largeur de papier
332 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
333 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
334 voir avec la mise à l'échelle.
336 L'adaptation automatique affecte les dimensionnements verticaux
337 @code{top-margin} et @code{bottom-margin} -- voir
338 @ref{Variables d'espacement vertical fixe} --, ainsi que les
339 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
340 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
341 @code{indent} et @code{short-indent} -- voir
342 @ref{Variables d'espacement horizontal}.
344 Les valeurs par défaut de ces dimensionnements sont contenues dans le
345 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
346 internes @code{top-margin-default}, @code{bottom-margin-default}, etc.
347 correspondant au format par défaut -- papier A4 -- pour lequel
348 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
353 @ref{Variables d'espacement vertical fixe},
354 @ref{Variables d'espacement horizontal}.
356 Fichiers d'initialisation :
357 @file{ly/paper-defaults-init.ly},
358 @file{scm/paper.scm}.
361 @node Variables d'espacement vertical fixe
362 @subsection Variables d'espacement vertical fixe
363 @translationof Fixed vertical spacing \paper variables
365 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
366 sont automatiquement ajustés selon le format du papier, ce qui peut
367 conduire à un résultat inattendu --
368 voir @ref{Adaptation automatique au format}.}
370 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
371 @file{ly/paper-defaults-init.ly}.
375 @funindex paper-height
377 La hauteur de la feuille. Il s'agit par défaut de la dimension du
378 papier utilisé. Notez bien que cette variable n'affectera pas
379 l'ajustement automatique d'un certain nombre de dimensionnements
385 La marge entre le bord supérieur de la feuille et la surface imprimable.
386 Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
390 @funindex bottom-margin
392 La marge entre la surface imprimable et le bord inférieur de la feuille.
393 Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
397 @funindex ragged-bottom
399 L'activation de cette variable permet de ne pas répartir verticalement
400 les systèmes sur les pages hormis la dernière. La valeur par défaut
401 est @code{#f}. Lorsque la partition ne comporte que deux ou trois
402 systèmes par page, comme pour un conducteur d'orchestre, nous vous
403 conseillons d'activer cette variable.
405 @item ragged-last-bottom
406 @funindex ragged-last-bottom
408 La désactivation de cette variable permet de répartir verticalement les
409 systèmes de la dernière page d'une partition. La valeur par défaut
410 est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
411 deux pages ou plus, de désactiver cette variable.@*
412 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
413 dernière page de chacune des parties -- créées à l'aide d'un bloc
414 @code{\bookpart} -- d'un même ouvrage.
420 @ref{Adaptation automatique au format}.
422 Fichiers d'initialisation :
423 @file{ly/paper-defaults-init.ly}.
426 @rlsrnamed{Spacing, Espacements}.
429 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
430 comme des systèmes à part entière ; ils seront donc affectés par
431 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
432 ajouteront de l'espace avant le premier système de la partition.
434 La définition explicite d'un format de papier annulera tout réglage des
435 marges haute et basse.
438 @node Variables d'espacement vertical fluctuant
439 @subsection Variables d'espacement vertical fluctuant
440 @translationof Flexible vertical spacing \paper variables
442 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
443 entre différents éléments (marges, titres, systèmes ou mouvements), en
444 dilatation ou compression selon le cas. Un certain nombre de variables
445 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
446 ces dimensionnements.
448 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
449 parlons ici n'influencent en rien l'espacement des portées d'un même
450 système. L'espacement au sein des systèmes est géré par des propriétés
451 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
452 définissent au niveau du bloc @code{\score} -- voir à ce sujet
453 @ref{Espacement vertical au sein d'un système}.
456 * Structure des variables d'espacement vertical fluctuant::
457 * Liste des variables d'espacement vertical fluctuant::
461 @node Structure des variables d'espacement vertical fluctuant
462 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
463 @translationof Structure of flexible vertical spacing alists
465 Chacune de ces variables attachées au bloc @code{\paper} est constituée
466 d'une liste associative @emph{(alist)} à quatre @i{clés} :
471 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
472 par défaut, exprimée en hauteur de portée, séparant les @i{points de
473 référence} de deux éléments, qui évite tout risque de collision en
474 l'absence de dilatation ou compression. Le point de référence d'un
475 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
476 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
477 ligne de @qq{non-portée} viendrait à s'intercaler. Une
478 @code{basic-distance} inférieure à @code{padding} ou
479 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
480 résultant ne saurait être inférieur à @code{padding} ou
481 @code{minimum-distance}.
484 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
485 minimal, exprimé en hauteur de portée, entre les points de référence des
486 deux éléments alors qu'il y a déjà un effet de compression. Une
487 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
488 sans effet, dans la mesure où l'espacement résultant ne saurait être
489 inférieur au @code{padding}.
491 @c TODO: explain skylines somewhere and xref to it from here.
494 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
495 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
496 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
497 sur toute la largeur des deux éléments.
500 @code{stretchability} @emph{(dilatation)} -- le coefficient
501 d'étirement de cet espace. Un coefficient nul permet de figer
502 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
503 positif déterminera la propension d'un espacement à s'étirer, tout
504 en tenant compte du coefficient affecté aux autres espacements.
505 Par exemple, lorsque le coefficient de dilatation d'une dimension est
506 double de celui d'une autre, elle pourra s'étirer deux fois plus que
507 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
508 provoque une @code{programming_error} (erreur de programmation) et est
509 ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
510 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
511 sa valeur est par défaut égale à @code{space}. Notez bien que
512 l'utilisateur ne peut définir une propension à la compression ;
513 elle est en fait égale à
514 (@code{basic-distance} @minus{} @code{minimum-distance}).
518 Lorsque l'impression n'est pas en pleine page -- elle est donc
519 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
520 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
526 @code{basic-distance}, plus
528 @code{minimum-distance} et
530 @code{padding}, augmenté de ce qu'il faut pour éviter les
535 Cependant, lorsque la partition fait plusieurs pages, la dernière page
536 reprendra dans la mesure du possible l'espacement de la page précédente.
538 Les manières de modifier des listes associatives font l'objet d'un
539 @rusernamed{Modification de listes associatives, chapitre spécifique}.
540 L'exemple suivant indique deux façons de modifier une liste associative.
541 La première déclaration intervient sur une seule clé, alors que la
542 deuxième redéfinit complètement la variable.
546 system-system-spacing #'basic-distance = #8
548 score-system-spacing =
550 (basic-distance . 12)
551 (minimum-distance . 6)
552 (stretchability . 12))
557 @node Liste des variables d'espacement vertical fluctuant
558 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
559 @translationof List of flexible vertical spacing \paper variables
561 Le nom des dimensionnements à hauteur variable sont de la forme
562 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
563 @code{@var{après}} représentent les éléments qui doivent être espacés.
564 La distance s'établit entre les points de référence des deux éléments
565 concernés (voir la rubrique précédente pour plus de précision). Notez
566 bien que, dans les règles de nommage des variables qui suivent, le terme
567 @code{markup} fait référence aussi bien à un @i{markup de titrage}
568 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
569 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
570 distances sont exprimées en espace de portée.
572 Leurs valeurs par défaut sont inscrites dans le fichier
573 @file{ly/paper-defaults-init.ly}.
575 @c TODO: Where do headers/footers fit in? -mp
578 @item markup-system-spacing
579 @funindex markup-system-spacing
581 détermine l'espacement entre un titre ou un @emph{markup} de premier
582 niveau, et le système qui le suit.
584 @item score-markup-spacing
585 @funindex score-markup-spacing
587 détermine l'espacement entre le dernier système et le titre ou
588 @emph{markup} de haut niveau qui le suit.
590 @item score-system-spacing
591 @funindex score-system-spacing
593 détermine l'espacement entre le dernier système d'une partition et le
594 premier système de la partition suivante, en l'absence de titrage ou
595 @emph{markup} qui les sépare.
597 @item system-system-spacing
598 @funindex system-system-spacing
600 détermine l'espacement entre deux systèmes d'un même mouvement.
602 @item markup-markup-spacing
603 @funindex markup-markup-spacing
605 détermine l'espacement entre deux titres ou @emph{markups} de premier
608 @item last-bottom-spacing
609 @funindex last-bottom-spacing
611 détermine la distance entre le dernier système ou le dernier
612 @emph{markup} de haut niveau, et le bas de la surface imprimable --
613 autrement dit le haut de la marge basse.
615 @item top-system-spacing
616 @funindex top-system-spacing
618 détermine l'espace entre le haut de la surface imprimable (le bas de la
619 marge haute) et le milieu du premier système. Cette variable n'est
620 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
623 @item top-markup-spacing
624 @funindex top-markup-spacing
626 détermine l'espace entre le haut de la surface imprimable (le bas de la
627 marge haute) et le premier titre ou @emph{markup} de premier niveau.
628 Cette variable n'est effective qu'en l'absence de système en haut de
635 @ref{Espacement vertical au sein d'un système}.
638 @rlsrnamed{Spacing,Espacements}.
641 @rlsrnamed{Spacing,Espacements}.
644 @node Variables d'espacement horizontal
645 @subsection Variables d'espacement horizontal
646 @translationof Horizontal spacing \paper variables
648 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
649 sont automatiquement ajustés selon le format du papier, ce qui peut
650 conduire à un résultat inattendu --
651 voir @ref{Adaptation automatique au format}.}
654 * Variables de marge et de largeur::
655 * Variables spécifiques à l'impression recto-verso::
656 * Variables d'indentation et de décalage::
660 @node Variables de marge et de largeur
661 @unnumberedsubsubsec Variables de marge et de largeur
662 @translationof \paper variables for widths and margins
664 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
665 @file{ly/paper-defaults-init.ly}.
670 @funindex paper-width
672 La largeur de la page. Elle correspond par défaut à la largeur du
673 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
674 matière d'ajustement automatique, cette variable influe sur la variable
675 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
676 @code{paper-width} et @code{line-width}, les valeurs de
677 @code{left-margin} et @code{right-margin} seront recalculées. Voir
678 aussi @code{check-consistency}.
683 la longueur d'un système musical sans indentation et justifié sur toute
684 la largeur de la page. La valeur par défaut est égale à
685 @code{paper-width}, auquel sont retranchés @code{left-margin} et
686 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
687 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
688 marges seront alors recalculées de telle sorte que les systèmes soient
689 centrés. Voir aussi @code{check-consistency}. La variable
690 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
693 @funindex left-margin
695 la marge entre le bord gauche de la feuille et le début de chaque
696 système. La valeur par défaut est de @code{10\mm} ; elle sera
697 ajustée selon le format du papier. Lorsque vous définissez
698 @code{line-width} et @code{right-margin} sans modifier la valeur de
699 @code{left-margin}, cette dernière sera alors égale à
700 @code{(paper-width @minus{} line-width @minus{} right-margin)}.
701 Lorsque seule @code{line-width} est définie, les deux marges
703 @code{((paper-width @minus{} line-width) / 2)}, ce
704 qui a pour effet de centrer les systèmes sur la page. Voir aussi
705 @code{check-consistency}.
708 @funindex right-margin
710 La marge entre le bord droit de la page et la fin des systèmes en pleine
711 largeur (non @emph{ragged}). La valeur par défaut est de @code{10\mm}
712 et s'ajustera selon le format du papier. Lorsque vous définissez
713 @code{line-width} et @code{left-margin}, sans modifier la valeur de
714 @code{right-margin}, cette dernière sera alors égale à
715 @code{(paper-width @minus{} line-width @minus{} left-margin)}.
716 Lorsque seule @code{line-width} est définie, les deux marges
718 @code{((paper-width @minus{} line-width) / 2)}, ce
719 qui a pour effet de centrer les systèmes sur la page. Voir aussi
720 @code{check-consistency}.
722 @item check-consistency
723 @funindex check-consistency
725 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
726 @code{line-width} et @code{right-margin} sont en cohérence, et que
727 l'addition de ces trois éléments ne dépassera pas la largeur du papier
728 (@code{paper-width}). La valeur par défaut est @code{#t}. Dans
729 le cas d'une incohérence, un message d'avertissement est émis et les
730 trois variables -- marges et longueur de ligne -- rétablies à leur
731 valeur par défaut (ajustées selon le format du papier).
734 @funindex ragged-right
736 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
737 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
738 La valeur par défaut est @code{#f} mais, si la partition ne comporte
739 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
740 se gérer au sein d'un bloc @code{\layout}.
743 @funindex ragged-last
745 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
746 dernier système de façon à occuper toute la longueur de la ligne. La
747 valeur par défaut est @code{#f}. Cette variable peut aussi se
748 gérer au sein d'un bloc @code{\layout}.
754 @ref{Adaptation automatique au format}.
756 Fichiers d'initialisation :
757 @file{ly/paper-defaults-init.ly}.
760 La définition explicite d'un format de papier annulera tout réglage des
761 marges gauche et droite.
764 @node Variables spécifiques à l'impression recto-verso
765 @unnumberedsubsubsec Variables spécifiques à l'impression recto-verso
766 @translationof \paper variables for two-sided mode
768 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
769 @file{ly/paper-defaults-init.ly}.
779 Cette variable permet de gérer efficacement les impressions recto-verso.
780 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
781 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
782 différentes marges selon qu'il s'agit d'une page paire ou impaire.
783 Cette variable s'applique en lieu et place de @code{left-margin} et
784 @code{right-margin}. La valeur par défaut est @code{#f}.
787 @funindex inner-margin
789 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
790 avoir du côté intérieur. Bien entendu, cette variable n'est
791 effective que lorsque vous comptez générer un fichier imprimable en
792 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
793 défaut est de @code{10\mm} et s'ajustera selon le format du papier.
796 @funindex outer-margin
798 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
799 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
800 variable n'est effective que lorsque vous comptez générer un fichier
801 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
802 La valeur par défaut est de @code{20\mm} et s'ajustera selon le
806 @funindex binding-offset
808 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
809 valeur de la marge intérieure @code{inner-margin} de telle sorte que
810 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
811 effective que lorsque vous comptez générer un fichier imprimable en
812 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
813 défaut est de @code{0} et s'ajustera selon le format du papier.
819 @ref{Adaptation automatique au format}.
821 Fichiers d'initialisation :
822 @file{ly/paper-defaults-init.ly}.
825 @node Variables d'indentation et de décalage
826 @unnumberedsubsubsec Variables d'indentation et de décalage
827 @translationof \paper variables for shifts and indents
829 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
830 @file{ly/paper-defaults-init.ly}.
834 @item horizontal-shift
835 @funindex horizontal-shift
837 @c This default value is buried in the middle of page.scm. -mp
839 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
840 seront poussés d'autant vers la droite. La valeur par défaut est
846 Le niveau d'indentation du premier système d'une partition. La valeur
847 par défaut est de @code{15\mm} et s'ajustera selon le format du
848 papier. Cette variable peut aussi se gérer au sein d'un bloc
852 @funindex short-indent
854 Le niveau d'indentation de tous les systèmes hormis le premier. La
855 valeur par défaut est de @code{0}, et s'ajustera selon le format du
856 papier dès lors que vous lui aurez affecté une valeur. Cette
857 variable peut aussi se gérer au sein d'un bloc @code{\layout}.
863 @ref{Adaptation automatique au format}.
865 Fichiers d'initialisation :
866 @file{ly/paper-defaults-init.ly}.
869 @rlsrnamed{Spacing, Espacements}.
872 @node Autres variables du bloc \paper
873 @subsection Autres variables du bloc @code{\paper}
874 @translationof Other \paper variables
877 * Variables de gestion des sauts de ligne::
878 * Variables de gestion des sauts de page::
879 * Variables de gestion des numéros de page::
880 * Variables supplémentaires::
884 @node Variables de gestion des sauts de ligne
885 @unnumberedsubsubsec Variables de gestion des sauts de ligne
886 @translationof \paper variables for line breaking
890 @item max-systems-per-page
891 @funindex max-systems-per-page
893 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
894 variable n'est prise en compte, à ce jour, que par l'option
895 @code{ly:optimal-breaking}, et n'est pas définie.
897 @item min-systems-per-page
898 @funindex min-systems-per-page
900 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
901 cependant aux risques de débordement s'il est trop important. Cette
902 variable n'est prise en compte, à ce jour, que par l'option
903 @code{ly:optimal-breaking}, et n'est pas définie.
905 @item systems-per-page
906 @funindex systems-per-page
908 Le nombre de systèmes que devrait comporter chaque page. Cette variable
909 n'est à ce jour prise en charge que par l'algorithme
910 @code{ly:optimal-breaking} et n'est pas définie par défaut.
913 @funindex system-count
915 Le nombre de systèmes requis par la partition. Cette variable n'est pas
916 définie par défaut. Cette variable peut se gérer au sein d'un bloc
923 @ref{Sauts de ligne}.
926 @node Variables de gestion des sauts de page
927 @unnumberedsubsubsec Variables de gestion des sauts de page
928 @translationof \paper variables for page breaking
930 Les valeurs par défaut sont définies dans le fichier
931 @file{ly/paper-defaults-init.ly}.
936 @funindex page-breaking
938 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
939 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking},
940 @code{ly:one-line-breaking} et @code{ly:optimal-breaking} (activé
943 @item page-breaking-system-system-spacing
944 @funindex page-breaking-system-system-spacing
946 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
947 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
948 lorsque @code{page-breaking-system-system-spacing #'padding} a une
949 valeur nettement supérieure à @code{system-system-spacing #'padding},
950 l'algorithme en question aura tendance à disposer moins de systèmes sur
951 une même page. Cette variable est par défaut non définie.
956 Le nombre de pages que devra comporter la partition. Cette variable est
957 par défaut non définie.
961 Les variables qui suivent ne sont effectives que lorsque
962 l'algorithme @code{page-breaking} adopte la fonction
963 @code{ly:page-turn-breaking}. Les sauts de page sont alors
964 positionnés de sorte à minimiser le nombre de tournes. Dans la
965 mesure où il faut tourner la feuille pour passer d'une page
966 impaire à une page paire, sera privilégiée une répartition qui
967 présente une dernière page impaire. Les endroits où une tourne
968 serait appropriée peuvent s'indiquer à l'aide d'un
969 @code{\allowPageTurn} ou laissés à l'appréciation du
970 @code{Page_turn_engraver} -- voir @ref{Optimisation des tournes}.
972 Lorsqu'aucune option n'est satisfaisante pour placer
973 judicieusement les tournes, LilyPond peut décider d'insérer une
974 page blanche au milieu d'une partition ou entre deux partitions
975 successives, voire même finir par une page paire. La valeur des
976 trois variables qui suivent peut se voir augmentée de façon à
977 diminuer ces risques.
979 Il s'agit ici de pénalité ; autrement dit, au plus la valeur est
980 élevée, au moins l'action associée sera favorisée en regard des
985 @item blank-page-penalty
986 @funindex blank-page-penalty
988 Pénalité pour apparition d'une page blanche en cours de partition.
989 L'attribution d'une valeur élevée à @code{blank-page-penalty}
990 alors qu'a été activé @code{ly:page-turn-breaking} forcera
991 LilyPond à éviter de placer une page blanche au mileu de la
992 partition, quitte à espacer d'autant plus la musique pour remplir
993 cette page blanche et la suivante. La valeur par défaut est
996 @item blank-last-page-penalty
997 @funindex blank-last-page-penalty
999 Pénalité pour fin de partition intervenant sur une page paire.
1000 L'attribution d'une valeur élevée à @code{blank-last-page-penalty}
1001 alors qu'a été activé @code{ly:page-turn-breaking} forcera
1002 LilyPond à éviter de terminer la partition sur une page paire,
1003 quitte à ajuster les espacements jusqu'à obtenir une page de plus
1004 ou une de moins. La valeur par défaut est de @code{0}.
1006 @item blank-after-score-page-penalty
1007 @funindex blank-after-score-page-penalty
1009 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
1010 valeur est par défaut inférieure à celle de
1011 @code{blank-page-penalty} ; nous préférons qu'une page blanche
1012 s'insère après la fin de la partition plutôt qu'au milieu. La
1013 valeur par défaut est de @code{2}.
1018 Manuel de notation :
1019 @ref{Sauts de page},
1020 @ref{Optimisation des sauts de page},
1021 @ref{Optimisation des tournes},
1022 @ref{Minimisation des sauts de page},
1023 @ref{Présentation en rouleau}.
1025 Fichiers d'initialisation :
1026 @file{ly/paper-defaults-init.ly}.
1029 @node Variables de gestion des numéros de page
1030 @unnumberedsubsubsec Variables de gestion des numéros de page
1031 @translationof \paper variables for page numbering
1033 Les valeurs par défaut sont définies dans le
1034 fichier @file{ly/paper-defaults-init.ly}.
1038 @cindex pages, numérotation automatique
1039 @item auto-first-page-number
1040 @funindex auto-first-page-number
1042 L'algorithme qui gère les sauts de page prend en compte le fait que le
1043 premier numéro de page soit pair ou impair. Lorsque cette
1044 fonctionnalité est activée, l'algorithme des sauts de page décidera de
1045 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
1046 par un éventuel incrément de un. La valeur par défaut
1049 @cindex pages, numéro de la première
1050 @item first-page-number
1051 @funindex first-page-number
1053 Le numéro de la première page. La valeur par défaut est
1056 @item print-first-page-number
1057 @funindex print-first-page-number
1059 Cette variable permet d'imprimer le numéro de page y compris sur la
1060 première. La valeur par défaut est @code{#f}.
1062 @item print-page-number
1063 @funindex print-page-number
1065 La désactivation de cette variable permet d'obtenir des pages non
1066 numérotées. La valeur par défaut est @code{#t}.
1071 Fichiers d'initialisation :
1072 @file{ly/paper-defaults-init.ly}.
1075 Les pages au numéro impair sont toujours à droite. Pour que la musique
1076 commence en page 1, le dos de la page de garde doit être vide de telle
1077 sorte que la page une se retrouve à droite.
1080 @node Variables supplémentaires
1081 @unnumberedsubsubsec Variables supplémentaires
1082 @translationof Miscellaneous \paper variables
1086 @item page-spacing-weight
1087 @funindex page-spacing-weight
1089 Cette variable définit l'importance relative des espacements entre la
1090 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1091 privilégiera l'espacement au niveau de la page. La valeur par défaut
1094 @item print-all-headers
1095 @funindex print-all-headers
1097 Lorsque cette variable est activée, l'intégralité des champs d'entête
1098 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1099 champs @code{piece} et @code{opus}. La valeur par défaut
1102 @item system-separator-markup
1103 @funindex system-separator-markup
1105 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1106 chaque système, comme on le voit dans nombre de partitions orchestrales.
1107 Cette variable n'est pas définie par défaut. La commande
1108 @code{\slashSeparator} -- définie dans le fichier
1109 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1112 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1113 #(set-default-paper-size "a8")
1117 system-separator-markup = \slashSeparator
1123 \relative c'' { c1 \break c1 \break c1 }
1131 Fichiers d'initialisation :
1132 @file{ly/titling-init.ly}.
1135 @rlsrnamed{Spacing,Espacements}.
1138 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1139 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1142 @node Mise en forme de la partition
1143 @section Mise en forme de la partition
1144 @translationof Score layout
1146 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1147 plus particulièrement destinées à gérer la mise en forme de la
1152 * Définition de la taille de portée::
1156 @node Le bloc \layout
1157 @subsection Le bloc @code{\layout}
1158 @translationof The \layout block
1162 Alors que le bloc @code{\paper} définit le formatage des pages pour
1163 l'intégralité du document, le bloc @code{\layout} gère la mise en
1164 forme spécifique à la partition. La mise en forme de la musique peut
1165 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1166 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1167 où la mise en forme concerne une partition en particulier, un bloc
1168 @code{\layout} se placera au sein du bloc @code{\score} en question.
1169 Sont susceptibles d'apparaître dans un bloc @code{\layout} :
1173 la fonction Scheme @code{layout-set-staff-size},
1176 dans des blocs @code{\context}, les modifications apportées aux
1177 différents contextes, et
1180 les variables normalement attachées au bloc @code{\paper} qui
1181 affecteront la mise en forme de la partition.
1185 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1186 suivante, @ref{Définition de la taille de portée}. La modification des
1187 contextes est abordée dans d'autres chapitres -- voir
1188 @ref{Modification des greffons de contexte} et
1189 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1190 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1191 @code{\layout} sont :
1196 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1197 (voir @ref{Variables de marge et de largeur})
1200 @code{indent} et @code{short-indent}
1201 (voir @ref{Variables d'indentation et de décalage})
1205 (voir @ref{Variables de gestion des sauts de ligne})
1209 Voici un exemple de bloc @code{\layout} :
1216 \override StaffGrouper.staff-staff-spacing.basic-distance = #8
1220 \override TextScript.padding = #1
1221 \override Glissando.thickness = #3
1226 Il est tout à fait possible que plusieurs blocs @code{\layout}
1227 cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
1228 particulièrement utile lorsque différents réglages sont stockés dans des
1229 fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
1230 @code{\layout} est évalué, une copie de la configuration du
1231 @code{\layout} actuel est réalisée en interne, augmentée des
1232 aménagements apportés. Bien qu'on puisse considérer que le contenu des
1233 différents blocs @code{\layout} se cumule, c'est la dernière adaptation
1234 qui aura préséance en cas de situation conflictuelle -- cas typique
1235 d'une même propriété modifiée dans différents blocs.
1237 Par exemple, placer le bloc suivant
1243 \override TextScript.color = #magenta
1244 \override Glissando.thickness = #1.5
1249 après celui de l'exemple précédent aura pour effet de cumuler les
1250 adaptations de @code{'padding} et @code{'color} pour l'objet
1251 @code{TextScript}, mais la dernière adaptation apportée à la propriété
1252 @code{'thickness} de @code{Glissando} remplace, ou masque, celle
1253 précédemment établie.
1255 Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
1256 les utiliser ultérieurement. Ceci requiert toutefois une attention
1257 particulière dans la mesure où cette manière de procéder n'est pas
1258 équivalente à une définition complète et globale.
1260 Lorsque nous définissons la variable suivante,
1263 layoutVariable = \layout @{
1266 \override NoteHead.font-size = #4
1271 qui contient une configuration de @code{\layout} avec
1272 l'adaptation @code{NoteHead.font-size}, cette combinaison n'est pas
1273 enregistrée en tant que configuration courante. Notez bien que la
1274 « configuration courante » est lue lorsque la variable est définie, non
1275 lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
1276 variable dépend de l'endroit où elle se trouve dans le code source.
1278 Notre variable peut alors être utilisée au sein d'un autre bloc
1279 @code{\layout}, comme par exemple :
1286 \override NoteHead.color = #red
1291 Un bloc @code{\layout} qui contient une variable comme ci-dessus ne
1292 recopie pas la configuration actuelle ; il utilise en fait le contenu de
1293 @code{layoutVariable} en tant que configuration de base pour les
1294 adaptations ultérieures, en conséquence de quoi toute modification
1295 intervenant entre la définition et l'utilisation de la variable sera
1298 Si @code{layoutVariable} est définie, ou rapatriée par un
1299 @code{\indude}, juste avant d'être utilisée, son contenu devient la
1300 configuration actuelle augmentée des adaptations que la variable
1301 contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
1302 ci-dessus, le bloc @code{\layout} final contiendra donc :
1305 TextScript.padding = #1
1306 TextScript.color = #magenta
1307 Glissando.thickness = #1.5
1308 NoteHead.font-size = #4
1309 NoteHead.color = #red
1312 ainsi que les adaptations de @code{indent} et @code{StaffGrouper}.
1314 Cependant, si la variable avait été définie bien avant le premier bloc
1315 @code{\layout}, la configuration actuelle ne contiendrait que
1318 NoteHead.font-size= #4 % (écrit dans la définition de la variable)
1319 NoteHead.color = #red % (ajouté après l'utilisation de la variable)
1322 Une gestion attentive des variables de @code{\layout} se révèle être un
1323 outil précieux dans la mise en forme des sources et le retour à une
1324 configuration donnée.
1327 Manuel de notation :
1328 @ref{Modification des réglages par défaut d'un contexte}.
1331 @rlsrnamed{Spacing,Espacements}.
1334 @node Définition de la taille de portée
1335 @subsection Définition de la taille de portée
1336 @translationof Setting the staff size
1338 @cindex fonte, définition de la taille
1339 @cindex portée, définition de la taille
1340 @funindex layout file
1342 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1343 20 points. Il existe deux manières de la modifier :
1345 La taille des portées peut se définir globalement pour toutes les
1346 partitions d'un même fichier, ou plus précisément d'un bloc
1347 @code{\book}, à l'aide de @code{set-global-staff-size}.
1350 #(set-global-staff-size 14)
1354 Ceci définit donc la hauteur des portées à 14 points par
1355 défaut ; toutes les fontes seront ajustées en conséquence.
1357 Vous pouvez aussi spécifier une taille à une partition en particulier en
1358 procédant comme ci-dessous :
1364 #(layout-set-staff-size 15)
1369 La fonte Feta fournit les symboles musicaux dans huit tailles
1370 différentes. Chaque fonte correspond à une hauteur particulière de
1371 portée ; les petites tailles comportent des symboles plus épais
1372 pour être cohérent avec l'épaisseur relativement plus importante des
1373 lignes de la portée. Le tableau suivant répertorie les différentes
1377 @multitable @columnfractions .15 .2 .22 .2
1379 @item @b{nom de la fonte}
1380 @tab @b{hauteur de portée (pt)}
1381 @tab @b{hauteur de portée (mm)}
1382 @tab @b{utilisation}
1387 @tab format de poche
1407 @tab carnet de chant
1412 @tab partition standard
1423 @c matériel de location moderne ?
1428 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1429 contexte @code{fontSize} ainsi que la propriété de mise en forme
1430 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1431 individuellement la taille de chaque portée. La taille de chacune des
1432 portées est relative à la taille globale.
1435 Manuel de notation :
1436 @ref{Indication de la taille de fonte musicale}.
1439 @rlsrnamed{Spacing,Espacements}.
1442 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1443 lignes d'une portée.
1448 @translationof Breaks
1453 * Optimisation des sauts de page::
1454 * Optimisation des tournes::
1455 * Minimisation des sauts de page::
1456 * Présentation en rouleau::
1457 * Sauts explicites::
1458 * Recours à une voix supplémentaire pour gérer les sauts::
1462 @node Sauts de ligne
1463 @subsection Sauts de ligne
1464 @translationof Line breaking
1466 @cindex saut de ligne
1467 @cindex ligne, passer à la suivante
1469 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1470 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1471 trop aérée, et que des lignes consécutives aient à peu près la même
1474 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1475 vous le jugez utile pour @qq{forcer} le passage à la ligne suivante :
1477 @lilypond[quote,ragged-right,relative=2,verbatim]
1482 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1483 mesure ; LilyPond vous le signalera par un message si tel était le
1484 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1485 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1486 l'aide de @code{\bar ""}.
1488 @lilypond[quote,ragged-right,relative=2,verbatim]
1495 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1496 mesure dès lors que la précédente avait une note en suspend -- c'est
1497 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1498 L'instruction @code{\break} sera alors opérationnelle si vous avez
1499 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1500 @code{Voice} concerné. Notez bien qu'en pareil cas, les sauts de ligne
1501 forcés doivent être saisis au sein d'une expression polyphonique :
1503 @lilypond[quote,ragged-right,verbatim]
1505 \remove "Forbid_line_break_engraver"
1508 { c2. \tuplet 3/2 { c4 c c } c2. | }
1509 { s1 | \break s1 | }
1514 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1515 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1516 introduire la dérogation @w{@code{\override Beam.breakable = ##t}}.
1518 @lilypond[quote,ragged-right,relative=2,verbatim]
1519 \override Beam.breakable = ##t
1524 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1525 saut de ligne à la fin de la mesure où elle est explicitée.
1527 LilyPond dispose de deux variables de base pour influencer l'espacement
1528 au niveau des lignes. Toutes deux se définissent dans un bloc
1529 @code{\layout}, @code{indent} réglant l'indentation de la première
1530 ligne, et @code{line-width} la longueur des lignes.
1532 L'activation du commutateur @code{ragged-right} au sein du bloc
1533 @code{\layout} aura pour effet de terminer les systèmes là où ils
1534 prendraient fin normalement plutôt que de les étirer sur toute la
1535 longueur de la ligne. Ceci est particulièrement utile pour de petits
1536 fragments ou pour vérifier la densité induite par l'espacement naturel.
1538 @c TODO Check and add para on default for ragged-right
1540 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1541 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1551 @cindex sauts de ligne réguliers
1552 @cindex portée à quatre mesures
1554 L'utilisation conjointe de @code{\break} et de blancs dans une section
1555 @code{\repeat} vous permettra de positionner des sauts de ligne à
1556 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1557 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1563 s1 \noBreak s1 \noBreak
1564 s1 \noBreak s1 \break
1566 @{ @var{et ici la musique@dots{}} @}
1578 Manuel de notation :
1579 @ref{Variables de gestion des sauts de ligne}.
1581 Référence des propriétés internes :
1582 @rinternals{LineBreakEvent}.
1585 @rlsrnamed{Spacing,Espacements}.
1589 @subsection Sauts de page
1590 @translationof Page breaking
1592 La gestion automatique des sauts de page se contrôle à l'aide des
1593 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1594 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1595 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1596 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1597 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1600 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1601 trouver à des niveaux supérieurs, entre deux partitions ou
1602 @emph{markups} de premier rang.
1604 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1605 gérer la répartition horizontale, LilyPond dispose de commutateurs
1606 équivalents au niveau de la verticalité : @code{ragged-bottom} et
1607 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1608 affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
1609 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1610 à @ref{Variables d'espacement vertical fixe}.
1612 Les sauts de page sont générés par la fonction @code{page-breaking}.
1613 LilyPond dispose de trois différents algorithmes en la matière :
1614 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1615 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1616 activé par défaut, mais rien ne vous empêche d'en changer, par
1617 l'intermédiaire du bloc @code{\paper} :
1621 page-breaking = #ly:page-turn-breaking
1627 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1628 pages, la gestion des sauts de page finit par devenir très gourmande,
1629 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1630 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1631 sectionner l'ouvrage que vous traitez ; les sauts de page seront
1632 alors gérés individuellement au niveau de chacune des parties. Par
1633 ailleurs, cela vous autorisera une gestion différente selon les
1639 subtitle = "Préface"
1642 %% Pour une partie constituée principalement de texte
1643 %% ly:minimal-breaking est plus judicieux.
1644 page-breaking = #ly:minimal-breaking
1646 \markup @{ @dots{} @}
1650 %% Cette partie étant purement musicale,
1651 %% retour au style par défaut (optimal-breaking).
1653 subtitle = "Premier mouvement"
1655 \score @{ @dots{} @}
1661 @funindex \pageBreak
1663 @funindex \noPageBreak
1664 @code{\noPageBreak}.
1668 Manuel de notation :
1669 @ref{Variables de gestion des sauts de page}.
1672 @rlsrnamed{Spacing,Espacements}.
1675 @node Optimisation des sauts de page
1676 @subsection Optimisation des sauts de page
1677 @translationof Optimal page breaking
1679 @funindex ly:optimal-breaking
1681 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1682 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1683 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1684 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1685 n'a aucune notion de ce qu'est une @qq{tourne}.
1689 @rlsrnamed{Spacing,Espacements}.
1692 @node Optimisation des tournes
1693 @subsection Optimisation des tournes
1694 @translationof Optimal page turning
1696 @funindex ly:page-turn-breaking
1698 Aboutir à une configuration des sauts de page de telle sorte que les
1699 pages de droite se terminent toujours par un silence devient souvent une
1700 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1701 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1702 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1703 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1704 ne saurait intervenir qu'à certains endroits.
1706 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1707 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1708 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1709 informer la fonction des endroits où les sauts de page sont permis.
1711 Cette deuxième étape se réalise de deux manières différentes. Vous
1712 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1713 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1715 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1716 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1717 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1718 tournes recherchera dans le contexte en question les passages sans note.
1719 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1720 notes ; autrement dit, il ne restera pas inactif dans le cadre
1721 d'une portée polyphonique dont l'une des parties contiendrait des
1722 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1723 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1724 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1725 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1726 déposera le @code{\allowPageTurn}.
1728 @funindex minimumPageTurnLength
1730 Le @code{Page_turn_engraver} examine la propriété de contexte
1731 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1732 longueur d'un fragment sans note avant une tourne. La valeur par
1733 défaut de @code{minimumPageTurnLength} est
1734 @code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
1735 la manière suivante :
1738 \new Staff \with @{ \consists "Page_turn_engraver" @}
1741 R1 | % une tourne peut se placer ici
1743 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1744 R1 | % il ne peut pas y avoir de tourne ici
1746 R1*2 | % une tourne peut se placer ici
1751 @funindex minimumRepeatLengthForPageTurn
1753 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1754 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1755 temps au début et à la fin de la reprise pour que l'exécutant ait le
1756 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1757 même capable d'interdire un tourne dans le cas d'une reprise de courte
1758 durée, ajustable au travers de la propriété de contexte
1759 @code{minimumRepeatLengthForPageTurn}.
1761 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1762 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1763 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1768 @funindex \noPageTurn
1770 @funindex \allowPageTurn
1771 @code{\allowPageTurn}.
1775 Manuel de notation :
1776 @ref{Variables de gestion des sauts de ligne}.
1779 @rlsrnamed{Spacing,Espacements}.
1782 Une partition ne devrait contenir qu'une seule instance du
1783 @code{Page_turn_engraver}, au risque de les voir se contredire.
1786 @node Minimisation des sauts de page
1787 @subsection Minimisation des sauts de page
1788 @translationof Minimal page breaking
1790 @funindex ly:minimal-breaking
1792 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1793 calculs pour positionner les sauts de page. Elle mettra le plus de
1794 systèmes possible sur une page avant de passer à la suivante. On peut
1795 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1796 lorsque les autres fonctions de gestion des sauts de page ralentissent
1797 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1798 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1803 page-breaking = #ly:minimal-breaking
1809 @rlsrnamed{Spacing,Espacements}.
1812 @node Présentation en rouleau
1813 @subsection Présentation en rouleau
1814 @translationof One-line page breaking
1816 @funindex ly:one-line-breaking
1818 La fonction @code{ly:one-line-breaking} constitue un algorithme de
1819 calcul des sauts de pages particulier en ceci que chaque partition fait
1820 l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
1821 s'affranchit de l'impression des titres et marges ; seule la partition
1824 La largeur de page est ajustée de telle sorte que la pièce la plus
1825 longue tienne sur une seule ligne. En particulier, les variables
1826 @code{paper-width}, @code{line-width} et @code{indent} du bloc
1827 @code{\paper} seront ignorées ; les @code{left-margin} et
1828 @code{right-margin} seront honorées. La hauteur de page ne sera pas
1832 @node Sauts explicites
1833 @subsection Sauts explicites
1834 @translationof Explicit breaks
1836 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1837 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1838 avec ces deux instructions dérogatoires :
1841 \override NonMusicalPaperColumn.line-break-permission = ##f
1842 \override NonMusicalPaperColumn.page-break-permission = ##f
1845 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1846 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1847 explicite, et nulle part ailleurs. De la même façon, la désactivation
1848 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1849 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1850 nulle part ailleurs.
1852 @lilypond[quote,verbatim]
1859 music = \relative c'' { c8 c c c }
1863 \repeat unfold 2 { \music } \break
1864 \repeat unfold 4 { \music } \break
1865 \repeat unfold 6 { \music } \break
1866 \repeat unfold 8 { \music } \pageBreak
1867 \repeat unfold 8 { \music } \break
1868 \repeat unfold 6 { \music } \break
1869 \repeat unfold 4 { \music } \break
1870 \repeat unfold 2 { \music }
1875 \override NonMusicalPaperColumn.line-break-permission = ##f
1876 \override NonMusicalPaperColumn.page-break-permission = ##f
1884 @rlsrnamed{Spacing,Espacements}.
1887 @node Recours à une voix supplémentaire pour gérer les sauts
1888 @subsection Recours à une voix supplémentaire pour gérer les sauts
1889 @translationof Using an extra voice for breaks
1891 La plupart du temps, les informations concernant les sauts de ligne ou
1892 de page se retrouvent directement au milieu des notes.
1895 musique = \relative c'' @{ c4 c c c @}
1899 \repeat unfold 2 @{ \musique @} \break
1900 \repeat unfold 3 @{ \musique @}
1905 Bien que cela constitue un moyen aisé de saisir les commandes
1906 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1907 mélangées à des informations qui concernent plutôt l'agencement de la
1908 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1909 purement musical et les informations concernant les sauts de ligne ou de
1910 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1911 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1912 des @code{\break}, des @code{\pageBreak} et autres informations
1913 concernant les ruptures.
1915 @lilypond[quote,verbatim]
1916 music = \relative c'' { c4 c c c }
1927 \repeat unfold 2 { \music }
1928 \repeat unfold 3 { \music }
1929 \repeat unfold 6 { \music }
1930 \repeat unfold 5 { \music }
1936 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1937 les @code{line-break-system-details} et autres propriétés fort
1938 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1939 le voir au chapitre @ref{Espacement vertical}.
1941 @lilypond[quote,verbatim]
1942 music = \relative c'' { c4 c c c }
1947 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0))
1950 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 35))
1953 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 70))
1956 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 105))
1960 \repeat unfold 2 { \music }
1961 \repeat unfold 3 { \music }
1962 \repeat unfold 6 { \music }
1963 \repeat unfold 5 { \music }
1970 Manuel de notation :
1971 @ref{Espacement vertical}.
1974 @rlsrnamed{Spacing,Espacements}.
1977 @node Espacement vertical
1978 @section Espacement vertical
1979 @translationof Vertical spacing
1981 @cindex vertical, espacement
1982 @cindex espacement vertical
1984 L'espacement vertical dépend de trois éléments : la surface
1985 disponible -- format de papier et marges --, l'espace qui doit
1986 séparer les systèmes, et l'espace qui sépare les portées d'un même
1990 * Espacement vertical au sein d'un système::
1991 * Positionnement explicite des portées et systèmes::
1992 * Résolution des collisions verticales::
1996 @node Espacement vertical au sein d'un système
1997 @subsection Espacement vertical au sein d'un système
1998 @translationof Flexible vertical spacing within systems
2000 @cindex distance entre les portées
2001 @cindex portées, espacement
2002 @cindex espacement entre les portées
2003 @cindex espacement au sein d'un système
2005 LilyPond dispose de trois différents mécanismes permettant de contrôler
2006 l'espacement au sein d'un système selon trois catégories :
2011 @emph{portées isolées},
2014 @emph{portées regroupées} (portées d'un même groupe, telles celles
2015 d'un @code{ChoirStaff}, etc.), et
2018 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
2022 @c TODO: Clarify this. This almost implies that non-staff lines
2023 @c have NO effect on the spacing between staves. -mp
2025 La hauteur de chaque système se détermine en deux phases. Les portées
2026 sont tout d'abord espacées selon la surface disponible. Puis les lignes
2027 autres que des portées, comme les paroles ou les accords, sont réparties
2030 Les paragraphes qui suivent traitent exclusivement de la manière de
2031 gérer l'espacement entre les lignes d'un système -- portée musicale ou
2032 non. Pour ce qui a trait aux espacements entre les systèmes,
2033 mouvements, annotations et marge, ils sont contrôlés par des variables
2034 attachées au bloc @code{\paper} et font l'objet du chapitre
2035 @ref{Variables d'espacement vertical fluctuant}.
2038 * Propriétés d'espacement au sein d'un système::
2039 * Espacement de portées isolées::
2040 * Espacement de portées regroupées::
2041 * Espacement des lignes rattachées à des portées::
2045 @node Propriétés d'espacement au sein d'un système
2046 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
2047 @translationof Within-system spacing properties
2049 @funindex staff-affinity
2050 @funindex staffgroup-staff-spacing
2051 @funindex staff-staff-spacing
2052 @funindex nonstaff-unrelatedstaff-spacing
2053 @funindex nonstaff-relatedstaff-spacing
2054 @funindex nonstaff-nonstaff-spacing
2055 @funindex default-staff-staff-spacing
2056 @funindex minimum-Y-extent
2057 @funindex extra-offset
2058 @funindex self-alignment-X
2060 @funindex VerticalAxisGroup
2062 L'espacement entre les portées est géré par deux jeux de propriétés
2063 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
2064 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
2065 ou de non-portée. Le second, associé à l'objet graphique
2066 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
2067 de portées particulier. Les propriétés qui leur sont attachées sont
2068 abordées en fin de section.
2070 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
2071 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
2072 @code{@var{item2}} étant les éléments à espacer. Notez bien que
2073 @code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
2074 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
2075 l'espacement d'une ligne de non-portée alors que sa
2076 @code{staff-affinity} a été déterminée à @code{UP}.
2078 Toutes ces distances sont mesurées entre les points de référence
2079 respectifs des éléments considérés.
2080 Le @i{point de référence} d'une portée est le centre vertical du
2081 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
2082 l'interligne médian si @code{line-count} est pair.
2083 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
2084 tableau suivant présente le @i{point de référence} pour chacune
2087 @multitable {Ligne de non-portée} {Point de référence}
2088 @headitem Ligne de non-portée @tab Point de référence
2089 @item @code{ChordNames} @tab ligne de base
2090 @item @code{NoteNames} @tab ligne de base
2091 @item @code{Lyrics} @tab ligne de base
2092 @item @code{Dynamics} @tab centre vertical
2093 @item @code{FiguredBass} @tab point le plus haut
2094 @item @code{FretBoards} @tab ligne supérieure
2097 En voici une représentation graphique :
2100 @lilypond[quote,noragged-right,line-width=110\mm]
2101 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
2103 alignToZero = \with {
2104 \override VerticalAxisGroup.nonstaff-relatedstaff-spacing = #zero-space
2105 \override VerticalAxisGroup.nonstaff-nonstaff-spacing = #zero-space
2107 lowerCaseChords = \with {
2108 chordNameLowercaseMinor = ##t
2110 staffAffinityDown = \with {
2111 \override VerticalAxisGroup.staff-affinity = #DOWN
2114 #(define-music-function
2115 (parser location context)
2117 #{ s1*0^\markup { \typewriter #context } #})
2120 \context { \Dynamics \alignToZero }
2121 \context { \FiguredBass \alignToZero }
2122 \context { \Lyrics \alignToZero }
2123 \context { \NoteNames \alignToZero \staffAffinityDown }
2124 \context { \ChordNames \alignToZero
2127 \context { \FretBoards \alignToZero \staffAffinityDown }
2129 \override BarLine.stencil = ##f
2130 \override DynamicText.self-alignment-X = #-1
2131 \override FretBoard.X-offset = #1.75
2132 \override InstrumentName.minimum-Y-extent = #'(-2 . 2)
2133 \override InstrumentName.extra-offset = #'(0 . -0.5)
2134 \override TextScript.minimum-Y-extent = #'(-2 . 3)
2135 \override TimeSignature.stencil = ##f
2139 %% Contextes dont le point de référence est la ligne de base :
2140 %% ChordNames, NoteNames et Lyrics
2142 \new ChordNames { \chords { g1:m } }
2143 \new NoteNames { s1 | g1 | }
2144 \new RhythmicStaff {
2145 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
2147 \labelContext "ChordNames" s1 |
2148 \labelContext "NoteNames" s1 |
2149 \labelContext "Lyrics" s1 |
2151 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
2154 %% Le point de référence de Dynamics est le milieu de la ligne
2156 \new RhythmicStaff {
2157 \set RhythmicStaff.instrumentName = #"centre vertical "
2158 \labelContext "Dynamics" s1*3
2160 \new Dynamics { s1\mp s\fp }
2163 %% Le point de référence de FiguredBass est son point le plus haut
2165 \new RhythmicStaff {
2166 \set RhythmicStaff.instrumentName = #"point le plus haut "
2167 \labelContext "FiguredBass" s1
2169 \new FiguredBass { \figuremode { <6 5>1 } }
2172 %% Le point de référence de FretBoards est la ligne du haut
2173 \include "predefined-guitar-fretboards.ly"
2175 \new FretBoards { \chordmode { e1 } }
2176 \new RhythmicStaff {
2177 \set RhythmicStaff.instrumentName = #"ligne du haut "
2178 \labelContext "FretBoards " s1
2183 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2184 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2185 sous la forme d'une liste associative dont la structure est
2186 identique à celle des variables du bloc @code{\paper} que nous avons
2187 examinées au chapitre
2188 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2189 matière de modification d'une liste associative font l'objet d'un
2190 @rusernamed{Modification de listes associatives,chapitre particulier}.
2191 Les propriétés des objets graphiques se règlent avec un @code{\override}
2192 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2195 L'exemple suivant illustre deux façons de modifier une liste
2196 associative. La première déclaration n'agit que sur une seule clé,
2197 alors que la seconde redéfinit la propriété dans son intégralité.
2201 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2205 \override VerticalAxisGroup.default-staff-staff-spacing =
2206 #'(('basic-distance . 10)
2207 (minimum-distance . 9)
2209 (stretchability . 10))
2213 La modification d'un espacement au niveau global se mentionne au sein du
2214 bloc @code{\layout} :
2220 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2225 Les réglages concernant les propriétés d'espacement vertical des objets
2226 graphiques sont répertoriées aux chapitres
2227 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2228 Les propriétés relatives aux lignes de non-portée sont répertoriées
2229 selon la définition de leur contexte dans la
2230 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2233 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2234 @c VO Properties of the @code{VerticalAxisGroup} grob
2236 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2237 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2241 @item staff-staff-spacing
2242 Il s'agit de la distance entre la portée en cours et la portée qui suit
2243 au sein du même regroupement, qu'il y ait ou des lignes de non-portée
2244 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2245 pas à la dernière portée d'un système.
2247 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2248 d'un @code{VerticalAxisGroup} affectera les propriétés du
2249 @code{StaffGrouper} si la portée est incluse dans un regroupement ;
2250 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2251 regroupement. Les portées peuvent donc s'aligner différemment selon
2252 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2253 tenir compte des éventuels regroupements, cette fonction peut faire
2254 place à une complète redéfinition des espacements fluctuants à l'aide de
2255 règles dérogatoires comme vu précédemment.
2257 @item default-staff-staff-spacing
2258 Il s'agit de la distance qui s'appliquera par défaut aux portées
2259 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2260 explicitement par un @code{\override}.
2262 @item staff-affinity
2263 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2264 que prendra une ligne de non-portée pour aller s'accoler aux portées
2265 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2266 non-portée ira se placer à équidistance entre les portées qui
2267 l'encadrent, tout en tenant compte des éventuels risques de collision et
2268 autres contraintes d'espacement. Des lignes de non-portée
2269 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2270 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2271 Une ligne de non-portée en dessous d'un système devrait avoir sa
2272 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2273 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2274 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2275 @code{staff-affinity} : si vous affectez la valeur @code{#f} à
2276 une ligne de non-portée, cette ligne sera considérée comme étant une
2277 portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
2278 pour une portée lui fera perdre cette qualité.
2280 @item nonstaff-relatedstaff-spacing
2281 Il s'agit de la distance entre la ligne de non-portée en cours et la
2282 portée la plus proche selon la @code{staff-affinity}, à la double
2283 condition qu'il n'y ait pas déjà une autre ligne de non-portée et que la
2284 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2285 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2286 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2287 non-portée entre les deux portées adjacentes même si une autre
2288 non-portée est présente (quelque soit le côté). Le positionnement
2289 d'une ligne de non-portée dépend donc à la fois des portées tout
2290 comme des autres lignes de non-portée adjacentes. L'affectation
2291 d'une faible valeur à la propriété @code{stretchability} de l'un
2292 de ces types d'espacement les avantagera ; leur affecter une
2293 grande valeur aura pour conséquence de diminuer leur influence.
2296 @c traduction approximative des dernières phrases, qui manquent de
2297 @c précision : QUI EST AVANTAGÉ OU NON ?
2299 This means that the placement of a non-staff line depends
2300 on both the surrounding staves and the surrounding non-staff lines.
2301 Setting the @code{stretchability} of one of these types of spacing to
2302 a small value will make that spacing dominate. Setting the
2303 @code{stretchability} to a large value will make that spacing have
2307 @item nonstaff-nonstaff-spacing
2308 Il s'agit de la distance entre deux lignes de non-portée selon
2309 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2310 la même orientation. Bien entendu, ceci ne peut concerner que les
2311 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2313 @item nonstaff-unrelatedstaff-spacing
2314 Il s'agit de la distance entre une ligne de non-portée et la portée à
2315 l'opposé de l'orientation adoptée, à la double condition qu'il n'y ait
2316 pas déjà une autre ligne de non-portée et que la valeur de
2317 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2318 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2319 portée à laquelle elle ne correspond pas.
2323 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2324 @c VO Properties of the @code{StaffGrouper} grob
2326 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2327 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2331 @item staff-staff-spacing
2332 Il s'agit de la distance entre deux portées consécutives d'un même
2333 système. La propriété @code{staff-staff-spacing} de l'objet
2334 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2335 l'aide de règles dérogatoires.
2337 @item staffgroup-staff-spacing
2338 Il s'agit de la distance entre la dernière portée d'un regroupement et
2339 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2340 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2341 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2342 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2343 regroupement a été ajustée au niveau de son propre
2344 @code{VerticalAxisGroup}, cette dernière aura préséance.
2348 Manuel de notation :
2349 @ref{Variables d'espacement vertical fluctuant},
2350 @ref{Modification de listes associatives}.
2352 Fichiers d'initialisation :
2353 @file{ly/engraver-init.ly},
2354 @file{scm/define-grobs.scm}.
2356 Référence des propriétés internes :
2357 @rinternals{Contexts},
2358 @rinternals{VerticalAxisGroup},
2359 @rinternals{StaffGrouper}.
2362 @node Espacement de portées isolées
2363 @unnumberedsubsubsec Espacement de portées isolées
2364 @translationof Spacing of ungrouped staves
2366 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2367 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2370 L'espacement de ces @i{portées isolées} est géré par les propriétés
2374 @item Propriétés du @code{VerticalAxisGroup} :
2376 @item @code{default-staff-staff-spacing}
2377 @item @code{staff-staff-spacing}
2381 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2382 @ref{Propriétés d'espacement au sein d'un système}.
2384 Certaines propriétés supplémentaires s'appliqueront dès lors que
2385 ces portées sont regroupées -- voir
2386 @ref{Espacement de portées regroupées}.
2388 L'exemple suivant illustre la manière de gérer l'espacement de portées
2389 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2390 Les mêmes règles appliquées de manière dérogatoire au
2391 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2392 sein de regroupements.
2394 @lilypond[verbatim,quote,staffsize=16]
2398 \override VerticalAxisGroup.default-staff-staff-spacing =
2399 #'((basic-distance . 8)
2400 (minimum-distance . 7)
2406 % The very low note here needs more room than 'basic-distance
2407 % can provide, so the distance between this staff and the next
2408 % is determined by 'padding.
2409 \new Staff { b,2 r | }
2411 % Here, 'basic-distance provides enough room, and there is no
2412 % need to compress the space (towards 'minimum-distance) to make
2413 % room for anything else on the page, so the distance between
2414 % this staff and the next is determined by 'basic-distance.
2415 \new Staff { \clef bass g2 r | }
2417 % By setting 'padding to a negative value, staves can be made to
2418 % collide. The lowest acceptable value for 'basic-distance is 0.
2420 \override VerticalAxisGroup.default-staff-staff-spacing =
2421 #'((basic-distance . 3.5)
2423 } { \clef bass g2 r | }
2424 \new Staff { \clef bass g2 r | }
2429 Fichiers d'initialisation :
2430 @file{scm/define-grobs.scm}.
2433 @rlsrnamed{Spacing,Espacements}.
2435 Référence des propriétés internes :
2436 @rinternals{VerticalAxisGroup}.
2439 @node Espacement de portées regroupées
2440 @unnumberedsubsubsec Espacement de portées regroupées
2441 @translationof Spacing of grouped staves
2443 Dans les partitions orchestrales ou de grande ampleur, il arrive
2444 souvent que des portées soient regroupées. L'espacement est alors plus
2445 important entre deux regroupements qu'entre les portées d'un même
2448 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2449 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2450 une ou plusieurs portées.
2452 L'espacement entre les portées d'un même regroupement est géré par les
2453 propriétés suivantes :
2456 @item Propriétés du @code{VerticalAxisGroup} :
2458 @item @code{staff-staff-spacing}
2460 @item Propriétés du @code{StaffGrouper} :
2462 @item @code{staff-staff-spacing}
2463 @item @code{staffgroup-staff-spacing}
2467 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2468 @ref{Propriétés d'espacement au sein d'un système}.
2470 L'exemple suivant illustre la manière de gérer l'espacement de portées
2471 regroupées, à l'aide des propriétés de l'objet graphique
2472 @code{StaffGrouper} :
2474 @lilypond[verbatim,quote,staffsize=16]
2478 \override StaffGrouper.staff-staff-spacing.padding = #0
2479 \override StaffGrouper.staff-staff-spacing.basic-distance = #1
2484 \new PianoStaff \with {
2485 \override StaffGrouper.staffgroup-staff-spacing.basic-distance = #20
2500 Fichiers d'initialisation :
2501 @file{scm/define-grobs.scm}.
2504 @rlsrnamed{Spacing,Espacements}.
2506 Référence des propriétés internes:
2507 @rinternals{VerticalAxisGroup},
2508 @rinternals{StaffGrouper}.
2511 @node Espacement des lignes rattachées à des portées
2512 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2513 @translationof Spacing of non-staff lines
2515 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2516 @code{ChordNames} sont des contextes dont les objets de rendu sont
2517 gravés à l'instar des portées -- une ligne horizontale dans un système.
2518 En fait, les lignes de non-portée sont des contextes qui vont créer un
2519 objet de rendu @code{VerticalAxisGroup}.
2521 L'espacement des lignes de non-portée est géré par les propriétés
2525 @item Propriétés du @code{VerticalAxisGroup} :
2527 @item @code{staff-affinity}
2528 @item @code{nonstaff-relatedstaff-spacing}
2529 @item @code{nonstaff-nonstaff-spacing}
2530 @item @code{nonstaff-unrelatedstaff-spacing}
2534 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2535 @ref{Propriétés d'espacement au sein d'un système}.
2537 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2538 pour gérer l'espacement entre des lignes consécutives de non-portée.
2539 Vous noterez que la valeur élevée attribuée à la clé
2540 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2542 @lilypond[verbatim,quote,staffsize=16]
2546 \override VerticalAxisGroup.nonstaff-nonstaff-spacing.stretchability = #1000
2553 \override VerticalAxisGroup.staff-staff-spacing = #'((basic-distance . 30))
2556 \override VerticalAxisGroup.staff-affinity = #UP
2559 \override VerticalAxisGroup.staff-affinity = #CENTER
2560 } \lyricmode { center }
2562 \override VerticalAxisGroup.staff-affinity = #DOWN
2563 } \lyricmode { down }
2569 Fichiers d'initialisation :
2570 @file{ly/engraver-init.ly},
2571 @file{scm/define-grobs.scm}.
2574 @rlsrnamed{Spacing,Espacements}.
2576 @c @lsr{spacing,page-spacing.ly},
2577 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2579 Référence des propriétés internes :
2580 @rinternals{Contexts},
2581 @rinternals{VerticalAxisGroup}.
2584 @node Positionnement explicite des portées et systèmes
2585 @subsection Positionnement explicite des portées et systèmes
2586 @translationof Explicit staff and system positioning
2588 Pour bien comprendre comment fonctionnent les réglages de
2589 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2590 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2591 les différentes mises au point du décalage vertical appliqué aux portées
2592 et systèmes distribués sur une page.
2594 Une autre approche de l'espacement vertical est le recours à
2595 @code{NonMusicalPaperColumn.line-break-system-details}. Alors que
2596 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2597 @code{NonMusicalPaperColumn.line-break-system-details} spécifiera le
2598 positionnement vertical absolu sur la page.
2600 @code{NonMusicalPaperColumn.line-break-system-details} prend en charge
2601 une liste associative de trois mises au point :
2604 @item @code{X-offset}
2605 @item @code{Y-offset}
2606 @item @code{alignment-distances}
2609 Les dérogations en matière d'objet graphique, y compris celles
2610 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2611 à trois différents endroits de votre fichier source :
2614 @item directement au beau milieu des notes
2615 @item au sein d'un bloc @code{\context}
2616 @item dans un bloc @code{\with}
2619 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2620 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2621 @code{\with}. Dans le cas où il est stipulé au fil des notes, c'est la
2622 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2623 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2624 de la commande @code{\overrideProperty} :
2627 \overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20))
2629 \overrideProperty NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 40))
2631 \overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20)
2634 \overrideProperty NonMusicalPaperColumn.line-break-system-details #'((alignment-distances . (15)))
2636 \overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20)
2638 (alignment-distances . (15)))
2641 Nous allons maintenant voir ces différents réglages en action.
2642 Commençons par examiner un exemple dépourvu de toute mise au point.
2644 @c \book { } is required in these examples to ensure the spacing
2645 @c overrides can be seen between systems. -np
2647 @lilypond[verbatim,quote,staffsize=16]
2648 \header { tagline = ##f }
2649 \paper { left-margin = 0\mm }
2659 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2662 \repeat unfold 15 { d'4 d' d' d' }
2669 Cette partition isole les informations de saut de ligne ou de page dans
2670 une voix spécifique. La mise en forme est ainsi séparée des événements
2671 musicaux ; ceci nous permettra d'y voir plus clair au fur et à
2672 mesure que nous avancerons. Pour plus de précisions, relisez
2673 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2675 Les @code{\break} explicites répartissent la musique en lignes de six
2676 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2677 par défaut. Nous pouvons, afin de fixer explicitement le point
2678 d'attache vertical de chacun des systèmes, définir un doublet
2679 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2680 de l'objet @code{NonMusicalPaperColumn} :
2682 @lilypond[verbatim,quote,staffsize=16]
2683 \header { tagline = ##f }
2684 \paper { left-margin = 0\mm }
2690 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0))
2692 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 40))
2694 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 80))
2697 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2700 \repeat unfold 15 { d'4 d' d' d' }
2707 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2708 si la liste associative de @code{line-break-system-details} peut en
2709 comporter un certain nombre. Vous aurez aussi noté que la propriété
2710 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2713 Maintenant que chaque système est explicitement positionné, nous pouvons
2714 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2715 à la sous-propriété @code{alignment-distances} de
2716 @code{line-break-system-details}.
2718 @lilypond[verbatim,quote,staffsize=16]
2719 \header { tagline = ##f }
2720 \paper { left-margin = 0\mm }
2726 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 20)
2727 (alignment-distances . (15)))
2729 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 60)
2730 (alignment-distances . (15)))
2732 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 100)
2733 (alignment-distances . (15)))
2736 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2739 \repeat unfold 15 { d'4 d' d' d' }
2746 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2747 @code{line-break-system-details} de l'objet
2748 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2749 prendre bien d'autres paramètres d'espacement, y compris un doublet
2750 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2751 @code{alignment-distances} pour contrôler le positionnement de chaque
2752 système et de chaque portée. Vous noterez enfin que
2753 @code{alignment-distances} traite le positionnement des portées, non
2754 d'un regroupement de portées.
2756 @lilypond[verbatim,quote,staffsize=16]
2757 \header { tagline = ##f }
2758 \paper { left-margin = 0\mm }
2764 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0)
2765 (alignment-distances . (30 10)))
2767 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 60)
2768 (alignment-distances . (10 10)))
2770 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 100)
2771 (alignment-distances . (10 30)))
2774 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2777 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2778 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2785 Quelques points à prendre en considération :
2789 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2790 autres lignes de non-portée ne comptent pas pour une portée.
2793 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2794 @code{alignment-distances} sont considérés comme des multiples de la
2795 distance entre des portées adjacentes. Des valeurs positives remontent
2796 les portées et paroles, des valeurs négatives les descendent.
2799 Dans la mesure où @code{NonMusicalPaperColumn.line-break-system-details}
2800 permet de positionner systèmes et portées n'importe où sur une page,
2801 vous pourriez être en contradiction avec les dimensionnements de la
2802 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2803 quant aux différentes valeurs que vous affectez à ces réglages.
2809 @rlsrnamed{Spacing,Espacements}.
2812 @node Résolution des collisions verticales
2813 @subsection Résolution des collisions verticales
2814 @translationof Vertical collision avoidance
2816 @funindex outside-staff-priority
2817 @funindex outside-staff-padding
2818 @funindex outside-staff-horizontal-padding
2820 Vous savez de manière intuitive qu'un certain nombre d'objets en
2821 matière de notation musicale appartiennent à la portée, et que
2822 d'autres se placent en dehors de la portée. Entre autres objets
2823 externes, nous avons les marques repères, les textes et les
2824 nuances ; nous les appellerons @qq{objets extérieurs à la portée}.
2825 La règle adoptée par LilyPond pour positionner verticalement ces
2826 objets extérieurs consiste à les placer au plus près de la portée
2827 tout en prenant garde d'éviter qu'il y ait chevauchement.
2829 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2830 déterminer si un objet est ou non un objet extérieur à la portée :
2831 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2832 s'agit d'un objet extérieur à la portée. De plus, la propriété
2833 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2834 objets doivent être disposés.
2836 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2837 Les objets extérieurs à la portée sont alors triés selon l'ordre
2838 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2839 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2840 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2841 lorsque deux objets devraient se placer au même endroit, celui dont la
2842 @code{outside-staff-priority} est la plus faible sera disposé au plus
2845 @lilypond[quote,ragged-right,relative=2,verbatim]
2848 \once \override TextScript.outside-staff-priority = #1
2849 c4_"Text"\pp % this time the text will be closer to the staff
2851 % by setting outside-staff-priority to a non-number,
2852 % we disable the automatic collision avoidance
2853 \once \override TextScript.outside-staff-priority = ##f
2854 \once \override DynamicLineSpanner.outside-staff-priority = ##f
2855 c4_"Text"\pp % now they will collide
2858 Le décalage vertical entre un objet extérieur à la portée et celui qui
2859 le précède se contrôle par la propriété @code{outside-staff-padding}.
2862 @lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
2863 \once \override TextScript.outside-staff-padding = #0
2864 a'^"Ce texte est placé au plus près de la note"
2865 \once \override TextScript.outside-staff-padding = #3
2866 c^"Ce texte est décalé par rapport au texte précédent"
2867 c^"Ce texte est accolé au texte précédent"
2870 Par défaut, les objets extérieurs à la portée sont positionnés en
2871 évitant les collisions horizontales avec des objets précédemment
2872 positionnés. Ceci peut cependant générer des situations où des objets
2873 se trouvent horizontalement trop proches. L'espacement vertical entre
2874 les portées peut dans une certaine mesure permettre de mieux intercaler
2875 les objets extérieurs à la portée. La propriété
2876 @code{outside-staff-horizontal-padding} repoussera verticalement un
2877 objet pour éviter ce genre de situation.
2879 @lilypond[quote,ragged-right,relative=2,verbatim]
2880 % the markup is too close to the following note
2884 % setting outside-staff-horizontal-padding fixes this
2886 \once \override TextScript.outside-staff-horizontal-padding = #1
2894 @rlsrnamed{Spacing,Espacements}.
2897 @node Espacement horizontal
2898 @section Espacement horizontal
2899 @translationof Horizontal spacing
2901 @cindex horizontal, espacement
2902 @cindex espacement horizontal
2905 * Généralités sur l'espacement horizontal::
2906 * Changement d'espacement en cours de partition::
2907 * Modification de l'espacement horizontal::
2908 * Longueur de ligne::
2909 * Notation proportionnelle::
2913 @node Généralités sur l'espacement horizontal
2914 @subsection Généralités sur l'espacement horizontal
2915 @translationof Horizontal spacing overview
2917 Le moteur d'espacement traduit les différences de durée en distances
2918 étirables (@emph{springs} pour ressorts) de différentes longueurs. Des
2919 durées importantes prennent ainsi plus de place que des durées moins
2920 longues. Les durées les plus courtes se verront attribuer un espace
2921 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2922 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2923 plus elle prendra d'espace : le doublement d'une durée attribuera à
2924 la note un espace fixé d'après la propriété @code{spacing-increment}.
2926 L'exemple suivant comporte des blanches, des noires et un certain nombre
2927 de croches. La croche est suivie d'un espace de la largeur d'une tête
2928 de note ; pour la noire , cet espace est de deux têtes ; il
2929 est de trois pour la blanche.
2931 @lilypond[quote,verbatim,relative=1]
2932 c2 c4. c8 c4. c8 c4. c8 c8
2936 @code{spacing-increment} est normalement défini à 1,2 espace de
2937 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2938 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2939 s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
2940 @code{spacing-increment}). Le point de départ de cet espace se situe à
2941 l'extrémité gauche du symbole ; la note la plus courte est donc
2942 suivie en général d'un espace égal à la largeur d'une tête de note.
2944 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2945 croche à une partition qui comporte déjà des croches et des doubles
2946 augmentera considérablement son volume : la durée la plus
2947 courte n'est plus la double mais la triple croche, ce qui aura
2948 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2949 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2950 courte prise en considération au niveau de l'espacement n'est pas la
2951 note la plus brève de la partition, mais celle qui apparaît le plus
2954 La courte durée la plus fréquente est déterminée à partir de la note la
2955 plus courte de chaque mesure. C'est elle qui servira de base pour
2956 l'espacement, à cette nuance près que la plus courte durée ne saurait
2957 être strictement supérieure à la croche. Cette @qq{durée de référence}
2958 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2961 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2962 pour les espacements grâce à la propriété
2963 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2964 La durée maximale de cet étalon, normalement la croche, est gérée par la
2965 propriété @code{base-shortest-duration}.
2967 @funindex common-shortest-duration
2968 @funindex base-shortest-duration
2969 @funindex stem-spacing-correction
2972 Les notes plus courtes que la note témoin sont suivies d'un espace
2973 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2974 doubles croches à l'exemple précédent, elles seraient suivies d'une
2975 demie largeur de tête :
2977 @lilypond[quote,verbatim,relative=2]
2978 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2981 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2982 vu comment la direction des hampes peut influencer l'espacement -- voir
2983 @ressay{Espacement}. Ceci est contrôlé par la propriété
2984 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2985 pour chaque contexte @rinternals{Voice}. L'objet
2986 @code{StaffSpacing}, généré au niveau d'un contexte @rinternals{Staff},
2987 possède une même propriété qui contrôlera l'espacement hampe-barre de
2988 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2989 les réglages par défaut, puis avec des corrections forcées.
2991 @lilypond[quote,ragged-right]
2995 \override Staff.NoteSpacing.stem-spacing-correction = #1.5
2996 \override Staff.StaffSpacing.stem-spacing-correction = #1.5
3002 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
3003 @rusernamed{Notation proportionnelle,rubrique dédiée}.
3006 Essai sur la gravure musicale automatisée :
3007 @ressay{Espacement}.
3010 @rlsrnamed{Spacing,Espacements}.
3012 Référence des propriétés internes :
3013 @rinternals{SpacingSpanner},
3014 @rinternals{NoteSpacing},
3015 @rinternals{StaffSpacing},
3016 @rinternals{NonMusicalPaperColumn}.
3019 Il n'existe pas de mécanisme simple et efficace qui permette de
3020 forcer manuellement l'espacement. La solution ci-dessous permet
3021 cependant @qq{d'aérer} artificiellement une partition ; il vous
3022 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
3026 \override Score.NonMusicalPaperColumn.padding = #10
3029 Il n'y a aucun moyen de diminuer l'espacement.
3032 @node Changement d'espacement en cours de partition
3033 @subsection Changement d'espacement en cours de partition
3034 @translationof New spacing area
3036 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
3037 substantiellement la notion de valeur brève et valeur longue. La
3038 commande @code{newSpacingSection} permet alors de réinitialiser les
3039 paramètres d'espacement.
3041 Dans l'exemple qui suit, le changement de métrique marque le début
3042 d'une nouvelle partie ; remarquez comme les doubles-croches sont
3043 alors plus espacées :
3045 @lilypond[relative,verbatim,quote]
3048 c8 c c4 c16[ c c8] c4
3054 La commande @code{\newSpacingSection} crée un nouvel objet
3055 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
3056 @code{\override}s à partir de ce point.
3060 @rlsrnamed{Spacing,Espacements}.
3062 Référence des propriétés internes :
3063 @rinternals{SpacingSpanner}.
3066 @node Modification de l'espacement horizontal
3067 @subsection Modification de l'espacement horizontal
3068 @translationof Changing horizontal spacing
3070 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
3071 @code{base-shortest-duration}. Comparons les deux partitions qui
3072 suivent, toutes deux montrant la même musique. La première partition
3073 applique les réglages par défaut, alors que la seconde bénéficie d'un
3074 ajustement de la propriété @code{base-shortest-duration}. Au plus la
3075 valeur de @code{ly:make-moment} est grande, au plus la musique sera
3076 resserrée. En effet, @code{ly:make-moment} construit une durée :
3077 @code{1 4} est plus long que @code{1 16}.
3079 @lilypond[verbatim,line-width=12\cm]
3082 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3083 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3084 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3085 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3090 @lilypond[verbatim,line-width=12\cm]
3093 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3094 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3095 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3096 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3101 \override SpacingSpanner.base-shortest-duration = #(ly:make-moment 1 16)
3108 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
3109 facteurs qui ne sont pas liés à la durée (altération, changement de
3110 clef, etc.). @code{Score.SpacingSpanner.uniform-stretching}
3111 permet d'ignorer ces symboles et, par voie de conséquence, forcer
3112 l'espacement sur la simple durée. Notez bien que cette propriété
3113 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
3116 @lilypond[quote,ragged-right,verbatim]
3135 \override SpacingSpanner.uniform-stretching = ##t
3141 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
3142 les notes sans tenir compte des clefs, barres de mesure ou notes
3143 d'ornement qui pourraient apparaître :
3145 @lilypond[quote,ragged-right,relative=2,verbatim]
3146 \override Score.SpacingSpanner.strict-note-spacing = ##t
3147 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
3152 @rlsrnamed{Spacing,Espacements}.
3155 @node Longueur de ligne
3156 @subsection Longueur de ligne
3157 @translationof Line length
3159 @cindex saut de page
3161 @cindex ligne, longueur
3164 @funindex line-width
3165 @funindex ragged-right
3166 @funindex ragged-last
3168 @c Although line-width can be set in \layout, it should be set in paper
3169 @c block, to get page layout right.
3170 @c Setting indent in \paper block makes not much sense, but it works.
3172 @c Bit verbose and vague, use examples?
3173 Deux réglages de base ont une influence considérable sur
3174 l'espacement : @code{line-width} et @code{indent}. Tous deux se
3175 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3176 lignes et l'indentation de la première.
3178 L'activation du commutateur @code{ragged-right} au sein du bloc
3179 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3180 de les voir s'étirer sur toute la largeur de la page. Cette option est
3181 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3182 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3183 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3186 @cindex page, mise en forme
3187 @cindex vertical, espacement
3189 Le fonctionnement de l'option @code{ragged-last} est en tout point
3190 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3191 que la dernière ligne de la partition. Il n'y a pas de restriction
3192 quant à cette ligne. Il en va de même que pour le formatage d'un
3193 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3195 @c Note that for text there are several options for the last line.
3196 @c While Knuth TeX uses natural length, lead typesetters use the same
3197 @c stretch as the previous line. eTeX uses \lastlinefit to
3198 @c interpolate between both these solutions.
3210 @rlsrnamed{Spacing,Espacements}.
3213 @node Notation proportionnelle
3214 @subsection Notation proportionnelle
3215 @translationof Proportional notation
3217 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3218 ce cas de représenter la notation selon un espacement strictement
3219 relatif aux durées. Ce type d'espacement pourrait se comparer à
3220 l'utilisation de papier millimétré pour positionner les notes au fil de
3221 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3222 utilisent cette proportionnalité dans le but de clarifier des structures
3223 rythmiques complexes, d'aider au positionnement d'indications
3224 temporelles ou autres éléments graphiques directement dans la partition.
3226 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3227 s'utiliser conjointement ou individuellement, aux fins de mettre au
3228 point cette notation proportionnelle.
3231 @item @code{proportionalNotationDuration}
3233 @item @code{uniform-stretching}
3235 @item @code{strict-note-spacing}
3237 @item @code{\remove "Separating_line_group_engraver"}
3239 @item @code{\override PaperColumn.used = ##t}
3243 Nous allons examiner, dans les différents exemples qui suivent, les
3244 effets de ces réglages et comment ils interagissent.
3246 Commençons par cette mesure toute simple qui utilise l'espacement
3247 classique et justifiée à gauche.
3249 @lilypond[quote,verbatim,ragged-right]
3252 \new RhythmicStaff {
3256 c'16 c'16 c'16 c'16 c'16
3263 Vous constatez que la blanche qui entame la mesure prend moins de la
3264 moitié de l'espace. De même, les doubles croches et le quintolet de
3265 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3266 n'en occupent pas la moitié de l'espace horizontal.
3268 En matière de gravure traditionnelle, cet espacement correspond tout à
3269 fait à nos attentes, puisque nous pouvons rogner de l'espace sur la
3270 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3273 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3274 un autre graphisme en surplomb ou en dessous de notre partition, nous
3275 aurons besoin de la notation proportionnelle. Celle-ci s'active en
3276 définissant la propriété @code{proportionalNotationDuration}.
3278 @lilypond[quote,verbatim,ragged-right]
3281 \new RhythmicStaff {
3285 c'16 c'16 c'16 c'16 c'16
3292 proportionalNotationDuration = #(ly:make-moment 1 20)
3298 La blanche du début et les notes plus rapides de la deuxième moitié de
3299 la mesure occupent maintenant exactement le même espace horizontal.
3300 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3301 temporelle ou autre graphisme.
3303 @code{proportionalNotationDuration} est une propriété attachée au
3304 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3305 propriétés d'un contexte à trois différents endroits de votre
3306 fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
3307 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3308 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3309 de ces trois façons, à l'instar de n'importe quelle définition de
3312 La propriété @code{proportionalNotationDuration} prend en unique
3313 argument la durée de référence qui servira de base pour espacer toute la
3314 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3315 prend deux arguments : un numérateur et un dénominateur qui
3316 représentent une fraction de ronde. L'appel de
3317 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3318 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3319 @code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} ou
3320 @code{(ly:make-moment 3 97)}.
3322 Se pose alors le problème de fournir la juste durée de référence à
3323 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3324 tâtonnement, en commençant par une valeur proche de la note la plus
3325 rapide (la durée la plus courte) du morceau. Au plus la durée de
3326 référence est petite, au plus la musique sera étalée ; à l'inverse,
3327 une durée de référence élevée produira une musique resserrée.
3329 @lilypond[quote,verbatim,ragged-right]
3332 \new RhythmicStaff {
3336 c'16 c'16 c'16 c'16 c'16
3343 proportionalNotationDuration = #(ly:make-moment 1 8)
3350 \new RhythmicStaff {
3354 c'16 c'16 c'16 c'16 c'16
3361 proportionalNotationDuration = #(ly:make-moment 1 16)
3368 \new RhythmicStaff {
3372 c'16 c'16 c'16 c'16 c'16
3379 proportionalNotationDuration = #(ly:make-moment 1 32)
3385 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3386 comme la croche pour la première ligne, a pour conséquence de resserrer
3387 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3388 remarquez aussi que, par principe, la notation proportionnelle occupe
3389 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3390 notation proportionnelle met en évidence le rythme au détriment de
3391 l'espacement horizontal.
3393 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3396 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3397 ajoutons lui une portée incluant un autre type de nolet.
3399 @lilypond[quote,verbatim,ragged-right]
3402 \new RhythmicStaff {
3406 c'16 c'16 c'16 c'16 c'16
3409 \new RhythmicStaff {
3411 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3418 L'espacement est loin d'être idéal, pour la simple raison que
3419 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3420 uniformément. Il est vrai que de telles constructions complexes en
3421 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3422 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3423 @code{proportionalNotationDuration} permet d'arranger les choses.
3425 @lilypond[quote,verbatim,ragged-right]
3428 \new RhythmicStaff {
3432 c'16 c'16 c'16 c'16 c'16
3435 \new RhythmicStaff {
3437 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3444 proportionalNotationDuration = #(ly:make-moment 1 20)
3450 Cependant, si l'on observe de près, il est évident que les notes de la
3451 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3452 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3453 allons activer le @code{uniform-stretching}, propriété attachée au
3454 @code{SpacingSpanner}.
3456 @lilypond[quote,verbatim,ragged-right]
3459 \new RhythmicStaff {
3463 c'16 c'16 c'16 c'16 c'16
3466 \new RhythmicStaff {
3468 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3475 proportionalNotationDuration = #(ly:make-moment 1 20)
3476 \override SpacingSpanner.uniform-stretching = ##t
3482 L'espacement sur les deux portées est maintenant correct, les relations
3483 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3484 une indication temporelle ou autre graphisme selon notre envie.
3486 Notez bien que la prise en charge de la notation proportionnelle par
3487 LilyPond demande que, dans chaque partition, soit activée la propriété
3488 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3489 contraire, utiliser @code{proportionalNotationDuration} aura pour
3490 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3491 inséré des silences invisibles @emph{skip}.
3493 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3494 au contexte @code{Score}. Tout comme pour la propriété
3495 @code{proportionalNotationDuration}, les réglages du
3496 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3497 votre fichier : dans un bloc @code{\with}, dans un bloc
3498 @code{\context} ou au beau milieu de la musique à l'aide de la
3499 commande @code{\set}.
3501 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3502 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3503 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3504 partition. Vous pourriez toutefois avoir besoin de modifier ce
3505 comportement en cours de partition, et recourir alors à l'instruction
3506 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3507 rubrique @ref{Changement d'espacement en cours de partition}.
3509 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3510 qui est désactivé pour la plupart des partitions en notation
3511 proportionnelle. Voici ce qui apparaît dans une partition
3512 traditionnelle : il y a toujours un @qq{espace préservé} juste
3513 avant la première note de chaque portée.
3515 @lilypond[quote,verbatim,ragged-right]
3527 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3528 présent lorsqu'intervient un changement de métrique, d'armure ou de
3529 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3530 réduire cet espace à zéro.
3532 @lilypond[quote,verbatim,ragged-right]
3538 \remove "Separating_line_group_engraver"
3546 Les éléments non musicaux tels que métrique, armure, clef et
3547 altérations, posent problème lorsqu'on travaille en notation
3548 proportionnelle. Bien qu'aucune notion de durée ne leur soit
3549 attachée, ces éléments @qq{consomment} de l'espace. Différentes
3550 approches permettent cependant de gérer ce problème.
3552 Éviter les problèmes d'espacement avec l'armure est chose aisée :
3553 il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
3554 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3555 proportionnelle. Il en va de même pour la métrique, et tout
3556 particulièrement lorsque la partition comporte un quadrillage temporel
3557 ou autres graphismes. L'absence de métrique reste cependant
3558 exceptionnelle et la plupart des partitions en notation proportionnelle
3559 laissent apparaître quelques métriques. Il est par contre pratiquement
3560 impossible de se passer de clef et d'altération.
3562 L'une des options permettant de s'affranchir de l'espacement dû aux
3563 éléments non musicaux consiste en l'activation de la propriété
3564 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3565 les deux portées suivantes :
3567 @lilypond[quote,verbatim,ragged-right]
3569 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3579 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3580 \override Score.SpacingSpanner.strict-note-spacing = ##t
3590 Toutes deux affichent un espacement proportionnel. Cependant, la
3591 première ligne laisse apparaître un espacement plus lâche en raison de
3592 la présence d'un changement de clef. En ce qui concerne la deuxième
3593 ligne, l'espacement est strictement observé dès lors que la propriété
3594 @code{strict-note-spacing} a préalablement été activée. Comme vous
3595 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3596 conséquence que l'algorithme d'espacement ignore tout bonnement la
3597 largeur des métriques, armures, clefs et altérations.
3599 En plus de ceux que nous venons de voir, vous trouverez d'autres
3600 réglages en usage dans la notation proportionnelle comme, entre autres,
3603 @item @code{\override SpacingSpanner.strict-grace-spacing = ##t}
3604 @item @code{tupletFullLength = ##t}
3605 @item @code{\override Beam.breakable = ##t}
3606 @item @code{\override Glissando.breakable = ##t}
3607 @item @code{\override TextSpanner.breakable = ##t}
3608 @item @code{\remove "Forbid_line_break_engraver"} (dans un contexte de voix)
3611 Ces différents réglages permettent un espacement strict des notes
3612 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3613 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3614 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3615 différentes rubriques associées du manuel pour chacun de ces réglages.
3618 Manuel de notation :
3619 @ref{Changement d'espacement en cours de partition}.
3622 @rlsrnamed{Spacing,Espacements}.
3625 @node Réduction du nombre de pages de la partition
3626 @section Réduction du nombre de pages de la partition
3627 @translationof Fitting music onto fewer pages
3629 Vous pourriez un jour être confronté au problème suivant : l'une
3630 des pages de votre partition ne comporte que deux portées alors que,
3631 ce qui est d'autant plus frustrant, l'espace libre sur les autres
3632 pages aurait permis une distribution différente.
3634 L'instruction @code{annotate-spacing} se révèle être un outil
3635 indispensable pour l'analyse des problèmes de mise en forme. Cette
3636 commande met en surimpression la valeur des différentes variables
3637 d'espacement et de mise en forme, comme nous allons le voir dans la
3638 rubrique @ref{Mise en évidence de l'espacement}.
3641 * Mise en évidence de l'espacement::
3642 * Modification de l'espacement::
3646 @node Mise en évidence de l'espacement
3647 @subsection Mise en évidence de l'espacement
3648 @translationof Displaying spacing
3650 @cindex espacement, affichage des valeurs
3651 @funindex annotate-spacing
3653 Le meilleur moyen d'appréhender les différentes variables de
3654 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3655 la mise en page consiste à activer, au sein du bloc @code{\paper}, la
3656 fonction @code{annotate-spacing} :
3658 @c need to have \book{} otherwise we get the separate systems. -hwn
3659 @lilypond[verbatim,quote]
3660 #(set-default-paper-size "a6" 'landscape)
3663 \paper { annotate-spacing = ##t }
3668 Toutes les dimensions sont exprimées en espace de portée
3669 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3670 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3671 feuille (@code{paper-height}) est de 59,75 espaces de portée
3672 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3673 20 points -- sa valeur par défaut. Notez que :
3675 @multitable {1 staff-space} {(staff-size)/4 * (25,4/72,27) mm}
3678 @tab = (25,4/72,27) mm
3681 @tab = (@code{staff-size})/4 pts
3683 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3688 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3689 1,757 millimètres. Les 59,75 @code{staff-spaces} de
3690 @code{paper-height} correspondent donc à 105 millimètres, soit la
3691 hauteur d'une feuille au format A6 à l'italienne. Les paires
3692 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3693 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3696 Manuel de notation :
3697 @ref{Définition de la taille de portée}.
3700 @rlsrnamed{Spacing,Espacements}.
3703 @node Modification de l'espacement
3704 @subsection Modification de l'espacement
3705 @translationof Changing spacing
3707 Les informations fournies par @code{annotate-spacing} en matière de
3708 dimensionnement vertical sont incomparables. Pour plus de détails sur
3709 les manières de modifier marges et autres variables connexes, consultez
3710 la rubrique @ref{Mise en forme de la page}.
3712 En dehors des marges, vous disposez de quelques moyens supplémentaires
3713 pour gagner de l'espace :
3717 Rapprocher les systèmes le plus possible les uns des autres, de telle
3718 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3719 suffisamment pour éviter le blanc en bas de page.
3723 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3724 ragged-last-bottom = ##f
3730 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3731 deux titres. D'une part, le fait de définir un nombre de systèmes --
3732 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3733 systèmes par page dans la mesure où l'une des étapes d'estimation des
3734 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3735 systèmes par page permet d'en disposer plus sur les suivantes. Par
3736 exemple, avec un nombre par défaut de 11 systèmes par pages,
3737 l'instruction suivante le force à 10.
3746 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3747 se répartir sur deux pages.
3756 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3757 Par exemple, un crochet de reprise ou d'alternative consomme de
3758 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3759 diminue d'autant l'espace disponible que si seul le premier ne
3760 comportait l'indication. Autre exemple, les indications de nuance qui
3761 se @qq{détachent} d'un système peuvent être rapprochées de la portée :
3763 @lilypond[verbatim,quote,relative=1]
3765 e4 c g-\tweak X-offset #-2.7 -\tweak Y-offset #2.5 \f c
3769 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3770 comme indiqué à la rubrique
3771 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3772 l'espacement par défaut :
3774 @lilypond[verbatim,quote]
3787 Par contre, le fait de modifier la valeur de la propriété
3788 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3789 -- bien que la noire soit la durée la plus courante, nous prenons une
3790 valeur plus longue -- donnera un effet @qq{resserré} à la musique :
3792 @lilypond[verbatim,quote]
3804 \override SpacingSpanner.common-shortest-duration = #(ly:make-moment 1 2)
3811 La propriété @code{common-shortest-duration} ne peut être modifiée
3812 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3813 s'applique à l'intégralité de la partition.
3818 Manuel de notation :
3819 @ref{Mise en forme de la page},
3820 @ref{Modification de l'espacement horizontal}.
3823 @rlsrnamed{Spacing,Espacements}.