4.1 Pointer-cliquer
Le pointer-cliquer ajoute des liens au sein des documents pdf, pour certains événements musicaux.
| Activation du pointer-cliquer | ||
| Pointer-cliquer sélectif |
Activation du pointer-cliquer
Le pointer-cliquer (point and click) permet de se retrouver directement dans le fichier source, à la note que l’on pointe dans le visionneur de PDF. Ceci facilite grandement le repérage des erreurs à partir du fichier imprimable.
Lorsque cette fonctionnalité est active, LilyPond ajoute des hyperliens au fichier PDF. Ces liens sont transmis au navigateur internet qui se charge d’ouvrir un éditeur de texte à l’endroit même où le curseur pointe.
Afin que cette chaîne de traitement soit pleinement opérationnelle, il faut configurer votre visionneur de PDF de façon à ce qu’il suive les liens grâce au script ‘lilypond-invoke-editor’ fourni avec LilyPond.
Pour Xpdf, sous UNIX, vous devrez insérer la ligne suivante dans le fichier ‘xpdfrc’ – soit ‘/etc/xpdfrc’, soit dans votre répertoire personnel ‘.xpdfrc’.
urlCommand "lilypond-invoke-editor %s"
‘lilypond-invoke-editor’ est un petit programme assistant. Il
se charge d’appeler un éditeur pour les identifants de ressource
(URI) de type textedit, et un navigateur pour les autres.
Il teste en outre la variable d’environnement EDITOR pour les cas
suivant :
-
emacs sera alors lancée la commande
emacsclient --no-wait +line:column file
-
gvim sera alors lancée la commande
gvim --remote +:line:normcolumn file
-
nedit sera alors lancée la commande
nc -noask +line file'
La variable d’environnement LYEDITOR permet d’anticiper cette
affectation, puisqu’elle contient la commande qui permet de lancer
l’éditeur en tenant compte des valeurs respectives de %(file)s,
%(column)s et%(line)s. Par exemple,
emacsclient --no-wait +%(line)s:%(column)s %(file)s
en variable d’environnement LYEDITOR revient au lancement d’un
client emacs standard.
L’option pointer-cliquer accroît la taille des fichiers de manière significative. Afin de réduire la taille des fichiers PDF et PS, il est toujours possible de désactiver le pointer-cliquer en ajoutant
\pointAndClickOff
dans le fichier ‘.ly’. Il peut alors être activé de manière explicite grâce à
\pointAndClickOn
Le pointer-cliquer peut aussi être désactivé au moment de la compilation en ligne de commande :
lilypond -dno-point-and-click file.ly
Note : Lorsqu’un fichier LilyPond est destiné à être redistribué, pensez à désactiver le pointer-cliquer, de telle sorte que les chemins d’accès et autres informations propres à votre système ne se retrouvent pas inclus dans le fichier ‘.pdf’.
Pointer-cliquer sélectif
Pour certaines applications interactives, il est parfois préférable de limiter la fonctionnalité du pointer-cliquer à quelques éléments seulement. Par exemple, si vous avez l’intention de créer une application lançant l’audio et la vidéo à partir d’une note en particulier, il serait mal venu qu’un clic sur la note vous amène à l’altération ou une liaison qui l’affecterait.
Les événements générateurs de lien peuvent se gérer :
-
En dur dans votre fichier ‘.ly’ :
\pointAndClickTypes #'note-event \relative c' { c2\f( f) }ou
#(ly:set-option 'point-and-click 'note-event) \relative c' { c2\f( f) } -
En ligne de commande :
lilypond -dpoint-and-click=note-event example.ly
Plusieurs types d’événement peuvent être mentionnés :
-
En dur dans votre fichier ‘.ly’ :
\pointAndClickTypes #'(note-event dynamic-event) \relative c' { c2\f( f) }ou
#(ly:set-option 'point-and-click '(note-event dynamic-event)) \relative c' { c2\f( f) } -
En ligne de commande :
lilypond \ -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \ example.ly
Autres langues : English, deutsch, español, magyar, italiano, 日本語.
About automatic language selection.