nächstes: GNU Free Documentation License, voriges: Vorlagen, aufwärts: Top
LilyPond verwendet die Scheme-Programmiersprache sowohl als Teil der Eingabesyntax als auch als internen Mechanismus, um Programmmodule zusammenzufügen. Dieser Abschnitt ist ein sehr kurzer Überblick über die Dateneingabe mit Scheme. Wenn Sie mehr über Scheme wissen wollen, gehen Sie zu http://www.schemers.org.
Das Grundlegendste an einer Sprache sind Daten: Zahlen, Zeichen, Zeichenketten, Listen usw. Hier ist eine Liste der Datentypen, die für LilyPond-Eingabedateien relevant sind.
#t
und für Falsch #f
.
1
ist die (ganze)
Zahl Eins, während -1.5
ist eine Gleitkommazahl (also
eine nicht-ganze).
"Das ist eine Zeichenkette"
Zeichenketten können über mehrere Zeilen reichen:
"Das ist eine Zeichenkette"
Anführungszeichen und neue Zeilen können auch mit sogenannten
Fluchtsequenzen eingefügt werden. Die Zeichenkette
a sagt "b"
wird wie folgt eingegeben:
"a sagt \"b\""
Neue Zeilen und Backslashe werden mit \n
bzw. \\
eingegeben.
In einer Notationsdatei werden kleine Scheme-Abschnitte mit der
Raute (#
) eingeleitet. Die vorigen Beispiele heißen also in
LilyPond:
##t ##f #1 #-1.5 #"Das ist eine Zeichenkette" #"Das ist eine Zeichenkette"
Für den Rest dieses Abschnitts nehmen wir an, dass die Daten immer in einer LilyPond-Datei stehen, darum wird immer die Raute verwendet.
Scheme kann verwendet werden, um Berechnungen durchzuführen. Es
verwendet eine Präfix-Syntax. Um 1 und 2 zu addieren, muss
man (+ 1 2)
schreiben, und nicht 1+2, wie in traditioneller
Mathematik.
#(+ 1 2) #3
Der Pfeil zeigt an, dass das Ergebnis der Auswertung von
(+ 1 2)
3
ist. Berechnungen können geschachtelt
werden und das Ergebnis einer Berechnung kann für eine neue
Berechnung eingesetzt werden.
#(+ 1 (* 3 4)) #(+ 1 12) #13
Diese Berechnungen sind Beispiele von Auswertungen. Ein Ausdruck
wie (* 3 4)
wird durch seinen Wert 12
ersetzt. Ähnlich
verhält es sich mit Variablen. Nachdem eine Variable definiert ist:
twelve = #12
kann man sie in Ausdrücken weiterverwenden:
twentyFour = #(* 2 twelve)
Die 24 wird in der Variablen twentyFour
gespeichert.
Die gleiche Zuweisung kann auch vollständig in Scheme geschrieben
werden:
#(define twentyFour (* 2 twelve))
Der Name einer Variable ist auch ein Ausdruck, genauso wie eine Zahl oder eine Zeichenkette. Er wird wie folgt eingegeben:
#'twentyFour
Das Apostroph '
verhindert, dass bei der Scheme-Auswertung
twentyFour
durch 24
ersetzt wird. Anstatt dessen erhalten
wir die Bezeichnung twentyFour
.
Diese Syntax wird sehr oft verwendet, weil es manche Einstellungsveränderungen erfordern, dass Scheme-Werte einer internen Variable zugewiesen werden, wie etwa
\override Stem #'thickness = #2.6
Diese Anweisung verändert die Erscheinung der Notenhälse. Der Wert
2.6
wird der Variable thickness
(Dicke) eines
Stem
-(Hals)-Objektes gleichgesetzt.
thickness
wird relativ zu den Notenlinien errechnet, in diesem
Fall sind die Hälse also 2,6 mal so dick wie die Notenlinien. Dadurch
werden Hälse fast zweimal so dick dargestellt, wie sie normalerweise sind.
Um zwischen Variablen zu unterscheiden, die in den Quelldateien direkt
definiert werden (wie twentyFour
weiter oben), und zwischen denen,
die für interne Objekte zuständig sind, werden hier die ersteren
„Bezeichner“ genannt, die letzteren dagegen „Eigenschaften“.
Das Hals-Objekt hat also eine thickness
-Eigenschaft, während
twentyFour
ein Bezeichner ist.
Sowohl zweidimensionale Abstände (X- und Y-Koordinaten) als auch
Größen von Objekten (Intervalle mit linker und rechter Begrenzung) werden
als pairs
(Paare) eingegeben. Ein Paar1 wird als (erster . zweiter)
eingegeben und sie müssen mit dem Apostroph eingeleitet werden, genauso
wie Symbole:
\override TextScript #'extra-offset = #'(1 . 2)
Hierdurch wird das Paar (1, 2) mit der Eigenschaft extra-offset
des TextScript-Objektes verknüpft. Diese Zahlen werden in
Systembreiten gemessen, so dass der Befehl das Objekt eine Systembreite
nach rechts verschiebt und zwei Breiten nach oben.
Die zwei Elemente eines Paares können von beliebigem Inhalt sein, etwa
#'(1 . 2) #'(#t . #f) #'("blah-blah" . 3.14159265)
Eine Liste wird eingegeben, indem die Elemente der Liste in Klammern geschrieben werden, mit einem Apostroph davor. Beispielsweise:
#'(1 2 3) #'(1 2 "string" #f)
Die ganze Zeit wurde hier schon Listen benutzt. Eine Berechnung,
wie (+ 1 2)
, ist auch eine Liste (welche das Symbol +
und die Nummern 1 und 2 enthält. Normalerweise werden Listen
als Berechnungen interpretiert und der Scheme-Interpreter ersetzt
die Liste mit dem Ergebnis der Berechnung. Um eine Liste an sich
einzugeben, muss die Auswertung angehalten werden. Das geschieht,
indem der Liste ein Apostroph vorangestellt wird. Für Berechnungen
kann man also den Apostroph nicht verwenden.
Innerhalb einer zitierten Liste (also mit Apostroph) muss man keine Anführungszeichen mehr setzen. Im Folgenden ein Symbolpaar, eine Symbolliste und eine Liste von Listen:
#'(stem . head) #'(staff clef key-signature) #'((1) (2))
[1] In der
Scheme-Terminologie wird ein Paar cons
genannt und seine
zwei Elemente car
und cdr
.
Diese Seite ist für LilyPond-2.11.58 (Entwicklungszweig).
Fehler bitte an http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs melden.
Ihre Vorschläge für die Dokumentation sind willkommen.