1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 95b372c451ea1586db8db66d3d00334382e8e103
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Frédéric Chiasson, Jean-Charles Malahieude
18 Negative numbers are allowed:
19 > Are you sure? The following works well
21 > first-page-number = -2
23 > and prints page number -1 on the second page, for example.
26 In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
29 "@code{layout-set-staff-size} does not change the distance between
32 Could we add a sentence:
33 "Use instead the pair fontSize = #@var{N}
34 \override StaffSymbol #'staff-space = #(magstep @var{N})
35 inside the Staff context to change the size of the font and the
36 distance between staff lines accordingly."
38 Actually I found, that the @internalsref{StaffSymbol} at line 481
39 sends to an incomplete documentation. The property staff-space is not
40 explained here. I thought Y-extent might be of help, but it is in turn
41 explained by x-space which again is missing from the list. Who has the
42 knowledge to fix this?
46 http://code.google.com/p/lilypond/issues/detail?id=68
51 @node Gestion de l'espace
52 @chapter Gestion de l'espace
53 @translationof Spacing issues
55 L'agencement général d'une partition dépend de trois facteurs
56 interdépendants : la mise en page, les sauts de ligne et l'espacement.
57 Les choix faits en matière d'espacement détermineront la densité de
58 chacun des systèmes, ce qui influera sur le positionnement des sauts de
59 ligne et, par voie de conséquence, sur le nombre de pages de la
62 En pratique, cette procédure comporte quatre étapes. Dans un premier
63 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
64 base des durées. Sont alors calculées différentes possibilités de saut
65 de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
66 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
67 la combinaison entre sauts de page et de ligne qui offre la meilleure
68 occupation de l'espace, tant horizontalement que verticalement.
70 Les réglages qui influencent la mise en forme se placent dans deux blocs
71 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
72 @ref{Mise en forme de la page} contient les réglages applicables à
73 l'intégralité du document -- à toutes les partitions d'un ouvrage --
74 tels que format du papier, impression ou non des numéros de page, etc.
75 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
76 rubrique @ref{Mise en forme de la partition}, il détermine la mise en
77 forme de la musique : le nombre de systèmes utilisés, l'espacement des
78 regroupements de portées, etc.
81 * Mise en forme de la page::
82 * Mise en forme de la partition::
84 * Espacement vertical::
85 * Espacement horizontal::
86 * Réduction du nombre de pages de la partition::
89 @cindex ragged, aligné
90 @cindex aligné, ragged
92 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
93 dont la traduction vous semblera assurément erronée. Il n'en est
94 cependant rien : certains termes techniques ont une histoire
95 particulière selon leur langue d'origine. Ainsi le vocable anglais
96 @emph{Ragged} signifie en lambeau, en loques ; dans l'univers
97 typographique, un maître français voit un alignement à gauche -- il dira
98 @qq{au fer à gauche} -- alors que son homologue anglophone constate un
99 @emph{ragged-right} -- donc du vide à droite.}
102 @node Mise en forme de la page
103 @section Mise en forme de la page
104 @translationof Page layout
106 Nous allons examiner ici les options qui contrôlent la mise en forme des
107 pages attachées au bloc @code{\paper}.
111 * Format du papier et adaptation automatique::
112 * Variables d'espacement vertical fixe::
113 * Variables d'espacement vertical fluctuant::
114 * Variables d'espacement horizontal::
115 * Autres variables du bloc \paper::
120 @subsection Le bloc @code{\paper}
121 @translationof The @code{\paper} block
123 Un bloc @code{\paper} peut apparaître au sein d'un bloc @code{\book}.
124 Les réglages effectués à l'aide du bloc @code{\paper} s'appliqueront à
125 l'intégralité d'un ouvrage, qui peut comporter plusieurs partitions (des
126 blocs @emph{score}) ; il ne doit donc en aucun cas se trouver dans un
127 bloc @code{\score}. Peuvent apparaître dans un bloc @code{\paper} :
132 la fonction Scheme @code{set-paper-size},
135 des variables propres au bloc @code{\paper} qui viendront adapter la
139 la définition des différents @emph{markups} qui personnaliseront la mise
140 en forme des entêtes et pieds de page ainsi que des titrages.
144 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
145 -- @ref{Format du papier et adaptation automatique}. Les variables du
146 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
147 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
148 des entête, pied de page et titrage, elles sont étudiées à la rubrique
149 @ref{Titrages personnalisés}.
151 La plupart des variables gérant le papier ne sont fonctionnelles que
152 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
153 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
154 rubrique @ref{Le bloc \layout}.
156 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
157 correspondent à des dimensions sont exprimées en millimètre -- vous
158 pouvez bien entendu spécifier un autre système de mesure. Voici
159 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
168 Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
169 mentionner le suffixe d'unité @code{\in} :
177 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
178 @code{\in} et @code{\pt}. Ces unités sont des conversions de
179 millimètres, répertoriées dans le fichier
180 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
181 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
182 @code{\mm} à votre code lorsque vous travaillez en millimètres.
184 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
185 fonctions Scheme. Voici l'équivalent de l'exemple précédent :
189 #(define top-margin (* 0.5 in))
195 @ref{Format du papier et adaptation automatique},
196 @ref{Titrages personnalisés}.
197 @ref{Le bloc \layout}.
199 Fichiers d'initialisation :
200 @file{ly/paper-defaults-init.ly}.
203 @node Format du papier et adaptation automatique
204 @subsection Format du papier et adaptation automatique
205 @translationof Paper size and automatic scaling
207 @cindex papier, taille
214 * Adaptation automatique au format::
218 @node Format du papier
219 @unnumberedsubsubsec Format du papier
220 @translationof Setting the paper size
222 LilyPond génère par défaut, et en l'absence de mention explicite d'un
223 format de papier, un fichier imprimable au format A4. Vous pouvez
224 cependant utiliser un autre format à l'aide des deux fonctions
225 @code{set-default-paper-size} et @code{set-paper-size} qui, elle, se
226 place à l'intérieur d'un bloc @code{\paper} :
229 #(set-default-paper-size "quarto")
232 qui se place en début de fichier, ou @code{set-paper-size},
236 #(set-paper-size "tabloid")
240 qui s'inscrit au sein d'un bloc @code{\paper}.
243 La seule restriction à l'utilisation isolée de la fonction
244 @code{set-default-paper-size} est qu'elle doit intervenir avant le
245 premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
246 format pour toutes les pages, alors que @code{set-paper-size} détermine
247 le format des feuilles rattachées à un bloc @code{\paper} particulier.
248 Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
249 format du papier s'appliquera à toutes les pages ; si @code{\paper}
250 apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
251 @emph{book} en question.
253 À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
254 doit intervenir avant toute autre variable. Les raisons à ceci sont
255 abordées à la rubrique @ref{Adaptation automatique au format}.
257 Différents formats de papier sont définis dans le fichier
258 @file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
259 format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
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 @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 L'inversion des dimensions du papier sans pour autant basculer la
295 présentation -- comme pour imprimer sur une carte postale ou créer un
296 graphique destiné à inclusion -- s'obtient en ajoutant @samp{landscape}
297 au nom du format de papier :
300 #(set-default-paper-size "a6landscape")
303 Lorsque la taille du papier comporte explicitement @samp{landscape} ou
304 @samp{portrait}, la présence d'un argument @code{'landscape} aura pour
305 seul effet de modifier l'orientation de l'image et non les dimensions de
310 @ref{Adaptation automatique au format},
311 @ref{Formats de papier prédéfinis}.
313 Fichiers d'initialisation :
314 @file{scm/paper.scm}.
317 @node Adaptation automatique au format
318 @unnumberedsubsubsec Adaptation automatique au format
319 @translationof Automatic scaling to paper size
321 Toute modification du format de papier à l'aide des fonctions Scheme
322 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
323 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
324 par l'ajustement d'un certain nombre de variables attachées au bloc
325 @code{\paper} afin qu'elles soient en concordance avec le format
326 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
327 particulière en redéfinissant sa valeur après avoir spécifié le format
328 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
329 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
330 l'étalonnage automatique, bien que spécifier une largeur de papier
331 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
332 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
333 voir avec la mise à l'échelle.
335 L'adaptation automatique affecte les dimensionnements verticaux
336 @code{top-margin} et @code{bottom-margin} -- voir
337 @ref{Variables d'espacement vertical fixe} --, ainsi que les
338 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
339 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
340 @code{indent} et @code{short-indent} -- voir
341 @ref{Variables d'espacement horizontal}.
343 Les valeurs par défaut de ces dimensionnements sont contenues dans le
344 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
345 internes @code{top-margin-default}, @code{bottom-margin-default}, etc.
346 correspondant au format par défaut -- papier A4 -- pour lequel
347 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
352 @ref{Variables d'espacement vertical fixe},
353 @ref{Variables d'espacement horizontal}.
355 Fichiers d'initialisation :
356 @file{ly/paper-defaults-init.ly},
357 @file{scm/paper.scm}.
360 @node Variables d'espacement vertical fixe
361 @subsection Variables d'espacement vertical fixe
362 @translationof Fixed vertical spacing @code{\paper} variables
364 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
365 sont automatiquement ajustés selon le format du papier, ce qui peut
366 conduire à un résultat inattendu --
367 voir @ref{Adaptation automatique au format}.}
369 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
370 @file{ly/paper-defaults-init.ly}.
374 @funindex paper-height
376 La hauteur de la feuille. Il s'agit par défaut de la dimension du
377 papier utilisé. Notez bien que cette variable n'affectera pas
378 l'ajustement automatique d'un certain nombre de dimensionnements
384 La marge entre le bord supérieur de la feuille et la surface imprimable.
385 Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
389 @funindex bottom-margin
391 La marge entre la surface imprimable et le bord inférieur de la feuille.
392 Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
396 @funindex ragged-bottom
398 L'activation de cette variable permet de ne pas répartir verticalement
399 les systèmes sur les pages hormis la dernière. La valeur par défaut
400 est @code{#f}. Lorsque la partition ne comporte que deux ou trois
401 systèmes par page, comme pour un conducteur d'orchestre, nous vous
402 conseillons d'activer cette variable.
404 @item ragged-last-bottom
405 @funindex ragged-last-bottom
407 La désactivation de cette variable permet de répartir verticalement les
408 systèmes de la dernière page d'une partition. La valeur par défaut
409 est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
410 deux pages ou plus, de désactiver cette variable.@*
411 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
412 dernière page de chacune des parties -- créées à l'aide d'un bloc
413 @code{\bookpart} -- d'un même ouvrage.
419 @ref{Adaptation automatique au format}.
421 Fichiers d'initialisation :
422 @file{ly/paper-defaults-init.ly}.
425 @rlsrnamed{Spacing, Espacements}.
428 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
429 comme des systèmes à part entière ; ils seront donc affectés par
430 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
431 ajouteront de l'espace avant le premier système de la partition.
433 La définition explicite d'un format de papier annulera tout réglage des
434 marges haute et basse.
437 @node Variables d'espacement vertical fluctuant
438 @subsection Variables d'espacement vertical fluctuant
439 @translationof Flexible vertical spacing @code{\paper} variables
441 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
442 entre différents éléments (marges, titres, systèmes ou mouvements), en
443 dilatation ou compression selon le cas. Un certain nombre de variables
444 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
445 ces dimensionnements.
447 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
448 parlons ici n'influencent en rien l'espacement des portées d'un même
449 système. L'espacement au sein des systèmes est géré par des propriétés
450 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
451 définissent au niveau du bloc @code{\score} -- voir à ce sujet
452 @ref{Espacement vertical au sein d'un système}.
455 * Structure des variables d'espacement vertical fluctuant::
456 * Liste des variables d'espacement vertical fluctuant::
460 @node Structure des variables d'espacement vertical fluctuant
461 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
462 @translationof Structure of flexible vertical spacing alists
464 Chacune de ces variables attachées au bloc @code{\paper} est constituée
465 d'une liste associative @emph{(alist)} à quatre @i{clés} :
470 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
471 par défaut, exprimée en hauteur de portée, séparant les @i{points de
472 référence} de deux éléments, qui évite tout risque de collision en
473 l'absence de dilatation ou compression. Le point de référence d'un
474 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
475 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
476 ligne de @qq{non-portée} viendrait à s'intercaler. Une
477 @code{basic-distance} inférieure à @code{padding} ou
478 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
479 résultant ne saurait être inférieur à @code{padding} ou
480 @code{minimum-distance}.
483 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
484 minimal, exprimé en hauteur de portée, entre les points de référence des
485 deux éléments alors qu'il y a déjà un effet de compression. Une
486 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
487 sans effet, dans la mesure où l'espacement résultant ne saurait être
488 inférieur au @code{padding}.
490 @c TODO: explain skylines somewhere and xref to it from here.
493 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
494 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
495 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
496 sur toute la largeur des deux éléments.
499 @code{stretchability} @emph{(dilatation)} -- le coefficient
500 d'étirement de cet espace. Un coefficient nul permet de figer
501 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
502 positif déterminera la propension d'un espacement à s'étirer, tout
503 en tenant compte du coefficient affecté aux autres espacements.
504 Par exemple, lorsque le coefficient de dilatation d'une dimension est
505 double de celui d'une autre, elle pourra s'étirer deux fois plus que
506 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
507 provoque une @code{programming_error} (erreur de programmation) et est
508 ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
509 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
510 sa valeur est par défaut égale à @code{space}. Notez bien que
511 l'utilisateur ne peut définir une propension à la compression ;
512 elle est en fait égale à
513 (@code{basic-distance} @minus{} @code{minimum-distance}).
517 Lorsque l'impression n'est pas en pleine page -- elle est donc
518 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
519 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
525 @code{basic-distance}, plus
527 @code{minimum-distance} et
529 @code{padding}, augmenté de ce qu'il faut pour éviter les
534 Cependant, lorsque la partition fait plusieurs pages, la dernière page
535 reprendra dans la mesure du possible l'espacement de la page précédente.
537 Les manières de modifier des listes associatives font l'objet d'un
538 @rusernamed{Modification de listes associatives, chapitre spécifique}.
539 L'exemple suivant indique deux façons de modifier une liste associative.
540 La première déclaration intervient sur une seule clé, alors que la
541 deuxième redéfinit complètement la variable.
545 system-system-spacing #'basic-distance = #8
547 score-system-spacing =
549 (basic-distance . 12)
550 (minimum-distance . 6)
551 (stretchability . 12))
556 @node Liste des variables d'espacement vertical fluctuant
557 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
558 @translationof List of flexible vertical spacing @code{\paper} variables
560 Le nom des dimensionnements à hauteur variable sont de la forme
561 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
562 @code{@var{après}} représentent les éléments qui doivent être espacés.
563 La distance s'établit entre les points de référence des deux éléments
564 concernés (voir la rubrique précédente pour plus de précision). Notez
565 bien que, dans les règles de nommage des variables qui suivent, le terme
566 @code{markup} fait référence aussi bien à un @i{markup de titrage}
567 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
568 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
569 distances sont exprimées en espace de portée.
571 Leurs valeurs par défaut sont inscrites dans le fichier
572 @file{ly/paper-defaults-init.ly}.
574 @c TODO: Where do headers/footers fit in? -mp
577 @item markup-system-spacing
578 @funindex markup-system-spacing
580 détermine l'espacement entre un titre ou un @emph{markup} de premier
581 niveau, et le système qui le suit.
583 @item score-markup-spacing
584 @funindex score-markup-spacing
586 détermine l'espacement entre le dernier système et le titre ou
587 @emph{markup} de haut niveau qui le suit.
589 @item score-system-spacing
590 @funindex score-system-spacing
592 détermine l'espacement entre le dernier système d'une partition et le
593 premier système de la partition suivante, en l'absence de titrage ou
594 @emph{markup} qui les sépare.
596 @item system-system-spacing
597 @funindex system-system-spacing
599 détermine l'espacement entre deux systèmes d'un même mouvement.
601 @item markup-markup-spacing
602 @funindex markup-markup-spacing
604 détermine l'espacement entre deux titres ou @emph{markups} de premier
607 @item last-bottom-spacing
608 @funindex last-bottom-spacing
610 détermine la distance entre le dernier système ou le dernier
611 @emph{markup} de haut niveau, et le bas de la surface imprimable --
612 autrement dit le haut de la marge basse.
614 @item top-system-spacing
615 @funindex top-system-spacing
617 détermine l'espace entre le haut de la surface imprimable (le bas de la
618 marge haute) et le milieu du premier système. Cette variable n'est
619 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
622 @item top-markup-spacing
623 @funindex top-markup-spacing
625 détermine l'espace entre le haut de la surface imprimable (le bas de la
626 marge haute) et le premier titre ou @emph{markup} de premier niveau.
627 Cette variable n'est effective qu'en l'absence de système en haut de
634 @ref{Espacement vertical au sein d'un système}.
637 @rlsrnamed{Spacing,Espacements}.
640 @rlsrnamed{Spacing,Espacements}.
643 @node Variables d'espacement horizontal
644 @subsection Variables d'espacement horizontal
645 @translationof Horizontal spacing \paper variables
647 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
648 sont automatiquement ajustés selon le format du papier, ce qui peut
649 conduire à un résultat inattendu --
650 voir @ref{Adaptation automatique au format}.}
653 * Variables de marge et de largeur::
654 * Variables spécifiques pour l'impression recto-verso::
655 * Variables d'indentation et de décalage::
659 @node Variables de marge et de largeur
660 @unnumberedsubsubsec Variables de marge et de largeur
661 @translationof @code{\paper} variables for widths and margins
663 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
664 @file{ly/paper-defaults-init.ly}.
669 @funindex paper-width
671 La largeur de la page. Elle correspond par défaut à la largeur du
672 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
673 matière d'ajustement automatique, cette variable influe sur la variable
674 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
675 @code{paper-width} et @code{line-width}, les valeurs de
676 @code{left-margin} et @code{right-margin} seront recalculées. Voir
677 aussi @code{check-consistency}.
682 la longueur d'un système musical sans indentation et justifié sur toute
683 la largeur de la page. La valeur par défaut est égale à
684 @code{paper-width}, auquel sont retranchés @code{left-margin} et
685 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
686 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
687 marges seront alors recalculées de telle sorte que les systèmes soient
688 centrés. Voir aussi @code{check-consistency}. La variable
689 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
692 @funindex left-margin
694 la marge entre le bord gauche de la feuille et le début de chaque
695 système. La valeur par défaut est de @code{10\mm} ; elle sera
696 ajustée selon le format du papier. Lorsque vous définissez
697 @code{line-width} et @code{right-margin} sans modifier la valeur de
698 @code{left-margin}, cette dernière sera alors égale à
699 @code{(paper-width @minus{} line-width @minus{} right-margin)}.
700 Lorsque seule @code{line-width} est définie, les deux marges
702 @code{((paper-width @minus{} line-width) / 2)}, ce
703 qui a pour effet de centrer les systèmes sur la page. Voir aussi
704 @code{check-consistency}.
707 @funindex right-margin
709 La marge entre le bord droit de la page et la fin des systèmes en pleine
710 largeur (non @emph{ragged}). La valeur par défaut est de @code{10\mm}
711 et s'ajustera selon le format du papier. Lorsque vous définissez
712 @code{line-width} et @code{left-margin}, sans modifier la valeur de
713 @code{right-margin}, cette dernière sera alors égale à
714 @code{(paper-width @minus{} line-width @minus{} left-margin)}.
715 Lorsque seule @code{line-width} est définie, les deux marges
717 @code{((paper-width @minus{} line-width) / 2)}, ce
718 qui a pour effet de centrer les systèmes sur la page. Voir aussi
719 @code{check-consistency}.
721 @item check-consistency
722 @funindex check-consistency
724 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
725 @code{line-width} et @code{right-margin} sont en cohérence, et que
726 l'addition de ces trois éléments ne dépassera pas la largeur du papier
727 (@code{paper-width}). La valeur par défaut est @code{#t}. Dans
728 le cas d'une incohérence, un message d'avertissement est émis et les
729 trois variables -- marges et longueur de ligne -- rétablies à leur
730 valeur par défaut (ajustées selon le format du papier).
733 @funindex ragged-right
735 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
736 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
737 La valeur par défaut est @code{#f} mais, si la partition ne comporte
738 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
739 se gérer au sein d'un bloc @code{\layout}.
742 @funindex ragged-last
744 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
745 dernier système de façon à occuper toute la longueur de la ligne. La
746 valeur par défaut est @code{#f}. Cette variable peut aussi
747 se gérer au sein d'un bloc @code{\layout}.
753 @ref{Adaptation automatique au format}.
755 Fichiers d'initialisation :
756 @file{ly/paper-defaults-init.ly}.
759 La définition explicite d'un format de papier annulera tout réglage des
760 marges gauche et droite.
763 @node Variables spécifiques pour l'impression recto-verso
764 @unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
765 @translationof @code{\paper} variables for two-sided mode
767 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
768 @file{ly/paper-defaults-init.ly}.
778 Cette variable permet de gérer efficacement les impressions recto-verso.
779 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
780 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
781 différentes marges selon qu'il s'agit d'une page paire ou impaire.
782 Cette variable s'applique en lieu et place de @code{left-margin} et
783 @code{right-margin}. La valeur par défaut est @code{#f}.
786 @funindex inner-margin
788 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
789 avoir du côté intérieur. Bien entendu, cette variable n'est
790 effective que lorsque vous comptez générer un fichier imprimable en
791 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
792 défaut est de @code{10\mm} et s'ajustera selon le format du papier.
795 @funindex outer-margin
797 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
798 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
799 variable n'est effective que lorsque vous comptez générer un fichier
800 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
801 La valeur par défaut est de @code{20\mm} et s'ajustera selon le
805 @funindex binding-offset
807 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
808 valeur de la marge intérieure @code{inner-margin} de telle sorte que
809 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
810 effective que lorsque vous comptez générer un fichier imprimable en
811 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
812 défaut est de @code{0} et s'ajustera selon le format du papier.
818 @ref{Adaptation automatique au format}.
820 Fichiers d'initialisation :
821 @file{ly/paper-defaults-init.ly}.
824 @node Variables d'indentation et de décalage
825 @unnumberedsubsubsec Variables d'indentation et de décalage
826 @translationof @code{\paper} variables for shifts and indents
828 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
829 @file{ly/paper-defaults-init.ly}.
833 @item horizontal-shift
834 @funindex horizontal-shift
836 @c This default value is buried in the middle of page.scm. -mp
838 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
839 seront poussés d'autant vers la droite. La valeur par défaut est
845 Le niveau d'indentation du premier système d'une partition. La valeur
846 par défaut est de @code{15\mm} et s'ajustera selon le format du
847 papier. Cette variable peut aussi se gérer au sein d'un bloc
851 @funindex short-indent
853 Le niveau d'indentation de tous les systèmes hormis le premier. La
854 valeur par défaut est de @code{0}, et s'ajustera selon le format du
855 papier dès lors que vous lui affecterez une valeur. Cette variable peut
856 aussi se gérer au sein d'un bloc @code{\layout}.
862 @ref{Adaptation automatique au format}.
864 Fichiers d'initialisation :
865 @file{ly/paper-defaults-init.ly}.
868 @rlsrnamed{Spacing, Espacements}.
871 @node Autres variables du bloc \paper
872 @subsection Autres variables du bloc @code{\paper}
873 @translationof Other @code{\paper} variables
876 * Variables de gestion des sauts de ligne::
877 * Variables de gestion des sauts de page::
878 * Variables de gestion des numéros de page::
879 * Variables supplémentaires::
883 @node Variables de gestion des sauts de ligne
884 @unnumberedsubsubsec Variables de gestion des sauts de ligne
885 @translationof @code{\paper} variables for line breaking
887 @c TODO: Mention that ly:optimal-breaking is on by default? -mp
891 @item max-systems-per-page
892 @funindex max-systems-per-page
894 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
895 variable n'est prise en compte, à ce jour, que par l'option
896 @code{ly:optimal-breaking}, et n'est pas définie.
898 @item min-systems-per-page
899 @funindex min-systems-per-page
901 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
902 cependant aux risques de débordement s'il est trop important. Cette
903 variable n'est prise en compte, à ce jour, que par l'option
904 @code{ly:optimal-breaking}, et n'est pas définie.
906 @item systems-per-page
907 @funindex systems-per-page
909 Le nombre de systèmes que devrait comporter chaque page. Cette variable
910 n'est à ce jour prise en charge que par l'algorithme
911 @code{ly:optimal-breaking} et n'est pas définie par défaut.
914 @funindex system-count
916 Le nombre de systèmes requis par la partition. Cette variable n'est pas
917 définie par défaut. Cette variable peut se gérer au sein d'un bloc
924 @ref{Sauts de ligne}.
927 @node Variables de gestion des sauts de page
928 @unnumberedsubsubsec Variables de gestion des sauts de page
929 @translationof @code{\paper} variables for page breaking
931 Les valeurs par défaut sont définies dans le fichier
932 @file{ly/paper-defaults-init.ly}.
936 @item blank-after-score-page-force
937 @funindex blank-after-score-page-force
939 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
940 valeur est par défaut inférieure à celle de
941 @code{blank-page-force} ; nous préférons qu'une page blanche
942 s'insère après la fin de la partition plutôt qu'au milieu.
944 @item blank-last-page-force
945 @funindex blank-last-page-force
947 Pénalité pour fin de partition intervenant sur une page impaire. La
948 valeur par défaut est de @code{0}.
950 @item blank-page-force
951 @funindex blank-page-force
953 Pénalité pour apparition d'une page blanche en cours de partition.
954 L'algorithme @code{ly:optimal-breaking} n'en tiendra pas compte
955 puisqu'il ne conçoit pas la présence d'une page blanche au milieu d'une
956 partition. La valeur par défaut est de @code{5}.
959 @funindex page-breaking
961 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
962 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking} et
963 @code{ly:optimal-breaking}.
965 @item page-breaking-system-system-spacing
966 @funindex page-breaking-system-system-spacing
968 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
969 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
970 lorsque @code{page-breaking-system-system-spacing #'padding} a une
971 valeur nettement supérieure à @code{system-system-spacing #'padding},
972 l'algorithme en question aura tendance à disposer moins de systèmes sur
973 une même page. Cette variable est par défaut non définie.
978 Le nombre de pages que devra comporter la partition. Cette variable est
979 par défaut non définie.
986 @ref{Optimisation des sauts de page},
987 @ref{Optimisation des tournes},
988 @ref{Minimisation des sauts de page},
989 @ref{Présentation en rouleau}.
991 Fichiers d'initialisation :
992 @file{ly/paper-defaults-init.ly}.
995 @node Variables de gestion des numéros de page
996 @unnumberedsubsubsec Variables de gestion des numéros de page
997 @translationof @code{\paper} variables for page numbering
999 Les valeurs par défaut sont définies dans le fichier
1000 @file{ly/paper-defaults-init.ly}.
1004 @item auto-first-page-number
1005 @funindex auto-first-page-number
1007 L'algorithme qui gère les sauts de page prend en compte le fait que le
1008 premier numéro de page soit pair ou impair. Lorsque cette
1009 fonctionnalité est activée, l'algorithme des sauts de page décidera de
1010 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
1011 par un éventuel incrément de un. La valeur par défaut
1014 @item first-page-number
1015 @funindex first-page-number
1017 Le numéro de la première page. La valeur par défaut est
1020 @item print-first-page-number
1021 @funindex print-first-page-number
1023 Cette variable permet d'imprimer le numéro de page y compris sur la
1024 première. La valeur par défaut est @code{#f}.
1026 @item print-page-number
1027 @funindex print-page-number
1029 La désactivation de cette variable permet d'obtenir des pages non
1030 numérotées. La valeur par défaut est @code{#t}.
1035 Fichiers d'initialisation :
1036 @file{ly/paper-defaults-init.ly}.
1039 Les pages au numéro impair sont toujours à droite. Pour que la musique
1040 commence en page 1, le dos de la page de garde doit être vide de telle
1041 sorte que la page une se retrouve à droite.
1044 @node Variables supplémentaires
1045 @unnumberedsubsubsec Variables supplémentaires
1046 @translationof Miscellaneous @code{\paper} variables
1050 @item page-spacing-weight
1051 @funindex page-spacing-weight
1053 Cette variable définit l'importance relative des espacements entre la
1054 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1055 privilégiera l'espacement au niveau de la page. La valeur par défaut
1058 @item print-all-headers
1059 @funindex print-all-headers
1061 Lorsque cette variable est activée, l'intégralité des champs d'entête
1062 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1063 champs @code{piece} et @code{opus}. La valeur par défaut
1066 @item system-separator-markup
1067 @funindex system-separator-markup
1069 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1070 chaque système, comme on le voit dans nombre de partitions orchestrales.
1071 Cette variable n'est pas définie par défaut. La commande
1072 @code{\slashSeparator} -- définie dans le fichier
1073 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1076 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1077 #(set-default-paper-size "a8")
1081 system-separator-markup = \slashSeparator
1087 \relative c'' { c1 \break c1 \break c1 }
1095 Fichiers d'initialisation :
1096 @file{ly/titling-init.ly}.
1099 @rlsrnamed{Spacing,Espacements}.
1102 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1103 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1106 @node Mise en forme de la partition
1107 @section Mise en forme de la partition
1108 @translationof Score layout
1110 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1111 plus particulièrement destinées à gérer la mise en forme de la
1116 * Définition de la taille de portée::
1120 @node Le bloc \layout
1121 @subsection Le bloc @code{\layout}
1122 @translationof The @code{\layout} block
1126 Alors que le bloc @code{\paper} définit le formatage des pages pour
1127 l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
1128 forme spécifique à la partition. La mise en forme de la musique peut
1129 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1130 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1131 où la mise en forme concerne une partition en particulier, un bloc
1132 @code{\layout} se placera au sein du bloc @code{\score} en question.
1133 Sont susceptibles d'apparaître dans un bloc @code{\layout} :
1137 la fonction Scheme @code{layout-set-staff-size},
1140 dans des blocs @code{\context}, les modifications apportées aux
1141 différents contextes, et
1144 les variables normalement attachées au bloc @code{\paper} qui
1145 affecteront la mise en forme de la partition.
1149 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1150 suivante, @ref{Définition de la taille de portée}. La modification des
1151 contextes est abordée dans d'autres chapitres -- voir
1152 @ref{Modification des greffons de contexte} et
1153 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1154 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1155 @code{\layout} sont :
1160 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1161 (voir @ref{Variables de marge et de largeur})
1164 @code{indent} et @code{short-indent}
1165 (voir @ref{Variables d'indentation et de décalage})
1169 (voir @ref{Variables de gestion des sauts de ligne})
1173 Voici un exemple de bloc @code{\layout} :
1180 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #8
1184 \override TextScript #'padding = #1
1185 \override Glissando #'thickness = #3
1190 Il est tout à fait possible que plusieurs blocs @code{\layout}
1191 cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
1192 particulièrement utile lorsque différents réglages sont stockés dans des
1193 fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
1194 @code{\layout} est évalué, une copie de la configuration du
1195 @code{\layout} actuel est réalisée en interne, augmentée des
1196 aménagements apportés. Bien qu'on puisse considérer que le contenu des
1197 différents blocs @code{\layout} se cumule, c'est la dernière adaptation
1198 qui aura préséance en cas de situation conflictuelle -- cas typique
1199 d'une même propriété modifiée dans différents blocs.
1201 Par exemple, placer le bloc suivant
1207 \override TextScript #'color = #magenta
1208 \override Glissando #'thickness = #1.5
1213 après celui de l'exemple précédent aura pour effet de cumuler les
1214 adaptations de @code{'padding} et @code{'color} pour l'objet
1215 @code{TextScript}, mais la dernière adaptation apportée à la propriété
1216 @code{'thickness} de @code{Glissando} remplace, ou masque, celle
1217 précédemment établie.
1219 Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
1220 les utiliser ultérieurement. Ceci requiert toutefois une attention
1221 particulière dans la mesure où cette manière de procéder n'est pas
1222 équivalente à une définition complète et globale.
1224 Lorsque nous définissons la variable suivante,
1227 layoutVariable = \layout @{
1230 \override NoteHead #'font-size = #4
1235 qui contient une configuration de @code{\layout} avec
1236 l'adaptation @code{NoteHead #'font-size}, cette combinaison n'est pas
1237 enregistrée en tant que configuration courante. Notez bien que la
1238 « configuration courante » est lue lorsque la variable est définie, non
1239 lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
1240 variable dépend de l'endroit où elle se trouve dans le code source.
1242 Notre variable peut alors être utilisée au sein d'un autre bloc
1243 @code{\layout}, comme par exemple :
1250 \override NoteHead #'color = #red
1255 Un bloc @code{\layout} qui contient une variable comme ci-dessus, ne
1256 recopie pas la configuration actuelle ; il utilise en fait le contenu de
1257 @code{layoutVariable} en tant que configuration de base pour les
1258 adaptations ultérieures, en conséquence de quoi toute modification
1259 intervenant entre la définition et l'utilisation de la variable sera
1262 Si @code{layoutVariable} est définie, ou rapatriée par un
1263 @code{\indude}, juste avant d'être utilisée, son contenu devient la
1264 configuration actuelle augmentée des adaptations que la variable
1265 contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
1266 ci-dessus, le bloc @code{\layout} final contiendra donc :
1269 TextScript #'padding = #1
1270 TextScript #'color = #magenta
1271 Glissando #'thickness = #1.5
1272 NoteHead #'font-size = #4
1273 NoteHead #'color = #red
1276 ainsi que les adaptations de @code{indent} et @code{StaffGrouper}.
1278 Cependant, si la variable avait été définie bien avant le premier bloc
1279 @code{\layout}, la configuration actuelle ne contiendrait que
1282 NoteHead #' font-size= #4 % (écrit dans la définition de la variable)
1283 NoteHead #' color = #red % (ajouté après l'utilisation de la variable)
1286 Une gestion attentive des variables de @code{\layout} se révèle être un
1287 outil précieux dans la mise en forme des sources et le retour à une
1288 configuration donnée.
1291 Manuel de notation :
1292 @ref{Modification des réglages par défaut d'un contexte}.
1295 @rlsrnamed{Spacing,Espacements}.
1298 @node Définition de la taille de portée
1299 @subsection Définition de la taille de portée
1300 @translationof Setting the staff size
1302 @cindex fonte, définition de la taille
1303 @cindex portée, définition de la taille
1304 @funindex layout file
1306 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1307 20 points. Il existe deux manières de la modifier :
1309 La taille des portées peut se définir globalement pour toutes les
1310 partitions d'un même fichier, ou plus précisément d'un bloc
1311 @code{\book}, à l'aide de @code{set-global-staff-size}.
1314 #(set-global-staff-size 14)
1318 Ceci définit donc la hauteur des portées à 14 points par
1319 défaut ; toutes les fontes seront ajustées en conséquence.
1321 Vous pouvez aussi spécifier une taille à une partition en particulier en
1322 procédant comme ci-dessous :
1328 #(layout-set-staff-size 15)
1333 La fonte Feta fournit les symboles musicaux dans huit tailles
1334 différentes. Chaque fonte correspond à une hauteur particulière de
1335 portée ; les petites tailles comportent des symboles plus épais
1336 pour être cohérent avec l'épaisseur relativement plus importante des
1337 lignes de la portée. Le tableau suivant répertorie les différentes
1341 @multitable @columnfractions .15 .2 .22 .2
1343 @item @b{nom de la fonte}
1344 @tab @b{hauteur de portée (pt)}
1345 @tab @b{hauteur de portée (mm)}
1346 @tab @b{utilisation}
1351 @tab format de poche
1371 @tab carnet de chant
1376 @tab partition standard
1387 @c matériel de location moderne ?
1392 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1393 contexte @code{fontSize} ainsi que la propriété de mise en forme
1394 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1395 individuellement la taille de chaque portée. La taille de chacune des
1396 portées est relative à la taille globale.
1399 Manuel de notation :
1400 @ref{Indication de la taille de fonte musicale}.
1403 @rlsrnamed{Spacing,Espacements}.
1406 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1407 lignes d'une portée.
1412 @translationof Breaks
1417 * Optimisation des sauts de page::
1418 * Optimisation des tournes::
1419 * Minimisation des sauts de page::
1420 * Présentation en rouleau::
1421 * Sauts explicites::
1422 * Recours à une voix supplémentaire pour gérer les sauts::
1426 @node Sauts de ligne
1427 @subsection Sauts de ligne
1428 @translationof Line breaking
1430 @cindex saut de ligne
1431 @cindex ligne, passer à la suivante
1433 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1434 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1435 trop aérée, et que des lignes consécutives aient à peu près la même
1438 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1439 vous le jugez utile pour @qq{forcer} le passage à la ligne suivante :
1441 @lilypond[quote,ragged-right,relative=2,verbatim]
1446 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1447 mesure ; LilyPond vous le signalera par un message si tel était le
1448 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1449 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1450 l'aide de @code{\bar ""}.
1452 @lilypond[quote,ragged-right,relative=2,verbatim]
1459 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1460 mesure dès lors que la précédente avait une note en suspend -- c'est
1461 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1462 L'instruction @code{\break} sera alors opérationnelle si vous avez
1463 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1464 @code{Voice} concerné. Notez bien qu'en pareil cas, les sauts de ligne
1465 forcés doivent être saisis au sein d'une expression polyphonique :
1467 @lilypond[quote,ragged-right,verbatim]
1469 \remove "Forbid_line_break_engraver"
1472 { c2. \times 2/3 { c4 c c } c2. | }
1473 { s1 | \break s1 | }
1478 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1479 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1480 introduire la dérogation @w{@code{\override Beam #'breakable = ##t}}.
1482 @lilypond[quote,ragged-right,relative=2,verbatim]
1483 \override Beam #'breakable = ##t
1488 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1489 saut de ligne à la fin de la mesure où elle est explicitée.
1491 LilyPond dispose de deux variables de base pour influencer l'espacement
1492 au niveau des lignes. Toutes deux se définissent dans un bloc
1493 @code{\layout}, @code{indent} réglant l'indentation de la première
1494 ligne, et @code{line-width} la longueur des lignes.
1496 L'activation du commutateur @code{ragged-right} au sein du bloc
1497 @code{\layout} aura pour effet de terminer les systèmes là où ils
1498 prendraient fin normalement plutôt que de les étirer sur toute la
1499 longueur de la ligne. Ceci est particulièrement utile pour de petits
1500 fragments ou pour vérifier la densité induite par l'espacement naturel.
1502 @c TODO Check and add para on default for ragged-right
1504 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1505 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1515 @cindex sauts de ligne réguliers
1516 @cindex portée à quatre mesures
1518 L'utilisation conjointe de @code{\break} et de blancs dans une section
1519 @code{\repeat} vous permettra de positionner des sauts de ligne à
1520 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1521 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1527 s1 \noBreak s1 \noBreak
1528 s1 \noBreak s1 \break
1530 @{ @var{et ici la musique@dots{}} @}
1542 Manuel de notation :
1543 @ref{Variables de gestion des sauts de ligne}.
1545 Référence des propriétés internes :
1546 @rinternals{LineBreakEvent}.
1549 @rlsrnamed{Spacing,Espacements}.
1553 @subsection Sauts de page
1554 @translationof Page breaking
1556 La gestion automatique des sauts de page se contrôle à l'aide des
1557 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1558 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1559 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1560 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1561 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1564 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1565 trouver à des niveaux supérieurs, entre deux partitions ou
1566 @emph{markups} de premier rang.
1568 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1569 gérer la répartition horizontale, LilyPond dispose de commutateurs
1570 équivalents au niveau de la verticalité : @code{ragged-bottom} et
1571 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1572 affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
1573 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1574 à @ref{Variables d'espacement vertical fixe}.
1576 Les sauts de page sont générés par la fonction @code{page-breaking}.
1577 LilyPond dispose de trois différents algorithmes en la matière :
1578 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1579 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1580 activé par défaut, mais rien ne vous empêche d'en changer, par
1581 l'intermédiaire du bloc @code{\paper} :
1585 page-breaking = #ly:page-turn-breaking
1591 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1592 pages, la gestion des sauts de page finit par devenir très gourmande,
1593 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1594 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1595 sectionner l'ouvrage que vous traitez ; les sauts de page seront
1596 alors gérés individuellement au niveau de chacune des parties. Par
1597 ailleurs, cela vous autorisera une gestion différente selon les
1603 subtitle = "Préface"
1606 %% Pour une partie constituée principalement de texte
1607 %% ly:minimal-breaking est plus judicieux.
1608 page-breaking = #ly:minimal-breaking
1610 \markup @{ @dots{} @}
1614 %% Cette partie étant purement musicale,
1615 %% retour au style par défaut (optimal-breaking).
1617 subtitle = "Premier mouvement"
1619 \score @{ @dots{} @}
1625 @funindex \pageBreak
1627 @funindex \noPageBreak
1628 @code{\noPageBreak}.
1632 Manuel de notation :
1633 @ref{Variables de gestion des sauts de page}.
1636 @rlsrnamed{Spacing,Espacements}.
1639 @node Optimisation des sauts de page
1640 @subsection Optimisation des sauts de page
1641 @translationof Optimal page breaking
1643 @funindex ly:optimal-breaking
1645 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1646 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1647 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1648 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1649 n'a aucune notion de ce qu'est une @qq{tourne}.
1653 @rlsrnamed{Spacing,Espacements}.
1656 @node Optimisation des tournes
1657 @subsection Optimisation des tournes
1658 @translationof Optimal page turning
1660 @funindex ly:page-turn-breaking
1662 Aboutir à une configuration des sauts de page de telle sorte que les
1663 pages de droite se terminent toujours par un silence devient souvent une
1664 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1665 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1666 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1667 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1668 ne saurait intervenir qu'à certains endroits.
1670 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1671 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1672 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1673 informer la fonction des endroits où les sauts de page sont permis.
1675 Cette deuxième étape se réalise de deux manières différentes. Vous
1676 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1677 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1679 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1680 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1681 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1682 tournes recherchera dans le contexte en question les passages sans note.
1683 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1684 notes ; autrement dit, il ne restera pas inactif dans le cadre
1685 d'une portée polyphonique dont l'une des parties contiendrait des
1686 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1687 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1688 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1689 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1690 déposera le @code{\allowPageTurn}.
1692 @funindex minimumPageTurnLength
1694 Le @code{Page_turn_engraver} examine la propriété de contexte
1695 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1696 longueur d'un fragment sans note avant une tourne. La valeur par
1697 défaut de @code{minimumPageTurnLength} est
1698 @code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
1699 la manière suivante :
1702 \new Staff \with @{ \consists "Page_turn_engraver" @}
1705 R1 | % une tourne peut se placer ici
1707 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1708 R1 | % il ne peut pas y avoir de tourne ici
1710 R1*2 | % une tourne peut se placer ici
1715 @funindex minimumRepeatLengthForPageTurn
1717 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1718 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1719 temps au début et à la fin de la reprise pour que l'exécutant ait le
1720 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1721 même capable d'interdire un tourne dans le cas d'une reprise de courte
1722 durée, ajustable au travers de la propriété de contexte
1723 @code{minimumRepeatLengthForPageTurn}.
1725 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1726 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1727 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1732 @funindex \noPageTurn
1734 @funindex \allowPageTurn
1735 @code{\allowPageTurn}.
1740 @rlsrnamed{Spacing,Espacements}.
1743 Une partition ne devrait contenir qu'une seule instance du
1744 @code{Page_turn_engraver}, au risque de les voir se contredire.
1747 @node Minimisation des sauts de page
1748 @subsection Minimisation des sauts de page
1749 @translationof Minimal page breaking
1751 @funindex ly:minimal-breaking
1753 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1754 calculs pour positionner les sauts de page. Elle mettra le plus de
1755 systèmes possible sur une page avant de passer à la suivante. On peut
1756 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1757 lorsque les autres fonctions de gestion des sauts de page ralentissent
1758 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1759 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1764 page-breaking = #ly:minimal-breaking
1770 @rlsrnamed{Spacing,Espacements}.
1773 @node Présentation en rouleau
1774 @subsection Présentation en rouleau
1775 @translationof One-line page breaking
1777 @funindex ly:one-line-breaking
1779 La fonction @code{ly:one-line-breaking} constitue un algorithme de
1780 calcul des sauts de pages particulier en ceci que chaque partition fait
1781 l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
1782 s'affranchit de l'impression des titres et marges ; seule la partition
1785 La largeur de page est ajustée de telle sorte que la pièce la plus
1786 longue tienne sur une seule ligne. En particulier, les variables
1787 @code{paper-width}, @code{line-width} et @code{indent} du bloc
1788 @code{\paper} seront ignorées ; les @code{left-margin} et
1789 @code{right-margin} seront honorées. La hauteur de page ne sera pas
1793 @node Sauts explicites
1794 @subsection Sauts explicites
1795 @translationof Explicit breaks
1797 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1798 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1799 avec ces deux instructions dérogatoires :
1802 \override NonMusicalPaperColumn #'line-break-permission = ##f
1803 \override NonMusicalPaperColumn #'page-break-permission = ##f
1806 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1807 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1808 explicite, et nulle part ailleurs. De la même façon, la désactivation
1809 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1810 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1811 nulle part ailleurs.
1813 @lilypond[quote,verbatim]
1820 musique = \relative c'' { c8 c c c }
1824 \repeat unfold 2 { \musique } \break
1825 \repeat unfold 4 { \musique } \break
1826 \repeat unfold 6 { \musique } \break
1827 \repeat unfold 8 { \musique } \pageBreak
1828 \repeat unfold 8 { \musique } \break
1829 \repeat unfold 6 { \musique } \break
1830 \repeat unfold 4 { \musique } \break
1831 \repeat unfold 2 { \musique }
1836 \override NonMusicalPaperColumn #'line-break-permission = ##f
1837 \override NonMusicalPaperColumn #'page-break-permission = ##f
1845 @rlsrnamed{Spacing,Espacements}.
1848 @node Recours à une voix supplémentaire pour gérer les sauts
1849 @subsection Recours à une voix supplémentaire pour gérer les sauts
1850 @translationof Using an extra voice for breaks
1852 La plupart du temps, les informations concernant les sauts de ligne ou
1853 de page se retrouvent directement au milieu des notes.
1856 musique = \relative c'' @{ c4 c c c @}
1860 \repeat unfold 2 @{ \musique @} \break
1861 \repeat unfold 3 @{ \musique @}
1866 Bien que cela constitue un moyen aisé de saisir les commandes
1867 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1868 mélangées à des informations qui concernent plutôt l'agencement de la
1869 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1870 purement musical et les informations concernant les sauts de ligne ou de
1871 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1872 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1873 des @code{\break}, des @code{\pageBreak} et autres informations
1874 concernant les ruptures.
1876 @lilypond[quote,verbatim]
1877 music = \relative c'' { c4 c c c }
1888 \repeat unfold 2 { \music }
1889 \repeat unfold 3 { \music }
1890 \repeat unfold 6 { \music }
1891 \repeat unfold 5 { \music }
1897 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1898 les @code{line-break-system-details} et autres propriétés fort
1899 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1900 le voir au chapitre @ref{Espacement vertical}.
1902 @lilypond[quote,verbatim]
1903 music = \relative c'' { c4 c c c }
1908 \overrideProperty "Score.NonMusicalPaperColumn"
1909 #'line-break-system-details #'((Y-offset . 0))
1912 \overrideProperty "Score.NonMusicalPaperColumn"
1913 #'line-break-system-details #'((Y-offset . 35))
1916 \overrideProperty "Score.NonMusicalPaperColumn"
1917 #'line-break-system-details #'((Y-offset . 70))
1920 \overrideProperty "Score.NonMusicalPaperColumn"
1921 #'line-break-system-details #'((Y-offset . 105))
1925 \repeat unfold 2 { \music }
1926 \repeat unfold 3 { \music }
1927 \repeat unfold 6 { \music }
1928 \repeat unfold 5 { \music }
1935 Manuel de notation :
1936 @ref{Espacement vertical}.
1939 @rlsrnamed{Spacing,Espacements}.
1942 @node Espacement vertical
1943 @section Espacement vertical
1944 @translationof Vertical spacing
1946 @cindex vertical, espacement
1947 @cindex espacement vertical
1949 L'espacement vertical dépend de trois éléments : la surface
1950 disponible -- par exemple format de papier et marges --, l'espace qui
1951 doit séparer les systèmes, et l'espace qui sépare les portées d'un même
1955 * Espacement vertical au sein d'un système::
1956 * Positionnement explicite des portées et systèmes::
1957 * Résolution des collisions verticales::
1961 @node Espacement vertical au sein d'un système
1962 @subsection Espacement vertical au sein d'un système
1963 @translationof Flexible vertical spacing within systems
1965 @cindex distance entre les portées
1966 @cindex portées, espacement
1967 @cindex espacement entre les portées
1968 @cindex espacement au sein d'un système
1970 LilyPond dispose de trois différents mécanismes permettant de contrôler
1971 l'espacement au sein d'un système selon trois catégories :
1976 @emph{portées isolées},
1979 @emph{portées regroupées} (portées d'un même groupe, telles celles
1980 d'un @code{ChoirStaff}, etc.), et
1983 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
1987 @c TODO: Clarify this. This almost implies that non-staff lines
1988 @c have NO effect on the spacing between staves. -mp
1990 La hauteur de chaque système se détermine en deux phases. Les portées
1991 sont tout d'abord espacées selon la surface disponible. Puis les lignes
1992 autres que des portées, comme les paroles ou les accords, sont réparties
1995 Les paragraphes qui suivent traitent exclusivement de la manière de
1996 gérer l'espacement entre les lignes d'un système -- portée musicale ou
1997 non. Pour ce qui a trait aux espacements entre les systèmes,
1998 mouvements, annotations et marge, ils sont contrôlés par des variables
1999 attachées au bloc @code{\paper} et font l'objet du chapitre
2000 @ref{Variables d'espacement vertical fluctuant}.
2003 * Propriétés d'espacement au sein d'un système::
2004 * Espacement de portées isolées::
2005 * Espacement de portées regroupées::
2006 * Espacement des lignes rattachées à des portées::
2010 @node Propriétés d'espacement au sein d'un système
2011 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
2012 @translationof Within-system spacing properties
2014 L'espacement entre les portées est géré par deux jeux de propriétés
2015 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
2016 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
2017 ou de non-portée. Le second, associé à l'objet graphique
2018 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
2019 de portées particulier. Les propriétés qui leur sont attachées sont
2020 abordées en fin de section.
2022 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
2023 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
2024 @code{@var{item2}} étant les éléments à espacer. Notez bien que
2025 @code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
2026 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
2027 l'espacement d'une ligne de non-portée alors que sa
2028 @code{staff-affinity} a été déterminée à @code{UP}.
2030 Toutes ces distances sont mesurées entre les points de référence
2031 respectifs des éléments considérés.
2032 Le @i{point de référence} d'une portée est le centre vertical du
2033 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
2034 l'interligne médian si @code{line-count} est pair.
2035 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
2036 tableau suivant présente le @i{point de référence} pour chacune
2039 @multitable {Ligne de non-portée} {Point de référence}
2040 @headitem Ligne de non-portée @tab Point de référence
2041 @item @code{ChordNames} @tab ligne de base
2042 @item @code{NoteNames} @tab ligne de base
2043 @item @code{Lyrics} @tab ligne de base
2044 @item @code{Dynamics} @tab centre vertical
2045 @item @code{FiguredBass} @tab point le plus haut
2046 @item @code{FretBoards} @tab ligne supérieure
2049 En voici une représentation graphique :
2052 @lilypond[quote,noragged-right,line-width=110\mm]
2053 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
2055 alignToZero = \with {
2056 \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
2057 \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
2059 lowerCaseChords = \with {
2060 chordNameLowercaseMinor = ##t
2062 staffAffinityDown = \with {
2063 \override VerticalAxisGroup #'staff-affinity = #DOWN
2066 #(define-music-function
2067 (parser location context)
2069 #{ s1*0^\markup { \typewriter #context } #})
2072 \context { \Dynamics \alignToZero }
2073 \context { \FiguredBass \alignToZero }
2074 \context { \Lyrics \alignToZero }
2075 \context { \NoteNames \alignToZero \staffAffinityDown }
2076 \context { \ChordNames \alignToZero
2079 \context { \FretBoards \alignToZero \staffAffinityDown }
2081 \override BarLine #'stencil = ##f
2082 \override DynamicText #'self-alignment-X = #-1
2083 \override FretBoard #'X-offset = #1.75
2084 \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
2085 \override InstrumentName #'extra-offset = #'(0 . -0.5)
2086 \override TextScript #'minimum-Y-extent = #'(-2 . 3)
2087 \override TimeSignature #'stencil = ##f
2091 %% Contextes dont le point de référence est la ligne de base :
2092 %% ChordNames, NoteNames, et Lyrics
2094 \new ChordNames { \chords { g1:m } }
2095 \new NoteNames { s1 | g1 | }
2096 \new RhythmicStaff {
2097 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
2099 \labelContext "ChordNames" s1 |
2100 \labelContext "NoteNames" s1 |
2101 \labelContext "Lyrics" s1 |
2103 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
2106 %% Le point de référence de Dynamics est le milieu de la ligne
2108 \new RhythmicStaff {
2109 \set RhythmicStaff.instrumentName = #"centre vertical "
2110 \labelContext "Dynamics" s1*3
2112 \new Dynamics { s1\mp s\fp }
2115 %% Le point de référence de FiguredBass est son point le plus haut
2117 \new RhythmicStaff {
2118 \set RhythmicStaff.instrumentName = #"point le plus haut "
2119 \labelContext "FiguredBass" s1
2121 \new FiguredBass { \figuremode { <6 5>1 } }
2124 %% Le point de référence de FretBoards est la ligne du haut
2125 \include "predefined-guitar-fretboards.ly"
2127 \new FretBoards { \chordmode { e1 } }
2128 \new RhythmicStaff {
2129 \set RhythmicStaff.instrumentName = #"ligne du haut "
2130 \labelContext "FretBoards " s1
2135 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2136 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2137 sous la forme d'une liste associative dont la structure est
2138 identique à celle des variables du bloc @code{\paper} que nous avons
2139 examinées au chapitre
2140 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2141 matière de modification d'une liste associative font l'objet d'un
2142 @rusernamed{Modification de listes associatives,chapitre particulier}.
2143 Les propriétés des objets graphiques se règlent avec un @code{\override}
2144 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2147 L'exemple suivant illustre deux façons de modifier une liste
2148 associative. La première déclaration n'agit que sur une seule clé,
2149 alors que la seconde redéfinit la propriété dans son intégralité.
2153 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2157 \override VerticalAxisGroup #'staff-staff-spacing =
2158 #'(('basic-distance . 10)
2159 (minimum-distance . 9)
2161 (stretchability . 10))
2165 La modification d'un espacement au niveau global se mentionne au sein du
2166 bloc @code{\layout} :
2172 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2177 Les réglages concernant les propriétés d'espacement vertical des objets
2178 graphiques sont répertoriées aux chapitres
2179 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2180 Les propriétés relatives aux lignes de non-portée sont répertoriées
2181 selon la définition de leur contexte dans la
2182 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2185 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2186 @c VO Properties of the @code{VerticalAxisGroup} grob
2188 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2189 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2193 @item staff-staff-spacing
2194 Il s'agit de la distance entre la portée en cours et la portée qui suit
2195 au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
2196 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2197 pas à la dernière portée d'un système.
2199 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2200 d'un @code{VerticalAxisGroup} affectera les propriétés du
2201 @code{StaffGrouper} si la portée est incluse dans un regroupement ;
2202 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2203 regroupement. Les portées peuvent donc s'aligner différemment selon
2204 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2205 tenir compte des éventuels regroupements, cette fonction peut faire
2206 place à une complète redéfinition des espacements fluctuants à l'aide de
2207 règles dérogatoires comme vu précédemment.
2209 @item default-staff-staff-spacing
2210 Il s'agit de la distance qui s'appliquera par défaut aux portées
2211 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2212 explicitement par un @code{\override}.
2214 @item staff-affinity
2215 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2216 que prendra une ligne de non-portée pour aller s'accoler aux portées
2217 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2218 non-portée ira se placer à équidistance entre les portées qui
2219 l'encadrent, tout en tenant compte des éventuels risques de collision et
2220 des autres contraintes d'espacement. Des lignes de non-portée
2221 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2222 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2223 Une ligne de non-portée en dessous d'un système devrait avoir sa
2224 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2225 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2226 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2227 @code{staff-affinity} : si vous affectez la valeur @code{#f} à
2228 une ligne de non-portée, cette ligne sera considérée comme étant une
2229 portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
2230 pour une portée lui fera perdre cette qualité.
2232 @c TODO: verify last clause below ("even if other...")
2234 @item nonstaff-relatedstaff-spacing
2235 Il s'agit de la distance entre la ligne de non-portée en cours et la
2236 portée la plus proche selon la @code{staff-affinity}, à la double
2237 condition qu'il n'y ait pas déjà une autre ligne de non-portée et que la
2238 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2239 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2240 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2241 non-portée entre les deux portées adjacentes même si une autre
2242 non-portée est présente (quelque soit le côté).
2244 @item nonstaff-nonstaff-spacing
2245 Il s'agit de la distance entre deux lignes de non-portée selon
2246 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2247 la même orientation. Bien entendu, ceci ne peut concerner que les
2248 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2250 @item nonstaff-unrelatedstaff-spacing
2251 Il s'agit de la distance entre une ligne de non-portée et la portée à
2252 l'opposé de l'orientation adoptée, à la double condition qu'il n'y ait
2253 pas déjà une autre ligne de non-portée et que la valeur de
2254 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2255 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2256 portée à laquelle elle ne correspond pas.
2260 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2261 @c VO Properties of the @code{StaffGrouper} grob
2263 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2264 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2268 @item staff-staff-spacing
2269 Il s'agit de la distance entre deux portées consécutives d'un même
2270 système. La propriété @code{staff-staff-spacing} de l'objet
2271 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2272 l'aide de règles dérogatoires.
2274 @item staffgroup-staff-spacing
2275 Il s'agit de la distance entre la dernière portée d'un regroupement et
2276 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2277 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2278 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2279 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2280 regroupement a été ajustée au niveau de son propre
2281 @code{VerticalAxisGroup}, cette dernière aura préséance.
2285 Fichiers d'initialisation :
2286 @file{ly/engraver-init.ly},
2287 @file{scm/define-grobs.scm}.
2289 Référence des propriétés internes :
2290 @rinternals{Contexts},
2291 @rinternals{VerticalAxisGroup},
2292 @rinternals{StaffGrouper}.
2295 @node Espacement de portées isolées
2296 @unnumberedsubsubsec Espacement de portées isolées
2297 @translationof Spacing of ungrouped staves
2299 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2300 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2303 L'espacement de ces @i{portées isolées} est géré par les propriétés
2307 @item Propriétés du @code{VerticalAxisGroup} :
2309 @item @code{default-staff-staff-spacing}
2310 @item @code{staff-staff-spacing}
2314 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2315 @ref{Propriétés d'espacement au sein d'un système}.
2317 Certaines propriétés supplémentaires s'appliqueront dès lors que
2318 ces portées sont regroupées -- voir
2319 @ref{Espacement de portées regroupées}.
2321 L'exemple suivant illustre la manière de gérer l'espacement de portées
2322 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2323 Les mêmes règles appliquées de manière dérogatoire au
2324 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2325 sein de regroupements.
2327 @lilypond[verbatim,quote,staffsize=16]
2331 \override VerticalAxisGroup #'default-staff-staff-spacing =
2332 #'((basic-distance . 8)
2333 (minimum-distance . 7)
2339 % The very low note here needs more room than 'basic-distance
2340 % can provide, so the distance between this staff and the next
2341 % is determined by 'padding.
2342 \new Staff { b,2 r | }
2344 % Here, 'basic-distance provides enough room, and there is no
2345 % need to compress the space (towards 'minimum-distance) to make
2346 % room for anything else on the page, so the distance between
2347 % this staff and the next is determined by 'basic-distance.
2348 \new Staff { \clef bass g2 r | }
2350 % By setting 'padding to a negative value, staves can be made to
2351 % collide. The lowest acceptable value for 'basic-distance is 0.
2353 \override VerticalAxisGroup #'default-staff-staff-spacing =
2354 #'((basic-distance . 3.5)
2356 } { \clef bass g2 r | }
2357 \new Staff { \clef bass g2 r | }
2362 Fichiers d'initialisation :
2363 @file{scm/define-grobs.scm}.
2366 @rlsrnamed{Spacing,Espacements}.
2368 Référence des propriétés internes :
2369 @rinternals{VerticalAxisGroup}.
2372 @node Espacement de portées regroupées
2373 @unnumberedsubsubsec Espacement de portées regroupées
2374 @translationof Spacing of grouped staves
2376 Dans les partitions orchestrales ou de grande ampleur, il arrive
2377 souvent que des portées soient regroupées. L'espacement est alors plus
2378 important entre deux regroupements qu'entre les portées d'un même
2381 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2382 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2383 une ou plusieurs portées.
2385 L'espacement entre les portées d'un même regroupement est géré par les
2386 propriétés suivantes :
2389 @item Propriétés du @code{VerticalAxisGroup} :
2391 @item @code{staff-staff-spacing}
2393 @item Propriétés du @code{StaffGrouper} :
2395 @item @code{staff-staff-spacing}
2396 @item @code{staffgroup-staff-spacing}
2400 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2401 @ref{Propriétés d'espacement au sein d'un système}.
2403 L'exemple suivant illustre la manière de gérer l'espacement de portées
2404 regroupées, à l'aide des propriétés de l'objet graphique
2405 @code{StaffGrouper} :
2407 @lilypond[verbatim,quote,staffsize=16]
2411 \override StaffGrouper #'staff-staff-spacing #'padding = #0
2412 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
2417 \new PianoStaff \with {
2418 \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
2433 Fichiers d'initialisation :
2434 @file{scm/define-grobs.scm}.
2437 @rlsrnamed{Spacing,Espacements}.
2439 Référence des propriétés internes:
2440 @rinternals{VerticalAxisGroup},
2441 @rinternals{StaffGrouper}.
2444 @node Espacement des lignes rattachées à des portées
2445 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2446 @translationof Spacing of non-staff lines
2448 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2449 @code{ChordNames} sont des contextes dont les objets de rendu sont
2450 gravés à l'instar des portées -- une ligne horizontale dans un système.
2451 En fait, les lignes de non-portée sont des contextes qui vont créer un
2452 objet de rendu @code{VerticalAxisGroup}.
2454 L'espacement des lignes de non-portée est géré par les propriétés
2458 @item Propriétés du @code{VerticalAxisGroup} :
2460 @item @code{staff-affinity}
2461 @item @code{nonstaff-relatedstaff-spacing}
2462 @item @code{nonstaff-nonstaff-spacing}
2463 @item @code{nonstaff-unrelatedstaff-spacing}
2467 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2468 @ref{Propriétés d'espacement au sein d'un système}.
2470 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2471 pour gérer l'espacement entre des lignes consécutives de non-portée.
2472 Vous noterez que la valeur élevée attribuée à la clé
2473 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2475 @lilypond[verbatim,quote,staffsize=16]
2479 \override VerticalAxisGroup
2480 #'nonstaff-nonstaff-spacing #'stretchability = #1000
2487 \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
2490 \override VerticalAxisGroup #'staff-affinity = #UP
2493 \override VerticalAxisGroup #'staff-affinity = #CENTER
2494 } \lyricmode { center }
2496 \override VerticalAxisGroup #'staff-affinity = #DOWN
2497 } \lyricmode { down }
2503 Fichiers d'initialisation :
2504 @file{ly/engraver-init.ly},
2505 @file{scm/define-grobs.scm}.
2508 @rlsrnamed{Spacing,Espacements}.
2510 @c @lsr{spacing,page-spacing.ly},
2511 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2513 Référence des propriétés internes :
2514 @rinternals{Contexts},
2515 @rinternals{VerticalAxisGroup}.
2518 @node Positionnement explicite des portées et systèmes
2519 @subsection Positionnement explicite des portées et systèmes
2520 @translationof Explicit staff and system positioning
2522 Pour bien comprendre comment fonctionnent les réglages de
2523 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2524 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2525 les différentes mises au point du décalage vertical appliqué aux portées
2526 et systèmes distribués sur une page.
2528 Une autre approche de l'espacement vertical est le recours à
2529 @code{NonMusicalPaperColumn #'line-break-system-details}. Alors que
2530 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2531 @code{NonMusicalPaperColumn #'line-break-system-details} spécifiera le
2532 positionnement vertical absolu sur la page.
2534 @code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
2535 une liste associative de trois mises au point :
2538 @item @code{X-offset}
2539 @item @code{Y-offset}
2540 @item @code{alignment-distances}
2543 Les dérogations en matière d'objet graphique, y compris celles
2544 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2545 à trois différents endroits de votre fichier source :
2548 @item directement au beau milieu des notes
2549 @item au sein d'un bloc @code{\context}
2550 @item dans un bloc @code{\with}
2553 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2554 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2555 @code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
2556 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2557 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2558 de la commande @code{\overrideProperty} :
2561 \overrideProperty NonMusicalPaperColumn
2562 #'line-break-system-details #'((X-offset . 20))
2564 \overrideProperty NonMusicalPaperColumn
2565 #'line-break-system-details #'((Y-offset . 40))
2567 \overrideProperty NonMusicalPaperColumn
2568 #'line-break-system-details #'((X-offset . 20)
2571 \overrideProperty NonMusicalPaperColumn
2572 #'line-break-system-details #'((alignment-distances . (15)))
2574 \overrideProperty NonMusicalPaperColumn
2575 #'line-break-system-details #'((X-offset . 20)
2577 (alignment-distances . (15)))
2580 Nous allons maintenant voir ces différents réglages en action.
2581 Commençons par examiner un exemple dépourvu de toute mise au point.
2583 @c \book { } is required in these examples to ensure the spacing
2584 @c overrides can be seen between systems. -np
2586 @lilypond[verbatim,quote,staffsize=16]
2587 \header { tagline = ##f }
2588 \paper { left-margin = 0\mm }
2598 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2601 \repeat unfold 15 { d'4 d' d' d' }
2608 Cette partition isole les informations de saut de ligne ou de page dans
2609 une voix spécifique. La mise en forme est ainsi séparée des événements
2610 musicaux ; ceci nous permettra d'y voir plus clair au fur et à
2611 mesure que nous avancerons. Pour plus de précisions, relisez
2612 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2614 Les @code{\break} explicites répartissent la musique en lignes de cinq
2615 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2616 par défaut. Nous pouvons, afin de fixer explicitement le point
2617 d'attache vertical de chacun des systèmes, définir un doublet
2618 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2619 de l'objet @code{NonMusicalPaperColumn} :
2621 @lilypond[verbatim,quote,staffsize=16]
2622 \header { tagline = ##f }
2623 \paper { left-margin = 0\mm }
2629 \overrideProperty #"Score.NonMusicalPaperColumn"
2630 #'line-break-system-details #'((Y-offset . 0))
2632 \overrideProperty #"Score.NonMusicalPaperColumn"
2633 #'line-break-system-details #'((Y-offset . 40))
2635 \overrideProperty #"Score.NonMusicalPaperColumn"
2636 #'line-break-system-details #'((Y-offset . 80))
2639 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2642 \repeat unfold 15 { d'4 d' d' d' }
2649 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2650 si la liste associative de @code{line-break-system-details} peut en
2651 comporter un certain nombre. Vous aurez aussi noté que la propriété
2652 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2655 Maintenant que chaque système est explicitement positionné, nous pouvons
2656 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2657 à la sous-propriété @code{alignment-distances} de
2658 @code{line-break-system-details}.
2660 @lilypond[verbatim,quote,staffsize=16]
2661 \header { tagline = ##f }
2662 \paper { left-margin = 0\mm }
2668 \overrideProperty #"Score.NonMusicalPaperColumn"
2669 #'line-break-system-details #'((Y-offset . 20)
2670 (alignment-distances . (15)))
2672 \overrideProperty #"Score.NonMusicalPaperColumn"
2673 #'line-break-system-details #'((Y-offset . 60)
2674 (alignment-distances . (15)))
2676 \overrideProperty #"Score.NonMusicalPaperColumn"
2677 #'line-break-system-details #'((Y-offset . 100)
2678 (alignment-distances . (15)))
2681 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2684 \repeat unfold 15 { d'4 d' d' d' }
2691 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2692 @code{line-break-system-details} de l'objet
2693 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2694 prendre bien d'autres paramètres d'espacement, y compris un doublet
2695 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2696 @code{alignment-distances} pour contrôler le positionnement de chaque
2697 système et de chaque portée. Vous noterez enfin que
2698 @code{alignment-distances} traite le positionnement des portées, non
2699 d'un regroupement de portées.
2701 @lilypond[verbatim,quote,staffsize=16]
2702 \header { tagline = ##f }
2703 \paper { left-margin = 0\mm }
2709 \overrideProperty #"Score.NonMusicalPaperColumn"
2710 #'line-break-system-details #'((Y-offset . 0)
2711 (alignment-distances . (30 10)))
2713 \overrideProperty #"Score.NonMusicalPaperColumn"
2714 #'line-break-system-details #'((Y-offset . 60)
2715 (alignment-distances . (10 10)))
2717 \overrideProperty #"Score.NonMusicalPaperColumn"
2718 #'line-break-system-details #'((Y-offset . 100)
2719 (alignment-distances . (10 30)))
2722 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2725 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2726 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2733 Quelques points à prendre en considération :
2737 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2738 autres lignes de non-portée ne comptent pas pour une portée.
2741 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2742 @code{alignment-distances} sont considérés comme des multiples de la
2743 distance entre des portées adjacentes. Des valeurs positives remontent
2744 les portées et paroles, des valeurs négatives les descendent.
2747 Dans la mesure où @code{NonMusicalPaperColumn #'line-break-system-details}
2748 permet de positionner systèmes et portées n'importe où sur une page,
2749 vous pourriez être en contradiction avec les dimensionnements de la
2750 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2751 quant aux différentes valeurs que vous affectez à ces réglages.
2757 @rlsrnamed{Spacing,Espacements}.
2760 @node Résolution des collisions verticales
2761 @subsection Résolution des collisions verticales
2762 @translationof Vertical collision avoidance
2764 @funindex outside-staff-priority
2765 @funindex outside-staff-padding
2766 @funindex outside-staff-horizontal-padding
2768 Vous savez de manière intuitive qu'un certain nombre d'objets en
2769 matière de notation musicale appartiennent à la portée, et que
2770 d'autres se placent en dehors de la portée. Entre autres objets
2771 externes, nous avons les marques repères, les textes et les
2772 nuances ; nous les appellerons @qq{objets extérieurs à la portée}.
2773 La règle adoptée par LilyPond pour positionner verticalement ces
2774 objets extérieurs consiste à les placer au plus près de la portée
2775 tout en prenant garde d'éviter qu'il y ait chevauchement.
2777 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2778 déterminer si un objet est ou non un objet extérieur à la portée :
2779 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2780 s'agit d'un objet extérieur à la portée. De plus, la propriété
2781 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2782 objets doivent être disposés.
2784 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2785 Les objets extérieurs à la portée sont alors triés selon l'ordre
2786 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2787 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2788 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2789 lorsque deux objets devraient se placer au même endroit, celui dont la
2790 @code{outside-staff-priority} est la plus faible sera disposé au plus
2793 @lilypond[quote,ragged-right,relative=2,verbatim]
2796 \once \override TextScript #'outside-staff-priority = #1
2797 c4_"Text"\pp % this time the text will be closer to the staff
2799 % by setting outside-staff-priority to a non-number,
2800 % we disable the automatic collision avoidance
2801 \once \override TextScript #'outside-staff-priority = ##f
2802 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2803 c4_"Text"\pp % now they will collide
2806 Le décalage vertical entre un objet extérieur à la portée et celui qui
2807 le précède se contrôle par la propriété @code{outside-staff-padding}.
2810 @lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
2811 \once \override TextScript #'outside-staff-padding = #0
2812 a'^"Ce texte est placé au plus près de la note"
2813 \once \override TextScript #'outside-staff-padding = #3
2814 c^"Ce texte est décalé par rapport au texte précédent"
2815 c^"Ce texte est accolé au texte précédent"
2818 Par défaut, les objets extérieurs à la portée sont positionnés en
2819 évitant les collisions horizontales avec des objets précédemment
2820 positionnés. Ceci peut cependant générer des situations où des objets
2821 se trouvent horizontalement trop proches. L'espacement vertical entre
2822 les portées peut dans une certaine mesure permettre de mieux intercaler
2823 les objets extérieurs à la portée. La propriété
2824 @code{outside-staff-horizontal-padding} repoussera verticalement un
2825 objet pour éviter ce genre de situation.
2827 @lilypond[quote,ragged-right,relative=2,verbatim]
2828 % the markup is too close to the following note
2832 % setting outside-staff-horizontal-padding fixes this
2834 \once \override TextScript #'outside-staff-horizontal-padding = #1
2842 @rlsrnamed{Spacing,Espacements}.
2845 @node Espacement horizontal
2846 @section Espacement horizontal
2847 @translationof Horizontal spacing
2849 @cindex horizontal, espacement
2850 @cindex espacement horizontal
2853 * Généralités sur l'espacement horizontal::
2854 * Changement d'espacement en cours de partition::
2855 * Modification de l'espacement horizontal::
2856 * Longueur de ligne::
2857 * Notation proportionnelle::
2861 @node Généralités sur l'espacement horizontal
2862 @subsection Généralités sur l'espacement horizontal
2863 @translationof Horizontal spacing overview
2865 Le moteur d'espacement traduit les différences de durée en distances
2866 étirables (@emph{springs} pour ressorts) de différentes longueurs. Des
2867 durées importantes prennent ainsi plus de place que des durées moins
2868 longues. Les durées les plus courtes se verront attribuer un espace
2869 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2870 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2871 plus elle prendra d'espace : le doublement d'une durée attribuera à
2872 la note un espace fixé d'après la propriété @code{spacing-increment}.
2874 L'exemple suivant comporte des blanches, des noires et un certain nombre
2875 de croches. La croche est suivie d'un espace de la largeur d'une tête
2876 de note ; pour la noire , cet espace est de deux têtes ; il
2877 est de trois pour la blanche.
2879 @lilypond[quote,verbatim,relative=1]
2880 c2 c4. c8 c4. c8 c4. c8 c8
2884 @code{spacing-increment} est normalement défini à 1,2 espace de
2885 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2886 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2887 s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
2888 @code{spacing-increment}). Le point de départ de cet espace se situe à
2889 l'extrémité gauche du symbole ; la note la plus courte est donc
2890 suivie en général d'un espace égal à la largeur d'une tête de note.
2892 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2893 croche à une partition qui comporte déjà des croches et des doubles
2894 augmentera considérablement son volume : la durée la plus
2895 courte n'est plus la double mais la triple croche, ce qui aura
2896 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2897 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2898 courte prise en considération au niveau de l'espacement n'est pas la
2899 note la plus brève de la partition, mais celle qui apparaît le plus
2902 La courte durée la plus fréquente est déterminée à partir de la note la
2903 plus courte de chaque mesure. C'est elle qui servira de base pour
2904 l'espacement, à cette nuance près que la plus courte durée ne saurait
2905 être strictement supérieure à la croche. Cette @qq{durée de référence}
2906 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2909 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2910 pour les espacements grâce à la propriété
2911 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2912 La durée maximale de cet étalon, normalement la croche, est gérée par la
2913 propriété @code{base-shortest-duration}.
2915 @funindex common-shortest-duration
2916 @funindex base-shortest-duration
2917 @funindex stem-spacing-correction
2920 Les notes plus courtes que la note témoin sont suivies d'un espace
2921 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2922 doubles croches à l'exemple précédent, elles seraient suivies d'une
2923 demie largeur de tête :
2925 @lilypond[quote,verbatim,relative=2]
2926 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2929 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2930 vu comment la direction des hampes peut influencer l'espacement -- voir
2931 @ressay{Espacement}. Ceci est contrôlé par la propriété
2932 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2933 pour chaque contexte @rinternals{Voice}. L'objet
2934 @rinternals{StaffSpacing}, généré au niveau d'un contexte @code{Staff},
2935 possède une même propriété qui contrôlera l'espacement hampe-barre de
2936 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2937 les réglages par défaut, puis avec des corrections forcées.
2939 @lilypond[quote,ragged-right]
2943 \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2944 \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2950 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
2951 @rusernamed{Notation proportionnelle,rubrique dédiée}.
2955 @rlsrnamed{Spacing,Espacements}.
2957 Essai sur la gravure musicale automatisée :
2958 @ressay{Espacement}.
2960 Référence des propriétés internes :
2961 @rinternals{SpacingSpanner},
2962 @rinternals{NoteSpacing},
2963 @rinternals{StaffSpacing},
2964 @rinternals{NonMusicalPaperColumn}.
2967 Il n'existe pas de mécanisme simple et efficace qui permette de
2968 forcer manuellement l'espacement. La solution ci-dessous permet
2969 cependant @qq{d'aérer} artificiellement une partition ; il vous
2970 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
2973 \override Score.NonMusicalPaperColumn #'padding = #10
2976 Il n'y a aucun moyen de diminuer l'espacement.
2979 @node Changement d'espacement en cours de partition
2980 @subsection Changement d'espacement en cours de partition
2981 @translationof New spacing area
2983 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
2984 substantiellement la notion de valeur brève et valeur longue. La
2985 commande @code{newSpacingSection} permet alors de réinitialiser les
2986 paramètres d'espacement.
2988 Dans l'exemple qui suit, le changement de métrique marque le début
2989 d'une nouvelle partie ; remarquez comme les doubles-croches sont
2990 alors plus espacées :
2992 @lilypond[relative,verbatim,quote]
2995 c8 c c4 c16[ c c8] c4
3001 La commande @code{\newSpacingSection} crée un nouvel objet
3002 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
3003 @code{\override}s à partir de ce point.
3007 @rlsrnamed{Spacing,Espacements}.
3009 Référence des propriétés internes :
3010 @rinternals{SpacingSpanner}.
3013 @node Modification de l'espacement horizontal
3014 @subsection Modification de l'espacement horizontal
3015 @translationof Changing horizontal spacing
3017 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
3018 @code{base-shortest-duration}. Comparons les deux partitions qui
3019 suivent, toutes deux montrant la même musique. La première partition
3020 applique les réglages par défaut, alors que la seconde bénéficie d'un
3021 ajustement de la propriété @code{base-shortest-duration}. Au plus la
3022 valeur de @code{ly:make-moment} est grande, au plus la musique sera
3023 resserrée. En effet, @code{ly:make-moment} construit une durée :
3024 @code{1 4} est plus long que @code{1 16}.
3026 @lilypond[verbatim,line-width=12\cm]
3029 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3030 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3031 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3032 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3037 @lilypond[verbatim,line-width=12\cm]
3040 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3041 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3042 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3043 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3048 \override SpacingSpanner
3049 #'base-shortest-duration = #(ly:make-moment 1 16)
3056 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
3057 facteurs qui ne sont pas liés à la durée (altération, changement de
3058 clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
3059 permet d'ignorer ces symboles et, par voie de conséquence, forcer
3060 l'espacement sur la simple durée. Notez bien que cette propriété
3061 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
3064 @lilypond[quote,ragged-right,verbatim]
3083 \override SpacingSpanner #'uniform-stretching = ##t
3089 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
3090 les notes sans tenir compte des clefs, barres de mesure ou notes
3091 d'ornement qui pourraient apparaître :
3093 @lilypond[quote,ragged-right,relative=2,verbatim]
3094 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3095 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
3100 @rlsrnamed{Spacing,Espacements}.
3103 @node Longueur de ligne
3104 @subsection Longueur de ligne
3105 @translationof Line length
3107 @cindex saut de page
3109 @cindex ligne, longueur
3112 @funindex line-width
3113 @funindex ragged-right
3114 @funindex ragged-last
3116 @c Although line-width can be set in \layout, it should be set in paper
3117 @c block, to get page layout right.
3118 @c Setting indent in \paper block makes not much sense, but it works.
3120 @c Bit verbose and vague, use examples?
3121 Deux réglages de bases ont une influence considérable sur
3122 l'espacement : @code{line-width} et @code{indent}. Tous deux se
3123 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3124 lignes et l'indentation de la première.
3126 L'activation du commutateur @code{ragged-right} au sein du bloc
3127 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3128 de les voir s'étirer sur toute la largeur de la page. Cette option est
3129 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3130 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3131 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3134 @cindex page, mise en forme
3135 @cindex vertical, espacement
3137 Le fonctionnement de l'option @code{ragged-last} est en tout point
3138 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3139 que la dernière ligne de la partition. Il n'y a pas de restriction
3140 quant à cette ligne. Il en va de même que pour le formatage d'un
3141 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3143 @c Note that for text there are several options for the last line.
3144 @c While Knuth TeX uses natural length, lead typesetters use the same
3145 @c stretch as the previous line. eTeX uses \lastlinefit to
3146 @c interpolate between both these solutions.
3158 @rlsrnamed{Spacing,Espacements}.
3161 @node Notation proportionnelle
3162 @subsection Notation proportionnelle
3163 @translationof Proportional notation
3165 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3166 ce cas de représenter la notation selon un espacement strictement
3167 relatif aux durées. Ce type d'espacement pourrait se comparer à
3168 l'utilisation de papier millimétré pour positionner les notes au fil de
3169 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3170 utilisent cette proportionnalité dans le but de clarifier des structures
3171 rythmiques complexes, d'aider au positionnement d'indications
3172 temporelles ou autres éléments graphiques directement dans la partition.
3174 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3175 s'utiliser conjointement ou individuellement, aux fins de mettre au
3176 point cette notation proportionnelle.
3179 @item @code{proportionalNotationDuration}
3181 @item @code{uniform-stretching}
3183 @item @code{strict-note-spacing}
3185 @item @code{\remove "Separating_line_group_engraver"}
3187 @item @code{\override PaperColumn #'used = ##t}
3191 Nous allons examiner, dans les différents exemples qui suivent, les
3192 effets de ces réglages et comment ils interagissent.
3194 Commençons par cette mesure toute simple qui utilise l'espacement
3195 classique et justifiée à gauche.
3197 @lilypond[quote,verbatim,ragged-right]
3200 \new RhythmicStaff {
3204 c'16 c'16 c'16 c'16 c'16
3211 Vous constatez que la blanche qui entame la mesure prend moins de la
3212 moitié de l'espace. De même, les doubles croches et le quintolet de
3213 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3214 n'en occupent pas la moitié de l'espace horizontal.
3216 En matière de gravure traditionnelle, cet espacement correspond tout à
3217 fait à nos attentes, puisque nous pouvons rogner l'espace sur la
3218 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3221 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3222 un autre graphisme en surplomb ou en dessous de notre partition, nous
3223 aurons besoin de la notation proportionnelle. Celle-ci s'active en
3224 définissant la propriété @code{proportionalNotationDuration}.
3226 @lilypond[quote,verbatim,ragged-right]
3229 \new RhythmicStaff {
3233 c'16 c'16 c'16 c'16 c'16
3240 proportionalNotationDuration = #(ly:make-moment 1 20)
3246 La blanche du début et les notes plus rapides de la deuxième moitié de
3247 la mesure occupent maintenant exactement le même espace horizontal.
3248 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3249 temporelle ou autre graphisme.
3251 @code{proportionalNotationDuration} est une propriété attachée au
3252 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3253 propriétés d'un contexte à trois différents endroits de votre
3254 fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
3255 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3256 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3257 de ces trois façons, à l'instar de n'importe quelle définition de
3260 La propriété @code{proportionalNotationDuration} prend en unique
3261 argument la durée de référence qui servira de base pour espacer toute la
3262 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3263 prend deux arguments : un numérateur et un dénominateur qui
3264 représentent une fraction de ronde. L'appel de
3265 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3266 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3267 @code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} ou
3268 @code{(ly:make-moment 3 97)}.
3270 Se pose alors le problème de fournir la juste durée de référence à
3271 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3272 tâtonnement, en commençant par une valeur proche de la note la plus
3273 rapide (la durée la plus courte) du morceau. Au plus la durée de
3274 référence est petite, au plus la musique sera étalée ; à l'inverse,
3275 une durée de référence élevée produira une musique resserrée.
3277 @lilypond[quote,verbatim,ragged-right]
3280 \new RhythmicStaff {
3284 c'16 c'16 c'16 c'16 c'16
3291 proportionalNotationDuration = #(ly:make-moment 1 8)
3298 \new RhythmicStaff {
3302 c'16 c'16 c'16 c'16 c'16
3309 proportionalNotationDuration = #(ly:make-moment 1 16)
3316 \new RhythmicStaff {
3320 c'16 c'16 c'16 c'16 c'16
3327 proportionalNotationDuration = #(ly:make-moment 1 32)
3333 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3334 comme la croche pour la première ligne, a pour conséquence de resserrer
3335 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3336 remarquez aussi que, par principe, la notation proportionnelle occupe
3337 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3338 notation proportionnelle met en évidence le rythme au détriment de
3339 l'espacement horizontal.
3341 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3344 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3345 ajoutons lui une portée incluant un autre type de nolet.
3347 @lilypond[quote,verbatim,ragged-right]
3350 \new RhythmicStaff {
3354 c'16 c'16 c'16 c'16 c'16
3357 \new RhythmicStaff {
3359 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3366 L'espacement est loin d'être idéal, pour la simple raison que
3367 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3368 uniformément. Il est vrai que de telles constructions complexes en
3369 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3370 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3371 @code{proportionalNotationDuration} permet d'arranger les choses.
3373 @lilypond[quote,verbatim,ragged-right]
3376 \new RhythmicStaff {
3380 c'16 c'16 c'16 c'16 c'16
3383 \new RhythmicStaff {
3385 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3392 proportionalNotationDuration = #(ly:make-moment 1 20)
3398 Cependant, si l'on observe de près, il est évident que les notes de la
3399 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3400 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3401 allons activer le @code{uniform-stretching}, propriété attachée au
3402 @code{SpacingSpanner}.
3404 @lilypond[quote,verbatim,ragged-right]
3407 \new RhythmicStaff {
3411 c'16 c'16 c'16 c'16 c'16
3414 \new RhythmicStaff {
3416 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3423 proportionalNotationDuration = #(ly:make-moment 1 20)
3424 \override SpacingSpanner #'uniform-stretching = ##t
3430 L'espacement sur les deux portées est maintenant correct, les relations
3431 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3432 une indication temporelle ou autre graphisme selon notre envie.
3434 Notez bien que la prise en charge de la notation proportionnelle par
3435 LilyPond demande que, dans chaque partition, soit activée la propriété
3436 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3437 contraire, utiliser @code{proportionalNotationDuration} aura pour
3438 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3439 inséré des silences invisibles @emph{skip}.
3441 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3442 au contexte @code{Score}. Tout comme pour la propriété
3443 @code{proportionalNotationDuration}, les réglages du
3444 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3445 votre fichier : dans un bloc @code{\with}, dans un bloc
3446 @code{\context} ou au beau milieu de la musique à l'aide de la
3447 commande @code{\set}.
3449 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3450 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3451 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3452 partition. Vous pourriez toutefois avoir besoin de modifier ce
3453 comportement en cours de partition, et recourir alors à l'instruction
3454 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3455 rubrique @ref{Changement d'espacement en cours de partition}.
3457 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3458 qui est désactivé pour la plupart des partitions en notation
3459 proportionnelle. Voici ce qui apparaît dans une partition
3460 traditionnelle : il y a toujours un @qq{espace préservé} juste
3461 avant la première note de chaque portée.
3463 @lilypond[quote,verbatim,ragged-right]
3475 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3476 présent lorsqu'intervient un changement de métrique, d'armure ou de
3477 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3478 réduire cet espace à zéro.
3480 @lilypond[quote,verbatim,ragged-right]
3486 \remove "Separating_line_group_engraver"
3494 Les éléments non musicaux tels que métrique, armure et clef, posent
3495 problème lorsqu'on travaille en notation proportionnelle. Bien
3496 qu'aucune notion de durée ne leur soit attachée, ces éléments
3497 @qq{consomment} de l'espace. Différentes approches permettent
3498 cependant de gérer ce problème.
3500 Éviter les problèmes d'espacement avec l'armure est chose aisée :
3501 il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
3502 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3503 proportionnelle. Il en va de même pour la métrique, et tout
3504 particulièrement lorsque la partition comporte un quadrillage temporel
3505 ou autres graphismes. L'absence de métrique reste cependant
3506 exceptionnelle et la plupart des partitions en notation proportionnelle
3507 laissent apparaître quelques métriques. Il est par contre pratiquement
3508 impossible de se passer de clef et d'altération.
3510 L'une des options permettant de s'affranchir de l'espacement dû aux
3511 éléments non musicaux consiste en l'activation de la propriété
3512 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3513 les deux portées suivantes :
3515 @lilypond[quote,verbatim,ragged-right]
3517 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3527 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3528 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3538 Toutes deux affichent un espacement proportionnel. Cependant, la
3539 première ligne laisse apparaître un espacement plus lâche en raison de
3540 la présence d'un changement de clef. En ce qui concerne la deuxième
3541 ligne, l'espacement est strictement observé dès lors que la propriété
3542 @code{strict-note-spacing} a préalablement été activée. Comme vous
3543 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3544 conséquence que l'algorithme d'espacement ignore tout bonnement la
3545 largeur des métriques, armures, clefs et altérations.
3547 En plus de ceux que nous venons de voir, vous trouverez d'autres
3548 réglages en usage dans la notation proportionnelle comme, entre autres,
3551 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3552 @item @code{tupletFullLength = ##t}
3553 @item @code{\override Beam #'breakable = ##t}
3554 @item @code{\override Glissando #'breakable = ##t}
3555 @item @code{\override TextSpanner #'breakable = ##t}
3556 @item @code{\remove "Forbid_line_break_engraver" dans le contexte de voix}
3559 Ces différents réglages permettent un espacement strict des notes
3560 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3561 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3562 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3563 différentes rubriques associées du manuel pour chacun de ces réglages.
3566 Manuel de notation :
3567 @ref{Changement d'espacement en cours de partition}.
3570 @rlsrnamed{Spacing,Espacements}.
3573 @node Réduction du nombre de pages de la partition
3574 @section Réduction du nombre de pages de la partition
3575 @translationof Fitting music onto fewer pages
3577 Vous pourriez un jour être confronté au problème suivant : l'une
3578 des pages de votre partition ne comporte que deux portées alors que --
3579 ce qui est d'autant plus frustrant -- l'espace libre sur les autres
3580 pages aurait permis une distribution différente.
3582 L'instruction @code{annotate-spacing} se révèle être un outil
3583 indispensable pour l'analyse des problèmes de mise en forme. Cette
3584 commande met en surimpression la valeur des différentes variables
3585 d'espacement et de mise en forme, comme nous allons le voir dans la
3586 rubrique @ref{Mise en évidence de l'espacement}.
3589 * Mise en évidence de l'espacement::
3590 * Modification de l'espacement::
3594 @node Mise en évidence de l'espacement
3595 @subsection Mise en évidence de l'espacement
3596 @translationof Displaying spacing
3598 @funindex annotate-spacing
3599 @cindex espacement, affichage des valeurs
3601 Le meilleur moyen d'appréhender les différentes variables de
3602 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3603 la mise en page consiste à activer, au sein du bloc @code{\paper}, la
3604 fonction @code{annotate-spacing} :
3606 @c need to have \book{} otherwise we get the separate systems. -hwn
3607 @lilypond[verbatim,quote]
3608 #(set-default-paper-size "a6" 'landscape)
3611 \paper { annotate-spacing = ##t }
3616 Toutes les dimensions sont exprimées en espace de portée
3617 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3618 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3619 feuille (@code{paper-height}) est de 59,75 espaces de portée
3620 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3621 20 points -- sa valeur par défaut. Notez que :
3623 @multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
3626 @tab = (25,4/72,27) mm
3629 @tab = (@code{staff-size})/4 pts
3631 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3636 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3637 1,757 millimètres. Les 59,75 @code{staff-spaces} de
3638 @code{paper-height} correspondent donc à 105 millimètres, soit la
3639 hauteur d'une feuille au format A6 à l'italienne. Les paires
3640 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3641 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3644 Manuel de notation :
3645 @ref{Définition de la taille de portée}.
3648 @rlsrnamed{Spacing,Espacements}.
3651 @node Modification de l'espacement
3652 @subsection Modification de l'espacement
3653 @translationof Changing spacing
3655 Les informations fournies par @code{annotate-spacing} en matière de
3656 dimensionnement vertical sont incomparables. Pour plus de détails sur
3657 les manières de modifier marges et autres variables connexes, consultez
3658 la rubrique @ref{Mise en forme de la page}.
3660 En dehors des marges, vous disposez de quelques moyens supplémentaires
3661 pour gagner de l'espace :
3665 Rapprocher les systèmes le plus possible les uns des autres, de telle
3666 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3667 suffisamment pour éviter le blanc en bas de page.
3671 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3672 ragged-last-bottom = ##f
3678 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3679 deux titres. D'une part, le fait de définir un nombre de systèmes --
3680 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3681 systèmes par page dans la mesure où l'une des étapes d'estimation des
3682 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3683 systèmes par page permet d'en disposer plus sur les suivantes. Par
3684 exemple, avec un nombre par défaut de 11 systèmes par pages,
3685 l'instruction suivante le force à 10.
3694 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3695 se répartir sur deux pages.
3704 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3705 Par exemple, un crochet de reprise ou d'alternative consomme de
3706 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3707 diminue d'autant l'espace disponible que si seul le premier ne
3708 comportait l'indication. Autre exemple, les indications de nuance qui
3709 se @qq{détachent} d'un système peuvent être rapprochés de la portée :
3711 @lilypond[verbatim,quote,relative=1]
3713 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3717 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3718 comme indiqué à la rubrique
3719 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3720 l'espacement par défaut :
3722 @lilypond[verbatim,quote]
3735 Par contre, le fait de modifier la valeur de la propriété
3736 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3737 -- bien que la noire soit la durée la plus courante, nous prenons une
3738 valeur plus longue -- donnera un effet @qq{resserré} à la musique :
3740 @lilypond[verbatim,quote]
3752 \override SpacingSpanner
3753 #'common-shortest-duration = #(ly:make-moment 1 2)
3760 La propriété @code{common-shortest-duration} ne peut être modifiée
3761 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3762 s'applique à l'intégralité de la partition.
3767 Manuel de notation :
3768 @ref{Mise en forme de la page},
3769 @ref{Modification de l'espacement horizontal}.
3772 @rlsrnamed{Spacing,Espacements}.