4.1 Pointer-cliquer

Le pointer-cliquer ajoute des liens au sein des documents PDF, pour certains événements musicaux.


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 identifiants 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 :

Plusieurs types d’événement peuvent être mentionnés :


Autres langues : English, deutsch, español, magyar, italiano, 日本語.
About automatic language selection.

LilyPond — Utilisation des programmes