2.9 Retouches complexes (GNU LilyPond – Extension des fonctionnalités)

[ << Interfaces pour programmeurs ]	[Top][Contents][Index]	[ Interfaces LilyPond Scheme >> ]
[ < Conteneurs requalifiants ]	[ Up : Interfaces pour programmeurs ]	[ Interfaces LilyPond Scheme > ]

2.9 Retouches complexes

Certains réglages sont plus délicats que d’autres.

L’un d’entre eux est l’apparence des objets dits « extenseurs » (spanner), qui s’étendent horizontalement, tels que les liaisons. Si, en principe, un seul de ces objets est créé à la fois et peut donc être modifié de façon habituelle, lorsque ces objets doivent enjamber un changement de ligne, ils sont dupliqués au début du ou des systèmes suivants. Comme ces objets sont des clones de l’objet d’origine, ils en héritent toutes les propriétés, y compris les éventuelles commandes \override.
En d’autres termes, une commande \override affecte toujours les deux extrémités d’un objet spanner. Pour ne modifier que la partie précédant ou suivant le changement de ligne, il faut intervenir directement dans le processus de mise en page. La fonction de rappel after-line-breaking contient toute l’opération Scheme effectuée lorsque les sauts de lignes ont été déterminés, et que des objets graphiques ont été divisés sur des systèmes différents.

Dans l’exemple suivant, on définit une nouvelle opération nommée my-callback. Cette opération
- détermine si l’objet a été divisé à l’occasion d’un changement de ligne
- dans l’affirmative, recherche les différents tronçons de l’objet
- vérifie si l’objet considéré est bien la deuxième moitié d’un objet divisé
- dans l’affirmative, applique un espacement supplémentaire (extra-offset).
On ajoute cette procédure à l’objet Tie (liaison de tenue), de façon à ce que le deuxième tronçon d’une liaison divisée soit rehaussé.
```
#(define (my-callback grob)
   (let* (
          ;; l'objet a-t-il été divisé ?
          (orig (ly:grob-original grob))

          ;; si oui, rechercher les tronçons frères (siblings)
          (siblings (if (ly:grob? orig)
                        (ly:spanner-broken-into orig)
                        '())))

     (if (and (>= (length siblings) 2)
              (eq? (car (last-pair siblings)) grob))
         (ly:grob-set-property! grob 'extra-offset '(-2 . 5)))))

\relative {
  \override Tie.after-line-breaking =
  #my-callback
  c''1 ~ \break
  c2 ~ 2
}
```
Lorsque cette astuce va être appliquée, notre nouvelle fonction de rappel after-line-breaking devra également appeler celle d’origine (after-line-breaking), si elle existe. Ainsi, pour l’utiliser dans le cas d’un crescendo (objet Hairpin), il faudra également appeler ly:spanner::kill-zero-spanned-time.
Pour des raisons d’ordre technique, certains objets ne peuvent être modifiés par \override. Parmi ceux-là, les objets NonMusicalPaperColumn et PaperColumn. La commande \overrideProperty sert à les modifier, de façon similaire à \once \override, mais avec une syntaxe différente :
```
\overrideProperty
Score.NonMusicalPaperColumn      % Nom de l'objet
  . line-break-system-details    % Nom de la propriété
  . next-padding                 % Nom de la sous-propriété (optionnel)
  . #20                          % Valeur
```
Notez toutefois que la commande \override peut tout de même être appliquée à NonMusicalPaperColumn et PaperColumn dans un bloc \context.

[ << Interfaces pour programmeurs ]	[Top][Contents][Index]	[ Interfaces LilyPond Scheme >> ]
[ < Conteneurs requalifiants ]	[ Up : Interfaces pour programmeurs ]	[ Interfaces LilyPond Scheme > ]

2.9 Retouches complexes

GNU LilyPond – Extension des fonctionnalités v2.25.15 (branche de développement).