| [ << Externe Programme ] | [Anfang][Inhalt][Index] | [ Vorschläge zum Schreiben von LilyPond-Eingabe-Dateien >> ] |
| [ < Externe Programme ] | [ Nach oben : Externe Programme ] | [ Point and click aktivieren > ] |
4.1 Point and click
Poind and click fügt Verlinkung für bestimmte Notationselemente in die PDF-Dokumente ein.
| Point and click aktivieren | ||
| Selektives point-and-click |
| [ << Externe Programme ] | [Anfang][Inhalt][Index] | [ Vorschläge zum Schreiben von LilyPond-Eingabe-Dateien >> ] |
| [ < Point and click ] | [ Nach oben : Point and click ] | [ Selektives point-and-click > ] |
Point and click aktivieren
Point and click erlaubt es, die Noten in der Eingabedatei schnell zu finden, indem man auf sie im PDF-Programm klickt. Das erleichtert es, die Stellen zu finden, die Fehler in der Notation verursachen.
Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zur PDF-Datei hinzu. Diese Hyperlinks werden an den Webbrowser gesendet, der einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
Damit diese Kettenreaktion funktionieren kann, müssen Sie das PDF-Programm dazu anweisen, Hyperlinks zu folgen, indem das Skript ‘lilypond-invoke-editor’, welches mit LilyPond kommt, verwendet wird.
Für Xpdf unter UNIX sollte folgende Zeile in der Datei ‘xpdfrc’. Unter UNIX findet man diese Datei entweder in ‘/etc/xpdfrc’ oder als ‘$HOME/.xpdfrc’:
urlCommand "lilypond-invoke-editor %s"
Das Programm ‘lilypond-invoke-editor’ ist ein kleines
Hilfsprogramm. Es ruft einen Editor für besondere textedit-URIs#
auf und einen Webbrowser für andere. Es testes die Umgebungsvariable
EDITOR nach folgenden Mustern:
-
emacs das ruft auf
emacsclient --no-wait +line:column file
-
gvim das ruft auf
gvim --remote +:line:normcolumn file
-
nedit das ruft auf
nc -noask +line file'
Die Umgebungsvariable LYEDITOR wird benutzt, um dieses Verhalten
zu umgehen. Sie enthält die Kommandozeile, mit der der Editor aufgerufen
wird, wobei %(file)s, %(column)s und %(line)s mit
der Datei, Spalte und Zeile ersetzt wird. Die Einstellung
emacsclient --no-wait +%(line)s:%(column)s %(file)s
für LYEDITOR entspricht dem normalen Aufruf von emacsclient.
Die point-and-click-Links vergrößern die Größe des PDFs sehr stark. Um die Größe von PDFs und auch PS-Dateien zu verkleinern, kann point and click ausgeschaltet werden, indem man in der Eingabedatei
\pointAndClickOff
schreibt. Point and click kann explizit aktiviert werden mit dem Befehl
\pointAndClickOn
Alternativ können Sie point and click auch mit einer Kommandozeilenoption anschalten:
lilypond -dno-point-and-click file.ly
Achtung: Sie sollten immer point and click ausschalten, wenn Sie LilyPond-Dateien verteilen wollen, damit keine Informationen über Ihre Dateistrukturen in den Dateien gespeichert werden, was ein Sicherheitsrisiko darstellen könnte.
Selektives point-and-click
Für einige interaktive Anwendungen kann es von Vorteil sein, nur einige Elemente mit Point and click zu aktivieren. Wenn man beispielsweise eine Anwendung erstellen will, die Audio oder Video beginnend von einer angeklickten Note abspielt, würde es unpraktisch sein, wenn die Point-and-click-Zeiger Information eines Bogens oder Versetzungszeichen, die gleichzeitig mit der Note erscheinen, darstellen würden.
Man kann dieses Verhalten erreichen, indem man angibt, welche Ereignisse aufgenommen werden sollen:
-
Direkt in der ‘.ly’-Datei:
\pointAndClickTypes #'note-event \relative { c'2\f( f) }oder
#(ly:set-option 'point-and-click 'note-event) \relative { c'2\f( f) } -
Auf der Kommandozeile:
lilypond -dpoint-and-click=note-event example.ly
Auch mehrere Ereignisse können eingebunden werden:
-
Direkt in der ‘.ly’-Datei:
\pointAndClickTypes #'(note-event dynamic-event) \relative { c'2\f( f) }oder
#(ly:set-option 'point-and-click '(note-event dynamic-event)) \relative { c'2\f( f) } -
Auf der Kommandozeile:
lilypond \ -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \ example.ly