1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 0512fcc5db9b050be664413ba0f79a3dcfc1028a
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Frédéric Chiasson, Jean-Charles Malahieude
17 Negative numbers are allowed:
18 > Are you sure? The following works well
20 > first-page-number = -2
22 > and prints page number -1 on the second page, for example.
25 In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
28 "@code{layout-set-staff-size} does not change the distance between
31 Could we add a sentence:
32 "Use instead the pair fontSize = #@var{N}
33 \override StaffSymbol #'staff-space = #(magstep @var{N})
34 inside the Staff context to change the size of the font and the
35 distance between staff lines accordingly."
37 Actually I found, that the @internalsref{StaffSymbol} at line 481
38 sends to an incomplete documentation. The property staff-space is not
39 explained here. I thought Y-extent might be of help, but it is in turn
40 explained by x-space which again is missing from the list. Who has the
41 knowledge to fix this?
45 http://code.google.com/p/lilypond/issues/detail?id=68
50 @node Gestion de l'espace
51 @chapter Gestion de l'espace
52 @translationof Spacing issues
54 L'agencement général d'une partition dépend de trois facteurs
55 interdépendants : la mise en page, les sauts de ligne et l'espacement.
56 Les choix faits en matière d'espacement détermineront la densité de
57 chacun des systèmes, ce qui influera sur le positionnement des sauts de
58 ligne et, par voie de conséquence, sur le nombre de pages de la
61 En pratique, cette procédure comporte quatre étapes. Dans un premier
62 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
63 base des durées. Sont alors calculées différentes possibilités de saut
64 de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
65 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
66 la combinaison entre sauts de page et de ligne qui offre la meilleure
67 occupation de l'espace, tant horizontalement que verticalement.
69 Les réglages qui influencent la mise en forme se placent dans deux blocs
70 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
71 @ref{Mise en forme de la page} contient les réglages applicables à
72 l'intégralité du document -- à toutes les partitions d'un ouvrage --
73 tels que format du papier, impression ou non des numéros de page etc.
74 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
75 rubrique @ref{Mise en forme de la partition}, il détermine la mise en
76 forme de la musique : le nombre de systèmes utilisés, l'espacement des
77 regroupements de portées, etc.
80 * Mise en forme de la page::
81 * Mise en forme de la partition::
83 * Espacement vertical::
84 * Espacement horizontal::
85 * Réduction du nombre de pages de la partition::
88 @cindex ragged, aligné
89 @cindex aligné, ragged
91 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
92 dont la traduction vous semblera assurément erronée. Il n'en est
93 cependant rien : certains termes techniques ont une histoire
94 particulière selon leur langue d'origine. Ainsi le vocable anglais
95 @emph{Ragged} signifie en lambeau, en loques ; dans l'univers
96 typographique, un maître français voit un alignement à gauche -- il dira
97 @qq{au fer à gauche} -- alors que son homologue anglophone constate un
98 @emph{ragged-right} -- donc du vide à droite.}
101 @node Mise en forme de la page
102 @section Mise en forme de la page
103 @translationof Page layout
105 Nous allons examiner ici les options qui contrôlent la mise en forme des
106 pages attachées au bloc @code{\paper}.
110 * Format du papier et adaptation automatique::
111 * Variables d'espacement vertical fixe::
112 * Variables d'espacement vertical fluctuant::
113 * Variables d'espacement horizontal::
114 * Autres variables du bloc \paper::
119 @subsection Le bloc @code{\paper}
120 @translationof The @code{\paper} block
122 Un bloc @code{\paper} peut apparaître au sein d'un bloc @code{\book}.
123 Les réglages effectués à l'aide du bloc @code{\paper} s'appliqueront à
124 l'intégralité d'un ouvrage, qui peut comporter plusieurs partitions (des
125 blocs @emph{score}) ; il ne doit donc en aucun cas se trouver dans un
126 bloc @code{\score}. Peuvent apparaître dans un bloc @code{\paper} :
131 la fonction Scheme @code{set-paper-size},
134 des variables propres au bloc @code{\paper} qui viendront adapter la
138 la définition des différents @emph{markups} qui personnaliseront la mise
139 en forme des entêtes et pieds de page ainsi que des titrages.
143 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
144 -- @ref{Format du papier et adaptation automatique}. Les variables du
145 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
146 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
147 des entête, pied de page et titrages, elles sont étudiées à la rubrique
148 @ref{Titrages personnalisés}.
150 La plupart des variables gérant le papier ne sont fonctionnelles que
151 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
152 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
153 rubrique @ref{Le bloc \layout}.
155 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
156 correspondent à des dimensions sont exprimées en millimètre -- vous
157 pouvez bien entendu spécifier un autre système de mesure. Voici
158 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
167 Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
168 mentionner le suffixe d'unité @code{\in} :
176 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
177 @code{\in} et @code{\pt}. Ces unités sont des conversions de
178 millimètres, répertoriées dans le fichier
179 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
180 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
181 @code{\mm} à votre code lorsque vous travaillez en millimètres.
183 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
184 fonctions Scheme. Voici l'équivalent de l'exemple précédent :
188 #(define top-margin (* 0.5 in))
194 @ref{Format du papier et adaptation automatique},
195 @ref{Titrages personnalisés}.
196 @ref{Le bloc \layout}.
198 Fichiers d'initialisation :
199 @file{ly/paper-defaults-init.ly}.
202 @node Format du papier et adaptation automatique
203 @subsection Format du papier et adaptation automatique
204 @translationof Paper size and automatic scaling
206 @cindex papier, taille
213 * Adaptation automatique au format::
217 @node Format du papier
218 @unnumberedsubsubsec Format du papier
219 @translationof Setting the paper size
221 LilyPond génère par défaut, et en l'absence de mention explicite d'un
222 format de papier, un fichier imprimable au format A4. Vous pouvez
223 cependant utiliser un autre format à l'aide des deux fonctions
224 @code{set-default-paper-size}, alors que @code{set-paper-size} se place
225 à l'intérieur d'un bloc @code{\paper} :
228 #(set-default-paper-size "quarto")
231 qui se place en début de fichier, ou @code{set-paper-size},
235 #(set-paper-size "tabloid")
239 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 dans 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
262 @c An appendix entry exists for paper sizes but is not auto-generated
264 La commande suivante, inscrite dans votre fichier, vous permettra
265 d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
266 appel à l'aide des fonctions @code{set-default-paper-size} et
267 @code{set-paper-size} :
270 #(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
273 #(set-paper-size "mon format")
277 Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
278 @code{cm} (centimètres) ou en @code{mm} (millimètres).
280 @cindex papier, orientation
281 @cindex landscape, papier
282 @cindex paysage, papier
283 @cindex à l'italienne, papier
285 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
286 stipulant le format du papier, permet d'obtenir une présentation à
287 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
291 #(set-default-paper-size "a6" 'landscape)
294 C'est bien la feuille qui sera basculée, et non la musique.
298 @ref{Adaptation automatique au format},
299 @ref{Formats de papier prédéfinis}.
301 Fichiers d'initialisation :
302 @file{scm/paper.scm}.
305 @node Adaptation automatique au format
306 @unnumberedsubsubsec Adaptation automatique au format
307 @translationof Automatic scaling to paper size
309 Toute modification du format de papier à l'aide des fonctions Scheme
310 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
311 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
312 par l'ajustement d'un certain nombre de variables attachées au bloc
313 @code{\paper} afin qu'elles soient en concordance avec le format
314 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
315 particulière en redéfinissant sa valeur après avoir spécifié le format
316 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
317 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
318 l'étalonnage automatique, bien que spécifier une largeur de papier
319 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
320 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
321 voir avec la mise à l'échelle.
323 L'adaptation automatique affecte les dimensionnements verticaux
324 @code{top-margin} et @code{bottom-margin} -- voir
325 @ref{Variables d'espacement vertical fixe} --, ainsi que les
326 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
327 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
328 @code{indent} et @code{short-indent} -- voir
329 @ref{Variables d'espacement horizontal}.
331 Les valeurs par défaut de ces dimensionnements sont contenues dans le
332 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
333 internes @code{top-margin-default}, @code{bottom-margin-default} etc.
334 correspondant au format par défaut -- papier A4 -- pour lequel
335 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
340 @ref{Variables d'espacement vertical fixe},
341 @ref{Variables d'espacement horizontal}.
343 Fichiers d'initialisation :
344 @file{ly/paper-defaults-init.ly},
345 @file{scm/paper.scm}.
348 @node Variables d'espacement vertical fixe
349 @subsection Variables d'espacement vertical fixe
350 @translationof Fixed vertical spacing @code{\paper} variables
352 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
353 sont automatiquement ajustés selon le format du papier, ce qui peut
354 conduire à un résultat inattendu --
355 voir @ref{Adaptation automatique au format}.}
357 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
358 @file{ly/paper-defaults-init.ly}.
362 @funindex paper-height
364 La hauteur de la feuille. Il s'agit par défaut de la dimension du
365 papier utilisé. Notez bien que cette variable n'affectera pas
366 l'ajustement automatique d'un certain nombre de dimensionnements
372 La marge entre le bord supérieur de la feuille et la surface imprimable.
373 Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
377 @funindex bottom-margin
379 La marge entre la surface imprimable et le bord inférieur de la feuille.
380 Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
384 @funindex ragged-bottom
386 L'activation de cette variable permet de ne pas répartir verticalement
387 les systèmes sur les pages hormis la dernière. La valeur par défaut
388 est @code{#f}. Lorsque la partition ne comporte que deux ou trois
389 systèmes par page, comme pour un conducteur d'orchestre, nous vous
390 conseillons d'activer cette variable.
392 @item ragged-last-bottom
393 @funindex ragged-last-bottom
395 La désactivation de cette variable permet de répartir verticalement les
396 systèmes de la dernière page d'une partition. La valeur par défaut
397 est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
398 deux pages ou plus, de désactiver cette variable.@*
399 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
400 dernière page de chacune des parties -- créées à l'aide d'un bloc
401 @code{\bookpart} -- d'un même ouvrage.
407 @ref{Adaptation automatique au format}.
409 Fichiers d'initialisation :
410 @file{ly/paper-defaults-init.ly}.
413 @rlsrnamed{Spacing, Espacements}.
416 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
417 comme des systèmes à part entière ; ils seront donc affectés par
418 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
419 ajouteront de l'espace avant le premier système de la partition.
421 La définition explicite d'un format de papier annulera tout réglage des
422 marges haute et basse.
425 @node Variables d'espacement vertical fluctuant
426 @subsection Variables d'espacement vertical fluctuant
427 @translationof Flexible vertical spacing @code{\paper} variables
429 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
430 entre différents éléments (marges, titres, systèmes ou mouvements), en
431 dilatation ou compression selon le cas. Un certain nombre de variables
432 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
433 ces dimensionnements.
435 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
436 parlons ici n'influencent en rien l'espacement des portées d'un même
437 système. L'espacement au sein des systèmes est géré par des propriétés
438 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
439 définissent au niveau du bloc @code{\score} -- voir à ce sujet
440 @ref{Espacement vertical au sein d'un système}.
443 * Structure des variables d'espacement vertical fluctuant::
444 * Liste des variables d'espacement vertical fluctuant::
448 @node Structure des variables d'espacement vertical fluctuant
449 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
450 @translationof Structure of flexible vertical spacing alists
452 Chacune de ces variables attachées au bloc @code{\paper} est constituée
453 d'une liste associative @emph{(alist)} à quatre @i{clés} :
458 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
459 par défaut, exprimée en hauteur de portée, séparant les @i{points de
460 référence} de deux éléments, qui évite tout risque de collision en
461 l'absence de dilatation ou compression. Le point de référence d'un
462 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
463 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
464 ligne de @qq{non-portée} viendrait à s'intercaler. Une
465 @code{basic-distance} inférieure à @code{padding} ou
466 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
467 résultant ne saurait être inférieur à @code{padding} ou
468 @code{minimum-distance}.
471 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
472 minimal, exprimé en hauteur de portée, entre les points de référence des
473 deux éléments alors qu'il y a déjà un effet de compression. Une
474 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
475 sans effet, dans la mesure où l'espacement résultant ne saurait être
476 inférieur au @code{padding}.
478 @c TODO: explain skylines somewhere and xref to it from here.
481 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
482 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
483 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
484 sur toute la largeur des deux éléments.
487 @code{stretchability} @emph{(dilatation)} -- le coefficient
488 d'étirement de cet espace. Un coefficient nul permet de figer
489 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
490 positif déterminera la propension d'un espacement à s'étirer, tout
491 en tenant compte du coefficient affecté aux autres espacements.
492 Par exemple, lorsque le coefficient de dilatation d'une dimension est
493 double de celui d'une autre, elle pourra s'étirer deux fois plus que
494 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
495 provoque une @code{programming_error} (erreur de programmation) et est
496 ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
497 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
498 sa valeur est par défaut égale à @code{space}. Notez bien que
499 l'utilisateur ne peut définir une propension à la compression ;
500 elle est en fait égale à
501 (@code{basic-distance} @minus{} @code{minimum-distance}).
505 Lorsque l'impression n'est pas en pleine page -- elle est donc
506 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
507 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
513 @code{basic-distance}, plus
515 @code{minimum-distance} et
517 @code{padding}, augmenté de ce qu'il faut pour éviter les
522 Cependant, lorsque la partition fait plusieurs pages, la dernière page
523 reprendra dans la mesure du possible l'espacement de la page précédente.
525 Les manières de modifier des listes associatives font l'objet d'un
526 @rusernamed{Modification de listes associatives, chapitre spécifique}.
527 L'exemple suivant indique deux façons de modifier une liste associative.
528 La première déclaration intervient sur une seule clé, alors que la
529 deuxième redéfinit complètement la variable.
533 system-system-spacing #'basic-distance = #8
535 score-system-spacing =
537 (basic-distance . 12)
538 (minimum-distance . 6)
539 (stretchability . 12))
544 @node Liste des variables d'espacement vertical fluctuant
545 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
546 @translationof List of flexible vertical spacing @code{\paper} variables
548 Le nom des dimensionnements à hauteur variable sont de la forme
549 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
550 @code{@var{après}} représentent les éléments qui doivent être espacés.
551 La distance s'établit entre les points de référence des deux éléments
552 concernés (voir la rubrique précédente pou plus de précision). Notez
553 bien que, dans les règles de nommage des variables qui suivent, le terme
554 @code{markup} fait référence aussi bien à un @i{markup de titrage}
555 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
556 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
557 distances sont exprimées en espace de portée.
559 Leurs valeurs par défaut sont inscrites dans le fichier
560 @file{ly/paper-defaults-init.ly}.
562 @c TODO: Where do headers/footers fit in? -mp
565 @item markup-system-spacing
566 @funindex markup-system-spacing
568 détermine l'espacement entre un titre ou un @emph{markup} de premier
569 niveau, et le système qui le suit.
571 @item score-markup-spacing
572 @funindex score-markup-spacing
574 détermine l'espacement entre le dernier système et le titre ou
575 @emph{markup} de haut niveau qui le suit.
577 @item score-system-spacing
578 @funindex score-system-spacing
580 détermine l'espacement entre le dernier système d'une partition et le
581 premier système de la partition suivante, en l'absence de titrage ou
582 @emph{markup} qui les sépare.
584 @item system-system-spacing
585 @funindex system-system-spacing
587 détermine l'espacement entre deux systèmes d'un même mouvement.
589 @item markup-markup-spacing
590 @funindex markup-markup-spacing
592 détermine l'espacement entre deux titres ou @emph{markups} de premier
595 @item last-bottom-spacing
596 @funindex last-bottom-spacing
598 détermine la distance entre le dernier système ou le dernier
599 @emph{markup} de haut niveau, et le bas de la surface imprimable --
600 autrement dit le haut de la marge basse.
602 @item top-system-spacing
603 @funindex top-system-spacing
605 détermine l'espace entre le haut de la surface imprimable (le bas de la
606 marge haute) et le milieu du premier système. Cette variable n'est
607 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
610 @item top-markup-spacing
611 @funindex top-markup-spacing
613 détermine l'espace entre le haut de la surface imprimable (le bas de la
614 marge haute) et le premier titre ou @emph{markup} de premier niveau.
615 Cette variable n'est effective qu'en l'absence de système en haut de
622 @ref{Espacement vertical au sein d'un système}.
625 @rlsrnamed{Spacing,Espacements}.
628 @rlsrnamed{Spacing,Espacements}.
631 @node Variables d'espacement horizontal
632 @subsection Variables d'espacement horizontal
633 @translationof Horizontal spacing \paper variables
635 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
636 sont automatiquement ajustés selon le format du papier, ce qui peut
637 conduire à un résultat inattendu --
638 voir @ref{Adaptation automatique au format}.}
641 * Variables de marge et de largeur::
642 * Variables spécifiques pour l'impression recto-verso::
643 * Variables d'indentation et de décalage::
647 @node Variables de marge et de largeur
648 @unnumberedsubsubsec Variables de marge et de largeur
649 @translationof @code{\paper} variables for widths and margins
651 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
652 @file{ly/paper-defaults-init.ly}.
657 @funindex paper-width
659 La largeur de la page. Elle correspond par défaut à la largeur du
660 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
661 matière d'ajustement automatique, cette variable influe sur la variable
662 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
663 @code{paper-width} et @code{line-width}, les valeurs de
664 @code{left-margin} et @code{right-margin} seront recalculées. Voir
665 aussi @code{check-consistency}.
670 la longueur d'un système musical sans indentation et justifiée sur toute
671 la largeur de la page. La valeur par défaut est égale à
672 @code{paper-width}, auquel sont retranchés @code{left-margin} et
673 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
674 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
675 marges seront alors recalculées de telle sorte que les systèmes soient
676 centrés. Voir aussi @code{check-consistency}. La variable
677 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
680 @funindex left-margin
682 la marge entre le bord gauche de la feuille et le début de chaque
683 système. La valeur par défaut est de @code{10\mm} ; elle sera
684 ajustée selon le format du papier. Lorsque vous définissez
685 @code{line-width} et @code{right-margin}, sans modifier la valeur de
686 @code{left-margin}, cette dernière sera alors égale à
687 @code{(paper-width @minus{} line-width @minus{} right-margin)}.
688 Lorsque seule @code{line-width} est définie, les deux marges
690 @code{((paper-width @minus{} line-width) / 2)}, ce
691 qui a pour effet de centrer les systèmes sur la page. Voir aussi
692 @code{check-consistency}.
695 @funindex right-margin
697 La marge entre le bord droit de la page et la fin des systèmes en pleine
698 largeur (non @emph{ragged}). La valeur par défaut est
699 de @code{10\mm} et s'ajustera selon le format du papier. Lorsque
700 vous définissez @code{line-width} et @code{left-margin}, sans modifier
701 la valeur de @code{right-margin}, cette dernière sera alors égale à
702 @code{(paper-width @minus{} line-width @minus{} left-margin)}.
703 Lorsque seule @code{line-width} est définie, les deux marges
705 @code{((paper-width @minus{} line-width) / 2)}, ce
706 qui a pour effet de centrer les systèmes sur la page. Voir aussi
707 @code{check-consistency}.
709 @item check-consistency
710 @funindex check-consistency
712 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
713 @code{line-width} et @code{right-margin} sont en cohérence, et que
714 l'addition de ces trois éléments ne dépassera pas la largeur du papier
715 (@code{paper-width}). La valeur par défaut est @code{#t}. Dans
716 le cas d'une incohérence, un message d'avertissement est émis et les
717 trois variables -- marges et longueur de ligne -- rétablies à leur
718 valeur par défaut (ajustées selon le format du papier).
721 @funindex ragged-right
723 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
724 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
725 La valeur par défaut est @code{#f} mais, si la partition ne comporte
726 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
727 se gérer au sein d'un bloc @code{\layout}.
730 @funindex ragged-last
732 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
733 dernier système de façon à occuper toute la longueur de la ligne. La
734 valeur par défaut est @code{#f}. Cette variable peut aussi
735 se gérer au sein d'un bloc @code{\layout}.
741 @ref{Adaptation automatique au format}.
743 Fichiers d'initialisation :
744 @file{ly/paper-defaults-init.ly}.
747 La définition explicite d'un format de papier annulera tout réglage des
748 marges gauche et droite.
751 @node Variables spécifiques pour l'impression recto-verso
752 @unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
753 @translationof @code{\paper} variables for two-sided mode
755 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
756 @file{ly/paper-defaults-init.ly}.
766 Cette variable permet de gérer efficacement les impressions recto-verso.
767 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
768 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
769 différentes marges selon qu'il s'agit d'une page paire ou impaire.
770 Cette variable s'applique en lieu et place de @code{left-margin} et
771 @code{right-margin}. La valeur par défaut est @code{#f}.
774 @funindex inner-margin
776 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
777 avoir du côté intérieur. Bien entendu, cette variable n'est
778 effective que lorsque vous comptez générer un fichier imprimable en
779 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
780 défaut est de @code{10\mm} et s'ajustera selon le format du papier.
783 @funindex outer-margin
785 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
786 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
787 variable n'est effective que lorsque vous comptez générer un fichier
788 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
789 La valeur par défaut est de @code{20\mm} et s'ajustera selon le
793 @funindex binding-offset
795 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
796 valeur de la marge intérieure @code{inner-margin} de telle sorte que
797 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
798 effective que lorsque vous comptez générer un fichier imprimable en
799 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
800 défaut est de @code{0} et s'ajustera selon le format du papier.
806 @ref{Adaptation automatique au format}.
808 Fichiers d'initialisation :
809 @file{ly/paper-defaults-init.ly}.
812 @node Variables d'indentation et de décalage
813 @unnumberedsubsubsec Variables d'indentation et de décalage
814 @translationof @code{\paper} variables for shifts and indents
816 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
817 @file{ly/paper-defaults-init.ly}.
821 @item horizontal-shift
822 @funindex horizontal-shift
824 @c This default value is buried in the middle of page.scm. -mp
826 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
827 seront poussés d'autant vers la droite. la valeur par défaut est
833 Le niveau d'indentation du premier système d'une partition. La valeur
834 par défaut est de @code{15\mm} et s'ajustera selon le format du
835 papier. Cette variable peut aussi se gérer au sein d'un bloc
839 @funindex short-indent
841 Le niveau d'indentation de tous les systèmes hormis le premier. La
842 valeur par défaut est de @code{0}, et s'ajustera selon le format du
843 papier dès lors que vous lui affecterez une valeur. Cette variable peut
844 aussi se gérer au sein d'un bloc @code{\layout}.
850 @ref{Adaptation automatique au format}.
852 Fichiers d'initialisation :
853 @file{ly/paper-defaults-init.ly}.
856 @rlsrnamed{Spacing, Espacements}.
859 @node Autres variables du bloc \paper
860 @subsection Autres variables du bloc @code{\paper}
861 @translationof Other @code{\paper} variables
864 * Variables de gestion des sauts de ligne::
865 * Variables de gestion des sauts de page::
866 * Variables de gestion des numéros de page::
867 * Variables supplémentaires::
871 @node Variables de gestion des sauts de ligne
872 @unnumberedsubsubsec Variables de gestion des sauts de ligne
873 @translationof @code{\paper} variables for line breaking
875 @c TODO: Mention that ly:optimal-breaking is on by default? -mp
879 @item max-systems-per-page
880 @funindex max-systems-per-page
882 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
883 variable n'est prise en compte, à ce jour, que par l'option
884 @code{ly:optimal-breaking}, et n'est pas définie.
886 @item min-systems-per-page
887 @funindex min-systems-per-page
889 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
890 cependant aux risques de débordement s'il est trop important. Cette
891 variable n'est prise en compte, à ce jour, que par l'option
892 @code{ly:optimal-breaking}, et n'est pas définie.
894 @item systems-per-page
895 @funindex systems-per-page
897 Le nombre de systèmes que devrait comporter chaque page. Cette variable
898 n'est à ce jour prise en charge que par l'algorithme
899 @code{ly:optimal-breaking} et n'est pas définie par défaut.
902 @funindex system-count
904 Le nombre de systèmes requis par la partition. Cette variable n'est pas
905 définie par défaut. Cette variable peut se gérer au sein d'un bloc
912 @ref{Sauts de ligne}.
915 @node Variables de gestion des sauts de page
916 @unnumberedsubsubsec Variables de gestion des sauts de page
917 @translationof @code{\paper} variables for page breaking
919 Les valeurs par défaut sont définies dans le fichier
920 @file{ly/paper-defaults-init.ly}.
924 @item blank-after-score-page-force
925 @funindex blank-after-score-page-force
927 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
928 valeur est par défaut inférieure à celle de
929 @code{blank-page-force} ; nous préférons qu'une page blanche
930 s'insère après la fin de la partition plutôt qu'au milieu.
932 @item blank-last-page-force
933 @funindex blank-last-page-force
935 Pénalité pour fin de partition intervenant sur une page impaire. La
936 valeur par défaut est de @code{0}.
938 @item blank-page-force
939 @funindex blank-page-force
941 Pénalité pour apparition d'une page blanche en cours de partition.
942 L'algorithme @code{ly:optimal-breaking} n'en tiendra pas compte
943 puisqu'il ne conçoit pas la présence d'une page blanche au milieu d'une
944 partition. La valeur par défaut est de @code{5}.
947 @funindex page-breaking
949 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
950 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking} et
951 @code{ly:optimal-breaking}.
953 @item page-breaking-system-system-spacing
954 @funindex page-breaking-system-system-spacing
956 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
957 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
958 lorsque @code{page-breaking-system-system-spacing #'padding} a une
959 valeur nettement supérieure à @code{system-system-spacing #'padding},
960 l'algorithme en question aura tendance à disposer moins de systèmes sur
961 une même page. Cette variable est par défaut non définie.
966 Le nombre de pages que devra comporter la partition. Cette variable est
967 par défaut non définie.
974 @ref{Optimisation des sauts de page},
975 @ref{Optimisation des tournes},
976 @ref{Minimisation des sauts de page},
977 @ref{Présentation en rouleau}.
979 Fichiers d'initialisation :
980 @file{ly/paper-defaults-init.ly}.
983 @node Variables de gestion des numéros de page
984 @unnumberedsubsubsec Variables de gestion des numéros de page
985 @translationof @code{\paper} variables for page numbering
987 Les valeurs par défaut sont définies dans le fichier
988 @file{ly/paper-defaults-init.ly}.
992 @item auto-first-page-number
993 @funindex auto-first-page-number
995 L'algorithme qui gère les sauts de page prend en compte le fait que le
996 premier numéro de page soit pair ou impair. Lorsque cette
997 fonctionnalité est activée, l'algorithme des sauts de page décidera de
998 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
999 par un éventuel incrément de un. La valeur par défaut
1002 @item first-page-number
1003 @funindex first-page-number
1005 Le numéro de la première page. La valeur par défaut est
1008 @item print-first-page-number
1009 @funindex print-first-page-number
1011 Cette variable permet d'imprimer le numéro de page y compris sur la
1012 première. La valeur par défaut est @code{#f}.
1014 @item print-page-number
1015 @funindex print-page-number
1017 La désactivation de cette variable permet d'obtenir des pages non
1018 numérotées. La valeur par défaut est @code{#t}.
1023 Fichiers d'initialisation :
1024 @file{ly/paper-defaults-init.ly}.
1027 Les pages au numéro impair sont toujours à droite. Pour que la musique
1028 commence en page 1, le dos de la page de garde doit être vide de telle
1029 sorte que la page une se retrouve à droite.
1032 @node Variables supplémentaires
1033 @unnumberedsubsubsec Variables supplémentaires
1034 @translationof Miscellaneous @code{\paper} variables
1038 @item page-spacing-weight
1039 @funindex page-spacing-weight
1041 Cette variable définit l'importance relative des espacements entre la
1042 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1043 privilégiera l'espacement au niveau de la page. La valeur par défaut
1046 @item print-all-headers
1047 @funindex print-all-headers
1049 Lorsque cette variable est activée, l'intégralité des champs d'entête
1050 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1051 champs @code{piece} et @code{opus}. La valeur par défaut
1054 @item system-separator-markup
1055 @funindex system-separator-markup
1057 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1058 chaque système, comme on le voit dans nombre de partitions orchestrales.
1059 Cette variable n'est pas définie par défaut. La commande
1060 @code{\slashSeparator} -- définie dans le fichier
1061 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1064 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1065 #(set-default-paper-size "a8")
1069 system-separator-markup = \slashSeparator
1075 \relative c'' { c1 \break c1 \break c1 }
1083 Fichiers d'initialisation :
1084 @file{ly/titling-init.ly}.
1087 @rlsrnamed{Spacing,Espacements}.
1090 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1091 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1094 @node Mise en forme de la partition
1095 @section Mise en forme de la partition
1096 @translationof Score layout
1098 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1099 plus particulièrement destinées à gérer la mise en forme de la
1104 * Définition de la taille de portée::
1108 @node Le bloc \layout
1109 @subsection Le bloc @code{\layout}
1110 @translationof The @code{\layout} block
1114 Alors que le bloc @code{\paper} définit le formatage des pages pour
1115 l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
1116 forme spécifique à la partition. La mise en forme de la musique peut
1117 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1118 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1119 où la mise en forme concerne une partition en particulier, un bloc
1120 @code{\layout} se placera au sein du bloc @code{\score} en question.
1121 Sont susceptibles d'apparaître dans un bloc @code{\layout} :
1125 la fonction Scheme @code{layout-set-staff-size},
1128 dans des blocs @code{\context}, les modifications apportées aux
1129 différents contextes, et
1132 les variables normalement attachées au bloc @code{\paper} qui
1133 affecteront la mise en forme de la partition.
1137 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1138 suivante, @ref{Définition de la taille de portée}. La modification des
1139 contextes est abordée dans d'autres chapitres -- voir
1140 @ref{Modification des greffons de contexte} et
1141 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1142 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1143 @code{\layout} sont :
1148 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1149 (voir @ref{Variables de marge et de largeur})
1152 @code{indent} et @code{short-indent}
1153 (voir @ref{Variables d'indentation et de décalage})
1157 (voir @ref{Variables de gestion des sauts de ligne})
1161 Voici un exemple de bloc @code{\layout} :
1168 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #8
1172 \override TextScript #'padding = #1
1173 \override Glissando #'thickness = #3
1178 Il est tout à fait possible que plusieurs blocs @code{\layout}
1179 cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
1180 particulièrement utile lorsque différents réglages sont stockés dans des
1181 fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
1182 @code{\layout} est évalué, une copie de la configuration du
1183 @code{\layout} actuel est réalisée en interne, augmentée des
1184 aménagements apportés. Bien qu'on puisse considérer que le contenu des
1185 différents blocs @code{\layout} se cumule, c'est la dernière adaptation
1186 qui aura préséance en cas de situation conflictuelle -- cas typique
1187 d'une même propriété modifiée dans différents blocs.
1189 Par exemple, placer le bloc suivant
1195 \override TextScript #'color = #magenta
1196 \override Glissando #'thickness = #1.5
1201 après celui de l'exemple précédent aura pour effet de cumuler les
1202 adaptations de @code{'padding} et @code{'color} pour l'objet
1203 @code{TextScript}, mais la dernière adaptation apportée à la propriété
1204 @code{'thickness} de @code{Glissando} remplace, ou masque, celle
1205 précédemment établie.
1207 Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
1208 les utiliser ultérieurement. Ceci requiert toutefois une attention
1209 particulière dans la mesure où cette manière de procéder n'est pas
1210 équivalente à un définition complète et globale.
1212 Lorsque nous définissons la variable suivante,
1215 layoutVariable = \layout @{
1218 \override NoteHead #'font-size = #4
1223 qui contient une configuration de @code{\layout} avec
1224 l'adaptation @code{NoteHead #'font-size}, cette combinaison n'est pas
1225 enregistrée en tant que configuration courante. Notez bien que la
1226 « configuration courante » est lue lorsque la variable est définie, non
1227 lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
1228 variable dépend de l'endroit où elle se trouve dans le code source.
1230 Notre variable peut alors être utilisée au sein d'un autre bloc
1231 @code{\layout}, comme par exemple :
1238 \override NoteHead #'color = #red
1243 Un bloc @code{\layout} qui contient une variable comme ci-dessus, ne
1244 recopie pas la configuration actuelle ; il utilise en fait le contenu de
1245 @code{layoutVariable} en tant que configuration de base pour les
1246 adaptations ultérieures, en conséquence de quoi toute modification
1247 intervenant entre la définition et l'utilisation de la variable sera
1250 Si @code{layoutVariable} est définie, ou rapatriée par un
1251 @code{\indude}, juste avant d'être utilisée, son contenu devient la
1252 configuration actuelle augmentée des adaptations que la variable
1253 contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
1254 ci-dessus, le bloc @code{\layout} final contiendra donc :
1257 TextScript #'padding = #1
1258 TextScript #'color = #magenta
1259 Glissando #'thickness = #1.5
1260 NoteHead #'font-size = #4
1261 NoteHead #'color = #red
1264 ainsi que les adaptations à @code{indent} et @code{StaffGrouper}.
1266 Cependant, si la variable avait été définie bien avant le premier bloc
1267 @code{\layout}, la configuration actuelle ne contiendrait que
1270 NoteHead #' font-size= #4 % (written in the variable definition)
1271 NoteHead #' color = #red % (added after the use of the variable)
1274 Une gestion attentive des variables de @code{\layout} se révèle être un
1275 outil précieux dans la mise en forme des sources et le retour à une
1276 configuration donnée.
1279 Manuel de notation :
1280 @ref{Modification des réglages par défaut d'un contexte}.
1283 @rlsrnamed{Spacing,Espacements}.
1286 @node Définition de la taille de portée
1287 @subsection Définition de la taille de portée
1288 @translationof Setting the staff size
1290 @cindex fonte, définition de la taille
1291 @cindex portée, définition de la taille
1292 @funindex layout file
1294 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1295 20 points. Il existe deux manières de la modifier :
1297 La taille des portées peut se définir globalement pour toutes les
1298 partitions d'un même fichier, ou plus précisément d'un bloc
1299 @code{\book}, à l'aide de @code{set-global-staff-size}.
1302 #(set-global-staff-size 14)
1306 Ceci définit donc la hauteur des portées à 14 points par
1307 défaut ; toutes les fontes seront ajustées en conséquence.
1310 Vous pouvez aussi spécifier une taille à une partition en particulier en
1311 procédant comme ci-dessous :
1317 #(layout-set-staff-size 15)
1322 La fonte Feta fournit les symboles musicaux dans huit tailles
1323 différentes. Chaque fonte correspond à une hauteur particulière de
1324 portée ; les petites tailles comportent des symboles plus épais
1325 pour être cohérent avec l'épaisseur relativement plus importante des
1326 lignes de la portée. Le tableau suivant répertorie les différentes
1330 @multitable @columnfractions .15 .2 .22 .2
1332 @item @b{nom de la fonte}
1333 @tab @b{hauteur de portée (pt)}
1334 @tab @b{hauteur de portée (mm)}
1335 @tab @b{utilisation}
1340 @tab format de poche
1360 @tab carnet de chant
1365 @tab partition standard
1376 @c matériel de location moderne ?
1381 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1382 contexte @code{fontSize} ainsi que la propriété de mise en forme
1383 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1384 individuellement la taille de chaque portée. La taille de chacune des
1385 portées est relative à la taille globale.
1388 Manuel de notation :
1389 @ref{Indication de la taille de fonte musicale}.
1392 @rlsrnamed{Spacing,Espacements}.
1395 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1396 lignes d'une portée.
1401 @translationof Breaks
1406 * Optimisation des sauts de page::
1407 * Optimisation des tournes::
1408 * Minimisation des sauts de page::
1409 * Présentation en rouleau::
1410 * Sauts explicites::
1411 * Recours à une voix supplémentaire pour gérer les sauts::
1415 @node Sauts de ligne
1416 @subsection Sauts de ligne
1417 @translationof Line breaking
1419 @cindex saut de ligne
1420 @cindex ligne, passer à la suivante
1422 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1423 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1424 trop aérée, et que des lignes consécutives aient à peu près la même
1427 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1428 vous le jugez utile pour @qq{forcer} le passage à la ligne
1431 @lilypond[quote,ragged-right,relative=2,verbatim]
1436 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1437 mesure ; LilyPond vous le signalera par un message si tel était le
1438 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1439 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1440 l'aide de @code{\bar ""}.
1442 @lilypond[quote,ragged-right,relative=2,verbatim]
1449 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1450 mesure dès lors que la précédente avait une note en suspend -- c'est
1451 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1452 L'instruction @code{\break} sera alors opérationnelle si vous avez
1453 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1454 @code{Voice} concerné. Notez bien que les sauts de ligne forcés doivent
1455 être saisis au sein d'une expression polyphonique :
1457 @lilypond[quote,ragged-right,verbatim]
1459 \remove Forbid_line_break_engraver
1462 { c2. \times 2/3 { c4 c c } c2. | }
1463 { s1 | \break s1 | }
1468 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1469 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1470 introduire la dérogation @w{@code{\override Beam #'breakable = ##t}}.
1472 @lilypond[quote,ragged-right,relative=2,verbatim]
1473 \override Beam #'breakable = ##t
1478 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1479 saut de ligne à la fin de la mesure où elle est explicitée.
1481 LilyPond dispose de deux variables de base pour influencer l'espacement
1482 au niveau des lignes. Toutes deux se définissent dans un bloc
1483 @code{\layout}, @code{indent} réglant l'indentation de la première
1484 ligne, et @code{line-width} la longueur des lignes.
1486 L'activation du commutateur @code{ragged-right} au sein du bloc
1487 @code{\layout} aura pour effet de terminer les systèmes là où il le
1488 feraient normalement plutôt que de les étirer sur toute la longueur de
1489 la ligne. Ceci est particulièrement utile pour de petits fragments ou
1490 pour vérifier la densité induite par l'espacement naturel.
1492 @c TODO Check and add para on default for ragged-right
1494 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1495 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1505 @cindex sauts de ligne réguliers
1506 @cindex portée à quatre mesures
1508 L'utilisation conjointe de @code{\break} et de blancs dans une section
1509 @code{\repeat} vous permettra de positionner des sauts de ligne à
1510 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1511 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1517 s1 \noBreak s1 \noBreak
1518 s1 \noBreak s1 \break
1520 @{ @var{et ici la musique@dots{}} @}
1525 Apparemment, je ne vois pas de "snippet" qui corresponde,
1526 à moins que ce ne soit pour allécher vers la section
1527 "4.6 Fitting music onto fewer pages" -JCM
1529 A linebreaking configuration can be saved as a @code{.ly} file
1530 automatically. This allows vertical alignments to be stretched to
1531 fit pages in a second formatting run. This is fairly new and
1532 complicated. More details are available in
1544 Manuel de notation :
1545 @ref{Variables de gestion des sauts de ligne}.
1547 Référence des propriétés internes :
1548 @rinternals{LineBreakEvent}.
1551 @rlsrnamed{Spacing,Espacements}.
1555 @subsection Sauts de page
1556 @translationof Page breaking
1558 La gestion automatique des sauts de page se contrôle à l'aide des
1559 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1560 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1561 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1562 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1563 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1566 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1567 trouver à des niveaux supérieurs, entre deux partitions ou
1568 @emph{markups} de premier rang.
1570 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1571 gérer la répartition horizontale, LilyPond dispose de commutateurs
1572 équivalents au niveau de la verticalité : @code{ragged-bottom} et
1573 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1574 affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
1575 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1576 à @ref{Variables d'espacement vertical fixe}.
1578 Les sauts de page sont générés par la fonction @code{page-breaking}.
1579 LilyPond dispose de trois différents algorithmes en la matière :
1580 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1581 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1582 activé par défaut, mais rien ne vous empêche d'en changer, par
1583 l'intermédiaire du bloc @code{\paper} :
1587 page-breaking = #ly:page-turn-breaking
1593 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1594 pages, la gestion des sauts de page finit par devenir très gourmande,
1595 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1596 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1597 sectionner l'ouvrage que vous traitez ; les sauts de page seront
1598 alors gérés individuellement au niveau de chacune des parties. Par
1599 ailleurs, cela vous autorisera une gestion différente selon les
1605 subtitle = "Préface"
1608 %% Pour une partie constituée principalement de texte
1609 %% ly:minimal-breaking est plus judicieux.
1610 page-breaking = #ly:minimal-breaking
1612 \markup @{ @dots{} @}
1616 %% Cette partie étant purement musicale,
1617 %% retour au style par défaut (optimal-breaking).
1619 subtitle = "Premier mouvement"
1621 \score @{ @dots{} @}
1627 @funindex \pageBreak
1629 @funindex \noPageBreak
1630 @code{\noPageBreak}.
1634 Manuel de notation :
1635 @ref{Variables de gestion des sauts de page}.
1638 @rlsrnamed{Spacing,Espacements}.
1641 @node Optimisation des sauts de page
1642 @subsection Optimisation des sauts de page
1643 @translationof Optimal page breaking
1645 @funindex ly:optimal-breaking
1647 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1648 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1649 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1650 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1651 n'a aucune notion de ce qu'est une @qq{tourne}.
1655 @rlsrnamed{Spacing,Espacements}.
1658 @node Optimisation des tournes
1659 @subsection Optimisation des tournes
1660 @translationof Optimal page turning
1662 @funindex ly:page-turn-breaking
1664 Aboutir à une configuration des sauts de page de telle sorte que les
1665 pages de droite se terminent toujours par un silence devient souvent une
1666 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1667 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1668 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1669 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1670 ne saurait intervenir qu'à certains endroits.
1672 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1673 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1674 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1675 informer la fonction des endroits où les sauts de page sont permis.
1677 Cette deuxième étape se réalise de deux manières différentes. Vous
1678 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1679 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1681 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1682 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1683 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1684 tournes recherchera dans le contexte en question les passages sans note.
1685 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1686 notes ; autrement dit, il ne restera pas inactif dans le cadre
1687 d'une portée polyphonique dont l'une des parties contiendrait des
1688 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1689 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1690 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1691 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1692 déposera le @code{\allowPageTurn}.
1694 @funindex minimumPageTurnLength
1696 Le @code{Page_turn_engraver} examine la propriété de contexte
1697 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1698 longueur d'un fragment sans note avant une tourne. La valeur par
1699 défaut de @code{minimumPageTurnLength} est
1700 @code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
1701 la manière suivante :
1704 \new Staff \with @{ \consists "Page_turn_engraver" @}
1707 R1 | % une tourne peut se placer ici
1709 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1710 R1 | % il ne peut pas y avoir de tourne ici
1712 R1*2 | % une tourne peut se placer ici
1717 @funindex minimumRepeatLengthForPageTurn
1719 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1720 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1721 temps au début et à la fin de la reprise pour que l'exécutant ait le
1722 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1723 même capable d'interdire un tourne dans le cas d'une reprise de courte
1724 durée, ajustable au travers de la propriété de contexte
1725 @code{minimumRepeatLengthForPageTurn}.
1727 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1728 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1729 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1734 @funindex \noPageTurn
1736 @funindex \allowPageTurn
1737 @code{\allowPageTurn}.
1742 @rlsrnamed{Spacing,Espacements}.
1745 Une partition ne devrait contenir qu'une seule instance du
1746 @code{Page_turn_engraver}, au risque de se contredire les uns les autres.
1749 @node Minimisation des sauts de page
1750 @subsection Minimisation des sauts de page
1751 @translationof Minimal page breaking
1753 @funindex ly:minimal-breaking
1755 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1756 calculs pour positionner les sauts de page. Elle mettra le plus de
1757 systèmes possible sur une page avant de passer à la suivante. On peut
1758 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1759 lorsque les autres fonctions de gestion des sauts de page ralentissent
1760 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1761 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1766 page-breaking = #ly:minimal-breaking
1772 @rlsrnamed{Spacing,Espacements}.
1775 @node Présentation en rouleau
1776 @subsection Présentation en rouleau
1777 @translationof One-line page breaking
1779 @funindex ly:one-line-breaking
1781 La fonction @code{ly:one-line-breaking} constitue un algorithme de
1782 calcul des sauts de pages particulier en ceci que chaque partition fait
1783 l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
1784 s'affranchit de l'impression des titres et marges ; seule la partition
1787 La largeur de page est ajustée de telle sorte que la pièce la plus
1788 longue tienne sur une seule ligne. En particulier, les variables
1789 @code{paper-width}, @code{line-width} et @code{indent} du bloc
1790 @code{\paper} seront ignorées ; les @code{left-margin} et
1791 @code{right-margin} seront honorées. La hauteur de page ne sera pas
1795 @node Sauts explicites
1796 @subsection Sauts explicites
1797 @translationof Explicit breaks
1799 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1800 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1801 avec ces deux instructions dérogatoires :
1804 \override NonMusicalPaperColumn #'line-break-permission = ##f
1805 \override NonMusicalPaperColumn #'page-break-permission = ##f
1808 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1809 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1810 explicite, et nulle part ailleurs. De la même façon, la désactivation
1811 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1812 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1813 nulle part ailleurs.
1815 @lilypond[quote,verbatim]
1822 musique = \relative c'' { c8 c c c }
1826 \repeat unfold 2 { \musique } \break
1827 \repeat unfold 4 { \musique } \break
1828 \repeat unfold 6 { \musique } \break
1829 \repeat unfold 8 { \musique } \pageBreak
1830 \repeat unfold 8 { \musique } \break
1831 \repeat unfold 6 { \musique } \break
1832 \repeat unfold 4 { \musique } \break
1833 \repeat unfold 2 { \musique }
1838 \override NonMusicalPaperColumn #'line-break-permission = ##f
1839 \override NonMusicalPaperColumn #'page-break-permission = ##f
1847 @rlsrnamed{Spacing,Espacements}.
1850 @node Recours à une voix supplémentaire pour gérer les sauts
1851 @subsection Recours à une voix supplémentaire pour gérer les sauts
1852 @translationof Using an extra voice for breaks
1854 La plupart du temps, les informations concernant les sauts de ligne ou
1855 de page se retrouvent directement au milieu des notes.
1858 musique = \relative c'' @{ c4 c c c @}
1862 \repeat unfold 2 @{ \musique @} \break
1863 \repeat unfold 3 @{ \musique @}
1868 Bien que cela constitue un moyen aisé de saisir les commandes
1869 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1870 mélangées à des informations qui concernent plutôt l'agencement de la
1871 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1872 purement musical et les informations concernant les sauts de ligne ou de
1873 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1874 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1875 des @code{\break}, des @code{\pageBreak} et autres informations
1876 concernant les ruptures.
1878 @lilypond[quote,verbatim]
1879 music = \relative c'' { c4 c c c }
1890 \repeat unfold 2 { \music }
1891 \repeat unfold 3 { \music }
1892 \repeat unfold 6 { \music }
1893 \repeat unfold 5 { \music }
1899 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1900 les @code{line-break-system-details} et autres propriétés fort
1901 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1902 le voir au chapitre @ref{Espacement vertical}.
1904 @lilypond[quote,verbatim]
1905 music = \relative c'' { c4 c c c }
1910 \overrideProperty "Score.NonMusicalPaperColumn"
1911 #'line-break-system-details #'((Y-offset . 0))
1914 \overrideProperty "Score.NonMusicalPaperColumn"
1915 #'line-break-system-details #'((Y-offset . 35))
1918 \overrideProperty "Score.NonMusicalPaperColumn"
1919 #'line-break-system-details #'((Y-offset . 70))
1922 \overrideProperty "Score.NonMusicalPaperColumn"
1923 #'line-break-system-details #'((Y-offset . 105))
1927 \repeat unfold 2 { \music }
1928 \repeat unfold 3 { \music }
1929 \repeat unfold 6 { \music }
1930 \repeat unfold 5 { \music }
1937 Manuel de notation :
1938 @ref{Espacement vertical}.
1941 @rlsrnamed{Spacing,Espacements}.
1944 @node Espacement vertical
1945 @section Espacement vertical
1946 @translationof Vertical spacing
1948 @cindex vertical, espacement
1949 @cindex espacement vertical
1951 L'espacement vertical dépend de trois éléments : la surface
1952 disponible -- par exemple format de papier et marges --, l'espace qui
1953 doit séparer les systèmes, et l'espace qui sépare les portées d'un même
1957 * Espacement vertical au sein d'un système::
1958 * Positionnement explicite des portées et systèmes::
1959 * Résolution des collisions verticales::
1963 @node Espacement vertical au sein d'un système
1964 @subsection Espacement vertical au sein d'un système
1965 @translationof Flexible vertical spacing within systems
1967 @cindex distance entre les portées
1968 @cindex portées, espacement
1969 @cindex espacement entre les portées
1970 @cindex espacement au sein d'un système
1972 LilyPond dispose de trois différents mécanismes permettant de contrôler
1973 l'espacement au sein d'un système selon trois catégories :
1978 @emph{portées isolées},
1981 @emph{portées regroupées} (portées d'un même groupe, telles celles
1982 d'un @code{ChoirStaff}, etc.), et
1985 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
1989 @c TODO: Clarify this. This almost implies that non-staff lines
1990 @c have NO effect on the spacing between staves. -mp
1992 La hauteur de chaque système se détermine en deux phases. Les portées
1993 sont tout d'abord espacées selon la surface disponible. Puis les lignes
1994 autres que des portées, comme les paroles ou les accords, sont réparties
1997 Les paragraphes qui suivent traitent exclusivement de la manière de
1998 gérer l'espacement entre les lignes d'un système -- portée musicale ou
1999 non. Pour ce qui a trait aux espacements entre les systèmes,
2000 mouvements, annotations et marge, ils sont contrôlés par des variables
2001 attachées au bloc @code{\paper} et font l'objet du chapitre
2002 @ref{Variables d'espacement vertical fluctuant}.
2005 * Propriétés d'espacement au sein d'un système::
2006 * Espacement de portées isolées::
2007 * Espacement de portées regroupées::
2008 * Espacement des lignes rattachées à des portées::
2012 @node Propriétés d'espacement au sein d'un système
2013 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
2014 @translationof Within-system spacing properties
2016 L'espacement entre les portées est géré par deux jeux de propriétés
2017 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
2018 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
2019 ou de non-portée. Le second, associé à l'objet graphique
2020 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
2021 de portées particulier. Les propriétés qui leur sont attachées sont
2022 abordées en fin de section.
2024 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
2025 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
2026 @code{@var{item2}} étant les éléments à espacer. Notez bien que
2027 @code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
2028 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
2029 la distance entre une ligne de non-portée alors que sa
2030 @code{staff-affinity} a été déterminée à @code{UP}.
2032 Toutes ces distances sont mesurées entre les points de référence
2033 respectifs des éléments considérés.
2034 Le @i{point de référence} d'une portée est le centre vertical du
2035 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
2036 l'interligne médian si @code{line-count} est pair.
2037 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
2038 tableau suivant présente le @i{point de référence} pour chacune
2041 @multitable {Non-staff line} {Reference point}
2042 @headitem Ligne de non-portée @tab Point de référence
2043 @item @code{ChordNames} @tab ligne de base
2044 @item @code{NoteNames} @tab ligne de base
2045 @item @code{Lyrics} @tab ligne de base
2046 @item @code{Dynamics} @tab centre vertical
2047 @item @code{FiguredBass} @tab point le plus haut
2048 @item @code{FretBoards} @tab ligne supérieure
2051 En voici une représentation graphique :
2054 @lilypond[quote,noragged-right,line-width=110\mm]
2055 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
2057 alignToZero = \with {
2058 \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
2059 \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
2061 lowerCaseChords = \with {
2062 chordNameLowercaseMinor = ##t
2064 staffAffinityDown = \with {
2065 \override VerticalAxisGroup #'staff-affinity = #DOWN
2068 #(define-music-function
2069 (parser location context)
2071 #{ s1*0^\markup { \typewriter #context } #})
2074 \context { \Dynamics \alignToZero }
2075 \context { \FiguredBass \alignToZero }
2076 \context { \Lyrics \alignToZero }
2077 \context { \NoteNames \alignToZero \staffAffinityDown }
2078 \context { \ChordNames \alignToZero
2081 \context { \FretBoards \alignToZero \staffAffinityDown }
2083 \override BarLine #'stencil = ##f
2084 \override DynamicText #'self-alignment-X = #-1
2085 \override FretBoard #'X-offset = #1.75
2086 \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
2087 \override InstrumentName #'extra-offset = #'(0 . -0.5)
2088 \override TextScript #'minimum-Y-extent = #'(-2 . 3)
2089 \override TimeSignature #'stencil = ##f
2093 %% Contextes dont le point de référence est la ligne de base :
2094 %% ChordNames, NoteNames, et Lyrics
2096 \new ChordNames { \chords { g1:m } }
2097 \new NoteNames { s1 | g1 | }
2098 \new RhythmicStaff {
2099 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
2101 \labelContext "ChordNames" s1 |
2102 \labelContext "NoteNames" s1 |
2103 \labelContext "Lyrics" s1 |
2105 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
2108 %% Le point de référence de Dynamics est le milieu de la ligne
2110 \new RhythmicStaff {
2111 \set RhythmicStaff.instrumentName = #"centre vertical "
2112 \labelContext "Dynamics" s1*3
2114 \new Dynamics { s1\mp s\fp }
2117 %% Le point de référence de FiguredBass est son point le plus haut
2119 \new RhythmicStaff {
2120 \set RhythmicStaff.instrumentName = #"point le plus haut "
2121 \labelContext "FiguredBass" s1
2123 \new FiguredBass { \figuremode { <6 5>1 } }
2126 %% Le point de référence de FretBoards est la ligne du haut
2127 \include "predefined-guitar-fretboards.ly"
2129 \new FretBoards { \chordmode { e1 } }
2130 \new RhythmicStaff {
2131 \set RhythmicStaff.instrumentName = #"ligne du haut "
2132 \labelContext "FretBoards " s1
2137 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2138 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2139 sous la forme d'une liste associative dont la structure est
2140 identique à celle des variables du bloc @code{\paper} que nous avons
2141 examinées au chapitre
2142 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2143 matière de modification d'une liste associative font l'objet d'un
2144 @rusernamed{Modification de listes associatives,chapitre particulier}.
2145 Les propriétés des objets graphiques se règlent avec un @code{\override}
2146 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2149 L'exemple suivant illustre deux façons de modifier une liste
2150 associative. La première déclaration n'agit que sur une seule clé,
2151 alors que la seconde redéfinit la propriété dans son intégralité.
2155 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2159 \override VerticalAxisGroup #'staff-staff-spacing =
2160 #'(('basic-distance . 10)
2161 (minimum-distance . 9)
2163 (stretchability . 10))
2167 La modification d'un espacement au niveau global se mentionne au sein du
2168 bloc @code{\layout} :
2174 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2179 Les réglages concernant les propriétés d'espacement vertical des objets
2180 graphiques sont répertoriées aux chapitres
2181 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2182 Les propriétés relatives aux lignes de non-portée sont répertoriées
2183 selon la définition de leur contexte dans la
2184 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2187 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2188 @translationof Properties of the @code{VerticalAxisGroup} grob
2190 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2191 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2195 @item staff-staff-spacing
2196 Il s'agit de la distance entre la portée en cours et la portée qui suit
2197 au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
2198 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2199 pas à la dernière portée d'un système.
2201 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2202 d'un @code{VerticalAxisGroup} affectera les propriétés du
2203 @code{StaffGrouper} si la portée est incluse dans un regroupement ;
2204 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2205 regroupement. Les portées peuvent donc s'aligner différemment selon
2206 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2207 tenir compte des éventuels regroupements, cette fonction peut faire
2208 place à une complète redéfinition des espacements fluctuants à l'aide de
2209 règles dérogatoires comme vu précédemment.
2211 @item default-staff-staff-spacing
2212 Il s'agit de la distance qui s'appliquera par défaut aux portées
2213 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2214 explicitement par un @code{\override}.
2216 @item staff-affinity
2217 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2218 que prendra une ligne de non-portée pour aller s'accoler aux portées
2219 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2220 non-portée ira se placer à équidistance entre les portées qui
2221 l'encadrent, tout en tenant compte des éventuels risques de collision et
2222 des autres contraintes d'espacement. Des lignes de non-portée
2223 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2224 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2225 Une ligne de non-portée en dessous d'un système devrait avoir sa
2226 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2227 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2228 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2229 @code{staff-affinity} : si vous affectez la valeur @code{#f} à
2230 une ligne de non-portée, cette ligne sera considérée comme étant une
2231 portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
2232 pour une portée lui fera perdre cette qualité.
2234 @c TODO: verify last clause below ("even if other...")
2236 @item nonstaff-relatedstaff-spacing
2237 Il s'agit de la distance entre la ligne de non-portée en cours et la
2238 portée la plus proche selon la @code{staff-affinity}, à la double
2239 condition qu'il n'y a pas déjà une autre ligne de non-portée et que la
2240 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2241 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2242 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2243 non-portée entre les deux portées adjacentes même si une autre
2244 non-portée est présente (quelque soit le côté).
2246 @item nonstaff-nonstaff-spacing
2247 Il s'agit de la distance entre deux lignes de non-portée selon
2248 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2249 la même orientation. Bien entendu, ceci ne peut concerner que les
2250 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2252 @item nonstaff-unrelatedstaff-spacing
2253 Il s'agit de la distance entre une ligne de non-portée et la portée à
2254 l'opposé de l'orientation adoptée, à la double condition qu'il n'y a pas
2255 déjà une autre ligne de non-portée et que la valeur de
2256 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2257 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2258 portée à laquelle elle ne correspond pas.
2262 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2263 @translationof Properties of the @code{StaffGrouper} grob
2265 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2266 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2270 @item staff-staff-spacing
2271 Il s'agit de la distance entre deux portées consécutives d'un même
2272 système. La propriété @code{staff-staff-spacing} de l'objet
2273 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2274 l'aide de règles dérogatoires.
2276 @item staffgroup-staff-spacing
2277 Il s'agit de la distance entre la dernière portée d'un regroupement et
2278 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2279 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2280 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2281 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2282 regroupement a été ajustée au niveau de son propre
2283 @code{VerticalAxisGroup}, cette dernière aura préséance.
2287 Fichiers d'initialisation :
2288 @file{ly/engraver-init.ly},
2289 @file{scm/define-grobs.scm}.
2291 Référence des propriétés internes :
2292 @rinternals{Contexts},
2293 @rinternals{VerticalAxisGroup},
2294 @rinternals{StaffGrouper}.
2297 @node Espacement de portées isolées
2298 @unnumberedsubsubsec Espacement de portées isolées
2299 @translationof Spacing of ungrouped staves
2301 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2302 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2305 L'espacement de ces @i{portées isolées} est géré par les propriétés
2309 @item Propriétés du @code{VerticalAxisGroup} :
2311 @item @code{default-staff-staff-spacing}
2312 @item @code{staff-staff-spacing}
2316 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2317 @ref{Propriétés d'espacement au sein d'un système}.
2319 Certaines propriétés supplémentaires s'appliqueront dès lors que
2320 ces portées sont regroupées -- voir
2321 @ref{Espacement de portées regroupées}.
2323 L'exemple suivant illustre la manière de gérer l'espacement de portées
2324 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2325 Les mêmes règles appliquées de manière dérogatoire au
2326 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2327 sein de regroupements.
2329 @lilypond[verbatim,quote,staffsize=16]
2333 \override VerticalAxisGroup #'default-staff-staff-spacing =
2334 #'((basic-distance . 8)
2335 (minimum-distance . 7)
2341 % The very low note here needs more room than 'basic-distance
2342 % can provide, so the distance between this staff and the next
2343 % is determined by 'padding.
2344 \new Staff { b,2 r | }
2346 % Here, 'basic-distance provides enough room, and there is no
2347 % need to compress the space (towards 'minimum-distance) to make
2348 % room for anything else on the page, so the distance between
2349 % this staff and the next is determined by 'basic-distance.
2350 \new Staff { \clef bass g2 r | }
2352 % By setting 'padding to a negative value, staves can be made to
2353 % collide. The lowest acceptable value for 'basic-distance is 0.
2355 \override VerticalAxisGroup #'default-staff-staff-spacing =
2356 #'((basic-distance . 3.5)
2358 } { \clef bass g2 r | }
2359 \new Staff { \clef bass g2 r | }
2364 Fichiers d'initialisation :
2365 @file{scm/define-grobs.scm}.
2368 @rlsrnamed{Spacing,Espacements}.
2370 Référence des propriétés internes :
2371 @rinternals{VerticalAxisGroup}.
2374 @node Espacement de portées regroupées
2375 @unnumberedsubsubsec Espacement de portées regroupées
2376 @translationof Spacing of grouped staves
2378 Dans les partitions orchestrales ou de grande ampleur, il arrive
2379 souvent que des portées soient regroupées. L'espacement est alors plus
2380 important entre deux regroupements qu'entre les portées d'un même
2383 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2384 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2385 une ou plusieurs portées.
2387 L'espacement entre les portées d'un même regroupement est géré par les
2388 propriétés suivantes :
2391 @item Propriétés du @code{VerticalAxisGroup} :
2393 @item @code{staff-staff-spacing}
2395 @item Propriétés du @code{StaffGrouper} :
2397 @item @code{staff-staff-spacing}
2398 @item @code{staffgroup-staff-spacing}
2402 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2403 @ref{Propriétés d'espacement au sein d'un système}.
2405 L'exemple suivant illustre la manière de gérer l'espacement de portées
2406 regroupées, à l'aide des propriétés de l'objet graphique
2407 @code{StaffGrouper} :
2409 @lilypond[verbatim,quote,staffsize=16]
2413 \override StaffGrouper #'staff-staff-spacing #'padding = #0
2414 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
2419 \new PianoStaff \with {
2420 \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
2435 Fichiers d'initialisation :
2436 @file{scm/define-grobs.scm}.
2439 @rlsrnamed{Spacing,Espacements}.
2441 Référence des propriétés internes:
2442 @rinternals{VerticalAxisGroup},
2443 @rinternals{StaffGrouper}.
2446 @node Espacement des lignes rattachées à des portées
2447 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2448 @translationof Spacing of non-staff lines
2450 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2451 @code{ChordNames} sont des contextes dont les objets de rendu sont
2452 gravés à l'instar des portées -- une ligne horizontale dans un système.
2453 En fait, les lignes de non-portée sont des contextes qui vont créer un
2454 objet de rendu @code{VerticalAxisGroup}.
2456 L'espacement des lignes de non-portée est géré par les propriétés
2460 @item Propriétés du @code{VerticalAxisGroup} :
2462 @item @code{staff-affinity}
2463 @item @code{nonstaff-relatedstaff-spacing}
2464 @item @code{nonstaff-nonstaff-spacing}
2465 @item @code{nonstaff-unrelatedstaff-spacing}
2469 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2470 @ref{Propriétés d'espacement au sein d'un système}.
2472 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2473 pour gérer l'espacement entre des lignes consécutives de non-portée.
2474 Vous noterez que la valeur élevée attribuée à la clé
2475 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2477 @lilypond[verbatim,quote,staffsize=16]
2481 \override VerticalAxisGroup
2482 #'nonstaff-nonstaff-spacing #'stretchability = #1000
2489 \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
2492 \override VerticalAxisGroup #'staff-affinity = #UP
2495 \override VerticalAxisGroup #'staff-affinity = #CENTER
2496 } \lyricmode { center }
2498 \override VerticalAxisGroup #'staff-affinity = #DOWN
2499 } \lyricmode { down }
2505 Fichiers d'initialisation :
2506 @file{ly/engraver-init.ly},
2507 @file{scm/define-grobs.scm}.
2510 @rlsrnamed{Spacing,Espacements}.
2512 @c @lsr{spacing,page-spacing.ly},
2513 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2515 Référence des propriétés internes :
2516 @rinternals{Contexts},
2517 @rinternals{VerticalAxisGroup}.
2520 @node Positionnement explicite des portées et systèmes
2521 @subsection Positionnement explicite des portées et systèmes
2522 @translationof Explicit staff and system positioning
2524 Pour bien comprendre comment fonctionnent les réglages de
2525 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2526 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2527 les différentes mises au point du décalage vertical appliqué aux portées
2528 et systèmes distribués sur une page.
2530 Une autre approche de l'espacement vertical est le recours à
2531 @code{NonMusicalPaperColumn #'line-break-system-details}. Alors que
2532 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2533 @code{NonMusicalPaperColumn #'line-break-system-details} spécifiera le
2534 positionnement vertical absolu sur la page.
2536 @code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
2537 une liste associative de trois mises au point :
2540 @item @code{X-offset}
2541 @item @code{Y-offset}
2542 @item @code{alignment-distances}
2545 Les dérogations en matière d'objet graphique, y compris celles
2546 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2547 à trois différents endroits de votre fichier source :
2550 @item directement au beau milieu des notes
2551 @item au sein d'un bloc @code{\context}
2552 @item dans un bloc @code{\with}
2555 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2556 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2557 @code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
2558 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2559 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2560 de la commande @code{\overrideProperty} :
2563 \overrideProperty NonMusicalPaperColumn
2564 #'line-break-system-details #'((X-offset . 20))
2566 \overrideProperty NonMusicalPaperColumn
2567 #'line-break-system-details #'((Y-offset . 40))
2569 \overrideProperty NonMusicalPaperColumn
2570 #'line-break-system-details #'((X-offset . 20)
2573 \overrideProperty NonMusicalPaperColumn
2574 #'line-break-system-details #'((alignment-distances . (15)))
2576 \overrideProperty NonMusicalPaperColumn
2577 #'line-break-system-details #'((X-offset . 20)
2579 (alignment-distances . (15)))
2582 Nous allons maintenant voir ces différents réglages en action.
2583 Commençons par examiner un exemple dépourvu de toute mise au point.
2585 @c \book { } is required in these examples to ensure the spacing
2586 @c overrides can be seen between systems. -np
2588 @lilypond[verbatim,quote,staffsize=16]
2589 \header { tagline = ##f }
2590 \paper { left-margin = 0\mm }
2600 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2603 \repeat unfold 15 { d'4 d' d' d' }
2610 Cette partition isole les informations de saut de ligne ou de page dans
2611 une voix spécifique. La mise en forme est ainsi séparée des événements
2612 musicaux ; ceci nous permettra d'y voir plus clair au fur et à
2613 mesure que nous avancerons. Pour plus de précisions, relisez
2614 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2616 Les @code{\breaks} explicites répartissent la musique en lignes de cinq
2617 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2618 par défaut. Nous pouvons, afin de fixer explicitement le point
2619 d'attache vertical de chacun des systèmes, définir un doublet
2620 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2621 de l'objet @code{NonMusicalPaperColumn} :
2623 @lilypond[verbatim,quote,staffsize=16]
2624 \header { tagline = ##f }
2625 \paper { left-margin = 0\mm }
2631 \overrideProperty #"Score.NonMusicalPaperColumn"
2632 #'line-break-system-details #'((Y-offset . 0))
2634 \overrideProperty #"Score.NonMusicalPaperColumn"
2635 #'line-break-system-details #'((Y-offset . 40))
2637 \overrideProperty #"Score.NonMusicalPaperColumn"
2638 #'line-break-system-details #'((Y-offset . 80))
2641 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2644 \repeat unfold 15 { d'4 d' d' d' }
2651 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2652 si la liste associative de @code{line-break-system-details} peut en
2653 comporter un certain nombre. Vous aurez aussi noté que la propriété
2654 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2657 Maintenant que chaque système est explicitement positionné, nous pouvons
2658 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2659 à la sous-propriété @code{alignment-distances} de
2660 @code{line-break-system-details}.
2662 @lilypond[verbatim,quote,staffsize=16]
2663 \header { tagline = ##f }
2664 \paper { left-margin = 0\mm }
2670 \overrideProperty #"Score.NonMusicalPaperColumn"
2671 #'line-break-system-details #'((Y-offset . 20)
2672 (alignment-distances . (15)))
2674 \overrideProperty #"Score.NonMusicalPaperColumn"
2675 #'line-break-system-details #'((Y-offset . 60)
2676 (alignment-distances . (15)))
2678 \overrideProperty #"Score.NonMusicalPaperColumn"
2679 #'line-break-system-details #'((Y-offset . 100)
2680 (alignment-distances . (15)))
2683 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2686 \repeat unfold 15 { d'4 d' d' d' }
2693 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2694 @code{line-break-system-details} de l'objet
2695 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2696 prendre bien d'autres paramètres d'espacement, y compris un doublet
2697 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2698 @code{alignment-distances} pour contrôler le positionnement de chaque
2699 système et de chaque portée. Vous noterez enfin que
2700 @code{alignment-distances} traite le positionnement des portées, non
2701 d'un regroupement de portées.
2703 @lilypond[verbatim,quote,staffsize=16]
2704 \header { tagline = ##f }
2705 \paper { left-margin = 0\mm }
2711 \overrideProperty #"Score.NonMusicalPaperColumn"
2712 #'line-break-system-details #'((Y-offset . 0)
2713 (alignment-distances . (30 10)))
2715 \overrideProperty #"Score.NonMusicalPaperColumn"
2716 #'line-break-system-details #'((Y-offset . 60)
2717 (alignment-distances . (10 10)))
2719 \overrideProperty #"Score.NonMusicalPaperColumn"
2720 #'line-break-system-details #'((Y-offset . 100)
2721 (alignment-distances . (10 30)))
2724 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2727 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2728 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2735 Quelques points à prendre en considération :
2739 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2740 autres lignes de non-portée ne comptent pas pour une portée.
2743 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2744 @code{alignment-distances} sont considérés comme des multiples de la
2745 distance entre des portées adjacentes. Des valeurs positives remontent
2746 les portées et paroles, des valeurs négatives les descendent.
2749 Dans la mesure où @code{NonMusicalPaperColumn #'line-break-system-details}
2750 permet de positionner systèmes et portées n'importe où sur une page,
2751 vous pourriez être en contradiction avec les dimensionnements de la
2752 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2753 quant aux différentes valeurs que vous affectez à ces réglages.
2759 @rlsrnamed{Spacing,Espacements}.
2762 @node Résolution des collisions verticales
2763 @subsection Résolution des collisions verticales
2764 @translationof Vertical collision avoidance
2766 @funindex outside-staff-priority
2767 @funindex outside-staff-padding
2768 @funindex outside-staff-horizontal-padding
2770 Vous savez de manière intuitive qu'un certain nombre d'objets en
2771 matière de notation musicale appartiennent à la portée, et que
2772 d'autres se placent en dehors de la portée. Entre autres objets
2773 externes, nous avons les marques repères, les textes et les
2774 nuances ; nous les appellerons @qq{objets extérieurs à la portée}.
2775 La règle adoptée par LilyPond pour positionner verticalement ces
2776 objets extérieurs consiste à les placer au plus près de la portée
2777 tout en prenant garde d'éviter qu'il y ait chevauchement.
2779 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2780 déterminer si un objet est ou non un objet extérieur à la portée :
2781 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2782 s'agit d'un objet extérieur à la portée. De plus, la propriété
2783 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2784 objets doivent être disposés.
2786 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2787 Les objets extérieurs à la portée sont alors triés selon l'ordre
2788 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2789 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2790 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2791 lorsque deux objets devraient se placer au même endroit, celui dont la
2792 @code{outside-staff-priority} est la plus faible sera disposé au plus
2795 @lilypond[quote,ragged-right,relative=2,verbatim]
2798 \once \override TextScript #'outside-staff-priority = #1
2799 c4_"Text"\pp % this time the text will be closer to the staff
2801 % by setting outside-staff-priority to a non-number,
2802 % we disable the automatic collision avoidance
2803 \once \override TextScript #'outside-staff-priority = ##f
2804 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2805 c4_"Text"\pp % now they will collide
2808 Le décalage vertical entre un objet extérieur à la portée et celui qui
2809 le précède se contrôle par la propriété @code{outside-staff-padding}.
2812 @lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
2813 \once \override TextScript #'outside-staff-padding = #0
2814 a'^"Ce texte est placé au plus près de la note"
2815 \once \override TextScript #'outside-staff-padding = #3
2816 c^"Ce texte est décalé par rapport au texte précédent"
2817 c^"Ce texte est accolé au texte précédent"
2820 Par défaut, les objets extérieurs à la portée sont positionnés en
2821 évitant les collisions horizontales avec des objets précédemment
2822 positionnés. Ceci peut cependant générer des situations où des objets
2823 se trouvent horizontalement trop proches. L'espacement vertical entre
2824 les portées peut dans une certaine mesure permettre de mieux intercaler
2825 les objets extérieurs à la portée. La propriété
2826 @code{outside-staff-horizontal-padding} repoussera verticalement un
2827 objet pour éviter ce genre de situation.
2829 @lilypond[quote,ragged-right,relative=2,verbatim]
2830 % the markup is too close to the following note
2834 % setting outside-staff-horizontal-padding fixes this
2836 \once \override TextScript #'outside-staff-horizontal-padding = #1
2844 @rlsrnamed{Spacing,Espacements}.
2847 @node Espacement horizontal
2848 @section Espacement horizontal
2849 @translationof Horizontal spacing
2851 @cindex horizontal, espacement
2852 @cindex espacement horizontal
2855 * Généralités sur l'espacement horizontal::
2856 * Changement d'espacement en cours de partition::
2857 * Modification de l'espacement horizontal::
2858 * Longueur de ligne::
2859 * Notation proportionnelle::
2863 @node Généralités sur l'espacement horizontal
2864 @subsection Généralités sur l'espacement horizontal
2865 @translationof Horizontal spacing overview
2867 Le moteur d'espacement traduit les différences de durée en distances
2868 étirables (@emph{springs} pour ressorts) de différente longueur. Des
2869 durées importantes prennent ainsi plus de place que des durées moins
2870 longues. Les durées les plus courtes se verront attribuer un espace
2871 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2872 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2873 plus elle prendra d'espace : le doublement d'une durée attribuera à
2874 la note un espace fixé d'après la propriété @code{spacing-increment}.
2876 L'exemple suivant comporte des blanches, des noires et un certain nombre
2877 de croches. La croche est suivie d'un espace de la largeur d'une tête
2878 de note ; pour la noire , cet espace est de deux têtes ; il
2879 est de trois pour la blanche.
2881 @lilypond[quote,verbatim,relative=1]
2882 c2 c4. c8 c4. c8 c4. c8 c8
2886 @code{spacing-increment} est normalement défini à 1,2 espace de
2887 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2888 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2889 s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
2890 @code{spacing-increment}). Le point de départ de cet espace se situe à
2891 l'extrémité gauche du symbole ; la note la plus courte est donc
2892 suivie en général d'un espace égal à la largeur d'une tête de note.
2894 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2895 croche à une partition qui comporte déjà des croches et des doubles
2896 augmentera considérablement son volume : la durée la plus
2897 courte n'est plus la double mais la triple croche, ce qui aura
2898 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2899 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2900 courte prise en considération au niveau de l'espacement n'est pas la
2901 note la plus brève de la partition, mais celle qui apparaît le plus
2904 La courte durée la plus fréquente est déterminée à partir de la note la
2905 plus courte de chaque mesure. C'est elle qui servira de base pour
2906 l'espacement, à cette nuance près que la plus courte durée ne saurait
2907 être strictement supérieure à la croche. Cette @qq{durée de référence}
2908 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2911 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2912 pour les espacements grâce à la propriété
2913 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2914 La durée maximale de cet étalon, normalement la croche, est gérée par la
2915 propriété @code{base-shortest-duration}.
2917 @funindex common-shortest-duration
2918 @funindex base-shortest-duration
2919 @funindex stem-spacing-correction
2922 Les notes plus courtes que la note témoin sont suivies d'un espace
2923 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2924 doubles croches à l'exemple précédent, elles seraient suivies d'une
2925 demie largeur de tête :
2927 @lilypond[quote,verbatim,relative=2]
2928 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2931 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2932 vu comment la direction des hampes peut influencer l'espacement -- voir
2933 @ressay{Espacement}. Ceci est contrôlé par la propriété
2934 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2935 pour chaque contexte @rinternals{Voice}. L'objet
2936 @rinternals{StaffSpacing}, généré au niveau d'un contexte @code{Staff},
2937 possède une même propriété qui contrôlera l'espacement hampe-barre de
2938 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2939 les réglages par défaut, puis avec des corrections forcées.
2941 @lilypond[quote,ragged-right]
2945 \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2946 \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2952 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
2953 @rusernamed{Notation proportionnelle,rubrique dédiée}.
2957 @rlsrnamed{Spacing,Espacements}.
2959 Essai sur la gravure musicale automatisée :
2960 @ressay{Espacement}.
2962 Référence des propriétés internes :
2963 @rinternals{SpacingSpanner},
2964 @rinternals{NoteSpacing},
2965 @rinternals{StaffSpacing},
2966 @rinternals{NonMusicalPaperColumn}.
2969 Il n'existe pas de mécanisme simple et efficace qui permette de
2970 forcer manuellement l'espacement. La solution ci-dessous permet
2971 cependant @qq{d'aérer} artificiellement une partition ; il vous
2972 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
2975 \override Score.NonMusicalPaperColumn #'padding = #10
2978 Il n'y a aucun moyen de diminuer l'espacement.
2981 @node Changement d'espacement en cours de partition
2982 @subsection Changement d'espacement en cours de partition
2983 @translationof New spacing area
2985 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
2986 substantiellement la notion de valeur brève et valeur longue. La
2987 commande @code{newSpacingSection} permet alors de réinitialiser les
2988 paramètres d'espacement.
2990 Dans l'exemple qui suit, le changement de métrique marque le début
2991 d'une nouvelle partie ; remarquez comme les doubles-croches sont
2992 alors plus espacées :
2994 @lilypond[relative,verbatim,quote]
2997 c8 c c4 c16[ c c8] c4
3003 La commande @code{\newSpacingSection} crée un nouvel objet
3004 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
3005 @code{\override}s à partir de ce point.
3009 @rlsrnamed{Spacing,Espacements}.
3011 Référence des propriétés internes :
3012 @rinternals{SpacingSpanner}.
3015 @node Modification de l'espacement horizontal
3016 @subsection Modification de l'espacement horizontal
3017 @translationof Changing horizontal spacing
3019 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
3020 @code{base-shortest-duration}. Comparons les deux partitions qui
3021 suivent, toutes deux montrant la même musique. La première partition
3022 applique les réglages par défaut, alors que la seconde bénéficie
3023 d'ajustement de la propriété @code{base-shortest-duration}. Au plus la
3024 valeur de @code{ly:make-moment} est grande, au plus la musique sera
3025 resserrée. En effet, @code{ly:make-moment} construit une durée :
3026 @w{@code{1 4}} est plus long que @w{@code{1 16}}.
3028 @lilypond[verbatim,line-width=12\cm]
3031 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3032 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3033 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3034 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3039 @lilypond[verbatim,line-width=12\cm]
3042 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3043 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3044 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3045 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3050 \override SpacingSpanner
3051 #'base-shortest-duration = #(ly:make-moment 1 16)
3058 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
3059 facteurs qui ne sont pas liés à la durée (altération, changement de
3060 clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
3061 permet d'ignorer ces symboles et, par voie de conséquence, forcer
3062 l'espacement sur la simple durée. Notez bien que cette propriété
3063 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
3066 @lilypond[quote,ragged-right,verbatim]
3085 \override SpacingSpanner #'uniform-stretching = ##t
3091 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
3092 les notes sans tenir compte des clefs, barres de mesure ou notes
3093 d'ornement qui pourraient apparaître :
3095 @lilypond[quote,ragged-right,relative=2,verbatim]
3096 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3097 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
3102 @rlsrnamed{Spacing,Espacements}.
3105 @node Longueur de ligne
3106 @subsection Longueur de ligne
3107 @translationof Line length
3109 @cindex saut de page
3113 @funindex line-width
3114 @funindex ragged-right
3115 @funindex ragged-last
3117 @c Although line-width can be set in \layout, it should be set in paper
3118 @c block, to get page layout right.
3119 @c Setting indent in \paper block makes not much sense, but it works.
3121 @c Bit verbose and vague, use examples?
3122 Deux réglages de bases ont une influence considérable sur
3123 l'espacement : @code{line-width} et @code{indent}. Tous deux se
3124 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3125 lignes et l'indentation de la première.
3127 L'activation du commutateur @code{ragged-right} au sein du bloc
3128 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3129 de les voir s'étirer sur toute la largeur de la page. Cette option est
3130 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3131 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3132 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3136 @cindex vertical spacing
3138 Le fonctionnement de l'option @code{ragged-last} est en tout point
3139 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3140 que la dernière ligne de la partition. Il n'y a pas de restriction
3141 quant à cette ligne. Il en va de même que pour le formatage d'un
3142 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3144 @c Note that for text there are several options for the last line.
3145 @c While Knuth TeX uses natural length, lead typesetters use the same
3146 @c stretch as the previous line. eTeX uses \lastlinefit to
3147 @c interpolate between both these solutions.
3159 @rlsrnamed{Spacing,Espacements}.
3162 @node Notation proportionnelle
3163 @subsection Notation proportionnelle
3164 @translationof Proportional notation
3166 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3167 ce cas de représenter la notation selon un espacement strictement
3168 relatif aux durées. Ce type d'espacement pourrait se comparer à
3169 l'utilisation de papier millimétré pour positionner les notes au fil de
3170 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3171 utilisent cette proportionnalité dans le but de clarifier des structures
3172 rythmiques complexes, d'aider au positionnement d'indications
3173 temporelles ou autres éléments graphiques directement dans la partition.
3175 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3176 s'utiliser conjointement ou individuellement, aux fins de mettre au
3177 point cette notation proportionnelle.
3180 @item @code{proportionalNotationDuration}
3182 @item @code{uniform-stretching}
3184 @item @code{strict-note-spacing}
3186 @item @code{\remove Separating_line_group_engraver}
3188 @item @code{\override PaperColumn #'used = ##t}
3192 Nous allons examiner, dans les différents exemples qui suivent, les
3193 effets de ces réglages et comment ils interagissent.
3195 Commençons par cette mesure toute simple qui utilise l'espacement
3196 classique et justifiée à gauche.
3198 @lilypond[quote,verbatim,ragged-right]
3201 \new RhythmicStaff {
3205 c'16 c'16 c'16 c'16 c'16
3212 Vous constatez que la blanche qui entame la mesure prend moins de la
3213 moitié de l'espace. De même, les doubles croches et le quintolet de
3214 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3215 n'en occupent pas la moitié de l'espace horizontal.
3217 En matière de gravure traditionnelle, cet espacement correspond tout à
3218 fait à nos attentes, puisque nous pouvons rogner l'espace sur la
3219 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3222 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3223 un autre graphisme en surplomb ou en dessous de notre partition, nous
3224 aurons besoin de la notation proportionnelle. Celle-ci s'active an
3225 définissant la propriété @code{proportionalNotationDuration}.
3227 @lilypond[quote,verbatim,ragged-right]
3230 \new RhythmicStaff {
3234 c'16 c'16 c'16 c'16 c'16
3241 proportionalNotationDuration = #(ly:make-moment 1 20)
3247 La blanche du début et les notes plus rapides de la deuxième moitié de
3248 la mesure occupent maintenant exactement le même espace horizontal.
3249 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3250 temporelle ou autre graphisme.
3252 @code{proportionalNotationDuration} est une propriété attachée au
3253 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3254 propriétés d'un contexte à trois différents endroits de votre
3255 fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
3256 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3257 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3258 de ces trois façons, à l'instar de n'importe quelle définition de
3261 La propriété @code{proportionalNotationDuration} prend en unique
3262 argument la durée de référence qui servira de base pour espacer toute la
3263 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3264 prend deux arguments : un numérateur et un dénominateur qui
3265 représentent une fraction de ronde. L'appel de
3266 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3267 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3268 @code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} ou
3269 @code{(ly:make-moment 3 97)}.
3271 Se pose alors le problème de fournir la juste durée de référence à
3272 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3273 tâtonnement, en commençant par une valeur proche de la note la plus
3274 rapide (la durée la plus courte) du morceau. Au plus la durée de
3275 référence est petite, au plus la musique sera étalée ; à l'inverse,
3276 une durée de référence élevée produira une musique resserrée.
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 8)
3299 \new RhythmicStaff {
3303 c'16 c'16 c'16 c'16 c'16
3310 proportionalNotationDuration = #(ly:make-moment 1 16)
3317 \new RhythmicStaff {
3321 c'16 c'16 c'16 c'16 c'16
3328 proportionalNotationDuration = #(ly:make-moment 1 32)
3334 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3335 comme la croche pour la première ligne, a pour conséquence de resserrer
3336 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3337 remarquez aussi que, par principe, la notation proportionnelle occupe
3338 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3339 notation proportionnelle met en évidence le rythme au détriment de
3340 l'espacement horizontal.
3342 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3345 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3346 ajoutons lui une portée incluant un autre type de nolet.
3348 @lilypond[quote,verbatim,ragged-right]
3351 \new RhythmicStaff {
3355 c'16 c'16 c'16 c'16 c'16
3358 \new RhythmicStaff {
3360 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3367 L'espacement est loin d'être idéal, pour la simple raison que
3368 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3369 uniformément. Il est vrai que de telles constructions complexes en
3370 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3371 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3372 @code{proportionalNotationDuration} permet d'arranger les choses.
3374 @lilypond[quote,verbatim,ragged-right]
3377 \new RhythmicStaff {
3381 c'16 c'16 c'16 c'16 c'16
3384 \new RhythmicStaff {
3386 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3393 proportionalNotationDuration = #(ly:make-moment 1 20)
3399 Cependant, si l'on observe de près, il est évident que les notes de la
3400 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3401 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3402 allons activer le @code{uniform-stretching}, propriété attachée au
3403 @code{SpacingSpanner}.
3405 @lilypond[quote,verbatim,ragged-right]
3408 \new RhythmicStaff {
3412 c'16 c'16 c'16 c'16 c'16
3415 \new RhythmicStaff {
3417 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3424 proportionalNotationDuration = #(ly:make-moment 1 20)
3425 \override SpacingSpanner #'uniform-stretching = ##t
3431 L'espacement sur les deux portées est maintenant correct, les relations
3432 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3433 une indication temporelle ou autre graphisme selon notre envie.
3435 Notez bien que la prise en charge de la notation proportionnelle par
3436 LilyPond demande que, dans chaque partition, soit activée la propriété
3437 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3438 contraire, utiliser @code{proportionalNotationDuration} aura pour
3439 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3440 inséré des silences invisibles @emph{skip}.
3442 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3443 au contexte @code{Score}. Tout comme pour la propriété
3444 @code{proportionalNotationDuration}, les réglages du
3445 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3446 votre fichier : dans un bloc @code{\with}, dans un bloc
3447 @code{\context} ou au beau milieu de la musique à l'aide de la
3448 commande @code{\set}.
3450 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3451 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3452 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3453 partition. Vous pourriez toutefois avoir besoin de modifier ce
3454 comportement en cours de partition, et recourir alors à l'instruction
3455 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3456 rubrique @ref{Changement d'espacement en cours de partition}.
3458 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3459 qui est désactivé pour la plupart des partitions en notation
3460 proportionnelle. Voici ce qui apparaît dans une partition
3461 traditionnelle : il y a toujours un @qq{espace préservé} juste
3462 avant la première note de chaque portée.
3464 @lilypond[quote,verbatim,ragged-right]
3476 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3477 présent lorsqu'intervient un changement de métrique, d'armure ou de
3478 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3479 réduire cet espace à zéro.
3481 @lilypond[quote,verbatim,ragged-right]
3487 \remove Separating_line_group_engraver
3495 Les éléments non musicaux tels que métrique, armure et clef, posent
3496 problème lorsqu'on travaille en notation proportionnelle. Bien
3497 qu'aucune notion de durée ne leur soit attachée, ces éléments
3498 @qq{consomment} de l'espace. Différentes approches permettent
3499 cependant de gérer ce problème.
3501 Éviter les problèmes d'espacement avec l'armure est chose aisée :
3502 il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
3503 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3504 proportionnelle. Il en va de même pour la métrique, et tout
3505 particulièrement lorsque la partition comporte un quadrillage temporel
3506 ou autres graphismes. L'absence de métrique reste cependant
3507 exceptionnelle et la plupart des partitions en notation proportionnelle
3508 laissent apparaître quelques métriques. Il est par contre pratiquement
3509 impossible de se passer de clef et d'altération.
3511 L'une des options permettant de s'affranchir de l'espacement dû aux
3512 éléments non musicaux consiste en l'activation de la propriété
3513 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3514 les deux portées suivantes :
3516 @lilypond[quote,verbatim,ragged-right]
3518 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3528 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3529 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3539 Toutes deux affichent un espacement proportionnel. Cependant, la
3540 première ligne laisse apparaître un espacement plus lâche en raison de
3541 la présence d'un changement de clef. En ce qui concerne la deuxième
3542 ligne, l'espacement est strictement observé dès lors que la propriété
3543 @code{strict-note-spacing} a préalablement été activée. Comme vous
3544 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3545 conséquence que l'algorithme d'espacement ignore tout bonnement la
3546 largeur des métriques, armures, clefs et altérations.
3548 En plus de ceux que nous venons de voir, vous trouverez d'autres
3549 réglages en usage dans la notation proportionnelle comme, entre autres,
3552 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3553 @item @code{tupletFullLength = ##t}
3554 @item @code{\override Beam #'breakable = ##t}
3555 @item @code{\override Glissando #'breakable = ##t}
3556 @item @code{\override TextSpanner #'breakable = ##t}
3557 @item @code{\remove Forbid_line_break_engraver (dans un contexte de voix}
3560 Ces différents réglages permettent un espacement strict des notes
3561 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3562 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3563 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3564 différentes rubriques associées du manuel pour chacun de ces réglages.
3567 Manuel de notation :
3568 @ref{Changement d'espacement en cours de partition}.
3571 @rlsrnamed{Spacing,Espacements}.
3574 @node Réduction du nombre de pages de la partition
3575 @section Réduction du nombre de pages de la partition
3576 @translationof Fitting music onto fewer pages
3578 Vous pourriez un jour être confronté au problème suivant : l'une
3579 des pages de votre partition ne comporte que deux portées alors que --
3580 ce qui est d'autant plus frustrant -- l'espace libre sur les autres
3581 pages aurait permis une distribution différente.
3583 L'instruction @code{annotate-spacing} se révèle être un outil
3584 indispensable pour l'analyse des problèmes de mise en forme. Cette
3585 commande met en surimpression la valeur des différentes variables
3586 d'espacement et de mise en forme, comme nous allons le voir dans la
3587 rubrique @ref{Mise en évidence de l'espacement}.
3590 * Mise en évidence de l'espacement::
3591 * Modification de l'espacement::
3595 @node Mise en évidence de l'espacement
3596 @subsection Mise en évidence de l'espacement
3597 @translationof Displaying spacing
3599 @funindex annotate-spacing
3600 @cindex espacement, affichage des valeurs
3602 Le meilleur moyen d'appréhender les différentes variables de
3603 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3604 la mise en page, consiste à activer, au sein du bloc @code{\paper}, la
3605 fonction @code{annotate-spacing} :
3607 @c need to have \book{} otherwise we get the separate systems. -hwn
3608 @lilypond[verbatim,quote]
3609 #(set-default-paper-size "a6" 'landscape)
3612 \paper { annotate-spacing = ##t }
3617 Toutes les dimensions sont exprimées en espace de portée
3618 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3619 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3620 feuille (@code{paper-height}) est de 59,75 espaces de portée
3621 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3622 20 points -- sa valeur par défaut. Notez que :
3624 @multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
3627 @tab = (25,4/72,27) mm
3630 @tab = (@code{staff-size})/4 pts
3632 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3637 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3638 1,757 millimètres. Les 59,75 @code{staff-spaces} de
3639 @code{paper-height} correspondent donc à 105 millimètres, soit la
3640 hauteur d'une feuille au format A6 à l'italienne. Les paires
3641 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3642 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3645 Manuel de notation :
3646 @ref{Définition de la taille de portée}.
3649 @rlsrnamed{Spacing,Espacements}.
3652 @node Modification de l'espacement
3653 @subsection Modification de l'espacement
3654 @translationof Changing spacing
3656 Les informations fournies par @code{annotate-spacing} en matière de
3657 dimensionnement vertical sont incomparables. Pour plus de détails sur
3658 les manières de modifier marges et autres variables connexes, consultez
3659 la rubrique @ref{Mise en forme de la page}.
3661 En dehors des marges, vous disposez de quelques moyens supplémentaires
3662 pour gagner de l'espace :
3666 Rapprocher les systèmes le plus possible les uns des autres, de telle
3667 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3668 suffisamment pour éviter le blanc en bas de page.
3672 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3673 ragged-last-bottom = ##f
3679 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3680 deux titres. D'une part, le fait de définir un nombre de systèmes --
3681 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3682 systèmes par page dans la mesure où l'une des étapes d'estimation des
3683 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3684 systèmes par page permet d'en disposer plus sur les suivantes. Par
3685 exemple, avec un nombre par défaut de 11 systèmes par pages,
3686 l'instruction suivante le force à 10.
3695 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3696 se répartir sur deux pages.
3705 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3706 Par exemple, un crochet de reprise ou d'alternative consomme de
3707 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3708 diminue d'autant l'espace disponible que si seul le premier ne
3709 comportait l'indication. Autre exemple, les indications de nuance qui
3710 se @qq{détachent} d'un système peuvent être rapprochés de la portée :
3712 @lilypond[verbatim,quote,relative=1]
3714 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3718 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3719 comme indiqué à la rubrique
3720 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3721 l'espacement par défaut :
3723 @lilypond[verbatim,quote]
3736 Par contre, le fait de modifier la valeur de la propriété
3737 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3738 -- bien que la noire soit la durée la plus courante, nous prenons une
3739 valeur plus longue -- donnera un effet @qq{resserré} à la musique :
3741 @lilypond[verbatim,quote]
3753 \override SpacingSpanner
3754 #'common-shortest-duration = #(ly:make-moment 1 2)
3761 La propriété @code{common-shortest-duration} ne peut être modifiée
3762 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3763 s'applique à l'intégralité de la partition.
3768 Manuel de notation :
3769 @ref{Mise en forme de la page},
3770 @ref{Modification de l'espacement horizontal}.
3773 @rlsrnamed{Spacing,Espacements}.