1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 6b8cabe379e8b4b945797a4e55759c56117223d4
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.
27 http://code.google.com/p/lilypond/issues/detail?id=68
32 @node Gestion de l'espace
33 @chapter Gestion de l'espace
34 @translationof Spacing issues
36 L'agencement général d'une partition dépend de trois facteurs
37 interdépendants : la mise en page, les sauts de ligne et l'espacement.
38 Les choix faits en matière d'espacement détermineront la densité de
39 chacun des systèmes, ce qui influera sur le positionnement des sauts de
40 ligne et, par voie de conséquence, sur le nombre de pages de la
43 En pratique, cette procédure comporte quatre étapes. Dans un premier
44 temps, des distances élastiques @emph{(springs)} sont déterminées sur la
45 base des durées. Sont alors calculées différentes possibilités de saut
46 de ligne, chacune se voyant attribuer un « coefficient de laideur »,
47 puis est estimée la hauteur de chaque système. LilyPond opte enfin pour
48 la combinaison entre sauts de page et de ligne qui offre la meilleure
49 occupation de l'espace, tant horizontalement que verticalement.
51 Les réglages qui influencent la mise en forme se placent dans deux blocs
52 différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
53 @ref{Mise en forme de la page} contient les réglages applicables à
54 toutes les partitions d'une partie ou de l'intégralité d'un ouvrage --
55 tels que format du papier, impression ou non des numéros de page, etc.
56 Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
57 rubrique @ref{Mise en forme de la partition}, il détermine la mise en
58 forme de la musique : le nombre de systèmes utilisés, l'espacement des
59 regroupements de portées, etc.
62 * Mise en forme de la page::
63 * Mise en forme de la partition::
65 * Espacement vertical::
66 * Espacement horizontal::
67 * Réduction du nombre de pages de la partition::
70 @cindex ragged, aligné
71 @cindex aligné, ragged
73 @warning{Vous verrez au fil de ce chapitre apparaître certains termes
74 dont la traduction vous semblera assurément erronée. Il n'en est
75 cependant rien : certains termes techniques ont une histoire
76 particulière selon leur langue d'origine. Ainsi le vocable anglais
77 @emph{Ragged} signifie en lambeau, en loques ; dans l'univers
78 typographique, un maître français voit un alignement à gauche -- il dira
79 « au fer à gauche » -- alors que son homologue anglophone constate un
80 @emph{ragged-right} -- donc du vide à droite.}
83 @node Mise en forme de la page
84 @section Mise en forme de la page
85 @translationof Page layout
87 Nous allons examiner ici les options qui contrôlent la mise en forme des
88 pages attachées au bloc @code{\paper}.
92 * Format du papier et adaptation automatique::
93 * Variables d'espacement vertical fixe::
94 * Variables d'espacement vertical fluctuant::
95 * Variables d'espacement horizontal::
96 * Autres variables du bloc paper::
101 @subsection Le bloc @code{@bs{}paper}
102 @translationof The paper block
104 Des blocs @code{\paper} peuvent apparaître à trois différents endroits
105 et former ainsi une hiérarchie :
110 En début de fichier source, avant même tout bloc @code{\book},
111 @code{\bookpart} ou @code{\score}.
114 Au sein d'un bloc @code{\book} et indépendamment de tout bloc
115 @code{\bookpart} ou @code{\score} qu'il pourrait contenir.
118 Au sein d'un bloc @code{\bookpart}, mais en dehors de tout bloc
123 Un bloc @code{\paper} ne doit donc en aucun cas prendre place au sein
124 d'un bloc @code{\score}.
126 Les valeurs des différents champs seront filtrées en respectant cette
127 hiérarchie ; les valeurs définies le plus haut persisteront à moins
128 d'être remplacées à un niveau hiérarchique inférieur.
130 Plusieurs blocs @code{\paper} peuvent cohabiter à un même niveau,
131 notamment en raison de la présence d'inclusion de fichiers. Dans une
132 telle éventualité, les champs sont regroupés par niveau, la dernière
133 valeur rencontrée ayant préséance en cas de doublon.
135 Peuvent apparaître dans un bloc @code{\paper} :
140 la fonction Scheme @code{set-paper-size},
143 des variables propres au bloc @code{\paper} qui viendront adapter la
147 la définition des différents @emph{markups} qui personnaliseront la mise
148 en forme des entêtes et pieds de page ainsi que des titrages.
152 La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
153 -- @ref{Format du papier et adaptation automatique}. Les variables du
154 bloc @code{\paper} chargées de la mise en page sont abordées plus loin
155 dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
156 des entête, pied de page et titrage, elles sont étudiées à la rubrique
157 @ref{Titrages personnalisés}.
159 La plupart des variables gérant le papier ne sont fonctionnelles que
160 lorsque mentionnées dans un bloc @code{\paper}. Certaines, qui peuvent
161 toutefois apparaître dans un bloc @code{\layout}, sont référencées à la
162 rubrique @ref{Le bloc layout}.
164 Sauf mention contraire, toutes les variables du bloc @code{\paper} qui
165 correspondent à des dimensions sont exprimées en millimètre -- vous
166 pouvez bien entendu spécifier un autre système de mesure. Voici
167 comment, par exemple, définir la marge haute (@code{top-margin}) à dix
176 Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
177 mentionner le suffixe d'unité @code{\in} :
185 LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
186 @code{\in} et @code{\pt}. Ces unités sont des conversions de
187 millimètres, répertoriées dans le fichier
188 @file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
189 ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
190 @code{\mm} à votre code lorsque vous travaillez en millimètres.
192 Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
193 fonctions Scheme. Voici l'équivalent de l'exemple précédent :
197 #(define top-margin (* 0.5 in))
203 @ref{Format du papier et adaptation automatique},
204 @ref{Le bloc layout},
205 @ref{Titrages personnalisés}.
207 Fichiers d'initialisation :
208 @file{ly/paper-defaults-init.ly}.
211 @node Format du papier et adaptation automatique
212 @subsection Format du papier et adaptation automatique
213 @translationof Paper size and automatic scaling
215 @cindex papier, taille
222 * Adaptation automatique au format::
226 @node Format du papier
227 @unnumberedsubsubsec Format du papier
228 @translationof Setting the paper size
230 LilyPond génère par défaut, et en l'absence de mention explicite d'un
231 format de papier particulier, un fichier imprimable au format A4.
232 Vous pouvez cependant utiliser un autre format à l'aide des deux
236 @item set-default-paper-size
239 #(set-default-paper-size "quarto")
242 qui se place en début de fichier, et
248 #(set-paper-size "tabloid")
252 qui s'inscrit au sein d'un bloc @code{\paper}.
255 La seule restriction à l'utilisation isolée de la fonction
256 @code{set-default-paper-size} est qu'elle doit intervenir avant le
257 premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
258 format pour toutes les pages, alors que @code{set-paper-size} détermine
259 le format des feuilles rattachées à un bloc @code{\paper} particulier.
260 Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
261 format du papier s'appliquera à toutes les pages ; si @code{\paper}
262 apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
263 @emph{book} en question.
265 À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
266 doit intervenir avant toute autre variable. Les raisons à ceci sont
267 abordées à la rubrique @ref{Adaptation automatique au format}.
269 Différents formats de papier sont définis dans le fichier
270 @file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
271 format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
272 LilyPond. Les différents formats disponibles sont répertoriés à
273 l'annexe @ref{Formats de papier prédéfinis}.
275 @c An appendix entry exists for paper sizes but is not auto-generated
277 La commande suivante, inscrite dans votre fichier, vous permettra
278 d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
279 appel à l'aide des fonctions @code{set-default-paper-size} et
280 @code{set-paper-size} :
283 #(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
286 #(set-paper-size "mon format")
290 Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
291 @code{cm} (centimètres) ou @code{mm} (millimètres).
293 @cindex papier, orientation
294 @cindex landscape, papier
295 @cindex paysage, papier
296 @cindex à l'italienne, papier
298 Le fait d'ajouter l'argument @code{'landscape} à l'instruction
299 stipulant le format du papier permet d'obtenir une présentation à
300 l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
304 #(set-default-paper-size "a6" 'landscape)
307 L'inversion des dimensions du papier sans pour autant basculer la
308 présentation -- comme pour imprimer sur une carte postale ou créer un
309 graphique destiné à inclusion -- s'obtient en ajoutant @samp{landscape}
310 au nom du format de papier :
313 #(set-default-paper-size "a6landscape")
316 Lorsque la taille du papier comporte explicitement @samp{landscape} ou
317 @samp{portrait}, la présence d'un argument @code{'landscape} aura pour
318 seul effet de modifier l'orientation de l'image et non les dimensions de
323 @ref{Adaptation automatique au format},
324 @ref{Formats de papier prédéfinis}.
326 Fichiers d'initialisation :
327 @file{scm/paper.scm}.
330 @node Adaptation automatique au format
331 @unnumberedsubsubsec Adaptation automatique au format
332 @translationof Automatic scaling to paper size
334 Toute modification du format de papier à l'aide des fonctions Scheme
335 @code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
336 vues à la rubrique @ref{Format du papier}, se traduira automatiquement
337 par l'ajustement d'un certain nombre de variables attachées au bloc
338 @code{\paper} afin qu'elles soient en concordance avec le format
339 spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
340 particulière en redéfinissant sa valeur après avoir spécifié le format
341 de papier utilisé. Notez bien que le simple fait d'affecter une valeur
342 à @code{paper-height} ou @code{paper-width} ne déclenchera pas
343 l'étalonnage automatique, bien que spécifier une largeur de papier
344 @emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
345 c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
346 voir avec la mise à l'échelle.
348 L'adaptation automatique affecte les dimensionnements verticaux
349 @code{top-margin} et @code{bottom-margin} -- voir
350 @ref{Variables d'espacement vertical fixe} --, ainsi que les
351 dimensionnements horizontaux @code{left-margin}, @code{right-margin},
352 @code{inner-margin}, @code{outer-margin}, @code{binding-offset},
353 @code{indent} et @code{short-indent} -- voir
354 @ref{Variables d'espacement horizontal}.
356 Les valeurs par défaut de ces dimensionnements sont contenues dans le
357 fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
358 internes @code{top-margin-default}, @code{bottom-margin-default}, etc.
359 correspondant au format par défaut -- papier A4 -- pour lequel
360 @code{paper-height} est à @code{297\mm} et @code{paper-width} à
365 @ref{Variables d'espacement horizontal},
366 @ref{Variables d'espacement vertical fixe}.
368 Fichiers d'initialisation :
369 @file{ly/paper-defaults-init.ly},
370 @file{scm/paper.scm}.
373 @node Variables d'espacement vertical fixe
374 @subsection Variables d'espacement vertical fixe
375 @translationof Fixed vertical spacing paper variables
377 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
378 sont automatiquement ajustés selon le format du papier, ce qui peut
379 conduire à un résultat inattendu --
380 voir @ref{Adaptation automatique au format}.}
382 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
383 @file{ly/paper-defaults-init.ly}.
387 @funindex paper-height
389 La hauteur de la feuille. Il s'agit par défaut de la dimension du
390 papier utilisé. Notez bien que cette variable n'affectera pas
391 l'ajustement automatique d'un certain nombre de dimensionnements
397 La marge entre le bord supérieur de la feuille et la surface imprimable.
398 Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
402 @funindex bottom-margin
404 La marge entre la surface imprimable et le bord inférieur de la feuille.
405 Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
409 @funindex ragged-bottom
411 L'activation de cette variable permet de ne pas répartir verticalement
412 les systèmes sur les pages hormis la dernière. La valeur par défaut
413 est @code{#f}. Lorsque la partition ne comporte que deux ou trois
414 systèmes par page, comme pour un conducteur d'orchestre, nous vous
415 conseillons d'activer cette variable.
417 @item ragged-last-bottom
418 @funindex ragged-last-bottom
420 La désactivation de cette variable permet de répartir verticalement les
421 systèmes de la dernière page d'une partition. La valeur par défaut
422 est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
423 deux pages ou plus, de désactiver cette variable.@*
424 Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
425 dernière page de chacune des parties -- créées à l'aide d'un bloc
426 @code{\bookpart} -- d'un même ouvrage.
432 @ref{Adaptation automatique au format}.
434 Fichiers d'initialisation :
435 @file{ly/paper-defaults-init.ly}.
438 @rlsrnamed{Spacing, Espacements}.
441 Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
442 comme des systèmes à part entière ; ils seront donc affectés par
443 @code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
444 ajouteront de l'espace avant le premier système de la partition.
446 La définition explicite d'un format de papier annulera tout réglage des
447 marges haute et basse.
450 @node Variables d'espacement vertical fluctuant
451 @subsection Variables d'espacement vertical fluctuant
452 @translationof Flexible vertical spacing paper variables
454 Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
455 entre différents éléments (marges, titres, systèmes ou mouvements), en
456 dilatation ou compression selon le cas. Un certain nombre de variables
457 de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
458 ces dimensionnements.
460 Gardez à l'esprit que les variables du bloc @code{\paper} dont nous
461 parlons ici n'influencent en rien l'espacement des portées d'un même
462 système. L'espacement au sein des systèmes est géré par des propriétés
463 attachées à des objets graphiques (@emph{grobs}) qui, elles, se
464 définissent au niveau du bloc @code{\score} -- voir à ce sujet
465 @ref{Espacement vertical au sein d'un système}.
468 * Structure des variables d'espacement vertical fluctuant::
469 * Liste des variables d'espacement vertical fluctuant::
473 @node Structure des variables d'espacement vertical fluctuant
474 @unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
475 @translationof Structure of flexible vertical spacing alists
477 Chacune de ces variables attachées au bloc @code{\paper} est constituée
478 d'une liste associative @emph{(alist)} à quatre @i{clés} :
483 @code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
484 par défaut, exprimée en hauteur de portée, séparant les @i{points de
485 référence} de deux éléments, qui évite tout risque de collision en
486 l'absence de dilatation ou compression. Le point de référence d'un
487 titre ou d'un @emph{markup} est son sommet, celui d'un système est le
488 centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
489 ligne de « non-portée » viendrait à s'intercaler. Une
490 @code{basic-distance} inférieure à @code{padding} ou
491 @code{minimum-distance} sera sans effet, dans la mesure où l'espacement
492 résultant ne saurait être inférieur à @code{padding} ou
493 @code{minimum-distance}.
496 @code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
497 minimal, exprimé en hauteur de portée, entre les points de référence des
498 deux éléments alors qu'il y a déjà un effet de compression. Une
499 @code{minimum-distance} inférieure à la valeur du @code{padding} sera
500 sans effet, dans la mesure où l'espacement résultant ne saurait être
501 inférieur au @code{padding}.
503 @c TODO: explain skylines somewhere and xref to it from here.
506 @code{padding} @emph{(décalage)} -- la grandeur minimale de « blanc »
507 qui sépare deux éléments, exprimée en hauteur de portée. On peut le
508 voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
509 sur toute la largeur des deux éléments.
512 @code{stretchability} @emph{(dilatation)} -- le coefficient
513 d'étirement de cet espace. Un coefficient nul permet de figer
514 l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
515 positif déterminera la propension d'un espacement à s'étirer, tout
516 en tenant compte du coefficient affecté aux autres espacements.
517 Par exemple, lorsque le coefficient de dilatation d'une dimension est
518 double de celui d'une autre, elle pourra s'étirer deux fois plus que
519 cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
520 provoque une @code{programming_error} (erreur de programmation) et est
521 ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
522 une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
523 sa valeur est par défaut égale à @code{space}. Notez bien que
524 l'utilisateur ne peut définir une propension à la compression ;
525 elle est en fait égale à
526 (@code{basic-distance} @minus{} @code{minimum-distance}).
530 Lorsque l'impression n'est pas en pleine page -- elle est donc
531 @emph{ragged bottom} pour les anglophones -- l'élément @code{space}
532 n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
538 @code{basic-distance}, plus
540 @code{minimum-distance} et
542 @code{padding}, augmenté de ce qu'il faut pour éviter les
547 Cependant, lorsque la partition fait plusieurs pages, la dernière page
548 reprendra dans la mesure du possible l'espacement de la page précédente.
550 Les manières de modifier des listes associatives font l'objet d'un
551 @rusernamed{Modification de listes associatives, chapitre spécifique}.
552 L'exemple suivant indique deux façons de modifier une liste associative.
553 La première déclaration intervient sur une seule clé, alors que la
554 deuxième redéfinit complètement la variable.
558 system-system-spacing.basic-distance = #8
560 score-system-spacing =
562 (basic-distance . 12)
563 (minimum-distance . 6)
564 (stretchability . 12))
569 @node Liste des variables d'espacement vertical fluctuant
570 @unnumberedsubsubsec Liste des variables d'espacement fluctuant
571 @translationof List of flexible vertical spacing paper variables
573 Le nom des dimensionnements à hauteur variable sont de la forme
574 @code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
575 @code{@var{après}} représentent les éléments qui doivent être espacés.
576 La distance s'établit entre les points de référence des deux éléments
577 concernés (voir la rubrique précédente pour plus de précision). Notez
578 bien que, dans les règles de nommage des variables qui suivent, le terme
579 @code{markup} fait référence aussi bien à un @i{markup de titrage}
580 (@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
581 @i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
582 distances sont exprimées en espace de portée.
584 Leurs valeurs par défaut sont inscrites dans le fichier
585 @file{ly/paper-defaults-init.ly}.
587 @c TODO: Where do headers/footers fit in? -mp
590 @item markup-system-spacing
591 @funindex markup-system-spacing
593 détermine l'espacement entre un titre ou un @emph{markup} de premier
594 niveau, et le système qui le suit.
596 @item score-markup-spacing
597 @funindex score-markup-spacing
599 détermine l'espacement entre le dernier système et le titre ou
600 @emph{markup} de haut niveau qui le suit.
602 @item score-system-spacing
603 @funindex score-system-spacing
605 détermine l'espacement entre le dernier système d'une partition et le
606 premier système de la partition suivante, en l'absence de titrage ou
607 @emph{markup} qui les sépare.
609 @item system-system-spacing
610 @funindex system-system-spacing
612 détermine l'espacement entre deux systèmes d'un même mouvement.
614 @item markup-markup-spacing
615 @funindex markup-markup-spacing
617 détermine l'espacement entre deux titres ou @emph{markups} de premier
620 @item last-bottom-spacing
621 @funindex last-bottom-spacing
623 détermine la distance entre le dernier système ou le dernier
624 @emph{markup} de haut niveau, et le bas de la surface imprimable --
625 autrement dit le haut de la marge basse.
627 @item top-system-spacing
628 @funindex top-system-spacing
630 détermine l'espace entre le haut de la surface imprimable (le bas de la
631 marge haute) et le milieu du premier système. Cette variable n'est
632 effective qu'en l'absence de titre ou @emph{markup} de premier niveau
635 @item top-markup-spacing
636 @funindex top-markup-spacing
638 détermine l'espace entre le haut de la surface imprimable (le bas de la
639 marge haute) et le premier titre ou @emph{markup} de premier niveau.
640 Cette variable n'est effective qu'en l'absence de système en haut de
647 @ref{Espacement vertical au sein d'un système}.
650 @rlsrnamed{Spacing,Espacements}.
653 @rlsrnamed{Spacing,Espacements}.
656 @node Variables d'espacement horizontal
657 @subsection Variables d'espacement horizontal
658 @translationof Horizontal spacing paper variables
660 @warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
661 sont automatiquement ajustés selon le format du papier, ce qui peut
662 conduire à un résultat inattendu --
663 voir @ref{Adaptation automatique au format}.}
666 * Variables de marge et de largeur::
667 * Variables spécifiques à l'impression recto-verso::
668 * Variables d'indentation et de décalage::
672 @node Variables de marge et de largeur
673 @unnumberedsubsubsec Variables de marge et de largeur
674 @translationof paper variables for widths and margins
676 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
677 @file{ly/paper-defaults-init.ly}.
682 @funindex paper-width
684 La largeur de la page. Elle correspond par défaut à la largeur du
685 format de papier utilisé. Si @code{paper-width} n'a aucun effet en
686 matière d'ajustement automatique, cette variable influe sur la variable
687 @code{line-width}. Lorsque vous définissez à la fois les valeurs de
688 @code{paper-width} et @code{line-width}, les valeurs de
689 @code{left-margin} et @code{right-margin} seront recalculées. Voir
690 aussi @code{check-consistency}.
695 La longueur d'une ligne. Lorsque spécifié dans un bloc @code{\paper},
696 ceci définit l'étendue horizontale dont disposeront les lignes de portée
697 d'un système non indenté. La valeur par défaut est égale à
698 @code{paper-width}, auquel sont retranchés @code{left-margin} et
699 @code{right-margin}. Lorsque vous définissez @code{line-width} sans
700 modifier les valeurs de @code{left-margin} et @code{right-margin}, les
701 marges seront alors recalculées de telle sorte que les systèmes soient
702 centrés. Voir aussi @code{check-consistency}.
704 La valeur de @code{line-width} peut aussi se spécifier individuellement
705 au niveau de la partition, au sein d'un bloc @code{\layout}. Ceci
706 permet de contrôler la longueur des lignes partition par partition. Si
707 la longueur de ligne n'est pas spécifié dans une partition particulière,
708 elle sera valorisée à celle du @code{line-width} mentionné dans le bloc
709 @code{\paper}. La détermination de @code{line-width} pour un
710 @code{\score} particulier n'a aucun effet sur les marges. Les lignes
711 d'une portée dont la longueur est déterminée par le @code{line-width}
712 d'une partition seront alignées par la gauche sur la surface de papier
713 telle que définie par le @code{line-width} du bloc @code{\paper}. Dès
714 lors que les valeurs de @code{line-width} de la partition et du papier
715 sont égales, les lignes s'étendront de la marge gauche à la marge
716 droite. En cas de @code{line-width} de la partition supérieur au
717 @code{line-width} du papier, les lignes de portée déborderont dans la
722 @funindex left-margin
724 La marge entre le bord gauche de la feuille et le début de chaque
725 système. La valeur par défaut est de @code{10\mm} ; elle sera
726 ajustée selon le format du papier. Lorsque vous définissez
727 @code{line-width} et @code{right-margin} sans modifier la valeur de
728 @code{left-margin}, cette dernière sera alors égale à
729 @code{(paper-width @minus{} line-width @minus{} right-margin)}.
730 Lorsque seule @code{line-width} est définie, les deux marges
732 @code{((paper-width @minus{} line-width) / 2)}, ce
733 qui a pour effet de centrer les systèmes sur la page. Voir aussi
734 @code{check-consistency}.
737 @funindex right-margin
739 La marge entre le bord droit de la page et la fin des systèmes en pleine
740 largeur (non @emph{ragged}). La valeur par défaut est de @code{10\mm}
741 et s'ajustera selon le format du papier. Lorsque vous définissez
742 @code{line-width} et @code{left-margin}, sans modifier la valeur de
743 @code{right-margin}, cette dernière sera alors égale à
744 @code{(paper-width @minus{} line-width @minus{} left-margin)}.
745 Lorsque seule @code{line-width} est définie, les deux marges
747 @code{((paper-width @minus{} line-width) / 2)}, ce
748 qui a pour effet de centrer les systèmes sur la page. Voir aussi
749 @code{check-consistency}.
751 @item check-consistency
752 @funindex check-consistency
754 Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
755 @code{line-width} et @code{right-margin} sont en cohérence, et que
756 l'addition de ces trois éléments ne dépassera pas la largeur du papier
757 (@code{paper-width}). La valeur par défaut est @code{#t}. Dans
758 le cas d'une incohérence, un message d'avertissement est émis et les
759 trois variables -- marges et longueur de ligne -- rétablies à leur
760 valeur par défaut (ajustées selon le format du papier). La
761 désactivation de cette variable (valorisation à @code{#f}, toute
762 incohérence sera ignorée, et les systèmes pourront déborder de la page.
765 @funindex ragged-right
767 Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
768 la longueur de la ligne, mais s'arrêteront à leur longueur normale.
769 La valeur par défaut est @code{#f} mais, si la partition ne comporte
770 qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
771 se gérer au sein d'un bloc @code{\layout}.
774 @funindex ragged-last
776 Lorsqu'elle est activée, cette variable permet de ne pas étendre le
777 dernier système de façon à occuper toute la longueur de la ligne. La
778 valeur par défaut est @code{#f}. Cette variable peut aussi se
779 gérer au sein d'un bloc @code{\layout}.
785 @ref{Adaptation automatique au format}.
787 Fichiers d'initialisation :
788 @file{ly/paper-defaults-init.ly}.
791 La définition explicite d'un format de papier annulera tout réglage des
792 marges gauche et droite.
795 @node Variables spécifiques à l'impression recto-verso
796 @unnumberedsubsubsec Variables spécifiques à l'impression recto-verso
797 @translationof paper variables for two-sided mode
799 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
800 @file{ly/paper-defaults-init.ly}.
810 Cette variable permet de gérer efficacement les impressions recto-verso.
811 Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
812 @code{outer-margin} ainsi que @code{binding-offset} détermineront les
813 différentes marges selon qu'il s'agit d'une page paire ou impaire.
814 Cette variable s'applique en lieu et place de @code{left-margin} et
815 @code{right-margin}. La valeur par défaut est @code{#f}.
818 @funindex inner-margin
820 La marge que toutes les pages d'une partie ou de tout un ouvrage devront
821 avoir du côté intérieur. Bien entendu, cette variable n'est
822 effective que lorsque vous comptez générer un fichier imprimable en
823 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
824 défaut est de @code{10\mm} et s'ajustera selon le format du papier.
827 @funindex outer-margin
829 la marge que toutes les pages d'une partie ou de tout un ouvrage devront
830 avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
831 variable n'est effective que lorsque vous comptez générer un fichier
832 imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
833 La valeur par défaut est de @code{20\mm} et s'ajustera selon le
837 @funindex binding-offset
839 La gouttière, ou marge de reliure, permet d'augmenter en conséquence la
840 valeur de la marge intérieure @code{inner-margin} de telle sorte que
841 rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
842 effective que lorsque vous comptez générer un fichier imprimable en
843 recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
844 défaut est de @code{0} et s'ajustera selon le format du papier.
850 @ref{Adaptation automatique au format}.
852 Fichiers d'initialisation :
853 @file{ly/paper-defaults-init.ly}.
856 @node Variables d'indentation et de décalage
857 @unnumberedsubsubsec Variables d'indentation et de décalage
858 @translationof paper variables for shifts and indents
860 Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
861 @file{ly/paper-defaults-init.ly}.
865 @item horizontal-shift
866 @funindex horizontal-shift
868 @c This default value is buried in the middle of page.scm. -mp
870 Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
871 seront poussés d'autant vers la droite. La valeur par défaut est
877 Le niveau d'indentation du premier système d'une partition. La valeur
878 par défaut est de @code{15\mm} en A4 et s'ajustera selon le format du
879 papier. L'espace correspondant à @code{line-width} est réduit d'autant
880 pour le premier système. Cette variable peut aussi se gérer partition
881 par partition au sein d'un bloc @code{\layout}.
884 @funindex short-indent
886 Le niveau d'indentation de tous les systèmes hormis le premier. La
887 valeur par défaut est de @code{0} pour du A4, et s'ajustera selon le
888 format du papier dès lors que vous lui aurez affecté une valeur. Bien
889 entendu, l'espace spécifié par @code{line-width} sera réduit d'autant.
890 Cette variable peut aussi se gérer partition par partition, au sein d'un
897 @ref{Adaptation automatique au format}.
899 Fichiers d'initialisation :
900 @file{ly/paper-defaults-init.ly}.
903 @rlsrnamed{Spacing, Espacements}.
906 @node Autres variables du bloc paper
907 @subsection Autres variables du bloc @code{@bs{}paper}
908 @translationof Other paper variables
911 * Variables de gestion des sauts de ligne::
912 * Variables de gestion des sauts de page::
913 * Variables de gestion des numéros de page::
914 * Variables supplémentaires::
918 @node Variables de gestion des sauts de ligne
919 @unnumberedsubsubsec Variables de gestion des sauts de ligne
920 @translationof paper variables for line breaking
924 @item max-systems-per-page
925 @funindex max-systems-per-page
927 Le nombre maximal de systèmes qu'une page pourra comporter. Cette
928 variable n'est prise en compte, à ce jour, que par l'option
929 @code{ly:optimal-breaking}, et n'est pas définie.
931 @item min-systems-per-page
932 @funindex min-systems-per-page
934 Le nombre minimal de systèmes qu'une page pourra comporter. Attention
935 cependant aux risques de débordement s'il est trop important. Cette
936 variable n'est prise en compte, à ce jour, que par l'option
937 @code{ly:optimal-breaking}, et n'est pas définie.
939 @item systems-per-page
940 @funindex systems-per-page
942 Le nombre de systèmes que devrait comporter chaque page. Cette variable
943 n'est à ce jour prise en charge que par l'algorithme
944 @code{ly:optimal-breaking} et n'est pas définie par défaut.
947 @funindex system-count
949 Le nombre de systèmes requis par la partition. Cette variable n'est pas
950 définie par défaut. Cette variable peut se gérer au sein d'un bloc
957 @ref{Sauts de ligne}.
960 @node Variables de gestion des sauts de page
961 @unnumberedsubsubsec Variables de gestion des sauts de page
962 @translationof paper variables for page breaking
964 Les valeurs par défaut sont définies dans le fichier
965 @file{ly/paper-defaults-init.ly}.
970 @funindex page-breaking
972 L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
973 entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking},
974 @code{ly:one-page-breaking}, @code{ly:one-line-breaking},
975 @code{ly:one-line-auto-height-breaking}, et @code{ly:optimal-breaking}
978 @item page-breaking-system-system-spacing
979 @funindex page-breaking-system-system-spacing
981 Cette variable permet de « tromper » l'algorithme de gestion des sauts
982 de page quant à la valeur de @code{system-system-spacing}. Ainsi,
983 lorsque @code{page-breaking-system-system-spacing #'padding} a une
984 valeur nettement supérieure à @code{system-system-spacing #'padding},
985 l'algorithme en question aura tendance à disposer moins de systèmes sur
986 une même page. Cette variable est par défaut non définie.
991 Le nombre de pages que devra comporter la partition. Cette variable est
992 par défaut non définie.
996 Les variables qui suivent ne sont effectives que lorsque
997 l'algorithme @code{page-breaking} adopte la fonction
998 @code{ly:page-turn-breaking}. Les sauts de page sont alors
999 positionnés de sorte à minimiser le nombre de tournes. Dans la
1000 mesure où il faut tourner la feuille pour passer d'une page
1001 impaire à une page paire, sera privilégiée une répartition qui
1002 présente une dernière page impaire. Les endroits où une tourne
1003 serait appropriée peuvent s'indiquer à l'aide d'un
1004 @code{\allowPageTurn} ou laissés à l'appréciation du
1005 @code{Page_turn_engraver} -- voir @ref{Optimisation des tournes}.
1007 Lorsqu'aucune option n'est satisfaisante pour placer
1008 judicieusement les tournes, LilyPond peut décider d'insérer une
1009 page blanche au milieu d'une partition ou entre deux partitions
1010 successives, voire même finir par une page paire. La valeur des
1011 trois variables qui suivent peut se voir augmentée de façon à
1012 diminuer ces risques.
1014 Il s'agit ici de pénalité ; autrement dit, au plus la valeur est
1015 élevée, au moins l'action associée sera favorisée en regard des
1020 @item blank-page-penalty
1021 @funindex blank-page-penalty
1023 Pénalité pour apparition d'une page blanche en cours de partition.
1024 L'attribution d'une valeur élevée à @code{blank-page-penalty}
1025 alors qu'a été activé @code{ly:page-turn-breaking} forcera
1026 LilyPond à éviter de placer une page blanche au mileu de la
1027 partition, quitte à espacer d'autant plus la musique pour remplir
1028 cette page blanche et la suivante. La valeur par défaut est
1031 @item blank-last-page-penalty
1032 @funindex blank-last-page-penalty
1034 Pénalité pour fin de partition intervenant sur une page paire.
1035 L'attribution d'une valeur élevée à @code{blank-last-page-penalty}
1036 alors qu'a été activé @code{ly:page-turn-breaking} forcera
1037 LilyPond à éviter de terminer la partition sur une page paire,
1038 quitte à ajuster les espacements jusqu'à obtenir une page de plus
1039 ou une de moins. La valeur par défaut est de @code{0}.
1041 @item blank-after-score-page-penalty
1042 @funindex blank-after-score-page-penalty
1044 Pénalité pour apparition d'une page blanche entre deux partitions. Sa
1045 valeur est par défaut inférieure à celle de
1046 @code{blank-page-penalty} ; nous préférons qu'une page blanche
1047 s'insère après la fin de la partition plutôt qu'au milieu. La
1048 valeur par défaut est de @code{2}.
1053 Manuel de notation :
1054 @ref{Minimisation des sauts de page},
1055 @ref{Optimisation des sauts de page},
1056 @ref{Optimisation des tournes},
1057 @ref{Présentation en ligne continue},
1058 @ref{Présentation en page continue},
1059 @ref{Présentation en rouleau},
1060 @ref{Sauts de page}.
1062 Fichiers d'initialisation :
1063 @file{ly/paper-defaults-init.ly}.
1066 @node Variables de gestion des numéros de page
1067 @unnumberedsubsubsec Variables de gestion des numéros de page
1068 @translationof paper variables for page numbering
1070 Les valeurs par défaut sont définies dans le
1071 fichier @file{ly/paper-defaults-init.ly}.
1075 @cindex pages, numérotation automatique
1076 @item auto-first-page-number
1077 @funindex auto-first-page-number
1079 L'algorithme qui gère les sauts de page prend en compte le fait que le
1080 premier numéro de page soit pair ou impair. Lorsque cette
1081 fonctionnalité est activée, l'algorithme des sauts de page décidera de
1082 lui-même si le premier numéro sera pair ou impair, ce qui se traduira
1083 par un éventuel incrément de un. La valeur par défaut
1086 @cindex pages, numéro de la première
1087 @item first-page-number
1088 @funindex first-page-number
1090 Le numéro de la première page. La valeur par défaut est
1093 @item print-first-page-number
1094 @funindex print-first-page-number
1096 Cette variable permet d'imprimer le numéro de page y compris sur la
1097 première. La valeur par défaut est @code{#f}.
1099 @item print-page-number
1100 @funindex print-page-number
1102 La désactivation de cette variable permet d'obtenir des pages non
1103 numérotées. La valeur par défaut est @code{#t}.
1105 @cindex page, numérotation en chiffres romains
1106 @item page-number-type
1107 @funindex page-number-type
1109 Le type de chiffres à utiliser pour la numérotation : @code{roman-lower}
1110 (romains minuscules), @code{roman-upper} (romains majuscules) ou
1111 @code{arabic} (arabes). La valeur par défaut est @code{'arabic}.
1116 Fichiers d'initialisation :
1117 @file{ly/paper-defaults-init.ly}.
1120 Les pages au numéro impair sont toujours à droite. Pour que la musique
1121 commence en page 1, le dos de la page de garde doit être vide de telle
1122 sorte que la page une se retrouve à droite.
1125 @node Variables supplémentaires
1126 @unnumberedsubsubsec Variables supplémentaires
1127 @translationof Miscellaneous paper variables
1131 @item page-spacing-weight
1132 @funindex page-spacing-weight
1134 Cette variable définit l'importance relative des espacements entre la
1135 page (verticalité) et la ligne (horizontalité). Une valeur élevée
1136 privilégiera l'espacement au niveau de la page. La valeur par défaut
1139 @item print-all-headers
1140 @funindex print-all-headers
1142 Lorsque cette variable est activée, l'intégralité des champs d'entête
1143 sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
1144 champs @code{piece} et @code{opus}. La valeur par défaut
1147 @item system-separator-markup
1148 @funindex system-separator-markup
1150 Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
1151 chaque système, comme on le voit dans nombre de partitions orchestrales.
1152 Cette variable n'est pas définie par défaut. La commande
1153 @code{\slashSeparator} -- définie dans le fichier
1154 @file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
1157 @lilypond[quote,verbatim,noragged-right,line-width=30\mm]
1158 #(set-default-paper-size "a8")
1162 system-separator-markup = \slashSeparator
1168 \relative { c''1 \break c1 \break c1 }
1176 Fichiers d'initialisation :
1177 @file{ly/titling-init.ly}.
1180 @rlsrnamed{Spacing,Espacements}.
1183 L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
1184 page et du champ @code{instrument} contenu dans le bloc @code{\header}.
1187 @node Mise en forme de la partition
1188 @section Mise en forme de la partition
1189 @translationof Score layout
1191 Nous allons voir ici les options du bloc @code{\layout}. Elles sont
1192 plus particulièrement destinées à gérer la mise en forme de la
1197 * Définition de la taille de portée::
1201 @node Le bloc layout
1202 @subsection Le bloc @code{@bs{}layout}
1203 @translationof The layout block
1207 Alors que le bloc @code{\paper} définit le formatage des pages pour
1208 l'intégralité du document, le bloc @code{\layout} gère la mise en
1209 forme spécifique à la partition. La mise en forme de la musique peut
1210 concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
1211 @code{\layout} indépendant se placera en tête de fichier. Dans le cas
1212 où la mise en forme concerne une partition en particulier, un bloc
1213 @code{\layout} se placera au sein du bloc @code{\score} en question.
1214 Sont susceptibles d'apparaître dans un bloc @code{\layout} :
1218 la fonction Scheme @code{layout-set-staff-size},
1221 dans des blocs @code{\context}, les modifications apportées aux
1222 différents contextes, et
1225 les variables normalement attachées au bloc @code{\paper} qui
1226 affecteront la mise en forme de la partition.
1230 La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
1231 suivante, @ref{Définition de la taille de portée}. La modification des
1232 contextes est abordée dans d'autres chapitres -- voir
1233 @ref{Modification des greffons de contexte} et
1234 @ref{Modification des réglages par défaut d'un contexte}.
1236 Les variables du bloc @code{\paper} que l'on peut retrouver dans un bloc
1237 @code{\layout} sont :
1242 @code{line-width}, @code{ragged-right} et @code{ragged-last}
1243 (voir @ref{Variables de marge et de largeur})
1246 @code{indent} et @code{short-indent}
1247 (voir @ref{Variables d'indentation et de décalage})
1251 (voir @ref{Variables de gestion des sauts de ligne})
1255 Voici un exemple de bloc @code{\layout} :
1262 \override StaffGrouper.staff-staff-spacing.basic-distance = #8
1266 \override TextScript.padding = #1
1267 \override Glissando.thickness = #3
1272 Il est tout à fait possible que plusieurs blocs @code{\layout}
1273 cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
1274 particulièrement utile lorsque différents réglages sont stockés dans des
1275 fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
1276 @code{\layout} est évalué, une copie de la configuration du
1277 @code{\layout} actuel est réalisée en interne, augmentée des
1278 aménagements apportés. Bien qu'on puisse considérer que le contenu des
1279 différents blocs @code{\layout} se cumule, c'est la dernière adaptation
1280 qui aura préséance en cas de situation conflictuelle -- cas typique
1281 d'une même propriété modifiée dans différents blocs.
1283 Par exemple, placer le bloc suivant
1289 \override TextScript.color = #magenta
1290 \override Glissando.thickness = #1.5
1295 après celui de l'exemple précédent aura pour effet de cumuler les
1296 adaptations de @code{'padding} et @code{'color} pour l'objet
1297 @code{TextScript}, mais la dernière adaptation apportée à la propriété
1298 @code{'thickness} de @code{Glissando} remplace, ou masque, celle
1299 précédemment établie.
1301 Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
1302 les utiliser ultérieurement. Ceci requiert toutefois une attention
1303 particulière dans la mesure où cette manière de procéder n'est pas
1304 équivalente à une définition complète et globale.
1306 Lorsque nous définissons la variable suivante,
1309 layoutVariable = \layout @{
1312 \override NoteHead.font-size = #4
1317 qui contient une configuration de @code{\layout} avec
1318 l'adaptation @code{NoteHead.font-size}, cette combinaison n'est pas
1319 enregistrée en tant que configuration courante. Notez bien que la
1320 « configuration courante » est lue lorsque la variable est définie, non
1321 lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
1322 variable dépend de l'endroit où elle se trouve dans le code source.
1324 Notre variable peut alors être utilisée au sein d'un autre bloc
1325 @code{\layout}, comme par exemple :
1332 \override NoteHead.color = #red
1337 Un bloc @code{\layout} qui contient une variable comme ci-dessus ne
1338 recopie pas la configuration actuelle ; il utilise en fait le contenu de
1339 @code{layoutVariable} en tant que configuration de base pour les
1340 adaptations ultérieures, en conséquence de quoi toute modification
1341 intervenant entre la définition et l'utilisation de la variable sera
1344 Si @code{layoutVariable} est définie, ou rapatriée par un
1345 @code{\indude}, juste avant d'être utilisée, son contenu devient la
1346 configuration actuelle augmentée des adaptations que la variable
1347 contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
1348 ci-dessus, le bloc @code{\layout} final contiendra donc :
1351 TextScript.padding = #1
1352 TextScript.color = #magenta
1353 Glissando.thickness = #1.5
1354 NoteHead.font-size = #4
1355 NoteHead.color = #red
1358 ainsi que les adaptations de @code{indent} et @code{StaffGrouper}.
1360 Cependant, si la variable avait été définie bien avant le premier bloc
1361 @code{\layout}, la configuration actuelle ne contiendrait que
1364 NoteHead.font-size= #4 % (écrit dans la définition de la variable)
1365 NoteHead.color = #red % (ajouté après l'utilisation de la variable)
1368 Une gestion attentive des variables de @code{\layout} se révèle être un
1369 outil précieux dans la mise en forme des sources et le retour à une
1370 configuration donnée.
1373 Manuel de notation :
1374 @ref{Modification des réglages par défaut d'un contexte}.
1377 @rlsrnamed{Spacing,Espacements}.
1380 @node Définition de la taille de portée
1381 @subsection Définition de la taille de portée
1382 @translationof Setting the staff size
1384 @cindex fonte, définition de la taille
1385 @cindex portée, définition de la taille
1386 @funindex layout file
1387 @funindex magnification->font-size
1389 @funindex set-global-staff-size
1390 @funindex layout-set-staff-size
1392 La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
1393 20 points, ce qui correspond à 7,03 cm -- 1 point équivaut à
1394 100/7227 pouce, soit 2 540/7 227 mm. Il existe trois manières de la
1400 La taille des portées peut se définir globalement pour toutes les
1401 partitions d'un même fichier, ou plus précisément d'un bloc
1402 @code{\book}, à l'aide de @code{set-global-staff-size}.
1405 #(set-global-staff-size 14)
1409 Ceci définit donc la hauteur des portées à 14 points (4,92 mm) par
1410 défaut ; toutes les fontes seront ajustées en conséquence.
1413 La taille d'une partition particulière au sein d'un ouvrage se définit à
1414 l'aide d'un @code{layout-set-staff-size} placé dans le bloc
1415 @code{\layout} approprié :
1421 #(layout-set-staff-size 14)
1427 L'affectation d'une taille particulière à l'une des portées d'un
1428 système, LilyPond dispose de la commande @code{\magnifyStaff}. Par
1429 exemple, les partitions traditionnelles de musique de chambre avec piano
1430 présentaient souvent des portées de piano de 7 mm alors que les autres
1431 portées étaient gravées à une hauteur de cinq septièmes (s'il y avait
1432 assez de place) ou trois cinquièmes (en cas de présentation resserrée)
1433 de cette hauteur. Une proportion de 5/7 s'obtient se libelle ainsi :
1441 \new PianoStaff @{ @dots{} @}
1446 Si la valeur de @code{fontSize} à utiliser est connue, la forme suivante
1453 \magnifyStaff #(magstep -3)
1455 \new PianoStaff @{ @dots{} @}
1460 Mieux vaut éviter de réduire l'épaisseur des lignes si l'on veut que la
1461 partition s'approche au plus près des canons de la gravure
1467 @subheading Relation automatique entre fonte et taille
1468 @c VO Automatic font weight at different sizes
1470 Le glyphe Feta fournit les symboles musicaux dans huit tailles
1471 différentes. Chaque fonte correspond à une hauteur particulière de
1472 portée ; les petites tailles comportent des symboles plus épais
1473 pour être cohérent avec l'épaisseur relativement plus importante des
1474 lignes de la portée. Le tableau suivant répertorie les différentes
1477 @multitable @columnfractions .15 .2 .22 .2
1479 @item @b{nom de la fonte} @tab @b{hauteur de portée (pt)} @tab @b{hauteur de portée (mm)} @tab @b{utilisation}
1481 @item feta11 @tab 11,22 @tab 3,9 @tab format de poche
1482 @item feta13 @tab 12,60 @tab 4,4 @tab
1483 @item feta14 @tab 14,14 @tab 5,0 @tab
1484 @item feta16 @tab 15,87 @tab 5,6 @tab
1485 @item feta18 @tab 17,82 @tab 6,3 @tab carnet de chant
1486 @item feta20 @tab 20 @tab 7,0 @tab partition standard
1487 @item feta23 @tab 22,45 @tab 7,9 @tab
1488 @item feta26 @tab 25,2 @tab 8,9 @tab @c matériel de location moderne ?
1492 Manuel de notation :
1493 @ref{Indication de la taille de fonte musicale},
1494 @ref{La fonte Emmentaler}.
1497 @rlsrnamed{Spacing,Espacements}.
1500 @code{layout-set-staff-size} ne modifie en rien l'espacement entre les
1501 lignes d'une portée.
1506 @translationof Breaks
1514 @node Sauts de ligne
1515 @subsection Sauts de ligne
1516 @translationof Line breaking
1518 @cindex saut de ligne manuel
1519 @cindex ligne, passer à la suivante
1522 @funindex \autoBreaksOff
1523 @funindex \autoBreaksOn
1524 @funindex \autoLineBreaksOff
1525 @funindex \autoLineBreaksOn
1527 Les sauts de ligne sont normalement gérés de façon automatique. Ils
1528 interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
1529 trop aérée, et que des lignes consécutives aient à peu près la même
1532 Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
1533 vous le jugez utile pour « forcer » le passage à la ligne suivante :
1535 @lilypond[quote,ragged-right,verbatim]
1542 Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
1543 mesure ; LilyPond vous le signalera par un message lors de la
1544 compilation du fichier. Si d'aventure vous voulez forcer un saut de
1545 ligne en l'absence de barre de mesure, vous devrez auparavant insérer
1546 une barre invisible -- à l'aide de @code{\bar ""}.
1548 @lilypond[quote,ragged-right,verbatim]
1558 LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
1559 mesure dès lors que la précédente avait une note en suspend -- c'est
1560 typiquement le cas lorsqu'un n-olet est à cheval sur deux mesures.
1561 L'instruction @code{\break} sera toutefois opérationnelle si vous avez
1562 auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
1563 @code{Voice} concerné. Notez bien qu'en pareil cas, les sauts de ligne
1564 forcés doivent être saisis au sein d'une expression polyphonique :
1566 @lilypond[quote,ragged-right,verbatim]
1568 \remove "Forbid_line_break_engraver"
1571 { c''2. \tuplet 3/2 { c4 c c } c2. | }
1572 { s1 | \break s1 | }
1577 Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
1578 ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
1579 introduire la dérogation @w{@code{\override Beam.breakable = ##t}}.
1581 @lilypond[quote,ragged-right,verbatim]
1583 \override Beam.breakable = ##t
1589 L'instruction opposée, @code{\noBreak}, interdira toute tentative de
1590 saut de ligne à la fin de la mesure où elle est explicitée.
1592 Au sein même d'une pièce, les sauts de lignes automatiques sont inhibés
1593 dans la musique encadrée par les commandes @code{\autoLineBreaksOff} et
1594 @code{\autoLineBreaksOn}. Dans le cas où les sauts de pages
1595 automatiques devraient eux aussi être inhibés, ce sont les commandes
1596 @code{\autoBreaksOff} et @code{\autoBreaksOn} qu'il faudrait utiliser.
1597 Les sauts de ligne ou de page manuels ne sont pas affectés par ces
1598 commandes. Notez bien que la désactivation du positionnement
1599 automatique des sauts des ligne peut avoir pour effet un débordement de
1600 la musique dans la marge de droite si tout ne peut être contenu sur une
1603 Des sauts de ligne automatiques peuvent cependant être autorisés en un
1604 point particulier à l'aide d'un @code{\once \autoLineBreaksOn} sur une
1605 barre de mesure. Ceci ne concerne pas les sauts de page. Ceci indique
1606 qu'un saut de ligne peut intervenir à cet endroit précis, mais ne le
1609 LilyPond dispose de deux variables de base pour influencer l'espacement
1610 au niveau des lignes. Toutes deux se définissent dans un bloc
1611 @code{\layout}, @code{indent} réglant l'indentation de la première
1612 ligne, et @code{line-width} la longueur des lignes.
1614 L'activation du commutateur @code{ragged-right} au sein du bloc
1615 @code{\layout} aura pour effet de terminer les systèmes là où ils
1616 prendraient fin normalement plutôt que de les étirer sur toute la
1617 longueur de la ligne. Ceci est particulièrement utile pour de petits
1618 fragments ou pour vérifier la densité induite par l'espacement naturel.
1620 @c TODO Check and add para on default for ragged-right
1622 Le commutateur @code{ragged-last} est équivalent à @code{ragged-right},
1623 à ceci près qu'il n'affecte que la dernière ligne de la pièce.
1633 @cindex sauts de ligne réguliers
1634 @cindex portée à quatre mesures
1636 L'utilisation conjointe de @code{\break} et de blancs dans une section
1637 @code{\repeat} vous permettra de positionner des sauts de ligne à
1638 intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
1639 l'on est à 4/4, seront coupées toutes les quatre mesures, pas
1645 s1 \noBreak s1 \noBreak
1646 s1 \noBreak s1 \break
1648 @{ @var{et ici la musique@dots{}} @}
1655 @code{\autoBreaksOff},
1656 @code{\autoBreaksOn},
1657 @code{\autoLineBreaksOff},
1658 @code{\autoLineBreaksOn}.
1663 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
1664 {using-an-extra-voice-for-breaks.ly}
1667 Manuel de notation :
1668 @ref{Le bloc layout},
1669 @ref{Variables de gestion des sauts de ligne}.
1671 Référence des propriétés internes :
1672 @rinternals{LineBreakEvent}.
1675 @rlsrnamed{Spacing,Espacements}.
1679 Les commandes @code{\autoLineBreaksOff} et @code{\autoBreaksOff} doivent
1680 impérativement se placer après le début de la musique pour éviter tout
1685 @subsection Sauts de page
1686 @translationof Page breaking
1688 Cette section présente les différentes méthodes de gestion des sauts de
1689 page, ainsi que les moyens de les modifier.
1692 * Saut de page manuel::
1693 * Optimisation des sauts de page::
1694 * Minimisation des sauts de page::
1695 * Présentation en page continue::
1696 * Présentation en ligne continue::
1697 * Présentation en rouleau::
1698 * Optimisation des tournes::
1702 @node Saut de page manuel
1703 @unnumberedsubsubsec Saut de page manuel
1704 @translationof Manual page breaking
1706 @cindex manuel, saut de page
1707 @funindex \pageBreak
1708 @funindex \noPageBreak
1709 @funindex \autoPageBreaksOn
1710 @funindex \autoPageBreaksOff
1712 La gestion automatique des sauts de page se contrôle à l'aide des
1713 commandes @code{\pageBreak} et @code{\noPageBreak}. Ces commandes
1714 fonctionnent de manière analogue à @code{\break} et @code{\noBreak} pour
1715 les sauts de ligne et se placent donc au moment d'une barre de mesure.
1716 Elles permettent de forcer, ou d'interdire, un saut de page à la
1717 prochaine barre de mesure. Comme on peut s'y attendre,
1718 @code{\pageBreak} force aussi le saut de ligne.
1720 Les commandes @code{\pageBreak} et @code{\noPageBreak} peuvent se
1721 trouver à des niveaux supérieurs, entre deux partitions ou
1722 @emph{markups} de premier rang.
1724 Au sein même d'une pièce, les sauts de page automatiques sont inhibés
1725 dans la musique encadrée par les commandes @code{\autoPageBreaksOff} et
1726 @code{\autoPageeBreaksOn}. Les sauts de page manuels ne sont pas
1727 affectés par ces commandes.
1729 Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
1730 gérer la répartition horizontale, LilyPond dispose de commutateurs
1731 équivalents au niveau de la verticalité. @code{ragged-bottom}, une fois
1732 activé, empèchera les systmèes de se répartir sur la page. Quant à
1733 @code{ragged-last-bottom} (valorisé à @code{#t} par défaut), il laissera
1734 un espace vide en dernière page, y compris pour cahque @code{\bookpart}.
1735 Pour de plus amples détails, reportez-vous à
1736 @ref{Variables d'espacement vertical fixe}.
1738 Les sauts de page sont générés par la fonction @code{page-breaking}.
1739 LilyPond dispose de plusieurs algorithmes en la matière :
1740 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
1741 @code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
1742 activé par défaut, mais rien ne vous empêche d'en changer, par
1743 l'intermédiaire du bloc @code{\paper} :
1747 page-breaking = #ly:page-turn-breaking
1753 Lorsqu'un ouvrage contient plusieurs partitions et un certain nombre de
1754 pages, la gestion des sauts de page finit par devenir très gourmande,
1755 tant au niveau du processeur que de la mémoire. Vous pouvez cependant
1756 alléger la charge en recourant à des blocs @code{\bookpart} afin de
1757 sectionner l'ouvrage que vous traitez ; les sauts de page seront
1758 alors gérés individuellement au niveau de chacune des parties. Par
1759 ailleurs, cela vous autorisera une gestion différente selon les
1765 subtitle = "Préface"
1768 %% Pour une partie constituée principalement de texte
1769 %% ly:minimal-breaking est plus judicieux.
1770 page-breaking = #ly:minimal-breaking
1772 \markup @{ @dots{} @}
1776 %% Cette partie étant purement musicale,
1777 %% retour au style par défaut (optimal-breaking).
1779 subtitle = "Premier mouvement"
1781 \score @{ @dots{} @}
1788 @code{\noPageBreak},
1789 @code{\autoPageBreaksOn},
1790 @code{\autoPageBreaksOff}.
1794 Manuel de notation :
1795 @ref{Variables de gestion des sauts de page}.
1798 @rlsrnamed{Spacing,Espacements}.
1802 Le préfixe @code{\once} est ineffectif en ce qui concerne les commandes
1803 @code{\autoPageBreaksOn} et @code{\autoPageBreaksOff}. Si le
1804 positionnement automatique des sauts de page est désactivé et qu'il est
1805 réactivé pour permettre un saut de page, il doit le rester pendant
1806 quelques mesures (le nombre précis de mesures dépendant de la pièce)
1807 avant d'être à nouveau désactivé, autrement l'opportunité de passer à la
1808 page suivante ne sera pas saisie.
1811 @node Optimisation des sauts de page
1812 @unnumberedsubsubsec Optimisation des sauts de page
1813 @translationof Optimal page breaking
1815 @funindex ly:optimal-breaking
1817 LilyPond, pour déterminer où placer un saut de page, utilise par défaut
1818 la fonction @code{ly:optimal-breaking}. Celle-ci tend à trouver une
1819 rupture qui évite d'obtenir à la fois une page trop dense ou exagérément
1820 aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
1821 n'a aucune notion de ce qu'est une « tourne ».
1825 @rlsrnamed{Spacing,Espacements}.
1828 @node Minimisation des sauts de page
1829 @unnumberedsubsubsec Minimisation des sauts de page
1830 @translationof Minimal page breaking
1832 @funindex ly:minimal-breaking
1834 La fonction @code{ly:minimal-breaking} est celle qui réalise le moins de
1835 calculs pour positionner les sauts de page. Elle mettra le plus de
1836 systèmes possible sur une page avant de passer à la suivante. On peut
1837 donc la préférer lorsque la partition s'étend sur beaucoup de pages ou
1838 lorsque les autres fonctions de gestion des sauts de page ralentissent
1839 nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
1840 beaucoup de texte. Il suffit de la mentionner au sein du bloc
1845 page-breaking = #ly:minimal-breaking
1851 @rlsrnamed{Spacing,Espacements}.
1854 @node Présentation en page continue
1855 @unnumberedsubsubsec Présentation en page continue
1856 @translationof One-page page breaking
1858 @funindex ly:one-page-breaking
1860 La fonction @code{ly:one-page-breaking} constitue un algorithme de
1861 calcul des sauts de page particulier en ceci que la hauteur de page sera
1862 automatiquement ajustée à la longueur de la partition, de telle sorte
1863 que toute la musique tienne sur une seule page. La variable
1864 @code{paper-height} du bloc @code{\paper} est ignorée, mais les autres
1865 réglages restent disponibles. En particulier, l'espacement entre le
1866 dernier système (ou un @emph{markup} de premier niveau) et le pied de
1867 page est réglable à l'aide de la variable @code{last-bottom-spacing}
1868 du bloc @code{\paper}. La largeur de page n'est, par défaut, pas
1869 modifiée ; ceci peut s'ajuster à l'aide de la variable
1870 @code{paper-width} du bloc @code{\paper}.
1873 @code{ly:one-page-breaking} est à ce jour incompatible avec
1874 l'utilisation de @code{\bookpart}.
1877 @node Présentation en ligne continue
1878 @unnumberedsubsubsec Présentation en ligne continue
1879 @translationof One-line page breaking
1881 @funindex ly:one-line-breaking
1883 La fonction @code{ly:one-line-breaking} constitue un algorithme de
1884 calcul des sauts de page particulier en ceci que chaque partition fait
1885 l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
1886 s'affranchit de l'impression des titres et marges ; seule la partition
1889 La largeur de page est ajustée de telle sorte que la pièce la plus
1890 longue tienne sur une seule ligne. En particulier, les variables
1891 @code{paper-width}, @code{line-width} et @code{indent} du bloc
1892 @code{\paper} seront ignorées ; les @code{left-margin} et
1893 @code{right-margin} seront honorées. La hauteur de page ne sera pas
1897 @node Présentation en rouleau
1898 @unnumberedsubsubsec Présentation en rouleau
1899 @translationof One-line-auto-height page breaking
1901 @funindex ly:one-line-auto-height-breaking
1903 La fonction @code{ly:one-line-auto-height-breaking} opère comme
1904 @code{ly:one-line-breaking}, à ceci près que la hauteur de page s'adapte
1905 automatiquement à la hauteur de la musique. Dans les faits, la variable
1906 @code{paper-height} du bloc @code{\paper} s'ajuste de façon à englober
1907 la hauteur de la partition la plus étendue, plus les @code{top-margin}
1908 et @code{bottom-margin}.
1910 L'affectation d'une valeur à @code{top-system-spacing} influencera le
1911 positionnement vertical de la musique. Sa désactivation -- valorisation
1912 à @code{##f} au sein du bloc @code{\paper} -- aura pour effet de
1913 simplement placer la musique entre les marges supérieure et inférieure.
1916 @node Optimisation des tournes
1917 @unnumberedsubsubsec Optimisation des tournes
1918 @translationof Optimal page turning
1920 @funindex ly:page-turn-breaking
1922 Aboutir à une configuration des sauts de page de telle sorte que les
1923 pages de droite se terminent toujours par un silence devient souvent une
1924 nécessité. En effet, l'exécutant pourra alors tourner la page sans
1925 risquer de manquer des notes. La fonction @code{ly:page-turn-breaking}
1926 tend à trouver une rupture qui évite d'obtenir à la fois une page trop
1927 dense ou exagérément aérée, tout en tenant compte du fait qu'une tourne
1928 ne saurait intervenir qu'à certains endroits.
1930 L'utilisation de cette fonction se fait en deux étapes. Il vous faut
1931 tout d'abord l'activer au sein du bloc @code{\paper} comme indiqué à la
1932 rubrique @ref{Sauts de page}. Vous devrez, dans un deuxième temps,
1933 informer la fonction des endroits où les sauts de page sont permis.
1935 Cette deuxième étape se réalise de deux manières différentes. Vous
1936 pouvez spécifier manuellement chaque tourne potentielle en insérant un
1937 @code{\allowPageTurn} à l'endroit approprié de votre fichier source.
1939 Toutefois, cette option peut vite se révéler fastidieuse selon l'ampleur
1940 de l'œuvre. Vous pouvez alors recourir au @code{Page_turn_engraver} que
1941 vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
1942 tournes recherchera dans le contexte en question les passages sans note.
1943 Notez bien qu'il ne recherche pas des silences, mais l'absence de
1944 notes ; autrement dit, il ne restera pas inactif dans le cadre
1945 d'une portée polyphonique dont l'une des parties contiendrait des
1946 silences. Lorsqu'il rencontre un fragment suffisamment long ne
1947 contenant aucune note, il insère un @code{\allowPageTurn} à la barre
1948 terminant ce fragment, à moins qu'il ne rencontre en chemin une
1949 « barre spéciale » -- telle une double barre -- auquel cas il y
1950 déposera le @code{\allowPageTurn}.
1952 @funindex minimumPageTurnLength
1954 Le @code{Page_turn_engraver} examine la propriété de contexte
1955 @code{minimumPageTurnLength} pour déterminer quelle doit être la
1956 longueur d'un fragment sans note avant une tourne. La valeur par
1957 défaut de @code{minimumPageTurnLength} est
1958 @code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
1959 la manière suivante :
1962 \new Staff \with @{ \consists "Page_turn_engraver" @}
1965 R1 | % une tourne peut se placer ici
1967 \set Staff.minimumPageTurnLength = #(ly:make-moment 5/2)
1968 R1 | % il ne peut pas y avoir de tourne ici
1970 R1*2 | % une tourne peut se placer ici
1975 @funindex minimumRepeatLengthForPageTurn
1977 Le @code{Page_turn_engraver} tient compte des reprises. C'est pourquoi
1978 il ne permettra une tourne que dans le cas où il y aura suffisamment de
1979 temps au début et à la fin de la reprise pour que l'exécutant puisse
1980 aisément revenir à la page précédente. Le @code{Page_turn_engraver} est
1981 même capable d'interdire un tourne dans le cas d'une reprise de courte
1982 durée, ajustable au travers de la propriété de contexte
1983 @code{minimumRepeatLengthForPageTurn}.
1985 Les commandes de tourne -- @code{\pageTurn}, @code{\noPageTurn} et
1986 @code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
1987 entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
1992 @funindex \noPageTurn
1994 @funindex \allowPageTurn
1995 @code{\allowPageTurn}.
1999 Manuel de notation :
2000 @ref{Variables de gestion des sauts de ligne}.
2003 @rlsrnamed{Spacing,Espacements}.
2006 Une partition ne devrait contenir qu'une seule instance du
2007 @code{Page_turn_engraver}, au risque de les voir se contredire.
2010 @node Espacement vertical
2011 @section Espacement vertical
2012 @translationof Vertical spacing
2014 @cindex vertical, espacement
2015 @cindex espacement vertical
2017 L'espacement vertical dépend de trois éléments : la surface
2018 disponible -- format de papier et marges --, l'espace qui doit
2019 séparer les systèmes, et l'espace qui sépare les portées d'un même
2023 * Espacement vertical au sein d'un système::
2024 * Positionnement explicite des portées et systèmes::
2025 * Résolution des collisions verticales::
2029 @node Espacement vertical au sein d'un système
2030 @subsection Espacement vertical au sein d'un système
2031 @translationof Flexible vertical spacing within systems
2033 @cindex distance entre les portées
2034 @cindex portées, espacement
2035 @cindex espacement entre les portées
2036 @cindex espacement au sein d'un système
2038 LilyPond dispose de trois différents mécanismes permettant de contrôler
2039 l'espacement au sein d'un système selon trois catégories :
2044 @emph{portées isolées},
2047 @emph{portées regroupées} (portées d'un même groupe, telles celles
2048 d'un @code{ChoirStaff}, etc.), et
2051 @emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
2055 @c TODO: Clarify this. This almost implies that non-staff lines
2056 @c have NO effect on the spacing between staves. -mp
2058 La hauteur de chaque système se détermine en deux phases. Les portées
2059 sont tout d'abord espacées selon la surface disponible. Puis les lignes
2060 autres que des portées, comme les paroles ou les accords, sont réparties
2063 Les paragraphes qui suivent traitent exclusivement de la manière de
2064 gérer l'espacement entre les lignes d'un système -- portée musicale ou
2065 non. Pour ce qui a trait aux espacements entre les systèmes,
2066 mouvements, annotations et marge, ils sont contrôlés par des variables
2067 attachées au bloc @code{\paper} et font l'objet du chapitre
2068 @ref{Variables d'espacement vertical fluctuant}.
2071 * Propriétés d'espacement au sein d'un système::
2072 * Espacement de portées isolées::
2073 * Espacement de portées regroupées::
2074 * Espacement des lignes rattachées à des portées::
2078 @node Propriétés d'espacement au sein d'un système
2079 @unnumberedsubsubsec Propriétés d'espacement au sein d'un système
2080 @translationof Within-system spacing properties
2082 @funindex staff-affinity
2083 @funindex staffgroup-staff-spacing
2084 @funindex staff-staff-spacing
2085 @funindex nonstaff-unrelatedstaff-spacing
2086 @funindex nonstaff-relatedstaff-spacing
2087 @funindex nonstaff-nonstaff-spacing
2088 @funindex default-staff-staff-spacing
2089 @funindex minimum-Y-extent
2090 @funindex extra-offset
2091 @funindex self-alignment-X
2093 @funindex VerticalAxisGroup
2095 L'espacement entre les portées est géré par deux jeux de propriétés
2096 d'objet graphique (@emph{grob}). Le premier, associé à l'objet
2097 graphique @code{VerticalAxisGroup}, est créé pour toute ligne de portée
2098 ou de non-portée. Le second, associé à l'objet graphique
2099 @code{StaffGrouper}, doit être explicitement créé pour un regroupement
2100 de portées particulier. Les propriétés qui leur sont attachées sont
2101 abordées en fin de section.
2103 Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
2104 @w{@code{@var{item1}-@var{item2}-spacing}} -- @code{@var{item1}} et
2105 @code{@var{item2}} étant les éléments à espacer. Notez bien que
2106 @code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
2107 cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
2108 l'espacement d'une ligne de non-portée alors que sa
2109 @code{staff-affinity} a été déterminée à @code{UP}.
2111 Toutes ces distances sont mesurées entre les points de référence
2112 respectifs des éléments considérés.
2113 Le @i{point de référence} d'une portée est le centre vertical du
2114 @code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
2115 l'interligne médian si @code{line-count} est pair.
2116 Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
2117 tableau suivant présente le @i{point de référence} pour chacune
2120 @multitable {Ligne de non-portée} {Point de référence}
2121 @headitem Ligne de non-portée @tab Point de référence
2122 @item @code{ChordNames} @tab ligne de base
2123 @item @code{NoteNames} @tab ligne de base
2124 @item @code{Lyrics} @tab ligne de base
2125 @item @code{Dynamics} @tab mi-hauteur du « m »
2126 @item @code{FiguredBass} @tab point le plus haut
2127 @item @code{FretBoards} @tab ligne supérieure
2130 En voici une représentation graphique :
2133 @lilypond[quote,noragged-right,line-width=110\mm]
2134 #(define zero-space '((padding . -inf.0) (basic-distance . 0)))
2136 alignToZero = \with {
2137 \override VerticalAxisGroup.nonstaff-relatedstaff-spacing = #zero-space
2138 \override VerticalAxisGroup.nonstaff-nonstaff-spacing = #zero-space
2139 \override VerticalAxisGroup.staff-affinity = #DOWN
2140 \remove Text_engraver % avoid having two
2141 \consists Text_engraver
2143 lowerCaseChords = \with {
2144 chordNameLowercaseMinor = ##t
2147 #(define-music-function
2150 #{ s1*0^\markup { \upright {\typewriter #context } } #})
2153 \context { \Dynamics \alignToZero }
2154 \context { \FiguredBass \alignToZero }
2155 \context { \Lyrics \alignToZero }
2156 \context { \NoteNames \alignToZero }
2157 \context { \ChordNames \alignToZero \lowerCaseChords }
2158 \context { \FretBoards \alignToZero }
2161 \override DynamicText.self-alignment-X = #-1
2162 \override FretBoard.X-offset = #1.75
2163 \override InstrumentName.minimum-Y-extent = #'(-1 . 2)
2169 %% Contextes dont le point de référence est la ligne de base :
2170 %% ChordNames, NoteNames et Lyrics
2172 \new ChordNames { \chords { \labelContext "ChordNames" g1:m } }
2173 \new NoteNames { s1 |\labelContext "NoteNames" g1 | }
2174 \new Lyrics { \lyrics { \skip 1*2 | \labelContext "Lyrics" ghijk1 | } }
2175 \new RhythmicStaff \with { instrumentName = #"ligne de base (baseline) " } s1*3
2178 %% Le point de référence de Dynamics est le milieu du « m » dans la fonte
2180 \new Dynamics { \labelContext "Dynamics" s1\mp s\fp }
2181 \new RhythmicStaff \with { instrumentName = #"mid-hauteur " } s1*3
2184 %% Le point de référence de FiguredBass est son point le plus haut
2186 \new FiguredBass { \labelContext "FiguredBass" \figuremode { <6 5>1 } }
2187 \new RhythmicStaff \with { instrumentName = #"point le plus haut " } s1
2190 %% Le point de référence de FretBoards est la ligne du haut
2191 \include "predefined-guitar-fretboards.ly"
2193 \new FretBoards { \labelContext "FretBoards" \chordmode { e1 } }
2194 \new RhythmicStaff \with { instrumentName = #"ligne du haut " } s1
2198 Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
2199 @code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
2200 sous la forme d'une liste associative dont la structure est
2201 identique à celle des variables du bloc @code{\paper} que nous avons
2202 examinées au chapitre
2203 @ref{Variables d'espacement vertical fluctuant}. Les particularités en
2204 matière de modification d'une liste associative font l'objet d'un
2205 @rusernamed{Modification de listes associatives,chapitre particulier}.
2206 Les propriétés des objets graphiques se règlent avec un @code{\override}
2207 mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
2210 L'exemple suivant illustre deux façons de modifier une liste
2211 associative. La première déclaration n'agit que sur une seule clé,
2212 alors que la seconde redéfinit la propriété dans son intégralité.
2216 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2220 \override VerticalAxisGroup.default-staff-staff-spacing =
2221 #'(('basic-distance . 10)
2222 (minimum-distance . 9)
2224 (stretchability . 10))
2228 La modification d'un espacement au niveau global se mentionne au sein du
2229 bloc @code{\layout} :
2235 \override VerticalAxisGroup.default-staff-staff-spacing.basic-distance = #10
2240 Les réglages concernant les propriétés d'espacement vertical des objets
2241 graphiques sont répertoriées aux chapitres
2242 @rinternals{VerticalAxisGroup} et @rinternals{StaffGrouper}.
2243 Les propriétés relatives aux lignes de non-portée sont répertoriées
2244 selon la définition de leur contexte dans la
2245 @rinternalsnamed{Contexts,Référence des propriétés internes}.
2248 @subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
2249 @c VO Properties of the @code{VerticalAxisGroup} grob
2251 Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
2252 d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
2256 @item staff-staff-spacing
2257 Il s'agit de la distance entre la portée en cours et la portée qui suit
2258 au sein du même regroupement, qu'il y ait ou des lignes de non-portée
2259 (@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
2260 pas à la dernière portée d'un système.
2262 En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
2263 d'un @code{VerticalAxisGroup} affectera les propriétés du
2264 @code{StaffGrouper} si la portée est incluse dans un regroupement ;
2265 elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
2266 regroupement. Les portées peuvent donc s'aligner différemment selon
2267 qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
2268 tenir compte des éventuels regroupements, cette fonction peut faire
2269 place à une complète redéfinition des espacements fluctuants à l'aide de
2270 règles dérogatoires comme vu précédemment.
2272 @item default-staff-staff-spacing
2273 Il s'agit de la distance qui s'appliquera par défaut aux portées
2274 isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
2275 explicitement par un @code{\override}.
2277 @item staff-affinity
2278 Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
2279 que prendra une ligne de non-portée pour aller s'accoler aux portées
2280 adjacentes . Si vous lui attribuez @code{CENTER}, cette ligne de
2281 non-portée ira se placer à équidistance entre les portées qui
2282 l'encadrent, tout en tenant compte des éventuels risques de collision et
2283 autres contraintes d'espacement. Des lignes de non-portée
2284 adjacentes devraient avoir une @code{staff-affinity} allant de haut en
2285 bas -- autrement dit, pas de @code{UP} après un @code{DOWN}.
2286 Une ligne de non-portée en dessous d'un système devrait avoir sa
2287 @code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
2288 cette ligne surplombe un système, sa @code{staff-affinity} devrait être
2289 définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
2290 @code{staff-affinity} : si vous affectez la valeur @code{#f} à
2291 une ligne de non-portée, cette ligne sera considérée comme étant une
2292 portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
2293 pour une portée lui fera perdre cette qualité.
2295 @item nonstaff-relatedstaff-spacing
2296 Il s'agit de la distance entre la ligne de non-portée en cours et la
2297 portée la plus proche selon la @code{staff-affinity}, à la double
2298 condition qu'il n'y ait pas déjà une autre ligne de non-portée et que la
2299 valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
2300 la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
2301 de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
2302 non-portée entre les deux portées adjacentes même si une autre
2303 non-portée est présente (quelque soit le côté). Le positionnement
2304 d'une ligne de non-portée dépend donc à la fois des portées qui
2305 l'entourent tout comme des autres lignes de non-portée adjacentes.
2306 L'affectation d'une faible valeur à la propriété @code{stretchability}
2307 de l'un de ces types d'espacement l'avantagera ; lui affecter une
2308 valeur élevée aura pour conséquence de diminuer l'influence de
2309 l'espacement considéré.
2311 @item nonstaff-nonstaff-spacing
2312 Il s'agit de la distance entre deux lignes de non-portée selon
2313 l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
2314 la même orientation. Bien entendu, ceci ne peut concerner que les
2315 valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
2317 @item nonstaff-unrelatedstaff-spacing
2318 Il s'agit de la distance entre une ligne de non-portée et la portée à
2319 l'opposé de l'orientation adoptée, à la double condition qu'il n'y ait
2320 pas déjà une autre ligne de non-portée et que la valeur de
2321 @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
2322 trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
2323 portée à laquelle elle ne correspond pas.
2327 @subsubheading Propriétés de l'objet @code{StaffGrouper}
2328 @c VO Properties of the @code{StaffGrouper} grob
2330 Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
2331 d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
2335 @item staff-staff-spacing
2336 Il s'agit de la distance entre deux portées consécutives d'un même
2337 système. La propriété @code{staff-staff-spacing} de l'objet
2338 @code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
2339 l'aide de règles dérogatoires.
2341 @item staffgroup-staff-spacing
2342 Il s'agit de la distance entre la dernière portée d'un regroupement et
2343 la portée suivante, au sein d'un même système, y compris lorsqu'une ou
2344 plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
2345 deux. Cette propriété ne concerne pas la dernière portée d'un système.
2346 Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
2347 regroupement a été ajustée au niveau de son propre
2348 @code{VerticalAxisGroup}, cette dernière aura préséance.
2352 Manuel de notation :
2353 @ref{Modification de listes associatives},
2354 @ref{Variables d'espacement vertical fluctuant}.
2356 Fichiers d'initialisation :
2357 @file{ly/engraver-init.ly},
2358 @file{scm/define-grobs.scm}.
2360 Référence des propriétés internes :
2361 @rinternals{Contexts},
2362 @rinternals{VerticalAxisGroup},
2363 @rinternals{StaffGrouper}.
2366 @node Espacement de portées isolées
2367 @unnumberedsubsubsec Espacement de portées isolées
2368 @translationof Spacing of ungrouped staves
2370 Les @code{Staff}, @code{DrumStaff}, @code{TabStaff} entre autres sont
2371 des contextes de « portée » pouvant contenir plusieurs voix, mais pas
2374 L'espacement de ces @i{portées isolées} est géré par les propriétés
2378 @item Propriétés du @code{VerticalAxisGroup} :
2380 @item @code{default-staff-staff-spacing}
2381 @item @code{staff-staff-spacing}
2385 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2386 @ref{Propriétés d'espacement au sein d'un système}.
2388 Certaines propriétés supplémentaires s'appliqueront dès lors que
2389 ces portées sont regroupées -- voir
2390 @ref{Espacement de portées regroupées}.
2392 L'exemple suivant illustre la manière de gérer l'espacement de portées
2393 isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
2394 Les mêmes règles appliquées de manière dérogatoire au
2395 @code{staff-staff-spacing} produiront les mêmes effets, y compris au
2396 sein de regroupements.
2398 @lilypond[verbatim,quote,staffsize=16]
2402 \override VerticalAxisGroup.default-staff-staff-spacing =
2403 #'((basic-distance . 8)
2404 (minimum-distance . 7)
2410 % The very low note here needs more room than 'basic-distance
2411 % can provide, so the distance between this staff and the next
2412 % is determined by 'padding.
2413 \new Staff { b,2 r | }
2415 % Here, 'basic-distance provides enough room, and there is no
2416 % need to compress the space (towards 'minimum-distance) to make
2417 % room for anything else on the page, so the distance between
2418 % this staff and the next is determined by 'basic-distance.
2419 \new Staff { \clef bass g2 r | }
2421 % By setting 'padding to a negative value, staves can be made to
2422 % collide. The lowest acceptable value for 'basic-distance is 0.
2424 \override VerticalAxisGroup.default-staff-staff-spacing =
2425 #'((basic-distance . 3.5)
2427 } { \clef bass g2 r | }
2428 \new Staff { \clef bass g2 r | }
2433 Fichiers d'initialisation :
2434 @file{scm/define-grobs.scm}.
2437 @rlsrnamed{Spacing,Espacements}.
2439 Référence des propriétés internes :
2440 @rinternals{VerticalAxisGroup}.
2443 @node Espacement de portées regroupées
2444 @unnumberedsubsubsec Espacement de portées regroupées
2445 @translationof Spacing of grouped staves
2447 Dans les partitions orchestrales ou de grande ampleur, il arrive
2448 souvent que des portées soient regroupées. L'espacement est alors plus
2449 important entre deux regroupements qu'entre les portées d'un même
2452 Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
2453 @code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
2454 une ou plusieurs portées.
2456 L'espacement entre les portées d'un même regroupement est géré par les
2457 propriétés suivantes :
2460 @item Propriétés du @code{VerticalAxisGroup} :
2462 @item @code{staff-staff-spacing}
2464 @item Propriétés du @code{StaffGrouper} :
2466 @item @code{staff-staff-spacing}
2467 @item @code{staffgroup-staff-spacing}
2471 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2472 @ref{Propriétés d'espacement au sein d'un système}.
2474 L'exemple suivant illustre la manière de gérer l'espacement de portées
2475 regroupées, à l'aide des propriétés de l'objet graphique
2476 @code{StaffGrouper} :
2478 @lilypond[verbatim,quote,staffsize=16]
2482 \override StaffGrouper.staff-staff-spacing.padding = #0
2483 \override StaffGrouper.staff-staff-spacing.basic-distance = #1
2488 \new PianoStaff \with {
2489 \override StaffGrouper.staffgroup-staff-spacing.basic-distance = #20
2504 Fichiers d'initialisation :
2505 @file{scm/define-grobs.scm}.
2508 @rlsrnamed{Spacing,Espacements}.
2510 Référence des propriétés internes:
2511 @rinternals{VerticalAxisGroup},
2512 @rinternals{StaffGrouper}.
2515 @node Espacement des lignes rattachées à des portées
2516 @unnumberedsubsubsec Espacement des lignes rattachées à des portées
2517 @translationof Spacing of non-staff lines
2519 Les @i{lignes de non-portée}, comme les @code{Lyrics} ou les
2520 @code{ChordNames} sont des contextes dont les objets de rendu sont
2521 gravés à l'instar des portées -- une ligne horizontale dans un système.
2522 En fait, les lignes de non-portée sont des contextes qui vont créer un
2523 objet de rendu @code{VerticalAxisGroup} auxquel est attaché le
2524 @rinternals{Axis_group_engraver}.
2526 L'espacement des lignes de non-portée est géré par les propriétés
2530 @item Propriétés du @code{VerticalAxisGroup} :
2532 @item @code{staff-affinity}
2533 @item @code{nonstaff-relatedstaff-spacing}
2534 @item @code{nonstaff-nonstaff-spacing}
2535 @item @code{nonstaff-unrelatedstaff-spacing}
2539 Ces propriétés d'objet graphique sont expliquées une à une au chapitre
2540 @ref{Propriétés d'espacement au sein d'un système}.
2542 L'exemple suivant utilise la propriété @code{nonstaff-nonstaff-spacing}
2543 pour gérer l'espacement entre des lignes consécutives de non-portée.
2544 Vous noterez que la valeur élevée attribuée à la clé
2545 @code{stretchability} permet aux paroles de s'étirer plus que de raison.
2547 @lilypond[verbatim,quote,staffsize=16]
2551 \override VerticalAxisGroup.nonstaff-nonstaff-spacing.stretchability = #1000
2558 \override VerticalAxisGroup.staff-staff-spacing = #'((basic-distance . 30))
2561 \override VerticalAxisGroup.staff-affinity = #UP
2564 \override VerticalAxisGroup.staff-affinity = #CENTER
2565 } \lyricmode { center }
2567 \override VerticalAxisGroup.staff-affinity = #DOWN
2568 } \lyricmode { down }
2574 Fichiers d'initialisation :
2575 @file{ly/engraver-init.ly},
2576 @file{scm/define-grobs.scm}.
2579 @rlsrnamed{Spacing,Espacements}.
2581 @c @lsr{spacing,page-spacing.ly},
2582 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2584 Référence des propriétés internes :
2585 @rinternals{Contexts},
2586 @rinternals{VerticalAxisGroup}.
2589 @node Positionnement explicite des portées et systèmes
2590 @subsection Positionnement explicite des portées et systèmes
2591 @translationof Explicit staff and system positioning
2593 Pour bien comprendre comment fonctionnent les réglages de
2594 @code{VerticalAxisGroup} et de @code{\paper} abordés dans les deux
2595 rubriques précédentes, rien ne vaut une collection d'exemples illustrant
2596 les différentes mises au point du décalage vertical appliqué aux portées
2597 et systèmes distribués sur une page.
2599 Une autre approche de l'espacement vertical est le recours à
2600 @code{NonMusicalPaperColumn.line-break-system-details}. Alors que
2601 @code{VerticalAxisGroup} et @code{\paper} gèrent un décalage vertical,
2602 @code{NonMusicalPaperColumn.line-break-system-details} spécifiera le
2603 positionnement vertical absolu sur la page.
2605 @code{NonMusicalPaperColumn.line-break-system-details} prend en charge
2606 une liste associative de trois mises au point :
2609 @item @code{X-offset}
2610 @item @code{Y-offset}
2611 @item @code{alignment-distances}
2614 Les dérogations en matière d'objet graphique, y compris celles
2615 concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
2616 à trois différents endroits de votre fichier source :
2619 @item directement au beau milieu des notes
2620 @item au sein d'un bloc @code{\context}
2621 @item dans un bloc @code{\with}
2624 Le réglage de @code{NonMusicalPaperColumn} s'effectue à l'aide d'une
2625 simple commande @code{\override} au sein d'un bloc @code{\context} ou
2626 @code{\with}. Dans le cas où il est stipulé au fil des notes, c'est la
2627 commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
2628 quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
2629 de la commande @code{\overrideProperty} :
2632 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2635 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2638 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2642 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2643 #'((alignment-distances . (15)))
2645 \overrideProperty NonMusicalPaperColumn.line-break-system-details
2648 (alignment-distances . (15)))
2651 Nous allons maintenant voir ces différents réglages en action.
2652 Commençons par examiner un exemple dépourvu de toute mise au point.
2654 @c \book { } is required in these examples to ensure the spacing
2655 @c overrides can be seen between systems. -np
2657 @lilypond[verbatim,quote,staffsize=16]
2658 \header { tagline = ##f }
2659 \paper { left-margin = 0\mm }
2669 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2672 \repeat unfold 15 { d'4 d' d' d' }
2679 Cette partition isole les informations de saut de ligne ou de page dans
2680 une voix spécifique. La mise en forme est ainsi séparée des événements
2681 musicaux ; ceci nous permettra d'y voir plus clair au fur et à
2682 mesure que nous avancerons. Pour plus de précisions, relisez
2685 Les @code{\break} explicites répartissent la musique en lignes de cinq
2686 mesures chacune. L'espacement vertical est celui que LilyPond attribue
2687 par défaut. Nous pouvons, afin de fixer explicitement le point
2688 d'attache vertical de chacun des systèmes, définir un doublet
2689 @code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
2690 de l'objet @code{NonMusicalPaperColumn} :
2692 @lilypond[verbatim,quote,staffsize=16]
2693 \header { tagline = ##f }
2694 \paper { left-margin = 0\mm }
2700 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2703 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2706 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2710 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2713 \repeat unfold 15 { d'4 d' d' d' }
2720 Vous aurez remarqué que nous n'avons déterminé qu'une seule valeur, même
2721 si la liste associative de @code{line-break-system-details} peut en
2722 comporter un certain nombre. Vous aurez aussi noté que la propriété
2723 @code{Y-offset} détermine ici le point de départ de chacun des systèmes
2726 Maintenant que chaque système est explicitement positionné, nous pouvons
2727 jouer sur la distance séparant les portées de chacun des systèmes, grâce
2728 à la sous-propriété @code{alignment-distances} de
2729 @code{line-break-system-details}.
2731 @lilypond[verbatim,quote,staffsize=16]
2732 \header { tagline = ##f }
2733 \paper { left-margin = 0\mm }
2739 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2741 (alignment-distances . (10)))
2743 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2745 (alignment-distances . (15)))
2747 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2749 (alignment-distances . (20)))
2752 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2755 \repeat unfold 15 { d'4 d' d' d' }
2762 Nous avons maintenant assigné deux valeurs différentes à l'attribut
2763 @code{line-break-system-details} de l'objet
2764 @code{NonMusicalPaperColumn}. @code{line-break-system-details} pourrait
2765 prendre bien d'autres paramètres d'espacement, y compris un doublet
2766 @code{X-offset}, mais nous n'avons utilisé que @code{Y-offset} et
2767 @code{alignment-distances} pour contrôler le positionnement de chaque
2768 système et de chaque portée. Vous noterez enfin que
2769 @code{alignment-distances} traite le positionnement des portées, non
2770 d'un regroupement de portées.
2772 @lilypond[verbatim,quote,staffsize=16]
2773 \header { tagline = ##f }
2774 \paper { left-margin = 0\mm }
2780 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2782 (alignment-distances . (30 10)))
2784 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2786 (alignment-distances . (10 10)))
2788 \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details
2790 (alignment-distances . (10 30)))
2793 \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2796 \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2797 \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2804 Quelques points à prendre en considération :
2808 Lorsque vous utilisez @code{alignment-distances}, les paroles et
2809 autres lignes de non-portée ne comptent pas pour une portée.
2812 Les nombres fournis à @code{X-offset}, @code{Y-offset} et
2813 @code{alignment-distances} sont considérés comme des multiples de la
2814 distance entre des portées adjacentes. Des valeurs positives remontent
2815 les portées et paroles, des valeurs négatives les descendent.
2818 Dans la mesure où @code{NonMusicalPaperColumn.line-break-system-details}
2819 permet de positionner systèmes et portées n'importe où sur une page,
2820 vous pourriez être en contradiction avec les dimensionnements de la
2821 feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
2822 quant aux différentes valeurs que vous affectez à ces réglages.
2828 @rlsrnamed{Spacing,Espacements}.
2831 @node Résolution des collisions verticales
2832 @subsection Résolution des collisions verticales
2833 @translationof Vertical collision avoidance
2835 @funindex outside-staff-priority
2836 @funindex outside-staff-padding
2837 @funindex outside-staff-horizontal-padding
2839 Vous savez de manière intuitive qu'un certain nombre d'objets en
2840 matière de notation musicale appartiennent à la portée, et que
2841 d'autres se placent en dehors de la portée. Entre autres objets
2842 externes, nous avons les marques repères, les textes et les
2843 nuances ; nous les appellerons « objets extérieurs à la portée ».
2844 La règle adoptée par LilyPond pour positionner verticalement ces
2845 objets extérieurs consiste à les placer au plus près de la portée
2846 tout en prenant garde d'éviter qu'il y ait chevauchement.
2848 LilyPond utilise la propriété @code{outside-staff-priority} afin de
2849 déterminer si un objet est ou non un objet extérieur à la portée :
2850 lorsque la valeur de @code{outside-staff-priority} est numérique, il
2851 s'agit d'un objet extérieur à la portée. De plus, la propriété
2852 @code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
2853 objets doivent être disposés.
2855 Tout d'abord, LilyPond dispose tous les objets qui ne sont pas externes.
2856 Les objets extérieurs à la portée sont alors triés selon l'ordre
2857 croissant de leur @code{outside-staff-priority}. Enfin, LilyPond prend
2858 chacun des ces objets et les positionne de telle sorte qu'il n'entrent
2859 pas en collision avec ceux qui on déjà été placés. Autrement dit,
2860 lorsque deux objets devraient se placer au même endroit, celui dont la
2861 @code{outside-staff-priority} est la plus faible sera disposé au plus
2864 Une liste des @code{outside-staff-priorities} est disponible à la
2865 rubrique @rlearning{La propriété outside-staff-priority}.
2867 @lilypond[quote,ragged-right,verbatim]
2871 \once \override TextScript.outside-staff-priority = #1
2872 c4_"Text"\pp % this time the text will be closer to the staff
2874 % by setting outside-staff-priority to a non-number,
2875 % we disable the automatic collision avoidance
2876 \once \override TextScript.outside-staff-priority = ##f
2877 \once \override DynamicLineSpanner.outside-staff-priority = ##f
2878 c4_"Text"\pp % now they will collide
2882 Le décalage vertical entre des objets extérieurs à la portée se contrôle
2883 par la propriété @code{outside-staff-padding}.
2886 @lilypond[quote,ragged-right,verbatim,staffsize=18]
2888 \once \override TextScript.outside-staff-padding = #0
2889 a'4-"outside-staff-padding = #0"
2890 \once \override TextScript.outside-staff-padding = #3
2891 d-"outside-staff-padding = #3"
2892 c-"outside-staff-padding par défaut"
2893 b-"outside-staff-padding par défaut"
2898 Par défaut, les objets extérieurs à la portée sont positionnés en
2899 évitant les collisions horizontales avec des objets précédemment
2900 positionnés. Ceci peut cependant générer des situations où des objets
2901 se trouvent horizontalement trop proches. Comme l'illustre l'exemple
2902 suivant, la propriété @code{outside-staff-horizontal-padding} permet
2903 d'accroître l'espace horizontal requis et repoussera verticalement un
2904 objet pour éviter qu'il ne soit trop proche d'ventuelles lignes
2907 @lilypond[quote,ragged-right,verbatim]
2911 \once \override TextScript.outside-staff-horizontal-padding = #1
2918 @rlsrnamed{Spacing,Espacements}.
2921 @node Espacement horizontal
2922 @section Espacement horizontal
2923 @translationof Horizontal spacing
2925 @cindex horizontal, espacement
2926 @cindex espacement horizontal
2929 * Généralités sur l'espacement horizontal::
2930 * Changement d'espacement en cours de partition::
2931 * Modification de l'espacement horizontal::
2932 * Largeur de ligne::
2933 * Notation proportionnelle::
2937 @node Généralités sur l'espacement horizontal
2938 @subsection Généralités sur l'espacement horizontal
2939 @translationof Horizontal spacing overview
2941 Le moteur d'espacement traduit les différences de durée en distances
2942 étirables (@emph{springs} pour ressorts) de différentes longueurs. Des
2943 durées importantes prennent ainsi plus de place que des durées moins
2944 longues. Les durées les plus courtes se verront attribuer un espace
2945 fixe, contrôlé par la propriété @code{shortest-duration-space} de
2946 l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
2947 plus elle prendra d'espace : le doublement d'une durée attribuera à
2948 la note un espace fixé d'après la propriété @code{spacing-increment}.
2950 L'exemple suivant comporte des blanches, des noires et un certain nombre
2951 de croches. La croche est suivie d'un espace de la largeur d'une tête
2952 de note ; pour la noire , cet espace est de deux têtes ; il
2953 est de trois pour la blanche.
2955 @lilypond[quote,verbatim]
2963 @code{spacing-increment} est normalement défini à 1,2 espace de
2964 portée -- ce qui correspond à peu près à la largeur d'une tête de note
2965 -- et @code{shortest-duration-space} à 2,0. La note la plus courte
2966 s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
2967 @code{spacing-increment}). Le point de départ de cet espace se situe à
2968 l'extrémité gauche du symbole ; la note la plus courte est donc
2969 suivie en général d'un espace égal à la largeur d'une tête de note.
2971 Si l'on suit à la lettre ce qui précède, ajouter une simple triple
2972 croche à une partition qui comporte déjà des croches et des doubles
2973 augmentera considérablement son volume : la durée la plus
2974 courte n'est plus la double mais la triple croche, ce qui aura
2975 pour conséquence d'ajouter une largeur de tête à chacune des notes.
2976 Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
2977 courte prise en considération au niveau de l'espacement n'est pas la
2978 note la plus brève de la partition, mais celle qui apparaît le plus
2981 La courte durée la plus fréquente est déterminée à partir de la note la
2982 plus courte de chaque mesure. C'est elle qui servira de base pour
2983 l'espacement, à cette nuance près que la plus courte durée ne saurait
2984 être strictement supérieure à la croche.
2986 Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
2987 pour les espacements grâce à la propriété
2988 @code{common-shortest-duration} de l'objet @rinternals{SpacingSpanner}.
2989 La durée maximale de cet étalon, normalement la croche, est gérée par la
2990 propriété @code{base-shortest-duration}.
2992 @funindex common-shortest-duration
2993 @funindex base-shortest-duration
2994 @funindex stem-spacing-correction
2997 Les notes plus courtes que la note témoin sont suivies d'un espace
2998 proportionnel à la durée témoin. Si donc nous ajoutions quelques
2999 doubles croches à l'exemple précédent, elles seraient suivies d'une
3000 demie largeur de tête :
3002 @lilypond[quote,verbatim]
3003 \relative { c''2 c4. c8 | c4. c16[ c] c4. c8 | c8 c c4 c c }
3006 Comme le met en évidence notre @emph{Essai sur la gravure musicale
3007 automatisée}, la direction des hampes peut influencer l'espacement -- voir
3008 @ressay{Espacement} et s'ajuster à l'aide de la propriété
3009 @code{stem-spacing-correction} de l'objet @rinternals{NoteSpacing} créé
3010 pour chaque contexte @rinternals{Voice}.
3012 L'objet @code{StaffSpacing}, généré au niveau d'un contexte
3013 @rinternals{Staff}, possède une même propriété qui contrôlera
3014 l'espacement hampe-barre de mesure.
3016 L'exemple suivant montre ces adaptations, tout d'abord selon les
3017 réglages par défaut, puis avec des corrections forcées.
3019 @lilypond[quote,ragged-right]
3023 \override Staff.NoteSpacing.stem-spacing-correction = #1.5
3024 \override Staff.StaffSpacing.stem-spacing-correction = #1.5
3030 L'espacement spécifique à la notation proportionnelle fait l'objet d'une
3031 @rusernamed{Notation proportionnelle,rubrique dédiée}.
3034 Essai sur la gravure musicale automatisée :
3035 @ressay{Espacement}.
3038 @rlsrnamed{Spacing,Espacements}.
3040 Référence des propriétés internes :
3041 @rinternals{SpacingSpanner},
3042 @rinternals{NoteSpacing},
3043 @rinternals{StaffSpacing},
3044 @rinternals{NonMusicalPaperColumn}.
3047 Il n'existe pas de mécanisme simple et efficace qui permette de
3048 forcer manuellement l'espacement. La solution ci-dessous permet
3049 cependant « d'aérer » artificiellement une partition ; il vous
3050 suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
3054 \override Score.NonMusicalPaperColumn.padding = #10
3057 Il n'y a aucun moyen de diminuer l'espacement.
3060 @node Changement d'espacement en cours de partition
3061 @subsection Changement d'espacement en cours de partition
3062 @translationof New spacing section
3064 @cindex espacement, modification en cours de partition
3065 @cindex notes, espacement horizontal
3066 @funindex \newSpacingSection
3068 Il arrive, au cours d'un même mouvement, qu'une nouvelle partie modifie
3069 substantiellement la notion de valeur brève et valeur longue. La
3070 commande @code{newSpacingSection} permet alors de réinitialiser les
3071 paramètres d'espacement.
3073 Dans l'exemple qui suit, le changement de métrique marque le début
3074 d'une nouvelle partie ; remarquez comme les doubles-croches sont
3075 alors automatiquent un peu plus espacées :
3077 @lilypond[relative,verbatim,quote]
3080 c8 c c4 c16[ c c8] c4
3086 La commande @code{\newSpacingSection} crée un nouvel objet
3087 @code{SpacingSpanner} à cet instant musical. Si toutefois les
3088 ajustements apportés à l'espacement automatique ne se révélent pas
3089 satisfaisants, ils peuvent s'adapter à l'aide d'@code{\override}s. Ces
3090 amendements doivent intervenir au même moment que la commande
3091 @code{\newSpacingSection} ; ils produiront leurs effets jusqu'à ce
3092 qu'ils soient à nouveau modifiés par une nouvelle section, comme ici :
3094 @lilypond[verbatim,quote]
3099 \override Score.SpacingSpanner.spacing-increment = #2
3102 \revert Score.SpacingSpanner.spacing-increment
3109 @rlsrnamed{Spacing,Espacements}.
3111 Référence des propriétés internes :
3112 @rinternals{SpacingSpanner}.
3115 @node Modification de l'espacement horizontal
3116 @subsection Modification de l'espacement horizontal
3117 @translationof Changing horizontal spacing
3119 Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
3120 @code{base-shortest-duration}. Comparons les deux partitions qui
3121 suivent, toutes deux montrant la même musique. La première partition
3122 applique les réglages par défaut, alors que la seconde bénéficie d'un
3123 ajustement de la propriété @code{base-shortest-duration}. Au plus la
3124 valeur de @code{ly:make-moment} est grande, au plus la musique sera
3125 resserrée. En effet, @code{ly:make-moment} construit une durée :
3126 @code{1 4} est plus long que @code{1 16}.
3128 @lilypond[verbatim,line-width=12\cm]
3131 g'4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3132 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3133 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3134 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3139 @lilypond[verbatim,line-width=12\cm]
3142 g'4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
3143 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3144 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
3145 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
3150 \override SpacingSpanner.base-shortest-duration = #(ly:make-moment 1/16)
3157 L'espacement au sein d'un n-olet dépend par défaut d'un certain nombre de
3158 facteurs qui ne sont pas liés à la durée (altération, changement de
3159 clef, etc.). @code{Score.SpacingSpanner.uniform-stretching}
3160 permet d'ignorer ces symboles et, par voie de conséquence, de forcer
3161 l'espacement sur la simple durée. Notez bien que cette propriété
3162 s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
3165 @lilypond[quote,ragged-right,verbatim]
3169 \tuplet 5/4 { c8 c8 c8 c8 c8 } c8 c8 c8 c8
3172 c8 c8 c8 c8 \tuplet 5/4 { c8 c8 c8 c8 c8 }
3178 \override SpacingSpanner.uniform-stretching = ##t
3184 L'activation du commutateur @code{strict-note-spacing} permet d'espacer
3185 les notes sans tenir compte des clefs, barres de mesure ou notes
3186 d'ornement qui pourraient apparaître :
3188 @lilypond[quote,ragged-right,fragment,verbatim]
3189 \override Score.SpacingSpanner.strict-note-spacing = ##t
3190 \new Staff \relative {
3191 c''8[ c \clef alto c \grace { c16 c } c8 c c] c32[ c] }
3196 @rlsrnamed{Spacing,Espacements}.
3199 @node Largeur de ligne
3200 @subsection Largeur de ligne
3201 @translationof Line width
3203 @cindex saut de page
3205 @cindex ligne, longueur
3208 @funindex line-width
3209 @funindex ragged-right
3210 @funindex ragged-last
3212 @c Although line-width can be set in \layout, it should be set in paper
3213 @c block, to get page layout right.
3214 @c Setting indent in \paper block makes not much sense, but it works.
3216 @c Bit verbose and vague, use examples?
3217 Deux réglages de base ont une influence considérable sur
3218 l'espacement : @code{line-width} et @code{indent}. Tous deux se
3219 placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
3220 lignes et l'indentation de la première.
3222 L'activation du commutateur @code{ragged-right} au sein du bloc
3223 @code{\layout} permet de terminer les systèmes naturellement plutôt que
3224 de les voir s'étirer sur toute la largeur de la page. Cette option est
3225 particulièrement utile lorsque vous traitez de courts fragments, ou bien
3226 pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
3227 désactivé par défaut, il sera activé si la partition ne comporte qu'un
3230 @cindex page, mise en forme
3231 @cindex vertical, espacement
3233 Le fonctionnement de l'option @code{ragged-last} est en tout point
3234 identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
3235 que la dernière ligne de la partition. Il n'y a pas de restriction
3236 quant à cette ligne. Il en va de même que pour le formatage d'un
3237 paragraphe de texte, la dernière ligne s'arrête au dernier caractère.
3239 @c Note that for text there are several options for the last line.
3240 @c While Knuth TeX uses natural length, lead typesetters use the same
3241 @c stretch as the previous line. eTeX uses \lastlinefit to
3242 @c interpolate between both these solutions.
3254 @rlsrnamed{Spacing,Espacements}.
3257 @node Notation proportionnelle
3258 @subsection Notation proportionnelle
3259 @translationof Proportional notation
3261 LilyPond prend en charge la notation proportionnelle. Il s'agit dans
3262 ce cas de représenter la notation selon un espacement strictement
3263 relatif aux durées. Ce type d'espacement pourrait se comparer à
3264 l'utilisation de papier millimétré pour positionner les notes au fil de
3265 la portée. Certaines œuvres de la fin du XXe siècle et à l'aube du XXIe
3266 utilisent cette proportionnalité dans le but de clarifier des structures
3267 rythmiques complexes, d'aider au positionnement d'indications
3268 temporelles ou autres éléments graphiques directement dans la partition.
3270 LilyPond met à votre disposition cinq réglages différents, qui peuvent
3271 s'utiliser conjointement ou individuellement, aux fins de mettre au
3272 point cette notation proportionnelle.
3275 @item @code{proportionalNotationDuration}
3277 @item @code{uniform-stretching}
3279 @item @code{strict-note-spacing}
3281 @item @code{\remove "Separating_line_group_engraver"}
3283 @item @code{\override PaperColumn.used = ##t}
3287 Nous allons examiner, dans les différents exemples qui suivent, les
3288 effets de ces réglages et comment ils interagissent.
3290 Commençons par cette mesure toute simple qui utilise l'espacement
3291 classique et justifiée à gauche.
3293 @c The initial pitch is not necessary as long as RhythmicStaff is
3294 @c not preceded by other material in the score, but we don't want
3296 @lilypond[quote,verbatim,ragged-right]
3299 \new RhythmicStaff {
3300 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3306 Vous constatez que la blanche qui entame la mesure prend moins de la
3307 moitié de l'espace. De même, les doubles croches et le quintolet de
3308 doubles (donc des vingtièmes de ronde) qui terminent cette mesure
3309 n'en occupent pas la moitié de l'espace horizontal.
3311 En matière de gravure traditionnelle, cet espacement correspond tout à
3312 fait à nos attentes, puisque nous pouvons rogner de l'espace sur la
3313 blanche et ainsi gagner en largeur sur toute la mesure qui fait une
3316 Par contre, si nous avons besoin d'insérer une indication temporelle ou
3317 un autre graphisme en surplomb ou en dessous de notre partition, nous
3318 aurons besoin de la notation proportionnelle. Celle-ci s'active en
3319 définissant la propriété @code{proportionalNotationDuration}.
3321 @lilypond[quote,verbatim,ragged-right]
3324 \new RhythmicStaff {
3325 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3331 proportionalNotationDuration = #(ly:make-moment 1/20)
3337 La blanche du début et les notes plus rapides de la deuxième moitié de
3338 la mesure occupent maintenant exactement le même espace horizontal.
3339 Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
3340 temporelle ou autre graphisme.
3342 @code{proportionalNotationDuration} est une propriété attachée au
3343 contexte @code{Score}. Rappelez-vous que vous pouvez régler les
3344 propriétés d'un contexte à trois différents endroits de votre
3345 fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
3346 ou au beau milieu de la musique à l'aide de la commande @code{\set}.
3347 Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
3348 de ces trois façons, à l'instar de n'importe quelle définition de
3351 La propriété @code{proportionalNotationDuration} prend en unique
3352 argument la durée de référence qui servira de base pour espacer toute la
3353 musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
3354 prend deux arguments : un numérateur et un dénominateur qui
3355 représentent une fraction de ronde. L'appel de
3356 @w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
3357 égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
3358 @code{(ly:make-moment 1/16)}, @code{(ly:make-moment 1/8)} ou
3359 @code{(ly:make-moment 3/97)}.
3361 Se pose alors le problème de fournir la juste durée de référence à
3362 @code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
3363 tâtonnement, en commençant par une valeur proche de la note la plus
3364 rapide (la durée la plus courte) du morceau. Au plus la durée de
3365 référence est petite, au plus la musique sera étalée ; à l'inverse,
3366 une durée de référence élevée produira une musique resserrée.
3368 @lilypond[quote,verbatim,ragged-right]
3371 \new RhythmicStaff {
3372 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3378 proportionalNotationDuration = #(ly:make-moment 1/8)
3385 \new RhythmicStaff {
3386 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3392 proportionalNotationDuration = #(ly:make-moment 1/16)
3399 \new RhythmicStaff {
3400 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3406 proportionalNotationDuration = #(ly:make-moment 1/32)
3412 Vous ne manquerez pas de noter qu'une durée de référence trop grande,
3413 comme la croche pour la première ligne, a pour conséquence de resserrer
3414 la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
3415 remarquez aussi que, par principe, la notation proportionnelle occupe
3416 beaucoup plus d'espace horizontal que l'espacement traditionnel. La
3417 notation proportionnelle met en évidence le rythme au détriment de
3418 l'espacement horizontal.
3420 Examinons à présent le moyen d'optimiser l'espacement de n-olets en
3423 Reprenons notre exemple de départ, avec son espacement traditionnel, et
3424 ajoutons lui une portée incluant un autre type de n-olet.
3426 @lilypond[quote,verbatim,ragged-right]
3429 \new RhythmicStaff {
3430 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3432 \new RhythmicStaff {
3433 \tuplet 9/8 { c8 8 8 8 8 8 8 8 8 }
3439 L'espacement est loin d'être idéal, pour la simple raison que
3440 l'espacement régulier des notes de la portée inférieure ne s'étire pas
3441 uniformément. Il est vrai que de telles constructions complexes en
3442 n-olets sont assez rares en gravure traditionnelle, ce qui explique que
3443 les règles qu'elle applique peuvent amener à ce résultat. Le recours à
3444 @code{proportionalNotationDuration} permet d'arranger les choses.
3446 @lilypond[quote,verbatim,ragged-right]
3449 \new RhythmicStaff {
3450 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3452 \new RhythmicStaff {
3453 \tuplet 9/8 { c8 8 8 8 8 8 8 8 8 }
3459 proportionalNotationDuration = #(ly:make-moment 1/20)
3465 Cependant, si l'on observe de près, il est évident que les notes de la
3466 deuxième moitié du ennaolet ont tendance à s'espacer légèrement plus que
3467 celles de la première moitié. Afin d'uniformiser cet étalement, nous
3468 allons activer le @code{uniform-stretching}, propriété attachée au
3469 @code{SpacingSpanner}.
3471 @lilypond[quote,verbatim,ragged-right]
3474 \new RhythmicStaff {
3475 c2 16 16 16 16 \tuplet 5/4 { 16 16 16 16 16 }
3477 \new RhythmicStaff {
3478 \tuplet 9/8 { c8 8 8 8 8 8 8 8 8 }
3484 proportionalNotationDuration = #(ly:make-moment 1/20)
3485 \override SpacingSpanner.uniform-stretching = ##t
3491 L'espacement sur les deux portées est maintenant correct, les relations
3492 rythmiques sont clairement perceptibles, et nous pourrions y insérer
3493 une indication temporelle ou autre graphisme selon notre envie.
3495 Notez bien que la prise en charge de la notation proportionnelle par
3496 LilyPond demande que, dans chaque partition, soit activée la propriété
3497 @code{uniform-stretching} du @code{SpacingSpanner}. Dans le cas
3498 contraire, utiliser @code{proportionalNotationDuration} aura pour
3499 conséquence, entre autres, un espacement erroné lorsque vous y aurez
3500 inséré des silences invisibles @emph{skip}.
3502 Le @code{SpacingSpanner} est en fait un objet graphique abstrait attaché
3503 au contexte @code{Score}. Tout comme pour la propriété
3504 @code{proportionalNotationDuration}, les réglages du
3505 @code{SpacingSpanner} peuvent se faire à trois différents endroits de
3506 votre fichier : dans un bloc @code{\with}, dans un bloc
3507 @code{\context} ou au beau milieu de la musique à l'aide de la
3508 commande @code{\set}.
3510 Gardez bien à l'esprit qu'il n'y a qu'un seul @code{SpacingSpanner} par
3511 @code{Score}. Il s'ensuit que @code{uniform-stretching} est soit
3512 activé, soit désactivé, et dans tous les cas pour l'intégralité de la
3513 partition. Vous pourriez toutefois avoir besoin de modifier ce
3514 comportement en cours de partition, et recourir alors à l'instruction
3515 @code{\newSpacingSection} -- pour de plus amples détails, voir la
3516 rubrique @ref{Changement d'espacement en cours de partition}.
3518 Intéressons-nous maintenant au @code{Separating_line_group_engraver},
3519 qui est désactivé pour la plupart des partitions en notation
3520 proportionnelle. Voici ce qui apparaît dans une partition
3521 traditionnelle : il y a toujours un « espace préservé » juste
3522 avant la première note de chaque portée.
3524 @lilypond[quote,verbatim,ragged-right]
3536 Cet espace, géré par le @code{Separating_line_group_engraver}, est aussi
3537 présent lorsqu'intervient un changement de métrique, d'armure ou de
3538 clef. Désactiver le @code{Separating_line_group_engraver} revient à
3539 réduire cet espace à zéro.
3541 @lilypond[quote,verbatim,ragged-right]
3547 \remove "Separating_line_group_engraver"
3555 Les éléments non musicaux tels que métrique, armure, clef et
3556 altérations, posent problème lorsqu'on travaille en notation
3557 proportionnelle. Bien qu'aucune notion de durée ne leur soit
3558 attachée, ces éléments « consomment » de l'espace. Différentes
3559 approches permettent cependant de gérer ce problème.
3561 Éviter les problèmes d'espacement avec l'armure est chose aisée :
3562 il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
3563 musique contemporaine, où l'on trouve le plus d'ouvrages en notation
3564 proportionnelle. Il en va de même pour la métrique, et tout
3565 particulièrement lorsque la partition comporte un quadrillage temporel
3566 ou autres graphismes. L'absence de métrique reste cependant
3567 exceptionnelle et la plupart des partitions en notation proportionnelle
3568 laissent apparaître quelques métriques. Il est par contre pratiquement
3569 impossible de se passer de clef et d'altération.
3571 L'une des options permettant de s'affranchir de l'espacement dû aux
3572 éléments non musicaux consiste en l'activation de la propriété
3573 @code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
3574 les deux portées suivantes :
3576 @lilypond[quote,verbatim,ragged-right]
3578 \set Score.proportionalNotationDuration = #(ly:make-moment 1/16)
3579 c''8 8 8 \clef alto d' 2
3583 \set Score.proportionalNotationDuration = #(ly:make-moment 1/16)
3584 \override Score.SpacingSpanner.strict-note-spacing = ##t
3585 c''8 8 8 \clef alto d' 2
3589 Toutes deux affichent un espacement proportionnel. Cependant, la
3590 première ligne laisse apparaître un espacement plus lâche en raison de
3591 la présence d'un changement de clef. En ce qui concerne la deuxième
3592 ligne, l'espacement est strictement observé dès lors que la propriété
3593 @code{strict-note-spacing} a préalablement été activée. Comme vous
3594 pouvez le constater, l'activation de @code{strict-note-spacing} a pour
3595 conséquence que l'algorithme d'espacement ignore tout bonnement la
3596 largeur des métriques, armures, clefs et altérations.
3598 En plus de ceux que nous venons de voir, vous trouverez d'autres
3599 réglages en usage dans la notation proportionnelle comme, entre autres,
3602 @item @code{\override SpacingSpanner.strict-grace-spacing = ##t}
3603 @item @code{\set tupletFullLength = ##t}
3604 @item @code{\override Beam.breakable = ##t}
3605 @item @code{\override Glissando.breakable = ##t}
3606 @item @code{\override TextSpanner.breakable = ##t}
3607 @item @code{\remove "Forbid_line_break_engraver"} (dans un contexte de voix)
3610 Ces différents réglages permettent un espacement strict des notes
3611 d'ornement, d'étendre les indications de n-olet afin d'indiquer de façon
3612 évidente leurs bornes et d'autoriser le tronçonnement des extenseurs à
3613 l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
3614 différentes rubriques associées du manuel pour chacun de ces réglages.
3617 Manuel de notation :
3618 @ref{Changement d'espacement en cours de partition}.
3621 @rlsrnamed{Spacing,Espacements}.
3624 @node Réduction du nombre de pages de la partition
3625 @section Réduction du nombre de pages de la partition
3626 @translationof Fitting music onto fewer pages
3628 Vous pourriez un jour être confronté au problème suivant : l'une
3629 des pages de votre partition ne comporte que deux portées alors que,
3630 ce qui est d'autant plus frustrant, l'espace libre sur les autres
3631 pages aurait permis une distribution différente.
3633 L'instruction @code{annotate-spacing} se révèle être un outil
3634 indispensable pour l'analyse des problèmes de mise en forme. Cette
3635 commande met en surimpression la valeur des différentes variables
3636 d'espacement et de mise en forme, comme nous allons le voir dans la
3637 rubrique @ref{Mise en évidence de l'espacement}.
3640 * Mise en évidence de l'espacement::
3641 * Modification de l'espacement::
3645 @node Mise en évidence de l'espacement
3646 @subsection Mise en évidence de l'espacement
3647 @translationof Displaying spacing
3649 @cindex espacement, affichage des valeurs
3650 @funindex annotate-spacing
3652 Le meilleur moyen d'appréhender les différentes variables de
3653 dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
3654 la mise en page consiste à activer, au sein du bloc @code{\paper}, la
3655 fonction @code{annotate-spacing} :
3657 @lilypond[verbatim,quote,papersize=a6landscape]
3660 \paper { annotate-spacing = ##t }
3665 Toutes les dimensions sont exprimées en espace de portée
3666 @emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
3667 @code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
3668 feuille (@code{paper-height}) est de 59,75 espaces de portée
3669 (@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
3670 20 points -- sa valeur par défaut. Notez que :
3672 @multitable {1 staff-space} {(staff-size)/4 * (25,4/72,27) mm}
3675 @tab = (25,4/72,27) mm
3678 @tab = (@code{staff-size})/4 pts
3680 @tab = (@code{staff-size})/4 * (25,4/72,27) mm
3685 Dans le cas qui nous occupe, un @code{staff-space} égale environ
3686 1,757 millimètres. Les 59,75 @code{staff-spaces} de
3687 @code{paper-height} correspondent donc à 105 millimètres, soit la
3688 hauteur d'une feuille au format A6 à l'italienne. Les paires
3689 @code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
3690 l'extrémité inférieure et @var{b} l'extrémité supérieure.
3693 Manuel de notation :
3694 @ref{Définition de la taille de portée}.
3697 @rlsrnamed{Spacing,Espacements}.
3700 @node Modification de l'espacement
3701 @subsection Modification de l'espacement
3702 @translationof Changing spacing
3704 Les informations fournies par @code{annotate-spacing} en matière de
3705 dimensionnement vertical sont incomparables. Pour plus de détails sur
3706 les manières de modifier marges et autres variables connexes, consultez
3707 la rubrique @ref{Mise en forme de la page}.
3709 En dehors des marges, vous disposez de quelques moyens supplémentaires
3710 pour gagner de l'espace :
3714 Rapprocher les systèmes le plus possible les uns des autres, de telle
3715 sorte qu'il en tienne un maximum sur une même page, tout en les espaçant
3716 suffisamment pour éviter le blanc en bas de page.
3720 system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
3721 ragged-last-bottom = ##f
3727 Forcer le nombre de systèmes par page. Ceci peut se révéler judicieux à
3728 deux titres. D'une part, le fait de définir un nombre de systèmes --
3729 même s'il est égal à la valeur par défaut -- peut aboutir à plus de
3730 systèmes par page dans la mesure où l'une des étapes d'estimation des
3731 hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
3732 systèmes par page permet d'en disposer plus sur les suivantes. Par
3733 exemple, avec un nombre par défaut de 11 systèmes par pages,
3734 l'instruction suivante le force à 10.
3743 Forcer le nombre de pages. L'instruction suivante forcera la musique à
3744 se répartir sur deux pages.
3753 Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
3754 Par exemple, un crochet d'alternative en fin de reprise consomme de
3755 l'espace. Dans le cas où il s'étend sur deux systèmes, il occupera
3756 plus d'espace que si seul le premier comportait l'indication. Autre
3757 exemple, les indications de nuance qui se « détachent » d'un système
3758 peuvent être rapprochées de la portée :
3760 @lilypond[verbatim,quote]
3763 e4 c g-\tweak X-offset #-2.7 \f c
3768 Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
3769 comme indiqué à la rubrique
3770 @ref{Modification de l'espacement horizontal}. Voici ce que donne
3771 l'espacement par défaut :
3773 @lilypond[verbatim,quote]
3786 Par contre, le fait de modifier la valeur de la propriété
3787 @code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
3788 -- bien que la noire soit la durée la plus courante, nous prenons une
3789 valeur plus longue -- donnera un effet « resserré » à la musique :
3791 @lilypond[verbatim,quote]
3803 \override SpacingSpanner.common-shortest-duration =
3804 #(ly:make-moment 1/2)
3811 La propriété @code{common-shortest-duration} ne peut être modifiée
3812 dynamiquement. Elle se place toujours dans un bloc @code{\context} et
3813 s'applique à l'intégralité de la partition.
3818 Manuel de notation :
3819 @ref{Mise en forme de la page},
3820 @ref{Modification de l'espacement horizontal}.
3823 @rlsrnamed{Spacing,Espacements}.