1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 7a7f2723f444e7c074a6c5f9a8ab62f512a4cc98
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
33 Could we add a sentence:
34 "Use instead the pair fontSize = #@var{N}
35 \override StaffSymbol #'staff-space = #(magstep
37 inside the Staff context to change the size of the font and the
39 staff lines accordingly."
41 Actually I found, that the @internalsref{StaffSymbol} at line 481
42 sends to an incomplete
43 documentation. The property staff-space is not explained here. I
44 thought Y-extent might be of
45 help, but it is in turn explained by x-space which again is
46 missing from the list. Who has the
47 knowledge to fix this?
51 http://code.google.com/p/lilypond/issues/detail?id=68
56 @node Gestion de l'espace
57 @chapter Gestion de l'espace
58 @translationof Spacing issues
60 L'agencement général d'une partition dépend de trois facteurs
61 interdépendants@tie{}: la mise en page, les sauts de ligne et
62 l'espacement. Les choix faits en matière d'espacement détermineront la
63 densité de chacun des systèmes, ce qui influera sur le positionnement
64 des sauts de lignes et, par voie de conséquence, sur le nombre de pages
67 En pratique, cette procédure comporte quatre étapes. Dans un premier
68 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
69 base des durées. Sont alors calculées différentes possibilités de saut
70 de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
71 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
72 la combinaison entre sauts de page et de ligne qui offre la meilleure
73 occupation de l'espace, tant horizontalement que verticalement.
75 Les réglages qui influencent la mise en forme se placent dans deux blocs
76 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
77 @ref{Mise en forme de la page} contient les réglages applicables à
78 l'intégralité du document -- à toutes les partitions d'un ouvrage --
79 tels que format du papier, impression ou non des numéros de page, etc.
80 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
81 rubrique @ref{Mise en forme de la partition}, il détermine la mise en
82 forme de la musique@tie{}: le nombre de systèmes utilisés, l'espacement
83 des regroupements de portées, etc.
86 * Mise en forme de la page::
87 * Mise en forme de la partition::
89 * Espacement vertical::
90 * Espacement horizontal::
91 * Réduction du nombre de pages de la partition::
94 @cindex ragged, aligné
95 @cindex aligné, ragged
97 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
98 dont la traduction vous semblera assurément erronée. Il n'en est
99 cependant rien@tie{}: certains termes techniques ont une histoire
100 particulière selon leur langue d'origine. Ainsi, le vocable anglais
101 @emph{Ragged} signifie en lambeau, en loques@tie{}; dans l'univers
102 typographique, un maître français voit un alignement à gauche -- il dira
103 @qq{au fer à gauche} -- alors que son homologue anglophone constate un
104 @emph{ragged-right} -- donc du vide à droite.}
107 @node Mise en forme de la page
108 @section Mise en forme de la page
109 @translationof Page layout
111 Nous allons examiner ici les options qui contrôlent la mise en forme des
112 pages attachées au bloc @code{\paper}.
116 * Format du papier et adaptation automatique::
117 * Variables d'espacement vertical fixe::
118 * Variables d'espacement vertical fluctuant::
119 * Variables d'espacement horizontal::
120 * Autres variables du bloc \paper::
125 @subsection Le bloc @code{\paper}
126 @translationof The @code{\paper} block
128 Un bloc @code{\paper} peut apparaître au sein d'un bloc
129 @code{\book}. Les réglages effectués à l'aide du bloc @code{\paper}
130 s'appliqueront à l'intégralité d'un ouvrage, qui peut comporter
131 plusieurs partitions (des blocs @emph{score})@tie{}; il ne doit donc en
132 aucun cas se trouver dans un bloc @code{\score}. Peuvent apparaître
133 dans un bloc @code{\paper}@tie{}:
138 la fonction scheme @code{set-paper-size},
141 des variables propres au bloc @code{\paper} qui viendront adapter la
145 la définition des différents @emph{markups} qui personnaliseront la mise
146 en forme des entêtes, pied de page et titrages.
150 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
151 -- @ref{Format du papier et adaptation automatique}. Les variables du
152 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
153 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
154 des entête, pied de page et titrages, elles sont étudiées à la rubrique
155 @ref{Titrages personnalisés}.
157 La plupart des variables gérant le papier ne sont fonctionnelles que
158 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
159 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
160 rubrique @ref{Le bloc \layout}.
162 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
163 correspondent à des dimensions sont exprimées en millimètre -- vous
164 pouvez bien entendu spécifier un autre système de mesure. Voici
165 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
174 Si vous préférez lui affecter une valeur de 0,5@tie{}pouce, vous devrez
175 mentionner le suffixe d'unité @code{\in}@tie{}:
183 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
184 @code{\in} et @code{\pt}. Ces unités sont des conversions de
185 millimètres, répertoriées dans le fichier
186 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
187 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
188 @code{\mm} à votre code lorsque vous travaillez en millimètres.
190 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
191 fonctions Scheme. Voici l'équivalent de l'exemple précédent@tie{}:
195 #(define top-margin (* 0.5 in))
201 @ref{Format du papier et adaptation automatique},
202 @ref{Titrages personnalisés}.
203 @ref{Le bloc \layout}.
205 Fichiers d'initialisation :
206 @file{ly/paper-defaults-init.ly}.
209 @node Format du papier et adaptation automatique
210 @subsection Format du papier et adaptation automatique
211 @translationof Paper size and automatic scaling
213 @cindex papier, taille
220 * Adaptation automatique au format::
224 @node Format du papier
225 @unnumberedsubsubsec Format du papier
226 @translationof Setting paper size
228 Le format du papier est déterminé par deux fonctions différentes@tie{}:
229 @code{set-default-paper-size} et @code{set-paper-size}.
230 @code{set-default-paper-size} se place en tête de fichier, alors que
231 @code{set-paper-size} se place à l'intérieur d'un bloc
235 #(set-default-paper-size "a4")
240 #(set-paper-size "a4")
245 La seule restriction à l'utilisation isolée de la fonction
246 @code{set-default-paper-size} est qu'elle doit intervenir avant le
247 premier bloc @code{\paper}. À l'intérieur d'un bloc @code{\paper}, il
248 vaut mieux utiliser la fonction @code{set-paper-size}, avant toute autre
249 variables. Les raisons à ceci sont abordées dans la rubrique
250 @ref{Adaptation automatique au format}.
252 @code{set-default-paper-size} fixe le format pour toutes les pages,
253 alors que @code{set-paper-size} détermine le format des feuilles
254 rattachées à un bloc @code{\paper} particulier. Ainsi, lorsque le bloc
255 @code{\paper} se trouve en tête de fichier, le format du papier
256 s'appliquera à toutes les pages@tie{}; si @code{\paper} apparaît dans un
257 bloc @code{\book}, la taille ne s'appliquera qu'au @emph{book} en
260 Les formats @code{a4}, @code{letter}, @code{legal} et @code{11x17} (ou
261 tabloïd) sont couramment utilisés pour les éditions musicales. Bien
262 d'autres formats sont disponibles et sont répertoriés à la rubrique
263 @code{paper-alist} du fichier d'initialisation @file{scm/paper.scm}.
265 @c TODO add a new appendix for paper sizes (auto-generated) -pm
267 @warning{Par défaut, le papier est au format A4 (codé @code{a4}).}
269 Rien ne vous empêche d'ajouter un format de papier inhabituel à la
270 rubrique @code{paper-alist} du fichier @file{scm/paper.scm}. Sachez
271 cependant que celui-ci est écrasé à chaque mise à jour de LilyPond.
275 @cindex paysage, papier
276 @cindex à l'italienne, papier
278 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
279 @code{set-default-paper-size} permet d'obtenir une présentation à
280 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
284 #(set-default-paper-size "a6" 'landscape)
290 @ref{Adaptation automatique au format}.
292 Fichiers d'initialisation :
293 @file{scm/paper.scm}.
296 @node Adaptation automatique au format
297 @unnumberedsubsubsec Adaptation automatique au format
298 @translationof Automatic scaling to paper size
300 Toute modification du format de papier à l'aide des fonctions scheme
301 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
302 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
303 par l'ajustement d'un certain nombre de variables attachées au bloc
304 @code{\paper} afin qu'elles soient en concordance avec le format
305 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
306 particulière en redéfinissant sa valeur après avoir spécifié le format
307 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
308 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
309 l'étalonnage automatique, bien que spécifier une largeur de papier
310 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
311 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
312 voir avec la mise à l'echelle.
314 L'adaptation automatique affecte les dimensionnements verticaux
315 @code{top-margin} et @code{bottom-margin} -- voir
316 @ref{Variables d'espacement vertical fixe} --, ainsi que les
317 dimmensionnements horizontaux @code{left-margin}, @code{right-margin},
318 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
319 @code{indent} et @code{short-indent} -- voir
320 @ref{Variables d'espacement horizontal}.
322 Les valeurs par défaut de ces dimensionnements sont contenues dans le
323 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
324 internes @code{top-margin-default}, @code{bottom-margin-default} etc.
325 correspondant au format par défaut -- papier A4 -- pour lequel
326 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
331 @ref{Variables d'espacement vertical fixe},
332 @ref{Variables d'espacement horizontal}.
334 Fichiers d'initialisation :
335 @file{ly/paper-defaults-init.ly},
336 @file{scm/paper.scm}.
339 @node Variables d'espacement vertical fixe
340 @subsection Variables d'espacement vertical fixe
341 @translationof Fixed vertical spacing @code{\paper} variables
343 @warning{Certains dimmensionnements attachés au bloc @code{@bs{}paper}
344 sont automatiquement ajustés selon le format du papier, ce qui peut
345 conduire à un résultat inattendu --
346 voir @ref{Adaptation automatique au format}.}
348 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
349 @file{ly/paper-defaults-init.ly}.
353 @funindex paper-height
355 La hauteur de la feuille. Il s'agit par défaut de la dimension du
356 papier utilisé. Notez bien que cette variable n'affectera pas
357 l'ajustement automatique d'un certain nombre de dimmensionnement
363 La marge entre le bord supérieur de la feuille et la surface imprimable.
364 Elle est fixée par défaut à@tie{}@code{5\mm} et s'ajustera selon le
368 @funindex bottom-margin
370 La marge entre la surface imprimable et le bord inférieur de la feuille.
371 Elle est fixée par défaut à@tie{}@code{6\mm} et s'ajustera selon le
375 @funindex ragged-bottom
377 L'activation de cette variable permet de ne pas répartir verticalement
378 les systèmes sur les pages hormis la dernière. La valeur par défaut
379 est@tie{}@code{##f}. Lorsque la partition ne comporte que deux ou trois
380 systèmes par page, comme pour un conducteur d'orchestre, nous vous
381 conseillons d'activer cette variable.
383 @item ragged-last-bottom
384 @funindex ragged-last-bottom
386 La désactivation de cette variable permet de répartir verticalement les
387 systèmes de la dernière page d'une partition. La valeur par défaut
388 est@tie{}@code{##t}. Nous vous conseillons, lorsque des pièces couvrent
389 deux pages ou plus, d'activer cette variable.@*
390 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
391 dernière page de chacune des parties -- créées à l'aide d'un bloc
392 @code{\bookpart} -- d'un même ouvrage.
399 @ref{Adaptation automatique au format}.
401 Fichiers d'initialisation :
402 @file{ly/paper-defaults-init.ly}.
405 @rlsrnamed{Spacing, Espacements}.
409 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
410 comme des systèmes à part entière@tie{}; ils seront donc affectés par
411 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
412 ajouteront de l'espace avant le premier système de la partition.
415 @node Variables d'espacement vertical fluctuant
416 @subsection Variables d'espacement vertical fluctuant
417 @translationof Flexible vertical spacing @code{\paper} variables
419 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
420 entre différents éléments (marges, titres, systèmes ou mouvements), en
421 dilatation ou compression selon le cas. Un certain nombre de variables
422 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
423 ces dimensionnements.
425 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
426 parlons ici n'influencent en rien l'espacement des portées d'un même
427 système. L'espacement au sein des systèmes est géré par des propriétés
428 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
429 définissent au niveau du bloc @code{\score} -- voir à ce sujet
430 @ref{Espacement vertical au sein d'un système}.
434 * Structure des variables d'espacement vertical fluctuant::
435 * Liste des variables d'espacement vertical fluctuant::
438 @node Structure des variables d'espacement vertical fluctuant
439 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
440 @translationof Structure of flexible vertical spacing alists
442 Chacune de ces variables attachées au bloc @code{\paper} est constituée
443 d'une liste associative @emph{(alist)} à quatre @i{clés}@tie{}:
448 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
449 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
450 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
451 sur toute la largeur des deux éléments.
454 @code{space} @emph{(espace)} -- la grandeur d'espace par défaut,
455 exprimée en hauteur de portée, séparant les @i{points de référence} de
456 deux éléments, qui évite tout risque de collision en l'absence de
457 dilatation ou compression. Le point de référence d'un titre ou d'un
458 @emph{markup} est son sommet, celui d'un système est le centre vertical
459 du @code{StaffSymbol} le plus proche -- même lorsqu'une ligne de
460 @qq{non-portée} viendrait à s'intercaler. Un @code{space} inférieur à
461 @code{padding} ou @code{minimum-distance} sera sans effet, dans la
462 mesure où l'espacement résultant ne saurait être inférieur à
463 @code{padding} ou @code{minimum-distance}.
466 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
467 minimal, exprimé en hauteur de portée, entre les points de référence des
468 deux éléments alors qu'il y a déjà un effet de compression. Une
469 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
470 sans effet, dans la mesure où l'espacement résultant ne saurait être
471 inférieur au @code{padding}.
474 @code{stretchability} @emph{(dilatation)} -- le coefficient
475 d'étirement de cet espace. Un coefficient nul permet de figer
476 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
477 positif déterminera la propension d'un espacement à s'étirer, tout
478 en tenant compte du coefficient affecté aux autres espacements.
479 Par exemple, lorsque le coefficient de dilatation d'une dimension est
480 double de celui d'une autre, elle pourra s'étirer deux fois plus que
481 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
482 provoque une @code{programming_error} (erreur de programmation) et est
483 ignorée@tie{}; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
484 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
485 sa valeur est par défaut égale à @code{space}. Notez bien que
486 l'utilisateur ne peut définir une propension à la compression@tie{};
487 elle est en fait égale à
488 (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
492 Lorsque l'impression n'est pas en pleine page -- elle est donc
493 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
494 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
502 @code{minimum-distance} et
504 @code{padding}, augmenté de ce qu'il faut pour éviter les
509 Les manières de modifier des listes associatives font l'objet d'un
510 @rusernamed{Modification de listes associatives, chapitre spécifique}.
511 L'exemple suivant indique deux façons de modifier une liste associative.
512 La première déclaration intervient sur une seule clé, alors que la
513 deuxième redéfinit complètement la variable.
517 system-system-spacing #'basic-distance = #8
519 score-system-spacing =
521 (basic-distance . 12)
522 (minimum-distance . 6)
523 (stretchability . 12))
528 @node Liste des variables d'espacement vertical fluctuant
529 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
530 @translationof List of flexible vertical spacing @code{\paper} variables
532 Le nom des dimensionnements à hauteur variable sont de la forme
533 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
534 @code{@var{après}} représentent les éléments qui doivent être espacés.
535 La distance s'établit entre les points de référence des deux éléments
536 concernés (voir la rubrique précédente pou plus de précision). Notez
537 bien que, dans les règles de nommage des variables qui suivent, le terme
538 @code{markup} fait référence aussi bien à un @i{markup de titrage}
539 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
540 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
541 distances sont exprimées en espace de portée.
543 Leurs valeurs par défaut sont inscrites dans le fichier
544 @file{ly/paper-defaults-init.ly}.
546 @c TODO: Where do headers/footers fit in? -mp
549 @item markup-system-spacing
550 @funindex markup-system-spacing
552 détermine l'espacement entre un titre ou un @emph{markup} de premier
553 niveau, et le système qui le suit.
555 @item score-markup-spacing
556 @funindex score-markup-spacing
558 détermine l'espacement entre le dernier système et le titre ou
559 @emph{markup} de haut niveau qui le suit.
561 @item score-system-spacing
562 @funindex score-system-spacing
564 détermine l'espacement entre le dernier système d'une partition et le
565 premier système de la partition suivante, en l'absence de titrage ou
566 @emph{markup} qui les sépare.
568 @item system-system-spacing
569 @funindex system-system-spacing
571 détermine l'espacement entre deux systèmes d'un même mouvement.
573 @item markup-markup-spacing
574 @funindex markup-markup-spacing
576 détermine l'espacement entre deux titres ou @emph{markups} de premier
579 @item last-bottom-spacing
580 @funindex last-bottom-spacing
582 détermine la distance entre le dernier système ou le dernier
583 @emph{markup} de haut niveau, et le bas de la surface imprimable --
584 autrement dit le haut de la marge basse.
586 @item top-system-spacing
587 @funindex top-system-spacing
589 détermine l'espace entre le haut de la surface imprimable (le bas de la
590 marge haute) et le milieu du premier système. Cette variable n'est
591 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
594 @item top-markup-spacing
595 @funindex top-markup-spacing
597 détermine l'espace entre le haut de la surface imprimable (le bas de la
598 marge haute) et le premier titre ou @emph{markup} de premier niveau.
599 Cette variable n'est effective qu'en l'absence de système en haut de
607 @ref{Espacement vertical au sein d'un système}.
610 @rlsrnamed{Spacing,Espacements}.
613 @rlsrnamed{Spacing,Espacements}.
616 @node Variables d'espacement horizontal
617 @subsection Variables d'espacement horizontal
618 @translationof Horizontal spacing \paper variables
620 @warning{Certains dimmensionnements attachés au bloc @code{@bs{}paper}
621 sont automatiquement ajustés selon le format du papier, ce qui peut
622 conduire à un résultat inattendu --
623 voir @ref{Adaptation automatique au format}.}
626 * Variables de marge et de largeur::
627 * Variables spécifiques pour l'impression recto-verso::
628 * Variables d'indentation et de décalage::
632 @node Variables de marge et de largeur
633 @unnumberedsubsubsec Variables de marge et de largeur
634 @translationof @code{\paper} variables for widths and margins
636 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
637 @file{ly/paper-defaults-init.ly}.
642 @funindex paper-width
644 La largeur de la page. Elle correspond par défaut à la largeur du
645 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
646 matière d'ajustement automatique, cette variable influe sur la variable
647 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
648 @code{paper-width} et @code{line-width}, les valeurs de
649 @code{left-margin} et @code{right-margin} seront recalculées. Voir
650 aussi @code{check-consistency}.
655 la longueur d'un système musical sans indentation et justifiée sur toute
656 la largeur de la page. La valeur par défaut est égale à
657 @code{paper-width}, auquel sont retranchés @code{left-margin} et
658 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
659 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
660 marges seront alors recalculées de telle sorte que les systèmes soient
661 centrés. Voir aussi @code{check-consistency}. La variable
662 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
665 @funindex left-margin
667 la marge entre le bord gauche de la feuille et le début de chaque
668 système. La valeur par défaut est de@tie{}@code{10\mm}@tie{}; elle sera
669 ajustée selon le format du papier. Lorsque vous définissez
670 @code{line-width} et @code{right-margin}, sans modifier la valeur de
671 @code{left-margin}, cette dernière sera alors égale à
672 @code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}right-margin)}.
673 Lorsque seule @code{line-width} est définie, les deux marges
675 @code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, ce
676 qui a pour effet de centrer les systèmes sur la page. Voir aussi
677 @code{check-consistency}.
680 @funindex right-margin
682 La marge entre le bord droit de la page et la fin des systèmes en pleine
683 largeur (non @emph{ragged}). La valeur par défaut est
684 de@tie{}@code{10\mm} et s'ajustera selon le format du papier. Lorsque
685 vous définissez @code{line-width} et @code{left-margin}, sans modifier
686 la valeur de @code{right-margin}, cette dernière sera alors égale à
687 @code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}left-margin)}.
688 Lorsque seule @code{line-width} est définie, les deux marges
690 @code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, ce
691 qui a pour effet de centrer les systèmes sur la page. Voir aussi
692 @code{check-consistency}.
694 @item check-consistency
695 @funindex check-consistency
697 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
698 @code{line-width} et @code{right-margin} sont en cohérence, et que
699 l'addition de ces trois éléments ne dépassera pas la largeur du papier
700 (@code{paper-width}). La valeur par défaut est@tie{}@code{##t}. Dans
701 le cas d'une incohérence, un message d'avertissement est émis et les
702 trois variables -- marges et longueur de ligne -- rétablies à leur
703 valeur par défaut (ajustées selon le fromat du papier).
706 @funindex ragged-right
708 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
709 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
710 La valeur par défaut est @code{##f} mais, si la partition ne comporte
711 qu'un seul système, elle passe à @code{##t}. Cette variable peut aussi
712 se gérer au sein d'un bloc @code{\layout}.
715 @funindex ragged-last
717 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
718 dernier système de façon à occuper toute la longueur de la ligne. La
719 valeur par défaut est@tie{}@code{##f}. Cette variable peut aussi
720 se gérer au sein d'un bloc @code{\layout}.
726 @ref{Adaptation automatique au format}.
728 Fichiers d'initialisation :
729 @file{ly/paper-defaults-init.ly}.
732 @node Variables spécifiques pour l'impression recto-verso
733 @unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
734 @translationof @code{\paper} variables for two-sided mode
736 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
737 @file{ly/paper-defaults-init.ly}.
747 Cette variable permet de gérer efficacement les impressions recto-verso.
748 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
749 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
750 différentes marges selon qu'il s'agit d'une page paire ou impaire.
751 Cette variable s'applique en lieu et place de @code{left-margin} et
752 @code{right-margin}. La valeur par défaut est@tie{}@code{##f}.
755 @funindex inner-margin
757 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
758 avoir du côté intérieur. Bien entendu, cette variable n'est
759 effective que lorsque vous comptez générer un fichier imprimable en
760 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
761 défaut est de@tie{}@code{10\mm} et s'ajustera selon le format du papier.
764 @funindex outer-margin
766 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
767 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
768 variable n'est effective que lorsque vous comptez générer un fichier
769 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
770 La valeur par défaut est de@tie{}@code{20\mm} et s'ajustera selon le
774 @funindex binding-offset
776 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
777 valeur de la marge intérieure @code{inner-margin} de telle sorte que
778 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
779 effective que lorsque vous comptez générer un fichier imprimable en
780 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
781 défaut est de@tie{}@code{0} et s'ajustera selon le format du papier.
787 @ref{Adaptation automatique au format}.
789 Fichiers d'initialisation :
790 @file{ly/paper-defaults-init.ly}.
793 @node Variables d'indentation et de décalage
794 @unnumberedsubsubsec Variables d'indentation et de décalage
795 @translationof @code{\paper} variables for shifts and indents
797 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
798 @file{ly/paper-defaults-init.ly}.
802 @item horizontal-shift
803 @funindex horizontal-shift
805 @c This default value is buried in the middle of page.scm. -mp
807 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
808 seront poussés d'autant vers la droite. la valeur par défaut est
814 Le niveau d'indentation du premier système d'une partition. La valeur
815 par défaut est de@tie{}@code{15\mm} et s'ajustera selon le format du
816 papier. Cette variable peut aussi se gérer au sein d'un bloc
820 @funindex short-indent
822 Le niveau d'indentation de tous les systèmes hormis le premier. La
823 valeur par défaut est de@tie{}@code{0}, et s'ajustera selon le format du
824 papier dès lors que vous lui affecterez une valeur. Cette variable peut
825 aussi se gérer au sein d'un bloc @code{\layout}.
831 @ref{Adaptation automatique au format}.
833 Fichiers d'initialisation :
834 @file{ly/paper-defaults-init.ly}.
840 @node Autres variables du bloc \paper
841 @subsection Autres variables du bloc @code{\paper}
842 @translationof Other @code{\paper} variables
845 * Variables de gestion des sauts de ligne::
846 * Variables de gestion des sauts de page::
847 * Variables de gestion des numéros de page::
848 * Variables supplémentaires::
852 @node Variables de gestion des sauts de ligne
853 @unnumberedsubsubsec Variables de gestion des sauts de ligne
854 @translationof @code{\paper} variables for line breaking
856 @c TODO: Mention that ly:optimal-breaking is on by default? -mp
860 @item max-systems-per-page
861 @funindex max-systems-per-page
863 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
864 variable n'est prise en compte, à ce jour, que par l'option
865 @code{ly:optimal-breaking}, et n'est pas définie.
867 @item min-systems-per-page
868 @funindex min-systems-per-page
870 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
871 cependant aux risques de débordement s'il est trop important. Cette
872 variable n'est prise en compte, à ce jour, que par l'option
873 @code{ly:optimal-breaking}, et n'est pas définie.
875 @item systems-per-page
876 @funindex systems-per-page
878 Le nombre de systèmes que devrait comporter chaque page. Cette variable
879 n'est à ce jour prise en charge que par l'algorithme
880 @code{ly:optimal-breaking} et n'est pas définie par défaut.
883 @funindex system-count
885 Le nombre de systèmes requis par la partition. Cette variable n'est pas
886 définie par défaut. Cette variable peut se gérer au sein d'un bloc
893 @ref{Sauts de ligne}.
896 @node Variables de gestion des sauts de page
897 @unnumberedsubsubsec Variables de gestion des sauts de page
898 @translationof @code{\paper} variables for page breaking
900 Les valeurs par défaut sont définies dans le fichier
901 @file{ly/paper-defaults-init.ly}.
905 @item blank-after-score-page-force
906 @funindex blank-after-score-page-force
908 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
909 valeur est par défaut inférieure à celle de
910 @code{blank-page-force}@tie{}; nous préférons q'une page blanche
911 s'insère après la fin de la partition plutôt qu'au milieu.
913 @item blank-last-page-force
914 @funindex blank-last-page-force
916 Pénalité pour fin de partition intervenant sur une page impaire. La
917 valeur par défaut est de@tie{}@code{0}.
919 @item blank-page-force
920 @funindex blank-page-force
922 Pénalité pour apparition d'une page blanche en cours de partition.
923 L'algorithme @code{ly:optimal-breaking} n'en tiendra pas compte
924 puisqu'il ne conçoit pas la présence d'une page blanche au milieu d'une
925 partition. La valeur par défaut est de@tie{}@code{5}.
928 @funindex page-breaking
930 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
931 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking} et
932 @code{ly:optimal-breaking}.
934 @item page-breaking-system-system-spacing
935 @funindex page-breaking-system-system-spacing
937 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
938 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
939 lorsque @code{page-breaking-system-system-spacing #'padding} a une
940 valeur nettement supérieure à @code{system-system-spacing #'padding},
941 l'algorithme en question aura tendance à disposer moins de systèmes sur
942 une même page. Cette variable est par défaut non définie.
947 Le nombre de pages que devra comporter la partition. Cette variable est
948 par défaut non définie.
955 @ref{Optimisation des sauts de page},
956 @ref{Optimisation des tournes},
957 @ref{Minimisation des sauts de page}.
959 Fichiers d'initialisation :
960 @file{ly/paper-defaults-init.ly}.
963 @node Variables de gestion des numéros de page
964 @unnumberedsubsubsec Variables de gestion des numéros de page
965 @translationof @code{\paper} variables for page numbering
967 Les valeurs par défaut sont définies dans le fichier
968 @file{ly/paper-defaults-init.ly}.
972 @item auto-first-page-number
973 @funindex auto-first-page-number
975 L'algorithme qui gère les sauts de page prend en compte le fait que le
976 premier numéro de page soit pair ou impair. Lorsque cette
977 fonctionnalité est activée, l'algorithme des sauts de page décidera de
978 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
979 par un éventuel incrément de un. La valeur par défaut
982 @item first-page-number
983 @funindex first-page-number
985 Le numéro de la première page. La valeur par défaut est
988 @item print-first-page-number
989 @funindex print-first-page-number
991 Cette variable permet d'imprimer le numéro de page y compris sur la
992 première. La valeur par défaut est@tie{}@code{##f}.
994 @item print-page-number
995 @funindex print-page-number
997 La désactivation de cette variable permet d'obtenir des pages non
998 numérotées. La valeur par défaut est@tie{}@code{##t}.
1003 Fichiers d'initialisation :
1004 @file{ly/paper-defaults-init.ly}.
1007 @node Variables supplémentaires
1008 @unnumberedsubsubsec Variables supplémentaires
1009 @translationof Miscellaneous @code{\paper} variables
1013 @item page-spacing-weight
1014 @funindex page-spacing-weight
1016 Cette variable définit l'importance relative des espacements entre la
1017 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1018 privilégiera l'espacement au niveau de la page. La valeur par défaut
1019 est de@tie{}@code{#10}.
1021 @item print-all-headers
1022 @funindex print-all-headers
1024 Lorsque cette variable est activée, l'intégralité des champs d'entête
1025 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1026 champs @code{piece} et @code{opus}. La valeur par défaut
1027 est@tie{}@code{##f}.
1029 @item system-separator-markup
1030 @funindex system-separator-markup
1032 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1033 chaque système, comme on le voit dans nombre de partitions orchestrales.
1034 Cette variable n'est pas définie par défaut. La commande
1035 @code{\slashSeparator} -- définie dans le fichier
1036 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1039 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1040 #(set-default-paper-size "a8")
1044 system-separator-markup = \slashSeparator
1050 \relative c'' { c1 \break c1 \break c1 }
1059 Fichiers d'initialisation :
1060 @file{ly/titling-init.ly}.
1063 @rlsrnamed{Spacing,Espacements}.
1068 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1069 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1072 @node Mise en forme de la partition
1073 @section Mise en forme de la partition
1074 @translationof Score layout
1076 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1077 plus particulièrement destinées à gérer la mise en forme de la
1082 * Définition de la taille de portée::
1086 @node Le bloc \layout
1087 @subsection Le bloc @code{\layout}
1088 @translationof The @code{\layout} block
1092 Alors que le bloc @code{\paper} définit le formatage des pages pour
1093 l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
1094 forme spécifique à la partition. La mise en forme de la musique peut
1095 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1096 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1097 où la mise en forme concerne une partition en particulier, un bloc
1098 @code{\layout} se placera au sein du bloc @code{\score} en question.
1099 Sont susceptibles d'apparître dans un bloc @code{\layout}@tie{}:
1103 la fonction scheme @code{layout-set-staff-size},
1106 dans des blocs @code{\contexte}, les modifications apportées aux
1107 différents contextes, et
1110 les variables normalement attachées au bloc @code{\paper} qui
1111 affacteront la mise en forme de la partition.
1115 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1116 suivante, @ref{Définition de la taille de portée}. La modification des
1117 contextes est abordée dans d'autres chapitres -- voir
1118 @ref{Modification des propriétés d'un contexte} et
1119 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1120 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1121 @code{\layout} sont@tie{}:
1126 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1127 (voir @ref{Variables de marge et de largeur})
1130 @code{indent} et @code{short-indent}
1131 (see @ref{Variables d'indentation et de décalage})
1135 (see @ref{Variables de gestion des sauts de ligne})
1139 Voici un exemple de bloc @code{\layout} :
1146 \override StaffGrouper #'staff-staff-spacing #space = #8
1150 \override TextScript #'padding = #1
1151 \override Glissando #'thickness = #3
1158 Manuel de notation :
1159 @ref{Modification des réglages par défaut d'un contexte}.
1162 @rlsrnamed{Spacing,Espacements}.
1165 @node Définition de la taille de portée
1166 @subsection Définition de la taille de portée
1167 @translationof Setting the staff size
1169 @cindex fonte, définition de la taille
1170 @cindex portée, définition de la taille
1171 @funindex layout file
1173 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1174 20@tie{}points. Il existe deux manières de la modifier@tie{}:
1176 La taille des portées peut se définir globalement pour toutes les
1177 partitions d'un même fichier, ou plus précisément d'un bloc
1178 @code{\book}, à l'aide de @code{set-global-staff-size}.
1181 #(set-global-staff-size 14)
1185 Ceci définit donc la hauteur des portées à 14@tie{}points par
1186 défaut@tie{}; toutes les fontes seront ajustées en conséquence.
1189 Vous pouvez aussi spécifier une taille à une partition en particulier en
1190 procédant comme ci-dessous@tie{}:
1196 #(layout-set-staff-size 15)
1201 La fonte Feta fournit les symboles musicaux dans huit tailles
1202 différentes. Chaque fonte correspond à une hauteur particulière de
1203 portée@tie{}; les petites tailles comportent des symboles plus épais
1204 pour être cohérent avec l'épaisseur relativement plus importante des
1205 lignes de la portée. Le tableau suivant répertorie les différentes
1209 @multitable @columnfractions .15 .2 .22 .2
1211 @item @b{nom de la fonte}
1212 @tab @b{hauteur de portée (pt)}
1213 @tab @b{hauteur de portée (mm)}
1214 @tab @b{utilisation}
1219 @tab format de poche
1239 @tab carnet de chant
1244 @tab partition standard
1255 @c matériel de location moderne ?
1260 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1261 contexte @code{fontSize} ainsi que la propriété de mise en forme
1262 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1263 individuellement la taille de chaque portée. La taille de chacune des
1264 portées est relative à la taille globale.
1268 Manuel de notation :
1269 @ref{Indication de la taille de fonte musicale}.
1272 @rlsrnamed{Spacing,Espacements}.
1277 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1278 lignes d'une portée.
1283 @translationof Breaks
1288 * Optimisation des sauts de page::
1289 * Optimisation des tournes::
1290 * Minimisation des sauts de page::
1291 * Sauts explicites::
1292 * Recours à une voix supplémentaire pour gérer les sauts::
1296 @node Sauts de ligne
1297 @subsection Sauts de ligne
1298 @translationof Line breaking
1300 @cindex saut de ligne
1301 @cindex ligne, passer à la suivante
1303 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1304 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1305 trop aérée, et que des lignes consécutives aient à peu près la même
1308 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1309 vous le jugez utile pour @qq{forcer} le passage à la ligne
1312 @lilypond[quote,ragged-right,relative=2,verbatim]
1317 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1318 mesure@tie{}; LilyPond vous le signalera par un message si tel était le
1319 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1320 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1321 l'aide de @code{\bar@tie{}""}.
1323 @lilypond[quote,ragged-right,relative=2,verbatim]
1330 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1331 mesure dès lors que la précédente avait une note en suspend -- c'est
1332 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1333 L'instruction @code{\break} sera alors opérationnelle si vous avez
1334 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1335 @code{Voice} concerné. Notez bien que les sauts de ligne forcés doivent
1336 être saisis au sein d'une expression polyphonique@tie{}:
1338 @lilypond[quote,ragged-right,verbatim]
1340 \remove Forbid_line_break_engraver
1343 { c2. \times 2/3 { c4 c c } c2. | }
1344 { s1 | \break s1 | }
1349 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1350 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1351 introduire la dérogation @w{@code{\override Beam #'breakable = ##t}}.
1353 @lilypond[quote,ragged-right,relative=2,verbatim]
1354 \override Beam #'breakable = ##t
1359 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1360 saut de ligne à la fin de la mesure où elle est explicitée.
1362 LilyPond dispose de deux variables de base pour influencer l'espacement
1363 au niveau des lignes. Toutes deux se définissent dans un bloc
1364 @code{\layout}, @code{indent} réglant l'indentation de la première
1365 ligne, et @code{line-width} la longueur des lignes.
1367 L'activation du commutateur @code{ragged-right} au sein du bloc
1368 @code{\layout} aura pour effet de terminer les systèmes là où il le
1369 feraient normalement plutôt que de les étirer sur toute la longueur de
1370 la ligne. Ceci est particulièrement utile pour de petits fragments ou
1371 pour vérifier la densité induite par l'espacement naturel.
1373 @c TODO Check and add para on default for ragged-right
1375 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1376 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1388 @cindex sauts de ligne réguliers
1389 @cindex portée à quatre mesures
1391 L'utilisation conjointe de @code{\break} et de blancs dans une section
1392 @code{\repeat} vous permettra de positionner des sauts de ligne à
1393 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1394 'lon est à 4/4, seront coupées toutes les quatre mesures, pas
1400 s1 \noBreak s1 \noBreak
1401 s1 \noBreak s1 \break
1403 @{ @var{the actual music@dots{}} @}
1408 Apparemment, je ne vois pas de "snippet" qui corresponde,
1409 à moins que ce ne soit pour allécher vers la section
1410 "4.6 Fitting music onto fewer pages" -JCM
1412 A linebreaking configuration can be saved as a @code{.ly} file
1413 automatically. This allows vertical alignments to be stretched to
1414 fit pages in a second formatting run. This is fairly new and
1415 complicated. More details are available in
1429 @ref{Variables de gestion des sauts de ligne}.
1431 Référence des propriétés internes :
1432 @rinternals{LineBreakEvent}.
1435 @rlsrnamed{Spacing,Espacements}.
1439 @subsection Sauts de page
1440 @translationof Page breaking
1442 La gestion automatique des sauts de page se contrôle à l'aide des
1443 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1444 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1445 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1446 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1447 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1450 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1451 trouver à des niveaux supérieurs, entre deux partitions ou
1452 @emph{markups} de premier rang.
1454 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1455 gérer la répartition horizontale, LilyPond dispose de commutateurs
1456 équivalents au niveau de la verticalité@tie{}: @code{ragged-bottom} et
1457 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1458 affectés de @code{##t} -- les systèmes ne seront pas répartis sur les
1459 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1460 à @ref{Variables d'espacement vertical fixe}.
1462 Les sauts de page sont générés par la fonction @code{page-breaking}.
1463 LilyPond dispose de trois différents algorithmes en la matière@tie{}:
1464 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1465 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1466 activé par défaut, mais rien ne vous empêche d'en changer, par
1467 l'intermédiaire du bloc @code{\paper}@tie{}:
1471 page-breaking = #ly:page-turn-breaking
1477 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1478 pages, la gestion des sauts de page finit par devenir très gourmande,
1479 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1480 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1481 sectionner l'ouvrage que vous traitez@tie{}; les sauts de pages seront
1482 alors gérés individuellement au niveau de chacune des parties. Par
1483 ailleurs, cela vous autorisera une gestion différente selon les
1489 subtitle = "Préface"
1492 %% Pour une partie constituée principalement de texte
1493 %% ly:minimal-breaking est plus judicieux.
1494 page-breaking = #ly:minimal-breaking
1496 \markup @{ @dots{} @}
1500 %% Cette partie étant purement musicale,
1501 %% retour au style par défaut (optimal-breaking).
1503 subtitle = "Premier mouvement"
1505 \score @{ @dots{} @}
1512 @funindex \pageBreak
1514 @funindex \noPageBreak
1515 @code{\noPageBreak}.
1520 Manuel de notation :
1521 @ref{Variables de gestion des sauts de page}.
1524 @rlsrnamed{Spacing,Espacements}.
1527 @node Optimisation des sauts de page
1528 @subsection Optimisation des sauts de page
1529 @translationof Optimal page breaking
1531 @funindex ly:optimal-breaking
1533 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1534 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1535 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1536 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1537 n'a aucune notion de ce qu'est une @qq{tourne}.
1542 @rlsrnamed{Spacing,Espacements}.
1545 @node Optimisation des tournes
1546 @subsection Optimisation des tournes
1547 @translationof Optimal page turning
1549 @funindex ly:page-turn-breaking
1551 Aboutir à une configuration des sauts de page de telle sorte que les
1552 pages de droite se terminent toujours par un silence devient souvent une
1553 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1554 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1555 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1556 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1557 ne saurait intervenir qu'à certains endroits.
1559 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1560 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1561 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1562 informer la fonction des endroits où les sauts de page sont permis.
1564 Cette deuxième étape se réalise de deux manières différentes. Vous
1565 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1566 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1568 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1569 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1570 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1571 tournes recherchera dans le contexte en question les passages sans note.
1572 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1573 notes@tie{}; autrement dit, il ne restera pas inactif dans la cadre
1574 d'une portée polyphonique dont l'une des parties contiendrait des
1575 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1576 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1577 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1578 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1579 déposera le @code{\allowPageTurn}.
1581 @funindex minimumPageTurnLength
1583 Le @code{Page_turn_engraver} examine la propriété de contexte
1584 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1585 longueur d'un fragment sans note avant une tourne. La valeur par
1586 défaut de @code{minimumPageTurnLength} est
1587 @code{#(ly:make-moment@tie{}1@tie{}1)}, soit une ronde, et s'ajuste de
1588 la manière suivante@tie{}:
1591 \new Staff \with @{ \consists "Page_turn_engraver" @}
1594 R1 | % une tourne peut se placer ici
1596 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1597 R1 | % il ne peut pas y avoir de tourne ici
1599 R1*2 | % une tourne peut se placer ici
1604 @funindex minimumRepeatLengthForPageTurn
1606 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1607 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1608 temps au début et à la fin de la reprise pour que l'exécutant ait le
1609 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1610 même capable d'interdire un tourne dans le cas d'une reprise de courte
1611 durée, ajustable au travers de la propriété de contexte
1612 @code{minimumRepeatLengthForPageTurn}.
1614 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1615 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1616 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1622 @funindex \noPageTurn
1624 @funindex \allowPageTurn
1625 @code{\allowPageTurn}.
1631 @rlsrnamed{Spacing,Espacements}.
1636 Une partition ne devrait contenir qu'une seule instance du
1637 @code{Page_turn_engraver}, au risque de se contredire les uns les autres.
1640 @node Minimisation des sauts de page
1641 @subsection Minimisation des sauts de page
1642 @translationof Minimal page breaking
1644 @funindex ly:minimal-breaking
1646 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1647 calculs pour positionner les sauts de page. Elle mettra le plus de
1648 systèmes possible sur une page avant de passer à la suivante. On peut
1649 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1650 lorsque les autres fonctions de gestion des sauts de page ralentissent
1651 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1652 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1653 @code{\paper}@tie{}:
1657 page-breaking = #ly:minimal-breaking
1664 @rlsrnamed{Spacing,Espacements}.
1667 @node Sauts explicites
1668 @subsection Sauts explicites
1669 @translationof Explicit breaks
1671 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1672 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1673 avec ces deux instructions dérogatoires@tie{}:
1676 \override NonMusicalPaperColumn #'line-break-permission = ##f
1677 \override NonMusicalPaperColumn #'page-break-permission = ##f
1680 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1681 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1682 explicite, et nulle part ailleurs. De la même façon, la désactivation
1683 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1684 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1685 nulle part ailleurs.
1687 @lilypond[quote,verbatim]
1694 musique = \relative c'' { c8 c c c }
1698 \repeat unfold 2 { \musique } \break
1699 \repeat unfold 4 { \musique } \break
1700 \repeat unfold 6 { \musique } \break
1701 \repeat unfold 8 { \musique } \pageBreak
1702 \repeat unfold 8 { \musique } \break
1703 \repeat unfold 6 { \musique } \break
1704 \repeat unfold 4 { \musique } \break
1705 \repeat unfold 2 { \musique }
1710 \override NonMusicalPaperColumn #'line-break-permission = ##f
1711 \override NonMusicalPaperColumn #'page-break-permission = ##f
1720 @rlsrnamed{Spacing,Espacements}.
1723 @node Recours à une voix supplémentaire pour gérer les sauts
1724 @subsection Recours à une voix supplémentaire pour gérer les sauts
1725 @translationof Using an extra voice for breaks
1727 La plupart du temps, les informations concernant les sauts de ligne ou
1728 de page se retrouvent directement au milieu des notes.
1731 musique = \relative c'' @{ c4 c c c @}
1735 \repeat unfold 2 @{ \musique @} \break
1736 \repeat unfold 3 @{ \musique @}
1741 Bien que cela constitue un moyen aisé de saisir les commandes
1742 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1743 mélangées à des informations qui concernent plutôt l'agencement de la
1744 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1745 purement musical et les informations concernant les sauts de ligne ou de
1746 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1747 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1748 des @code{\break}, des @code{\pageBreak} et autres informations
1749 concernant les ruptures.
1751 @lilypond[quote,verbatim]
1752 music = \relative c'' { c4 c c c }
1763 \repeat unfold 2 { \music }
1764 \repeat unfold 3 { \music }
1765 \repeat unfold 6 { \music }
1766 \repeat unfold 5 { \music }
1772 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1773 les @code{line-break-system-details} et autres propriétés fort
1774 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1775 le voir au chapitre @ref{Espacement vertical}.
1777 @lilypond[quote,verbatim]
1778 music = \relative c'' { c4 c c c }
1783 \overrideProperty "Score.NonMusicalPaperColumn"
1784 #'line-break-system-details #'((Y-offset . 0))
1787 \overrideProperty "Score.NonMusicalPaperColumn"
1788 #'line-break-system-details #'((Y-offset . 35))
1791 \overrideProperty "Score.NonMusicalPaperColumn"
1792 #'line-break-system-details #'((Y-offset . 70))
1795 \overrideProperty "Score.NonMusicalPaperColumn"
1796 #'line-break-system-details #'((Y-offset . 105))
1800 \repeat unfold 2 { \music }
1801 \repeat unfold 3 { \music }
1802 \repeat unfold 6 { \music }
1803 \repeat unfold 5 { \music }
1811 Manuel de notation :
1812 @ref{Espacement vertical}.
1815 @rlsrnamed{Spacing,Espacements}.
1818 @node Espacement vertical
1819 @section Espacement vertical
1820 @translationof Vertical spacing
1822 @cindex vertical, espacement
1823 @cindex espacement vertical
1825 L'espacement vertical dépend de trois éléments@tie{}: la surface
1826 disponible -- par exemple format de papier et marges --, l'espace qui
1827 doit séparer les systèmes, et l'espace qui sépare les portées d'un même
1831 * Espacement vertical au sein d'un système::
1832 * Positionnement explicite des portées et systèmes::
1833 * Résolution des collisions verticales::
1836 @node Espacement vertical au sein d'un système
1837 @subsection Espacement vertical au sein d'un système
1838 @translationof Flexible vertical spacing within systems
1840 @cindex distance entre les portées
1841 @cindex portées, espacement
1842 @cindex espacement entre les portées
1843 @cindex espacement au sein d'un système
1845 LilyPond dispose de trois différents mécanismes permettant de contrôler
1846 l'espacement au sein d'un système selon trois catégories@tie{}:
1851 @emph{portées isolées},
1854 @emph{portées regroupées} (portées d'un même groupe, telles celles
1855 d'un @code{ChoirStaff}, etc.), et
1858 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
1862 @c TODO: Clarify this. This almost implies that non-staff lines
1863 @c have NO effect on the spacing between staves. -mp
1865 La hauteur de chaque système se détermine en deux phases. Les portées
1866 sont tout d'abord espacées selon la surface disponible. Puis les lignes
1867 autres que des portées, comme les paroles ou les accords, sont réparties
1870 Les paragraphes qui suivent traitent exclusivement de la manière de
1871 gérer l'espacement entre les lignes d'un système -- portée musicale ou
1872 non. Pour ce qui a trait aux espacements entre les systèmes,
1873 mouvements, annotations et marge, ils sont contrôlés par des variables
1874 attachées au bloc @code{\paper} et font l'objet du chapitre
1875 @ref{Variables d'espacement vertical fluctuant}.
1878 * Propriétés d'espacement au sein d'un système::
1879 * Espacement de portées isolées::
1880 * Espacement de portées regroupées::
1881 * Espacement des lignes rattachées à des portées::
1885 @node Propriétés d'espacement au sein d'un système
1886 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
1887 @translationof Within-system spacing properties
1889 L'espacement entre les portées est géré par deux jeux de propriétés
1890 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
1891 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
1892 ou de non-portée. Le second, associé à l'objet graphique
1893 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
1894 de portées particulier. Les propriétés qui leur sont attachées sont
1895 abordées en fin de section.
1897 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
1898 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
1899 @code{@var{item2}} étant les éléments à espacer. Notez bien que
1900 @code{@var{item2}} n'est pas forcément placé au-dessous@tie{}: c'est le
1901 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
1902 la distance entre une ligne de non-portée alors que sa
1903 @code{staff-affinity} a été déterminée à @code{#UP}.
1905 Toutes ces distances sont mesurées entre les points de référence
1906 respectifs de éléments considérés.
1907 Le @i{point de référence} d'une portée est le centre vertical du
1908 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
1909 l'interligne médian si @code{line-count} est pair.
1910 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
1911 tableau suivant présente le @i{point de référence} pour chacun d'entre
1914 @multitable {Non-staff line} {Reference point}
1915 @headitem Ligne de non-portée @tab Point de référence
1916 @item @code{ChordNames} @tab ligne de base
1917 @item @code{NoteNames} @tab ligne de base
1918 @item @code{Lyrics} @tab ligne de base
1919 @item @code{Dynamics} @tab centre vertical
1920 @item @code{FiguredBass} @tab point le plus haut
1921 @item @code{FretBoards} @tab ligne supérieure
1924 En voici une représentation graphique@tie{}:
1927 @lilypond[quote,noragged-right,line-width=110\mm]
1928 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
1930 alignToZero = \with {
1931 \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
1932 \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
1934 lowerCaseChords = \with {
1935 chordNameLowercaseMinor = ##t
1937 staffAffinityDown = \with {
1938 \override VerticalAxisGroup #'staff-affinity = #DOWN
1941 #(define-music-function
1942 (parser location context)
1944 #{ s1*0^\markup { \typewriter $context } #})
1947 \context { \Dynamics \alignToZero }
1948 \context { \FiguredBass \alignToZero }
1949 \context { \Lyrics \alignToZero }
1950 \context { \NoteNames \alignToZero }
1951 \context { \ChordNames \alignToZero \lowerCaseChords }
1952 \context { \FretBoards \alignToZero \staffAffinityDown }
1954 \override BarLine #'stencil = ##f
1955 \override DynamicText #'self-alignment-X = #-1
1956 \override FretBoard #'X-offset = #1.75
1957 \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
1958 \override InstrumentName #'extra-offset = #'(0 . -0.5)
1959 \override TextScript #'minimum-Y-extent = #'(-2 . 3)
1960 \override TimeSignature #'stencil = ##f
1964 %% Contextes dont le point de référence est la ligne de base :
1965 %% ChordNames, NoteNames, et Lyrics
1967 \new ChordNames { \chords { g1:m } }
1968 \new NoteNames { s1 | g1 | }
1969 \new RhythmicStaff {
1970 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
1972 \labelContext "ChordNames" s1 |
1973 \labelContext "NoteNames" s1 |
1974 \labelContext "Lyrics" s1 |
1976 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
1979 %% Le point de référence de Dynamics est le milieu de la ligne
1981 \new RhythmicStaff {
1982 \set RhythmicStaff.instrumentName = #"centre vertical "
1983 \labelContext "Dynamics" s1*3
1985 \new Dynamics { s2\mp s\fp }
1988 %% Le point de référence de FiguredBass est son point le plus haut
1990 \new RhythmicStaff {
1991 \set RhythmicStaff.instrumentName = #"point le plus haut "
1992 \labelContext "FiguredBass" s1
1994 \new FiguredBass { \figuremode { <6 5>1 } }
1997 %% Le point de référence de FretBoards est la ligne du haut
1998 \include "predefined-guitar-fretboards.ly"
2000 \new FretBoards { \chordmode { e1 } }
2001 \new RhythmicStaff {
2002 \set RhythmicStaff.instrumentName = #"ligne du haut "
2003 \labelContext "FretBoards " s1
2008 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2009 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2010 sous la forme d'une liste associative dont les composantes sont
2011 identiques à celle des variables du bloc @code{\paper} que nous avons
2012 examinées au chapitre
2013 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2014 matière de modification d'une liste associative font l'objet d'un
2015 @rusernamed{Modification de listes associatives,chapitre particulier}.
2016 Les propriétés des objets graphiques se règlent avec un @code{\override}
2017 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2020 L'exemple suivant illustre deux façons de modifier une liste
2021 associative. La première déclaration n'agit que sur une seule clé,
2022 alors que la seconde redéfinit la propriété dans son intégralité.
2026 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2030 \override VerticalAxisGroup #'staff-staff-spacing =
2032 (basic-distance . 10)
2033 (minimum-distance . 9)
2034 (stretchability . 10))
2038 La modification d'un espacement au niveau global se mentionne au sein du
2039 bloc @code{\layout}@tie{}:
2045 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2050 Les réglages concernant les propriétés d'espacement vertical des objets
2051 graphiques sont répertoriées aux chapitres
2052 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2053 Les propriétés relatives aux lignes de non-portée sont répertoriées
2054 selon la définition de leur contexte dans la
2055 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2058 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2059 @translationof Properties of the @code{VerticalAxisGroup} grob
2061 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2062 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2066 @item staff-staff-spacing
2067 Il s'agit de la distance entre la portée en cours et la portée qui suit
2068 au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
2069 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2070 pas à la dernière portée d'un système.
2071 Cette propriété écrase les réglages hérités du @emph{grob}
2072 @code{StaffGrouper} d'un éventuel regroupement.
2073 Lorsque @code{staff-staff-spacing} n'est pas défini et qu'il n'y a pas
2074 de @code{StaffGrouper} dont on pourrait hériter des propriétés, c'est la
2075 propriété @code{default-staff-staff-spacing} qui s'applique.
2077 @item default-staff-staff-spacing
2078 Il s'agit de la distance qui s'appliquera, dans le cas où
2079 @code{staff-staff-spacing} n'aura pas été défini, aussi bien pour les
2080 portées isolées que dans le cas où les portées d'un regroupement
2081 n'hériteraient pas des ajustements du @code{StaffGrouper} concerné.
2083 @item staff-affinity
2084 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2085 que prendra une ligne de non-portée pour aller s'accoler aux portées
2086 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2087 non-portée ira se placer à équidistance entre les portées qui
2088 l'encadrent, tout en tenant compte des éventuels risques de collision et
2089 des autres contraintes d'espacement. Des lignes de non-portée
2090 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2091 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2092 Une ligne de non-portée en dessous d'un système devrait avoir sa
2093 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2094 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2095 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2096 @code{staff-affinity}@tie{}: si vous lui affectez la valeur @code{#f} à
2097 une ligne de non-portée, cette ligne sera considérée comme étant une
2098 portée@tie{}; à l'inverse, utiliser la propriété @code{staff-affinity}
2099 pour une portée lui fera perdre cette qualité.
2101 @c TODO: verify last clause below ("even if other...")
2103 @item nonstaff-relatedstaff-spacing
2104 Il s'agit de la distance entre la ligne de non-portée en cours et la
2105 portée la plus proche selon la @code{staff-affinity}, à la double
2106 condition qu'il n'y a pas déjà une autre ligne de non-portée et que la
2107 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2108 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2109 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2110 non-portée entre les deux portées adjacentes même si une autre
2111 non-portée est présente (quelque soit le côté).
2113 @item nonstaff-nonstaff-spacing
2114 Il s'agit de la distance entre deux lignes de non-portée selon
2115 l'orientation définie par @code{staff-affinity} et qu'elles ont la même
2116 orientation. Bien entendu, ceci ne peut concerner que les valeurs
2117 @code{UP} et @code{DOWN} de @code{staff-affinity}.
2119 @item nonstaff-unrelatedstaff-spacing
2120 Il s'agit de la distance entre une ligne de non-portée et la portée à
2121 l'opposé de l'orientation adoptée, à la double condition qu'il n'y a pas
2122 déjà une autre ligne de non-portée et que la valeur de
2123 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2124 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2125 portée à laquelle elle ne correspond pas.
2129 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2130 @translationof Properties of the @code{StaffGrouper} grob
2132 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2133 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2137 @item staff-staff-spacing
2138 Il s'agit de la distance entre deux portées consécutives d'un même
2139 système. Cependant, lorsque l'une des portées d'un regroupement s'est
2140 vue définir la propriété @code{staff-staff-spacing} de son
2141 @code{VerticalAxisGroup}, le @code{VerticalAxisGroup} aura préséance.
2142 Voir aussi la propriété @code{default-staff-staff-spacing}.
2144 @item staffgroup-staff-spacing
2145 Il s'agit de la distance entre la dernière portée d'un regroupement et
2146 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2147 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2148 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2149 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2150 regroupement a été ajustée au niveau de son @code{VerticalAxisGroup},
2151 cette dernière aura préséance. Voir aussi la propriété
2152 @code{default-staff-staff-spacing}.
2157 Fichiers d'initialisation :
2158 @file{ly/engraver-init.ly},
2159 @file{scm/define-grobs.scm}.
2161 Référence des propriétés internes :
2162 @rinternals{Contexts},
2163 @rinternals{VerticalAxisGroup},
2164 @rinternals{StaffGrouper}.
2167 @node Espacement de portées isolées
2168 @unnumberedsubsubsec Espacement de portées isolées
2169 @translationof Spacing of ungrouped staves
2171 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2172 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2175 L'espacement de ces @i{portées isolées} est géré par les propriétés
2179 @item Propriétés du @code{VerticalAxisGroup} :
2181 @item @code{staff-staff-spacing}
2185 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2186 @ref{Propriétés d'espacement au sein d'un système}.
2188 Certaines propriétés supplémentaires s'appliqueront dès lors que
2189 ces portées sont regroupées -- voir
2190 @ref{Espacement de portées regroupées}.
2192 L'exemple suivant illustre la manière de gérer l'espacement de portées
2193 isolées à l'aide de la propriété @code{staff-staff-spacing}@tie{}:
2195 @lilypond[verbatim,quote,staffsize=16]
2199 \override VerticalAxisGroup #'staff-staff-spacing =
2201 (basic-distance . 8)
2202 (minimum-distance . 7))
2207 % The very low note here needs more room than 'space can
2208 % provide, so the distance between this staff and the next is
2209 % determined by 'padding.
2210 \new Staff { b,2 r | }
2212 % Here, 'space provides enough room, and there is no need to
2213 % compress the space (towards 'minimum-distance) to make room
2214 % for anything else on the page, so the distance between this
2215 % staff and the next is determined by 'space.
2216 \new Staff { \clef bass g2 r | }
2218 % By setting 'padding to a negative value, staves can be made to
2219 % collide. The lowest acceptable value for 'space is 0.
2221 \override VerticalAxisGroup #'staff-staff-spacing =
2223 (basic-distance . 3.5))
2224 } { \clef bass g2 r | }
2225 \new Staff { \clef bass g2 r | }
2231 Fichiers d'initialisation :
2232 @file{scm/define-grobs.scm}.
2235 @rlsrnamed{Spacing,Espacements}.
2237 Référence des propriétés internes :
2238 @rinternals{VerticalAxisGroup}.
2241 @node Espacement de portées regroupées
2242 @unnumberedsubsubsec Espacement de portées regroupées
2243 @translationof Spacing of grouped staves
2245 Dans les partitions orchestrales ou de grande ampleur, il arrive
2246 souvent que des portées soient regroupées. L'espacement est alors plus
2247 important entre deux regroupements qu'entre les portées d'un même
2250 Les @i{regroupement de portées} tels le @code{StaffGroup} ou le
2251 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2252 une ou plusieurs portées.
2254 L'espacement entre les portées d'un même regroupement est géré par les
2255 propriétés suivantes@tie{}:
2258 @item Propriétés du @code{VerticalAxisGroup} :
2260 @item @code{staff-staff-spacing}
2261 @item @code{default-staff-staff-spacing}
2263 @item Propriétés du @code{StaffGrouper} :
2265 @item @code{staff-staff-spacing}
2266 @item @code{staffgroup-staff-spacing}
2270 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2271 @ref{Propriétés d'espacement au sein d'un système}.
2273 L'exemple suivant illustre la manière de gérer l'espacement de portées
2274 regroupes, à l'aide des propriétés de l'objet graphique
2275 @code{StaffGrouper}@tie{}:
2277 @lilypond[verbatim,quote,staffsize=16]
2281 \override StaffGrouper #'staff-staff-spacing #'padding = #0
2282 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
2287 \new PianoStaff \with {
2288 \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
2303 Fichiers d'initialisation :
2304 @file{scm/define-grobs.scm}.
2307 @rlsrnamed{Spacing,Espacements}.
2309 Référence des propriétés internes:
2310 @rinternals{VerticalAxisGroup},
2311 @rinternals{StaffGrouper}.
2314 @node Espacement des lignes rattachées à des portées
2315 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2316 @translationof Spacing of non-staff lines
2318 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2319 @code{ChordNames} sont des contextes dont les objets de rendu sont
2320 gravés à l'instar des portées -- une ligne horizontale dans un système.
2321 En fait, les lignes de non-portée sont des contextes qui vont créer un
2322 objet de rendu @code{VerticalAxisGroup}.
2324 L'espacement des lignes de non-portée est géré par les propriétés
2328 @item Propriétés du @code{VerticalAxisGroup} :
2330 @item @code{staff-affinity}
2331 @item @code{nonstaff-relatedstaff-spacing}
2332 @item @code{nonstaff-nonstaff-spacing}
2333 @item @code{nonstaff-unrelatedstaff-spacing}
2337 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2338 @ref{Propriétés d'espacement au sein d'un système}.
2340 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2341 pour gérer l'espacement entre des lignes consécutives de non-portée.
2342 Vous noterez que la valeur élevée attribuée à la clé
2343 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2345 @lilypond[verbatim,quote,staffsize=16]
2349 \override VerticalAxisGroup
2350 #'nonstaff-nonstaff-spacing #'stretchability = #1000
2357 \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
2360 \override VerticalAxisGroup #'staff-affinity = #UP
2363 \override VerticalAxisGroup #'staff-affinity = #CENTER
2364 } \lyricmode { center }
2366 \override VerticalAxisGroup #'staff-affinity = #DOWN
2367 } \lyricmode { down }
2374 Fichiers d'initialisation :
2375 @file{ly/engraver-init.ly},
2376 @file{scm/define-grobs.scm}.
2379 @rlsrnamed{Spacing,Espacements}.
2381 @c @lsr{spacing,page-spacing.ly},
2382 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2384 Référence des propriétés internes :
2385 @rinternals{Contexts},
2386 @rinternals{VerticalAxisGroup}.
2389 @node Positionnement explicite des portées et systèmes
2390 @subsection Positionnement explicite des portées et systèmes
2391 @translationof Explicit staff and system positioning
2393 Pour bien comprendre comment fonctionnent les réglages de
2394 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2395 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2396 les différentes mises au point du décalage vertical appliqué aux portées
2397 et systèmes distribués sur une page.
2399 Une autre approche de l'espacement vertical est le recours à
2400 @code{NonMusicalPaperColumn #'line-break-system-details}. Alors que
2401 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2402 @code{NonMusicalPaperColumn #'line-break-system-details} spécifiera le
2403 positionnement vertical absolu sur la page.
2405 @code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
2406 une liste associative de trois mises au point@tie{}:
2409 @item @code{X-offset}
2410 @item @code{Y-offset}
2411 @item @code{alignment-distances}
2414 Les dérogations en matière d'objet graphique, y compris celles
2415 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2416 à trois différents endroits de votre fichier source@tie{}:
2419 @item directement au beau milieu des notes
2420 @item au sein d'un bloc @code{\context}
2421 @item dans un bloc @code{\with}
2424 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2425 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2426 @code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
2427 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2428 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2429 de la commande @code{\overrideProperty}@tie{}:
2432 \overrideProperty NonMusicalPaperColumn
2433 #'line-break-system-details #'((X-offset . 20))
2435 \overrideProperty NonMusicalPaperColumn
2436 #'line-break-system-details #'((Y-offset . 40))
2438 \overrideProperty NonMusicalPaperColumn
2439 #'line-break-system-details #'((X-offset . 20)
2442 \overrideProperty NonMusicalPaperColumn
2443 #'line-break-system-details #'((alignment-distances . (15)))
2445 \overrideProperty NonMusicalPaperColumn
2446 #'line-break-system-details #'((X-offset . 20)
2448 (alignment-distances . (15)))
2451 Nous allons maintenant voir ces différents réglages en action.
2452 Commençons par examiner un exemple dépourvu de toute mise au point.
2454 @c \book { } is required in these examples to ensure the spacing
2455 @c overrides can be seen between systems. -np
2457 @lilypond[verbatim,quote,staffsize=16]
2458 \header { tagline = ##f }
2459 \paper { left-margin = 0\mm }
2469 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2472 \repeat unfold 15 { d'4 d' d' d' }
2479 Cette partition isole les informations de saut de ligne ou de page dans
2480 une voix spécifique. La mise en forme est ainsi séparée des événements
2481 musicaux@tie{}; ceci nous permettra d'y voir plus clair au fur et à
2482 mesure que nous avancerons. Pour plus de précisions, relisez
2483 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2485 Les @code{\breaks} explicites répartissent la musique en lignes de cinq
2486 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2487 par défaut. Nous pouvons, afin de fixer explicitement le point
2488 d'attache vertical de chacun des systèmes, définir un doublet
2489 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2490 de l'objet @code{NonMusicalPaperColumn}@tie{}:
2492 @lilypond[verbatim,quote,staffsize=16]
2493 \header { tagline = ##f }
2494 \paper { left-margin = 0\mm }
2500 \overrideProperty #"Score.NonMusicalPaperColumn"
2501 #'line-break-system-details #'((Y-offset . 0))
2503 \overrideProperty #"Score.NonMusicalPaperColumn"
2504 #'line-break-system-details #'((Y-offset . 40))
2506 \overrideProperty #"Score.NonMusicalPaperColumn"
2507 #'line-break-system-details #'((Y-offset . 80))
2510 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2513 \repeat unfold 15 { d'4 d' d' d' }
2520 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2521 si la liste associative de @code{line-break-system-details} peut en
2522 comporter un certain nombre. Vous aurez aussi noté que la propriété
2523 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2526 Maintenant que chaque système est explicitement positionné, nous pouvons
2527 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2528 à la sous-propriété @code{alignment-distances} de
2529 @code{line-break-system-details}.
2531 @lilypond[verbatim,quote,staffsize=16]
2532 \header { tagline = ##f }
2533 \paper { left-margin = 0\mm }
2539 \overrideProperty #"Score.NonMusicalPaperColumn"
2540 #'line-break-system-details #'((Y-offset . 20)
2541 (alignment-distances . (15)))
2543 \overrideProperty #"Score.NonMusicalPaperColumn"
2544 #'line-break-system-details #'((Y-offset . 60)
2545 (alignment-distances . (15)))
2547 \overrideProperty #"Score.NonMusicalPaperColumn"
2548 #'line-break-system-details #'((Y-offset . 100)
2549 (alignment-distances . (15)))
2552 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2555 \repeat unfold 15 { d'4 d' d' d' }
2562 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2563 @code{line-break-system-details} de l'objet
2564 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2565 prendre bien d'autres paramètres d'espacement, y compris un doublet
2566 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2567 @code{alignment-distances} pour contrôler le positionnement de chaque
2568 système et de chaque portée. Vous noterez enfin que
2569 @code{alignment-distances} traite le positionnement des portées, non
2570 d'un regroupement de portées.
2572 @lilypond[verbatim,quote,staffsize=16]
2573 \header { tagline = ##f }
2574 \paper { left-margin = 0\mm }
2580 \overrideProperty #"Score.NonMusicalPaperColumn"
2581 #'line-break-system-details #'((Y-offset . 0)
2582 (alignment-distances . (30 10)))
2584 \overrideProperty #"Score.NonMusicalPaperColumn"
2585 #'line-break-system-details #'((Y-offset . 60)
2586 (alignment-distances . (10 10)))
2588 \overrideProperty #"Score.NonMusicalPaperColumn"
2589 #'line-break-system-details #'((Y-offset . 100)
2590 (alignment-distances . (10 30)))
2593 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2596 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2597 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2604 Quelques points à prendre en considération@tie{}:
2608 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2609 autres lignes de non-portée ne comptent pas pour une portée.
2612 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2613 @code{alignment-distances} sont considérés comme des multiples de la
2614 distance entre des portées adjacentes. Des valeurs positives remontent
2615 les portées et paroles, des valeurs négatives les descendent.
2618 Dans la mesure où @code{NonMusicalPaperColumn
2619 #'line-break-system-details} permet de positionner systèmes et portées
2620 n'importe où sur une page, vous pourriez être en contradiction avec les
2621 dimensionnements de la feuille ou bien aboutir à des surimpressions.
2622 Soyez donc raisonnables quant aux différentes valeurs que vous affectez
2630 @rlsrnamed{Spacing,Espacements}.
2633 @node Résolution des collisions verticales
2634 @subsection Résolution des collisions verticales
2635 @translationof Vertical collision avoidance
2637 @funindex outside-staff-priority
2638 @funindex outside-staff-padding
2639 @funindex outside-staff-horizontal-padding
2641 Vous savez de manière intuitive qu'un certain nombre d'objets en
2642 matière de notation musicale appartiennent à la portée, et que
2643 d'autres se placent en dehors de la portée. Entre autres objets
2644 externes, nous avons les marques repères, les textes et les
2645 nuances@tie{}; nous les appellerons @qq{objets extérieurs à la portée}.
2646 La règle qu'applique LilyPond pour positionner verticalement ces
2647 objets extérieurs consiste à les placer au plus près de la portée
2648 tout en prenant garde d'éviter qu'il y ait chevauchement.
2650 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2651 déterminer si un objet est ou non un objet extérieur à la portée@tie{}:
2652 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2653 s'agit d'un objet extérieur à la portée. De plus, la propriété
2654 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2655 objets doivent être disposés.
2657 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2658 Les objets extérieurs à la portée sont alors triés selon l'ordre
2659 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2660 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2661 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2662 lorsque deux objets devraient se placer au même endroit, celui dont la
2663 @code{outside-staff-priority} est la plus faible sera disposé au plus
2666 @lilypond[quote,ragged-right,relative=2,verbatim]
2669 \once \override TextScript #'outside-staff-priority = #1
2670 c4_"Text"\pp % this time the text will be closer to the staff
2672 % by setting outside-staff-priority to a non-number,
2673 % we disable the automatic collision avoidance
2674 \once \override TextScript #'outside-staff-priority = ##f
2675 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2676 c4_"Text"\pp % now they will collide
2679 Le décalage vertical entre un objet extérieur à la portée et celui qui
2680 le précède se contrôle par la propriété @code{outside-staff-padding}.
2683 @lilypond[quote,ragged-right,relative=2,verbatim]
2684 \once \override TextScript #'outside-staff-padding = #0
2685 a'^"Ce texte est placé au plus près de la note"
2686 \once \override TextScript #'outside-staff-padding = #3
2687 c^"Ce texte est décalé par rapport au texte précédent"
2688 c^"Ce texte est accolé au texte précédent"
2691 Par défaut, les objets extérieurs à la portée sont positionnés en
2692 évitant les collisions horizontales avec des objets précédemment
2693 positionnés. Ceci peut cependant générer des situations où des objets
2694 se trouvent horizontalement trop proches. L'espacement vertical entre
2695 les portées peut dans une certaine mesure permettre de mieux intercaler
2696 les objets extérieurs à la portée. La propriété
2697 @code{outside-staff-horizontal-padding} repoussera verticalement un
2698 objet pour éviter ce genre de situation.
2700 @lilypond[quote,ragged-right,relative=2,verbatim]
2701 % the markup is too close to the following note
2705 % setting outside-staff-horizontal-padding fixes this
2707 \once \override TextScript #'outside-staff-horizontal-padding = #1
2716 @rlsrnamed{Spacing,Espacements}.
2719 @node Espacement horizontal
2720 @section Espacement horizontal
2721 @translationof Horizontal spacing
2723 @cindex horizontal, espacement
2724 @cindex espacement horizontal
2727 * Généralités sur l'espacement horizontal::
2728 * Changement d'espacement en cours de partition::
2729 * Modification de l'espacement horizontal::
2730 * Longueur de ligne::
2731 * Notation proportionnelle::
2734 @node Généralités sur l'espacement horizontal
2735 @subsection Généralités sur l'espacement horizontal
2736 @translationof Horizontal spacing overview
2738 Le moteur d'espacement traduit les différences de durée en distances
2739 étirables (@emph{springs} pour ressorts) de différente longueur. Des
2740 durées importantes prennent ainsi plus de place que des durées moins
2741 longues. Les durées les plus courtes se verront attribuer un espace
2742 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2743 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2744 plus elle prendra d'espace@tie{}: le doublement d'une durée attribuera à
2745 la note un espace fixé d'après la propriété @code{spacing-increment}.
2747 L'exemple suivant comporte des blanches, des noires et un certain nombre
2748 de croches. La croche est suivie d'un espace de la largeur d'une tête
2749 de note@tie{}; pour la noire , cette espace est de deux têtes@tie{}; il
2750 est de trois pour la blanche.
2752 @lilypond[quote,verbatim,relative=1]
2753 c2 c4. c8 c4. c8 c4. c8 c8
2757 @code{spacing-increment} est normalement défini à 1,2@tie{}espace de
2758 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2759 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2760 s'étendra donc sur l'équivalent de 2,4@tie{}espaces de portée (2 fois le
2761 @code{spacing-increment}). Le point de départ de cet espace se situe à
2762 l'extrémité gauche du symbole@tie{}; la note la plus courte est donc
2763 suivie en général d'un espace égal à la largeur d'une tête de note.
2765 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2766 croche à une partition qui comporte déjà des croches et des doubles
2767 augmentera considérablement son volume@tie{}: la durée la plus
2768 courte n'est plus la double mais la triple croche, ce qui aura
2769 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2770 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2771 courte prise en considération au niveau de l'espacement n'est pas la
2772 note la plus brève de la partition, mais celle qui apparaît le plus
2775 La courte durée la plus fréquente est déterminée à partir de la note la
2776 plus courte de chaque mesure. C'est elle qui servira de base pour
2777 l'espacement, à cette nuance près que la plus courte durée ne saurait
2778 être strictement supérieure à la croche. Cette @qq{durée de référence}
2779 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2782 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2783 pour les espacements grâce à la propriété
2784 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2785 La durée maximale de cet étalon, normalement la croche, est gérée par la
2786 propriété @code{base-shortest-duration}.
2788 @funindex common-shortest-duration
2789 @funindex base-shortest-duration
2790 @funindex stem-spacing-correction
2793 Les notes plus courtes que la note témoin sont suivies d'un espace
2794 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2795 doubles croches à l'exemple précédent, elles seraient suivies d'une
2796 demie largeur de tête@tie{}:
2798 @lilypond[quote,verbatim,relative=2]
2799 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2803 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2804 vu comment la direction des hampes peut influencer l'espacement -- voir
2805 @ressay{Espacement}. Ceci est contrôlé par la propriété
2806 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2807 pour chaque contexte @rinternals{Voice}. L'objet
2808 @rinternals{StaffSpacing}, généré au niveau d'un contexte @code{Staff},
2809 possède une même propriété qui contrôlera l'espacement hampe-barre de
2810 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2811 les réglages par défaut, puis avec des corrections forcées.
2813 @lilypond[quote,ragged-right]
2817 \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2818 \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2824 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
2825 @rusernamed{Notation proportionnelle,rubrique dédiée}.
2830 @rlsrnamed{Spacing,Espacements}.
2832 Référence des propriétés internes :
2833 @rinternals{SpacingSpanner},
2834 @rinternals{NoteSpacing},
2835 @rinternals{StaffSpacing},
2836 @rinternals{NonMusicalPaperColumn}.
2841 Il n'existe pas de mécanisme simple simple et efficace qui permette de
2842 forcer manuellement l'espacement. La solution ci-dessous permet
2843 cependant @qq{d'aérer} artificiellement une partition@tie{}; il vous
2844 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
2847 \override Score.NonMusicalPaperColumn #'padding = #10
2850 Il n'y a aucun moyen de diminuer l'espacement.
2853 @node Changement d'espacement en cours de partition
2854 @subsection Changement d'espacement en cours de partition
2855 @translationof New spacing area
2857 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
2858 substantiellement la notion de valeur brève et valeur longue. La
2859 commande @code{newSpacingSection} permet alors de réinitialiser les
2860 paramètres d'espacement.
2862 Dans l'exemple qui suit, le changement de métrique marque le début
2863 d'une nouvelle partie@tie{}; remarquez comme les doubles-croches sont
2864 alors plus espacées@tie{}:
2866 @lilypond[relative,verbatim,quote]
2869 c8 c c4 c16[ c c8] c4
2875 La commande @code{\newSpacingSection} crée un nouvel objet
2876 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
2877 @code{\override}s à partir de ce point.
2882 @rlsrnamed{Spacing,Espacements}.
2884 Référence des propriétés internes :
2885 @rinternals{SpacingSpanner}.
2888 @node Modification de l'espacement horizontal
2889 @subsection Modification de l'espacement horizontal
2890 @translationof Changing horizontal spacing
2892 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
2893 @code{base-shortest-duration}. Comparons les deux partitions qui
2894 suivent, toutes deux montrant la même musique. La première partition
2895 applique les réglages par défaut, alors que la seconde bénéficie
2896 d'ajustement de la propriété @code{base-shortest-duration}. Au plus la
2897 valeur de @code{ly:make-moment} est grande, au plus la musique sera
2898 resserrée. En effet, @code{ly:make-moment} construit une durée@tie{}:
2899 @w{@code{1 4}} est plus long que @w{@code{1 16}}.
2901 @lilypond[verbatim,line-width=12\cm]
2904 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2905 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2906 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2907 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2912 @lilypond[verbatim,line-width=12\cm]
2915 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2916 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2917 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2918 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2923 \override SpacingSpanner
2924 #'base-shortest-duration = #(ly:make-moment 1 16)
2933 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
2934 facteurs qui ne sont pas liés à la durée (altération, changement de
2935 clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
2936 permet d'ignorer ces symboles et, par voie de conséquence, forcer
2937 l'espacement sur la simple durée. Notez bien que cette propriété
2938 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
2941 @lilypond[quote,ragged-right,verbatim]
2960 \override SpacingSpanner #'uniform-stretching = ##t
2966 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
2967 les notes sans tenir compte des clefs, barres de mesure ou notes
2968 d'ornement qui pourraient apparaître@tie{}:
2970 @lilypond[quote,ragged-right,relative=2,verbatim]
2971 \override Score.SpacingSpanner #'strict-note-spacing = ##t
2972 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
2978 @rlsrnamed{Spacing,Espacements}.
2981 @node Longueur de ligne
2982 @subsection Longueur de ligne
2983 @translationof Line length
2985 @cindex saut de page
2989 @funindex line-width
2990 @funindex ragged-right
2991 @funindex ragged-last
2993 @c Although line-width can be set in \layout, it should be set in paper
2994 @c block, to get page layout right.
2995 @c Setting indent in \paper block makes not much sense, but it works.
2997 @c Bit verbose and vague, use examples?
2998 Deux réglages de bases ont une influence considérable sur
2999 l'espacement@tie{}: @code{line-width} et @code{indent}. Tous deux se
3000 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3001 lignes et l'indentation de la première.
3003 L'activation du commutateur @code{ragged-right} au sein du bloc
3004 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3005 de les voir s'étirer sur toute la largeur de la page. Cette option est
3006 particulièrement utile lorsque vous traitez de courts fragment, ou bien
3007 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3008 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3012 @cindex vertical spacing
3014 Le fonctionnement de l'option @code{ragged-last} est en tout point
3015 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3016 que la dernière ligne de la partition. Il n'y a pas de restriction
3017 quant à cette ligne. Il en va de même que pour le formatage d'un
3018 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3020 @c Note that for text there are several options for the last line.
3021 @c While Knuth TeX uses natural length, lead typesetters use the same
3022 @c stretch as the previous line. eTeX uses \lastlinefit to
3023 @c interpolate between both these solutions.
3036 @rlsrnamed{Spacing,Espacements}.
3039 @node Notation proportionnelle
3040 @subsection Notation proportionnelle
3041 @translationof Proportional notation
3043 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3044 ce cas de représenter la notation selon un espacement strictement
3045 relatif aux durées. Ce type d'espacement pourrait se comparer à
3046 l'utilisation de papier millimétré pour positionner les notes au fil de
3047 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3048 utilisent cette proportionnalité dans le but de clarifier des structures
3049 rythmiques complexes, d'aider au positionnement d'indications
3050 temporelles ou autres éléments graphiques directement dans la partition.
3052 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3053 s'utiliser conjointement ou individuellement, aux fins de mettre au
3054 point cette notation proportionnelle.
3057 @item @code{proportionalNotationDuration}
3059 @item @code{uniform-stretching}
3061 @item @code{strict-note-spacing}
3063 @item @code{\remove Separating_line_group_engraver}
3065 @item @code{\override PaperColumn #'used = ##t}
3069 Nous allons examiner, dans les différents exemples qui suivent, les
3070 effets de ces réglages et comment ils interagissent.
3072 Commençons par cette mesure toute simple qui utilise l'espacement
3073 classique et justifiée à gauche.
3075 @lilypond[quote,verbatim,ragged-right]
3078 \new RhythmicStaff {
3082 c'16 c'16 c'16 c'16 c'16
3089 Vous constatez que la blanche qui entame la mesure prend moins de la
3090 moitié de l'espace. De même, les doubles croches et le quintolet de
3091 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3092 n'en occupent pas la moitié de l'espace horizontal.
3094 En matière de gravure traditionnelle, cet espacement correspond tout à
3095 fait à nos attentes, puisque nous pouvons rogner l'espace sur la
3096 blanche et ainsi en gagner en largeur sur toute la mesure qui fait une
3099 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3100 un autre graphisme en surplomb ou en dessous de notre partition, nous
3101 aurons besoin de la notation proportionnelle. Celle-ci s'active an
3102 définissant la propriété @code{proportionalNotationDuration}.
3104 @lilypond[quote,verbatim,ragged-right]
3107 \new RhythmicStaff {
3111 c'16 c'16 c'16 c'16 c'16
3118 proportionalNotationDuration = #(ly:make-moment 1 20)
3124 La blanche du début et les notes plus rapides de la deuxième moitié de
3125 la mesure occupent maintenant exactement le même espace horizontal.
3126 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3127 temporelle ou autre graphisme.
3130 @code{proportionalNotationDuration} est une propriété attachée au
3131 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3132 propriétés d'un contexte à trois différents endroits de votre
3133 fichier@tie{}: dans un bloc @code{\with}, dans un bloc @code{\context}
3134 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3135 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3136 de ces trois façons, à l'instar de n'importe quel définition de
3139 La propriété @code{proportionalNotationDuration} prend en unique
3140 argument la durée de référence qui servira de base pour espacer toute la
3141 musique. La fonction scheme @code{make-moment} intégrée à LilyPond
3142 prend deux arguments@tie{}: un numérateur et un dénominateur qui
3143 représentent une fraction de ronde. L'appel de
3144 @w{@code{#(ly:make-moment 1 20)}} produit donc une durée de référence
3145 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3146 @code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} ou
3147 @code{#(ly:make-moment 3 97)}.
3149 Se pose alors le problème de fournir la juste durée de référence à
3150 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3151 tâtonnement, en commençant par une valeur proche de la note la plus
3152 rapide (la durée la plus courte) du morceau. Au plus la durée de
3153 référence est petite, au plus la musique sera étalée@tie{}; à l'inverse,
3154 une durée de référence élevée produira une musique resserrée.
3156 @lilypond[quote,verbatim,ragged-right]
3159 \new RhythmicStaff {
3163 c'16 c'16 c'16 c'16 c'16
3170 proportionalNotationDuration = #(ly:make-moment 1 8)
3177 \new RhythmicStaff {
3181 c'16 c'16 c'16 c'16 c'16
3188 proportionalNotationDuration = #(ly:make-moment 1 16)
3195 \new RhythmicStaff {
3199 c'16 c'16 c'16 c'16 c'16
3206 proportionalNotationDuration = #(ly:make-moment 1 32)
3212 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3213 comme la croche pour la première ligne, a pour conséquence de resserrer
3214 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3215 remarquez aussi que , par principe, la notation proportionnelle occupe
3216 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3217 notation proportionnelle met en évidence le rythme au détriment de
3218 l'espacement horizontal.
3220 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3223 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3224 ajoutons lui une portée incluant un autre type de nolet.
3226 @lilypond[quote,verbatim,ragged-right]
3229 \new RhythmicStaff {
3233 c'16 c'16 c'16 c'16 c'16
3236 \new RhythmicStaff {
3238 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3245 L'espacement est loin d'être idéal, pour la simple raison que
3246 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3247 uniformément. Il est vrai que de telles constructions complexes en
3248 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3249 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3250 @code{proportionalNotationDuration} permet d'arranger les choses.
3252 @lilypond[quote,verbatim,ragged-right]
3255 \new RhythmicStaff {
3259 c'16 c'16 c'16 c'16 c'16
3262 \new RhythmicStaff {
3264 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3271 proportionalNotationDuration = #(ly:make-moment 1 20)
3277 Cependant, si l'on observe de près, il est évident que les notes de la
3278 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3279 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3280 allons activer le @code{uniform-stretching}, propriété attachée au
3281 @code{SpacingSpanner}.
3283 @lilypond[quote,verbatim,ragged-right]
3286 \new RhythmicStaff {
3290 c'16 c'16 c'16 c'16 c'16
3293 \new RhythmicStaff {
3295 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3302 proportionalNotationDuration = #(ly:make-moment 1 20)
3303 \override SpacingSpanner #'uniform-stretching = ##t
3309 L'espacement sur les deux portées est maintenant correct, les relations
3310 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3311 une indication temporelle ou autre graphisme selon notre envie.
3313 Notez bien que la prise en charge de la notation proportionnelle par
3314 LilyPond demande que, dans chaque partition, soit activée la propriété
3315 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3316 contraire, utiliser @code{proportionalNotationDuration} aura pour
3317 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3318 inséré des silences invisibles @emph{skip}.
3320 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3321 au contexte @code{Score}. Tout comme pour la propriété
3322 @code{proportionalNotationDuration}, les réglages du
3323 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3324 votre fichier@tie{}: dans un bloc @code{\with}, dans un bloc
3325 @code{\context} ou au beau milieu de la musique à l'aide de la
3326 commande @code{\set}.
3328 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3329 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3330 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3331 partition. Vous pourriez toutefois avoir besoin de modifier ce
3332 comportement en cours de partition, et recourir alors à l'instruction
3333 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3334 rubrique @ref{Changement d'espacement en cours de partition}.
3337 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3338 qui est désactivé pour la plupart des partitions en notation
3339 proportionnelle. Voici ce qui apparaît dans une partition
3340 traditionnelle@tie{}: il y a toujours un @qq{espace préservé} juste
3341 avant la première note de chaque portée.
3343 @lilypond[quote,verbatim,ragged-right]
3355 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3356 présent lorsqu'intervient un changement de métrique, d'armure ou de
3357 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3358 réduire cet espace à zéro.
3360 @lilypond[quote,verbatim,ragged-right]
3366 \remove Separating_line_group_engraver
3374 Les éléments non musicaux tels que métrique, armure et clef, posent
3375 problème lorsqu'on travaille en notation proportionnelle. Bien
3376 qu'aucune notion de durée ne leur soit attachée, ces éléments
3377 @qq{consomment} de l'espace. Différentes approches permettent
3378 cependant de gérer ce problème.
3380 Éviter les problèmes d'espacement avec l'armure est chose aisée@tie{}:
3381 il suffit qu'il n'y en ait pas@tie{}! C'est bien souvent le cas en
3382 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3383 proportionnelle. Il en va de même pour la métrique, et tout
3384 particulièrement lorsque la partition comporte un quadrillage temporel
3385 ou autres graphismes. L'absence de métrique reste cependant
3386 exceptionnelle et la plupart des partitions en notation proportionnelle
3387 laissent apparaître quelques métriques. Il est par contre pratiquement
3388 impossible de se passer de clef et d'altération.
3390 L'une des options permettant de s'affranchir de l'espacement dû aux
3391 éléments non musicaux consiste en l'activation de la propriété
3392 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3393 les deux portées suivantes@tie{}:
3395 @lilypond[quote,verbatim,ragged-right]
3397 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3407 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3408 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3418 Toutes deux affichent un espacement proportionnel. Cependant, la
3419 première ligne laisse apparaître un espacement plus lâche en raison de
3420 la présence d'un changement de clef. En ce qui concerne la deuxième
3421 ligne, l'espacement est strictement observé dès lors que la propriété
3422 @code{strict-note-spacing} a préalablement été activée. Comme vous
3423 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3424 conséquence que l'algorithme d'espacement ignore tout bonnement la
3425 largeur des métriques, armures, clefs et altérations.
3427 En plus ceux que nous venons de voir, vous trouverez d'autres réglages
3428 en usage dans la notation proportionnelle comme, entre autres,
3431 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3432 @item @code{tupletFullLength = ##t}
3433 @item @code{\override Beam #'breakable = ##t}
3434 @item @code{\override Glissando #'breakable = ##t}
3435 @item @code{\override TextSpanner #'breakable = ##t}
3436 @item @code{\remove Forbid_line_break_engraver (dans un contexte de voix}
3439 Ces différents réglages permettent un espacement strict des notes
3440 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3441 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3442 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3443 différentes rubriques associées du manuel pour chacun de ces réglages.
3447 Manuel de notation :
3448 @ref{Changement d'espacement en cours de partition}.
3451 @rlsrnamed{Spacing,Espacements}.
3454 @node Réduction du nombre de pages de la partition
3455 @section Réduction du nombre de pages de la partition
3456 @translationof Fitting music onto fewer pages
3458 Vous pourriez un jour être confronté au problème suiven@tie{}: l'une
3459 des pages de votre partition ne comporte que deux portées alors que --
3460 ce qui est d'autant plus frustrant -- l'espace libre sur les autres
3461 pages aurait permis une distribution différente.
3463 L'instruction @code{annotate-spacing} se révèle être un outil
3464 indispensable pour pour l'analyse des problèmes de mise en forme. Cette
3465 commande met en surimpression la valeur des différentes variables
3466 d'espacement et de mise en forme, comme nous allons le voir dans la
3467 rubrique @ref{Mise en évidence de l'espacement}.
3470 * Mise en évidence de l'espacement::
3471 * Modification de l'espacement::
3474 @node Mise en évidence de l'espacement
3475 @subsection Mise en évidence de l'espacement
3476 @translationof Displaying spacing
3478 @funindex annotate-spacing
3479 @cindex espacement, affichage des valeurs
3481 Le meilleur moyen d'appréhender les différentes variables de
3482 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3483 la mise en page, consiste à activer, au sein du bloc @code{\paper}, la
3484 fonction @code{annotate-spacing}@tie{}:
3486 @c need to have \book{} otherwise we get the separate systems. -hwn
3487 @lilypond[verbatim,quote]
3488 #(set-default-paper-size "a6" 'landscape)
3491 \paper { annotate-spacing = ##t }
3496 Toutes les dimensions sont exprimées en espace de portée
3497 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3498 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3499 feuille (@code{paper-height}) est de 59,75@tie{}espaces de portée
3500 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3501 20@tie{}points -- sa valeur par défaut. Notez que@tie{}:
3503 @multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
3506 @tab = (25,4/72,27) mm
3509 @tab = (@code{staff-size})/4 pts
3511 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3516 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3517 1,757@tie{}millimètres. Les 59,75@tie{}@code{staff-spaces} de
3518 @code{paper-height} correspondent donc à 105@tie{}millimètres, soit la
3519 hauteur d'une feuille au format A6 à l'italienne. Les paires
3520 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3521 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3525 Manuel de notation :
3526 @ref{Définition de la taille de portée}.
3529 @rlsrnamed{Spacing,Espacements}.
3532 @node Modification de l'espacement
3533 @subsection Modification de l'espacement
3534 @translationof Changing spacing
3536 Les informations fournies par @code{annotate-spacing} en matière de
3537 dimensionnement vertical sont incomparables. Pour plus de détails sur
3538 les manières de modifier marges et autres variables connexes, consultez
3539 la rubrique @ref{Mise en forme de la page}.
3541 En dehors des marges, vous disposez de quelques moyens supplémentaires
3542 pour gagner de l'espace@tie{}:
3546 Rapprocher les systèmes le plus possible les uns des autres, de telle
3547 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3548 suffisamment pour éviter le blanc en bas de page.
3552 system-system-spacing = #'((padding . 0) (basic-distance . 0.1))
3553 ragged-last-bottom = ##f
3559 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3560 deux titres. D'une part, le fait de définir un nombre de systèmes --
3561 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3562 systèmes par page dans la mesure où l'une des étapes d'estimation des
3563 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3564 systèmes par page permet d'en disposer plus sur les suivantes. Par
3565 exemple, avec un nombre par défaut de 11@tie{}systèmes par pages,
3566 l'instruction suivante le force à 10.
3575 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3576 Par exemple, un crochet de reprise ou d'alternative consomme de
3577 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3578 diminue d'autant l'espace disponible que si seul le premier ne
3579 comportait l'indication. Autre exemple, les indications de nuance qui
3580 se @qq{détachent} d'un système peuvent être rapprochés de la portée@tie{}:
3582 @lilypond[verbatim,quote,relative=1]
3584 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3588 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3589 comme indiqué à la rubrique
3590 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3591 l'espacement par défaut@tie{}:
3593 @lilypond[verbatim,quote]
3606 Par contre, le fait de modifier la valeur de la propriété
3607 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3608 -- bien que la noire soit la durée la plus courante, nous prenons une
3609 valeur plus longue -- donnera un effet @qq{resserré} à la musique@tie{}:
3611 @lilypond[verbatim,quote]
3623 \override SpacingSpanner
3624 #'common-shortest-duration = #(ly:make-moment 1 2)
3631 La propriété @code{common-shortest-duration} ne peut être modifiée
3632 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3633 s'applique à l'intégralité de la partition.
3639 Manuel de notation :
3640 @ref{Mise en forme de la page},
3641 @ref{Modification de l'espacement horizontal}.
3644 @rlsrnamed{Spacing,Espacements}.