1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58
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 ligne 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 et pieds de page ainsi que des 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 the paper size
228 LilyPond génère par défaut, et en l'absence de mention explicite d'un
229 format de papier, un fichier imprimable au format@tie{}A4. Vous pouvez
230 cependant utiliser un autre format à l'aide des deux fonctions
231 @code{set-default-paper-size},
233 @code{set-paper-size} se place à l'intérieur d'un bloc
237 #(set-default-paper-size "quarto")
240 qui se place en début de fichier, ou @code{set-paper-size},
244 #(set-paper-size "tabloid")
248 qui s'inscrit au sein d'un bloc @code{\paper}.
252 La seule restriction à l'utilisation isolée de la fonction
253 @code{set-default-paper-size} est qu'elle doit intervenir avant le
254 premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
255 format pour toutes les pages, alors que @code{set-paper-size} détermine
256 le format des feuilles rattachées à un bloc @code{\paper} particulier.
257 Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
258 format du papier s'appliquera à toutes les pages@tie{}; si @code{\paper}
259 apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
260 @emph{book} en question.
262 À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
263 doit intervenir avant toute autre variable. Les raisons à ceci sont
264 abordées dans la rubrique @ref{Adaptation automatique au format}.
266 Différents formats de papier sont définis dans le fichier
267 @file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
268 format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
271 @c An appendix entry exists for paper sizes but is not auto-generated
273 La commande suivante, inscrite dans votre fichier, vous permettra
274 d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
275 appel à l'aide des fonctions @code{set-default-paper-size} et
276 @code{set-paper-size}@tie{}:
279 #(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
282 #(set-paper-size "mon format")
286 Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
287 @code{cm} (centimètres) ou en @code{mm} (millimètres).
289 @cindex papier, orientation
290 @cindex landscape, papier
291 @cindex paysage, papier
292 @cindex à l'italienne, papier
294 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
295 stipulant le format du papier, permet d'obtenir une présentation à
296 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
300 #(set-default-paper-size "a6" 'landscape)
303 C'est bien la feuille qui sera basculée, et non la musique.
307 @ref{Adaptation automatique au format},
308 @ref{Formats de papier prédéfinis}.
310 Fichiers d'initialisation :
311 @file{scm/paper.scm}.
314 @node Adaptation automatique au format
315 @unnumberedsubsubsec Adaptation automatique au format
316 @translationof Automatic scaling to paper size
318 Toute modification du format de papier à l'aide des fonctions Scheme
319 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
320 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
321 par l'ajustement d'un certain nombre de variables attachées au bloc
322 @code{\paper} afin qu'elles soient en concordance avec le format
323 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
324 particulière en redéfinissant sa valeur après avoir spécifié le format
325 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
326 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
327 l'étalonnage automatique, bien que spécifier une largeur de papier
328 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
329 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
330 voir avec la mise à l'échelle.
332 L'adaptation automatique affecte les dimensionnements verticaux
333 @code{top-margin} et @code{bottom-margin} -- voir
334 @ref{Variables d'espacement vertical fixe} --, ainsi que les
335 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
336 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
337 @code{indent} et @code{short-indent} -- voir
338 @ref{Variables d'espacement horizontal}.
340 Les valeurs par défaut de ces dimensionnements sont contenues dans le
341 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
342 internes @code{top-margin-default}, @code{bottom-margin-default} etc.
343 correspondant au format par défaut -- papier A4 -- pour lequel
344 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
349 @ref{Variables d'espacement vertical fixe},
350 @ref{Variables d'espacement horizontal}.
352 Fichiers d'initialisation :
353 @file{ly/paper-defaults-init.ly},
354 @file{scm/paper.scm}.
357 @node Variables d'espacement vertical fixe
358 @subsection Variables d'espacement vertical fixe
359 @translationof Fixed vertical spacing @code{\paper} variables
361 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
362 sont automatiquement ajustés selon le format du papier, ce qui peut
363 conduire à un résultat inattendu --
364 voir @ref{Adaptation automatique au format}.}
366 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
367 @file{ly/paper-defaults-init.ly}.
371 @funindex paper-height
373 La hauteur de la feuille. Il s'agit par défaut de la dimension du
374 papier utilisé. Notez bien que cette variable n'affectera pas
375 l'ajustement automatique d'un certain nombre de dimensionnements
381 La marge entre le bord supérieur de la feuille et la surface imprimable.
382 Elle est fixée par défaut à@tie{}@code{5\mm} et s'ajustera selon le
386 @funindex bottom-margin
388 La marge entre la surface imprimable et le bord inférieur de la feuille.
389 Elle est fixée par défaut à@tie{}@code{6\mm} et s'ajustera selon le
393 @funindex ragged-bottom
395 L'activation de cette variable permet de ne pas répartir verticalement
396 les systèmes sur les pages hormis la dernière. La valeur par défaut
397 est@tie{}@code{#f}. Lorsque la partition ne comporte que deux ou trois
398 systèmes par page, comme pour un conducteur d'orchestre, nous vous
399 conseillons d'activer cette variable.
401 @item ragged-last-bottom
402 @funindex ragged-last-bottom
404 La désactivation de cette variable permet de répartir verticalement les
405 systèmes de la dernière page d'une partition. La valeur par défaut
406 est@tie{}@code{#t}. Nous vous conseillons, lorsque des pièces couvrent
407 deux pages ou plus, de désactiver cette variable.@*
408 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
409 dernière page de chacune des parties -- créées à l'aide d'un bloc
410 @code{\bookpart} -- d'un même ouvrage.
416 @ref{Adaptation automatique au format}.
418 Fichiers d'initialisation :
419 @file{ly/paper-defaults-init.ly}.
422 @rlsrnamed{Spacing, Espacements}.
425 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
426 comme des systèmes à part entière@tie{}; ils seront donc affectés par
427 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
428 ajouteront de l'espace avant le premier système de la partition.
430 La définition explicite d'un format de papier annulera tout réglage des
431 marges haute et basse.
434 @node Variables d'espacement vertical fluctuant
435 @subsection Variables d'espacement vertical fluctuant
436 @translationof Flexible vertical spacing @code{\paper} variables
438 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
439 entre différents éléments (marges, titres, systèmes ou mouvements), en
440 dilatation ou compression selon le cas. Un certain nombre de variables
441 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
442 ces dimensionnements.
444 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
445 parlons ici n'influencent en rien l'espacement des portées d'un même
446 système. L'espacement au sein des systèmes est géré par des propriétés
447 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
448 définissent au niveau du bloc @code{\score} -- voir à ce sujet
449 @ref{Espacement vertical au sein d'un système}.
452 * Structure des variables d'espacement vertical fluctuant::
453 * Liste des variables d'espacement vertical fluctuant::
457 @node Structure des variables d'espacement vertical fluctuant
458 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
459 @translationof Structure of flexible vertical spacing alists
461 Chacune de ces variables attachées au bloc @code{\paper} est constituée
462 d'une liste associative @emph{(alist)} à quatre @i{clés}@tie{}:
467 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
468 par défaut, exprimée en hauteur de portée, séparant les @i{points de
469 référence} de deux éléments, qui évite tout risque de collision en
470 l'absence de dilatation ou compression. Le point de référence d'un
471 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
472 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
473 ligne de @qq{non-portée} viendrait à s'intercaler. Une
474 @code{basic-distance} inférieure à @code{padding} ou
475 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
476 résultant ne saurait être inférieur à @code{padding} ou
477 @code{minimum-distance}.
480 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
481 minimal, exprimé en hauteur de portée, entre les points de référence des
482 deux éléments alors qu'il y a déjà un effet de compression. Une
483 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
484 sans effet, dans la mesure où l'espacement résultant ne saurait être
485 inférieur au @code{padding}.
487 @c TODO: explain skylines somewhere and xref to it from here.
490 @code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
491 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
492 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
493 sur toute la largeur des deux éléments.
496 @code{stretchability} @emph{(dilatation)} -- le coefficient
497 d'étirement de cet espace. Un coefficient nul permet de figer
498 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
499 positif déterminera la propension d'un espacement à s'étirer, tout
500 en tenant compte du coefficient affecté aux autres espacements.
501 Par exemple, lorsque le coefficient de dilatation d'une dimension est
502 double de celui d'une autre, elle pourra s'étirer deux fois plus que
503 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
504 provoque une @code{programming_error} (erreur de programmation) et est
505 ignorée@tie{}; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
506 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
507 sa valeur est par défaut égale à @code{space}. Notez bien que
508 l'utilisateur ne peut définir une propension à la compression@tie{};
509 elle est en fait égale à
510 (@code{basic-distance}@tie{}@minus{}@tie{}@code{minimum-distance}).
514 Lorsque l'impression n'est pas en pleine page -- elle est donc
515 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
516 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
522 @code{basic-distance}, plus
524 @code{minimum-distance} et
526 @code{padding}, augmenté de ce qu'il faut pour éviter les
531 Cependant, lorsque la partition fait plusieurs pages, la dernière page
532 reprendra dans la mesure du possible l'espacement de la page précédente.
534 Les manières de modifier des listes associatives font l'objet d'un
535 @rusernamed{Modification de listes associatives, chapitre spécifique}.
536 L'exemple suivant indique deux façons de modifier une liste associative.
537 La première déclaration intervient sur une seule clé, alors que la
538 deuxième redéfinit complètement la variable.
542 system-system-spacing #'basic-distance = #8
544 score-system-spacing =
546 (basic-distance . 12)
547 (minimum-distance . 6)
548 (stretchability . 12))
553 @node Liste des variables d'espacement vertical fluctuant
554 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
555 @translationof List of flexible vertical spacing @code{\paper} variables
557 Le nom des dimensionnements à hauteur variable sont de la forme
558 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
559 @code{@var{après}} représentent les éléments qui doivent être espacés.
560 La distance s'établit entre les points de référence des deux éléments
561 concernés (voir la rubrique précédente pou plus de précision). Notez
562 bien que, dans les règles de nommage des variables qui suivent, le terme
563 @code{markup} fait référence aussi bien à un @i{markup de titrage}
564 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
565 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
566 distances sont exprimées en espace de portée.
568 Leurs valeurs par défaut sont inscrites dans le fichier
569 @file{ly/paper-defaults-init.ly}.
571 @c TODO: Where do headers/footers fit in? -mp
574 @item markup-system-spacing
575 @funindex markup-system-spacing
577 détermine l'espacement entre un titre ou un @emph{markup} de premier
578 niveau, et le système qui le suit.
580 @item score-markup-spacing
581 @funindex score-markup-spacing
583 détermine l'espacement entre le dernier système et le titre ou
584 @emph{markup} de haut niveau qui le suit.
586 @item score-system-spacing
587 @funindex score-system-spacing
589 détermine l'espacement entre le dernier système d'une partition et le
590 premier système de la partition suivante, en l'absence de titrage ou
591 @emph{markup} qui les sépare.
593 @item system-system-spacing
594 @funindex system-system-spacing
596 détermine l'espacement entre deux systèmes d'un même mouvement.
598 @item markup-markup-spacing
599 @funindex markup-markup-spacing
601 détermine l'espacement entre deux titres ou @emph{markups} de premier
604 @item last-bottom-spacing
605 @funindex last-bottom-spacing
607 détermine la distance entre le dernier système ou le dernier
608 @emph{markup} de haut niveau, et le bas de la surface imprimable --
609 autrement dit le haut de la marge basse.
611 @item top-system-spacing
612 @funindex top-system-spacing
614 détermine l'espace entre le haut de la surface imprimable (le bas de la
615 marge haute) et le milieu du premier système. Cette variable n'est
616 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
619 @item top-markup-spacing
620 @funindex top-markup-spacing
622 détermine l'espace entre le haut de la surface imprimable (le bas de la
623 marge haute) et le premier titre ou @emph{markup} de premier niveau.
624 Cette variable n'est effective qu'en l'absence de système en haut de
631 @ref{Espacement vertical au sein d'un système}.
634 @rlsrnamed{Spacing,Espacements}.
637 @rlsrnamed{Spacing,Espacements}.
640 @node Variables d'espacement horizontal
641 @subsection Variables d'espacement horizontal
642 @translationof Horizontal spacing \paper variables
644 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
645 sont automatiquement ajustés selon le format du papier, ce qui peut
646 conduire à un résultat inattendu --
647 voir @ref{Adaptation automatique au format}.}
650 * Variables de marge et de largeur::
651 * Variables spécifiques pour l'impression recto-verso::
652 * Variables d'indentation et de décalage::
656 @node Variables de marge et de largeur
657 @unnumberedsubsubsec Variables de marge et de largeur
658 @translationof @code{\paper} variables for widths and margins
660 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
661 @file{ly/paper-defaults-init.ly}.
666 @funindex paper-width
668 La largeur de la page. Elle correspond par défaut à la largeur du
669 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
670 matière d'ajustement automatique, cette variable influe sur la variable
671 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
672 @code{paper-width} et @code{line-width}, les valeurs de
673 @code{left-margin} et @code{right-margin} seront recalculées. Voir
674 aussi @code{check-consistency}.
679 la longueur d'un système musical sans indentation et justifiée sur toute
680 la largeur de la page. La valeur par défaut est égale à
681 @code{paper-width}, auquel sont retranchés @code{left-margin} et
682 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
683 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
684 marges seront alors recalculées de telle sorte que les systèmes soient
685 centrés. Voir aussi @code{check-consistency}. La variable
686 @code{line-width} peut se définir aussi dans un bloc @code{\layout}.
689 @funindex left-margin
691 la marge entre le bord gauche de la feuille et le début de chaque
692 système. La valeur par défaut est de@tie{}@code{10\mm}@tie{}; elle sera
693 ajustée selon le format du papier. Lorsque vous définissez
694 @code{line-width} et @code{right-margin}, sans modifier la valeur de
695 @code{left-margin}, cette dernière sera alors égale à
696 @code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}right-margin)}.
697 Lorsque seule @code{line-width} est définie, les deux marges
699 @code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, ce
700 qui a pour effet de centrer les systèmes sur la page. Voir aussi
701 @code{check-consistency}.
704 @funindex right-margin
706 La marge entre le bord droit de la page et la fin des systèmes en pleine
707 largeur (non @emph{ragged}). La valeur par défaut est
708 de@tie{}@code{10\mm} et s'ajustera selon le format du papier. Lorsque
709 vous définissez @code{line-width} et @code{left-margin}, sans modifier
710 la valeur de @code{right-margin}, cette dernière sera alors égale à
711 @code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}left-margin)}.
712 Lorsque seule @code{line-width} est définie, les deux marges
714 @code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, ce
715 qui a pour effet de centrer les systèmes sur la page. Voir aussi
716 @code{check-consistency}.
718 @item check-consistency
719 @funindex check-consistency
721 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
722 @code{line-width} et @code{right-margin} sont en cohérence, et que
723 l'addition de ces trois éléments ne dépassera pas la largeur du papier
724 (@code{paper-width}). La valeur par défaut est@tie{}@code{#t}. Dans
725 le cas d'une incohérence, un message d'avertissement est émis et les
726 trois variables -- marges et longueur de ligne -- rétablies à leur
727 valeur par défaut (ajustées selon le format du papier).
730 @funindex ragged-right
732 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
733 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
734 La valeur par défaut est @code{#f} mais, si la partition ne comporte
735 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
736 se gérer au sein d'un bloc @code{\layout}.
739 @funindex ragged-last
741 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
742 dernier système de façon à occuper toute la longueur de la ligne. La
743 valeur par défaut est@tie{}@code{#f}. Cette variable peut aussi
744 se gérer au sein d'un bloc @code{\layout}.
750 @ref{Adaptation automatique au format}.
752 Fichiers d'initialisation :
753 @file{ly/paper-defaults-init.ly}.
756 La définition explicite d'un format de papier annulera tout réglage des
757 marges gauche et droite.
760 @node Variables spécifiques pour l'impression recto-verso
761 @unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
762 @translationof @code{\paper} variables for two-sided mode
764 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
765 @file{ly/paper-defaults-init.ly}.
775 Cette variable permet de gérer efficacement les impressions recto-verso.
776 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
777 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
778 différentes marges selon qu'il s'agit d'une page paire ou impaire.
779 Cette variable s'applique en lieu et place de @code{left-margin} et
780 @code{right-margin}. La valeur par défaut est@tie{}@code{#f}.
783 @funindex inner-margin
785 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
786 avoir du côté intérieur. Bien entendu, cette variable n'est
787 effective que lorsque vous comptez générer un fichier imprimable en
788 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
789 défaut est de@tie{}@code{10\mm} et s'ajustera selon le format du papier.
792 @funindex outer-margin
794 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
795 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
796 variable n'est effective que lorsque vous comptez générer un fichier
797 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
798 La valeur par défaut est de@tie{}@code{20\mm} et s'ajustera selon le
802 @funindex binding-offset
804 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
805 valeur de la marge intérieure @code{inner-margin} de telle sorte que
806 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
807 effective que lorsque vous comptez générer un fichier imprimable en
808 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
809 défaut est de@tie{}@code{0} et s'ajustera selon le format du papier.
815 @ref{Adaptation automatique au format}.
817 Fichiers d'initialisation :
818 @file{ly/paper-defaults-init.ly}.
821 @node Variables d'indentation et de décalage
822 @unnumberedsubsubsec Variables d'indentation et de décalage
823 @translationof @code{\paper} variables for shifts and indents
825 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
826 @file{ly/paper-defaults-init.ly}.
830 @item horizontal-shift
831 @funindex horizontal-shift
833 @c This default value is buried in the middle of page.scm. -mp
835 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
836 seront poussés d'autant vers la droite. la valeur par défaut est
842 Le niveau d'indentation du premier système d'une partition. La valeur
843 par défaut est de@tie{}@code{15\mm} et s'ajustera selon le format du
844 papier. Cette variable peut aussi se gérer au sein d'un bloc
848 @funindex short-indent
850 Le niveau d'indentation de tous les systèmes hormis le premier. La
851 valeur par défaut est de@tie{}@code{0}, et s'ajustera selon le format du
852 papier dès lors que vous lui affecterez une valeur. Cette variable peut
853 aussi se gérer au sein d'un bloc @code{\layout}.
859 @ref{Adaptation automatique au format}.
861 Fichiers d'initialisation :
862 @file{ly/paper-defaults-init.ly}.
865 @rlsrnamed{Spacing, Espacements}.
868 @node Autres variables du bloc \paper
869 @subsection Autres variables du bloc @code{\paper}
870 @translationof Other @code{\paper} variables
873 * Variables de gestion des sauts de ligne::
874 * Variables de gestion des sauts de page::
875 * Variables de gestion des numéros de page::
876 * Variables supplémentaires::
880 @node Variables de gestion des sauts de ligne
881 @unnumberedsubsubsec Variables de gestion des sauts de ligne
882 @translationof @code{\paper} variables for line breaking
884 @c TODO: Mention that ly:optimal-breaking is on by default? -mp
888 @item max-systems-per-page
889 @funindex max-systems-per-page
891 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
892 variable n'est prise en compte, à ce jour, que par l'option
893 @code{ly:optimal-breaking}, et n'est pas définie.
895 @item min-systems-per-page
896 @funindex min-systems-per-page
898 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
899 cependant aux risques de débordement s'il est trop important. Cette
900 variable n'est prise en compte, à ce jour, que par l'option
901 @code{ly:optimal-breaking}, et n'est pas définie.
903 @item systems-per-page
904 @funindex systems-per-page
906 Le nombre de systèmes que devrait comporter chaque page. Cette variable
907 n'est à ce jour prise en charge que par l'algorithme
908 @code{ly:optimal-breaking} et n'est pas définie par défaut.
911 @funindex system-count
913 Le nombre de systèmes requis par la partition. Cette variable n'est pas
914 définie par défaut. Cette variable peut se gérer au sein d'un bloc
921 @ref{Sauts de ligne}.
924 @node Variables de gestion des sauts de page
925 @unnumberedsubsubsec Variables de gestion des sauts de page
926 @translationof @code{\paper} variables for page breaking
928 Les valeurs par défaut sont définies dans le fichier
929 @file{ly/paper-defaults-init.ly}.
933 @item blank-after-score-page-force
934 @funindex blank-after-score-page-force
936 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
937 valeur est par défaut inférieure à celle de
938 @code{blank-page-force}@tie{}; nous préférons qu'une page blanche
939 s'insère après la fin de la partition plutôt qu'au milieu.
941 @item blank-last-page-force
942 @funindex blank-last-page-force
944 Pénalité pour fin de partition intervenant sur une page impaire. La
945 valeur par défaut est de@tie{}@code{0}.
947 @item blank-page-force
948 @funindex blank-page-force
950 Pénalité pour apparition d'une page blanche en cours de partition.
951 L'algorithme @code{ly:optimal-breaking} n'en tiendra pas compte
952 puisqu'il ne conçoit pas la présence d'une page blanche au milieu d'une
953 partition. La valeur par défaut est de@tie{}@code{5}.
956 @funindex page-breaking
958 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
959 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking} et
960 @code{ly:optimal-breaking}.
962 @item page-breaking-system-system-spacing
963 @funindex page-breaking-system-system-spacing
965 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
966 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
967 lorsque @code{page-breaking-system-system-spacing #'padding} a une
968 valeur nettement supérieure à @code{system-system-spacing #'padding},
969 l'algorithme en question aura tendance à disposer moins de systèmes sur
970 une même page. Cette variable est par défaut non définie.
975 Le nombre de pages que devra comporter la partition. Cette variable est
976 par défaut non définie.
983 @ref{Optimisation des sauts de page},
984 @ref{Optimisation des tournes},
985 @ref{Minimisation des sauts de page}.
987 Fichiers d'initialisation :
988 @file{ly/paper-defaults-init.ly}.
991 @node Variables de gestion des numéros de page
992 @unnumberedsubsubsec Variables de gestion des numéros de page
993 @translationof @code{\paper} variables for page numbering
995 Les valeurs par défaut sont définies dans le fichier
996 @file{ly/paper-defaults-init.ly}.
1000 @item auto-first-page-number
1001 @funindex auto-first-page-number
1003 L'algorithme qui gère les sauts de page prend en compte le fait que le
1004 premier numéro de page soit pair ou impair. Lorsque cette
1005 fonctionnalité est activée, l'algorithme des sauts de page décidera de
1006 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
1007 par un éventuel incrément de un. La valeur par défaut
1010 @item first-page-number
1011 @funindex first-page-number
1013 Le numéro de la première page. La valeur par défaut est
1016 @item print-first-page-number
1017 @funindex print-first-page-number
1019 Cette variable permet d'imprimer le numéro de page y compris sur la
1020 première. La valeur par défaut est@tie{}@code{#f}.
1022 @item print-page-number
1023 @funindex print-page-number
1025 La désactivation de cette variable permet d'obtenir des pages non
1026 numérotées. La valeur par défaut est@tie{}@code{#t}.
1031 Fichiers d'initialisation :
1032 @file{ly/paper-defaults-init.ly}.
1035 Les pages au numéro impair sont toujours à droite. Pour que la musique
1036 commence en page 1, le dos de la page de garde doit être vide de telle
1037 sorte que la page une se retrouve à droite.
1040 @node Variables supplémentaires
1041 @unnumberedsubsubsec Variables supplémentaires
1042 @translationof Miscellaneous @code{\paper} variables
1046 @item page-spacing-weight
1047 @funindex page-spacing-weight
1049 Cette variable définit l'importance relative des espacements entre la
1050 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1051 privilégiera l'espacement au niveau de la page. La valeur par défaut
1052 est de@tie{}@code{10}.
1054 @item print-all-headers
1055 @funindex print-all-headers
1057 Lorsque cette variable est activée, l'intégralité des champs d'entête
1058 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1059 champs @code{piece} et @code{opus}. La valeur par défaut
1062 @item system-separator-markup
1063 @funindex system-separator-markup
1065 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1066 chaque système, comme on le voit dans nombre de partitions orchestrales.
1067 Cette variable n'est pas définie par défaut. La commande
1068 @code{\slashSeparator} -- définie dans le fichier
1069 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1072 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1073 #(set-default-paper-size "a8")
1077 system-separator-markup = \slashSeparator
1083 \relative c'' { c1 \break c1 \break c1 }
1091 Fichiers d'initialisation :
1092 @file{ly/titling-init.ly}.
1095 @rlsrnamed{Spacing,Espacements}.
1098 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1099 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1102 @node Mise en forme de la partition
1103 @section Mise en forme de la partition
1104 @translationof Score layout
1106 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1107 plus particulièrement destinées à gérer la mise en forme de la
1112 * Définition de la taille de portée::
1116 @node Le bloc \layout
1117 @subsection Le bloc @code{\layout}
1118 @translationof The @code{\layout} block
1122 Alors que le bloc @code{\paper} définit le formatage des pages pour
1123 l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
1124 forme spécifique à la partition. La mise en forme de la musique peut
1125 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1126 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1127 où la mise en forme concerne une partition en particulier, un bloc
1128 @code{\layout} se placera au sein du bloc @code{\score} en question.
1129 Sont susceptibles d'apparaître dans un bloc @code{\layout}@tie{}:
1133 la fonction Scheme @code{layout-set-staff-size},
1136 dans des blocs @code{\context}, les modifications apportées aux
1137 différents contextes, et
1140 les variables normalement attachées au bloc @code{\paper} qui
1141 affecteront la mise en forme de la partition.
1145 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1146 suivante, @ref{Définition de la taille de portée}. La modification des
1147 contextes est abordée dans d'autres chapitres -- voir
1148 @ref{Modification des greffons de contexte} et
1149 @ref{Modification des réglages par défaut d'un contexte}. Les variables
1150 du bloc @code{\paper} que l'on peut retrouver dans un bloc
1151 @code{\layout} sont@tie{}:
1156 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1157 (voir @ref{Variables de marge et de largeur})
1160 @code{indent} et @code{short-indent}
1161 (voir @ref{Variables d'indentation et de décalage})
1165 (voir @ref{Variables de gestion des sauts de ligne})
1169 Voici un exemple de bloc @code{\layout} :
1176 \override StaffGrouper #'staff-staff-spacing #space = #8
1180 \override TextScript #'padding = #1
1181 \override Glissando #'thickness = #3
1187 Manuel de notation :
1188 @ref{Modification des réglages par défaut d'un contexte}.
1191 @rlsrnamed{Spacing,Espacements}.
1194 @node Définition de la taille de portée
1195 @subsection Définition de la taille de portée
1196 @translationof Setting the staff size
1198 @cindex fonte, définition de la taille
1199 @cindex portée, définition de la taille
1200 @funindex layout file
1202 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1203 20@tie{}points. Il existe deux manières de la modifier@tie{}:
1205 La taille des portées peut se définir globalement pour toutes les
1206 partitions d'un même fichier, ou plus précisément d'un bloc
1207 @code{\book}, à l'aide de @code{set-global-staff-size}.
1210 #(set-global-staff-size 14)
1214 Ceci définit donc la hauteur des portées à 14@tie{}points par
1215 défaut@tie{}; toutes les fontes seront ajustées en conséquence.
1218 Vous pouvez aussi spécifier une taille à une partition en particulier en
1219 procédant comme ci-dessous@tie{}:
1225 #(layout-set-staff-size 15)
1230 La fonte Feta fournit les symboles musicaux dans huit tailles
1231 différentes. Chaque fonte correspond à une hauteur particulière de
1232 portée@tie{}; les petites tailles comportent des symboles plus épais
1233 pour être cohérent avec l'épaisseur relativement plus importante des
1234 lignes de la portée. Le tableau suivant répertorie les différentes
1238 @multitable @columnfractions .15 .2 .22 .2
1240 @item @b{nom de la fonte}
1241 @tab @b{hauteur de portée (pt)}
1242 @tab @b{hauteur de portée (mm)}
1243 @tab @b{utilisation}
1248 @tab format de poche
1268 @tab carnet de chant
1273 @tab partition standard
1284 @c matériel de location moderne ?
1289 Ces fontes sont disponibles dans toutes les tailles. La propriété de
1290 contexte @code{fontSize} ainsi que la propriété de mise en forme
1291 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1292 individuellement la taille de chaque portée. La taille de chacune des
1293 portées est relative à la taille globale.
1296 Manuel de notation :
1297 @ref{Indication de la taille de fonte musicale}.
1300 @rlsrnamed{Spacing,Espacements}.
1303 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1304 lignes d'une portée.
1309 @translationof Breaks
1314 * Optimisation des sauts de page::
1315 * Optimisation des tournes::
1316 * Minimisation des sauts de page::
1317 * Sauts explicites::
1318 * Recours à une voix supplémentaire pour gérer les sauts::
1322 @node Sauts de ligne
1323 @subsection Sauts de ligne
1324 @translationof Line breaking
1326 @cindex saut de ligne
1327 @cindex ligne, passer à la suivante
1329 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1330 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1331 trop aérée, et que des lignes consécutives aient à peu près la même
1334 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1335 vous le jugez utile pour @qq{forcer} le passage à la ligne
1338 @lilypond[quote,ragged-right,relative=2,verbatim]
1343 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1344 mesure@tie{}; LilyPond vous le signalera par un message si tel était le
1345 cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
1346 barre de mesure, vous devrez auparavant insérer une barre invisible -- à
1347 l'aide de @code{\bar@tie{}""}.
1349 @lilypond[quote,ragged-right,relative=2,verbatim]
1356 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1357 mesure dès lors que la précédente avait une note en suspend -- c'est
1358 typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
1359 L'instruction @code{\break} sera alors opérationnelle si vous avez
1360 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1361 @code{Voice} concerné. Notez bien que les sauts de ligne forcés doivent
1362 être saisis au sein d'une expression polyphonique@tie{}:
1364 @lilypond[quote,ragged-right,verbatim]
1366 \remove Forbid_line_break_engraver
1369 { c2. \times 2/3 { c4 c c } c2. | }
1370 { s1 | \break s1 | }
1375 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1376 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1377 introduire la dérogation @w{@code{\override Beam #'breakable = ##t}}.
1379 @lilypond[quote,ragged-right,relative=2,verbatim]
1380 \override Beam #'breakable = ##t
1385 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1386 saut de ligne à la fin de la mesure où elle est explicitée.
1388 LilyPond dispose de deux variables de base pour influencer l'espacement
1389 au niveau des lignes. Toutes deux se définissent dans un bloc
1390 @code{\layout}, @code{indent} réglant l'indentation de la première
1391 ligne, et @code{line-width} la longueur des lignes.
1393 L'activation du commutateur @code{ragged-right} au sein du bloc
1394 @code{\layout} aura pour effet de terminer les systèmes là où il le
1395 feraient normalement plutôt que de les étirer sur toute la longueur de
1396 la ligne. Ceci est particulièrement utile pour de petits fragments ou
1397 pour vérifier la densité induite par l'espacement naturel.
1399 @c TODO Check and add para on default for ragged-right
1401 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1402 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1412 @cindex sauts de ligne réguliers
1413 @cindex portée à quatre mesures
1415 L'utilisation conjointe de @code{\break} et de blancs dans une section
1416 @code{\repeat} vous permettra de positionner des sauts de ligne à
1417 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1418 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1424 s1 \noBreak s1 \noBreak
1425 s1 \noBreak s1 \break
1427 @{ @var{et ici la musique@dots{}} @}
1432 Apparemment, je ne vois pas de "snippet" qui corresponde,
1433 à moins que ce ne soit pour allécher vers la section
1434 "4.6 Fitting music onto fewer pages" -JCM
1436 A linebreaking configuration can be saved as a @code{.ly} file
1437 automatically. This allows vertical alignments to be stretched to
1438 fit pages in a second formatting run. This is fairly new and
1439 complicated. More details are available in
1451 Manuel de notation :
1452 @ref{Variables de gestion des sauts de ligne}.
1454 Référence des propriétés internes :
1455 @rinternals{LineBreakEvent}.
1458 @rlsrnamed{Spacing,Espacements}.
1462 @subsection Sauts de page
1463 @translationof Page breaking
1465 La gestion automatique des sauts de page se contrôle à l'aide des
1466 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1467 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1468 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1469 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1470 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1473 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1474 trouver à des niveaux supérieurs, entre deux partitions ou
1475 @emph{markups} de premier rang.
1477 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1478 gérer la répartition horizontale, LilyPond dispose de commutateurs
1479 équivalents au niveau de la verticalité@tie{}: @code{ragged-bottom} et
1480 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1481 affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
1482 pages y compris la dernière. Pour de plus amples détails, reportez-vous
1483 à @ref{Variables d'espacement vertical fixe}.
1485 Les sauts de page sont générés par la fonction @code{page-breaking}.
1486 LilyPond dispose de trois différents algorithmes en la matière@tie{}:
1487 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1488 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1489 activé par défaut, mais rien ne vous empêche d'en changer, par
1490 l'intermédiaire du bloc @code{\paper}@tie{}:
1494 page-breaking = #ly:page-turn-breaking
1500 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1501 pages, la gestion des sauts de page finit par devenir très gourmande,
1502 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1503 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1504 sectionner l'ouvrage que vous traitez@tie{}; les sauts de page seront
1505 alors gérés individuellement au niveau de chacune des parties. Par
1506 ailleurs, cela vous autorisera une gestion différente selon les
1512 subtitle = "Préface"
1515 %% Pour une partie constituée principalement de texte
1516 %% ly:minimal-breaking est plus judicieux.
1517 page-breaking = #ly:minimal-breaking
1519 \markup @{ @dots{} @}
1523 %% Cette partie étant purement musicale,
1524 %% retour au style par défaut (optimal-breaking).
1526 subtitle = "Premier mouvement"
1528 \score @{ @dots{} @}
1534 @funindex \pageBreak
1536 @funindex \noPageBreak
1537 @code{\noPageBreak}.
1541 Manuel de notation :
1542 @ref{Variables de gestion des sauts de page}.
1545 @rlsrnamed{Spacing,Espacements}.
1548 @node Optimisation des sauts de page
1549 @subsection Optimisation des sauts de page
1550 @translationof Optimal page breaking
1552 @funindex ly:optimal-breaking
1554 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1555 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1556 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1557 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1558 n'a aucune notion de ce qu'est une @qq{tourne}.
1562 @rlsrnamed{Spacing,Espacements}.
1565 @node Optimisation des tournes
1566 @subsection Optimisation des tournes
1567 @translationof Optimal page turning
1569 @funindex ly:page-turn-breaking
1571 Aboutir à une configuration des sauts de page de telle sorte que les
1572 pages de droite se terminent toujours par un silence devient souvent une
1573 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1574 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1575 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1576 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1577 ne saurait intervenir qu'à certains endroits.
1579 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1580 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1581 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1582 informer la fonction des endroits où les sauts de page sont permis.
1584 Cette deuxième étape se réalise de deux manières différentes. Vous
1585 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1586 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1588 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1589 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1590 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1591 tournes recherchera dans le contexte en question les passages sans note.
1592 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1593 notes@tie{}; autrement dit, il ne restera pas inactif dans le cadre
1594 d'une portée polyphonique dont l'une des parties contiendrait des
1595 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1596 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1597 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1598 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1599 déposera le @code{\allowPageTurn}.
1601 @funindex minimumPageTurnLength
1603 Le @code{Page_turn_engraver} examine la propriété de contexte
1604 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1605 longueur d'un fragment sans note avant une tourne. La valeur par
1606 défaut de @code{minimumPageTurnLength} est
1607 @code{(ly:make-moment@tie{}1@tie{}1)}, soit une ronde, et s'ajuste de
1608 la manière suivante@tie{}:
1611 \new Staff \with @{ \consists "Page_turn_engraver" @}
1614 R1 | % une tourne peut se placer ici
1616 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1617 R1 | % il ne peut pas y avoir de tourne ici
1619 R1*2 | % une tourne peut se placer ici
1624 @funindex minimumRepeatLengthForPageTurn
1626 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1627 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1628 temps au début et à la fin de la reprise pour que l'exécutant ait le
1629 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1630 même capable d'interdire un tourne dans le cas d'une reprise de courte
1631 durée, ajustable au travers de la propriété de contexte
1632 @code{minimumRepeatLengthForPageTurn}.
1634 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1635 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1636 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1641 @funindex \noPageTurn
1643 @funindex \allowPageTurn
1644 @code{\allowPageTurn}.
1649 @rlsrnamed{Spacing,Espacements}.
1652 Une partition ne devrait contenir qu'une seule instance du
1653 @code{Page_turn_engraver}, au risque de se contredire les uns les autres.
1656 @node Minimisation des sauts de page
1657 @subsection Minimisation des sauts de page
1658 @translationof Minimal page breaking
1660 @funindex ly:minimal-breaking
1662 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1663 calculs pour positionner les sauts de page. Elle mettra le plus de
1664 systèmes possible sur une page avant de passer à la suivante. On peut
1665 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1666 lorsque les autres fonctions de gestion des sauts de page ralentissent
1667 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1668 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1669 @code{\paper}@tie{}:
1673 page-breaking = #ly:minimal-breaking
1679 @rlsrnamed{Spacing,Espacements}.
1682 @node Sauts explicites
1683 @subsection Sauts explicites
1684 @translationof Explicit breaks
1686 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1687 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1688 avec ces deux instructions dérogatoires@tie{}:
1691 \override NonMusicalPaperColumn #'line-break-permission = ##f
1692 \override NonMusicalPaperColumn #'page-break-permission = ##f
1695 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1696 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1697 explicite, et nulle part ailleurs. De la même façon, la désactivation
1698 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1699 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1700 nulle part ailleurs.
1702 @lilypond[quote,verbatim]
1709 musique = \relative c'' { c8 c c c }
1713 \repeat unfold 2 { \musique } \break
1714 \repeat unfold 4 { \musique } \break
1715 \repeat unfold 6 { \musique } \break
1716 \repeat unfold 8 { \musique } \pageBreak
1717 \repeat unfold 8 { \musique } \break
1718 \repeat unfold 6 { \musique } \break
1719 \repeat unfold 4 { \musique } \break
1720 \repeat unfold 2 { \musique }
1725 \override NonMusicalPaperColumn #'line-break-permission = ##f
1726 \override NonMusicalPaperColumn #'page-break-permission = ##f
1734 @rlsrnamed{Spacing,Espacements}.
1737 @node Recours à une voix supplémentaire pour gérer les sauts
1738 @subsection Recours à une voix supplémentaire pour gérer les sauts
1739 @translationof Using an extra voice for breaks
1741 La plupart du temps, les informations concernant les sauts de ligne ou
1742 de page se retrouvent directement au milieu des notes.
1745 musique = \relative c'' @{ c4 c c c @}
1749 \repeat unfold 2 @{ \musique @} \break
1750 \repeat unfold 3 @{ \musique @}
1755 Bien que cela constitue un moyen aisé de saisir les commandes
1756 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1757 mélangées à des informations qui concernent plutôt l'agencement de la
1758 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1759 purement musical et les informations concernant les sauts de ligne ou de
1760 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1761 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1762 des @code{\break}, des @code{\pageBreak} et autres informations
1763 concernant les ruptures.
1765 @lilypond[quote,verbatim]
1766 music = \relative c'' { c4 c c c }
1777 \repeat unfold 2 { \music }
1778 \repeat unfold 3 { \music }
1779 \repeat unfold 6 { \music }
1780 \repeat unfold 5 { \music }
1786 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1787 les @code{line-break-system-details} et autres propriétés fort
1788 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1789 le voir au chapitre @ref{Espacement vertical}.
1791 @lilypond[quote,verbatim]
1792 music = \relative c'' { c4 c c c }
1797 \overrideProperty "Score.NonMusicalPaperColumn"
1798 #'line-break-system-details #'((Y-offset . 0))
1801 \overrideProperty "Score.NonMusicalPaperColumn"
1802 #'line-break-system-details #'((Y-offset . 35))
1805 \overrideProperty "Score.NonMusicalPaperColumn"
1806 #'line-break-system-details #'((Y-offset . 70))
1809 \overrideProperty "Score.NonMusicalPaperColumn"
1810 #'line-break-system-details #'((Y-offset . 105))
1814 \repeat unfold 2 { \music }
1815 \repeat unfold 3 { \music }
1816 \repeat unfold 6 { \music }
1817 \repeat unfold 5 { \music }
1824 Manuel de notation :
1825 @ref{Espacement vertical}.
1828 @rlsrnamed{Spacing,Espacements}.
1831 @node Espacement vertical
1832 @section Espacement vertical
1833 @translationof Vertical spacing
1835 @cindex vertical, espacement
1836 @cindex espacement vertical
1838 L'espacement vertical dépend de trois éléments@tie{}: la surface
1839 disponible -- par exemple format de papier et marges --, l'espace qui
1840 doit séparer les systèmes, et l'espace qui sépare les portées d'un même
1844 * Espacement vertical au sein d'un système::
1845 * Positionnement explicite des portées et systèmes::
1846 * Résolution des collisions verticales::
1850 @node Espacement vertical au sein d'un système
1851 @subsection Espacement vertical au sein d'un système
1852 @translationof Flexible vertical spacing within systems
1854 @cindex distance entre les portées
1855 @cindex portées, espacement
1856 @cindex espacement entre les portées
1857 @cindex espacement au sein d'un système
1859 LilyPond dispose de trois différents mécanismes permettant de contrôler
1860 l'espacement au sein d'un système selon trois catégories@tie{}:
1865 @emph{portées isolées},
1868 @emph{portées regroupées} (portées d'un même groupe, telles celles
1869 d'un @code{ChoirStaff}, etc.), et
1872 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
1876 @c TODO: Clarify this. This almost implies that non-staff lines
1877 @c have NO effect on the spacing between staves. -mp
1879 La hauteur de chaque système se détermine en deux phases. Les portées
1880 sont tout d'abord espacées selon la surface disponible. Puis les lignes
1881 autres que des portées, comme les paroles ou les accords, sont réparties
1884 Les paragraphes qui suivent traitent exclusivement de la manière de
1885 gérer l'espacement entre les lignes d'un système -- portée musicale ou
1886 non. Pour ce qui a trait aux espacements entre les systèmes,
1887 mouvements, annotations et marge, ils sont contrôlés par des variables
1888 attachées au bloc @code{\paper} et font l'objet du chapitre
1889 @ref{Variables d'espacement vertical fluctuant}.
1892 * Propriétés d'espacement au sein d'un système::
1893 * Espacement de portées isolées::
1894 * Espacement de portées regroupées::
1895 * Espacement des lignes rattachées à des portées::
1899 @node Propriétés d'espacement au sein d'un système
1900 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
1901 @translationof Within-system spacing properties
1903 L'espacement entre les portées est géré par deux jeux de propriétés
1904 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
1905 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
1906 ou de non-portée. Le second, associé à l'objet graphique
1907 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
1908 de portées particulier. Les propriétés qui leur sont attachées sont
1909 abordées en fin de section.
1911 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
1912 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
1913 @code{@var{item2}} étant les éléments à espacer. Notez bien que
1914 @code{@var{item2}} n'est pas forcément placé au-dessous@tie{}: c'est le
1915 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
1916 la distance entre une ligne de non-portée alors que sa
1917 @code{staff-affinity} a été déterminée à @code{UP}.
1919 Toutes ces distances sont mesurées entre les points de référence
1920 respectifs des éléments considérés.
1921 Le @i{point de référence} d'une portée est le centre vertical du
1922 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
1923 l'interligne médian si @code{line-count} est pair.
1924 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
1925 tableau suivant présente le @i{point de référence} pour chacune
1928 @multitable {Non-staff line} {Reference point}
1929 @headitem Ligne de non-portée @tab Point de référence
1930 @item @code{ChordNames} @tab ligne de base
1931 @item @code{NoteNames} @tab ligne de base
1932 @item @code{Lyrics} @tab ligne de base
1933 @item @code{Dynamics} @tab centre vertical
1934 @item @code{FiguredBass} @tab point le plus haut
1935 @item @code{FretBoards} @tab ligne supérieure
1938 En voici une représentation graphique@tie{}:
1941 @lilypond[quote,noragged-right,line-width=110\mm]
1942 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
1944 alignToZero = \with {
1945 \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
1946 \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
1948 lowerCaseChords = \with {
1949 chordNameLowercaseMinor = ##t
1951 staffAffinityDown = \with {
1952 \override VerticalAxisGroup #'staff-affinity = #DOWN
1955 #(define-music-function
1956 (parser location context)
1958 #{ s1*0^\markup { \typewriter #context } #})
1961 \context { \Dynamics \alignToZero }
1962 \context { \FiguredBass \alignToZero }
1963 \context { \Lyrics \alignToZero }
1964 \context { \NoteNames \alignToZero \staffAffinityDown }
1965 \context { \ChordNames \alignToZero
1968 \context { \FretBoards \alignToZero \staffAffinityDown }
1970 \override BarLine #'stencil = ##f
1971 \override DynamicText #'self-alignment-X = #-1
1972 \override FretBoard #'X-offset = #1.75
1973 \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
1974 \override InstrumentName #'extra-offset = #'(0 . -0.5)
1975 \override TextScript #'minimum-Y-extent = #'(-2 . 3)
1976 \override TimeSignature #'stencil = ##f
1980 %% Contextes dont le point de référence est la ligne de base :
1981 %% ChordNames, NoteNames, et Lyrics
1983 \new ChordNames { \chords { g1:m } }
1984 \new NoteNames { s1 | g1 | }
1985 \new RhythmicStaff {
1986 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
1988 \labelContext "ChordNames" s1 |
1989 \labelContext "NoteNames" s1 |
1990 \labelContext "Lyrics" s1 |
1992 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
1995 %% Le point de référence de Dynamics est le milieu de la ligne
1997 \new RhythmicStaff {
1998 \set RhythmicStaff.instrumentName = #"centre vertical "
1999 \labelContext "Dynamics" s1*3
2001 \new Dynamics { s1\mp s\fp }
2004 %% Le point de référence de FiguredBass est son point le plus haut
2006 \new RhythmicStaff {
2007 \set RhythmicStaff.instrumentName = #"point le plus haut "
2008 \labelContext "FiguredBass" s1
2010 \new FiguredBass { \figuremode { <6 5>1 } }
2013 %% Le point de référence de FretBoards est la ligne du haut
2014 \include "predefined-guitar-fretboards.ly"
2016 \new FretBoards { \chordmode { e1 } }
2017 \new RhythmicStaff {
2018 \set RhythmicStaff.instrumentName = #"ligne du haut "
2019 \labelContext "FretBoards " s1
2024 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2025 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2026 sous la forme d'une liste associative dont la structure est
2027 identique à celle des variables du bloc @code{\paper} que nous avons
2028 examinées au chapitre
2029 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2030 matière de modification d'une liste associative font l'objet d'un
2031 @rusernamed{Modification de listes associatives,chapitre particulier}.
2032 Les propriétés des objets graphiques se règlent avec un @code{\override}
2033 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2036 L'exemple suivant illustre deux façons de modifier une liste
2037 associative. La première déclaration n'agit que sur une seule clé,
2038 alors que la seconde redéfinit la propriété dans son intégralité.
2042 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2046 \override VerticalAxisGroup #'staff-staff-spacing =
2047 #'(('basic-distance . 10)
2048 (minimum-distance . 9)
2050 (stretchability . 10))
2054 La modification d'un espacement au niveau global se mentionne au sein du
2055 bloc @code{\layout}@tie{}:
2061 \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10
2066 Les réglages concernant les propriétés d'espacement vertical des objets
2067 graphiques sont répertoriées aux chapitres
2068 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2069 Les propriétés relatives aux lignes de non-portée sont répertoriées
2070 selon la définition de leur contexte dans la
2071 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2074 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2075 @translationof Properties of the @code{VerticalAxisGroup} grob
2077 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2078 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2082 @item staff-staff-spacing
2083 Il s'agit de la distance entre la portée en cours et la portée qui suit
2084 au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
2085 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2086 pas à la dernière portée d'un système.
2088 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2089 d'un @code{VerticalAxisGroup} affectera les propriétés du
2090 @code{StaffGrouper} si la portée est incluse dans un regroupement@tie{};
2091 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2092 regroupement. Les portées peuvent donc s'aligner différemment selon
2093 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2094 tenir compte des éventuels regroupements, cette fonction peut faire
2095 place à une complète redéfinition des espacements fluctuants à l'aide de
2096 règles dérogatoires comme vu précédemment.
2098 @item default-staff-staff-spacing
2099 Il s'agit de la distance qui s'appliquera par défaut aux portées
2100 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2101 explicitement par un @code{\override}.
2103 @item staff-affinity
2104 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2105 que prendra une ligne de non-portée pour aller s'accoler aux portées
2106 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2107 non-portée ira se placer à équidistance entre les portées qui
2108 l'encadrent, tout en tenant compte des éventuels risques de collision et
2109 des autres contraintes d'espacement. Des lignes de non-portée
2110 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2111 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2112 Une ligne de non-portée en dessous d'un système devrait avoir sa
2113 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2114 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2115 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2116 @code{staff-affinity}@tie{}: si vous affectez la valeur @code{#f} à
2117 une ligne de non-portée, cette ligne sera considérée comme étant une
2118 portée@tie{}; à l'inverse, utiliser la propriété @code{staff-affinity}
2119 pour une portée lui fera perdre cette qualité.
2121 @c TODO: verify last clause below ("even if other...")
2123 @item nonstaff-relatedstaff-spacing
2124 Il s'agit de la distance entre la ligne de non-portée en cours et la
2125 portée la plus proche selon la @code{staff-affinity}, à la double
2126 condition qu'il n'y a pas déjà une autre ligne de non-portée et que la
2127 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2128 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2129 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2130 non-portée entre les deux portées adjacentes même si une autre
2131 non-portée est présente (quelque soit le côté).
2133 @item nonstaff-nonstaff-spacing
2134 Il s'agit de la distance entre deux lignes de non-portée selon
2135 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2136 la même orientation. Bien entendu, ceci ne peut concerner que les
2137 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2139 @item nonstaff-unrelatedstaff-spacing
2140 Il s'agit de la distance entre une ligne de non-portée et la portée à
2141 l'opposé de l'orientation adoptée, à la double condition qu'il n'y a pas
2142 déjà une autre ligne de non-portée et que la valeur de
2143 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2144 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2145 portée à laquelle elle ne correspond pas.
2149 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2150 @translationof Properties of the @code{StaffGrouper} grob
2152 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2153 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2157 @item staff-staff-spacing
2158 Il s'agit de la distance entre deux portées consécutives d'un même
2159 système. La propriété @code{staff-staff-spacing} de l'objet
2160 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2161 l'aide de règles dérogatoires.
2163 @item staffgroup-staff-spacing
2164 Il s'agit de la distance entre la dernière portée d'un regroupement et
2165 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2166 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2167 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2168 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2169 regroupement a été ajustée au niveau de son propre
2170 @code{VerticalAxisGroup}, cette dernière aura préséance.
2174 Fichiers d'initialisation :
2175 @file{ly/engraver-init.ly},
2176 @file{scm/define-grobs.scm}.
2178 Référence des propriétés internes :
2179 @rinternals{Contexts},
2180 @rinternals{VerticalAxisGroup},
2181 @rinternals{StaffGrouper}.
2184 @node Espacement de portées isolées
2185 @unnumberedsubsubsec Espacement de portées isolées
2186 @translationof Spacing of ungrouped staves
2188 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2189 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2192 L'espacement de ces @i{portées isolées} est géré par les propriétés
2196 @item Propriétés du @code{VerticalAxisGroup} :
2198 @item @code{default-staff-staff-spacing}
2199 @item @code{staff-staff-spacing}
2203 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2204 @ref{Propriétés d'espacement au sein d'un système}.
2206 Certaines propriétés supplémentaires s'appliqueront dès lors que
2207 ces portées sont regroupées -- voir
2208 @ref{Espacement de portées regroupées}.
2210 L'exemple suivant illustre la manière de gérer l'espacement de portées
2211 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2212 Les mêmes règles appliquées de manière dérogatoire au
2213 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2214 sein de regroupements.
2216 @lilypond[verbatim,quote,staffsize=16]
2220 \override VerticalAxisGroup #'default-staff-staff-spacing =
2221 #'((basic-distance . 8)
2222 (minimum-distance . 7)
2228 % The very low note here needs more room than 'basic-distance
2229 % can provide, so the distance between this staff and the next
2230 % is determined by 'padding.
2231 \new Staff { b,2 r | }
2233 % Here, 'basic-distance provides enough room, and there is no
2234 % need to compress the space (towards 'minimum-distance) to make
2235 % room for anything else on the page, so the distance between
2236 % this staff and the next is determined by 'basic-distance.
2237 \new Staff { \clef bass g2 r | }
2239 % By setting 'padding to a negative value, staves can be made to
2240 % collide. The lowest acceptable value for 'basic-distance is 0.
2242 \override VerticalAxisGroup #'default-staff-staff-spacing =
2243 #'((basic-distance . 3.5)
2245 } { \clef bass g2 r | }
2246 \new Staff { \clef bass g2 r | }
2251 Fichiers d'initialisation :
2252 @file{scm/define-grobs.scm}.
2255 @rlsrnamed{Spacing,Espacements}.
2257 Référence des propriétés internes :
2258 @rinternals{VerticalAxisGroup}.
2261 @node Espacement de portées regroupées
2262 @unnumberedsubsubsec Espacement de portées regroupées
2263 @translationof Spacing of grouped staves
2265 Dans les partitions orchestrales ou de grande ampleur, il arrive
2266 souvent que des portées soient regroupées. L'espacement est alors plus
2267 important entre deux regroupements qu'entre les portées d'un même
2270 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2271 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2272 une ou plusieurs portées.
2274 L'espacement entre les portées d'un même regroupement est géré par les
2275 propriétés suivantes@tie{}:
2278 @item Propriétés du @code{VerticalAxisGroup} :
2280 @item @code{staff-staff-spacing}
2282 @item Propriétés du @code{StaffGrouper} :
2284 @item @code{staff-staff-spacing}
2285 @item @code{staffgroup-staff-spacing}
2289 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2290 @ref{Propriétés d'espacement au sein d'un système}.
2292 L'exemple suivant illustre la manière de gérer l'espacement de portées
2293 regroupées, à l'aide des propriétés de l'objet graphique
2294 @code{StaffGrouper}@tie{}:
2296 @lilypond[verbatim,quote,staffsize=16]
2300 \override StaffGrouper #'staff-staff-spacing #'padding = #0
2301 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
2306 \new PianoStaff \with {
2307 \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
2322 Fichiers d'initialisation :
2323 @file{scm/define-grobs.scm}.
2326 @rlsrnamed{Spacing,Espacements}.
2328 Référence des propriétés internes:
2329 @rinternals{VerticalAxisGroup},
2330 @rinternals{StaffGrouper}.
2333 @node Espacement des lignes rattachées à des portées
2334 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2335 @translationof Spacing of non-staff lines
2337 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2338 @code{ChordNames} sont des contextes dont les objets de rendu sont
2339 gravés à l'instar des portées -- une ligne horizontale dans un système.
2340 En fait, les lignes de non-portée sont des contextes qui vont créer un
2341 objet de rendu @code{VerticalAxisGroup}.
2343 L'espacement des lignes de non-portée est géré par les propriétés
2347 @item Propriétés du @code{VerticalAxisGroup} :
2349 @item @code{staff-affinity}
2350 @item @code{nonstaff-relatedstaff-spacing}
2351 @item @code{nonstaff-nonstaff-spacing}
2352 @item @code{nonstaff-unrelatedstaff-spacing}
2356 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2357 @ref{Propriétés d'espacement au sein d'un système}.
2359 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2360 pour gérer l'espacement entre des lignes consécutives de non-portée.
2361 Vous noterez que la valeur élevée attribuée à la clé
2362 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2364 @lilypond[verbatim,quote,staffsize=16]
2368 \override VerticalAxisGroup
2369 #'nonstaff-nonstaff-spacing #'stretchability = #1000
2376 \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
2379 \override VerticalAxisGroup #'staff-affinity = #UP
2382 \override VerticalAxisGroup #'staff-affinity = #CENTER
2383 } \lyricmode { center }
2385 \override VerticalAxisGroup #'staff-affinity = #DOWN
2386 } \lyricmode { down }
2392 Fichiers d'initialisation :
2393 @file{ly/engraver-init.ly},
2394 @file{scm/define-grobs.scm}.
2397 @rlsrnamed{Spacing,Espacements}.
2399 @c @lsr{spacing,page-spacing.ly},
2400 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2402 Référence des propriétés internes :
2403 @rinternals{Contexts},
2404 @rinternals{VerticalAxisGroup}.
2407 @node Positionnement explicite des portées et systèmes
2408 @subsection Positionnement explicite des portées et systèmes
2409 @translationof Explicit staff and system positioning
2411 Pour bien comprendre comment fonctionnent les réglages de
2412 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2413 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2414 les différentes mises au point du décalage vertical appliqué aux portées
2415 et systèmes distribués sur une page.
2417 Une autre approche de l'espacement vertical est le recours à
2418 @code{NonMusicalPaperColumn #'line-break-system-details}. Alors que
2419 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2420 @code{NonMusicalPaperColumn #'line-break-system-details} spécifiera le
2421 positionnement vertical absolu sur la page.
2423 @code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
2424 une liste associative de trois mises au point@tie{}:
2427 @item @code{X-offset}
2428 @item @code{Y-offset}
2429 @item @code{alignment-distances}
2432 Les dérogations en matière d'objet graphique, y compris celles
2433 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2434 à trois différents endroits de votre fichier source@tie{}:
2437 @item directement au beau milieu des notes
2438 @item au sein d'un bloc @code{\context}
2439 @item dans un bloc @code{\with}
2442 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2443 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2444 @code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
2445 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2446 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2447 de la commande @code{\overrideProperty}@tie{}:
2450 \overrideProperty NonMusicalPaperColumn
2451 #'line-break-system-details #'((X-offset . 20))
2453 \overrideProperty NonMusicalPaperColumn
2454 #'line-break-system-details #'((Y-offset . 40))
2456 \overrideProperty NonMusicalPaperColumn
2457 #'line-break-system-details #'((X-offset . 20)
2460 \overrideProperty NonMusicalPaperColumn
2461 #'line-break-system-details #'((alignment-distances . (15)))
2463 \overrideProperty NonMusicalPaperColumn
2464 #'line-break-system-details #'((X-offset . 20)
2466 (alignment-distances . (15)))
2469 Nous allons maintenant voir ces différents réglages en action.
2470 Commençons par examiner un exemple dépourvu de toute mise au point.
2472 @c \book { } is required in these examples to ensure the spacing
2473 @c overrides can be seen between systems. -np
2475 @lilypond[verbatim,quote,staffsize=16]
2476 \header { tagline = ##f }
2477 \paper { left-margin = 0\mm }
2487 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2490 \repeat unfold 15 { d'4 d' d' d' }
2497 Cette partition isole les informations de saut de ligne ou de page dans
2498 une voix spécifique. La mise en forme est ainsi séparée des événements
2499 musicaux@tie{}; ceci nous permettra d'y voir plus clair au fur et à
2500 mesure que nous avancerons. Pour plus de précisions, relisez
2501 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2503 Les @code{\breaks} explicites répartissent la musique en lignes de cinq
2504 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2505 par défaut. Nous pouvons, afin de fixer explicitement le point
2506 d'attache vertical de chacun des systèmes, définir un doublet
2507 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2508 de l'objet @code{NonMusicalPaperColumn}@tie{}:
2510 @lilypond[verbatim,quote,staffsize=16]
2511 \header { tagline = ##f }
2512 \paper { left-margin = 0\mm }
2518 \overrideProperty #"Score.NonMusicalPaperColumn"
2519 #'line-break-system-details #'((Y-offset . 0))
2521 \overrideProperty #"Score.NonMusicalPaperColumn"
2522 #'line-break-system-details #'((Y-offset . 40))
2524 \overrideProperty #"Score.NonMusicalPaperColumn"
2525 #'line-break-system-details #'((Y-offset . 80))
2528 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2531 \repeat unfold 15 { d'4 d' d' d' }
2538 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2539 si la liste associative de @code{line-break-system-details} peut en
2540 comporter un certain nombre. Vous aurez aussi noté que la propriété
2541 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2544 Maintenant que chaque système est explicitement positionné, nous pouvons
2545 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2546 à la sous-propriété @code{alignment-distances} de
2547 @code{line-break-system-details}.
2549 @lilypond[verbatim,quote,staffsize=16]
2550 \header { tagline = ##f }
2551 \paper { left-margin = 0\mm }
2557 \overrideProperty #"Score.NonMusicalPaperColumn"
2558 #'line-break-system-details #'((Y-offset . 20)
2559 (alignment-distances . (15)))
2561 \overrideProperty #"Score.NonMusicalPaperColumn"
2562 #'line-break-system-details #'((Y-offset . 60)
2563 (alignment-distances . (15)))
2565 \overrideProperty #"Score.NonMusicalPaperColumn"
2566 #'line-break-system-details #'((Y-offset . 100)
2567 (alignment-distances . (15)))
2570 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2573 \repeat unfold 15 { d'4 d' d' d' }
2580 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2581 @code{line-break-system-details} de l'objet
2582 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2583 prendre bien d'autres paramètres d'espacement, y compris un doublet
2584 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2585 @code{alignment-distances} pour contrôler le positionnement de chaque
2586 système et de chaque portée. Vous noterez enfin que
2587 @code{alignment-distances} traite le positionnement des portées, non
2588 d'un regroupement de portées.
2590 @lilypond[verbatim,quote,staffsize=16]
2591 \header { tagline = ##f }
2592 \paper { left-margin = 0\mm }
2598 \overrideProperty #"Score.NonMusicalPaperColumn"
2599 #'line-break-system-details #'((Y-offset . 0)
2600 (alignment-distances . (30 10)))
2602 \overrideProperty #"Score.NonMusicalPaperColumn"
2603 #'line-break-system-details #'((Y-offset . 60)
2604 (alignment-distances . (10 10)))
2606 \overrideProperty #"Score.NonMusicalPaperColumn"
2607 #'line-break-system-details #'((Y-offset . 100)
2608 (alignment-distances . (10 30)))
2611 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2614 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2615 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2622 Quelques points à prendre en considération@tie{}:
2626 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2627 autres lignes de non-portée ne comptent pas pour une portée.
2630 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2631 @code{alignment-distances} sont considérés comme des multiples de la
2632 distance entre des portées adjacentes. Des valeurs positives remontent
2633 les portées et paroles, des valeurs négatives les descendent.
2636 Dans la mesure où @code{NonMusicalPaperColumn #'line-break-system-details}
2637 permet de positionner systèmes et portées n'importe où sur une page,
2638 vous pourriez être en contradiction avec les dimensionnements de la
2639 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2640 quant aux différentes valeurs que vous affectez à ces réglages.
2646 @rlsrnamed{Spacing,Espacements}.
2649 @node Résolution des collisions verticales
2650 @subsection Résolution des collisions verticales
2651 @translationof Vertical collision avoidance
2653 @funindex outside-staff-priority
2654 @funindex outside-staff-padding
2655 @funindex outside-staff-horizontal-padding
2657 Vous savez de manière intuitive qu'un certain nombre d'objets en
2658 matière de notation musicale appartiennent à la portée, et que
2659 d'autres se placent en dehors de la portée. Entre autres objets
2660 externes, nous avons les marques repères, les textes et les
2661 nuances@tie{}; nous les appellerons @qq{objets extérieurs à la portée}.
2662 La règle adoptée par LilyPond pour positionner verticalement ces
2663 objets extérieurs consiste à les placer au plus près de la portée
2664 tout en prenant garde d'éviter qu'il y ait chevauchement.
2666 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2667 déterminer si un objet est ou non un objet extérieur à la portée@tie{}:
2668 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2669 s'agit d'un objet extérieur à la portée. De plus, la propriété
2670 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2671 objets doivent être disposés.
2673 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2674 Les objets extérieurs à la portée sont alors triés selon l'ordre
2675 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2676 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2677 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2678 lorsque deux objets devraient se placer au même endroit, celui dont la
2679 @code{outside-staff-priority} est la plus faible sera disposé au plus
2682 @lilypond[quote,ragged-right,relative=2,verbatim]
2685 \once \override TextScript #'outside-staff-priority = #1
2686 c4_"Text"\pp % this time the text will be closer to the staff
2688 % by setting outside-staff-priority to a non-number,
2689 % we disable the automatic collision avoidance
2690 \once \override TextScript #'outside-staff-priority = ##f
2691 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2692 c4_"Text"\pp % now they will collide
2695 Le décalage vertical entre un objet extérieur à la portée et celui qui
2696 le précède se contrôle par la propriété @code{outside-staff-padding}.
2699 @lilypond[quote,ragged-right,relative=2,verbatim]
2700 \once \override TextScript #'outside-staff-padding = #0
2701 a'^"Ce texte est placé au plus près de la note"
2702 \once \override TextScript #'outside-staff-padding = #3
2703 c^"Ce texte est décalé par rapport au texte précédent"
2704 c^"Ce texte est accolé au texte précédent"
2707 Par défaut, les objets extérieurs à la portée sont positionnés en
2708 évitant les collisions horizontales avec des objets précédemment
2709 positionnés. Ceci peut cependant générer des situations où des objets
2710 se trouvent horizontalement trop proches. L'espacement vertical entre
2711 les portées peut dans une certaine mesure permettre de mieux intercaler
2712 les objets extérieurs à la portée. La propriété
2713 @code{outside-staff-horizontal-padding} repoussera verticalement un
2714 objet pour éviter ce genre de situation.
2716 @lilypond[quote,ragged-right,relative=2,verbatim]
2717 % the markup is too close to the following note
2721 % setting outside-staff-horizontal-padding fixes this
2723 \once \override TextScript #'outside-staff-horizontal-padding = #1
2731 @rlsrnamed{Spacing,Espacements}.
2734 @node Espacement horizontal
2735 @section Espacement horizontal
2736 @translationof Horizontal spacing
2738 @cindex horizontal, espacement
2739 @cindex espacement horizontal
2742 * Généralités sur l'espacement horizontal::
2743 * Changement d'espacement en cours de partition::
2744 * Modification de l'espacement horizontal::
2745 * Longueur de ligne::
2746 * Notation proportionnelle::
2750 @node Généralités sur l'espacement horizontal
2751 @subsection Généralités sur l'espacement horizontal
2752 @translationof Horizontal spacing overview
2754 Le moteur d'espacement traduit les différences de durée en distances
2755 étirables (@emph{springs} pour ressorts) de différente longueur. Des
2756 durées importantes prennent ainsi plus de place que des durées moins
2757 longues. Les durées les plus courtes se verront attribuer un espace
2758 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2759 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2760 plus elle prendra d'espace@tie{}: le doublement d'une durée attribuera à
2761 la note un espace fixé d'après la propriété @code{spacing-increment}.
2763 L'exemple suivant comporte des blanches, des noires et un certain nombre
2764 de croches. La croche est suivie d'un espace de la largeur d'une tête
2765 de note@tie{}; pour la noire , cet espace est de deux têtes@tie{}; il
2766 est de trois pour la blanche.
2768 @lilypond[quote,verbatim,relative=1]
2769 c2 c4. c8 c4. c8 c4. c8 c8
2773 @code{spacing-increment} est normalement défini à 1,2@tie{}espace de
2774 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2775 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2776 s'étendra donc sur l'équivalent de 2,4@tie{}espaces de portée (2 fois le
2777 @code{spacing-increment}). Le point de départ de cet espace se situe à
2778 l'extrémité gauche du symbole@tie{}; la note la plus courte est donc
2779 suivie en général d'un espace égal à la largeur d'une tête de note.
2781 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2782 croche à une partition qui comporte déjà des croches et des doubles
2783 augmentera considérablement son volume@tie{}: la durée la plus
2784 courte n'est plus la double mais la triple croche, ce qui aura
2785 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2786 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2787 courte prise en considération au niveau de l'espacement n'est pas la
2788 note la plus brève de la partition, mais celle qui apparaît le plus
2791 La courte durée la plus fréquente est déterminée à partir de la note la
2792 plus courte de chaque mesure. C'est elle qui servira de base pour
2793 l'espacement, à cette nuance près que la plus courte durée ne saurait
2794 être strictement supérieure à la croche. Cette @qq{durée de référence}
2795 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2798 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2799 pour les espacements grâce à la propriété
2800 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2801 La durée maximale de cet étalon, normalement la croche, est gérée par la
2802 propriété @code{base-shortest-duration}.
2804 @funindex common-shortest-duration
2805 @funindex base-shortest-duration
2806 @funindex stem-spacing-correction
2809 Les notes plus courtes que la note témoin sont suivies d'un espace
2810 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2811 doubles croches à l'exemple précédent, elles seraient suivies d'une
2812 demie largeur de tête@tie{}:
2814 @lilypond[quote,verbatim,relative=2]
2815 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2818 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2819 vu comment la direction des hampes peut influencer l'espacement -- voir
2820 @ressay{Espacement}. Ceci est contrôlé par la propriété
2821 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2822 pour chaque contexte @rinternals{Voice}. L'objet
2823 @rinternals{StaffSpacing}, généré au niveau d'un contexte @code{Staff},
2824 possède une même propriété qui contrôlera l'espacement hampe-barre de
2825 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2826 les réglages par défaut, puis avec des corrections forcées.
2828 @lilypond[quote,ragged-right]
2832 \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2833 \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2839 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
2840 @rusernamed{Notation proportionnelle,rubrique dédiée}.
2844 @rlsrnamed{Spacing,Espacements}.
2846 Essai sur la gravure musicale automatisée :
2847 @ressay{Espacement}.
2849 Référence des propriétés internes :
2850 @rinternals{SpacingSpanner},
2851 @rinternals{NoteSpacing},
2852 @rinternals{StaffSpacing},
2853 @rinternals{NonMusicalPaperColumn}.
2856 Il n'existe pas de mécanisme simple et efficace qui permette de
2857 forcer manuellement l'espacement. La solution ci-dessous permet
2858 cependant @qq{d'aérer} artificiellement une partition@tie{}; il vous
2859 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
2862 \override Score.NonMusicalPaperColumn #'padding = #10
2865 Il n'y a aucun moyen de diminuer l'espacement.
2868 @node Changement d'espacement en cours de partition
2869 @subsection Changement d'espacement en cours de partition
2870 @translationof New spacing area
2872 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
2873 substantiellement la notion de valeur brève et valeur longue. La
2874 commande @code{newSpacingSection} permet alors de réinitialiser les
2875 paramètres d'espacement.
2877 Dans l'exemple qui suit, le changement de métrique marque le début
2878 d'une nouvelle partie@tie{}; remarquez comme les doubles-croches sont
2879 alors plus espacées@tie{}:
2881 @lilypond[relative,verbatim,quote]
2884 c8 c c4 c16[ c c8] c4
2890 La commande @code{\newSpacingSection} crée un nouvel objet
2891 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
2892 @code{\override}s à partir de ce point.
2896 @rlsrnamed{Spacing,Espacements}.
2898 Référence des propriétés internes :
2899 @rinternals{SpacingSpanner}.
2902 @node Modification de l'espacement horizontal
2903 @subsection Modification de l'espacement horizontal
2904 @translationof Changing horizontal spacing
2906 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
2907 @code{base-shortest-duration}. Comparons les deux partitions qui
2908 suivent, toutes deux montrant la même musique. La première partition
2909 applique les réglages par défaut, alors que la seconde bénéficie
2910 d'ajustement de la propriété @code{base-shortest-duration}. Au plus la
2911 valeur de @code{ly:make-moment} est grande, au plus la musique sera
2912 resserrée. En effet, @code{ly:make-moment} construit une durée@tie{}:
2913 @w{@code{1 4}} est plus long que @w{@code{1 16}}.
2915 @lilypond[verbatim,line-width=12\cm]
2918 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2919 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2920 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2921 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2926 @lilypond[verbatim,line-width=12\cm]
2929 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2930 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2931 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2932 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2937 \override SpacingSpanner
2938 #'base-shortest-duration = #(ly:make-moment 1 16)
2945 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
2946 facteurs qui ne sont pas liés à la durée (altération, changement de
2947 clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
2948 permet d'ignorer ces symboles et, par voie de conséquence, forcer
2949 l'espacement sur la simple durée. Notez bien que cette propriété
2950 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
2953 @lilypond[quote,ragged-right,verbatim]
2972 \override SpacingSpanner #'uniform-stretching = ##t
2978 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
2979 les notes sans tenir compte des clefs, barres de mesure ou notes
2980 d'ornement qui pourraient apparaître@tie{}:
2982 @lilypond[quote,ragged-right,relative=2,verbatim]
2983 \override Score.SpacingSpanner #'strict-note-spacing = ##t
2984 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
2989 @rlsrnamed{Spacing,Espacements}.
2992 @node Longueur de ligne
2993 @subsection Longueur de ligne
2994 @translationof Line length
2996 @cindex saut de page
3000 @funindex line-width
3001 @funindex ragged-right
3002 @funindex ragged-last
3004 @c Although line-width can be set in \layout, it should be set in paper
3005 @c block, to get page layout right.
3006 @c Setting indent in \paper block makes not much sense, but it works.
3008 @c Bit verbose and vague, use examples?
3009 Deux réglages de bases ont une influence considérable sur
3010 l'espacement@tie{}: @code{line-width} et @code{indent}. Tous deux se
3011 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3012 lignes et l'indentation de la première.
3014 L'activation du commutateur @code{ragged-right} au sein du bloc
3015 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3016 de les voir s'étirer sur toute la largeur de la page. Cette option est
3017 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3018 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3019 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3023 @cindex vertical spacing
3025 Le fonctionnement de l'option @code{ragged-last} est en tout point
3026 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3027 que la dernière ligne de la partition. Il n'y a pas de restriction
3028 quant à cette ligne. Il en va de même que pour le formatage d'un
3029 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3031 @c Note that for text there are several options for the last line.
3032 @c While Knuth TeX uses natural length, lead typesetters use the same
3033 @c stretch as the previous line. eTeX uses \lastlinefit to
3034 @c interpolate between both these solutions.
3046 @rlsrnamed{Spacing,Espacements}.
3049 @node Notation proportionnelle
3050 @subsection Notation proportionnelle
3051 @translationof Proportional notation
3053 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3054 ce cas de représenter la notation selon un espacement strictement
3055 relatif aux durées. Ce type d'espacement pourrait se comparer à
3056 l'utilisation de papier millimétré pour positionner les notes au fil de
3057 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3058 utilisent cette proportionnalité dans le but de clarifier des structures
3059 rythmiques complexes, d'aider au positionnement d'indications
3060 temporelles ou autres éléments graphiques directement dans la partition.
3062 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3063 s'utiliser conjointement ou individuellement, aux fins de mettre au
3064 point cette notation proportionnelle.
3067 @item @code{proportionalNotationDuration}
3069 @item @code{uniform-stretching}
3071 @item @code{strict-note-spacing}
3073 @item @code{\remove Separating_line_group_engraver}
3075 @item @code{\override PaperColumn #'used = ##t}
3079 Nous allons examiner, dans les différents exemples qui suivent, les
3080 effets de ces réglages et comment ils interagissent.
3082 Commençons par cette mesure toute simple qui utilise l'espacement
3083 classique et justifiée à gauche.
3085 @lilypond[quote,verbatim,ragged-right]
3088 \new RhythmicStaff {
3092 c'16 c'16 c'16 c'16 c'16
3099 Vous constatez que la blanche qui entame la mesure prend moins de la
3100 moitié de l'espace. De même, les doubles croches et le quintolet de
3101 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3102 n'en occupent pas la moitié de l'espace horizontal.
3104 En matière de gravure traditionnelle, cet espacement correspond tout à
3105 fait à nos attentes, puisque nous pouvons rogner l'espace sur la
3106 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3109 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3110 un autre graphisme en surplomb ou en dessous de notre partition, nous
3111 aurons besoin de la notation proportionnelle. Celle-ci s'active an
3112 définissant la propriété @code{proportionalNotationDuration}.
3114 @lilypond[quote,verbatim,ragged-right]
3117 \new RhythmicStaff {
3121 c'16 c'16 c'16 c'16 c'16
3128 proportionalNotationDuration = #(ly:make-moment 1 20)
3134 La blanche du début et les notes plus rapides de la deuxième moitié de
3135 la mesure occupent maintenant exactement le même espace horizontal.
3136 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3137 temporelle ou autre graphisme.
3139 @code{proportionalNotationDuration} est une propriété attachée au
3140 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3141 propriétés d'un contexte à trois différents endroits de votre
3142 fichier@tie{}: dans un bloc @code{\with}, dans un bloc @code{\context}
3143 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3144 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3145 de ces trois façons, à l'instar de n'importe quelle définition de
3148 La propriété @code{proportionalNotationDuration} prend en unique
3149 argument la durée de référence qui servira de base pour espacer toute la
3150 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3151 prend deux arguments@tie{}: un numérateur et un dénominateur qui
3152 représentent une fraction de ronde. L'appel de
3153 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3154 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3155 @code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} ou
3156 @code{(ly:make-moment 3 97)}.
3158 Se pose alors le problème de fournir la juste durée de référence à
3159 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3160 tâtonnement, en commençant par une valeur proche de la note la plus
3161 rapide (la durée la plus courte) du morceau. Au plus la durée de
3162 référence est petite, au plus la musique sera étalée@tie{}; à l'inverse,
3163 une durée de référence élevée produira une musique resserrée.
3165 @lilypond[quote,verbatim,ragged-right]
3168 \new RhythmicStaff {
3172 c'16 c'16 c'16 c'16 c'16
3179 proportionalNotationDuration = #(ly:make-moment 1 8)
3186 \new RhythmicStaff {
3190 c'16 c'16 c'16 c'16 c'16
3197 proportionalNotationDuration = #(ly:make-moment 1 16)
3204 \new RhythmicStaff {
3208 c'16 c'16 c'16 c'16 c'16
3215 proportionalNotationDuration = #(ly:make-moment 1 32)
3221 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3222 comme la croche pour la première ligne, a pour conséquence de resserrer
3223 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3224 remarquez aussi que, par principe, la notation proportionnelle occupe
3225 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3226 notation proportionnelle met en évidence le rythme au détriment de
3227 l'espacement horizontal.
3229 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3232 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3233 ajoutons lui une portée incluant un autre type de nolet.
3235 @lilypond[quote,verbatim,ragged-right]
3238 \new RhythmicStaff {
3242 c'16 c'16 c'16 c'16 c'16
3245 \new RhythmicStaff {
3247 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3254 L'espacement est loin d'être idéal, pour la simple raison que
3255 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3256 uniformément. Il est vrai que de telles constructions complexes en
3257 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3258 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3259 @code{proportionalNotationDuration} permet d'arranger les choses.
3261 @lilypond[quote,verbatim,ragged-right]
3264 \new RhythmicStaff {
3268 c'16 c'16 c'16 c'16 c'16
3271 \new RhythmicStaff {
3273 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3280 proportionalNotationDuration = #(ly:make-moment 1 20)
3286 Cependant, si l'on observe de près, il est évident que les notes de la
3287 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3288 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3289 allons activer le @code{uniform-stretching}, propriété attachée au
3290 @code{SpacingSpanner}.
3292 @lilypond[quote,verbatim,ragged-right]
3295 \new RhythmicStaff {
3299 c'16 c'16 c'16 c'16 c'16
3302 \new RhythmicStaff {
3304 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3311 proportionalNotationDuration = #(ly:make-moment 1 20)
3312 \override SpacingSpanner #'uniform-stretching = ##t
3318 L'espacement sur les deux portées est maintenant correct, les relations
3319 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3320 une indication temporelle ou autre graphisme selon notre envie.
3322 Notez bien que la prise en charge de la notation proportionnelle par
3323 LilyPond demande que, dans chaque partition, soit activée la propriété
3324 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3325 contraire, utiliser @code{proportionalNotationDuration} aura pour
3326 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3327 inséré des silences invisibles @emph{skip}.
3329 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3330 au contexte @code{Score}. Tout comme pour la propriété
3331 @code{proportionalNotationDuration}, les réglages du
3332 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3333 votre fichier@tie{}: dans un bloc @code{\with}, dans un bloc
3334 @code{\context} ou au beau milieu de la musique à l'aide de la
3335 commande @code{\set}.
3337 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3338 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3339 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3340 partition. Vous pourriez toutefois avoir besoin de modifier ce
3341 comportement en cours de partition, et recourir alors à l'instruction
3342 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3343 rubrique @ref{Changement d'espacement en cours de partition}.
3345 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3346 qui est désactivé pour la plupart des partitions en notation
3347 proportionnelle. Voici ce qui apparaît dans une partition
3348 traditionnelle@tie{}: il y a toujours un @qq{espace préservé} juste
3349 avant la première note de chaque portée.
3351 @lilypond[quote,verbatim,ragged-right]
3363 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3364 présent lorsqu'intervient un changement de métrique, d'armure ou de
3365 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3366 réduire cet espace à zéro.
3368 @lilypond[quote,verbatim,ragged-right]
3374 \remove Separating_line_group_engraver
3382 Les éléments non musicaux tels que métrique, armure et clef, posent
3383 problème lorsqu'on travaille en notation proportionnelle. Bien
3384 qu'aucune notion de durée ne leur soit attachée, ces éléments
3385 @qq{consomment} de l'espace. Différentes approches permettent
3386 cependant de gérer ce problème.
3388 Éviter les problèmes d'espacement avec l'armure est chose aisée@tie{}:
3389 il suffit qu'il n'y en ait pas@tie{}! C'est bien souvent le cas en
3390 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3391 proportionnelle. Il en va de même pour la métrique, et tout
3392 particulièrement lorsque la partition comporte un quadrillage temporel
3393 ou autres graphismes. L'absence de métrique reste cependant
3394 exceptionnelle et la plupart des partitions en notation proportionnelle
3395 laissent apparaître quelques métriques. Il est par contre pratiquement
3396 impossible de se passer de clef et d'altération.
3398 L'une des options permettant de s'affranchir de l'espacement dû aux
3399 éléments non musicaux consiste en l'activation de la propriété
3400 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3401 les deux portées suivantes@tie{}:
3403 @lilypond[quote,verbatim,ragged-right]
3405 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3415 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3416 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3426 Toutes deux affichent un espacement proportionnel. Cependant, la
3427 première ligne laisse apparaître un espacement plus lâche en raison de
3428 la présence d'un changement de clef. En ce qui concerne la deuxième
3429 ligne, l'espacement est strictement observé dès lors que la propriété
3430 @code{strict-note-spacing} a préalablement été activée. Comme vous
3431 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3432 conséquence que l'algorithme d'espacement ignore tout bonnement la
3433 largeur des métriques, armures, clefs et altérations.
3435 En plus de ceux que nous venons de voir, vous trouverez d'autres
3436 réglages en usage dans la notation proportionnelle comme, entre autres,
3439 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3440 @item @code{tupletFullLength = ##t}
3441 @item @code{\override Beam #'breakable = ##t}
3442 @item @code{\override Glissando #'breakable = ##t}
3443 @item @code{\override TextSpanner #'breakable = ##t}
3444 @item @code{\remove Forbid_line_break_engraver (dans un contexte de voix}
3447 Ces différents réglages permettent un espacement strict des notes
3448 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3449 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3450 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3451 différentes rubriques associées du manuel pour chacun de ces réglages.
3454 Manuel de notation :
3455 @ref{Changement d'espacement en cours de partition}.
3458 @rlsrnamed{Spacing,Espacements}.
3461 @node Réduction du nombre de pages de la partition
3462 @section Réduction du nombre de pages de la partition
3463 @translationof Fitting music onto fewer pages
3465 Vous pourriez un jour être confronté au problème suivant@tie{}: l'une
3466 des pages de votre partition ne comporte que deux portées alors que --
3467 ce qui est d'autant plus frustrant -- l'espace libre sur les autres
3468 pages aurait permis une distribution différente.
3470 L'instruction @code{annotate-spacing} se révèle être un outil
3471 indispensable pour l'analyse des problèmes de mise en forme. Cette
3472 commande met en surimpression la valeur des différentes variables
3473 d'espacement et de mise en forme, comme nous allons le voir dans la
3474 rubrique @ref{Mise en évidence de l'espacement}.
3477 * Mise en évidence de l'espacement::
3478 * Modification de l'espacement::
3482 @node Mise en évidence de l'espacement
3483 @subsection Mise en évidence de l'espacement
3484 @translationof Displaying spacing
3486 @funindex annotate-spacing
3487 @cindex espacement, affichage des valeurs
3489 Le meilleur moyen d'appréhender les différentes variables de
3490 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3491 la mise en page, consiste à activer, au sein du bloc @code{\paper}, la
3492 fonction @code{annotate-spacing}@tie{}:
3494 @c need to have \book{} otherwise we get the separate systems. -hwn
3495 @lilypond[verbatim,quote]
3496 #(set-default-paper-size "a6" 'landscape)
3499 \paper { annotate-spacing = ##t }
3504 Toutes les dimensions sont exprimées en espace de portée
3505 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3506 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3507 feuille (@code{paper-height}) est de 59,75@tie{}espaces de portée
3508 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3509 20@tie{}points -- sa valeur par défaut. Notez que@tie{}:
3511 @multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
3514 @tab = (25,4/72,27) mm
3517 @tab = (@code{staff-size})/4 pts
3519 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3524 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3525 1,757@tie{}millimètres. Les 59,75@tie{}@code{staff-spaces} de
3526 @code{paper-height} correspondent donc à 105@tie{}millimètres, soit la
3527 hauteur d'une feuille au format A6 à l'italienne. Les paires
3528 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3529 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3532 Manuel de notation :
3533 @ref{Définition de la taille de portée}.
3536 @rlsrnamed{Spacing,Espacements}.
3539 @node Modification de l'espacement
3540 @subsection Modification de l'espacement
3541 @translationof Changing spacing
3543 Les informations fournies par @code{annotate-spacing} en matière de
3544 dimensionnement vertical sont incomparables. Pour plus de détails sur
3545 les manières de modifier marges et autres variables connexes, consultez
3546 la rubrique @ref{Mise en forme de la page}.
3548 En dehors des marges, vous disposez de quelques moyens supplémentaires
3549 pour gagner de l'espace@tie{}:
3553 Rapprocher les systèmes le plus possible les uns des autres, de telle
3554 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3555 suffisamment pour éviter le blanc en bas de page.
3559 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3560 ragged-last-bottom = ##f
3566 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3567 deux titres. D'une part, le fait de définir un nombre de systèmes --
3568 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3569 systèmes par page dans la mesure où l'une des étapes d'estimation des
3570 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3571 systèmes par page permet d'en disposer plus sur les suivantes. Par
3572 exemple, avec un nombre par défaut de 11@tie{}systèmes par pages,
3573 l'instruction suivante le force à 10.
3582 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3583 se répartir sur deux pages.
3592 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3593 Par exemple, un crochet de reprise ou d'alternative consomme de
3594 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3595 diminue d'autant l'espace disponible que si seul le premier ne
3596 comportait l'indication. Autre exemple, les indications de nuance qui
3597 se @qq{détachent} d'un système peuvent être rapprochés de la portée@tie{}:
3599 @lilypond[verbatim,quote,relative=1]
3601 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3605 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3606 comme indiqué à la rubrique
3607 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3608 l'espacement par défaut@tie{}:
3610 @lilypond[verbatim,quote]
3623 Par contre, le fait de modifier la valeur de la propriété
3624 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3625 -- bien que la noire soit la durée la plus courante, nous prenons une
3626 valeur plus longue -- donnera un effet @qq{resserré} à la musique@tie{}:
3628 @lilypond[verbatim,quote]
3640 \override SpacingSpanner
3641 #'common-shortest-duration = #(ly:make-moment 1 2)
3648 La propriété @code{common-shortest-duration} ne peut être modifiée
3649 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3650 s'applique à l'intégralité de la partition.
3655 Manuel de notation :
3656 @ref{Mise en forme de la page},
3657 @ref{Modification de l'espacement horizontal}.
3660 @rlsrnamed{Spacing,Espacements}.