1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: b446ebc24f8d43acb323818988fe8b1d8072afc8
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Frédéric Chiasson, Jean-Charles Malahieude
18 Negative numbers are allowed:
19 > Are you sure? The following works well
21 > first-page-number = -2
23 > and prints page number -1 on the second page, for example.
26 In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
29 "@code{layout-set-staff-size} does not change the distance between
33 Could we add a sentence:
34 "Use instead the pair fontSize = #@var{N}
35 \override StaffSymbol #'staff-space = #(magstep
37 inside the Staff context to change the size of the font and the
39 staff lines accordingly."
41 Actually I found, that the @internalsref{StaffSymbol} at line 481
42 sends to an incomplete
43 documentation. The property staff-space is not explained here. I
44 thought Y-extent might be of
45 help, but it is in turn explained by x-space which again is
46 missing from the list. Who has the
47 knowledge to fix this?
51 http://code.google.com/p/lilypond/issues/detail?id=68
56 @node Gestion de l'espace
57 @chapter Gestion de l'espace
58 @translationof Spacing issues
60 L'agencement général d'une partition dépend de trois facteurs
61 interdépendants@tie{}: la mise en page, les sauts de ligne et
62 l'espacement. Les choix faits en matière d'espacement détermineront la
63 densité de chacun des systèmes, ce qui influera sur le positionnement
64 des sauts de lignes et, par voie de conséquence, sur le nombre de pages
67 En pratique, cette procédure comporte quatre étapes. Dans un premier
68 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
69 base des durées. Sont alors calculées différentes possibilités de saut
70 de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
71 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
72 la combinaison entre sauts de page et de ligne qui offre la meilleure
73 occupation de l'espace, tant horizontalement que verticalement.
75 Les réglages qui influencent la mise en forme se placent dans deux blocs
76 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
77 @ref{Mise en forme de la page} contient les réglages applicables à
78 l'intégralité du document -- à toutes les partitions d'un ouvrage --
79 tels que format du papier, impression ou non des numéros de page, etc.
80 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
81 rubrique @ref{Mise en forme de la musique}, il détermine la mise en
82 forme d'une partition@tie{}: le nombre de systèmes utilisés,
83 l'espacement des regroupements de portées, etc.
86 * Mise en forme de la page::
87 * Mise en forme de la partition::
89 * Espacement vertical::
90 * Espacement horizontal::
91 * Réduction du nombre de pages de la partition::
94 @cindex ragged, aligné
95 @cindex aligné, ragged
97 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
98 dont la traduction vous semblera assurément erronée. Il n'en est
99 cependant rien@tie{}: certains termes techniques ont une histoire
100 particulière selon leur langue d'origine. Ainsi, le vocable anglais
101 @emph{Ragged} signifie en lambeau, en loques@tie{}; dans l'univers
102 typographique, un maître français voit un alignement à gauche -- il dira
103 @qq{au fer à gauche} -- alors que son homologue anglophone constate un
104 @emph{ragged-right} -- donc du vide à droite.}
107 @node Mise en forme de la page
108 @section Mise en forme de la page
109 @translationof Page layout
111 Nous allons examiner ici les options qui contrôlent la mise en forme des
112 pages attachées au bloc @code{\paper}.
116 * Format du papier et adaptation automatique::
117 * Variables d'espacement vertical fixe::
118 * Variables d'espacement vertical fluctuant::
119 * Variables d'espacement horizontal::
120 * Autres variables du bloc \paper::
125 @subsection Le bloc @code{\paper}
126 @translationof The @code{\paper} block
128 Un bloc @code{\paper} peut apparaître au sein d'un bloc
129 @code{\book}. Les réglages effectués à l'aide du bloc @code{\paper}
130 s'appliqueront à l'intégralité d'un ouvrage, qui peut comporter
131 plusieurs partitions (des blocs @emph{score})@tie{}; il ne doit donc en
132 aucun cas se trouver dans un bloc @code{\score}. Peuvent apparaître
133 dans un bloc @code{\paper}@tie{}:
138 la fonction scheme @code{set-paper-size},
141 des variables propres au bloc @code{\paper} qui viendront adapter la
145 la définition des différents @emph{markups} qui personnaliseront la mise
146 en forme des entêtes, pied de page et titrages.
150 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
151 -- @ref{Format du papier et adaptation automatique}. Les variables du
152 bloc @code{\paper} traitant 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êtes, 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}. Pour plus de lisibilité, et bien que ce ne
185 soit pas techniquement requis, nous vous conseillons d'ajouter
186 @code{\mm} à votre code lorsque vous travaillez en millimètres.
188 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
189 fonctions Scheme. Voici l'équivalent de l'exemple précédent@tie{}:
193 #(define top-margin (* 0.5 in))
199 @ref{Titrages personnalisés}.
202 @node Format du papier et adaptation automatique
203 @subsection Format du papier et adaptation automatique
204 @translationof Paper size and automatic scaling
206 @cindex papier, taille
213 * Adaptation automatique au format::
217 @node Format du papier
218 @unnumberedsubsubsec Format du papier
219 @translationof Setting paper size
221 Le format du papier est déterminé par deux fonctions différentes@tie{}:
222 @code{set-default-paper-size} et @code{set-paper-size}.
223 @code{set-default-paper-size} se place en tête de fichier, alors que
224 @code{set-paper-size} se place à l'intérieur d'un bloc
228 #(set-default-paper-size "a4")
233 #(set-paper-size "a4")
238 La seule restriction à l'utilisation isolée de la fonction
239 @code{set-default-paper-size} est qu'elle doit intervenir avant le
240 premier bloc @code{\paper}. À l'intérieur d'un bloc @code{\paper}, il
241 vaut mieux utiliser la fonction @code{set-paper-size}, avant toute autre
242 variables. Les raisons à ceci sont abordées dans la rubrique
243 @ref{Adaptation automatique au format}.
245 @code{set-default-paper-size} fixe le format pour toutes les pages,
246 alors que @code{set-paper-size} détermine le format des feuilles
247 rattachées à un bloc @code{\paper} particulier. Ainsi, lorsque le bloc
248 @code{\paper} se trouve en tête de fichier, le format du papier
249 s'appliquera à toutes les pages@tie{}; si @code{\paper} apparaît dans un
250 bloc @code{\book}, la taille ne s'appliquera qu'au @emph{book} en
253 Les formats @code{a4}, @code{letter}, @code{legal} et @code{11x17} (ou
254 tabloïd) sont couramment utilisés pour les éditions musicales. Bien
255 d'autres formats sont disponibles et sont répertoriés à la rubrique
256 @code{paper-alist} du fichier d'initialisation @file{scm/paper.scm}.
258 @c TODO add a new appendix for paper sizes (auto-generated) -pm
260 @warning{Par défaut, le papier est au format A4 (codé @code{a4}).}
262 Rien ne vous empêche d'ajouter un format de papier inhabituel à la
263 rubrique @code{paper-alist} du fichier @file{scm/paper.scm}. Sachez
264 cependant que celui-ci est écrasé à chaque mise à jour de LilyPond.
268 @cindex paysage, papier
269 @cindex à l'italienne, papier
271 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
272 @code{set-default-paper-size} permet d'obtenir une présentation à
273 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
277 #(set-default-paper-size "a6" 'landscape)
282 Fichiers d'initialisation :
283 @file{scm/paper.scm}.
286 @node Adaptation automatique au format
287 @unnumberedsubsubsec Adaptation automatique au format
288 @translationof Automatic scaling to paper size
290 If the paper size is changed with one of the scheme functions
291 (@code{set-default-paper-size} or @code{set-paper-size}), the
292 values of several @code{\paper} variables are automatically scaled
293 to the new size. To bypass the automatic scaling for a particular
294 variable, set the variable after setting the paper size. Note
295 that the automatic scaling is not triggered by setting
296 @code{paper-height} or @code{paper-width}, even though
297 @code{paper-width} can influence other values (this is separate
298 from scaling and is discussed below). The
299 @code{set-default-paper-size} and @code{set-paper-size} functions
300 are described in @ref{Setting paper size}.
302 The vertical dimensions affected by automatic scaling are
303 @code{top-margin} and @code{bottom-margin}. The horizontal
304 dimensions affected by automatic scaling are @code{left-margin},
305 @code{right-margin}, @code{inner-margin}, @code{outer-margin},
306 @code{binding-offset}, @code{indent}, and @code{short-indent}.
308 The default values for these dimensions are set in
309 @file{ly/paper-defaults-init.ly}, using internal variables named
310 @code{top-margin-default}, @code{bottom-margin-default}, etc.
311 These are the values that result at the default paper size
312 @code{a4}. For reference, with @code{a4} paper the
313 @code{paper-height} is @code{297\mm} and the @code{paper-width} is
318 @file{ly/paper-defaults-init.ly},
319 @file{scm/paper.scm}.
324 Les marges, entête et pied de page, ainsi que les autres variables de
325 mise en page sont automatiquement définis par rapport au format du
328 Les valeurs par défaut des marges, inscrites dans le fichier
329 d'initialisation @file{ly/paper-defaults-init.ly}, s'appliquent
330 au format par défaut (A4 sauf mention spécifique) et sont étalonnées
331 pour les autres formats.
333 Nous allons examiner, dans les paragraphes qui suivent, les différentes
334 variables sur lesquelles vous pouvez intervenir.
337 @node Variables d'espacement vertical fixe
338 @subsection Variables d'espacement vertical fixe
339 @translationof Fixed vertical spacing @code{\paper} variables
343 @funindex paper-height
345 La hauteur de la feuille. Il s'agit par défaut de la dimension du
346 papier utilisé -- voir @ref{Format du papier} pour plus de détails.
351 La marge entre le bord supérieur de la feuille et la surface imprimable.
352 Elle est fixée par défaut à@tie{}@code{5\mm}.
355 @funindex bottom-margin
357 La marge entre la surface imprimable et le bord inférieur de la feuille.
358 Elle est fixée par défaut à@tie{}@code{6\mm}.
361 @funindex ragged-bottom
363 L'activation de cette variable permet de ne pas répartir verticalement
364 les systèmes sur les pages hormis la dernière. La valeur par défaut
367 Lorsque la partition ne comporte que deux ou trois systèmes par page,
368 comme pour un conducteur d'orchestre, nous vous conseillons d'activer
371 @item ragged-last-bottom
372 @funindex ragged-last-bottom
374 La désactivation de cette variable permet de répartir verticalement les
375 systèmes de la dernière page d'une partition. La valeur par défaut
378 Nous vous conseillons, lorsque des pièces couvrent deux pages ou plus,
379 d'activer cette variable.
381 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
382 dernière page de chacune des parties -- créées à l'aide d'un bloc
383 @code{\bookpart} -- d'un même ouvrage.
389 Fichiers d'initialisation :
390 @file{ly/paper-defaults-init.ly}.
393 @rlsrnamed{Spacing, Espacements}.
397 The titles (from the @code{\header} block) are treated as a
398 system, so @code{ragged-bottom} and @code{ragged-last-bottom} will
399 add space between the titles and the first system of the score.
402 @node Variables d'espacement vertical fluctuant
403 @subsection Variables d'espacement vertical fluctuant
404 @translationof Flexible vertical spacing @code{\paper} variables
406 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
407 entre différents éléments (marges, titres, systèmes ou mouvements), en
408 dilatation ou compression selon le cas. Un certain nombre de variables
409 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
410 ces dimensionnements.
412 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
413 parlons ici n'influencent en rien l'espacement des portées d'un même
414 système. L'espacement au sein des systèmes est géré par des propriétés
415 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
416 définissent au niveau du bloc @code{\score} -- voir à ce sujet
417 @ref{Espacement vertical au sein d'un système}.
421 * Structure des variables d'espacement vertical fluctuant::
422 * Liste des variables d'espacement vertical fluctuant::
425 @node Structure des variables d'espacement vertical fluctuant
426 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
427 @translationof Structure of flexible vertical spacing alists
429 Chacune de ces variables est constituée d'une liste associative à quatre
434 @code{padding} (@emph{décalage}) -- la grandeur minimale de
435 @qq{blanc} qui sépare deux éléments, exprimée en hauteur de portée. On
436 peut le voir comme la hauteur minimale d'un rectangle vide qui devrait
437 s'étendre sur toute la largeur des deux éléments.
440 @code{space} (@emph{espace}) -- la grandeur d'espace par défaut,
441 exprimée en hauteur de portée, séparant les @i{points de référence} de
442 deux éléments, qui évite tout risque de collision en l'absence de
443 dilatation ou compression. Le point de référence d'un titre ou d'un
444 @emph{markup} est son sommet, celui d'un système est la ligne médiane du
445 @code{StaffSymbol} le plus proche -- même lorsqu'une ligne de
446 @qq{non-portée} se trouverait au milieu. Un @code{space} inférieur à
447 @code{padding} ou @code{minimum-distance} sera sans effet, dans la
448 mesure où l'espacement résultant ne saurait être inférieur à
449 @code{padding} ou @code{minimum-distance}.
452 @code{minimum-distance} (@emph{distance-minimale}) -- l'espacement
453 minimal, exprimé en hauteur de portée, entre les points de référence des
454 deux éléments alors qu'il y a déjà un effet de compression. Une
455 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
456 sans effet, dans la mesure où l'espacement résultant ne saurait être
457 inférieur au @code{padding}.
460 @code{stretchability} (@emph{dilatation}) -- le coefficient
461 d'étirement de cet espace. Un coefficient nul permet de figer
462 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
463 positif déterminera la propension d'un espacement à s'étirer, tout
464 en tenant compte du coefficient affecté aux autres espacements.
465 Par exemple, lorsque le coefficient de dilatation d'une dimension est
466 double de celui d'une autre, elle pourra s'étirer deux fois plus que
467 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
468 provoque une @code{programming_error} (erreur de programmation) et est
469 ignorée@tie{}; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
470 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
471 sa valeur est par défaut égale à @code{space}. Notez bien que
472 l'utilisateur ne peut définir une propension à la compression@tie{};
473 elle est en fait égale à
474 (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
478 Lorsque l'impression n'est pas en pleine page -- elle est donc
479 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
480 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
484 @item @code{space}, plus
485 @item @code{minimum-distance} et
486 @item @code{padding}, augmenté de ce qu'il faut pour éviter les
490 Les manières de modifier des listes associatives font l'objet d'un
491 @rusernamed{Modification de listes associatives,chapitre spécifique}.
492 Les variables d'espacement associées au papier ne peuvent se gérer que
493 dans un bloc @code{\paper}.
495 L'exemple suivant indique deux façons de modifier une liste associative.
496 La première déclaration intervient sur une seule clé, alors que la
497 deuxième redéfinit complètement la variable.
501 system-system-spacing #'space = #8
503 score-system-spacing =
506 (minimum-distance . 6)
507 (stretchability . 12))
511 Les valeurs par défaut de ces variables sont répertoriés dans le
512 fichier @file{ly/paper-defaults-init.ly}.
515 @node Liste des variables d'espacement vertical fluctuant
516 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
517 @translationof List of flexible vertical spacing @code{\paper} variables
519 Le nom des dimensionnements à hauteur variable sont de la forme
520 @code{@var{upper}-@var{lower}-spacing}, où @code{@var{upper}} et
521 @code{@var{lower}} représentent les éléments qui doivent être espacés.
522 La distance s'établit entre les points de référence des deux éléments
523 concernés@tie{}: le sommet pour un titre ou un @emph{markup}, la ligne
524 médiane de la portée la plus proche pour un système. Notez bien que,
525 dans les règles de nommage des variables qui suivent, le terme
526 @code{markup} fait référence aussi bien à un @i{markup de titrage}
527 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
528 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
529 distances sont exprimées en espace de portée. Leurs valeurs par défaut
530 sont inscrites dans le fichier @file{ly/paper-defaults-init.ly}.
532 @c TODO: Where do headers/footers fit in? -mp
534 Voici à présent les différentes variables disponibles@tie{}:
537 @item markup-system-spacing
538 @funindex markup-system-spacing
540 détermine l'espacement entre un titre ou un @emph{markup} de premier
541 niveau, et le système qui le suit.
543 @item score-markup-spacing
544 @funindex score-markup-spacing
546 détermine l'espacement entre le dernier système et le titre ou
547 @emph{markup} de haut niveau qui le suit.
549 @item score-system-spacing
550 @funindex score-system-spacing
552 détermine l'espacement entre le dernier système d'une partition et le
553 premier système de la partition suivante, en l'absence de titrage ou
554 @emph{markup} qui les sépare.
556 @item system-system-spacing
557 @funindex system-system-spacing
559 détermine l'espacement entre deux systèmes d'un même mouvement.
561 @item markup-markup-spacing
562 @funindex markup-markup-spacing
564 détermine l'espacement entre deux titres ou @emph{markups} de premier
567 @item last-bottom-spacing
568 @funindex last-bottom-spacing
570 détermine la distance entre le dernier système ou le dernier
571 @emph{markup} de haut niveau, et le bas de la surface imprimable --
572 autrement dit le haut de la marge basse.
574 @item top-system-spacing
575 @funindex top-system-spacing
577 détermine l'espace entre le haut de la surface imprimable (le bas de la
578 marge haute) et le milieu du premier système. Cette variable n'est
579 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
582 @item top-markup-spacing
583 @funindex top-markup-spacing
585 détermine l'espace entre le haut de la surface imprimable (le bas de la
586 marge haute) et le premier titre ou @emph{markup} de premier niveau.
587 Cette variable n'est effective qu'en l'absence de système en haut de
595 @ref{Espacement vertical au sein d'un système}.
598 @rlsrnamed{Spacing,Espacements}.
601 @node Variables d'espacement horizontal
602 @subsection Variables d'espacement horizontal
603 @translationof Horizontal spacing \paper variables
605 @warning{Some @code{@bs{}paper} dimensions are automatically
606 scaled to the paper size, which may lead to unexpected behavior.
607 See @ref{Automatic scaling to paper size}.}
610 * Variables de marge et de largeur::
611 * Variables spécifiques pour l'impression recto-verso::
612 * Variables d'indentation et de décalage::
615 Certaines variables permettent de gérer les dimensionnements
616 horizontaux de la page@tie{}:
619 @node Variables de marge et de largeur
620 @unnumberedsubsubsec Variables de marge et de largeur
621 @translationof @code{\paper} variables for widths and margins
623 Default values (before scaling) that are not listed here are
624 defined in @file{ly/paper-defaults-init.ly}.
629 @funindex paper-width
631 La largeur de la page. Elle correspond par défaut à la largeur du
632 format de papier utilisé -- voir à ce sujet la rubrique
633 @ref{Format du papier}.
638 la longueur d'un système musical. La valeur par défaut est égale à
639 @code{paper-width}, auquel sont retranchés @code{left-margin} et
643 @funindex left-margin
645 la marge entre le bord gauche de la feuille et le début de chaque
646 système. La valeur par défaut est de@tie{}@code{10\mm}.
649 @funindex right-margin
651 La marge entre le bord droit de la page et la fin des systèmes. La
652 valeur par défaut est de@tie{}@code{10\mm}.
654 @item check-consistency
655 @funindex check-consistency
657 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
658 @code{right-margin} et @code{line-width} sont en cohérence, et que
659 l'addition de ces trois éléments ne dépassera pas la largeur du papier
660 (@code{paper-width}). La valeur par défaut est@tie{}@code{##t}.
663 @funindex ragged-right
665 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
666 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
667 La valeur par défaut est @code{##f}.
669 Si la partition ne comporte qu'un seul système, la valeur par défaut
673 @funindex ragged-last
675 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
676 dernier système de façon à occuper toute la longueur de la ligne. La
677 valeur par défaut est@tie{}@code{##f}.
682 Fichiers d'initialisation :
683 @file{ly/paper-defaults-init.ly}.
686 @node Variables spécifiques pour l'impression recto-verso
687 @unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
688 @translationof@code{\paper} variables for two-sided mode
690 Default values (before scaling) are defined in
691 @file{ly/paper-defaults-init.ly}.
702 Cette variable permet de gérer efficacement les impressions recto-verso.
703 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
704 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
705 différentes marges selon qu'il s'agit d'une page paire ou impaire.
706 Cette variable s'applique en lieu et place de @code{left-margin} et
707 @code{right-margin}. La valeur par défaut est@tie{}@code{##f}.
710 @funindex inner-margin
712 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
713 avoir du côté intérieur. Bien entendu, cette variable n'est
714 effective que lorsque vous comptez générer un fichier imprimable en
715 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
716 défaut est de@tie{}@code{10\mm}.
719 @funindex outer-margin
721 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
722 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
723 variable n'est effective que lorsque vous comptez générer un fichier
724 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
725 La valeur par défaut est de@tie{}@code{20\mm}.
728 @funindex binding-offset
730 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
731 valeur de la marge intérieure @code{inner-margin} de telle sorte que
732 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
733 effective que lorsque vous comptez générer un fichier imprimable en
734 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
735 défaut est de@tie{}@code{0}.
740 Fichiers d'initialisation :
741 @file{ly/paper-defaults-init.ly}.
744 @node Variables d'indentation et de décalage
745 @unnumberedsubsubsec Variables d'indentation et de décalage
746 @translationof @code{\paper} variables for shifts and indents
748 Default values (before scaling) that are not listed here are
749 defined in @file{ly/paper-defaults-init.ly}.
753 @item horizontal-shift
754 @funindex horizontal-shift
756 @c This default value is buried in the middle of page.scm. -mp
758 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
759 seront poussés d'autant vers la droite. la valeur par défaut est
765 Le niveau d'indentation du premier système d'une partition. La valeur
766 par défaut est de@tie{}@code{15\mm}.
769 @funindex short-indent
771 Le niveau d'indentation de tous les systèmes hormis le premier. La
772 valeur par défaut est de@tie{}@code{0}.
776 @node Autres variables du bloc \paper
777 @subsection Autres variables du bloc @code{\paper}
778 @translationof Other @code{\paper} variables
781 * Variables de gestion des sauts de ligne::
782 * Variables de gestion des sauts de page::
783 * Variables de gestion des numéros de page::
788 @node Variables de gestion des sauts de ligne
789 @unnumberedsubsubsec Variables de gestion des sauts de ligne
790 @translationof @code{\paper} variables for line breaking
792 @c TODO: Mention that ly:optimal-breaking is on by default? -mp
796 @item max-systems-per-page
797 @funindex max-systems-per-page
799 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
800 variable n'est prise en compte, à ce jour, que par l'option
801 @code{ly:optimal-breaking}, et n'est pas définie.
803 @item min-systems-per-page
804 @funindex min-systems-per-page
806 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
807 cependant aux risques de débordement s'il est trop important. Cette
808 variable n'est prise en compte, à ce jour, que par l'option
809 @code{ly:optimal-breaking}, et n'est pas définie.
811 @item systems-per-page
812 @funindex systems-per-page
814 Le nombre de systèmes que devrait comporter chaque page. Cette variable
815 n'est à ce jour prise en charge que par l'algorithme
816 @code{ly:optimal-breaking} et n'est pas définie par défaut.
819 @funindex system-count
821 Le nombre de systèmes requis par la partition. Cette variable n'est pas
828 @ref{Sauts de ligne}.
831 @node Variables de gestion des sauts de page
832 @unnumberedsubsubsec Variables de gestion des sauts de page
833 @translationof @code{\paper} variables for page breaking
835 Default values not listed here are defined in
836 @file{ly/paper-defaults-init.ly}
840 @item blank-after-score-page-force
841 @funindex blank-after-score-page-force
843 The penalty for having a blank page after the end of one score and
844 before the next. By default, this is smaller than
845 @code{blank-page-force}, so that we prefer blank pages after
846 scores to blank pages within a score.
850 @item blank-last-page-force
851 @funindex blank-last-page-force
853 Pénalité pour fin de partition intervenant sur une page impaire. La
854 valeur par défaut est de@tie{}@code{0}.
856 @item blank-page-force
857 @funindex blank-page-force
859 Pénalité pour apparition d'une page blanche en cours de partition.
860 L'option @code{ly:optimal-breaking} n'en tiendra pas compte puisqu'elle
861 ne conçoit pas la présence d'une page blanche au milieu d'une partition.
862 La valeur par défaut est de@tie{}@code{5}.
864 @funindex page-breaking
866 The page-breaking algorithm to use. Choices are
867 @code{ly:minimal-breaking}, @code{ly:page-turn-breaking}, and
868 @code{ly:optimal-breaking}.
870 @item page-breaking-system-system-spacing
871 @funindex page-breaking-system-system-spacing
873 Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
874 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
875 lorsque @code{page-breaking-system-system-spacing #'padding} a une
876 valeur nettement supérieure à @code{system-system-spacing #'padding},
877 l'algorithme en question aura tendance à disposer moins de systèmes sur
878 une même page. Cette variable est par défaut non définie.
883 Le nombre de pages que devra comporter la partition. Cette variable est
884 par défaut non définie.
891 @ref{Optimisation des sauts de page},
892 @ref{Optimisation des tournes},
893 @ref{Minimisation des sauts de page}.
896 @file{ly/paper-defaults-init.ly}.
899 @node Variables de gestion des numéros de page
900 @unnumberedsubsubsec Variables de gestion des numéros de page
901 @translationof @code{\paper} variables for page numbering
903 Default values not listed here are defined in
904 @file{ly/paper-defaults-init.ly}
908 @item auto-first-page-number
909 @funindex auto-first-page-number
911 L'algorithme qui gère les sauts de page prend en compte le fait que le
912 premier numéro de page soit pair ou impair. Lorsque cette
913 fonctionnalité est activée, l'algorithme des sauts de page décidera de
914 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
915 par un éventuel incrément de un. La valeur par défaut
918 @item first-page-number
919 @funindex first-page-number
921 Le numéro de la première page. La valeur par défaut est
924 @item print-first-page-number
925 @funindex print-first-page-number
927 Cette variable permet d'imprimer le numéro de page y compris sur la
928 première. La valeur par défaut est@tie{}@code{##f}.
930 @item print-page-number
931 @funindex print-page-number
933 La désactivation de cette variable permet d'obtenir des pages non
934 numérotées. La valeur par défaut est@tie{}@code{##t}.
939 Fichiers d'initialisation :
940 @file{ly/paper-defaults-init.ly}.
943 @node Autres variables
944 @unnumberedsubsubsec Autres variables
945 @translationof Miscellaneous @code{\paper} variables
949 @item page-spacing-weight
950 @funindex page-spacing-weight
952 Cette variable définit l'importance relative des espacements entre la
953 page (verticalité) et la ligne (horizontalité). Une valeur élevée
954 privilégiera l'espacement au niveau de la page. La valeur par défaut
955 est de@tie{}@code{#10}.
957 @item print-all-headers
958 @funindex print-all-headers
960 Lorsque cette variable est activée, l'intégralité des champs d'entête
961 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
962 champs @code{piece} et @code{opus}. La valeur par défaut
965 @item system-separator-markup
966 @funindex system-separator-markup
968 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
969 chaque système, comme on le voit dans nombre de partitions orchestrales.
970 Cette variable n'est pas définie par défaut.
972 La commande @code{\slashSeparator} fournit un @emph{markup} relativement
975 @lilypond[quote,ragged-right]
976 #(set-default-paper-size "a6" 'landscape)
979 \relative c' { c1 \break c1 }
982 system-separator-markup = \slashSeparator
991 Fichiers d'initialisation :
992 @file{ly/titling-init.ly}.
995 @rlsrnamed{Spacing,Espacements}.
1000 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1001 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1004 @node Mise en forme de la partition
1005 @section Mise en forme de la partition
1006 @translationof Score layout
1008 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1009 plus particulièrement destinées à gérer la mise en forme de la
1014 * Définition de la taille de portée::
1018 @node Le bloc \layout
1019 @subsection Le bloc @code{\layout}
1020 @translationof The @code{\layout} block
1024 Alors que le bloc @code{\paper} définit le formatage des pages pour
1025 l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
1026 forme spécifique à la partition.
1032 \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
1035 \override TextScript #'padding = #1.0
1036 \override Glissando #'thickness = #3
1043 Manuel de notation :
1044 @ref{Modification des réglages par défaut d'un contexte}.
1047 @rlsrnamed{Spacing,Espacements}.
1050 @node Définition de la taille de portée
1051 @subsection Définition de la taille de portée
1052 @translationof Setting the staff size
1054 @cindex fonte, définition de la taille
1055 @cindex portée, définition de la taille
1056 @funindex layout file
1058 La @strong{taille de portée} (@emph{staff size}) est fixée par défaut à
1059 20@tie{}points. Il existe deux manières de la modifier@tie{}:
1061 La taille des portées peut se définir globalement pour toutes les
1062 partitions d'un même fichier, ou plus précisément d'un bloc
1063 @code{\book}, à l'aide de @code{set-global-staff-size}.
1066 #(set-global-staff-size 14)
1070 Ceci définit donc la hauteur des portées à 14@tie{}points par
1071 défaut@tie{}; toutes les fontes seront ajustées en conséquence.
1074 Vous pouvez aussi spécifier une taille à une partition en particulier en
1075 procédant comme ci-dessous@tie{}:
1081 #(layout-set-staff-size 15)
1086 La fonte Feta fournit les symboles musicaux dans huit tailles
1087 différentes. Chaque fonte correspond à une hauteur particulière de
1088 portée@tie{}; les petites tailles comportent des symboles plus épais
1089 pour correspondre à l'épaisseur relativement plus importante des lignes
1090 de la portée. Le tableau suivant répertorie les différentes tailles de
1094 @multitable @columnfractions .15 .2 .22 .2
1096 @item @b{nom de la fonte}
1097 @tab @b{hauteur de portée (pt)}
1098 @tab @b{hauteur de portée (mm)}
1099 @tab @b{utilisation}
1104 @tab format de poche
1124 @tab carnet de chant
1129 @tab partition standard
1140 @c modern rental material?
1145 Ces fontes sont disponibles à toutes les tailles. La propriété de
1146 contexte @code{fontSize} ainsi que la propriété de mise en forme
1147 @code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
1148 individuellement la taille de chaque portée. La taille de chacune des
1149 portées est relative à la taille globale.
1153 Manuel de notation :
1154 @ref{Indication de la taille de fonte musicale}.
1157 @rlsrnamed{Spacing,Espacements}.
1162 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1163 lignes d'une portée.
1168 @translationof Breaks
1173 * Optimisation des sauts de page::
1174 * Optimisation des tournes::
1175 * Minimisation des sauts de page::
1176 * Sauts explicites::
1177 * Recours à une voix supplémentaire pour gérer les sauts::
1180 @node Sauts de ligne
1181 @subsection Sauts de ligne
1182 @translationof Line breaking
1184 @cindex saut de ligne
1185 @cindex ligne, passer à la suivante
1187 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1188 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1189 trop aérée, et que des lignes consécutives aient à peu près la même
1190 densité. Il arrive parfois que LilyPond n'ait pas judicieusement placé
1191 un saut de ligne@tie{}; il suffit alors d'insérer l'instruction
1192 @code{\break} à l'endroit où vous le jugez utile pour @qq{forcer} le
1193 passage à la ligne suivante, en gardant à l'esprit qu'il ne saurait
1194 intervenir au beau milieu d'une mesure. Autrement dit, un saut de ligne
1195 ne peut se placer que sur une barre, à la fin d'une mesure complète. Si
1196 d'aventure vous voulez forcer un saut de ligne en l'absence de barre de
1197 mesure, vous devrez auparavant insérer une barre invisible -- à l'aide
1198 de @code{\bar@tie{}""} -- et vous assurer qu'aucune portée n'a de note
1199 en cours à ce moment précis, auquel cas le saut en question sera tout
1202 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1203 saut de ligne à la fin de la mesure où elle est explicitée.
1205 LilyPond dispose de deux variables de base pour influencer l'espacement
1206 au niveau des lignes. Toutes deux se définissent dans un bloc
1207 @code{\layout}, @code{indent} réglant l'indentation de la première
1208 ligne, et @code{line-width} la longueur des lignes.
1210 L'activation du commutateur @code{ragged-right} au sein du bloc
1211 @code{\layout} aura pour effet de terminer les système là où il le
1212 feraient normalement plutôt que de les étirer sur toute la longueur de
1213 la ligne. Ceci est particulièrement utile pour de petits fragments ou
1214 pour vérifier la densité induite par l'espacement naturel.
1216 @c TODO Check and add para on default for ragged-right
1218 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1219 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1231 @cindex sauts de ligne réguliers
1232 @cindex portée à quatre mesures
1234 L'utilisation conjointe de @code{\break} et de blancs dans une section
1235 @code{\repeat} vous permettra de positionner des sauts de ligne à
1236 intervalle régulier. Par exemple, les 28 mesures de ce qui suit seront
1237 coupées toutes les quatre mesures, pas ailleurs@tie{}:
1240 << \repeat unfold 7 @{
1241 s1 \noBreak s1 \noBreak
1242 s1 \noBreak s1 \break @}
1243 @emph{en avant la musique !}
1248 Apparemment, je ne vois pas de "snippet" qui corresponde,
1249 à moins que ce ne soit pour allécher vers la section
1250 "4.6 Fitting music onto fewer pages" -JCM
1252 A linebreaking configuration can be saved as a @code{.ly} file
1253 automatically. This allows vertical alignments to be stretched to
1254 fit pages in a second formatting run. This is fairly new and
1255 complicated. More details are available in
1268 Référence des propriétés internes :
1269 @rinternals{LineBreakEvent}.
1272 @rlsrnamed{Spacing,Espacements}.
1277 Un saut de ligne ne peut intervenir qu'au moment d'une barre de mesure.
1278 Une note qui resterait en suspend faussera la mesure comme vous pouvez
1279 le constater ci-dessous.
1281 @lilypond[quote,ragged-right,relative=2,verbatim]
1282 c4 c2 << c2 {s4 \break } >> % this does nothing
1283 c2 c4 | % a break here would work
1284 c4 c2 c4 ~ \break % as does this break
1288 Le seul moyen d'obtenir ce que vous voulez en pareil cas consiste à
1289 désactiver le @code{Forbid_line_break_engraver}. Notez bien que les
1290 sauts de ligne forcés doivent être saisis au sein d'une expression
1293 @lilypond[quote,ragged-right,relative=2,verbatim]
1295 \remove Forbid_line_break_engraver
1297 c4 c2 << c2 {s4 \break } >> % now the break is allowed
1302 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1303 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1304 introduire la dérogation @code{\override Beam #'breakable = ##t}.
1308 @subsection Sauts de page
1309 @translationof Page breaking
1311 La gestion automatique des sauts de page se contrôle à l'aide des
1312 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1313 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1314 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1315 Elles permettent de forcer, ou d'interdire, un saut de page à l'endroit
1316 indiqué. Comme on peut s'y attendre, @code{\pageBreak} force le saut de
1319 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1320 trouver à des niveaux supérieurs, entre deux partitions ou
1321 @emph{markups} de premier rang.
1323 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1324 gérer la répartition horizontale, LilyPond dispose de commutateurs
1325 équivalents au niveau de la verticalité@tie{}: @code{ragged-bottom} et
1326 @code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
1327 affectés de @code{##t} -- les systèmes ne seront pas répartis sur les
1328 pages y compris la dernière.
1330 Pour de plus amples détails, reportez-vous à @ref{Espacement vertical}.
1332 Les sauts de page sont générés par la fonction @code{page-breaking}.
1333 LilyPond dispose de trois différents algorithmes en la matière@tie{}:
1334 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1335 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1336 activé par défaut, mais rien ne vous empêche d'en changer, par
1337 l'intermédiaire du bloc @code{\paper}@tie{}:
1341 #(define page-breaking ly:page-turn-breaking)
1347 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1348 pages, la gestion des sauts de page finit par devenir très gourmande,
1349 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1350 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1351 sectionner l'ouvrage que vous traitez@tie{}; les sauts de pages seront
1352 alors gérés individuellement au niveau de chacune des parties. Par
1353 ailleurs, cela vous autorisera une gestion différente selon les
1359 subtitle = "Préface"
1362 %% Pour une partie constituée principalement de texte
1363 %% ly:minimal-breaking est plus judicieux.
1364 #(define page-breaking ly:minimal-breaking)
1366 \markup @{ @dots{} @}
1370 %% Cette partie étant purement musicale,
1371 %% retour au style par défaut (optimal-breaking).
1373 subtitle = "Premier mouvement"
1375 \score @{ @dots{} @}
1382 @funindex \pageBreak
1384 @funindex \noPageBreak
1385 @code{\noPageBreak}.
1391 @rlsrnamed{Spacing,Espacements}.
1394 @node Optimisation des sauts de page
1395 @subsection Optimisation des sauts de page
1396 @translationof Optimal page breaking
1398 @funindex ly:optimal-breaking
1400 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1401 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1402 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1403 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1404 n'a aucune notion de ce qu'est une @qq{tourne}.
1409 @rlsrnamed{Spacing,Espacements}.
1412 @node Optimisation des tournes
1413 @subsection Optimisation des tournes
1414 @translationof Optimal page turning
1416 @funindex ly:page-turn-breaking
1418 Aboutir à une configuration des sauts de page de telle sorte que les
1419 pages de droite se terminent toujours par un silence devient souvent une
1420 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1421 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1422 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1423 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1424 ne saurait intervenir qu'à certains endroits.
1426 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1427 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1428 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1429 informer la fonction des endroits où les sauts de page sont permis.
1431 Cette deuxième étape se réalise de deux manières différentes. Vous
1432 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1433 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1435 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1436 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1437 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1438 tournes recherchera dans le contexte en question les passages sans note.
1439 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1440 notes@tie{}; autrement dit, il ne restera pas inactif dans la cadre
1441 d'une portée polyphonique dont l'une des parties contiendrait des
1442 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1443 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1444 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1445 @qq{barre spéciale} -- telle une double barre -- auquel cas il y
1446 déposera le @code{\allowPageTurn}.
1448 @funindex minimumPageTurnLength
1450 Le @code{Page_turn_engraver} examine la propriété de contexte
1451 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1452 longueur d'un fragment sans note avant une tourne. La valeur par
1453 défaut de @code{minimumPageTurnLength} est
1454 @code{#(ly:make-moment@tie{}1@tie{}1)}, soit une ronde, et s'ajuste de
1455 la manière suivante@tie{}:
1458 \new Staff \with @{ \consists "Page_turn_engraver" @}
1461 R1 | % une tourne peut se placer ici
1463 \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1464 R1 | % il ne peut pas y avoir de tourne ici
1466 R1*2 | % une tourne peut se placer ici
1471 @funindex minimumRepeatLengthForPageTurn
1473 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1474 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1475 temps au début et à la fin de la reprise pour que l'exécutant ait le
1476 temps de revenir à la page précédente. Le @code{Page_turn_engraver} est
1477 même capable d'interdire un tourne dans le cas d'une reprise de courte
1478 durée, ajustable au travers de la propriété de contexte
1479 @code{minimumRepeatLengthForPageTurn}.
1481 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1482 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1483 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1489 @funindex \noPageTurn
1491 @funindex \allowPageTurn
1492 @code{\allowPageTurn}.
1498 @rlsrnamed{Spacing,Espacements}.
1503 Une partition ne devrait contenir qu'une seule instance du
1504 @code{Page_turn_engraver}, au risque de se contredire les uns les autres.
1507 @node Minimisation des sauts de page
1508 @subsection Minimisation des sauts de page
1509 @translationof Minimal page breaking
1511 @funindex ly:minimal-breaking
1513 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1514 calculs pour positionner les sauts de page. Elle mettra le plus de
1515 systèmes possible sur une page avant de passer à la suivante. On peut
1516 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1517 lorsque les autres fonctions de gestion des sauts de page ralentissent
1518 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1519 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1520 @code{\paper}@tie{}:
1524 #(define page-breaking ly:minimal-breaking)
1531 @rlsrnamed{Spacing,Espacements}.
1534 @node Sauts explicites
1535 @subsection Sauts explicites
1536 @translationof Explicit breaks
1538 Il arrive parfois que LilyPond rejette des @code{\break} ou des
1539 @code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
1540 avec ces deux instructions dérogatoires@tie{}:
1543 \override NonMusicalPaperColumn #'line-break-permission = ##f
1544 \override NonMusicalPaperColumn #'page-break-permission = ##f
1547 Lorsque vous désactivez @code{line-break-permission}, LilyPond
1548 ne passera à la ligne suivante qu'en présence d'un @code{\break}
1549 explicite, et nulle part ailleurs. De la même façon, la désactivation
1550 de @code{page-break-permission} aura pour conséquence que LilyPond ne
1551 changera de page que lorsqu'il rencontrera un @code{\pageBreak}, et
1552 nulle part ailleurs.
1554 @lilypond[quote,verbatim]
1563 \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
1564 \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1565 \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1566 \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
1567 \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
1568 \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1569 \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1570 \repeat unfold 2 { c'8 c'8 c'8 c'8 }
1575 \override NonMusicalPaperColumn #'line-break-permission = ##f
1576 \override NonMusicalPaperColumn #'page-break-permission = ##f
1585 @rlsrnamed{Spacing,Espacements}.
1588 @node Recours à une voix supplémentaire pour gérer les sauts
1589 @subsection Recours à une voix supplémentaire pour gérer les sauts
1590 @translationof Using an extra voice for breaks
1592 La plupart du temps, les informations concernant les sauts de ligne ou
1593 de page se retrouvent directement au milieu des notes.
1598 \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
1600 \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
1605 Bien que cela constitue un moyen aisé de saisir les commandes
1606 @code{\break} et @code{\pageBreak}, les données musicales se retrouvent
1607 mélangées à des informations qui concernent plutôt l'agencement de la
1608 musique sur le papier. Vous pouvez tout à fait séparer ce qui est
1609 purement musical et les informations concernant les sauts de ligne ou de
1610 page en créant une voix supplémentaire dédiée. Cette voix spécifique
1611 ne contiendra que des blancs -- des silences invisibles @code{\skip} --,
1612 des @code{\break}, des @code{\pageBreak} et autres informations
1613 concernant les ruptures.
1615 @lilypond[quote,verbatim]
1625 \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1626 \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1627 \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1628 \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1634 Cette manière de procéder est tout à fait indiquée lorsque vous ajustez
1635 les @code{line-break-system-details} et autres propriétés fort
1636 intéressantes de @code{NonMusicalPaperColumnGrob}, comme vous pouvez
1637 le voir au chapitre @ref{Espacement vertical}.
1639 @lilypond[quote,verbatim]
1643 \overrideProperty "Score.NonMusicalPaperColumn"
1644 #'line-break-system-details #'((Y-offset . 0))
1647 \overrideProperty "Score.NonMusicalPaperColumn"
1648 #'line-break-system-details #'((Y-offset . 35))
1651 \overrideProperty "Score.NonMusicalPaperColumn"
1652 #'line-break-system-details #'((Y-offset . 70))
1655 \overrideProperty "Score.NonMusicalPaperColumn"
1656 #'line-break-system-details #'((Y-offset . 105))
1660 \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1661 \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1662 \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1663 \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1671 Manuel de notation :
1672 @ref{Espacement vertical}.
1675 @rlsrnamed{Spacing,Espacements}.
1678 @node Espacement vertical
1679 @section Espacement vertical
1680 @translationof Vertical spacing
1682 @cindex vertical, espacement
1683 @cindex espacement vertical
1685 L'espacement vertical dépend de trois éléments@tie{}: la surface
1686 disponible -- par exemple format de papier et marges --, l'espace qui
1687 doit séparer les systèmes, et l'espace qui sépare les portées d'un même
1691 * Espacement vertical au sein d'un système::
1692 * Positionnement explicite des portées et systèmes::
1693 * Résolution des collisions verticales::
1696 @node Espacement vertical au sein d'un système
1697 @subsection Espacement vertical au sein d'un système
1698 @translationof Flexible vertical spacing within systems
1700 @cindex distance entre les portées
1701 @cindex portées, espacement
1702 @cindex espacement entre les portées
1703 @cindex espacement au sein d'un système
1705 LilyPond dispose de trois différents mécanismes permettant de contrôler
1706 l'espacement au sein d'un système selon trois catégories@tie{}:
1710 @emph{portées isolées},
1713 @emph{portées regroupées} (portées d'un même groupe, telles celles
1714 d'un @code{ChoirStaff}, etc.), et
1717 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
1721 @c TODO: Clarify this. This almost implies that non-staff lines
1722 @c have NO effect on the spacing between staves. -mp
1724 La hauteur de chaque système se détermine en deux phases. Les portées
1725 sont tout d'abord espacées selon la surface disponible. Puis les lignes
1726 autres que des portées, comme les paroles ou les accords, sont réparties
1729 Les paragraphes qui suivent traitent exclusivement de la manière de
1730 gérer l'espacement entre les lignes d'un système -- portée musicale ou
1731 non. Pour ce qui a trait aux espacements entre les systèmes,
1732 mouvements, annotations et marge, ils sont contrôlés par des variables
1733 attachées au bloc @code{\paper} et font l'objet du chapitre
1734 @ref{Dimensionnement vertical fluctuant}.
1737 * Propriétés d'espacement au sein d'un système::
1738 * Espacement de portées isolées::
1739 * Espacement de portées regroupées::
1740 * Espacement des lignes rattachées à des portées::
1744 @node Propriétés d'espacement au sein d'un système
1745 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
1746 @translationof Within-system spacing properties
1748 L'espacement entre les portées est géré par deux jeux de propriétés
1749 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
1750 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
1751 ou de non-portée. Le second, associé à l'objet graphique
1752 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
1753 de portées particulier. Les propriétés qui leur sont attachées sont
1754 abordées en fin de section.
1756 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
1757 @code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
1758 @code{@var{item2}} étant les éléments à espacer. Notez bien que
1759 @code{@var{item2}} n'est pas forcément placé au-dessous@tie{}: c'est le
1760 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
1761 la distance entre une ligne de non-portée alors que sa
1762 @code{staff-affinity} a été déterminée à @code{#UP}.
1764 Toutes ces distances sont mesurées entre les points de référence
1765 respectifs de éléments considérés.
1766 Le @i{point de référence} d'une portée est le centre vertical du
1767 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
1768 l'interligne médian si @code{line-count} est pair.
1769 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
1770 tableau suivant présente le @i{point de référence} pour chacun d'entre
1773 @multitable {Non-staff line} {Reference point}
1774 @headitem Ligne de non-portée @tab Point de référence
1775 @item @code{ChordNames} @tab ligne de base
1776 @item @code{NoteNames} @tab ligne de base
1777 @item @code{Lyrics} @tab ligne de base
1778 @item @code{Dynamics} @tab centre vertical
1779 @item @code{FiguredBass} @tab point le plus haut
1780 @item @code{FretBoards} @tab ligne supérieure
1783 En voici une représentation graphique@tie{}:
1786 @lilypond[quote,noragged-right,line-width=110\mm]
1787 #(define zero-space '((padding . -inf.0) (space . 0)))
1789 alignToZero = \with {
1790 \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
1791 \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
1793 lowerCaseChords = \with {
1794 chordNameLowercaseMinor = ##t
1796 staffAffinityDown = \with {
1797 \override VerticalAxisGroup #'staff-affinity = #DOWN
1800 #(define-music-function
1801 (parser location context)
1803 #{ s1*0^\markup { \typewriter $context } #})
1806 \context { \Dynamics \alignToZero }
1807 \context { \FiguredBass \alignToZero }
1808 \context { \Lyrics \alignToZero }
1809 \context { \NoteNames \alignToZero }
1810 \context { \ChordNames \alignToZero \lowerCaseChords }
1811 \context { \FretBoards \alignToZero \staffAffinityDown }
1813 \override BarLine #'stencil = ##f
1814 \override DynamicText #'self-alignment-X = #-1
1815 \override FretBoard #'X-offset = #1.75
1816 \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
1817 \override InstrumentName #'extra-offset = #'(0 . -0.5)
1818 \override TextScript #'minimum-Y-extent = #'(-2 . 3)
1819 \override TimeSignature #'stencil = ##f
1823 %% Contextes dont le point de référence est la ligne de base :
1824 %% ChordNames, NoteNames, et Lyrics
1826 \new ChordNames { \chords { g1:m } }
1827 \new NoteNames { s1 | g1 | }
1828 \new RhythmicStaff {
1829 \set RhythmicStaff.instrumentName = #"ligne de base (baseline) "
1831 \labelContext "ChordNames" s1 |
1832 \labelContext "NoteNames" s1 |
1833 \labelContext "Lyrics" s1 |
1835 \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
1838 %% Le point de référence de Dynamics est le milieu de la ligne
1840 \new RhythmicStaff {
1841 \set RhythmicStaff.instrumentName = #"centre vertical "
1842 \labelContext "Dynamics" s1*3
1844 \new Dynamics { s2\mp s\fp }
1847 %% Le point de référence de FiguredBass est son point le plus haut
1849 \new RhythmicStaff {
1850 \set RhythmicStaff.instrumentName = #"point le plus haut "
1851 \labelContext "FiguredBass" s1
1853 \new FiguredBass { \figuremode { <6 5>1 } }
1856 %% Le point de référence de FretBoards est la ligne du haut
1857 \include "predefined-guitar-fretboards.ly"
1859 \new FretBoards { \chordmode { e1 } }
1860 \new RhythmicStaff {
1861 \set RhythmicStaff.instrumentName = #"ligne du haut "
1862 \labelContext "FretBoards " s1
1867 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
1868 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
1869 sous la forme d'une liste associative dont les composantes sont
1870 identiques à celle des variables du bloc @code{\paper} que nous avons
1871 examinées au chapitre @ref{Dimensionnement vertical fluctuant}.
1873 Les particularités en matière de modification d'une liste associative
1875 @rusernamed{Modification de listes associatives,chapitre particulier}.
1876 Les propriétés des objets graphiques se règlent avec un @code{\override}
1877 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
1880 L'exemple suivant illustre deux façons de modifier une liste
1881 associative. La première déclaration n'agit que sur une seule clé,
1882 alors que la seconde redéfinit la propriété dans son intégralité.
1886 \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
1890 \override VerticalAxisGroup #'staff-staff-spacing =
1893 (minimum-distance . 9)
1894 (stretchability . 10))
1898 La modification d'un espacement au niveau global se mentionne au sein du
1899 bloc @code{\layout}@tie{}:
1905 \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
1910 Les réglages concernant les propriétés d'espacement vertical des objets
1911 graphiques sont répertoriées aux chapitres
1912 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
1913 Les propriétés relatives aux lignes de non-portée sont répertoriées
1914 selon la définition de leur contexte dans la
1915 @rinternalsnamed{Contexts,Référence des propriétés internes}.
1918 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
1919 @translationof Properties of the @code{VerticalAxisGroup} grob
1921 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
1922 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
1926 @item staff-staff-spacing
1927 Il s'agit de la distance entre la portée en cours et la portée qui suit
1928 au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
1929 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
1930 pas à la dernière portée d'un système.
1931 Cette propriété écrase les réglages hérités du @emph{grob}
1932 @code{StaffGrouper} d'un éventuel regroupement.
1933 Lorsque @code{staff-staff-spacing} n'est pas défini et qu'il n'y a pas
1934 de @code{StaffGrouper} dont on pourrait hériter des propriétés, c'est la
1935 propriété @code{default-staff-staff-spacing} qui s'applique.
1937 @item default-staff-staff-spacing
1938 Il s'agit de la distance qui s'appliquera, dans le cas où
1939 @code{staff-staff-spacing} n'aura pas été défini, aussi bien pour les
1940 portées isolées que dans le cas où les portées d'un regroupement
1941 n'hériteraient pas des ajustements du @code{StaffGrouper} concerné.
1943 @item staff-affinity
1944 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
1945 que prendra une ligne de non-portée pour aller s'accoler aux portées
1946 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
1947 non-portée ira se placer à équidistance entre les portées qui
1948 l'encadrent, tout en tenant compte des éventuels risques de collision et
1949 des autres contraintes d'espacement. Des lignes de non-portée
1950 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
1951 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
1952 Une ligne de non-portée en dessous d'un système devrait avoir sa
1953 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
1954 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
1955 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
1956 @code{staff-affinity}@tie{}: si vous lui affectez la valeur @code{#f} à
1957 une ligne de non-portée, cette ligne sera considérée comme étant une
1958 portée@tie{}; à l'inverse, utiliser la propriété @code{staff-affinity}
1959 pour une portée lui fera perdre cette qualité.
1961 @c TODO: verify last clause below ("even if other...")
1963 @item nonstaff-relatedstaff-spacing
1964 Il s'agit de la distance entre la ligne de non-portée en cours et la
1965 portée la plus proche selon la @code{staff-affinity}, à la double
1966 condition qu'il n'y a pas déjà une autre ligne de non-portée et que la
1967 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
1968 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
1969 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
1970 non-portée entre les deux portées adjacentes même si une autre
1971 non-portée est présente (quelque soit le côté).
1973 @item nonstaff-nonstaff-spacing
1974 Il s'agit de la distance entre deux lignes de non-portée selon
1975 l'orientation définie par @code{staff-affinity} et qu'elles ont la même
1976 orientation. Bien entendu, ceci ne peut concerner que les valeurs
1977 @code{UP} et @code{DOWN} de @code{staff-affinity}.
1979 @item nonstaff-unrelatedstaff-spacing
1980 Il s'agit de la distance entre une ligne de non-portée et la portée à
1981 l'opposé de l'orientation adoptée, à la double condition qu'il n'y a pas
1982 déjà une autre ligne de non-portée et que la valeur de
1983 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
1984 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
1985 portée à laquelle elle ne correspond pas.
1989 @subsubheading Propriétés de l'objet @code{StaffGrouper}
1990 @translationof Properties of the @code{StaffGrouper} grob
1992 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
1993 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
1997 @item staff-staff-spacing
1998 Il s'agit de la distance entre deux portées consécutives d'un même
1999 système. Cependant, lorsque l'une des portées d'un regroupement s'est
2000 vue définir la propriété @code{staff-staff-spacing} de son
2001 @code{VerticalAxisGroup}, le @code{VerticalAxisGroup} aura préséance.
2002 Voir aussi la propriété @code{default-staff-staff-spacing}.
2004 @item staffgroup-staff-spacing
2005 Il s'agit de la distance entre la dernière portée d'un regroupement et
2006 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2007 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2008 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2009 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2010 regroupement a été ajustée au niveau de son @code{VerticalAxisGroup},
2011 cette dernière aura préséance. Voir aussi la propriété
2012 @code{default-staff-staff-spacing}.
2017 Fichiers d'initialisation :
2018 @file{ly/engraver-init.ly},
2019 @file{scm/define-grobs.scm}.
2021 Référence des propriétés internes :
2022 @rinternals{Contexts},
2023 @rinternals{VerticalAxisGroup},
2024 @rinternals{StaffGrouper}.
2027 @node Espacement de portées isolées
2028 @unnumberedsubsubsec Espacement de portées isolées
2029 @translationof Spacing of ungrouped staves
2031 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2032 des contextes de @qq{portée} pouvant contenir plusieurs voix, mais pas
2035 L'espacement de ces @i{portées isolées} est géré par les propriétés
2039 @item Propriétés du @code{VerticalAxisGroup} :
2041 @item @code{staff-staff-spacing}
2045 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2046 @ref{Propriétés d'espacement au sein d'un système}.
2048 Certaines propriétés supplémentaires s'appliqueront dès lors que
2049 ces portées sont regroupées -- voir
2050 @ref{Espacement de portées regroupées}.
2052 L'exemple suivant illustre la manière de gérer l'espacement de portées
2053 isolées à l'aide de la propriété @code{staff-staff-spacing}@tie{}:
2055 @lilypond[verbatim,quote,staffsize=16]
2059 \override VerticalAxisGroup #'staff-staff-spacing =
2062 (minimum-distance . 7))
2067 % The very low note here needs more room than 'space can
2068 % provide, so the distance between this staff and the next is
2069 % determined by 'padding.
2070 \new Staff { b,2 r | }
2072 % Here, 'space provides enough room, and there is no need to
2073 % compress the space (towards 'minimum-distance) to make room
2074 % for anything else on the page, so the distance between this
2075 % staff and the next is determined by 'space.
2076 \new Staff { \clef bass g2 r | }
2078 % By setting 'padding to a negative value, staves can be made to
2079 % collide. The lowest acceptable value for 'space is 0.
2081 \override VerticalAxisGroup #'staff-staff-spacing =
2084 } { \clef bass g2 r | }
2085 \new Staff { \clef bass g2 r | }
2091 Fichiers d'initialisation :
2092 @file{scm/define-grobs.scm}.
2095 @rlsrnamed{Spacing,Espacements}.
2097 Référence des propriétés internes :
2098 @rinternals{VerticalAxisGroup}.
2101 @node Espacement de portées regroupées
2102 @unnumberedsubsubsec Espacement de portées regroupées
2103 @translationof Spacing of grouped staves
2105 Dans les partitions orchestrales ou de grande ampleur, il arrive
2106 souvent que des portées soient regroupées. L'espacement est alors plus
2107 important entre deux regroupements qu'entre les portées d'un même
2110 Les @i{regroupement de portées} tels le @code{StaffGroup} ou le
2111 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2112 une ou plusieurs portées.
2114 L'espacement entre les portées d'un même regroupement est géré par les
2115 propriétés suivantes@tie{}:
2118 @item Propriétés du @code{VerticalAxisGroup} :
2120 @item @code{staff-staff-spacing}
2121 @item @code{default-staff-staff-spacing}
2123 @item Propriétés du @code{StaffGrouper} :
2125 @item @code{staff-staff-spacing}
2126 @item @code{staffgroup-staff-spacing}
2130 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2131 @ref{Propriétés d'espacement au sein d'un système}.
2133 L'exemple suivant illustre la manière de gérer l'espacement de portées
2134 regroupes, à l'aide des propriétés de l'objet graphique
2135 @code{StaffGrouper}@tie{}:
2137 @lilypond[verbatim,quote,staffsize=16]
2141 \override StaffGrouper #'staff-staff-spacing #'padding = #0
2142 \override StaffGrouper #'staff-staff-spacing #'space = #1
2147 \new PianoStaff \with {
2148 \override StaffGrouper #'staffgroup-staff-spacing #'space = #20
2163 Fichiers d'initialisation :
2164 @file{scm/define-grobs.scm}.
2167 @rlsrnamed{Spacing,Espacements}.
2169 Référence des propriétés internes:
2170 @rinternals{VerticalAxisGroup},
2171 @rinternals{StaffGrouper}.
2173 @node Espacement des lignes rattachées à des portées
2174 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2175 @translationof Spacing of non-staff lines
2177 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2178 @code{ChordNames} sont des contextes dont les objets de rendu sont
2179 gravés à l'instar des portées -- une ligne horizontale dans un système.
2180 En fait, les lignes de non-portée sont des contextes qui vont créer un
2181 objet de rendu @code{VerticalAxisGroup}.
2183 L'espacement des lignes de non-portée est géré par les propriétés
2187 @item Propriétés du @code{VerticalAxisGroup} :
2189 @item @code{staff-affinity}
2190 @item @code{nonstaff-relatedstaff-spacing}
2191 @item @code{nonstaff-nonstaff-spacing}
2192 @item @code{nonstaff-unrelatedstaff-spacing}
2196 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2197 @ref{Propriétés d'espacement au sein d'un système}.
2199 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2200 pour gérer l'espacement entre des lignes consécutives de non-portée.
2201 Vous noterez que la valeur élevée attribuée à la clé
2202 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2204 @lilypond[verbatim,quote,staffsize=16]
2208 \override VerticalAxisGroup
2209 #'nonstaff-nonstaff-spacing #'stretchability = #1000
2216 \override VerticalAxisGroup #'staff-staff-spacing = #'((space . 30))
2219 \override VerticalAxisGroup #'staff-affinity = #UP
2222 \override VerticalAxisGroup #'staff-affinity = #CENTER
2223 } \lyricmode { center }
2225 \override VerticalAxisGroup #'staff-affinity = #DOWN
2226 } \lyricmode { down }
2233 Fichiers d'initialisation :
2234 @file{ly/engraver-init.ly},
2235 @file{scm/define-grobs.scm}.
2238 @rlsrnamed{Spacing,Espacements}.
2240 @c @lsr{spacing,page-spacing.ly},
2241 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2243 Référence des propriétés internes :
2244 @rinternals{Contexts},
2245 @rinternals{VerticalAxisGroup}.
2248 @node Positionnement explicite des portées et systèmes
2249 @subsection Positionnement explicite des portées et systèmes
2250 @translationof Explicit staff and system positioning
2252 Pour bien comprendre comment fonctionnent les réglages de
2253 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2254 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2255 les différentes mises au point du décalage vertical appliqué aux portées
2256 et systèmes distribués sur une page.
2258 Une autre approche de l'espacement vertical est le recours à
2259 @code{NonMusicalPaperColumn #'line-break-system-details}. Alors que
2260 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2261 @code{NonMusicalPaperColumn #'line-break-system-details} spécifiera le
2262 positionnement vertical absolu sur la page.
2264 @code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
2265 une liste associative de trois mises au point@tie{}:
2268 @item @code{X-offset}
2269 @item @code{Y-offset}
2270 @item @code{alignment-distances}
2273 Les dérogations en matière d'objet graphique, y compris celles
2274 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2275 à trois différents endroits de votre fichier source@tie{}:
2278 @item directement au beau milieu des notes
2279 @item au sein d'un bloc @code{\context}
2280 @item dans un bloc @code{\with}
2283 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2284 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2285 @code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
2286 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2287 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2288 de la commande @code{\overrideProperty}@tie{}:
2291 \overrideProperty NonMusicalPaperColumn
2292 #'line-break-system-details #'((X-offset . 20))
2294 \overrideProperty NonMusicalPaperColumn
2295 #'line-break-system-details #'((Y-offset . 40))
2297 \overrideProperty NonMusicalPaperColumn
2298 #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
2300 \overrideProperty NonMusicalPaperColumn
2301 #'line-break-system-details #'((alignment-distances . (15)))
2303 \overrideProperty NonMusicalPaperColumn
2304 #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
2305 (alignment-distances . (15)))
2308 Nous allons maintenant voir ces différents réglages en action.
2309 Commençons par examiner un exemple dépourvu de toute mise au point.
2311 @c \book { } is required in these examples to ensure the spacing
2312 @c overrides can be seen between systems. -np
2315 \header { tagline = ##f }
2316 \paper { left-margin = 0\mm }
2326 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2329 \repeat unfold 15 { d'4 d' d' d' }
2336 Cette partition isole les informations de saut de ligne ou de page dans
2337 une voix spécifique. La mise en forme est ainsi séparée des événements
2338 musicaux@tie{}; ceci nous permettra d'y voir plus clair au fur et à
2339 mesure que nous avancerons. Pour plus de précisions, relisez
2340 @ref{Recours à une voix supplémentaire pour gérer les sauts}.
2342 Les @code{\breaks} explicites répartissent la musique en lignes de cinq
2343 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2344 par défaut. Nous pouvons, afin de fixer explicitement le point
2345 d'attache vertical de chacun des systèmes, définir un doublet
2346 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2347 de l'objet @code{NonMusicalPaperColumn}@tie{}:
2350 \header { tagline = ##f }
2351 \paper { left-margin = 0\mm }
2357 \overrideProperty #"Score.NonMusicalPaperColumn"
2358 #'line-break-system-details #'((Y-offset . 0))
2360 \overrideProperty #"Score.NonMusicalPaperColumn"
2361 #'line-break-system-details #'((Y-offset . 40))
2363 \overrideProperty #"Score.NonMusicalPaperColumn"
2364 #'line-break-system-details #'((Y-offset . 80))
2367 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2370 \repeat unfold 15 { d'4 d' d' d' }
2377 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2378 si la liste associative de @code{line-break-system-details} peut en
2379 comporter un certain nombre. Vous aurez aussi noté que la propriété
2380 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2383 Maintenant que chaque système est explicitement positionné, nous pouvons
2384 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2385 à la sous-propriété @code{alignment-distances} de
2386 @code{line-break-system-details}.
2389 \header { tagline = ##f }
2390 \paper { left-margin = 0\mm }
2396 \overrideProperty #"Score.NonMusicalPaperColumn"
2397 #'line-break-system-details #'((Y-offset . 20)
2398 (alignment-distances . (15)))
2400 \overrideProperty #"Score.NonMusicalPaperColumn"
2401 #'line-break-system-details #'((Y-offset . 60)
2402 (alignment-distances . (15)))
2404 \overrideProperty #"Score.NonMusicalPaperColumn"
2405 #'line-break-system-details #'((Y-offset . 100)
2406 (alignment-distances . (15)))
2409 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2412 \repeat unfold 15 { d'4 d' d' d' }
2419 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2420 @code{line-break-system-details} de l'objet
2421 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2422 prendre bien d'autres paramètres d'espacement, y compris un doublet
2423 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2424 @code{alignment-distances} pour contrôler le positionnement de chaque
2425 système et de chaque portée. Vous noterez enfin que
2426 @code{alignment-distances} traite le positionnement des portées, non
2427 d'un regroupement de portées.
2430 \header { tagline = ##f }
2431 \paper { left-margin = 0\mm }
2437 \overrideProperty #"Score.NonMusicalPaperColumn"
2438 #'line-break-system-details #'((Y-offset . 0)
2439 (alignment-distances . (30 10)))
2441 \overrideProperty #"Score.NonMusicalPaperColumn"
2442 #'line-break-system-details #'((Y-offset . 60)
2443 (alignment-distances . (10 10)))
2445 \overrideProperty #"Score.NonMusicalPaperColumn"
2446 #'line-break-system-details #'((Y-offset . 100)
2447 (alignment-distances . (10 30)))
2450 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2453 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2454 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2461 Quelques points à prendre en considération@tie{}:
2465 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2466 autres lignes de non-portée ne comptent pas pour une portée.
2469 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2470 @code{alignment-distances} sont considérés comme des multiples de la
2471 distance entre des portées adjacentes. Des valeurs positives remontent
2472 les portées et paroles, des valeurs négatives les descendent.
2475 Dans la mesure où @code{NonMusicalPaperColumn
2476 #'line-break-system-details} permet de positionner systèmes et portées
2477 n'importe où sur une page, vous pourriez être en contradiction avec les
2478 dimensionnements de la feuille ou bien aboutir à des surimpressions.
2479 Soyez donc raisonnables quant aux différentes valeurs que vous affectez
2487 @rlsrnamed{Spacing,Espacements}.
2490 @node Résolution des collisions verticales
2491 @subsection Résolution des collisions verticales
2492 @translationof Vertical collision avoidance
2494 @funindex outside-staff-priority
2495 @funindex outside-staff-padding
2496 @funindex outside-staff-horizontal-padding
2498 Vous savez de manière intuitive qu'un certain nombre d'objets en
2499 matière de notation musicale appartiennent à la portée, et que
2500 d'autres se placent en dehors de la portée. Entre autres objets
2501 externes, nous avons les marques repères, les textes et les
2502 nuances@tie{}; nous les appellerons @qq{objets extérieurs à la portée}.
2503 La règle qu'applique LilyPond pour positionner verticalement ces
2504 objets extérieurs consiste à les placer au plus près de la portée
2505 tout en prenant garde d'éviter qu'il y ait chevauchement.
2507 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2508 déterminer si un objet est ou non un objet extérieur à la portée@tie{}:
2509 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2510 s'agit d'un objet extérieur à la portée. De plus, la propriété
2511 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2512 objets doivent être disposés.
2514 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2515 Les objets extérieurs à la portée sont alors triés selon l'ordre
2516 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2517 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2518 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2519 lorsque deux objets devraient se placer au même endroit, celui dont la
2520 @code{outside-staff-priority} est la plus faible sera disposé au plus
2523 @lilypond[quote,ragged-right,relative=2,verbatim]
2526 \once \override TextScript #'outside-staff-priority = #1
2527 c4_"Text"\pp % this time the text will be closer to the staff
2529 % by setting outside-staff-priority to a non-number,
2530 % we disable the automatic collision avoidance
2531 \once \override TextScript #'outside-staff-priority = ##f
2532 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2533 c4_"Text"\pp % now they will collide
2536 Le décalage vertical entre un objet extérieur à la portée et celui qui
2537 le précède se contrôle par la propriété @code{outside-staff-padding}.
2540 @lilypond[quote,ragged-right,relative=2,verbatim]
2541 \once \override TextScript #'outside-staff-padding = #0
2542 a'^"Ce texte est placé au plus près de la note"
2543 \once \override TextScript #'outside-staff-padding = #3
2544 c^"Ce texte est décalé par rapport au texte précédent"
2545 c^"Ce texte est accolé au texte précédent"
2548 Par défaut, les objets extérieurs à la portée sont positionnés en
2549 évitant les collisions horizontales avec des objets précédemment
2550 positionnés. Ceci peut cependant générer des situations où des objets
2551 se trouvent horizontalement trop proches. L'espacement vertical entre
2552 les portées peut dans une certaine mesure permettre de mieux intercaler
2553 les objets extérieurs à la portée. La propriété
2554 @code{outside-staff-horizontal-padding} repoussera verticalement un
2555 objet pour éviter ce genre de situation.
2557 @lilypond[quote,ragged-right,relative=2,verbatim]
2558 % the markup is too close to the following note
2562 % setting outside-staff-horizontal-padding fixes this
2564 \once \override TextScript #'outside-staff-horizontal-padding = #1
2573 @rlsrnamed{Spacing,Espacements}.
2576 @node Espacement horizontal
2577 @section Espacement horizontal
2578 @translationof Horizontal spacing
2580 @cindex horizontal, espacement
2581 @cindex espacement horizontal
2584 * Généralités sur l'espacement horizontal::
2585 * Changement d'espacement en cours de partition::
2586 * Modification de l'espacement horizontal::
2587 * Longueur de ligne::
2588 * Notation proportionnelle::
2591 @node Généralités sur l'espacement horizontal
2592 @subsection Généralités sur l'espacement horizontal
2593 @translationof Horizontal spacing overview
2595 Le moteur d'espacement traduit les différences de durée en distances
2596 étirables (@emph{springs} pour ressorts) de différente longueur. Des
2597 durées importantes prennent ainsi plus de place que des durées moins
2598 longues. Les durées les plus courtes se verront attribuer un espace
2599 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2600 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2601 plus elle prendra d'espace@tie{}: le doublement d'une durée attribuera à
2602 la note un espace fixé d'après la propriété @code{spacing-increment}.
2604 L'exemple suivant comporte des blanches, des noires et un certain nombre
2605 de croches. La croche est suivie d'un espace de la largeur d'une tête
2606 de note@tie{}; pour la noire , cette espace est de deux têtes@tie{}; il
2607 est de trois pour la blanche.
2609 @lilypond[quote,verbatim,relative=1]
2610 c2 c4. c8 c4. c8 c4. c8 c8
2614 @code{spacing-increment} est normalement défini à 1,2@tie{}espace de
2615 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2616 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2617 s'étendra donc sur l'équivalent de 2,4@tie{}espaces de portée (2 fois le
2618 @code{spacing-increment}). Le point de départ de cet espace se situe à
2619 l'extrémité gauche du symbole@tie{}; la note la plus courte est donc
2620 suivie en général d'un espace égal à la largeur d'une tête de note.
2622 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2623 croche à une partition qui comporte déjà des croches et des doubles
2624 augmentera considérablement son volume@tie{}: la durée la plus
2625 courte n'est plus la double mais la triple croche, ce qui aura
2626 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2627 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2628 courte prise en considération au niveau de l'espacement n'est pas la
2629 note la plus brève de la partition, mais celle qui apparaît le plus
2632 La courte durée la plus fréquente est déterminée à partir de la note la
2633 plus courte de chaque mesure. C'est elle qui servira de base pour
2634 l'espacement, à cette nuance près que la plus courte durée ne saurait
2635 être strictement supérieure à la croche. Cette @qq{durée de référence}
2636 est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
2639 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2640 pour les espacements grâce à la propriété
2641 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2642 La durée maximale de cet étalon, normalement la croche, est gérée par la
2643 propriété @code{base-shortest-duration}.
2645 @funindex common-shortest-duration
2646 @funindex base-shortest-duration
2647 @funindex stem-spacing-correction
2650 Les notes plus courtes que la note témoin sont suivies d'un espace
2651 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2652 doubles croches à l'exemple précédent, elles seraient suivies d'une
2653 demie largeur de tête@tie{}:
2655 @lilypond[quote,verbatim,relative=2]
2656 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2660 Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
2661 vu comment la direction des hampes peut influencer l'espacement -- voir
2662 @ressay{Espacement}. Ceci est contrôlé par la propriété
2663 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing}, créé
2664 pour chaque contexte @rinternals{Voice}. L'objet
2665 @rinternals{StaffSpacing}, généré au niveau d'un contexte @code{Staff},
2666 possède une même propriété qui contrôlera l'espacement hampe-barre de
2667 mesure. L'exemple suivant montre ces adaptations, tout d'abord selon
2668 les réglages par défaut, puis avec des corrections forcées.
2670 @lilypond[quote,ragged-right]
2674 \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2675 \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2681 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
2682 @rusernamed{Notation proportionnelle,rubrique dédiée}.
2687 @rlsrnamed{Spacing,Espacements}.
2689 Référence des propriétés internes :
2690 @rinternals{SpacingSpanner},
2691 @rinternals{NoteSpacing},
2692 @rinternals{StaffSpacing},
2693 @rinternals{NonMusicalPaperColumn}.
2698 Il n'existe pas de mécanisme simple simple et efficace qui permette de
2699 forcer manuellement l'espacement. La solution ci-dessous permet
2700 cependant @qq{d'aérer} artificiellement une partition@tie{}; il vous
2701 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
2704 \override Score.NonMusicalPaperColumn #'padding = #10
2707 Il n'y a aucun moyen de diminuer l'espacement.
2710 @node Changement d'espacement en cours de partition
2711 @subsection Changement d'espacement en cours de partition
2712 @translationof New spacing area
2714 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
2715 substantiellement la notion de valeur brève et valeur longue. La
2716 commande @code{newSpacingSection} permet alors de réinitialiser les
2717 paramètres d'espacement.
2719 Dans l'exemple qui suit, le changement de métrique marque le début
2720 d'une nouvelle partie@tie{}; remarquez comme les doubles-croches sont
2721 alors plus espacées@tie{}:
2723 @lilypond[relative,verbatim,quote]
2726 c8 c c4 c16[ c c8] c4
2732 La commande @code{\newSpacingSection} crée un nouvel objet
2733 @code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
2734 @code{\override}s à partir de ce point.
2739 @rlsrnamed{Spacing,Espacements}.
2741 Référence des propriétés internes :
2742 @rinternals{SpacingSpanner}.
2745 @node Modification de l'espacement horizontal
2746 @subsection Modification de l'espacement horizontal
2747 @translationof Changing horizontal spacing
2749 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
2750 @code{base-shortest-duration}. Comparons les deux partitions qui
2751 suivent, toutes deux montrant la même musique. La première partition
2752 applique les réglages par défaut, alors que la seconde bénéficie
2753 d'ajustement de la propriété @code{base-shortest-duration}. Au plus la
2754 valeur de @code{ly:make-moment} est grande, au plus la musique sera
2755 resserrée. En effet, @code{ly:make-moment} construit une durée@tie{}:
2756 @w{@code{1 4}} est plus long que @w{@code{1 16}}.
2758 @lilypond[verbatim,line-width=12\cm]
2761 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2762 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2763 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2764 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2769 @lilypond[verbatim,line-width=12\cm]
2772 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2773 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2774 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2775 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2780 \override SpacingSpanner
2781 #'base-shortest-duration = #(ly:make-moment 1 16)
2790 L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
2791 facteurs qui ne sont pas liés à la durée (altération, changement de
2792 clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
2793 permet d'ignorer ces symboles et, par voie de conséquence, forcer
2794 l'espacement sur la simple durée. Notez bien que cette propriété
2795 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
2798 @lilypond[quote,ragged-right,verbatim]
2817 \override SpacingSpanner #'uniform-stretching = ##t
2823 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
2824 les notes sans tenir compte des clefs, barres de mesure ou notes
2825 d'ornement qui pourraient apparaître@tie{}:
2827 @lilypond[quote,ragged-right,relative=2,verbatim]
2828 \override Score.SpacingSpanner #'strict-note-spacing = ##t
2829 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
2835 @rlsrnamed{Spacing,Espacements}.
2838 @node Longueur de ligne
2839 @subsection Longueur de ligne
2840 @translationof Line length
2842 @cindex saut de page
2846 @funindex line-width
2847 @funindex ragged-right
2848 @funindex ragged-last
2850 @c Although line-width can be set in \layout, it should be set in paper
2851 @c block, to get page layout right.
2852 @c Setting indent in \paper block makes not much sense, but it works.
2854 @c Bit verbose and vague, use examples?
2855 Deux réglages de bases ont une influence considérable sur
2856 l'espacement@tie{}: @code{line-width} et @code{indent}. Tous deux se
2857 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
2858 lignes et l'indentation de la première.
2860 L'activation du commutateur @code{ragged-right} au sein du bloc
2861 @code{\layout} permet de terminer les systèmes naturellement plutôt que
2862 de les voir s'étirer sur toute la largeur de la page. Cette option est
2863 particulièrement utile lorsque vous traitez de courts fragment, ou bien
2864 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
2865 désactivé par défaut, il sera activé si la partition ne comporte qu'un
2869 @cindex vertical spacing
2871 Le fonctionnement de l'option @code{ragged-last} est en tout point
2872 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
2873 que la dernière ligne de la partition. Il n'y a pas de restriction
2874 quant à cette ligne. Il en va de même que pour le formatage d'un
2875 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
2877 @c Note that for text there are several options for the last line.
2878 @c While Knuth TeX uses natural length, lead typesetters use the same
2879 @c stretch as the previous line. eTeX uses \lastlinefit to
2880 @c interpolate between both these solutions.
2893 @rlsrnamed{Spacing,Espacements}.
2896 @node Notation proportionnelle
2897 @subsection Notation proportionnelle
2898 @translationof Proportional notation
2900 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
2901 ce cas de représenter la notation selon un espacement strictement
2902 relatif aux durées. Ce type d'espacement pourrait se comparer à
2903 l'utilisation de papier millimétré pour positionner les notes au fil de
2904 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
2905 utilisent cette proportionnalité dans le but de clarifier des structures
2906 rythmiques complexes, d'aider au positionnement d'indications
2907 temporelles ou autres éléments graphiques directement dans la partition.
2909 LilyPond met à votre disposition cinq réglages différents, qui peuvent
2910 s'utiliser conjointement ou individuellement, aux fins de mettre au
2911 point cette notation proportionnelle.
2914 @item @code{proportionalNotationDuration}
2916 @item @code{uniform-stretching}
2918 @item @code{strict-note-spacing}
2920 @item @code{\remove Separating_line_group_engraver}
2922 @item @code{\override PaperColumn #'used = ##t}
2926 Nous allons examiner, dans les différents exemples qui suivent, les
2927 effets de ces réglages et comment ils interagissent.
2929 Commençons par cette mesure toute simple qui utilise l'espacement
2930 classique et justifiée à gauche.
2932 @lilypond[quote,verbatim,ragged-right]
2935 \new RhythmicStaff {
2939 c'16 c'16 c'16 c'16 c'16
2946 Vous constatez que la blanche qui entame la mesure prend moins de la
2947 moitié de l'espace. De même, les doubles croches et le quintolet de
2948 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
2949 n'en occupent pas la moitié de l'espace horizontal.
2951 En matière de gravure traditionnelle, cet espacement correspond tout à
2952 fait à nos attentes, puisque nous pouvons rogner l'espace sur la
2953 blanche et ainsi en gagner en largeur sur toute la mesure qui fait une
2956 Par contre, si nous avons besoin d'insérer une indication temporelle ou
2957 un autre graphisme en surplomb ou en dessous de notre partition, nous
2958 aurons besoin de la notation proportionnelle. Celle-ci s'active an
2959 définissant la propriété @code{proportionalNotationDuration}.
2961 @lilypond[quote,verbatim,ragged-right]
2964 \new RhythmicStaff {
2968 c'16 c'16 c'16 c'16 c'16
2975 proportionalNotationDuration = #(ly:make-moment 1 20)
2981 La blanche du début et les notes plus rapides de la deuxième moitié de
2982 la mesure occupent maintenant exactement le même espace horizontal.
2983 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
2984 temporelle ou autre graphisme.
2987 @code{proportionalNotationDuration} est une propriété attachée au
2988 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
2989 propriétés d'un contexte à trois différents endroits de votre
2990 fichier@tie{}: dans un bloc @code{\with}, dans un bloc @code{\context}
2991 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
2992 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
2993 de ces trois façons, à l'instar de n'importe quel définition de
2996 La propriété @code{proportionalNotationDuration} prend en unique
2997 argument la durée de référence qui servira de base pour espacer toute la
2998 musique. La fonction scheme @code{make-moment} intégrée à LilyPond
2999 prend deux arguments@tie{}: un numérateur et un dénominateur qui
3000 représentent une fraction de ronde. L'appel de
3001 @w{@code{#(ly:make-moment 1 20)}} produit donc une durée de référence
3002 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3003 @code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} ou
3004 @code{#(ly:make-moment 3 97)}.
3006 Se pose alors le problème de fournir la juste durée de référence à
3007 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3008 tâtonnement, en commençant par une valeur proche de la note la plus
3009 rapide (la durée la plus courte) du morceau. Au plus la durée de
3010 référence est petite, au plus la musique sera étalée@tie{}; à l'inverse,
3011 une durée de référence élevée produira une musique resserrée.
3013 @lilypond[quote,verbatim,ragged-right]
3016 \new RhythmicStaff {
3020 c'16 c'16 c'16 c'16 c'16
3027 proportionalNotationDuration = #(ly:make-moment 1 8)
3034 \new RhythmicStaff {
3038 c'16 c'16 c'16 c'16 c'16
3045 proportionalNotationDuration = #(ly:make-moment 1 16)
3052 \new RhythmicStaff {
3056 c'16 c'16 c'16 c'16 c'16
3063 proportionalNotationDuration = #(ly:make-moment 1 32)
3069 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3070 comme la croche pour la première ligne, a pour conséquence de resserrer
3071 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3072 remarquez aussi que , par principe, la notation proportionnelle occupe
3073 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3074 notation proportionnelle met en évidence le rythme au détriment de
3075 l'espacement horizontal.
3077 Examinons à présent le moyen d'optimiser l'espacement de nolets en
3080 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3081 ajoutons lui une portée incluant un autre type de nolet.
3083 @lilypond[quote,verbatim,ragged-right]
3086 \new RhythmicStaff {
3090 c'16 c'16 c'16 c'16 c'16
3093 \new RhythmicStaff {
3095 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3102 L'espacement est loin d'être idéal, pour la simple raison que
3103 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3104 uniformément. Il est vrai que de telles constructions complexes en
3105 nolets sont assez rares en gravure traditionnelle, ce qui explique que
3106 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3107 @code{proportionalNotationDuration} permet d'arranger les choses.
3109 @lilypond[quote,verbatim,ragged-right]
3112 \new RhythmicStaff {
3116 c'16 c'16 c'16 c'16 c'16
3119 \new RhythmicStaff {
3121 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3128 proportionalNotationDuration = #(ly:make-moment 1 20)
3134 Cependant, si l'on observe de près, il est évident que les notes de la
3135 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3136 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3137 allons activer le @code{uniform-stretching}, propriété attachée au
3138 @code{SpacingSpanner}.
3140 @lilypond[quote,verbatim,ragged-right]
3143 \new RhythmicStaff {
3147 c'16 c'16 c'16 c'16 c'16
3150 \new RhythmicStaff {
3152 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
3159 proportionalNotationDuration = #(ly:make-moment 1 20)
3160 \override SpacingSpanner #'uniform-stretching = ##t
3166 L'espacement sur les deux portées est maintenant correct, les relations
3167 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3168 une indication temporelle ou autre graphisme selon notre envie.
3170 Notez bien que la prise en charge de la notation proportionnelle par
3171 LilyPond demande que, dans chaque partition, soit activée la propriété
3172 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3173 contraire, utiliser @code{proportionalNotationDuration} aura pour
3174 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3175 inséré des silences invisibles @emph{skip}.
3177 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3178 au contexte @code{Score}. Tout comme pour la propriété
3179 @code{proportionalNotationDuration}, les réglages du
3180 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3181 votre fichier@tie{}: dans un bloc @code{\with}, dans un bloc
3182 @code{\context} ou au beau milieu de la musique à l'aide de la
3183 commande @code{\set}.
3185 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3186 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3187 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3188 partition. Vous pourriez toutefois avoir besoin de modifier ce
3189 comportement en cours de partition, et recourir alors à l'instruction
3190 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3191 rubrique @ref{Changement d'espacement en cours de partition}.
3194 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3195 qui est désactivé pour la plupart des partitions en notation
3196 proportionnelle. Voici ce qui apparaît dans une partition
3197 traditionnelle@tie{}: il y a toujours un @qq{espace préservé} juste
3198 avant la première note de chaque portée.
3200 @lilypond[quote,verbatim,ragged-right]
3212 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3213 présent lorsqu'intervient un changement de métrique, d'armure ou de
3214 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3215 réduire cet espace à zéro.
3217 @lilypond[quote,verbatim,ragged-right]
3223 \remove Separating_line_group_engraver
3231 Les éléments non musicaux tels que métrique, armure et clef, posent
3232 problème lorsqu'on travaille en notation proportionnelle. Bien
3233 qu'aucune notion de durée ne leur soit attachée, ces éléments
3234 @qq{consomment} de l'espace. Différentes approches permettent
3235 cependant de gérer ce problème.
3237 Éviter les problèmes d'espacement avec l'armure est chose aisée@tie{}:
3238 il suffit qu'il n'y en ait pas@tie{}! C'est bien souvent le cas en
3239 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3240 proportionnelle. Il en va de même pour la métrique, et tout
3241 particulièrement lorsque la partition comporte un quadrillage temporel
3242 ou autres graphismes. L'absence de métrique reste cependant
3243 exceptionnelle et la plupart des partitions en notation proportionnelle
3244 laissent apparaître quelques métriques. Il est par contre pratiquement
3245 impossible de se passer de clef et d'altération.
3247 L'une des options permettant de s'affranchir de l'espacement dû aux
3248 éléments non musicaux consiste en l'activation de la propriété
3249 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3250 les deux portées suivantes@tie{}:
3252 @lilypond[quote,verbatim,ragged-right]
3254 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3264 \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3265 \override Score.SpacingSpanner #'strict-note-spacing = ##t
3275 Toutes deux affichent un espacement proportionnel. Cependant, la
3276 première ligne laisse apparaître un espacement plus lâche en raison de
3277 la présence d'un changement de clef. En ce qui concerne la deuxième
3278 ligne, l'espacement est strictement observé dès lors que la propriété
3279 @code{strict-note-spacing} a préalablement été activée. Comme vous
3280 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3281 conséquence que l'algorithme d'espacement ignore tout bonnement la
3282 largeur des métriques, armures, clefs et altérations.
3284 En plus ceux que nous venons de voir, vous trouverez d'autres réglages
3285 en usage dans la notation proportionnelle comme, entre autres,
3288 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3289 @item @code{tupletFullLength = ##t}
3290 @item @code{\override Beam #'breakable = ##t}
3291 @item @code{\override Glissando #'breakable = ##t}
3292 @item @code{\override TextSpanner #'breakable = ##t}
3293 @item @code{\remove Forbid_line_break_engraver (dans un contexte de voix}
3296 Ces différents réglages permettent un espacement strict des notes
3297 d'ornement, d'étendre les indications de nolet afin d'indiquer de façon
3298 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3299 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3300 différentes rubriques associées du manuel pour chacun de ces réglages.
3304 Manuel de notation :
3305 @ref{Changement d'espacement en cours de partition}.
3308 @rlsrnamed{Spacing,Espacements}.
3311 @node Réduction du nombre de pages de la partition
3312 @section Réduction du nombre de pages de la partition
3313 @translationof Fitting music onto fewer pages
3315 Vous pourriez un jour être confronté au problème suiven@tie{}: l'une
3316 des pages de votre partition ne comporte que deux portées alors que --
3317 ce qui est d'autant plus frustrant -- l'espace libre sur les autres
3318 pages aurait permis une distribution différente.
3320 L'instruction @code{annotate-spacing} se révèle être un outil
3321 indispensable pour pour l'analyse des problèmes de mise en forme. Cette
3322 commande met en surimpression la valeur des différentes variables
3323 d'espacement et de mise en forme, comme nous allons le voir dans la
3324 rubrique @ref{Mise en évidence de l'espacement}.
3327 * Mise en évidence de l'espacement::
3328 * Modification de l'espacement::
3331 @node Mise en évidence de l'espacement
3332 @subsection Mise en évidence de l'espacement
3333 @translationof Displaying spacing
3335 @funindex annotate-spacing
3336 @cindex espacement, affichage des valeurs
3338 Le meilleur moyen d'appréhender les différentes variables de
3339 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3340 la mise en page, consiste à activer, au sein du bloc @code{\paper}, la
3341 fonction @code{annotate-spacing}@tie{}:
3343 @c need to have \book{} otherwise we get the separate systems. -hwn
3344 @lilypond[verbatim,quote]
3345 #(set-default-paper-size "a6" 'landscape)
3348 \paper { annotate-spacing = ##t }
3353 Toutes les dimensions sont exprimées en espace de portée
3354 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3355 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3356 feuille (@code{paper-height}) est de 59,75@tie{}espaces de portée
3357 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3358 20@tie{}points -- sa valeur par défaut. Notez que@tie{}:
3360 @multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
3363 @tab = (25,4/72,27) mm
3366 @tab = (@code{staff-size})/4 pts
3368 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3373 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3374 1,757@tie{}millimètres. Les 59,75@tie{}@code{staff-spaces} de
3375 @code{paper-height} correspondent donc à 105@tie{}millimètres, soit la
3376 hauteur d'une feuille au format A6 à l'italienne. Les paires
3377 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3378 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3382 Manuel de notation :
3383 @ref{Définition de la taille de portée}.
3386 @rlsrnamed{Spacing,Espacements}.
3389 @node Modification de l'espacement
3390 @subsection Modification de l'espacement
3391 @translationof Changing spacing
3393 Les informations fournies par @code{annotate-spacing} en matière de
3394 dimensionnement vertical sont incomparables. Pour plus de détails sur
3395 les manières de modifier marges et autres variables connexes, consultez
3396 la rubrique @ref{Mise en forme de la page}.
3398 En dehors des marges, vous disposez de quelques moyens supplémentaires
3399 pour gagner de l'espace@tie{}:
3403 Rapprocher les systèmes le plus possible les uns des autres, de telle
3404 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3405 suffisamment pour éviter le blanc en bas de page.
3409 system-system-spacing = #'((padding . 0) (space . 0.1))
3410 ragged-last-bottom = ##f
3416 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3417 deux titres. D'une part, le fait de définir un nombre de systèmes --
3418 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3419 systèmes par page dans la mesure où l'une des étapes d'estimation des
3420 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3421 systèmes par page permet d'en disposer plus sur les suivantes. Par
3422 exemple, avec un nombre par défaut de 11@tie{}systèmes par pages,
3423 l'instruction suivante le force à 10.
3432 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3433 Par exemple, un crochet de reprise ou d'alternative consomme de
3434 l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
3435 diminue d'autant l'espace disponible que si seul le premier ne
3436 comportait l'indication. Autre exemple, les indications de nuance qui
3437 se @qq{détachent} d'un système peuvent être rapprochés de la portée@tie{}:
3439 @lilypond[verbatim,quote,relative=1]
3441 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3445 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3446 comme indiqué à la rubrique
3447 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3448 l'espacement par défaut@tie{}:
3450 @lilypond[verbatim,quote]
3463 Par contre, le fait de modifier la valeur de la propriété
3464 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3465 -- bien que la noire soit la durée la plus courante, nous prenons une
3466 valeur plus longue -- donnera un effet @qq{resserré} à la musique@tie{}:
3468 @lilypond[verbatim,quote]
3480 \override SpacingSpanner
3481 #'common-shortest-duration = #(ly:make-moment 1 2)
3488 La propriété @code{common-shortest-duration} ne peut être modifiée
3489 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3490 s'applique à l'intégralité de la partition.
3496 Manuel de notation :
3497 @ref{Mise en forme de la page},
3498 @ref{Modification de l'espacement horizontal}.
3501 @rlsrnamed{Spacing,Espacements}.