LilyPond – Learning Manual

Anhänge

1. Übung

Dieses Kapitel stellt dem Leser das grundlegende Arbeiten mit LilyPond vor.

1.0.1 Eine Quelldatei übersetzen

Dieser Abschnitt führt in die „Kompilation“ ein – den Bearbeitungsprozess von LilyPond-Eingabedateien (die Sie geschrieben haben) um eine Ausgabedatei zu erstellen.

1.0.2 Noten eingeben

„Kompilation“ ist der Begriff, der benutzt wird, um eine Lilypond-Eingabedatei mit dem Programm LilyPond in eine Notenausgabe umzuwandeln. Ausgabedateien sind in erster Linie PDF-Dateien (zum Anschauen und Drucken), MIDI (zum Abspielen) und PNG (für die Benutzung auf Internetseiten). Die Eingabedateien von LilyPond sind einfache Textdateien.

Das erste Beispiel zeigt, wie solch eine einfache Eingabedatei ausschauen kann.

{
  c' e' g' e'
}

Die graphische Ausgabe ist:

Zusätzlich unterscheidet LilyPond Groß- und Kleinschreibung. ‘ { c d e }’ ist zulässiger Code, ‘ { C D E }’ dagegen resultiert in einer Fehlermeldung.

Ansicht des Ergebnisses

Das Erstellen der Notenausgabe hängt davon ab, welches Betriebssystem und welche Programme Sie benutzen.

• MacOS X (graphisch)
• Microsoft Windows (graphisch)
• Alle Betriebssysteme (Kommandozeile)

Beachten Sie, dass es eine Reihe an Texteditoren mit besserer Unterstützung für LilyPond gibt. Mehr dazu im Abschnitt Leichteres Editieren.

1.0.3 MacOS X

1. Schritt: Erstellen Sie eine ‘.ly’-Datei

Wenn Sie das LilyPond.app-Symbol doppelt klicken, öffnet sich eine Beispiel-Datei.

Wählen Sie aus den Menüs oben links auf Ihrem Bildschirm File > Save.

Wählen Sie einen Namen für die Datei, etwa ‘test.ly’.

2. Schritt: Kompilieren (mit LilyPad)

Aus den selben Menüs wählen Sie jetzt Compile > Typeset.

Ein neues Fenster öffnet sich, in dem ein Fortschrittslog der Kompilation der von ihnen gerade gespeicherten Datei gezeigt wird.

3. Schritt: Ausgabe anschauen

Wenn die Kompilation fertig ist, wird ein PDF mit dem gleichen Namen wie das Original erstellt und automatisch mit dem Standard-PDF-Programm geöffnet und angezeigt.

Andere Befehle

Um neue LilyPond-Dateien zu erstellen beginnen sie mit File > New

oder File > Open um eine schon existierende Datei zu öffnen und zu editieren.

Sie müssen alle Änderungen an der Datei zuerst speichern, bevor Sie wieder Compile > Tyepset wählen. Wenn das PDF nicht erscheint, schauen Sie im Fortschrittslog nach Fehlern.

Wenn Sie nicht das Standard-PDF-Programm benutzen, das automatisch bei Mac OS X dabei ist, und Sie die PDF-Datei noch von einer vorigen Kompilation geöffnet haben, können weitere Kompilationen fehlschlagen, bis Sie das Original-PDF schließen.

1.0.4 Windows

1. Schritt: Erstellen Sie eine ‘.ly’-Datei

Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken, öffnet sich ein einfacher Texteditor mit einer Beispieldatei.

Aus dem Menü über der Beispieldatei wählen Sie File > Save as. Benutzen Sie nicht File > Save für die Beispieldatei, weil die Datei nicht funktioniert, bis Sie sie mit einem eigenen Namen gespeichert haben.

Wählen Sie einen Namen für Ihre Datei, etwa ‘test.ly’.

Schritt 2a: Kompilieren (mit drag-and-drop)

Sie können nach Belieben die Kompilation starten, indem Sie entweder:

Die Datei auf das LilyPond-Symbol ziehen.

Oder Sie klicken mit der rechten Maustaste auf die Datei und wählen Sie aus dem Menü Open with > LilyPond.

Schritt 2b: Kompilieren (mit Doppelklick)

Sie können auch einfach die Datei ‘test.ly’ doppelt anklicken.

3. Schritt: Ausgabe anschauen

Während der Kompilation von ‘test.ly’ öffnet sich ein Kommandofenster sehr schnell und schließt sich wieder. Drei zusätzliche Dateien werden in diesem Schritt erstellt.

Das PDF enthält den Notensatz aus der Datei ‘test.ly’.

Andere Befehle

Um eine neue Datei zu erstellen, wählen Sie File > New aus irgendeiner schon erstellten Datei.

oder File > Open, um eine Datei zu öffnen und zu bearbeiten, die Sie schon vorher gespeichert hatten.

Sie müssen jede neue Änderung erst speichern, bevor Sie die Datei kompilieren. Wenn kein PDF erstellt wird, öffnen Sie die Log-Datei und schauen Sie nach Fehlern.

Die Log-Datei wird jedes Mal überschrieben, wenn Sie Ihre LilyPond-Datei kompilieren.

Die PS-Datei wird intern von LilyPond benutzt um das PDF zu erstellen und kann ignoriert werden. Sie wird auch jedes Mal neu überschrieben.

Wenn Sie das PDF in einem PDF-Programm anschauen, müssen Sie es zuerst schließen, bevor Sie eine neue Kompilation durchführen können, denn es kann einen Fehler bei der Erstellung des neuen PDFs geben, wenn das alte noch geöffnet ist.

1.0.5 Kommandozeile

Schritt 1: Erstellen Sie eine ‘.ly’-Datei

Erstellen Sie eine Text-Datei mit dem Namen ‘test.ly’ und geben Sie folgenden Text ein:

{
  c' e' g' e'
}

Schritt 2: Kompilieren (auf der Kommandozeile)

Um die Datei zu kompilieren, geben sie an der Konsole bzw. Kommandozeile

lilypond test.ly

ein. Sie werden ungefähr folgende Meldungen sehen:

lilypond test.ly
GNU LilyPond 2.13.45
»test.ly« wird verarbeitet
Analysieren...
Interpretation der Musik...
Vorverarbeitung der grafischen Elemente...
Ideale Seitenanzahl wird gefunden...
Musik wird auf eine Seite angepasst...
Systeme erstellen...
Layout nach »test.ps« ausgeben...
Konvertierung nach »test.pdf«...

3. Schritt: Ausgabe anschauen

Als Ergebnis erhalten Sie ein ‘test.pdf’, das Sie mit den Standardprogrammen Ihres Betriebssystemes anschauen können.

1.1 Wie werden Eingabe-Dateien geschrieben

Dieser Abschnitt erklärt die grundlegende LilyPond-Syntax und hilft bei den ersten Anfängen, eine LilyPond-Eingabedatei zu schreiben.

1.1.1 Einfache Notation

LilyPond fügt einige Bestandteile des Notenbildes automatisch hinzu. Im nächsten Beispiel sind nur vier Tonhöhen angegeben, aber LilyPond setzt trotzdem einen Schlüssel, eine Taktangabe und Notendauern.

{
  c' e' g' e'
}

Diese Einstellungen können verändert werden, aber in den meisten Fällen sind die automatischen Werte durchaus brauchbar.

Tonhöhen

Glossar: pitch, interval, scale, middle C, octave, accidental.

Die Tonhöhen werden mit Kleinbuchstaben eingegeben, die den Notennamen entsprechen. Es ist jedoch wichtig zu wissen, dass LilyPond in seiner Standardeinstellung die englischen Notennamen verwendet. Bis auf eine Ausnahme entsprechen sie den deutschen, deshalb wird die Voreinstellung von LilyPond für diese Übung beibehalten. Die Ausnahme ist das h – in LilyPond muss man anstelle dessen b schreiben! Das deutsche b dagegen wird als bes notiert, ein his dagegen würde bis geschrieben. Siehe auch Versetzungszeichen und Notenbezeichnungen in anderen Sprachen, hier wird beschrieben, wie sich die deutschen Notennamen benutzen lassen.

Am einfachsten können Noten im \relative-Modus eingegeben werden. In diesem Modus wird die Oktave der Note automatisch gewählt, indem angenommen wird, dass die folgende Note immer so nah wie möglich in Bezug auf die vorhergehende gesetzt wird, d. h. sie wird höchstens drei Notenzeilen höher oder tiefer als die vorhergehende Note gesetzt. Fangen wir unser erstes Notationsbeispiel mit einer Tonleiter an, wo also die nächste Note immer nur eine Notenlinie über der vorherigen steht.

% Beginnpunkt auf das mittlere C setzen
\relative c' {
  c d e f
  g a b c
}

Die erste Note ist ein eingestrichenes C. Jede folgende Note befindet sich so nah wie möglich bei der vorherigen – das erste ‚C‘ ist also das nächste C vom eingestrichenen C aus gerechnet. Darauf folgt das nächstmögliche D in Bezug auf die vorhergehende Note. Mit diesen Regeln können auch Melodien mit größeren Intervallen im \relative-Modus gebildet werden:

\relative c' {
  d f a g
  c b f d
}

Es ist nicht notwendig, dass die erste Note der Melodie mit der Note beginnt, die die erste Tonhöhe angibt. Die erste Note (das ‚D‘) des vorigen Beispiels ist das nächste D vom eingestrichenen C aus gerechnet.

Indem man Apostrophe ' (Taste Shift+#) oder Kommata , zu dem \relative c' { hinzufügt oder entfernt, kann die Oktave der ersten Tonhöhe verändert werden:

% zweigestrichenes C
\relative c'' {
  e c a c
}

Der relative Modus kann zunächst verwirrend erscheinen, aber es ist die einfachste Art, die meisten Melodien zu notieren. Schauen wir uns an, wie diese relative Berechnung in der Praxis funktioniert. Wenn wir mit einem H beginnen (b in der LilyPond-Syntax), welches sich auf der mittleren Linie im Violinschlüssel befindet, können wir C, D und E aufwärts notieren, und A, G und F unter dem H. Wenn also die Note, die auf das H folgt, ein C, D oder E ist, setzt LilyPond es oberhalb des Hs, wenn es ein A, G oder F ist, wird es darunter gesetzt.

\relative c'' {
  b c  % c ist 1 Zeile aufwärts, also c über dem b
  b d  % d ist 2 Zeilen aufwärts, oder 5 runter, also d über dem b
  b e  % e ist 3 aufwärts oder 4 runter, also e über dem b
  b a  % a ist 6 aufwärts oder 1 runter, also a unter dem b
  b g  % g ist 5 aufwärts oder 2 runter, also g unter dem b
  b f  % f ist 4 aufwärts oder 3 runter, also f unter dem b
}

Die gleiche Berechnung findet auch statt, wenn eine der Noten erhöht oder erniedrigt ist. Versetzungszeichen werden vollständig ignoriert bei der Berechnung. Genau die gleiche Berechnung wird analog von jeder folgenden Tonhöhe aus für die nächste Tonhöhe neu ausgeführt.

Um Intervalle zu notieren, die größer als drei Notenzeilen sind, kann man die Oktave verändern. Mit einem Apostroph ' (Taste Shift+#) direkt hinter dem Notennamen wird die Oktave um eins erhöht, mit einem Komma , um eins erniedrigt.

\relative c'' {
  a a, c' f,
  g g'' a,, f'
}

Um eine Notenhöhe um zwei (oder mehr!) Oktaven zu verändern, werden sukzessive '' oder ,, benutzt – es muss sich dabei wirklich um zwei einzelne Apostrophen und nicht um das Anführungszeichen "  (Taste Shift+2) handeln!

Tondauern (Rhythmen)

Glossar: beam, duration, whole note, half note, quarter note, dotted note.

Die Dauer einer Note wird durch eine Zahl bezeichnet, die direkt auf den Notennamen folgend eingegeben wird. 1 für eine ganze Note, 2 für eine halbe Note, 4 für eine Viertelnote und so weiter. Notenhälse und Balken werden automatisch hinzugefügt.

Wenn keine Dauer bezeichnet wird, wird die der vorhergehenden Note verwendet. Für die erste Note ist eine Viertel als Standard definiert.

\relative c'' {
  a1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}

Um punktierte Noten zu erzeugen, wird einfach ein Punkt . hinter die Notendauer geschrieben. Die Dauer einer punktierten Note muss explizit, also inklusive der Nummer, angegeben werden.

\relative c'' {
  a4 a a4. a8
  a8. a16 a a8. a8 a4.
}

Pausen

Eine Pause wird genauso wie eine Noten eingegeben; ihre Bezeichnung ist r :

\relative c'' {
  a4 r r2
  r8 a r4 r4. r8
}

Taktangabe

Glossar: time signature.

Die Taktart kann mit dem \time-Befehl definiert werden:

\relative c'' {
  \time 3/4
  a4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}

Tempobezeichnung

Glossar: tempo indication, metronome.

Die Tempobezeichnung und die Metronom-Angabe können mit dem \tempo-Befehl gesetzt werden:

\relative c'' {
  \time 3/4
  \tempo "Andante"
  a4 a a
  \time 6/8
  \tempo 4. = 96
  a4. a
  \time 4/4
  \tempo  "Presto" 4 = 120
  a4 a a a
}

Notenschlüssel

Glossar: clef.

Der Notenschlüssel kann mit dem \clef-Befehl gesetzt werden:

\relative c' {
  \clef "treble"
  c1
  \clef "alto"
  c1
  \clef "tenor"
  c1
  \clef "bass"
  c1
}

Alles zusammen

Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:

\relative c, {
  \clef "bass"
  \time 3/4
  \tempo "Andante" 4 = 120
  c2 e8 c'
  g'2.
  f4 e d
  c4 c, r4
}

Siehe auch

Notationsreferenz: Tonhöhen setzen, Rhythmen eingeben, Pausen eingeben, Taktangabe, Notenschlüssel.

1.1.2 Arbeiten an Eingabe-Dateien

LilyPonds Quelldateien ähneln Dateien in den meisten Programmiersprachen: Sie enthalten eine Versionsbezeichnung, es ist auf Groß- und Kleinschreibung zu achten und Leerzeichen werden ignoriert. Ausdrücke werden mit geschweiften Klammern { } eingeklammert und Kommentare mit dem Prozentzeichen % auskommentiert oder mit %{ … %} umgeben.

Wenn das jetzt unverständlich erscheint, sind hier die Erklärungen:

• Versionsbezeichnung: Jede LilyPond-Datei soll eine Versionsbezeichnung enthalten. Eine Versionsbezeichnung ist eine Zeile, die die Version von LilyPond deklariert, für die die Datei geschrieben wurde, wie in dem Beispiel:

  \version "2.13.45"
  

  Üblicherweise wird die Versionsbezeichnung oben in die Datei geschrieben.

  Die Versionsbezeichnung ist aus zwei Gründen sehr wichtig: 1. kann man mit ihrer Hilfe automatische Aktualisierungen der Eingabedateien vornehmen, wenn sich die LilyPond-Syntax ändern sollte. 2. wird hier die Version von LilyPond beschrieben, die nötig ist, um die Datei zu kompilieren.

  Wenn die Versionsbezeichnung in einer Datei fehlt, gibt LilyPond eine Warnung während der Kompilation der Datei aus.

• Groß- und Kleinschreibung: Die Bedeutung eines Zeichens verändert sich, je nachdem, ob es groß (A, B, S, T) oder klein (a, b, s, t) geschrieben wird. Noten müssen immer klein geschrieben werden, ‘{ c d e }’ funktioniert, während ‘{ C D E }’ einen Fehler produziert.
• Leerzeichen: Es spielt keine Rolle, wie viele Leerzeichen oder Tabulatoren oder leere Zeilen sich zwischen den Zeichen der Quelldatei befinden. ‘{ c d e }’ bedeutet das Gleiche wie ‘{ c       d e }’ oder

  { c4                        d
                       e }
  

  Natürlich ist das letzte Beispiel etwas schwer zu lesen. Eine gute Daumenregel ist es, Code-Blöcke mit zwei Leerzeichen einzurücken:

  {
    c4 d e
  }
  

  Leerzeichen sind jedoch nötig, um viele syntaktische Elemente voneinander zu trennen. Leerzeichen können also immer hinzugefügt werden, aber sie dürfen nicht entfernt werden. Da fehlende Leerzeichen sehr seltsame Fehlermeldungen hervorrufen können, wird es nahe gelegt, immer ein Leerzeichen vor und nach jedem syntaktischen Element, etwa vor und nach geschweiften Klammern, einzufügen.

• Ausdrücke: Auch der kleinste Abschnitt an LilyPond-Code muss in { geschweifte Klammern } eingeschlossen werden. Diese Klammern zeigen LilyPond an, dass es sich um einen zusammengehörenden musikalischen Ausdruck handelt, genauso wie Klammern ‚()‘ in der Mathematik. Die Klammern sollten von jeweils einem Leerzeichen umgeben sein, um Zweideutigkeiten auszuschließen, es sei denn, sie befinden sich am Anfang oder Ende einer Zeile.

  Ein LilyPond-Befehl gefolgt von einem einfachen Ausdruck in Klammern (wie etwa ‚\relative c' { … }‘) wird auch als ein einzelner Musikausdruck gewertet.

• Kommentare: Ein Kommentar ist eine Bemerkung für den menschlichen Leser einer Quelldatei, es wird bei der Dateianalyse durch das Programm ignoriert, so dass es also keine Auswirkung auf die Druckausgabe der Noten hat. Es gibt zwei verschiedene Typen von Kommentaren. Das Prozentzeichen ‚%‘ geht einem Zeilen-Kommentar voraus: Alles nach diesem Zeichen wird in dieser Zeile ignoriert. Üblicherweise wird ein Kommentar über dem Code gesetzt, auf den es sich bezieht.

  a4 a a a
  % Dieser Kommentar bezieht sich auf das H
  b2 b
  

  Ein Block-Kommentar ist ein ganzer Abschnitt mit einem Kommentar. Alles, was von %{ und %} umgeben ist, wird ignoriert. Das heißt, dass sich ein Block-Kommentar nicht ein einem anderen Blockkommentar befinden kann. Wenn Sie das versuchen sollten, beendet schon das erste %} beide Block-Kommentare. Das folgende Beispiel zeigt eine mögliche Anwendung von Kommentaren:

  % Noten für twinkle twinkle hier
    c4 c g' g a a g2
  
  %{
      Diese Zeilen, und die Noten unten werden
      ignoriert, weil sie sich in einem Block-Kommentar
      befinden.
  
      f4 f e e d d c2
  %}
  

1.2 Mit Fehlern umgehen

Manchmal erstellt LlilyPond nicht das Notenbild, das Sie erwarten. Dieser Abschnitt stellt einige Links zur Verfügung, um Ihnen bei der Problemlösung möglicher Schwierigkeiten zu helfen.

1.2.1 Allgemeine Fehlerlösungstipps

Fehlerlösung für LilyPond-Probleme kann eine große Herausforderung für Menschen darstellen, die an eine graphische Benutzeroberfläche gewohnt sind, weil ungültige Eingabedateien erstellt werden können. Wenn das geschieht, ist eine logische Herangehensweise der beste Weg, das Problem zu identifizieren und zu lsöen. Einige Richtlinien, wie Sie diese Problemlösung erlernen können, finden sich in Troubleshooting.

1.2.2 Einige häufige Fehler

Es gibt einige übliche Fehler, die schwierig zu lösen sind, wenn man nur die Fehlermeldungen der Log-Datei hat. Sie werden näher erklärt in Common errors.

1.3 Wie die Handbücher gelesen werden sollen

Dieser Abschnitt zeigt, wie die Dokumentation effizient gelesen werden kann und erklärt auch einige nützliche Interaktionseigenschaften der Online-Version.

1.3.1 Ausgelassenes Material

LilyPond-Code muss immer von { } Zeichen oder einem \relative c'' { … } umgeben sein, wie gezeigt in Arbeiten an Eingabe-Dateien. Im Rest dieses Handbuchs werden die meisten Beispiel allerdings darauf verzichten. Um sie zu reproduzieren, können Sie den entsprechenden Quellcode kopieren und in eine Textdatei einfügen, aber Sie müssen dabei \relative c'' { … } einfügen, wie hier gezeigt:

\relative c'' {
  …hier das Beispiel…
}

Warum werden die Klammern hier meist weggelassen? Die meisten der Beispiele können in ein längeres Musikstück hineinkopiert werden, und dann ist es natürlich nicht sinnvoll, wenn auch noch \relative c'' { … } dazukommt; ein \relative darf nicht innerhalb eines anderen \relative gesetzt werden, deshalb wird es hier weggelassen, damit die Beispiele auch innerhalb eines anderen Kontextes funktionieren. Wenn bei jedem Beispiel \relative c'' { … } eingesetzt würde, könnten Sie die kleinen Beispiele der Dokumentation nicht einfach zu Ihrem eigenen Notentext hinzufügen. Die meisten Benutzer wollen Noten zu einer schon bestehenden Datei irgendwo in der Mitte hinzufügen, deshalb wurde der relative Modus für die Beispiele im Handbuch weggelassen.

Denken Sie auch daran, dass jede LilyPond-Datei eine Versionsbezeichnung mit dem \version-Befehl haben sollte. Weil die Beispiele in den Handbüchern Schnipsel und keine vollständigen Dateien sind, fehlt hier die Versionsbezeichnung. Sie sollten sie aber immer in Ihre eigenen Dateien einfügen.

1.3.2 Anklickbare Beispiele

Viele Leute lernen Programme, indem sie einfach herumprobieren. Das geht auch mit LilyPond. Wenn Sie in der HTML-Version dieses Handbuchs eine Abbildung in der HTML-Version dieses Handbuches anklicken, erhalten sie exakt den LilyPond-Code, der zum Satz der Abbildung benutzt wurde. Versuchen Sie es mit dieser Abbildung:

Wenn Sie einfach alles kopieren, was im „ly snippet“-Abschnitt steht, und in eine Text-Datei einfügen, haben Sie schon eine fertige Vorlage für weitere Experimente. Damit Sie genau das gleiche Erscheinungsbild wie bei dem Beispiel selber erreichen, müssen Sie alles kopieren ab der Zeile „Start cut-&-pastable section“ bis ganz zum Ende der Datei.

1.3.3 Überblick über die Handbücher

Es gibt sehr viele Dokumentation für LilyPond. Neue Benutzer sind oft verwirrt, welche Teile davon sie lesen sollen, und so kommt es vor, dass manchmal wichtige Abschnitte nicht gelesen werden.

• Bevor Sie irgendetwas ausprobieren: Lesen Sie die Abschnitte Übung und Übliche Notation. Wenn Sie auf musikalische Fachbegriffen stoßen, die Sie nicht kennen, schauen Sie diese im Glossar nach.
• Bevor Sie ein vollständiges Stück notieren: Lesen Sie den Abschnitt Grundbegriffe im Handbuch zum Lernen. Danach können Sie sich die für Ihr Projekt wichtigen Abschnitte in der Notationsreferenz anschauen.
• Bevor Sie versuchen, die Standardnotation zu verändern: Lesen Sie Die Ausgabe verändern im Handbuch zum Lernen.
• Bevor Sie sich an ein größeres Projekt machen: Lesen Sie den Abschnitt wie man Dateien schreibt in der Programmbenutzung.

2. Übliche Notation

Dieser Abschnitt erklärt, wie wunderschöner Notensatz erstellt werden kann, der die am häufigsten vorkommenden Notationssymbole enthält. Der Abschnitt baut auf der Übung auf.

2.1 Notation auf einem System

Dieses Kapitel lehrt grundlegende Bestandteile der Notation, die für eine Stimme auf einem System gebraucht werden.

* Taktüberprüfung

2.1.1 Taktüberprüfung

Wenn sie auch nicht zwingend vorgeschrieben sind, so sollten Taktüberprüfungen in der Eingabedatei benutzt werden, um zu zeigen, wo Taktstriche normalerweise sein sollten. Sie werden mit dem „Pipe“-Symbol ( |) notiert (Taste AltGr + <). Mithilfe der Taktüberprüfungen kann das Programm sicherstellen, dass die eingegebenen Notenlängen auch volle Takte an den richtigen Stellen ergeben. Taktüberprüfungen erleichtern auch das Lesen des Eingabetextes, weil sie Ordnung in den Text bringen.

g1 | e1 | c2. c'4 | g4 c g e | c4 r r2 |

Siehe auch

Notationsreferenz: Takt- und Taktzahlüberprüfung.

2.1.2 Versetzungszeichen und Tonartbezeichnung (Vorzeichen)

Versetzungszeichen

Glossar: sharp, flat, double sharp, double flat, accidental.

Ein Kreuz-Versetzungszeichen¹ wird eingegeben, indem an den Notennamen ein ‚is‘ gehängt wird, ein B-Versetzungszeichen durch Anhängen von ‚es‘. Logischerweise wird dann ein Doppelkreuz oder Doppel-B durch Anhängen von ‚isis‘ oder ‚eses‘ geschrieben. Diese Syntax stammt aus der Tradition der germanischen Sprachen und ist also für deutsche Benutzer kein Problem. Es ist aber möglich, die Namen für die Versetzungszeichen in anderen Sprachen zu benutzen, siehe Notenbezeichnungen in anderen Sprachen.

cis4 ees fisis, aeses

Tonartbezeichnungen (Vorzeichen)

Glossar: key signature, major, minor.

Die Tonart eines Stückes wird erstellt mit dem Befehl \key, gefolgt von einer Notenbezeichnung und \major (für Dur) oder \minor (für Moll).

\key d \major
a1 |
\key c \minor
a1 |

Warnung: Tonartbezeichnungen und Tonhöhen

Glossar: accidental, key signature, pitch, flat, natural, sharp, transposition, Pitch names.

Um zu bestimmen, ob vor einer bestimmten Note ein Versetzungszeichen erscheinen soll, untersucht LilyPond die Notenhöhen und die Tonart. Die Tonart beeinflusst nur die gedruckten Versetzungszeichen, nicht die wirklichen Tonhöhen! Diese Besonderheit scheint am Anfang oft verwirrend, so dass sie hier etwas genauer betrachtet wird.

LilyPond unterscheidet strickt zwischen dem musikalischen Inhalt und dem Satz (Layout). Die Alteration (B, Kreuz oder Auflösungszeichen) einer Note gehört zur Tonhöhe dazu und ist deshalb musikalischer Inhalt. Ob ein Versetzungszeichen (also ein gedrucktes Kreuz, b oder Auflösungszeichen) auch vor der Note erscheint, hängt vom Kontext, also vom Layout ab. Das Layout gehorcht bestimmten Regeln, und Versetzungszeichen werden automatisch nach diesen Regeln gesetzt. Die Versetzungszeichen im fertigen Notenbild sind nach den Regeln des Notensatzes gesetzt. Deshalb wird automatisch entschieden, wo sie erscheinen, und man muss den Ton eingeben, den man hören will.

In diesem Beispiel

\key d \major
cis4 d e fis

hat keine der Noten ein Versetzungszeichen, trotzdem muss im Quelltext das ‚is‘ für cis und fis notiert werden.

Der Code ‚b‘ (nach der holländischen Notenbezeichnung wird der Ton H mit b gesetzt) heißt also nicht: „Zeichne einen schwarzen Punkt auf die Mittellinie des Systems.“ Im Gegenteil, er heißt vielmehr: „Hier soll eine Note mit der Tonhöhe H gesetzt werden.“ In der Tonart As-Dur bekommt sie ein Versetzungszeichen:

\key aes \major
aes4 c b c

Alle diese Versetzungszeichen ausdrücklich zu schreiben, bedeutet vielleicht etwas mehr Schreibarbeit, hat aber den großen Vorteil, dass Transpositionen sehr viel einfacher gemacht wird und der Druck von Versetzungszeichen nach unterschiedlichen Regeln erfolgen kann. Siehe Automatische Versetzungszeichen für einige Beispiele, wie Vorzeichen anhand von unterschiedlichen Regeln ausgegeben werden können.

Siehe auch

Notationsreferenz: Notenbezeichnungen in anderen Sprachen, Versetzungszeichen, Automatische Versetzungszeichen, Tonartbezeichnung.

2.1.3 Bindebögen und Legatobögen

Bindebögen

Glossar: tie.

Ein Bindebogen wird geschrieben, indem man eine Tilde ~ an die erste der zu verbindenden Noten hängt.

g4~ g c2~ | c4~ c8 a~ a2

Legatobögen

Glossar: slur.

Ein Legatobogen ist ein Bogen, der sich über mehrere Noten erstreckt. Seine Beginn- und Endnote werden mit ‚(‘ beziehungsweise ‚)‘ markiert.

d4( c16) cis( d e c cis d) e( d4)

Phrasierungsbögen

Glossar: slur, phrasing.

Bögen, die längere Phrasierungseinheiten markieren (Phrasierungsbögen), werden mit \( und \) eingegeben. Es können sowohl Legato- als auch Phrasierungsbögen gleichzeitig vorkommen, aber es kann nicht mehr als jeweils einen Legato- und einen Phrasierungsbogen gleichzeitig geben.

g4\( g8( a) b( c) b4\)

Warnung: Bindebögen sind nicht Legatobögen

Glossar: articulation, slur, tie.

Ein Legatobogen sieht aus wie ein tie, hat aber eine andere Bedeutung. Ein Bindebogen verlängert nur die vorhergehende Note und kann also nur bei zwei Noten gleicher Tonhöhe benutzt werden. Legatobögen dagegen zeigen die Artikulation von Noten an und können für größere Notengruppen gesetzt werden. Binde- und Legatobögen können geschachtelt werden.

c4~( c8 d~ d4 e)

Siehe auch

Notationsreferenz: Bindebögen, Legatobögen, Phrasierungsbögen.

2.1.4 Artikulationszeichen und Lautstärke

Artikulationszeichen

Glossar: articulation.

Übliche Artikulationszeichen können durch Anfügen von Minus (‚-‘) und einem entsprechenden Zeichen eingegeben werden:

c4-^ c-+ c-- c-|
c4-> c-. c2-_

Fingersatz

Glossar: fingering.

Auf gleiche Weise können Fingersatzbezeichnungen hinzugefügt werden, indem nach dem Minus (‚-‘) eine Zahl geschrieben wird:

c4-3 e-5 b-2 a-1

Artikulationszeichen und Fingersätze werden normalerweise automatisch platziert, aber man kann ihre Position auch vorgeben durch die Zeichen ‚^‘ (oben) oder ‚_‘ (unten) anstelle des Minuszeichen. An eine Note können auch mehrfache Artikulationszeichen gehängt werden. Meistens findet aber LilyPond alleine die beste Möglichkeit, wie die Artikulationen platziert werden sollen.

c4_-^1 d^. f^4_2-> e^-_+

Dynamik

Glossar: dynamics, crescendo, decrescendo.

Die Dynamik innerhalb eines Stückes wird eingegeben, indem man die Markierungen (mit einem Backslash) an die Note hängt:

c4\ff c\mf c\p c\pp

Crescendi und Decrescendi werden mit dem Befehl \< beziehungsweise \> begonnen. Das nächste absolute Dynamik-Zeichen, etwa \f, beendet das (De)Crescendo. Auch mit dem Befehl \! kann es explizit beendet werden.

c4\< c\ff\> c c\!

Siehe auch

Notationsreferenz: Artikulationszeichen und Verzierungen, Fingersatzanweisungen, Dynamik.

2.1.5 Text hinzufügen

Text können Sie auf folgende Art in die Partitur einfügen:

c2^"espr" a_"legato"

Zusätzliche Formatierung kann eingesetzt werden, wenn Sie den \markup-Befehl benutzen:

c2^\markup { \bold espr }
a2_\markup {
  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}

Siehe auch

Notationsreferenz: Text eingeben.

2.1.6 Automatische und manuelle Balken

Alle Balken werden automatisch gesetzt:

a8 ais d ees r d c16 b a8

Wenn diese automatisch gesetzten Balken nicht gewollt sind, können sie manuell geändert werden. Wenn nur ein Balken hier und da korrigiert werde muss, erhält die Note, an der der Balken anfängt, ein ‚[‘ (AltGr+8) und die, an der er enden soll, ein ‚]‘ (AltGr+9).

a8[ ais] d[ ees r d] c16 b a8

Wenn Sie die automatischen Balken vollständig oder für einen längeren Abschnitt ausschalten wollen, benutzen Sie den Befehl \autoBeamOff, um die Balken abzuschalten, und \autoBeamOn, um sie wieder einzuschalten.

\autoBeamOff
a8 c b4 d8. c16 b4 |
\autoBeamOn
a8 c b4 d8. c16 b4 |

Siehe auch

Notationsreferenz: Automatische Balken, Manuelle Balken.

2.1.7 Zusätzliche rhythmische Befehle

Auftakt

Ein Auftakt wird mit dem Befehl \partial eingegeben. Darauf folgt die Länge des Auftaktes: \partial 4 heißt eine Viertelnote Auftakt und \partial 8 eine Achtelnote.

\partial 8 f8 |
c2 d |

Andere rhythmische Aufteilungen

Glossar: note value, triplet.

Triolen und N-tolen werden mit dem \times-Befehl erzeugt. Er braucht zwei Argumente: einen Bruch und die Noten, auf die er sich bezieht. Die Dauer des Abschnittes wird mit dem Bruch multipliziert. In einer Triole dauern die Noten 2/3 ihrer normalen Länge, also hat eine Triole 2/3 als Bruch:

\times 2/3 { f8 g a }
\times 2/3 { c8 r c }
\times 2/3 { f,8 g16[ a g a] }
\times 2/3 { d4 a8 }

Verzierungen

Glossar: grace notes, acciaccatura, appoggiatura.

Verzierungen werden mit dem Befehl \grace eingegeben, Vorhalte durch den Befehl \appoggiatura und Vorschläge mit \acciaccatura.

c2 \grace { a32[ b] } c2 |
c2 \appoggiatura b16 c2 |
c2 \acciaccatura b16 c2 |

Siehe auch

Notationsreferenz: Verzierungen, Andere rhythmische Aufteilungen, Auftakte.

2.2 Mehrere Noten auf einmal

In diesem Kapitel wird gezeigt, wie mehr als eine Note zur gleichen Zeit gesetzt werden kann: auf unterschiedlichen Systemen für verschiedene Instrumente oder für ein Instrument (z. B. Klavier) und in Akkorden.

Polyphonie nennt man in der Musik das Vorkommen von mehr als einer Stimme in einem Stück. Polyphonie bzw. Mehrstimmigkeit heißt für LilyPond allerdings das Vorkommen von mehr als einer Stimme pro System.

2.2.1 Musikalische Ausdrücke erklärt

In LilyPond-Quelldateien wird Musik durch musikalische Ausdrücke dargestellt. Eine einzelne Note ist ein musikalischer Ausdruck.

a4

Eine Gruppe von Noten innerhalb von Klammern bildet einen neuen Ausdruck. Dieser ist nun ein zusammengesetzter musikalischer Ausdruck. Hier wurde solch ein zusammengesetzter musikalischer Ausdruck mit zwei Noten erstellt:

{ a4 g4 }

Wenn eine Gruppe von musikalischen Ausdrücken (also beispielsweise Noten) in geschweifte Klammern gesetzt wird, bedeutet das, dass eine Gruppe nach der anderen gesetzt wird. Das Resultat ist ein neuer musikalischer Ausdruck.

{ { a4 g } f4 g }

Analogie: mathematische Ausdrücke

Die Anordnung von Ausrücken funktioniert ähnlich wie mathematische Gleichungen. Eine längere Gleichung entsteht durch die Kombination kleinerer Gleichungen. Solche Gleichungen werden auch Ausdruck genannt und ihre Definition ist rekursiv, sodass beliebig komplexe und lange Ausdrücke erstellt werden können. So etwa hier:

1

1 + 2

(1 + 2) * 3

((1 + 2) * 3) / (4 * 5)

Das ist eine Folge von (mathematischen) Ausdrücken, in denen jeder Ausdruck in dem folgenden (größeren) enthalten ist. Die einfachsten Ausdrücke sind Zahlen, und größere werden durch die Kombination von Ausdrücken mit Hilfe von Operatoren (wie ‚+‘, ‚*‘ und ‚/‘) sowie Klammern. Genauso wie mathematische Ausdrücke können auch musikalische Ausdrücke beliebig tief verschachtelt werden. Das wird benötigt für komplexe Musik mit vielen Stimmen.

Gleichzeitige musikalische Ausdrücke: mehrere Notensysteme

Glossar: polyphony.

Mit dieser Technik kann polyphone Musik gesetzt werden. Musikalische Ausdrücke werden einfach parallel kombiniert, damit sie gleichzeitig als eigene Stimmen in dem gleichen Notensystem gesetzt werden. Um anzuzeigen, dass an dieser Stelle gleichzeitige Noten gesetzt werden, muss nur ein Kombinationszeichen eingefügt werden. Parallel werden musikalische Ausdrücke kombiniert, indem man sie mit << und >> einrahmt. Im folgenden Beispiel sind drei Ausdrücke (jeder mit zwei Noten) parallel kombiniert:

\relative c'' {
  <<
    { a2 g }
    { f2 e }
    { d2 b }
  >>
}

Es ist noch zu bemerken, dass wir hier für jede Ebene innerhalb der Quelldatei eine andere Einrückung geschrieben haben. Für LilyPond spielt es keine Rolle, wie viele Leerzeichen am Anfang einer Zeile sind, aber für Menschen ist es eine große Hilfe, sofort zu sehen, welche Teile des Quelltextes zusammen gehören.

Gleichzeitige musikalische Ausdrücke: ein Notensystem

Um die Anzahl der Notensysteme zu bestimmen, analysiert LilyPond den Anfang des ersten Ausdrucks. Wenn sich hier eine einzelne Note befindet, wird nur ein System gesetzt, wenn es sich um eine parallele Anordnung von Ausdrücken handelt, wird mehr als ein System gesetzt. Das folgende Beispiel beginnt mit einer Note:

\relative c'' {
  c2 <<c e>> |
  << { e f } { c <<b d>> } >> |
}

2.2.2 Mehrere Notensysteme

Wie wir in Musikalische Ausdrücke erklärt gesehen haben, sind LilyPond-Quelldateien aus musikalischen Ausdrücken konstruiert. Wenn die Noteneingabe mit parallelen Ausdrücken beginnt, werden mehrere Notensysteme erstellt. Es ist aber sicherer und einfacherer zu verstehen, wenn diese Systeme explizit erstellt werden.

Um mehr als ein System zu schreiben, wird jedem Notenausdruck, der in einem eigenen System stehen soll, der Befehl \new Staff vorne angefügt. Diese Staff (engl. für Notensystem)-Elemente werden dann parallel angeordnet mit den << und >>-Zeichen:

\relative c'' {
  <<
    \new Staff { \clef "treble" c4 }
    \new Staff { \clef "bass" c,,4 }
  >>
}

Der Befehl \new beginnt einen neuen „Notationskontext“. Ein solcher Notationskontext ist eine Umgebung, in der musikalische Ereignisse (wie Noten oder \clef (Schlüssel)-Befehle) interpretiert werden. Für einfache Stücke werden diese Umgebungen automatisch erstellt. Für kompliziertere Musik ist es aber am besten, die Umgebungen explizit zu erstellen.

Es gibt verschiedene Kontext-Typen. Score (Partitur), Staff (Notensystem) und Voice (Stimme) verarbeiten die Eingabe von Noten, während die Lyrics (Text)-Umgebung zum Setzen von Liedtexten und die ChordNames (Akkordbezeichnungs)-Umgebung für Akkordsymbole verwendet wird.

Indem \new vor einen musikalischen Ausdruck gesetzt wird, wird ein größerer Ausdruck erstellt. In diesem Sinne erinnert die Syntax des \new-Befehls an das Minuszeichen in der Mathematik. Genauso wie (4+5) ein Ausdruck ist, der durch -(4+5) zu einem größeren Ausdruck erweitert wurde, werden auch musikalische Ausdrücke durch den \new-Befehl erweitert.

Die Taktangabe, die in einem einzelnen System angegeben wird, wirkt sich auf alle anderen System aus. Die Angabe der Tonart in einem System hingegen beeinflusst nicht die Tonart der anderen Systeme. Dieses Verhalten ist darin begründet, dass Partituren mit transponierenden Instrumenten häufiger sind als Partituren mit unterschiedlichen Taktarten.

\relative c'' {
  <<
    \new Staff { \clef "treble" \key d \major \time 3/4 c4 }
    \new Staff { \clef "bass" c,,4 }
  >>
}

2.2.3 Notensysteme gruppieren

Glossar: brace, staff, system.

Musik für das Klavier wird üblicherweise auf zwei Systemen notiert, die durch eine geschweifte Klammer verbunden sind (Akkolade). Um ein derartiges Notensystem zu erstellen, geht man ähnlich vor wie in dem Beispiel aus Mehrere Notensysteme, nur dass der gesamte Ausdruck jetzt in eine PianoStaff-Umgebung eingefügt wird.

\new PianoStaff <<
  \new Staff …
  \new Staff …
>> >>

Hier ein kleines Beispiel:

\relative c'' {
  \new PianoStaff <<
    \new Staff { \time 2/4 c4 e | g g, | }
    \new Staff { \clef "bass" c,,4 c' | e c | }
  >>
}

Andere typische Gruppen von Notensystemen können mit den Befehlen \new StaffGroup für Orchestersätze und \new ChoirStaff für ein Chorsystem erstellt werden. Jede dieser Systemgruppen erstellt einen neuen Kontext, der dafür sorgt, dass die Klammern zu Beginn des Systems erstellt werden und der zusätzlich auch darüber entscheidet, ob die Taktlinien nur auf dem System oder auch zwischen System gesetzt werden.

Siehe auch

Notationsreferenz: Tasteninstrumente und andere Instrumente mit mehreren Systemen, Systeme anzeigen lassen.

2.2.4 Noten zu Akkorden verbinden

Glossar: chord

Wir haben schon weiter oben gesehen, wie Akkorde erstellt werden können, indem sie mit spitzen Klammern eingeschlossen und somit als gleichzeitig erklingend markiert werden. Die normale Art, Akkorde zu notieren, ist aber, sie in einfache spitze Klammern (‚<‘ und ‚>‘) einzuschließen. Beachten Sie, dass alle Noten eines Akkordes die gleiche Dauer haben müssen, und diese Dauer wird nach der schließenden Klammer geschrieben.

r4 <c e g> <c f a>2

Akkorde sind im Grunde gleichwertig mit einfachen Noten: Fast alle Markierungen, die an einfache Noten angehängt werden können, kann man auch an Akkorde hängen. So können Markierungen wie Balken oder Bögen mit den Akkorden kombiniert werden. Sie müssen jedoch außerhalb der spitzen Klammern gesetzt werden.

<c e g>8[ <c f a> <c e g> <c f a>] <c e g>\>[ <c f a> <c f a> <c e g>]\! |
r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |

Siehe auch

Notationsreferenz: Chorded notes.

2.2.5 Mehrstimmigkeit in einem System

Polyphone Notation in LilyPond ist nicht schwer, benutzt aber bestimmte Konzepte, die hier noch nicht behandelt worden sind und hier nicht erklärt werden sollten. Anstelle dessen führen die folgenden Abschnitte in diese Konzepte ein und erklären sie ausführlich.

Siehe auch

Handbuch zum Lernen: Voice enthält Noten.

Notationsreferenz: Gleichzeitig erscheinende Noten.

2.3 Lieder

In diesem Kapitel wird in die Kombination von Musik mit Text eingeführt und die Erstellung einfacher Song-Blätter gezeigt.

2.3.1 Einfache Lieder setzen

Glossar: lyrics.

Hier ist der Beginn eines einfachen Kinderliedes, Girls and boys come out to play:

\relative c'' {
  \key g \major
  \time 6/8
  d4 b8 c4 a8 | d4 b8 g4
}

Zu diesen Noten kann Text hinzugefügt werden, indem beide mit dem \addlyrics-Befehl kombiniert werden. Text wird eingegeben, indem jede Silbe durch ein Leerzeichen getrennt wird.

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 | d4 b8 g4
  }
  \addlyrics {
    Girls and boys come | out to play,
  }
>>

Sowohl die Noten als auch der Text sind jeweils in geschweifte Klammern eingefasst, und der gesamte Ausdruck ist zwischen << ... >> positioniert. Damit wird garantiert, dass Text und Noten gleichzeitig gesetzt werden.

2.3.2 Text an einer Melodie ausrichten

Glossar: melisma, extender line.

Die nächste Zeile des Kinderliedes lautet: The moon doth shine as bright as day. So sieht es notiert aus:

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c b a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Wenn dieser Code des obrigen Beispiels kompiliert wird, sollten derartige Warnungen in der Ausgabe auf der Konsole/in der Log-Datei auftauchen:

test.ly:10:29: Warnung: Taktüberprüfung gescheitert bei: 5/8
    The | moon doth shine as
                             | bright as day; |
test.ly:10:46: Warnung: Taktüberprüfung gescheitert bei: 3/8
    The | moon doth shine as | bright as day;
                                              |

Das ist ein gutes Beispiel für den Nutzen von Taktüberprüfungen. Wenn man sich die Noten genauer anschaut, wird klar, dass die neue Textzeile nicht korrekt an den Noten ausgerichtet ist. Das Wort shine sollte zu zwei Noten gesungen werden, nicht nur zu einer. Das nennt man ein Melisma, eine Silbe Text zu mehreren Noten. Es gibt mehrere Möglichkeiten, eine Silbe über mehrere Noten zu verlängern. Die einfachste ist es, einen Legatobogen um die betroffenen Noten zu setzen, zu Einzelheiten siehe Bindebögen und Legatobögen.

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c( b) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Die Wörter orientieren sich jetzt richtig an den Noten, aber der automatische Balken für die Noten zu shine as sieht nicht richtig aus. Wir können das korrigieren, indem wir die Balkenlänge manuell eingrenzen, damit sie der üblichen Notationsweise für Gesang entspricht. Für Einzelheiten siehe Automatische und manuelle Balken.

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c([ b]) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Alternativ kann das Melisma auch im Text notiert werden, indem für jede Note, die übersprungen werden soll, ein Unterstrich _ im Text geschrieben wird:

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c[ b] a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine _ as | bright as day; |
  }
>>

Wenn die letzte Silbe eines Wortes sich über mehrere Noten oder eine sehr lange Note erstreckt, wird üblicherweise eine Fülllinie gesetzt, die sich über alle Noten erstreckt, die zu der Silbe gehören. Diese Fülllinie wird mit zwei Unterstrichen __ notiert. Hier ein Beispiel der ersten drei Takte aus Didos Klage, aus Purcells Dido and Æneas:

<<
  \relative c'' {
    \key g \minor
    \time 3/2
    g2 a bes | bes2( a) b2 |
    c4.( bes8 a4. g8 fis4.) g8 | fis1
  }
  \addlyrics {
    When I am | laid,
    am | laid __ in | earth,
  }
>>

Keins der bisherigen Beispiele hat bisher Wörter benutzt, die länger als eine Silbe waren. Solche Wörter werden üblicherweise auf die Noten aufgeteilt, eine Silbe pro Note, mit Bindestrichen zwischen den Silben. Diese Silben werden durch zwei Minuszeichen notiert und von LilyPond als ein zentrierter Bindestrich zwischen den Silben gesetzt. Hier ein Beispiel, das dies und alle anderen Tricks zeigt, mit denen Text an den Noten ausgerichtet werden kann:

<<
  \relative c' {
    \key g \major
    \time 3/4
    \partial 4
    d4 | g4 g a8( b) | g4 g b8( c) |
    d4 d e | c2
  }
  \addlyrics {
    A -- | way in a __ | man -- ger,
    no __ | crib for a | bed, __
  }
>>

Einige Texte, besonders in italienischer Sprache, brauchen das Gegenteil: mehr als eine Silbe muss zu einer einzelnen Note gesetzt werden. Das ist möglich, indem die Silben durch einen einzelnen Unterstrich _ zusammengekoppelt werden. Dazwischen dürfen sich keine Leerzeichen befinden, oder indem man die relevanten Silben in Anführungszeichen " setzt. Hier ein Beispiel aus dem Figaro von Rossini, wo die Silbe al auf der selben Note wie go des Wortes Largo in Figaros Arie Largo al factotum gesungen werden muss.

<<
  \relative c' {
    \clef "bass"
    \key c \major
    \time 6/8
    c4.~ c8 d b | c8([ d]) b c d b | c8
  }
  \addlyrics {
    Lar -- go_al fac -- | to -- tum del -- la cit -- | tà
  }
>>

Siehe auch

Notationsreferenz: Notation von Gesang.

2.3.3 Text zu mehreren Systemen

Die einfache Lösung mit \addlyrics kann benutzt werden, um Text zu einem oder mehreren Systemen zu setzen. Hier ein Beispiel aus Händels Judas Maccabäus:

<<
  \relative c'' {
    \key f \major
    \time 6/8
    \partial 8
    c8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ c4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- | dorn, __
  }
  \relative c' {
    \key f \major
    \time 6/8
    \partial 8
    r8 | r4. r4 c8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- dorn,
  }
>>

Aber Partituren, die komplizierter als dieses Beispiel sind, werden besser notiert, indem man die Systemstruktur von den Noten und dem Gesangstext durch Variablen trennt. Die Benutzung von Variablen wird erklärt im Abschnitt Stücke durch Bezeichner organisieren.

Siehe auch

Notationsreferenz: Notation von Gesang.

2.4 Letzter Schliff

Das ist das letzte Kapitel der Übung. Hier soll demonstriert werden, wie man den letzten Schliff an einfachen Stücken anbringen kann. Gleichzeitig dient es als Einleitung zum Rest des Handbuches.

2.4.1 Stücke durch Bezeichner organisieren

Wenn alle die Elemente, die angesprochen wurden, zu größeren Dateien zusammengefügt werden, werden auch die musikalischen Ausdrücke sehr viel größer. In polyphonen Dateien mit vielen Systemen kann das sehr chaotisch aussehen. Das Chaos kann aber deutlich reduziert werden, wenn Variablen definiert und verwendet werden.

Variablen (die auch als Bezeichner oder Makros bezeichnet werden) können einen Teil der Musik aufnehmen. Sie werden wie folgt definiert:

bezeichneteMusik = { … }

Der Inhalt des musikalischen Ausdrucks bezeichneteMusik kann dann später wieder benutzt werden, indem man einen Backslash davor setzt (\bezeichneteMusik), genau wie bei jedem LilyPond-Befehl.

Geige = \new Staff
  { \relative c'' {
    a4 b c b
  }
}
Cello = \new Staff
  { \relative c {
    \clef "bass"
    e2 d
  }
}
{
  <<
    \Geige
    \Cello
  >>
}

In den Namen der Variablen dürfen nur Buchstaben des Alphabets verwendet werden, keine Zahlen oder Striche.

Variable müssen vor dem eigentlichen musikalischen Ausdruck definiert werden. Sie können dann aber beliebig oft verwendet werden, nachdem sie einmal definiert worden sind. Sie können sogar eingesetzt werden, um später in der Datei eine neue Variable zu erstellen. Damit kann die Schreibarbeit erleichtert werden, wenn Notengruppen sich oft wiederholen.

trioleA = \times 2/3 { c,8 e g }
TaktA = { \trioleA \trioleA \trioleA \trioleA }

\relative c'' {
  \TaktA \TaktA
}

Man kann diese Variablen auch für viele andere Objekte verwenden, etwa:

Breite = 4.5\cm
Name = "Tim"
aFünfPapier = \paper { paperheight = 21.0 \cm }

Abhängig vom Kontext kann solch ein Bezeichner in verschiedenen Stellen verwendet werden. Das folgende Beispiel zeigt die Benutzung der eben definierten Bezeichner:

\paper {
  \aFünfPapier
  line-width = \Breite
}

{
  c4^\Name
}

2.4.2 Titel hinzufügen

Titel, Komponist, Opusnummern und ähnliche Information werden in einer \header-Umgebung eingefügt. Diese Umgebung befindet sich außerhalb der musikalischen Ausdrücke, meistens wird die \header-Umgebung direkt nach der @ref{Versionsnummer} eingefügt.

\version "2.13.45"

\header {
  title = "Symphony"
  composer = "Ich"
  opus = "Op. 9"
}

{
  … Noten …
}

Wenn die Datei übersetzt wird, werden Titel- und Komponisteneinträge über der Musik ausgegeben. Mehr Information über die Titelei findet sich im Kapitel Titel erstellen.

2.4.3 Absolute Notenbezeichnungen

Bis jetzt haben wir immer \relative benutzt, um Tonhöhen zu bestimmen. Das ist die einfachste Eingabeweise für die meiste Musik. Es gibt aber noch eine andere Möglichkeit, Tonhöhen darzustellen: durch absolute Bezeichnung.

Wenn man das \relative weglässt, werden alle Tonhöhen von LilyPond als absolute Werte interpretiert. Ein c' ist dann also immer das eingestrichene C, ein b ist immer das kleine h unter dem eingestrichenen C, und ein g, ist immer das große G – also die Note auf der letzten Linie im Bass-Schlüssel.

{
  \clef "bass"
  c'4 b g, g, |
  g,4 f, f c' |
}

Hier eine Tonleiter über vier Oktaven:

{
  \clef "bass"
  c,4 d, e, f, |
  g,4 a, b, c |
  d4 e f g |
  a4 b c' d' |
  \clef "treble"
  e'4 f' g' a' |
  b'4 c'' d'' e'' |
  f''4 g'' a'' b'' |
  c'''1 |
}

Wie leicht zu sehen ist, muss man sehr viele Apostrophe schreiben, wenn die Melodie im Sopranschlüssel notiert ist. Siehe etwa dieses Fragment von Mozart:

{
  \key a \major
  \time 6/8
  cis''8. d''16 cis''8 e''4 e''8 |
  b'8. cis''16 b'8 d''4 d''8 |
}

Alle diese Apostrophe machen den Quelltext schlecht lesbar und sind eine mögliche Fehlerquelle. Mit dem \relative-Befehl ist das Beispiel sehr viel einfacher zu lesen:

\relative c'' {
  \key a \major
  \time 6/8
  cis8. d16 cis8 e4 e8 |
  b8. cis16 b8 d4 d8 |
}

Wenn man einen Fehler durch ein Oktavierungszeichen (' oder ,) im \relative-Modus macht, ist er sehr schnell zu finden, denn viele Noten sind nacheinander in der falschen Oktave. Im absoluten Modus dagegen ist ein einzelner Fehler nicht so deutlich und deshalb auch nicht so einfach zu finden.

Trotz allem ist der absolute Modus gut für Musik mit sehr großen Sprüngen und vor allem für computergenerierte LilyPond-Dateien.

2.4.4 Nach der Übung

Wenn Sie diese Übung absolviert haben, sollten Sie am besten ein paar Stücke selber notieren. Beginnen Sie mit den Vorlagen und fügen Sie einfach Ihre Noten dazu. Wenn Sie irgendetwas brauchen, das nicht in der Übung besprochen wurde, schauen Sie sich den Abschnitt Alles über die Notation an, angefangen mit Musikalische Notation. Wenn Sie für ein Instrument oder Ensemble Noten schreiben wollen, für das es keine Vorlage gibt, schauen Sie sich Erweiterung der Beispiele an.

Wenn Sie ein paar kurze Stücke notiert haben, lesen Sie den Rest des Handbuchs zum Lernen (Kapitel 3–5). Natürlich können Sie auch sofort weiterlesen. Die nächsten Kapitel sind aber mit der Annahme geschrieben, dass Sie die Eingabesprache von LilyPond beherrschen. Sie können die weiteren Kapitel auch überfliegen und dann darauf wieder zurückkommen, wenn Sie einige Erfahrungen im Notieren gewonnen haben.

In dieser Übung, genauso wie im gesamten Handbuch zum Lernen, befindet sich ein Abschnitt Siehe auch am Ende jedes Abschnittes, wo sich Verweise auf andere Abschnitte befinden. Diesen Verweisen sollten Sie nicht beim ersten Durchlesen folgen; erst wenn Sie das gesamte Handbuch zum Lernen gelesen haben, können Sie bei Bedarf diesen Verweisen folgen, um ein Thema zu vertiefen.

Bitte lesen Sie jetzt Überblick über die Handbücher, wenn Sie es bisher noch nicht getan haben. Es gibt ungeheuer viel Information über LilyPond, so dass Neulinge sich nicht sofort zurecht finden. Wenn Sie auch nur ein paar Minuten in diesem Abschnitt lesen, können Sie sich Stunden frustrierendes Suchen an der falschen Stelle ersparen!

3. Grundbegriffe

Nachdem im Tutorial gezeigt wurde, wie aus einfachen Text-Dateien wunderschön formatierte Musiknoten erzeugt werden können, stellt dieses Kapitel die Konzepte und Techniken vor, wie auch komplexere Partituren erstellt werden können.

3.1 Wie eine LilyPond-Eingabe-Datei funktioniert

Das LilyPond Eingabeformat hat eine ziemlich freie Form, so dass für erfahrene Benutzer viel Freiheit besteht, die Struktur ihrer Quelldateien anzulegen. Für Neulinge kann diese Flexibilität aber erst einmal verwirrend sein. In diesem Kapitel soll darum ein Teil dieser Strukturen dargestellt werden, vieles aber zur Vereinfachung auch weggelassen werden. Für eine komplette Beschreibung des Eingabeformats siehe Die Dateistruktur.

Die meisten Beispiele in diesem Handbuch sind kleine Schnipsel, wie etwa dieser:

c4 a b c

Wie hoffentlich bekannt ist, lässt sich solch ein Schnipsel nicht in dieser Form übersetzen. Diese Beispiele sind also nur Kurzformen von wirklichen Beispielen. Sie müssen wenigstens zusätzlich in geschweifte Klammern gesetzt werden.

{
  c4 a b c
}

Die meisten Beispiele benutzen auch den \relative c'-Befehl. Der ist nicht nötig, um die Dateien zu übersetzen, aber in den meisten Fällen sieht der Notensatz seltsam aus, wenn man den Befehl weglässt.

\relative c'' {
  c4 a b c
}

Eine komplette Definition des Eingabeformats findet sich im Kapitel Die Dateistruktur.

3.1.1 Einführung in die Dateistruktur von LilyPond

Ein grundlegendes Beispiel einer Eingabedatei für LilyPond lautet:

\version "2.13.45"

\header { }

\score {
  ...zusammengesetzter Musik-Ausdruck...  % Die gesamten Noten kommen hier hin!
  \layout { }
  \midi { }
}

Aufgrund der Flexibilität von LilyPond gibt es viele Variationen dieses Schemas, aber dieses Beispiel dient als einfacher Ausgangspunkt.

Bisher hat noch keines der Beispiele den \score{}-Befehl benutzt, da Lilypond derartige zusätzliche Befehle automatisch bei Bedarf einfügt, wenn die Eingabedatei eine einfache Struktur hat.

Sehen wir uns als ein solches einfaches Beispiel an:

\relative c'' {
  c4 a d c
}

Im Hintergrund kommen hier noch einige Ebenen dazu: LilyPond-Code in der obigen Form ist in Wirklichkeit eine Abkürzung. Auch wenn man so Dateien schreiben kann und sie auch korrekt gesetzt werden, heißt der vollständige Code, der hier gemeint ist, eigentlich:

\book {
  \score {
    \new Staff {
      \new Voice {
        \relative c'' {
          c4 a b c
        }
      }
    }
    \layout { }
  }
}

Mit anderen Worten: Wenn die Eingabedatei einen einfachen Musik-Ausdruck enthält, wird LilyPond die Datei so interpretieren, als ob dieser Ausdruck in den oben gezeigten Befehlen eingegeben wurde. Diese nötige Struktur wird automatisch im Speicher beim Aufruf von LilyPond erzeugt, ohne dass der Benutzer davon etwas bemerkt.

Ein Wort der Warnung ist jedoch angebracht! Viele der Beispiele in der Dokumentation von LilyPond lassen die \new Staff und \new Voice Befehle zur Erzeugung einer Notenzeile und einer Stimme (beides ist in LilyPond ein sogenannter Kontext) bewusst aus, damit sie implizit von LilyPond im Speicher erzeugt werden. Für einfache Dokumente funktioniert das im Allgemeinen sehr gut, für komplexere Partituren können dadurch aber unerwartete Ergebnisse entstehen, teilweise sogar unerwartete leere Notenzeilen. Um die entsprechenden Kontexte in diesem Fall explizit zu erzeugen, siehe Kontexte und Engraver.

Im Moment wollen wir aber zu unserem ersten Beispiel zurückkehren und nur den \score-Befehl näher betrachten.

Eine Partitur (\score) muss immer mit einem musikalischen Ausdruck beginnen. Das ist letztendlich alle Musik, angefangen bei einer einzelnen Note bis hin zu einer riesigen Partitur mit vielen Notensystemen (bezeichnet durch GrandStaff):

{
  \new GrandStaff <<
    ...hier die gesamte Partitur...
  >>
}

Da sich alles innerhalb der geschweiften Klammern { ... } befindet, wird es wie ein einziger musikalischer Ausdruck behandelt.

Ein \score auch andere Dinge enthalten, wie etwa

\score {
  { c'4 a b c' }
  \layout { }
  \midi { }
  \header { }
}

Wie man sieht, sind die drei Befehle \header, \layout und \midi von spezieller Natur: Im Gegensatz zu vielen Anderen Befehlen, die auch mit einem \ beginnen, liefern sie keinen Musikausdruck und sind auch nicht Teil eines musikalischen Ausdrucks. Daher können sie sowohl innerhalb eines \score-Blocks als auch außerhalb plaziert werden. Tatsächlich werden einige dieser Befehle meist außerhalb des \score-Blocksgesetzt, zum Beispiel findet sich der \header sehr oft oberhalb der \score-Umgebung. Das funktioniert genauso gut.

Zwei bisher noch nicht aufgetauchte Befehle sind \layout { } und \midi {}. Wenn sie in einer Datei vorkommen, führt dies dazu, dass Lilypond eine druckfähige PDF-Datei bzw. eine MIDI-Datei erzeugt. Genauer beschrieben werden sie im Benutzerhandbuch – Partiturlayout und MIDI-Dateien erstellen.

Ihr LilyPond Code kann auch mehrere \score-Blöcke enthalten. Jeder davon wird als eigenständige Partitur interpretiert, die allerdings alle in dieselbe Ausgabedatei plaziert werden. Ein \book-Befehl ist nicht explizit notwendig – er wird implizit erzeugt. Wenn jedoch für jeden \score-Block in einer einzigen ‘.ly’-Datei eine eigene Ausgabe-Datei erzeugt werden soll, dann muss jeder dieser Blöcke in einen eigenen \book-Block gesetzt werden: Jeder \book-Block erzeugt dann eine eigene Ausgabedatei.

Zusammenfassung:

Jeder \book-Block erzeugt eine eigene Ausgabedatei (z.B. eine PDF-Datei). Wenn Sie keinen derartigen Block explizit angegeben haben, setzt LilyPond den gesamten Dateiinhalt innerhalb eines einzigen impliziten \book-Blocks.

Jeder \score-Block beschreibt ein eigenständiges Musikstück innerhalb des \book-Blocks.

Jeder \layout-Block wirkt sich auf den \score- oder \book-Block aus, in dem er auftritt. So wirkt z.B. ein \layout-Block innerhalb eines \score-Blocks nur auf diesen einen Block und seinen gesamten Inhalt, ein \layout-Block außerhalb eines \score-Blocks (und daher innerhalb des implizit erzeugten oder explizit angegebenen \book-Blocks) jedoch auf alle \score-Blocks innerhalb dieses \book-Blocks.

Nähere Details finden sich im Abschnitt Mehrere Partituren in einem Buch.

Eine gute Möglichkeit zur Vereinfachung sind selbst definierte Variablen, wie auch gezeigt in Stücke durch Bezeichner organisieren. Alle Vorlagen verwenden diese Möglichkeit:

melodie = \relative c' {
  c4 a b c
}

\score {
  { \melodie }
}

Wenn LilyPond diese Datei analysiert, nimmt es den Inhalt von melodie (alles nach dem Gleichheitszeichen) und fügt ihn immer dann ein, wenn ein \melodie vorkommt. Die Namen sind frei wählbar, die Variable kann genauso gut melodie, GLOBAL, rechteHandKlavier, oder foofoobarbaz heißen. Als Variablenname kann fast jeder beliebige Name benutzt werden, allerdings dürfen nur Buchstaben vorkommen (also keine Zahlen, Unterstriche, Sonderzeichen, etc.) und er darf nicht wie ein LilyPond-Befehl lauten. Für mehr Information siehe Tipparbeit durch Variablen und Funktionen ersparen. Die genauen Einschränkungen sind beschrieben in Die Dateistruktur.

Siehe auch

Eine vollständige Definition des Eingabeformats findet sich in Die Dateistruktur.

3.1.2 Score ist ein (einziger) zusammengesetzter musikalischer Ausdruck

Im vorigen Kapitel, Einführung in die Dateistruktur von LilyPond, wurde die allgemeine Struktur einer LilyPond-Quelldatei beschrieben. Aber anscheinend haben wir die wichtigste Frage ausgelassen, nämlich wie man herausfindet, was nach dem \score geschrieben werden soll.

In Wirklichkeit ist das aber gar kein Geheimnis. Diese Zeile ist die Antwort:

Eine Partitur fängt immer mit \score an, gefolgt von einem einzelnen musikalischen Ausdruck.

Vielleicht wollen Sie noch einmal Musikalische Ausdrücke erklärt überfliegen. In diesem Kapitel wurde gezeigt, wie sich große musikalische Ausdrücke aus kleinen Teilen zusammensetzen. Noten können zu Akkorden verbunden werden usw. Jetzt gehen wir aber in die andere Richtung und betrachten, wie sich ein großer musikalischer Ausdruck zerlegen lässt. Zur Einfachheit soll nur ein Sänger und Klavier in unserem Beispiel eingesetzt werden. Wir brauchen keine Systemgruppe (StaffGroup), die einfach nur bewirkt, dass die Systeme mit einer Klammer zusammengefasst werden; sie wird also entfernt. Wir brauchen aber einen Sänger und ein Klavier.

\score {
  {
    <<
      \new Staff = "Sänger" <<
      >>
      \new PianoStaff = "Klavier" <<
      >>
    >>
  }
  \layout { }
}

Hier wurden die Systeme (Staff) benannt: „Sänger“ und „Klavier“. Das ist nicht direkt notwendig in diesem Fall, aber es ist gut, sich diese Schreibweise anzugewöhnen, damit man immer sofort erkennt, um welches System es sich handelt.

Zur Erinnerung: mit << und >> werden Noten gleichzeitig gesetzt. Dadurch werden Vokalstimme und Klaviersysteme übereinander ausgegeben. Die << ... >>-Konstruktion ist für das Sänger-System nicht notwendig, wenn hier nur die Noten einer einzigen Stimme eingefügt werden sollen, aber << ... >> anstelle von geschwungenen Klammern sind notwendig, sobald mehr als eine Stimme oder etwa eine Notenstimme und Gesangstext eingefügt werden sollen. In unserem Fall soll eine Stimme mit Gesangstext notiert werden, sodass die spitzen Klammern benötigt werden. Die Noten sollen erst später hinzugefügt werden, hier also erstmal nur ein paar Platzhalternoten und Text. Wenn Sie sich nicht erinnern, wie man Gesangstext notiert, lesen Sie noch einmal \addlyrics in Einfache Lieder setzen.

\score {
  <<
    \new Staff = "Sänger" <<
      \new Voice = "Singstimme" { c'1 }
      \addlyrics { And }
    >>
    \new PianoStaff = "Klavier" <<
      \new Staff = "oben" { }
      \new Staff = "unten" { }
    >>
  >>
  \layout { }
}

Jetzt haben wir viel mehr Details. Wir haben ein System (engl. staff) für einen Sänger, in dem sich wieder eine Stimme (engl. voice) befindet. Voice bedeutet für LilyPond eine Stimme (sowohl gesungen als auch gespielt) und evtl. zusätzlich einen Text. Zusätzlich werden zwei Notensysteme für das Klavier mit dem Befehl \new PianoStaff gesetzt. PianoStaff bezeichnet die Piano-Umgebung (etwa durchgehende Taktstriche und die geschweifte Klammer am Anfang), in der dann wiederum zwei eigene Systeme ("oben" für die rechte Hand und "unten" für die linke) erstellt werden, auch wenn das untere System noch einen Bassschlüssel erhalten muss.

Jetzt könnte man in diese Umgebung Noten einfügen. Innerhalb der geschweiften Klammern neben \new Voice = "Singstimme" könnte man

\relative c'' {
  r4 d8\noBeam g, c4 r
}

schreiben. Aber wenn man seine Datei so direkt schreibt, wird der \score-Abschnitt sehr lang und es wird ziemlich schwer zu verstehen, wie alles zusammenhängt. Darum bietet es sich an, Bezeichner (oder Variablen) zu verwenden. Sie wurden zu Beginn des vorigen Abschnitts erklärt, erinnern Sie sich? Damit wir sicher gehen können, dass der Inhalt der text-Variable als Gesangstext interpretiert wird, wird ihm \lyricmode vorangesetzt. Wie \addlyrics wird hiermit in den Eingabemodus für Gesangstext gewechselt. Ohne diesen Befehl würde LilyPond versuchen, den Inhalt der Variable als Noten zu interpretieren und dabei eine Menge Fehler produzieren. (Einige andere Eingabemodi sind außerdem noch verfügbar, siehe Input modes.)

Also haben wir, wenn wir ein paar Noten und einen Bassschlüssel für die linke Hand hinzufügen, folgendes Beispiel:

melodie = \relative c'' { r4 d8\noBeam g, c4 r }
text    = \lyricmode { And God said, }
oben    = \relative c'' { <g d g,>2~ <g d g,> }
unten   = \relative c { b2 e }

\score {
  <<
    \new Staff = "Sänger" <<
      \new Voice = "Singstimme" { \melodie }
      \addlyrics { \text }
    >>
    \new PianoStaff = "Klavier" <<
      \new Staff = "oben" { \oben }
      \new Staff = "unten" {
        \clef "bass"
        \unten
      }
    >>
  >>
  \layout { }
}

Beim Schreiben (oder Lesen) einer \score-Umgebung sollte man langsam und sorgfältig vorgehen. Am besten fängt man mit dem größten Gebilde an und definiert dann die darin enthaltenen kleineren der Reihe nach. Es hilft auch, sehr genau mit den Einzügen zu sein, so dass jede Zeile, die der gleichen Ebene angehört, wirklich horizontal an der gleichen Stelle beginnt.

Siehe auch

Benutzerhandbuch: Struktur einer Partitur.

3.1.3 Musikalische Ausdrücke ineinander verschachteln

Notenzeilen (die ‚Staff‘-Kontexte) müssen nicht unbedingt gleich zu Beginn erzeugt werden – sie können auch zu einem späteren Zeitpunkt eingeführt weden. Das ist vor allem nützlich, um Ossias zu erzeugen. Hier folgt ein kurzes Beispiel, wie eine zusätzliche temporäre Notenzeile für nur drei Noten erzeugt werden kann:

\new Staff {
  \relative g' {
    r4 g8 g c4 c8 d |
    e4 r8
    <<
      { f8 c c }
      \new Staff {
        f8 f c
      }
    >>
    r4 |
  }
}

Wie man sieht, ist die Größe des Notenschlüssels dieselbe, wie sie auch bei einer Schlüsseländerung auftritt – etwas kleiner als der Schlüssel am Beginn einer Notenzeile. Dies ist normal für Notenschlüssel, die innerhalb einer Notenzeile gesetzt werden.

Der Ossia-Abschnitt kann auch oberhalb der Hauptnotenzeile gesetzt werden:

\new Staff = "Hauptzeile" {
  \relative g' {
    r4 g8 g c4 c8 d |
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = #"Hauptzeile"
      }{ f8 f c }
    >>
    r4 |
  }
}

Dieses Beispiel benutzt den \with-Befehl, der später noch genauer erklärt wird. Damit kann das Standardverhalten einer einzelnen Notenzeile geändert werden: Hier wird einfach angegeben, dass die neue Notenzeile oberhalb der bereits existierenden Zeile mit Namen „Hauptzeile“ plaziert werden soll, anstatt standardmäßig unterhalb.

Siehe auch

Ossia werden oft ohne Notenschlüssel und Taktangabe gedruckt, meist auch etwas kleiner als die anderen Notenzeilen. Dies ist natürlich auch in LilyPond möglich, benötigt aber Befehle, die bisher noch nicht vorgestellt wurden. Siehe Größe von Objekten und Ossia-Systeme.

3.1.4 Über die Nicht-Schachtelung von Klammern und Bindebögen

Sie haben bisher zahlreiche verschiedene Arten von Klammern und Klammer-artigen Konstruktionen beim Schreiben von Musik mit LilyPond kennengelernt. Diese folgen verschiedenen Regeln, die zu Beginn vielleicht verwirrend wirken. Bevor die genauen Regeln vorgestellt werden, wollen wir die diversen Klammerarten und Arten von Klammer-artigen Konstrukten kurz rekapitulieren:

Zusätzlich sollten vielleicht noch einige weiter Konstruktionen erwähnt werden, die Noten auf irgendeine Art und Weise verbinden: Haltebögen (durch eine Tilde ~ markiert), Triolen (als \times x/y {..} geschrieben) und Vorschlagnoten (als \grace{..} notiert).

Außerhalb von LilyPond fordert die übliche Benutzung von Klammern, dass die entsprechenden Arten korrekt verschachtelt werden, wie z.B. in << [ { ( .. ) } ] >>. Die schließenden Klammern kommen dabei in der umgekehrten Reihenfolge wie die öffnenden Klammern vor. Dies ist auch in LilyPond ein Muss für die drei Klammerarten, die in obiger Tabelle mit dem Wort ‚Umschließt‘ beschrieben werden – sie müssen korrekt geschachtelt werden. Die restlichen Klammer-artigen Konstruktionen (durch ‚Markiert‘ in der Tabelle oben beschrieben), die Haltebögen und die Triolen brauchen jedoch mit den anderen Klammern oder Klammer-artigen Konstrukten nicht unbedingt korrekt geschachtelt werden. Tatsächlich sind sie auch keine Klammern in dem Sinn, dass sie etwas umschließen, sondern viel mehr Indikatoren, an welcher Stelle ein bestimmtes musikalisches Objekt beginnt oder endet.

So kann also z.B. einen Phrasierungsbogen vor einem manuellen Balken beginn, jedoch schon vor dem Ende des Balkens enden. Dies mag zwar musikalisch wenig Sinn ergeben, ist aber in LilyPond auch möglich:

 { g8\( a b[ c b\) a] g4 }

Im Allgemeinen können die verschiedenen Klammerarten, Klammer-artigen Konstruktionen, Haltebögen, Triolen und Vorschlagnoten beliebig kombiniert werden. Das folgende Beispiel zeigt einen Balken, der in eine Triole reicht (Zeile 1), eine Bindebogen, der ebenfalls in eine Triole reicht (Zeile 2), einen Balken und einen Bindeboden in eine Triole, ein Haltebogen, der über zwei Triolen läuft, sowie einen Phrasierungsbogen, der in einer Triole beginnt (Zeilen 3 und 4).

{
  r16[ g \times 2/3 { r16 e'8] }
  g16( a \times 2/3 { b16 d) e' }
  g8[( a \times 2/3 { b8 d') e'~] } |
  \times 4/5 { e'32\( a b d' e' } a'4.\)
}

3.2 Voice enthält Noten

Sänger brauchen Stimmen zum Singen, und LilyPond braucht sie auch: in der Tat sind alle Noten für alle Instrumente in einer Partitur innerhalb von Stimmen gesetzt. Die Stimme ist das grundlegendste Prinzip von LilyPond.

3.2.1 Ich höre Stimmen

Die grundlegendsten und innersten Ebenen ein einer LilyPond-Partitur werden „Voice context“ (Stimmenkontext) oder auch nur „Voice“ (Stimme) genannt. Stimmen werden in anderen Notationsprogrammen manchmal auch als „layer“ (Ebene) bezeichnet.

Tatsächlich ist die Stimmenebene die einzige, die wirklich Noten enthalten kann. Wenn kein Stimmenkontext explizit erstellt wird, wird er automatisch erstellt, wie am Anfang dieses Kapitels gezeigt. Manche Instrumente wie etwa die Oboe können nur eine Note gleichzeitig spielen. Noten für solche Instrumente sind monophon und brauchen nur eine einzige Stimme. Instrumente, die mehrere Noten gleichzeitig spielen können, wie das Klavier, brauchen dagegen oft mehrere Stimmen, um die verschiedenen gleichzeitig erklingenden Noten mit oft unterschiedlichen Rhythmen darstellen zu können.

Eine einzelne Stimme kann natürlich auch vielen Noten in einem Akkord enthalten – wann also braucht man dann mehrere Stimmen? Schauen wir uns zuerst dieses Beispiel mit vier Akkorden an:

\key g \major
<d g>4 <d fis> <d a'> <d g>

Das kann ausgedrückt werden, indem man die einfachen spitzen Klammern < ... > benützt, um Akkorde anzuzeigen. Hierfür braucht man nur eine Stimme. Aber gesetzt der Fall das Fis sollte eigentlich eine Achtelnote sein, gefolgt von einer Achtelnote G (als Durchgangsnote hin zum A)? Hier haben wir also zwei Noten, die zur gleichen Zeit beginnen, aber unterschiedliche Dauern haben: die Viertelnote D und die Achtelnote Fis. Wie können sie notiert werden? Als Akkord kann man sie nicht schreiben, weil alle Noten in einem Akkord die gleiche Länge besitzen müssen. Sie können auch nicht als aufeinanderfolgende Noten geschrieben werden, denn sie beginnen ja zur selben Zeit. In diesem Fall also brauchen wir zwei Stimmen.

Wie aber wird das in der LilyPond-Syntax ausgedrückt?

Die einfachste Art, Fragmente mit mehr als einer Stimme auf einem System zu notieren, ist, die Stimmen nacheinander (jeweils mit den Klammern { ... }) zu schreiben und dann mit den spitzen Klammern (<<...>>) simultan zu kombinieren. Die beiden Fragmente müssen zusätzlich noch mit zwei Backslash-Zeichen (\\) voneinander getrennt werden, damit sie als zwei unterschiedliche Stimmen erkannt werden. Ohne diese Trenner würden sie als eine einzige Stimme notiert werden. Diese Technik ist besonders dann angebracht, wenn es sich bei den Noten um hauptsächlich homophone Musik handelt, in der hier und da polyphone Stellen vorkommen.

So sieht es aus, wenn die Akkorde in zwei Stimmen aufgeteilt werden und zur Durchgangsnote noch ein Bogen hinzugefügt wird:

\key g \major
%    Voice "1"               Voice "2"
<< { g4 fis8( g) a4 g } \\ { d4 d d d }  >>

Beachte, dass die Hälse der zweiten Stimme nun nach unten zeigen.

Hier ein anderes Beispiel:

\key d \minor
%    Voice "1"             Voice "2"
<< { r4 g g4. a8 }    \\ { d,2 d4 g }       >>
<< { bes4 bes c bes } \\ { g4 g g8( a) g4 } >>
<< { a2. r4 }         \\ { fis2. s4 }       >>

Es ist nicht notwendig, für jeden Takt eine eigene << \\ >>-Konstruktion zu benutzen. Bei Musik mit nur wenigen Noten pro Takt kann es die Quelldatei besser lesbar machen, aber wenn in einem Takt viele Noten vorkommen, kann man die gesamten Stimmen separat schreiben, wie hier:

\key d \minor
<< {
  % Voice "1"
  r4 g g4. a8 |
  bes4 bes c bes |
  a2. r4 |
} \\ {
  % Voice "2"
  d,2 d4 g |
  g4 g g8( a) g4 |
  fis2. s4 |
} >>

Dieses Beispiel hat nur zwei Stimmen, aber die gleiche Konstruktion kann angewendet werden, wenn man drei oder mehr Stimmen hat, indem man weitere Backslash-Trenner hinzufügt.

Die Stimmenkontexte tragen die Namen "1", "2" usw. In jedem dieser Kontexte wird die vertikale Ausrichtung von Hälsen, Bögen, Dynamik-Zeichen usw. entsprechend ausgerichtet.

\new Staff \relative c' {
  % Main voice
  c16 d e f
  %    Voice "1"     Voice "2"                Voice "3"
  << { g4 f e } \\ { r8 e4 d c8~ } >> |
  << { d2 e }   \\ { c8 b16 a b8 g~ g2 } \\ { s4 b c2 } >> |
}

Diese Stimmen sind alle getrennt von der Hauptstimme, die die Noten außerhalb der << .. >>-Konstruktion beinhaltet. Lassen wir es uns die simultane Konstruktion nennen. Bindebögen und Legatobögen können nur Noten in der selben Stimmen miteinander verbinden und können also somit nicht aus der simultanen Konstruktion hinausreichen. Umgekehrt gilt, dass parallele Stimmen aus eigenen simultanen Konstruktionen auf dem gleichen Notensystem die gleiche Stimme sind. Auch andere, mit dem Stimmenkontext verknüpfte Eigenschaften erstrecken sich auf alle simultanen Konstrukte. Hier das gleiche Beispiel, aber mit unterschiedlichen Farben für die Notenköpfe der unterschiedlichen Stimmen. Beachten Sie, dass Änderungen in einer Stimme sich nicht auf die anderen Stimmen erstrecken, aber sie sind weiterhin in der selben Stimme vorhanden, auch noch später im Stück. Beachten Sie auch, dass übergebundene Noten über die gleiche Stimme in zwei Konstrukten verteilt werden können, wie hier an der blauen Dreieckstimme gezeigt.

\new Staff \relative c' {
  % Main voice
  c16 d e f
  <<   % Bar 1
    {
      \voiceOneStyle
      g4 f e
    }
  \\
    {
      \voiceTwoStyle
      r8 e4 d c8~
    }
  >> |
  <<  % Bar 2
     % Voice 1 continues
    { d2 e }
  \\
     % Voice 2 continues
    { c8 b16 a b8 g~ g2 }
  \\
    {
      \voiceThreeStyle
      s4 b c2
    }
  >> |
}

Die Befehle \voiceXXXStyle sind vor allem dazu da, um in pädagogischen Dokumenten wie diesem hier angewandt zu werden. Sie verändern die Farbe des Notenkopfes, des Halses und des Balkens, und zusätzlich die Form des Notenkopfes, damit die einzelnen Stimmen einfach auseinander gehalten werden können. Die erste Stimme ist als rote Raute definiert, die zweite Stimme als blaue Dreiecke, die dritte Stimme als grüne Kreise mit Kreuz und die vierte Stimme (die hier nicht benutzt wird) hat dunkelrote Kreuze. \voiceNeutralStyle (hier auch nicht benutzt) macht diese Änderungen rückgängig. Später soll gezeigt werden, wie Befehle wie diese vom Benutzer selber erstellt werden können. Siehe auch Sichtbarkeit und Farbe von Objekten und Variablen für Optimierungen einsetzen.

Polyphonie ändert nicht die Verhältnisse der Noten innerhalb eines \relative-Blocks. Jede Note wird weiterhin relativ zu der vorherigen Note errechnet, oder relativ zur ersten Note des vorigen Akkords. So ist etwa hier

\relative c' { NoteA << < NoteB NoteC > \\ NoteD >> NoteE }

NoteB bezüglich NoteA
NoteC bezüglich NoteB, nicht noteA;
NoteD bezüglich NoteB, nicht NoteA oder NoteC;
NoteE bezüglich NoteD, nicht NoteA errechnet.

Eine andere Möglichkeit ist, den \relative-Befehl vor jede Stimme zu stellen. Das bietet sich an, wenn die Stimmen weit voneinander entfernt sind.

\relative c' { NoteA ... }
<<
  \relative c'' { < NoteB NoteC > ... }
\\
  \relative g' { NoteD ... }
>>
\relative c' { NoteE ... }

Zum Schluss wollen wir die Stimmen in einem etwas komplizierteren Stück analysieren. Hier die Noten der ersten zwei Takte von Chopins Deux Nocturnes, Op. 32. Dieses Beispiel soll später in diesem und dem nächsten Kapitel benutzt werden, um verschiedene Techniken, Notation zu erstellen, zu demonstrieren. Ignorieren Sie deshalb an diesem Punkt alles in folgendem Code, das Ihnen seltsam vorkommt, und konzentrieren Sie sich auf die Noten und die Stimmen. Die komplizierten Dinge werden in späteren Abschnitten erklärt werden.

Die Richtung der Hälse wird oft benutzt, um anzuzeigen, dass zwei gleichzeitige Melodien sich fortsetzen. Hier zeigen die Hälse aller oberen Noten nach oben und die Hälse aller unteren Noten nach unten. Das ist der erste Anhaltspunkt, dass mehr als eine Stimme benötigt wird.

Aber die wirkliche Notwendigkeit für mehrere Stimmen tritt erst dann auf, wenn unterschiedliche Noten gleichzeitig erklingen, aber unterschiedliche Dauern besitzen. Schauen Sie sich die Noten auf dem dritten Schlag im ersten Takt an. Das As ist eine punktierte Viertel, das F ist eine Viertel und das Des eine Halbe. Sie können nicht als Akkord geschrieben werden, denn alle Noten in einem Akkord besitzen die gleiche Dauer. Sie können aber auch nicht nacheinander geschrieben werden, denn sie beginnen auf der gleichen Taktzeit. Dieser Taktabschnitt benötigt drei Stimmen, und normalerweise schreibt man drei Stimmen für den ganzen Takt, wie im Beispiel unten zu sehen ist; hier sind unterschiedliche Köpfe und Farben für die verschiedenen Stimmen eingesetzt. Noch einmal: der Quellcode für dieses Beispiel wird später erklärt werden, deshalb ignorieren Sie alles, was Sie hier nicht verstehen können.

Versuchen wir also, diese Musik selber zu notieren. Wie wir sehen werden, beinhaltet das einige Schwierigkeiten. Fangen wir an, wie wir es gelernt haben, indem wir mit der << \\ >>-Konstruktion die drei Stimmen des ersten Taktes notieren:

\new Staff \relative c'' {
  \key aes \major
  <<
    { c2 aes4. bes8 } \\ { aes2 f4 fes } \\ { <ees c>2 des }
  >> |
  <c ees aes c>1 |
}

Die Richtung des Notenhalses wird automatisch zugewiesen; die ungeraden Stimmen tragen Hälse nach oben, die gerade Hälse nach unten. Die Hälse für die Stimmen 1 und 2 stimmen, aber die Hälse in der dritten Stimme sollen in diesem Beispiel eigentlich nach unten zeigen. Wir können das korrigieren, indem wir die dritte Stimme einfach auslassen und die Noten in die vierte Stimme verschieben. Das wird einfach vorgenommen, indem noch ein Paar \\-Stimmen hinzugefügt wird.

\new Staff \relative c'' {
  \key aes \major
  <<  % erste Stimme
    { c2 aes4. bes8 }
  \\  % zweite Stimme
    { aes2 f4 fes }
  \\  % Stimme drei auslassen
  \\  % vierte Stimme
    { <ees c>2 des }
  >>
  <c ees aes c>1
}

Wie zu sehen ist, ändert das die Richtung der Hälse, aber zeigt ein anderes Problem auf, auf das man manchmal bei mehreren Stimmen stößt: Die Hälse einer Stimme können mit den Hälsen anderer Stimmen kollidieren. LilyPond erlaubt Noten in verschiedenen Stimmen sich auf der gleichen vertikalen Position zu befinden, wenn die Hälse in entgegengesetzte Richtungen zeigen, und positioniert die dritte und vierte Stimme dann so, dass Zusammenstöße möglichst vermieden werden. Das funktioniert gewöhnlich recht gut, aber in diesem Beispiel sind die Noten der untersten Stimme eindeutig standardmäßig schlecht positioniert. LilyPond bietet verschiedene Möglichkeiten, die horizontale Position von Noten anzupassen. Wir sind aber noch nicht so weit, dass wir diese Funktionen anwenden könnten. Darum heben wir uns das Problem für einen späteren Abschnitt auf; siehe force-hshift-Eigenschaft in Überlappende Notation in Ordnung bringen.

Siehe auch

Notationsreferenz: Mehrere Stimmen.

3.2.2 Stimmen explizit beginnen

Voice-Kontexte können auch manuell innerhalb eines << >>-Abschnittes initiiert werden. Mit den Befehlen \voiceOne bis hin zu \voiceFour kann jeder Stimme entsprechendes Verhalten von vertikaler Verschiebung und Richtung von Hälsen und anderen Objekten hinzugefügt werden. In längeren Partituren können die Stimmen damit besser auseinander gehalten werden.

Die << \\ >>-Konstruktion, die wir im vorigen Abschnitt verwendet haben:

\new Staff {
  \relative c' {
    << { e4 f g a } \\ { c,4 d e f } >>
  }
}

ist identisch mit

\new Staff <<
  \new Voice = "1" { \voiceOne \relative c' { e4 f g a } }
  \new Voice = "2" { \voiceTwo \relative c' { c4 d e f } }
>>

Beide würden folgendes Notenbild erzeugen:

Der \voiceXXX-Befehl setzt die Richtung von Hälsen, Bögen, Artikulationszeichen, Text, Punktierungen und Fingersätzen. \voiceOne und \voiceThree lassen diese Objekte nach oben zeigen, \voiceTwo und \voiceFour dagegen lassen sie abwärts zeigen. Diese Befehle erzeugen eine horizontale Verschiebung, wenn es erforderlich ist, um Zusammenstöße zu vermeiden. Der Befehl \oneVoice stellt wieder auf das normale Verhalten um.

Schauen wir uns in einigen einfachen Beispielen an, was genau die Befehle \oneVoice, \voiceOne und voiceTwo mit Text, Bögen und Dynamikbezeichnung anstellen:

\relative c' {
  % Default behavior or behavior after \oneVoice
  c4 d8~ d e4( f | g4 a) b-> c |
}

\relative c' {
  \voiceOne
  c4 d8~ d e4( f | g4 a) b-> c |
  \oneVoice
  c,4 d8~ d e4( f | g4 a) b-> c |
}

\relative c' {
  \voiceTwo
  c4 d8~ d e4( f | g4 a) b-> c |
  \oneVoice
  c,4 d8~ d e4( f | g4 a) b-> c |
}

Schauen wir und nun drei unterschiedliche Arten an, den gleichen Abschnitt polyphoner Musik zu notieren, jede Art mit ihren Vorteilen in unterschiedlichen Situationen. Wir benutzen dabei das Beispiel vom vorherigen Abschnitt.

Ein Ausdruck, der direkt innerhalb einer << >>-Umgebung auftritt, gehört der Hauptstimme an. Das ist nützlich, wenn zusätzliche Stimme auftreten, während die Hauptstimme sich fortsetzt. Hier also eine bessere Version des Beispiels aus dem vorigen Abschnitt. Die farbigen Kreuz-Notenköpfe zeigen, dass die Hauptstimme sich jetzt in einem einzigen Stimmen (voice)-Kontext befindet. Somit kann ein Phrasierungsbogen ober sie gesetzt werden.

\new Staff \relative c' {
  \voiceOneStyle
  % The following notes are monophonic
  c16^( d e f
  % Start simultaneous section of three voices
  <<
    % Continue the main voice in parallel
    { g4 f e | d2 e) | }
    % Initiate second voice
    \new Voice {
      % Set stems, etc., down
      \voiceTwo
      r8 e4 d c8~ | c8 b16 a b8 g~ g2 |
    }
    % Initiate third voice
    \new Voice {
      % Set stems, etc, up
      \voiceThree
      s2. | s4 b4 c2 |
    }
  >>
}

Tiefer verschachtelte polyphone Konstrukte sind möglich, und wenn eine Stimme nur kurz auftaucht, kann das der bessere Weg sein, Noten zu setzen:

\new Staff \relative c' {
  c16^( d e f
  <<
    { g4 f e | d2 e2) | }
    \new Voice {
      \voiceTwo
      r8 e4 d c8~
      <<
        { c8 b16 a b8 g~ g2 | }
        \new Voice {
          \voiceThree
          s4 b4 c2 |
        }
      >>
    }
  >>
}

Diese Methode, neue Stimmen kurzzeitig zu verschachteln, bietet sich an, wenn nur sehr kleine Abschnitte polyphonisch gesetzt sind. Wenn aber die ganze Partitur polyphon ist, ist es meistens klarer, direkt unterschiedliche Stimmen über die gesamte Partitur hinweg einzusetzen. Hierbei kann man mit unsichtbaren Noten dann die Stellen überspringen, an denen die Stimme nicht auftaucht, wie etwa hier:

\new Staff \relative c' <<
  % Initiate first voice
  \new Voice {
    \voiceOne
    c16^( d e f g4 f e | d2 e) |
  }
  % Initiate second voice
  \new Voice {
    % Set stems, etc, down
    \voiceTwo
    s4 r8 e4 d c8~ | c8 b16 a b8 g~ g2 |
  }
  % Initiate third voice
  \new Voice {
    % Set stems, etc, up
    \voiceThree
    s1 | s4 b c2 |
  }
>>

Notenkolumnen

Dicht notierte Noten in einem Akkord, oder Noten auf der gleichen Taktzeit aber in unterschiedlichen Stimmen, werden in zwei, manchmal auch mehreren Kolumnen gesetzt, um die Noten am Überschneiden zu hindern. Wir bezeichnen sie als Notenkolumnen. Jede Stimme hat eine eigene Kolumne, und ein stimmenabhängiger Verschiebunsbefehl (engl. shift) wird eingesetzt, wenn eine Kollision auftreten könnte. Das zeigt das Beispiel oben. Im zweiten Takt wird das C der zweiten Stimme nach rechts verschoben, relativ gesehen zum D der ersten Stimme, und im letzten Akkord wird das C der dritten Stimme auch nach rechts verschoben im Verhältnis zu den anderen Stimmen.

Die Befehle \shiftOn, \shiftOnn, \shiftOnnn und \shiftOff bestimmen den Grad, zu dem Noten und Akkorde verschoben werden sollen, wenn sich sonst eine Kollision nicht vermeiden ließe. Die Standardeinstellung ist, dass die äußeren Stimmen (also normalerweise Stimme 1 und 2) \shiftOff eingestellt haben, während für die inneren Stimmen (3 und 4) \shiftOn eingeschaltet ist. Wenn eine Verschiebung auftritt, werden Stimmen 1 und 3 nach rechts und Stimmen 2 und 4 nach links verschoben.

\shiftOnn und \shiftOnnn definieren weitere Verschiebungsebenen, die man kurzzeitig anwählen kann, um Zusammenstöße in komplexen Situationen aufzulösen, siehe auch Beispiele aus dem Leben.

Eine Notenkolumne kann nur eine Note (oder einen Akkord) von einer Stimme mit Hälsen nach oben und eine Note (oder einen Akkord) von einer Stimme mit Hälsen nach unten tragen. Wenn Noten von zwei Stimmen mit den Hälsen in die gleiche Richtung an der selben Stelle auftreten und in beiden Stimmen ist keine Verschiebung oder die gleiche Verschiebungsebene definiert, wird die Fehlermeldung „zu viele kollidierende Notenspalten werden ignoriert“ ausgegeben.

Siehe auch

Notationsreferenz: Mehrere Stimmen.

3.2.3 Stimmen und Text

Die Notation von Vokalmusik ihre eigene Schwierigkeit, nämlich die Kombination von zwei Ausdrücken: den Noten und dem Text. Achtung: Der Gesangstext wird auf Englisch „lyrics“ genannt.

Wir haben schon den \addlyrics{}-Befehl betrachtet, mit dem einfache Partituren gut erstellt werden können. Diese Methode ist jedoch recht eingeschränkt. Wenn der Notensatz komplexer wird, muss der Gesangstext mit einem neuen Lyrics-Kontext begonnen werden (mit dem Befehl \new Lyrics) und durch den Befehl \lyricsto{} mit einer bestimmten Stimme verknüpft werden, indem die Bezeichnung der Stimme benutzt wird.

<<
  \new Voice = "one" {
    \relative c'' {
      \autoBeamOff
      \time 2/4
      c4 b8. a16 | g4. f8 | e4 d | c2 |
    }
  }
  \new Lyrics \lyricsto "one" {
    No more let | sins and | sor -- rows | grow. |
  }
>>

Beachten Sie, dass der Notentext nur mit einem Voice-Kontext verknüpft werden kann, nicht mit einem Staff-Kontext. In diesem Fall also müssen Sie ein System (Staff) und eine Stimme (Voice) explizit erstellen, damit alles funktioniert.

Die automatischen Balken, die LilyPond in der Standardeinstellung setzt, eignen sich sehr gut für instrumentale Musik, aber nicht so gut für Musik mit Text, wo man entweder gar keine Balken benutzt oder sie einsetzt, um Melismen zu verdeutlichen. Im Beispiel oben wird deshalb der Befehl \autoBeamOff eingesetzt um die automatischen Balken (engl. beam) auszuschalten.

Wir wollen das frühere Beispiel von Judas Maccabæus benutzen, um diese flexiblere Technik für Gesangstexte zu illustrieren. Das Beispiel wurde so umgeformt, dass jetzt Variablen eingesetzt werden, um den Text und die Noten von der Partiturstruktur zu trennen. Es wurde zusätzlich eine Chorpartiturklammer hinzugefügt. Der Gesangtext muss mit \lyricmode eingegeben werden, damit er als Text und nicht als Noten interpretiert werden kann.

global = { \key f \major \time 6/8 \partial 8 }

SopOneMusic = \relative c'' {
  c8 | c8([ bes)] a a([ g)] f | f'4. b, | c4.~ c4
}
SopOneLyrics = \lyricmode {
  Let | flee -- cy flocks the | hills a -- dorn, __
}
SopTwoMusic = \relative c' {
  r8 | r4. r4 c8 | a'8([ g)] f f([ e)] d | e8([ d)] c bes'
}
SopTwoLyrics = \lyricmode {
  Let | flee -- cy flocks the | hills a -- dorn,
}

\score {
  \new ChoirStaff <<
    \new Staff <<
      \new Voice = "SopOne" {
        \global
        \SopOneMusic
      }
      \new Lyrics \lyricsto "SopOne" {
        \SopOneLyrics
      }
    >>
    \new Staff <<
      \new Voice = "SopTwo" {
        \global
        \SopTwoMusic
      }
      \new Lyrics \lyricsto "SopTwo" {
        \SopTwoLyrics
      }
    >>
  >>
}

Dies ist die Grundstruktur für alle Chorpartituren. Mehr Systeme können hinzugefügt werden, wenn sie gebraucht werden, mehr Stimmen können zu jedem System hinzugefügt werden, mehr Strophen können zum Text hinzugefügt werden, und schließlich können die Variablen schnell in eine eigene Datei verschoben werden, wenn sie zu lang werden sollten.

Hier ein Beispiel der ersten Zeile eines Chorals mit vier Strophen für gemischten Chor. In diesem Fall ist der Text für alle vier Stimmen identisch. Beachten Sie, wie die Variablen eingesetzt werden, um Inhalt (Noten und Text) und Form (die Partitur) voneinander zu trennen. Eine Variable wurde eingesetzt, um die Elemente, die auf beiden Systemen auftauchen, aufzunehmen, nämlich Taktart und Tonart. Solch eine Variable wird oft auch mit „global“ bezeichnet.

keyTime = { \key c \major \time 4/4 \partial 4 }

SopMusic   = \relative c' { c4 | e4. e8 g4  g    | a4   a   g  }
AltoMusic  = \relative c' { c4 | c4. c8 e4  e    | f4   f   e  }
TenorMusic = \relative c  { e4 | g4. g8 c4.   b8 | a8 b c d e4 }
BassMusic  = \relative c  { c4 | c4. c8 c4  c    | f8 g a b c4 }

VerseOne =
  \lyricmode { E -- | ter -- nal fa -- ther, | strong to save, }
VerseTwo   =
  \lyricmode { O | Christ, whose voice the | wa -- ters heard, }
VerseThree =
  \lyricmode { O | Ho -- ly Spi -- rit, | who didst brood }
VerseFour  =
  \lyricmode { O | Tri -- ni -- ty of | love and pow'r }

\score {
  \new ChoirStaff <<
    \new Staff <<
      \clef "treble"
      \new Voice = "Sop"  { \voiceOne \keyTime \SopMusic }
      \new Voice = "Alto" { \voiceTwo \AltoMusic }
      \new Lyrics \lyricsto "Sop" { \VerseOne   }
      \new Lyrics \lyricsto "Sop" { \VerseTwo   }
      \new Lyrics \lyricsto "Sop" { \VerseThree }
      \new Lyrics \lyricsto "Sop" { \VerseFour  }
    >>
    \new Staff <<
      \clef "bass"
      \new Voice = "Tenor" { \voiceOne \keyTime \TenorMusic }
      \new Voice = "Bass"  { \voiceTwo \BassMusic }
    >>
  >>
}

Siehe auch

Notation Reference: Notation von Gesang.

3.3 Kontexte und Engraver

Kontexte und Engraver („Stempel“) sind in den vorherigen Abschnitten schon aufgetaucht; hier wollen wir uns ihnen nun etwas ausführlicher widmen, denn sie sind sehr wichtig, um Feineinstellungen in der LilyPond-Notenausgabe vornehmen zu können.

3.3.1 Was sind Kontexte?

Wenn Noten gesetzt werden, müssen viele Elemente zu der Notenausgabe hinzugefügt werden, die im Quellcode gar nicht explizit vorkommen. Vergleichen Sie etwa den Quellcode und die Notenausgabe des folgenden Beispiels:

cis4 cis2. | a4 a2. |

Der Quellcode ist sehr kurz und knapp, während in der Notenausgabe Taktlinien, Vorzeichen, ein Schlüssel und eine Taktart hinzugefügt wurden. Während LilyPond den Eingabetext interpretiert, wird die musikalische Information von rechts nach links gelesen, in etwa, wie man eine Partitur von links nach rechts liest. Während das Programm den Code liest, merkt es sich, wo sich Taktgrenzen befinden und für welche Tonhöhen Versetzungszeichen gesetzt werden müssen. Diese Information muss auf mehreren Ebenen gehandhabt werden, denn Versetzungszeichen etwa beziehen sich nur auf ein System, Taktlinien dagegen üblicherweise auf die gesamte Partitur.

Innerhalb von LilyPond sind diese Regeln und Informationshappen in Kontexten (engl. contexts) gruppiert. Der Voice (Stimmen)-Kontext wurde schon vorgestellt. Daneben gibt es noch die Staff (Notensystem-) und Score (Partitur)-Kontexte. Kontexte sind hierarchisch geschichtet um die hierarchische Struktur einer Partitur zu spiegeln. Ein Staff-Kontext kann zum Beispiel viele Voice-Kontexte beinhalten, und ein Score-Kontext kann viele Staff-Kontexte beinhalten.

Jeder Kontext hat die Aufgabe, bestimmte Notationsregeln zu erzwingen, bestimmte Notationsobjekte zu erstellen und verbundene Elemente zu ordnen. Der Voice-Kontext zum Beispiel kann eine Vorzeichenregel einführen und der Staff-Kontext hält diese Regel dann aufrecht, um einzuordnen, ob ein Versetzungszeichen gesetzt werden muss oder nicht.

Ein anderes Beispiel: die Synchronisation der Taktlinien ist standardmäßig im Score-Kontext verankert. Manchmal sollen die Systeme einer Partitur aber unterschiedliche Taktarten enthalten, etwa in einer polymetrischen Partitur mit 4/4- und 3/4-Takt. In diesem Fall müssen also die Standardeinstellungen der Score- und Staff-Kontexte verändert werden.

In einfachen Partituren werden die Kontexte implizit erstellt, und es kann sein, dass Sie sich dessen gar nicht bewusst sind. Für etwas größere Projekte, etwa mit vielen Systemen, müssen die Kontexte aber explizit erstellt werden, um sicher zu gehen, dass man auch wirklich die erwünschte Zahl an Systemen in der richtigen Reihenfolge erhält. Wenn Stücke mit spezialisierter Notation gesetzt werden sollen, ist es üblich, die existierenden Kontexte zu verändern oder gar gänzlich neue zu definieren.

Zusätzlich zu den Score, Staff und Voice-Kontexten gibt es noch Kontexte, die zwischen der Partitur- und Systemebene liegen und Gruppen von Systemen kontrollieren. Das sind beispielsweise der PianoStaff und ChoirStaff-Kontext. Es gibt zusätzlich alternative Kontexte für Systeme und Stimmen sowie eigene Kontexte für Gesangstexte, Perkussion, Griffsymbole, Generalbass usw.

Die Bezeichnungen all dieser Kontexte werden von einem oder mehreren englischen Wörtern gebildet, dabei wird jedes Wort mit einem Großbuchstaben begonnen und direkt an das folgende ohne Bindestrich oder Unterstrich angeschlossen, etwa GregorianTranscriptionStaff.

Siehe auch

Notationreferenz: Was sind Kontexte?.

3.3.2 Kontexte erstellen

In einer Eingabedatei enthält eine Score-Umgebung (einen Kontext), die mit dem Befehl \score eingeleitet wird, nur einen einzigen musikalischen Ausdruck und mit ihm verknüpft eine Ausgabedefinition (entweder eine \layout- oder eine \midi-Umgebung). Üblicherweise wird der Score-Kontext automatisch von LilyPond erstellt, wenn der musikalische Ausdruck interpretiert wird.

Wenn nur ein System vorhanden ist, kann man es ruhig LilyPond überlassen, auch die Voice- und Staff-Kontexte zu erstellen, aber für komplexere Partituren ist es notwendig, sie mit einem Befehl zu erstellen. Der einfachste Befehl hierzu ist \new. Er wird dem musikalischen Ausdruck vorangestellt, etwa so:

\new Typ musikalischer Ausdruck

wobei Typ eine Kontextbezeichnung (wie etwa Staff oder Voice) ist. Dieser Befehl erstellt einen neuen Kontext und beginnt, den muskalischen Ausdruck innerhalb dieses Kontexts auszuwerten.

Wir haben schon viele explizite Beispiel gesehen, in denen neue Staff- und Voice-Kontexte erstellt wurden, aber um noch einmal ins Gedächtnis zu rufen, wie diese Befehle benutzt werden, hier ein kommentiertes Beispiel aus dem richtigen Leben:

\score {  % start of single compound music expression
  <<  % start of simultaneous staves section
    \time 2/4
    \new Staff {  % create RH staff
      \clef "treble"
      \key g \minor
      \new Voice {  % create voice for RH notes
        \relative c'' {  % start of RH notes
          d4 ees16 c8.
          d4 ees16 c8.
        }  % end of RH notes
      }  % end of RH voice
    }  % end of RH staff
    \new Staff <<  % create LH staff; needs two simultaneous voices
      \clef "bass"
      \key g \minor
      \new Voice {  % create LH voice one
        \voiceOne
        \relative g {  % start of LH voice one notes
          g8 <bes d> ees, <g c>
          g8 <bes d> ees, <g c>
        }  % end of LH voice one notes
      }  % end of LH voice one
      \new Voice {  % create LH voice two
        \voiceTwo
        \relative g {  % start of LH voice two notes
          g4 ees
          g4 ees
        }  % end of LH voice two notes
      }  % end of LH voice two
    >>  % end of LH staff
  >>  % end of simultaneous staves section
}  % end of single compound music expression

(Beachten Sie, dass wir hier alle Zeilen, die eine neue Umgebung entweder mit einer geschweiften Klammer ({) oder doppelten spitzen Klammern (<<) öffnen, mit jeweils zwei Leerzeichen, und die entsprechenden schließenden Klammern mit der gleichen Anzahl Leerzeichen eingerückt werden. Dies ist nicht erforderlich, es wird aber zu einem großen Teil die nicht passenden Klammerpaar-Fehler eliminieren und ist darum sehr empfohlen. Es macht es möglich, die Struktur einer Partitur auf einen Blick zu verstehen, und alle nicht passenden Klammern erschließen sich schnell. Beachten Sie auch, dass das untere Notensystem mit eckigen Klammern erstellt wird, denn innerhalb dieses Systems brauchen wir zwei Stimmen, um die Noten darzustellen. Das obere System braucht nur einen einzigen musikalischen Ausdruck und ist deshalb von geschweiften Klammern umschlossen.)

Der \new-Befehl kann einem Kontext auch einen Namen zur Identifikation geben, um ihn von anderen Kontexten des selben Typs zu unterscheiden:

\new Typ = Name musikalischer Ausdruck

Beachten Sie den Unterschied zwischen der Bezeichnung des Kontexttyps (Staff, Voice, usw.) und dem Namen, der aus beliebigen Buchstaben bestehen kann und vom Benutzer frei erfunden werden kann. Zahlen und Leerzeichen können auch benutzt werden, in dem Fall muss der Name aber von doppelten Anführungszeichen umgeben werden, also etwa \new Staff = "Mein System 1" musikalischer Ausdruck. Der Name wird benutzt, um später auf genau diesen spezifischen Kontext zu verweisen. Dieses Vorgehen wurde schon in dem Abschnitt zu Gesangstexten angewandt, siehe Stimmen und Text.

Siehe auch

Notationsreferenz: Kontexte erstellen.

3.3.3 Was sind Engraver?

Jedes Zeichen des fertigen Notensatzes von LilyPond wird von einem Engraver (Stempel) produziert. Es gibt also einen Engraver, der die Systeme erstellt, einen, der die Notenköpfe ausgibt, einen für die Hälse, einen für die Balken usw. Insgesamt gibt es über 120 Engraver! Zum Glück braucht man für die meisten Partituren nur ein paar Engraver, und für einfache Partituren muss man eigentlich überhaupt nichts über sie wissen.

Engraver leben und wirken aus den Kontexten heraus. Engraver wie der Metronome_mark_engraver, dessen Aktion und Ausgabe sich auf die gesamte Partitur bezieht, wirken in der obersten Kontextebene – dem Score-Kontext.

Der Clef_engraver (Schlüssel-Stempel) und der Key_engraver (Vorzeichen-Stempel) finden sich in jedem Staff-Kontext, denn unterschiedliche Systeme könnten unterschiedliche Tonarten und Notenschlüssel brauchen.

Der Note_heads_engraver (Notenkopf-Stempel) und der Stem_engraver (Hals-Stempel) befinden sich in jedem Voice-Kontext, der untersten Kontextebene.

Jeder Engraver bearbeitet die bestimmten Objekte, die mit seiner Funktion assoziiert sind, und verwaltet die Eigenschaften dieser Funktion. Diese Eigenschaften, wie etwa die Eigenschaften, die mit Kontexten assoziiert sind, können verändert werden, um die Wirkungsweise des Engravers oder das Erscheinungsbild der von ihm produzierten Elemente in der Partitur zu ändern.

Alle Engraver haben zusammengesetzte Bezeichnung, die aus den (englischen) Wörtern ihrer Funktionsweise bestehen. Nur das erste Wort hat einen Großbuchstaben, und die restlichen Wörter werden mit einem Unterstrich angefügt. Ein Staff_symbol_engraver verantwortet also die Erstellung der Notenlinien, ein Clef_engraver entscheidet über die Art der Notenschlüssel und setzt die entsprechenden Symbole; damit wird gleichzeitig die Referenztonhöhe auf dem Notensystem festgelegt.

Hier die meistgebräuchlichen Engraver mit ihrer Funktion. Sie werden sehen, dass es mit etwas Englischkenntnissen einfach ist, die Funktion eines Engravers von seiner Bezeichnung abzuleiten.

Es soll später gezeigt werden, wie die LilyPond-Ausgabe verändert werden kann, indem die Wirkungsweise der Engraver beeinflusst wird.

Siehe auch

Referenz der Interna: Engravers and Performers.

3.3.4 Kontexteigenschaften verändern

Kontexte sind dafür verantwortlich, die Werte bestimmter Kontext-Eigenschaften zu speichern. Viele davon können verändert werden, um die Interpretation der Eingabe zu beeinflussen und die Ausgabe zu verändern. Kontexte werden mit dem \set-Befehl geändert. Er wird in Form

\set KontextBezeichnung.eigenschaftsBezeichnung = #Wert

verwendet, wobei KontextBezeichnung üblicherweise Score, Staff oder Voice ist. Der erste Teil kann auch ausgelassen werden; in diesem Fall wird der aktuelle Kontext (üblicherweise Voice) eingesetzt.

Die Bezeichnung von Kontexten-Eigenschaften besteht aus zwei Wörtern, die ohne Unterstrich oder Bindestrich verbunden sind. Alle außer dem ersten werden am Anfang groß geschrieben. Hier einige Beispiele der gebräuchlichsten Kontext-Eigenschaften. Es gibt sehr viel mehr.

Ein boolescher Wert ist entweder wahr (#t) oder falsch (#f), ein Integer eine positive ganze Zahl, ein Real (reelle Zahl) eine positive oder negative Dezimalzahl, und Text wird in doppelte Anführungszeichen (Shift+2) eingeschlossen. Beachten Sie das Vorkommen des Rautenzeichens (#) an unterschiedlichen Stellen: als Teil eines booleschen Wertes vor dem t oder f, aber auch vor einem Wert in der \set-Befehlskette. Wenn ein boolescher Wert eingegeben werden soll, braucht man also zwei Rautenzeichen, z. B. ##t.

Bevor eine Eigenschaft geändert werden kann, muss man wissen, in welchem Kontext sie sich befindet. Manchmal versteht das sich von selbst, aber in einigen Fällen kann es zunächst unverständlich erscheinen. Wenn der falsche Kontext angegeben wird, wird keine Fehlermeldung produziert, aber die Veränderung wird einfach nicht ausgeführt. instrumentName befindet sich offensichtlich innerhalb von einem Staff-Kontext, denn das Notensystem soll benannt werden. In dem folgenden Beispiel erhält das erste System korrekt die Instrumentenbezeichnung, das zweite aber nicht, weil der Kontext ausgelassen wurde.

<<
  \new Staff \relative c'' {
    \set Staff.instrumentName = #"Soprano"
    c2 c
 }
  \new Staff \relative c' {
    \set instrumentName = #"Alto"  % Wrong!
    d2 d
 }
>>

Denken Sie daran, dass der Standardkontext Voice ist; in dem zweiten \set-Befehl wird also die Eigenschaft instrumentName im Voice-Kontext auf „Alto“, gesetzt, aber weil LilyPond diese Eigenschaft nicht im Voice-Kontext vermutet, passiert einfach gar nichts. Das ist kein Fehler, und darum wird auch keine Fehlermeldung produziert.

Ebenso gibt es keine Fehlermeldung, wenn die Kontext-Bezeichnung falsch geschrieben wird und die Änderung also nicht ausgeführt werden kann. Tatsächlich kann eine beliebige (ausgedachte) Kontextbezeichnung mit dem \set-Befehl eingesetzt werden, genauso wie die, die wirklich existieren. Aber wenn LilyPond diese Bezeichnung nicht zuordnen kann, bewirkt der Befehl einfach gar nichts. Manche Editoren, die Unterstützung für LilyPond-Befehle mitbringen, markieren existierende Kontextbezeichnungen mit einem Punkt, wenn man mit der Maus darüber fährt (wie etwa JEdit mit dem LilyPondTool), oder markieren unbekannte Bezeichnungen anders (wie ConTEXT). Wenn Sie keinen Editor mit LilyPond-Unterstützung einsetzen, wird empfohlen, die Bezeichnungen in der Interna-Referenz zu überprüfen: siehe Tunable context properties, oder Contexts.

Die Eigenschaft instrumentName wird erst aktiv, wenn sie in einem Staff-Kontext gesetzt wird, aber manche Eigenschaften können in mehr als einem Kontext benutzt werden. Als Beispiel mag die extraNatural-Eigenschaft dienen, die zusätzliche Erniedrigungszeichen setzt. Die Standardeinstellung ist ##t (wahr) in allen Systemen. Wenn sie nur in einem Staff (Notensystem) auf ##f (falsch) gesetzt wird, wirkt sie sich auf alle Noten in diesem System aus. Wird sie dagegen in der Score-Umgebung gesetzt, wirkt sich das auf alle darin enthaltenen Systeme aus.

Das also bewirkt, dass die zusätzlichen Erniedrigungszeichen in einem System ausgeschaltet sind:

<<
  \new Staff \relative c'' {
    ais2 aes
  }
  \new Staff \relative c'' {
    \set Staff.extraNatural = ##f
    ais2 aes
  }
>>

während das dazu dient, sie in allen Systemen auszuschalten:

<<
  \new Staff \relative c'' {
    ais2 aes
  }
  \new Staff \relative c'' {
    \set Score.extraNatural = ##f
    ais2 aes
  }
>>

Ein anderes Beispiel ist die Eigenschaft clefOctavation: wenn sie im Score-Kontext gesetzt wird, ändert sich sofort der Wert der Oktavierung in allen aktuellen Systemen und wird auf einen neuen Wert gesetzt, der sich auf alle Systeme auswirkt.

Der gegenteilige Befehl, \unset, entfernt die Eigenschaft effektiv wieder von dem Kontext: in den meisten Fällen wird der Kontext auf ihre Standardeinstellungen zurückgesetzt. Normalerweise wird aber \unset nicht benötigt, denn ein neues \set erledigt alles, was man braucht.

Die \set- und \unset-Befehle könne überall im Eingabequelltext erscheinen und werden aktiv von dem Moment, an dem sie auftreten bis zum Ende der Partitur oder bis die Eigenschaft mit \set oder \unset neu gesetzt wird. Versuchen wir als Beispiel, die Schriftgröße mehrmals zu ändern, was sich unter anderem auf die Notenköpfe auswirkt. Die Änderung bezieht sich immer auf den Standard, nicht vom letzten gesetzten Wert.

c4 d
% make note heads smaller
\set fontSize = #-4
e4 f |
% make note heads larger
\set fontSize = #2.5
g4 a
% return to default size
\unset fontSize
b4 c |

Wir haben jetzt gesehen, wie sich die Werte von unterschiedlichen Eigenschaften ändern lassen. Beachten Sie, dass Integer und Zahlen immer mit einem Rautenzeichen beginnen, während die Werte wahr und falsch (mit ##t und ##f notiert) immer mit zwei Rauten beginnen. Eine Eigenschaft, die aus Text besteht, muss in doppelte Anführungsstriche gesetzt werden, auch wenn wir später sehen werden, dass Text auf eine sehr viel allgemeinere und mächtigere Art mit dem \markup-Befehl eingegeben werden kann.

Kontexteigenschaften mit \with setzen

Die Standardwerte von Kontexteigenschaften können zu dem Zeitpunkt definiert werden, an welchem der Kontext erstellt wird. Manchmal ist das eine saubere Weise, eine Eigenschaft zu bestimmen, die für die gesamte Partitur erhalten bleichen soll. Wenn ein Kontext mit einem \new-Befehl erstellt wird, können in einer direkt folgenden \with { .. }-Umgebung die Eigenschaften bestimmt werden. Wenn also die zusätzlichen Auflösungszeichen für eine ganze Partitur gelten sollen, könnte man schreiben:

\new Staff \with { extraNatural = ##f }

etwa so:

<<
  \new Staff
    \relative c'' {
      gis4 ges aes ais
    }
  \new Staff \with { extraNatural = ##f } {
    \relative c'' {
      gis ges aes ais
    }
  }
>>

Eigenschaften, die auf diese Arte gesetzt werden, können immer noch dynamisch mit dem \set-Befehl geändert werden und mit \unset auf ihre Standardeinstellungen zurückgesetzt werden, wie sie vorher in der \with-Umgebung definiert wurden.

Wenn also die fontSize-Eigenschaft in einer \with-Umgebung definiert wird, wird der Standardwert für die Schriftgröße festgelegt. Wenn dieser Wert später mit \set verändert wird, kann dieser neue Standardwert mit dem Befehl \unset fontSize wieder erreicht werden.

Kontexteigenschaften mit \context setzen

Die Werte von Kontext-Eigenschaften können in allen Kontexten eines bestimmten Typs (etwa alle Staff-Kontexte) gleichzeitig mit einem Befehl gesetzt werden. Der Kontext wird spezifiziert, indem seine Bezeichnung benutzt wird, also etwa Staff, mit einem Backslash davor: \Staff. Der Befehl für die Eigenschaft ist der gleiche, wie er auch in der \with-Konstruktion benutzt wird, wie oben gezeigt. Er wird in eine \context-Umgebung eingebettet, welche wiederum innerhalb von einer \layout-Umgebung steht. Jede \context-Umgebung wirkt sich auf alle Kontexte dieses Types aus, welche sich in der aktuellen Partitur befinden (d. h. innerhalb einer \score- oder \book-Umgebung). Hier ist ein Beispiel, wie man diese Funktion anwendet:

\score {
  \new Staff {
    \relative c'' {
      cis4 e d ces
    }
  }
  \layout {
    \context {
      \Staff
      extraNatural = ##t
    }
  }
}

Wenn die Veränderung der Eigenschaft sich auf alle Systeme einer score-Umgebung beziehen soll:

\score {
  <<
    \new Staff {
      \relative c'' {
        gis4 ges aes ais
      }
    }
    \new Staff {
      \relative c'' {
        gis4 ges aes ais
      }
    }
  >>
  \layout {
    \context {
      \Score extraNatural = ##f
    }
  }
}

Kontext-Eigenschaften, die auf diese Weise gesetzt werden, können für bestimmten Kontexte überschrieben werden, indem die \with-Konstruktion eingesetzt wird, oder mit \set-Befehlen innerhalb der aktuellen Noten.

Siehe auch

Notationsreferenz: Die Standardeinstellungen von Kontexten ändern, Der set-Befehl.

Referenz der Interna: Contexts, Tunable context properties.

3.3.5 Engraver hinzufügen und entfernen

Wir haben gesehen, dass jeder Kontext eine Anzahl an Engravern (Stempeln) beinhaltet, von denen ein jeder einen bestimmten Teil des fertigen Notensatzes produziert, wie z. B. Taktlinien, Notenlinien, Notenköpfe, Hälse usw. Wenn ein Engraver aus einem Kontext entfernt wird, kann er seine Objekte nicht länger produzieren. Das ist eine eher grobe Methode, die Notenausgabe zu beeinflussen, aber es kann von großem Nutzen sein.

Einen einzelnen Kontext verändern

Um einen Engraver von einem einzelnen Kontext zu entfernen, wir der \with-Befehl eingesetzt, direkt hinter den Befehl zur Kontext-Erstellung geschrieben, wie in dem vorigen Abschnitt gezeigt.

Als ein Beispiel wollen wir das Beispiel aus dem letzten Abschnitt produzieren, aber die Notenlinien entfernen. Erinnern Sie sich, dass die Notenlinien vom Staff_symbol_engraver erstellt werden.

\new Staff \with {
  \remove Staff_symbol_engraver
}
\relative c' {
  c4 d
  \set fontSize = #-4  % make note heads smaller
  e4 f |
  \set fontSize = #2.5  % make note heads larger
  g4 a
  \unset fontSize  % return to default size
  b4 c |
}

Engraver können auch zu einem bestimmten Kontext hinzugefügt werden. Dies geschieht mit dem Befehl

\consists Engraver_bezeichnung

welcher auch wieder innerhalb der \with-Umgebung gesetzt wird. Einige Chorpartituren zeigen einen Ambitus direkt zu Beginn der ersten Notenzeile, um den Stimmumfang des Stückes anzuzeigen, siehe auch ambitus. Der Ambitus wird vom Ambitus_engraver erstellt, der normalerweise in keinem Kontext enthalten ist. Wenn wir ihn zum Voice-Kontext hinzufügen, errechnet er automatisch den Stimmumfang für diese einzelne Stimme und zeigt ihn an:

\new Staff <<
  \new Voice \with {
    \consists Ambitus_engraver
  } {
    \relative c'' {
      \voiceOne
      c4 a b g
    }
  }
  \new Voice {
    \relative c' {
      \voiceTwo
      c4 e d f
    }
  }
>>

wenn wir den Ambitus-Engraver allerdings zum Staff-Kontext hinzufügen, wird der Stimmumfang aller Stimmen in diesem Notensystem errechnet:

\new Staff \with {
  \consists Ambitus_engraver
}
<<
  \new Voice {
    \relative c'' {
      \voiceOne
      c4 a b g
    }
  }
  \new Voice {
    \relative c' {
      \voiceTwo
      c4 e d f
    }
  }
>>

Alle Kontexte des gleichen Typs verändern

Die vorigen Beispiele zeigen, wie man Engraver in einem bestimmten Kontext hinzufügen oder entfernen kann. Es ist auch möglich, Engraver in jedem Kontext eines bestimmten Typs hinzuzufügen oder zu entfernen. Dazu werden die Befehle in dem entsprechenden Kontext in einer \layout-Umgebung gesetzt. Wenn wir also z. B. den Ambitus für jedes Notensystem in einer Partitur mit vier Systemen anzeigen wollen, könnte das so aussehen:

\score {
  <<
    \new Staff {
      \relative c'' {
        c4 a b g
      }
    }
    \new Staff {
      \relative c' {
        c4 a b g
      }
    }
    \new Staff {
      \clef "G_8"
      \relative c' {
        c4 a b g
      }
    }
    \new Staff {
      \clef "bass"
      \relative c {
        c4 a b g
      }
    }
  >>
  \layout {
    \context {
      \Staff
      \consists Ambitus_engraver
    }
  }
}

Die Werte der Kontext-Eigenschaften können auch für alle Kontexte eines bestimmten Typs auf die gleiche Weise geändert werden, indem der \set-Befehl in einer \context-Umgebung angewendet wird.

Siehe auch

Notationsreferenz: Umgebungs-Plugins verändern, Die Standardeinstellungen von Kontexten ändern.

3.4 Erweiterung der Beispiele

Sie haben sich durch die Übung gearbeitet, Sie wissen jetzt, wie Sie Notensatz produzieren, und Sie haben die grundlegenden Konzepte verstanden. Aber wie erhalten Sie genau die Systeme, die Sie brauchen? Es gibt eine ganze Anzahl an fertigen Vorlagen (siehe Vorlagen), mit denen Sie beginnen können. Aber was, wenn Sie nicht genau das finden, was Sie brauchen? Lesen Sie weiter.

3.4.1 Sopran und Cello

Beginnen Sie mit der Vorlage, die Ihren Vorstellungen am nächsten kommt. Nehmen wir einmal an, Sie wollen ein Stück für Sopran und Cello schreiben. In diesem Fall könnten Sie mit der Vorlage „Noten und Text“ (für die Sopran-Stimme) beginnen.

\version "2.13.45"
melody = \relative c' {
  \clef "treble"
  \key c \major
  \time 4/4
  a4 b c d
}

text = \lyricmode {
  Aaa Bee Cee Dee
}

\score {
  <<
    \new Voice = "one" {
      \autoBeamOff
      \melody
    }
    \new Lyrics \lyricsto "one" \text
  >>
  \layout { }
  \midi { }
}

Jetzt wollen wir die Cello-Stimme hinzufügen. Schauen wir uns das Beispiel „Nur Noten“ an:

\version "2.13.45"

melody = \relative c' {
  \clef "treble"
  \key c \major
  \time 4/4
  a4 b c d
}

\score {
  \new Staff \melody
  \layout { }
  \midi { }
}

Wir brauchen den \version-Befehl nicht zweimal. Wir brauchen aber den melody-Abschnitt. Wir wollen keine zwei \score (Partitur)-Abschnitte – mit zwei \score-Abschnitten würden wir zwei Stimmen getrennt voneinander erhalten. In diesem Fall wollen wir sie aber zusammen, als Duett. Schließlich brauchen wir innerhalb des \score-Abschnittes nur einmal die Befehle \layout und \midi.

Wenn wir jetzt einfach zwei melody-Abschnitte in unsere Datei kopieren würden, hätten wir zwei melody-Variable. Das würde zu keinem Fehler führen, aber die zweite von ihnen würde für beide Melodien eingesetzt werden. Wir müssen ihnen also andere Bezeichnungen zuweisen, um sie voneinander zu unterscheiden. Nennen wir die Abschnitte also SopranNoten für den Sopran und CelloNoten für die Cellostimme. Wenn wir schon dabei sind, können wir textauch nach SoprText umbenennen. Denken Sie daran, beide Vorkommen der Bezeichnung zu ändern: einmal die Definition gleich am Anfang (melody = \relative c' { ) und dann auch noch die Benutzung der Variable innerhalb des \score-Abschnittes.

Gleichzeitig können wir auch noch das Notensystem für das Cello ändern – das Cello hat normalerweise einen Bassschlüssel. Wir ändern auch die Noten etwas ab.

\version "2.13.45"

SopranNoten = \relative c' {
  \clef "treble"
  \key c \major
  \time 4/4
  a4 b c d
}

SoprText = \lyricmode {
  Aaa Bee Cee Dee
}

CelloNoten = \relative c {
  \clef "bass"
  \key c \major
  \time 4/4
  d4 g fis8 e d4
}

\score {
  <<
    \new Voice = "eins" {
      \autoBeamOff
      \SopranNoten
    }
    \new Lyrics \lyricsto "eins" \Soprantext
  >>
  \layout { }
  \midi { }
}

Das sieht schon vielversprechend aus, aber die Cello-Stimme erscheint noch nicht im Notensatz – wir haben vergessen, sie in den \score-Abschnitt einzufügen. Wenn die Cello-Stimme unterhalb des Soprans erscheinen soll, müssen wir

\new Staff \CelloNoten

unter dem Befehl für den Sopran hinzufügen. Wir brauchen auch die spitzen Klammern (<< und >>) um die Noten, denn damit wird LilyPond mitgeteilt, dass mehr als ein Ereignis gleichzeitig stattfindet (in diesem Fall sind es zwei Staff-Instanzen). Der \score-Abschnitt sieht jetzt so aus:

\score {
  <<
    <<
      \new Voice = "eins" {
        \autoBeamOff
        \SopranNoten
      }
      \new Lyrics \lyricsto "eins" \SoprText
    >>
    \new Staff \CelloNoten
  >>
  \layout { }
  \midi { }
}

Das sieht etwas unschön aus, vor allem die Einrückung stimmt nicht mehr. Das können wir aber schnell in Ordnung bringen. Hier also die gesamte Vorlage für Sopran und Cello:

\version "2.13.45"

sopranoMusic = \relative c' {
  \clef "treble"
  \key c \major
  \time 4/4
  a4 b c d
}

sopranoLyrics = \lyricmode {
  Aaa Bee Cee Dee
}

celloMusic = \relative c {
  \clef "bass"
  \key c \major
  \time 4/4
  d4 g fis8 e d4
}

\score {
  <<
    <<
      \new Voice = "one" {
        \autoBeamOff
        \sopranoMusic
      }
      \new Lyrics \lyricsto "one" \sopranoLyrics
    >>
    \new Staff \celloMusic
  >>
  \layout { }
  \midi { }
}

Siehe auch

Die Vorlagen, mit denen wir begonnen haben, können im Anhang „Vorlagen“ gefunden werden, siehe Ein einzelnes System.

3.4.2 Vierstimmige SATB-Partitur

Die meisten Partituren für vierstimmigen gemischten Chor mit Orchesterbegleitung (wie etwa Mendelssohns Elias oder Händels Messias) sind so aufgebaut, dass für jede der vier Stimmen ein eigenes System besteht und die Orchesterbegleitung dann als Klavierauszug darunter notiert wird. Hier ein Beispiel aus Händels Messias:

Keine der Vorlage bietet diesen Aufbau direkt an. Die Vorlage, die am nächsten daran liegt, ist „SATB-Partitur und automatischer Klavierauszug“, siehe Vokalensemble. Wir müssen diese Vorlage aber so anpassen, dass die Noten für das Klavier nicht automatisch aus dem Chorsatz generiert werden. Die Variablen für die Noten und den Text des Chores sind in Ordnung, wir müssen nun noch Variablen für die Klaviernoten hinzufügen.

Die Reihenfolge, in welcher die Variablen in das Chorsystem (ChoirStaff) eingefügt werden, entspricht nicht der in dem Beispiel oben. Wir wollen sie so sortieren, dass die Texte jeder Stimme direkt unter den Noten notiert werden. Alle Stimmen sollten als \voiceOne notiert werden, welches die Standardeinstellung ist; wir können also die \voiceXXX-Befehle entfernen. Wir müssen auch noch den Schlüssel für den Tenor ändern. Die Methode, mit der der Text den Stimmen zugewiesen wird, ist uns noch nicht bekannt, darum wollen wir sie umändern auf die Weise, die wir schon kennen. Wir fügen auch noch Instrumentbezeichnungen zu den Systemen hinzu.

Damit erhalten wir folgenden ChoirStaff:

\new ChoirStaff <<
  \new Staff = "sopranos" <<
    \set Staff.instrumentName = #"Sopran"
    \new Voice = "sopranos" {
      \global
      \sopranoMusic
    }
  >>
  \new Lyrics \lyricsto "sopranos" {
    \sopranoWords
  }
  \new Staff = "altos" <<
    \set Staff.instrumentName = #"Alt"
    \new Voice = "altos" {
      \global
      \altoMusic
    }
  >>
  \new Lyrics \lyricsto "altos" {
    \altoWords
  }
  \new Staff = "tenors" <<
    \set Staff.instrumentName = #"Tenor"
    \new Voice = "tenors" {
      \global
      \tenorMusic
    }
  >>
  \new Lyrics \lyricsto "tenors" {
    \tenorWords
  }
  \new Staff = "basses" <<
    \set Staff.instrumentName = #"Bass"
    \new Voice = "basses" {
      \global
      \bassMusic
    }
  >>
  \new Lyrics \lyricsto "basses" {
    \bassWords
  }
>>  % end ChoirStaff

Als nächstes müssen wir das Klaviersystem bearbeiten. Das ist einfach: wir nehmen einfach den Klavierteil aus der „Piano solo“-Vorlage:

\new PianoStaff <<
  \set PianoStaff.instrumentName = #"Piano  "
  \new Staff = "oben" \oben
  \new Staff = "unten" \unten
>>

und fügen die Variablen oben und unten hinzu.

Das Chorsystem und das Pianosystem müssen mit spitzen Klammern kombiniert werden, damit beide übereinander erscheinen:

<<  % ChoirStaff und PianoStaff parallel kombinieren
  \new ChoirStaff <<
    \new Staff = "sopranos" <<
      \new Voice = "sopranos" {
        \global
        \sopranoMusic
      }
    >>
    \new Lyrics \lyricsto "sopranos" {
      \sopranoWords
     }
    \new Staff = "altos" <<
      \new Voice = "altos" {
        \global
        \altoMusic
      }
    >>
    \new Lyrics \lyricsto "altos" {
      \altoWords
    }
    \new Staff = "tenors" <<
      \clef "G_8"  % tenor clef
      \new Voice = "tenors" {
        \global
        \tenorMusic
      }
    >>
    \new Lyrics \lyricsto "tenors" {
      \tenorWords
    }
    \new Staff = "basses" <<
      \clef "bass"
      \new Voice = "basses" {
        \global
        \bassMusic
      }
    >>
    \new Lyrics \lyricsto "basses" {
      \bassWords
    }
  >>  % end ChoirStaff

  \new PianoStaff <<
    \set PianoStaff.instrumentName = #"Piano"
    \new Staff = "upper" \upper
    \new Staff = "lower" \lower
  >>
>>

Alles miteinander kombiniert und mit den Noten für drei Takte sieht unser Beispiel nun so aus:

\version "2.13.45"

global = {
  \key d \major
  \time 4/4
}
sopranoMusic = \relative c'' {
  \clef "treble"
  r4 d2 a4 | d4. d8 a2 | cis4 d cis2 |
}
sopranoWords = \lyricmode {
  Wor -- thy | is the lamb | that was slain |
}
altoMusic = \relative a' {
  \clef "treble"
  r4 a2 a4 | fis4. fis8 a2 | g4 fis fis2 |
}
altoWords = \sopranoWords
tenorMusic = \relative c' {
  \clef "G_8"
  r4 fis2 e4 | d4. d8 d2 | e4 a, cis2 |
}
tenorWords = \sopranoWords
bassMusic = \relative c' {
  \clef "bass"
  r4 d2 cis4 | b4. b8 fis2 | e4 d a'2 |
}
bassWords = \sopranoWords
upper = \relative a' {
  \clef "treble"
  \global
  r4 <a d fis>2 <a e' a>4
  <d fis d'>4. <d fis d'>8 <a d a'>2
  <g cis g'>4 <a d fis> <a cis e>2
}
lower = \relative c, {
  \clef "bass"
  \global
  <d d'>4 <d d'>2 <cis cis'>4
  <b b'>4. <b' b'>8 <fis fis'>2
  <e e'>4 <d d'> <a' a'>2
}

\score {
  <<  % combine ChoirStaff and PianoStaff in parallel
    \new ChoirStaff <<
      \new Staff = "sopranos" <<
        \set Staff.instrumentName = #"Soprano"
        \new Voice = "sopranos" {
          \global
          \sopranoMusic
        }
      >>
      \new Lyrics \lyricsto "sopranos" {
        \sopranoWords
      }
      \new Staff = "altos" <<
        \set Staff.instrumentName = #"Alto"
        \new Voice = "altos" {
          \global
          \altoMusic
        }
      >>
      \new Lyrics \lyricsto "altos" {
        \altoWords
      }
      \new Staff = "tenors" <<
        \set Staff.instrumentName = #"Tenor"
        \new Voice = "tenors" {
          \global
          \tenorMusic
        }
      >>
      \new Lyrics \lyricsto "tenors" {
        \tenorWords
      }
      \new Staff = "basses" <<
        \set Staff.instrumentName = #"Bass"
        \new Voice = "basses" {
          \global
          \bassMusic
        }
      >>
      \new Lyrics \lyricsto "basses" {
        \bassWords
      }
    >>  % end ChoirStaff

    \new PianoStaff <<
      \set PianoStaff.instrumentName = #"Piano  "
      \new Staff = "upper" \upper
      \new Staff = "lower" \lower
    >>
  >>
}

3.4.3 Eine Partitur von Grund auf erstellen

Wenn Sie einige Fertigkeit im Schreiben von LilyPond-Code gewonnen haben, werden Sie vielleicht feststellen, dass es manchmal einfacher ist, von Grund auf anzufangen, anstatt die fertigen Vorlagen zu verändern. Auf diese Art könne Sie auch Ihren eigenen Stil entwickeln, und ihn der Musik anpassen, die Sie notieren wollen. Als Beispiel wollen wir demonstrieren, wie man die Partitur für ein Orgelpreludium von Grund auf konstruiert.

Beginnen wir mit dem Kopf, dem header-Abschnitt. Hier notieren wir den Titel, den Namen des Komponisten usw. Danach schreiben wir die einzelnen Variablen auf und schließlich am Ende die eigentliche Partitur, den \score-Abschnitt. Beginnen wir mit einer groben Struktur, in die wir dann die Einzelheiten nach und nach eintragen.

Als Beispiel benutzen wir zwei Takte aus dem Orgelpreludium Jesu, meine Freude von J. S. Bach, notiert für zwei Manuale und Pedal. Sie können die Noten am Ende dieses Abschnittes sehen. Das obere Manual trägt zwei Stimmen, das untere und das Pedalsystem jeweils nur eine. Wir brauchen also vier Variablen für die Noten und eine, um Taktart und Tonart zu definieren.

\version "2.13.45"
\header {
  title = "Jesu, meine Freude"
  composer = "J. S. Bach"
}
keyTime = { \key c \minor \time 4/4 }
ManualOneVoiceOneMusic = { s1 }
ManualOneVoiceTwoMusic = { s1 }
ManualTwoMusic = { s1 }
PedalOrganMusic = { s1 }

\score {
}

Im Moment haben wir eine unsichtbare Note in jede Stimme eingesetzt (s1). Die Noten werden später hinzugefügt.

Als nächstes schauen wir uns an, was in die Partitur (die \score-Umgebung) kommt. Dazu wird einfach die Notensystemstruktur konstruiert, die wir benötigen. Orgelmusik wird meistens auf drei Systemen notiert, eins für jedes Manual und ein drittes für die Pedalnoten. Die Systeme für die Manuale werden mit einer geschweiften Klammer verbunden, wir benutzen hier also ein PianoStaff. Das erste Manualsystem braucht zwei Stimmen, das zweite nur eine.

\new PianoStaff <<
  \new Staff = "ManualOne" <<
    \new Voice {
      \ManualOneVoiceOneMusic
    }
    \new Voice {
      \ManualOneVoiceTwoMusic
    }
  >>  % Ende ManualOne Systemkontext
  \new Staff = "ManualTwo" <<
    \new Voice {
      \ManualTwoMusic
    }
  >>  % Ende ManualTwo Systemkontext
>>  % Ende PianoStaff Kontext

Als nächstes soll das System für das Pedal hinzugefügt werden. Es soll unter das Klaviersystem gesetzt werden, aber muss gleichzeitig mit ihm erscheinen. Wir brauchen also spitze Klammern um beide Definitionen. Sie wegzulassen würde eine Fehlermeldung in der Log-Datei hervorrufen. Das ist ein sehr häufiger Fehler, der wohl auch Ihnen früher oder später unterläuft. Sie können das fertige Beispiel am Ende des Abschnittes kopieren und die Klammern entfernen, um zu sehen, wie die Fehlermeldung aussehen kann, die Sie in solch einem Fall erhalten würden.

<<  % PianoStaff and Pedal Staff must be simultaneous
  \new PianoStaff <<
    \new Staff = "ManualOne" <<
      \new Voice {
        \ManualOneVoiceOneMusic
      }
      \new Voice {
        \ManualOneVoiceTwoMusic
      }
    >>  % end ManualOne Staff context
    \new Staff = "ManualTwo" <<
      \new Voice {
        \ManualTwoMusic
      }
    >>  % end ManualTwo Staff context
  >>  % end PianoStaff context
  \new Staff = "PedalOrgan" <<
    \new Voice {
      \PedalOrganMusic
    }
  >>
>>

Es ist nicht notwendig, die simultane Konstruktion << .. >> innerhalb des zweiten Manualsystems und des Pedalsystems zu benutzen, denn sie enthalten nur eine Stimme. Andererseits schadet es nichts, sie zu schreiben, und es ist eine gute Angewohnheit, immer die spitzen Klammern nach einem \new Staff zu schreiben, wenn mehr als eine Stimme vorkommen könnten. Für Stimmen (Voice) dagegen gilt genau das Gegenteil: eine neue Stimme sollte immer von geschweiften Klammern ({ .. }) gefolgt werden, falls Sie ihre Noten in mehrere Variable aufteilen, die nacheinander gesetzt werden sollen.

Fügen wir also diese Struktur zu der \score-Umgebung hinzu und bringen wir die Einzüge in Ordnung. Gleichzeitig wollen wir die richtigen Schlüssel setzen und die Richtung der Hälse und Bögen in den Stimmen des oberen Systems kontrollieren, indem die obere Stimme ein \voiceOne, die untere dagegen ein \voiceTwo erhält. Die Taktart und Tonart werden mit unserer fertigen Variable \keyTime eingefügt.

\score {
  <<  % PianoStaff and Pedal Staff must be simultaneous
    \new PianoStaff <<
      \new Staff = "ManualOne" <<
        \keyTime  % set time signature and key
        \clef "treble"
        \new Voice {
          \voiceOne
          \ManualOneVoiceOneMusic
        }
        \new Voice {
          \voiceTwo
          \ManualOneVoiceTwoMusic
        }
      >>  % end ManualOne Staff context
      \new Staff = "ManualTwo" <<
        \keyTime
        \clef "bass"
        \new Voice {
          \ManualTwoMusic
        }
      >>  % end ManualTwo Staff context
    >>  % end PianoStaff context
    \new Staff = "PedalOrgan" <<
      \keyTime
      \clef "bass"
      \new Voice {
        \PedalOrganMusic
      }
    >>  % end PedalOrgan Staff
  >>
}  % end Score context

Das Layout des Orgelsystems oben ist fast perfekt, es hat jedoch einen kleinen Fehler, den man nicht bemerken kann, wenn man nur ein einzelnes System betrachtet: Der Abstand des Pedalsystems zum System der linken Hand sollte in etwa der gleiche sein wie der Abstand zwischen den Systemen der linken und rechten Hand. Die Dehnbarkeit von Systemen in einem Klaviersystem (PianoStaff)-Kontext ist beschränkt (sodass der Abstand zwischen den Systemen der linken und rechten Hand nicht zu groß wird), und das Pedalsystem sollte sich genauso verhalten.

Die Spreizbarkeit von Systemen kann mit der nex-staff-spacing-Eigenschaft des VerticalAxisGroup-„graphischen Objekts“ (üblicherweise als „Grob“ innerhalb der LilyPond-Dokumentation bezeichnet) kontrolliert werden. An dieser Stelle brauchen Sie sich um die Details nicht zu sorgen, sie werden später erklärt. Sehr neugierigen können sich den Abschnitt Overview of modifying properties anschauen. Im Moment kann man nicht nur die strechability-Untereigenschaft verändern, darum müssen hier auch die anderen Untereigenschaften kopiert werden. Die Standardeinstellungen dieser Untereigenschaften finden sich in der Datei ‘scm/define-grobs.scm’ in den Definitionen für den VerticalAxisGroup-Grob. Der Wert für strechability wird aus der Definition für das Klaviersystem (PianoStaff) entnommen (in der Datei ‘ly/engraver-init.ly’) sodass die Werte identisch sind.

\score {
  <<  % PianoStaff and Pedal Staff must be simultaneous
    \new PianoStaff <<
      \new Staff = "ManualOne" <<
        \keyTime  % set key and time signature
        \clef "treble"
        \new Voice {
          \voiceOne
          \ManualOneVoiceOneMusic
        }
        \new Voice {
          \voiceTwo
          \ManualOneVoiceTwoMusic
        }
      >>  % end ManualOne Staff context
      \new Staff = "ManualTwo" \with {
        \override VerticalAxisGroup
          #'staff-staff-spacing = #'((basic-distance . 9)
                                     (minimum-distance . 8)
                                     (padding . 1)
                                     (stretchability . 5))
      } <<
        \keyTime
        \clef "bass"
        \new Voice {
          \ManualTwoMusic
        }
      >>  % end ManualTwo Staff context
    >>  % end PianoStaff context
    \new Staff = "PedalOrgan" <<
      \keyTime
      \clef "bass"
      \new Voice {
        \PedalOrganMusic
      }
    >>  % end PedalOrgan Staff
  >>
}  % end Score context

Damit ist das Grundgerüst fertig. Jede Orgelmusik mit drei Systemen hat die gleiche Struktur, auch wenn die Anzahl der Stimmen in einem System sich ändern kann. Jetzt müssen wir nur noch die Noten einfügen und alle Teile zusammenfügen, indem wir die Variablen mit einem Backslash in die Partitur einbauen.

\version "2.13.45"

\header {
  title = "Jesu, meine Freude"
  composer = "J S Bach"
}
keyTime = { \key c \minor \time 4/4 }
ManualOneVoiceOneMusic = \relative g' {
  g4 g f ees |
  d2 c2 |
}
ManualOneVoiceTwoMusic = \relative c' {
  ees16 d ees8~ ees16 f ees d c8 d~ d c~ |
  c8 c4 b8 c8. g16 c b c d |
}
ManualTwoMusic = \relative c' {
  c16 b c8~ c16 b c g a8 g~ g16 g aes ees |
  f16 ees f d g aes g f ees d e8~ ees16 f ees d |
}
PedalOrganMusic = \relative c {
  r8 c16 d ees d ees8~ ees16 a, b g c b c8 |
  r16 g ees f g f g8 c,2 |
}

\score {
  <<  % PianoStaff and Pedal Staff must be simultaneous
    \new PianoStaff <<
      \new Staff = "ManualOne" <<
        \keyTime  % set time signature and key
        \clef "treble"
        \new Voice {
          \voiceOne
          \ManualOneVoiceOneMusic
        }
        \new Voice {
          \voiceTwo
          \ManualOneVoiceTwoMusic
        }
      >>  % end ManualOne Staff context
      \new Staff = "ManualTwo" \with {
        \override VerticalAxisGroup
          #'staff-staff-spacing = #'((basic-distance . 9)
                                     (minimum-distance . 8)
                                     (padding . 1)
                                     (stretchability . 5))
      } <<
        \keyTime
        \clef "bass"
        \new Voice {
          \ManualTwoMusic
        }
      >>  % end ManualTwo Staff context
    >>  % end PianoStaff context
    \new Staff = "PedalOrgan" <<
      \keyTime
      \clef "bass"
      \new Voice {
        \PedalOrganMusic
      }
    >>  % end PedalOrgan Staff context
  >>
}  % end Score context

Siehe auch

Glossar: system.

3.4.4 Tipparbeit durch Variablen und Funktionen ersparen

Bis jetzt wurde immer derartige Notation vorgestellt:

hornNotes = \relative c'' { c4 b dis c }

\score {
  {
    \hornNotes
  }
}

Sie können sich vorstellen, dass das etwa für minimalistische Musik sehr nützlich sein könnte:

fragmentA = \relative c'' { a4 a8. b16 }
fragmentB = \relative c'' { a8. gis16 ees4 }
violin = \new Staff {
  \fragmentA \fragmentA |
  \fragmentB \fragmentA |
}

\score {
  {
    \violin
  }
}

Diese Variablen (die man auch als Makros oder Benutzer-Befehl bezeichnet) können jedoch auch für eigene Anpassungen eingesetzt werden:

dolce = \markup { \italic \bold dolce }
padText = { \once \override TextScript #'padding = #5.0 }
fthenp=_\markup {
    \dynamic f \italic \small { 2nd } \hspace #0.1 dynamic p
}

violin = \relative c'' {
  \repeat volta 2 {
    c4._\dolce b8 a8 g a b
    \padText
    c4.^"hi there!" d8 e' f g d
    c,4.\fthenp b8 c4 c-.
  }
}

\score {
  {
    \violin
  }
  \layout{ragged-right=##t}
}

Derartige Variablen sind offensichtlich sehr nützlich, zu Tipparbeit zu ersparen. Aber es lohnt sich schon, sie zu benutzen, wenn man sie nur einmal benutzen will, denn sie vereinfachen die Struktur einer Datei sehr stark. Hier das vorige Beispiel ohne jede Benutzung von Variablen. Es ist sehr viel schwerer lesbar, besonders die letzte Zeile.

violin = \relative c'' {
  \repeat volta 2 {
    c4._\markup { \italic \bold dolce } b8 a8 g a b
    \once \override TextScript #'padding = #5.0
    c4.^"hi there!" d8 e' f g d
    c,4.\markup {
      \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
    }
    b8 c4 c-. |
  }
}

Bisher haben wir vor allem statische Ersetzungen betrachtet: wenn LilyPond etwa \padText sieht, wird es ersetzt mit all dem Code, mit dem wir es definiert haben (also alles, was sich rechts von padtext= befindet).

LilyPond kann auch nicht-statische Ersetzungen bewältigen. Man kann sie sich als Funktionen vorstellen.

padText =
#(define-music-function
     (parser location padding)
     (number?)
   #{
     \once \override TextScript #'padding = $padding
   #})

\relative c''' {
  c4^"piu mosso" b a b |
  \padText #1.8
  c4^"piu mosso" d e f |
  \padText #2.6
  c4^"piu mosso" fis a g |
}

Die Benutzung von Variablen ist auch eine gute Möglichkeit, Arbeit zu vermeiden, wenn sich einmal die Syntax von LilyPond ändern sollte (siehe auch with convert-ly Updating old input files with convert-ly). Wenn man eine einzige Definition hat (wie etwa \dolce), die für alle Vorkommen in der Notation eingesetzt wird, muss man auch nur einmal diese Definition aktualisieren, anstatt dass man sie in jeder ‘.ly’-Datei einzeln ändern müsste.

3.4.5 Partitur und Stimmen

In Orchestermusik werden alle Noten zweimal gedruckt. Einmal in einer Stimme für die Spieler, und einmal ein der Partitur für den Dirigenten. Variablen können benutzen, um sich doppelte Arbeit zu ersparen. Die Noten werden nur einmal eingegeben und in einer Variable abgelegt. Der Inhalt der Variable wird dann benutzt um sowohl die Stimme als auch die Partitur zu erstellen.

Es bietet sich an, die Noten in einer extra Datei abzulegen. Nehmen wir an, dass die Datei ‘horn-music.ly’ folgende Noten eines Horn/Fagott-Duos enthält:

hornNotes = \relative c {
  \time 2/4
  r4 f8 a | cis4 f | e4 d |
}

Eine Stimme wird also erstellt, indem man folgendes in eine Datei schreibt:

\include "horn-music.ly"

\header {
  instrument = "Horn in F"
}

{
 \transpose f c' \hornNotes
}

Die Zeile

\include "horn-music.ly"

ersetzt den Inhalt von ‘horn-music.ly’ an dieser Position in der Datei, sodass hornNotes im Folgenden definiert ist. Der Befehl \transpose f c' zeigt an, dass das Argument (\hornNotes) eine Quinte nach oben transponiert werden soll. Klingendes f wird als c', wie es die Stimmung eines normalen F-Hornes verlangt. Die Transposition kann in folgender Notenausgabe gesehen werden:

In Ensemblestücken sind manche Stimmen für viele Takte stumm. Das wird durch eine besondere Pause notiert, die Mehrtaktpause. Sie wird mit einem großen R notiert, gefolgt von der Dauer (1 für eine Ganze, 2 für eine Halbe usw.). Indem man die Dauern multipliziert, kann man auch längere Dauern erzeugen. Diese Pause etwa dauert drei Takte in einem 2/4-Takt:

R2*3

Wenn die Stimme gesetzt wird, werden Mehrtaktpausen komprimiert. Das geschieht, indem man folgendes in die Datei schreibt:

\set Score.skipBars = ##t

Dieser Befehl setzt die Eigenschaft skipBars im Score-Kontext auf wahr (##t). Die Pause und diese Option zu der Musik von oben hinzugefügt, ergibt folgendes Beispiel:

Die Partitur wird erstellt, indem man alle Noten kombiniert. Angenommen, die andere Stimme ist in bassoonNotes in der Datei ‘bassoon-music.ly’ definiert, würde eine Partitur erstellt mit:

\include "bassoon-music.ly"
\include "horn-music.ly"

<<
  \new Staff \hornNotes
  \new Staff \bassoonNotes
>>

woraus sich ergibt:

4. Die Ausgabe verändern

In diesem Kapitel wird erklärt, wie man die Notenausgabe verändern kann. In LilyPond kann man sehr viel konfigurieren, fast jedes Notenfragment kann geändert werden.

4.1 Grundlagen für die Optimierung

4.1.1 Grundlagen zur Optimierung

„Optimierung“ (engl. tweaking) ist ein LilyPond-Begriff für die verschiedenen Methoden, die Aktionen zu beeinflussen, die während der Kompilation einer Notationsdatei vorgenommen werden sowie auf das Notenbild einzuwirken. Einige dieser Optimierungen sind sehr einfach, andere dagegen recht komplex. Aber insgesamt erlaubt das System an Optimierungen so gut wie alle möglichen Erscheinungsformen für die Notenausgabe.

In diesem Abschnitt werden die grundlegenden Konzepte vorgestellt, um die Optimierung zu verstehen. Später soll eine Anzahl von fertigen Befehlen bereitgestellt werden, die einfach in die Quelldatei kopiert werden können um den selben Effekt wie im Beispiel zu erhalten. Gleichzeitig zeigen diese Beispiele, wie die Befehle konstruiert werden, so dass Sie in der Lage sein werden, eigene Befehle auf dieser Grundlage zu entwickeln.

Bevor Sie mit diesem Kapitel beginnen, könnte Sie ein Blick in den Abschnitt Kontexte und Engraver interessieren, dann Kontexte und Engraver sowie die Eigenschaften, die mit ihnen verknüpft sind, sind die Voraussetzung, um die Funktionsweise von Optimierungen verstehen zu können.

4.1.2 Objekte und Schnittstellen

Optimierung bedeutet, die internen Operationen und Strukturen des LilyPond-Programmes zu verändern, darum sollen hier zunächst die wichtigsten Begriffe erklärt werden, die zur Beschreibung dieser Operationen und Strukturen benutzt werden.

Der Begriff „Objekt“ ist ein allgemeiner Begriff, mit dem die Vielzahl an internen Strukturen bezeichnet wird, die LilyPond während der Bearbeitung des Quelltextes erstellt. Wenn etwa ein Befehl wie \new Staff auftritt, wird ein neues Objekt vom Typ Staff erstellt. Dieses Objekt Staff enthält dann alle Eigenschaften, die mit diesem speziellen Notensystem verknüpft sind, wie beispielsweise seine Bezeichnung, Tonart und spezifische Angaben über die Engraver, die innerhalb dieses Systems eingesetzt werden. Für alle anderen Kontexte gibt es genauso Objekte, die deren Eigenschaften beinhalten, beispielsweise für Voice-Objekte, Score-Objekte, Lyrics-Objekte, aber auch für Objekte, die Notationselemente wie die Taktlinien, Notenköpfe, Bögen und Dynamikbezeichnung enthalten. Jedes Objekt hat eine eigene Gruppe an Eigenschaftswerten.

Bestimmte Objekttypen tragen besondere Bezeichnungen. Objekte, die Notationselemente der gesetzten Ausgabe repräsentieren, also Notenköpfe, Hälse, Bögen, Fingersatz, Schlüssel usw., werden „Layout-Objekte“, oft auch „Graphische Objekte“ genannt. Daraus resultiert die künstliche Abkürzung „Grob“. Diese sind auch Objekte im allgemeinen Sinn und haben genauso Eigenschaften, die mit ihnen verknüpft sind, wie etwa Größe, Position, Farbe usw.

Einige Layout-Objekte sind etwas spezieller. Phrasierungsbögen, Crescendo-Klammern, Oktavierungszeichen und viele andere Grobs sind nicht an einer Stelle plaziert – sie haben vielmehr einen Anfangspunkt, einen Endpunkt und eventuell noch andere Eigenschaften, die ihre Form bestimmen. Objekte mit solch einer erweiterten Gestalt werden als „Strecker“ (engl. Spanners) bezeichnet.

Es bleibt uns noch übrig zu erklären, was „Schnittstellen“ (engl. interface) sind. Wenn auch viele Objekte sehr unterschiedlich sind, haben sie doch oft gemeinsame Eigenschaften, die auf die gleiche Weise verarbeitet werden. Alle Grobs beispielsweise haben eine Farbe, eine Größe, eine Position usw. und alle diese Eigenschaften werden von LilyPond auf die gleiche Weise verarbeitet, während der Quelltext in Notensatz umgesetzt wird. Um die internen Operationen zu vereinfachen, sind alle diese gemeinsamen Prozesse und Eigenschaften in einem Objekt mit der Bezeichnung grob-interface (Schnittstelle eines graphischen Objektes) zusammengefasst. Es gibt viele andere Gruppen gemeinsamer Eigenschaften, die jede eine Bezeichnung besitzen, welche auf -interface endet. Insgesamt gibt es über 100 dieser Schnittstellen. Wir werden später sehen, was es damit auf sich hat.

Dies waren die Hauptbegriffe, die in diesem Kapitel zur Anwendung kommen sollen.

4.1.3 Regeln zur Benennung von Objekten und Eigenschaften

Es wurden schon früher einige Regeln zur Benennung von Objekten vorgestellt, siehe Kontexte und Engraver. Hier eine Referenzliste der häufigsten Objekt- und Eigenschaftsbezeichnungen mit den Regeln für ihre Bezeichnung und illustrierenden echten Bezeichnungen. Es wurde „A“ für einen beliebigen Großbuchstaben und „aaa“ für eine beliebige Anzahl an Kleinbuchstaben eingesetzt. Andere Zeichen werden explizit angegeben.

Es wird bald ersichtlich werden, dass die Eigenschaften von unterschiedlichen Objekttypen mit unterschiedlichen Befehlen geändert werden. Deshalb ist es nützlich, aus der Schreibweise zu erkennen, um was für ein Objekt es sich handelt, um den entsprechenden Befehl einsetzen zu können.

4.1.4 Optimierungsmethoden

Der \override-Befehl

Wir haben uns schon mit den Befehlen \set und \with bekannt gemacht, mit welchen Eigenschaften von Kontexten verändert und Engraver entfernt oder hinzugefügt werden können. Siehe dazu Kontexteigenschaften verändern und Engraver hinzufügen und entfernen. Jetzt wollen wir uns weitere wichtige Befehle anschauen.

Der Befehl, um die Eigenschaften von Layout-Objekten zu ändern, ist \override. Weil dieser Befehl interne Eigenschaften tief in der Programmstruktur von LilyPond verändern muss, ist seine Syntax nicht so einfach wie die der bisherigen Befehle. Man muss genau wissen, welche Eigenschaft welches Objektes in welchem Kontext geändert werden soll, und welches der neu zu setzende Wert dann ist. Schauen wir uns an, wie das vor sich geht.

Die allgemeine Syntax dieses Befehles ist:

\override Kontext.LayoutObjekt #'layout-eigenschaft =
#Wert

Damit wir die Eigenschaft mit der Bezeichnung layout-property das Layout-Objektes mit der BezeichnungLayoutObject, welches ein Mitglied des Kontext-Kontextes ist, auf den Wert value.

Der Kontext kann (und wird auch normalerweise) ausgelassen werden, wenn der benötigte Kontext eindeutig impliziert ist und einer der untersten Kontexte ist, also etwa Voice, ChordNames oder Lyrics. Auch in diesem Text wird der Kontext oft ausgelassen werden. Später soll gezeigt werden, in welchen Fällen er ausdrücklich definiert werden muss.

Spätere Abschnitte behandeln umfassend Eigenschaften und ihre Werte, aber um ihre Funktion und ihr Format zu demonstrieren, werden wir hier nur einige einfache Eigenschaften und Werte einsetzen, die einfach zu verstehen sind.

Für den Moment könne Sie die #'-Zeichen ignorieren, die vor jeder Layout-Eigenschaft, und die #-Zeichen, die vor jedem Wert stehen. Sie müssen immer in genau dieser Form geschrieben werden. Das ist der am häufigsten gebrauchte Befehl für die Optimierung, und der größte Teil dieses Abschnittes wird dazu benutzt, seine Benutzung zu erläutern. Hier ein einfaches Beispiel, um die Farbe des Notenkopfes zu ändern:

c4 d
\override NoteHead #'color = #red
e4 f |
\override NoteHead #'color = #green
g4 a b c |

Der \revert-Befehl

Wenn eine Eigenschaft einmal überschrieben wurde, wird ihr neuer Wert so lange bewahrt, bis er noch einmal überschrieben wird oder ein \revert-Befehl vorkommt. Der \revert-Befehl hat die folgende Syntax und setzt den Wert der Eigenschaft zurück auf den Standardwert, nicht jedoch auf den vorigen Wert, wenn mehrere \override-Befehle benutzt wurden.

\revert Kontext.LayoutObjekt #'layout-eigenschaft

Wiederum, genauso wie der Kontext bei dem \override-Befehl, wird Kontext oft nicht benötigt. Er wird in vielen der folgenden Beispiele ausgelassen. Im nächsten Beispiel wird die Farbe des Notenkopfes wieder auf den Standardwert für die letzten zwei Noten gesetzt.

c4 d
\override NoteHead #'color = #red
e4 f |
\override NoteHead #'color = #green
g4 a
\revert NoteHead #'color
b4 c |

\once-Präfix

Sowohl der \override-Befehl als auch der \set-Befehl können mit dem Präfix \once (einmal) versehen werden. Dadurch wird der folgende \override- oder \set-Befehl nur für den aktuellen Musik-Moment wirksam, bevor sich wieder der Standard einstellt. Am gleichen Beispiel demonstriert, kann damit die Farbe eines einzelnen Notenkopfes geändert werden:

c4 d
\once \override NoteHead #'color = #red
e4 f |
\once \override NoteHead #'color = #green
g4 a b c |

Der \overrideProperty-Befehl

Es gibt eine andere Form des override-Befehls, \overrideProperty (überschreibe Eigenschaft), welcher ab und zu benötigt wird. Es wird hier nur der Vollständigkeit halber erwähnt, sein Einsatz wird demonstriert in Schwierige Korrekturen.

Der \tweak-Befehl

Der letzte Optimierungsbefehl in LilyPond ist \tweak (engl. optimieren). Er wird eingesetzt um Eigenschaften von Objekten zu verändern, die zum selben Musik-Moment auftreten, wie etwa die Noten eines Akkordes. Ein \override würde alle Noten des Akkords beeinflussen, während mit \tweak nur das nächste Objekt der Eingabe geändert wird.

Hier ein Beispiel. Angenommen, die Größe des mittleren Notenkopfes (ein E) in einem C-Dur-Akkord soll geändert werden. Schauen wir zuerst, was wir mit \once \override erhalten:

<c e g>4
\once \override NoteHead #'font-size = #-3
<c e g>4
<c e g>4

Wie man sehen kann, beeinflusst override alle Notenköpfe des Akkordes. Das liegt daran, dass alle die Noten eines Akkordes zum selben Musik-Moment auftreten und die Funktion von \once ist es, die Optimierung auf an allen Objekten auszuführen, die zum selben Musik-Moment auftreten wie der \override-Befehl.

Der \tweak-Befehl funktioniert anders. Er bezieht sich auf das direkt folgende Element in der Eingabe-Datei. Es wirkt aber auch nur mit Objekten, die direkt von der Eingabe kreiert werden, insbesondere Notenköpfe und Artikulationszeichen. Objekte wie etwa Hälse oder Versetzungszeichen werden erst später erstellt und lassen sich nicht auf diese Weise ändern. Zusätzlich müssen sich etwa Notenköpfe innerhalb eines Akkordes befinden, d. h. sie müssen von einfachen spitzen Klammern umschlossen sein. Um also eine einzelne Note mit \tweak zu verändern, muss der Befehl innerhalb der spitzen Klammern zusammen mit der Note eingegeben werden.

Um also zu unserem Beispiel zurückzukommen, könnte man die mittlere Note eines Akkordes auf diese Weise ändern:

<c e g>4
<c \tweak #'font-size #-3 e g>4

Beachten Sie, dass die Syntax des \tweak-Befehls sich von der des \override-Befehls unterscheidet. Weder Kontext noch Layout-Objekt können angegeben werden, denn das würde zu einem Fehler führen. Beide Angaben sind durch das folgende Element impliziert. Hier sollte auch kein Gleichheitszeichen vorhanden sein. Die verallgemeinerte Syntax des \tweak-Befehls ist also einfach

\tweak #'layout-eigenschaft #Wert

Ein \tweak-Befehl kann auch benutzt werden, um nur eine von mehreren Artikulationen zu ändern, wie im nächsten Beispiel zu sehen ist.

a4^"Black"
  -\tweak #'color #red ^"Red"
  -\tweak #'color #green _"Green"

Beachten Sie, dass dem \tweak-Befehl ein Artikulationsmodifikator vorangestellt werden muss, ganz als ob er selbst ein Artikulationszeichen wäre.

Der \tweak-Befehl muss auch benutzt werden, wenn das Aussehen einer vor mehreren geschachtelten Triolenklammern geändert werden soll, die zum selben Zeitpunkt beginnen. Im folgenden Beispiel beginnen die lange Klammer und die erste Triolenklammer zum selben Zeitpunkt, sodass ein \override-Befehl sich auf beide beziehen würde. In dem Beispiel wird \tweak benutzt, um zwischen ihnen zu unterscheiden. Der erste \tweakBefehl gibt an, dass die lange Klammer über den Noten gesetzt werden soll, und der zweite, dass die Zahl der rhythmischen Aufteilung für die erste der kurzen Klammern in rot gesetzt wird.

\tweak #'direction #up
\times 4/3 {
  \tweak #'color #red
  \times 2/3 { c8[ c c] }
  \times 2/3 { c8[ c c] }
  \times 2/3 { c8[ c c] }
}

Wenn geschachtelte N-tolen nicht zum gleichen Zeitpunkt beginnen, kann ihr Aussehen auf die übliche Art mit dem \override-Befehl geändert werden:

\times 2/3 { c8[ c c] }
\once \override TupletNumber
  #'text = #tuplet-number::calc-fraction-text
\times 2/3 {
  c8[ c]
  c8[ c]
  \once \override TupletNumber #'transparent = ##t
  \times 2/3 { c8[ c c] }
  \times 2/3 { c8[ c c] }
}

Siehe auch

Notationsreferenz: Der tweak-Befehl.

4.2 Die Referenz der Programminterna

4.2.1 Eigenschaften von Layoutobjekten

Angenommen, in Ihrer Partitur tritt ein Legatobogen auf, der Ihrer Meinung nach zu dünn ausgefallen ist. Sie würden ihn gerne etwas schwerer gezeichnet sehen. Wie gehen Sie vor? Von den Anmerkungen in früheren Abschnitten wissen Sie schon, dass LilyPond sehr flexibel ist und eine derartige Modifikation möglich sein sollte, und Sie erraten vielleicht, dass ein \override-Befehl angebracht ist. Aber gibt es eine Eigenschaft für die Dicke eines Legatobogens (engl. slur), und wenn es sie gibt, auf welche Weise lässt sie sich verändern? Hier kommt die Referenz der Interna zur Geltung. Dort finden sich alle Informationen, um den beschriebenen und alle anderen \override-Befehle zu konstruieren.

Bevor Sie jetzt in die Referenz der Interna wechseln, ist eine Warnung angebracht. Es handelt sich um ein Referenzdokument, was heißt, dass es sehr wenig oder gar keine Erklärungen enthält: seine Aufgabe ist es, Information klar und genau darzustellen. Das bedeutet, dass es auf den ersten Blick entmutigend wirkt. Die Einführung und Erklärung in diesem Abschnitt wird Ihnen aber schnell ermöglichen, genau die Information aus der Referenz zu entnehmen, die Sie benötigen. Beachten Sie, dass die Referenz der Interna nur auf Englisch existiert. Um die Eigenschaftsbezeichnung eines bestimmten Objektes zu finden, können Sie das Glossar (siehe Musikglossar) verwenden, in dem die englischen Begriffe in viele andere Sprachen übersetzt sind.

Das Vorgehen soll an einem konkreten Beispiel einer echten Komposition demonstriert werden. Hier das Beispiel:

{
  \key es \major
  \time 6/8
  {
    r4 bes8 bes[( g]) g |
    g8[( es]) es d[( f]) as |
    as8 g
  }
  \addlyrics {
    The man who | feels love's sweet e -- | mo -- tion
  }
}

Angenommen also, wir wollen die Legatobögen etwas dicker setzten. Ist das möglich? Die Legatobögen sind mit Sicherheit ein Layout-Objekt, die Frage muss also lauten: „Gibt es eine Eigenschaft von Legatobögen, die die Dicke bestimmt?“ Um diese Frage zu beantworten, müssen wir in der Referenz der Interna ( kurz IR) nachschauen.

Die IR für die LilyPond-Version, die Sie benutzen, findet sich auf der LilyPond-Webseite unter der Adresse http://lilypond.org. Gehen Sie zur Dokumentationsseite und klicken Sie auf den Link zur Referenz der Interna. Die Sprache ändert sich ab hier nach englisch. Für diese Übung sollten Sie die HTML-Version benutzen, nicht die „auf einer großen Seite“ oder die PDF-Version. Damit Sie die nächsten Absätze verstehen können, müssen Sie genauso vorgehen, während Sie weiterlesen.

Unter der Überschrift Top befinden sich fünf Links. Wählen Sie den Link zum Backend, wo sich die Information über Layout-Objekte befindet. Hier, unter der Überschrift Backend, wählen Sie den Link All layout objects. Die Seite, die sich öffnet, enthält ein Liste aller Layout-Objekte, die in Ihrerer LilyPond-Version benutzt werden, in alphabetischer Ordnung. Wählen Sie den Link Slur und die Eigenschaften der Legatobögen (engl. slur) werden aufgelistet.

Eine alternative Methode, auf diese Seite zu gelangen, ist von der Notationsreferenz aus. Auf einer der Seiten zu Legatobögen findet sich ein Link zur Referenz der Interna. Dieser Link führt Sie direkt auf diese Seite. Wenn Sie aber eine Ahnung haben, wie die Bezeichnung des Layout-Objektes lauten könnte, das sie ändern wollen, ist es oft schneller, direkt zur IR zu gehen und dort nachzuschlagen.

Aus der Slur-Seite in der IR könne wir entnehmen, dass Legatobögen (Slur-Objekte) durch den Slur_engraver erstellt werden. Dann werden die Standardeinstellungen aufgelistet. Beachten Sie, dass diese nicht in alphabetischer Reihenfolge geordnet sind. Schauen Sie sich die Liste an, ob sie eine Eigenschaft enthält, mit der die Dicke von Legatobögen kontrolliert werden kann. Sie sollten folgendes finden:

thickness (number)
     1.2
     Line thickness, generally measured in line-thickness

Das sieht ganz danach aus, als ob damit die Dicke geändert werden kann. Es bedeutet, dass der Wert von thickness einfach eine Zahl (number) ist, dass der Standardwert 1.2 ist, und dass die Einheit für die Dicke eine andere Eigenschaft mit der Bezeichnung line-thickness ist.

Wie schon früher gesagt, gibt es wenig bis gar keine Erklärungen in der IR, aber wir haben schon genug Informationen, um zu versuchen, die Dicke eines Legatobogens zu ändern. Die Bezeichnung des Layout-Objekts ist offensichtlich Slur und die Bezeichnung der Eigenschaft, die geändert werden soll thickness. Der neue Wert sollte etwas mehr als 1.2 sein, denn der Bogen soll ja dicker werden.

Den benötigten \override-Befehl können wir jetzt einfach konstruieren, indem wir die Werte für die Bezeichnungen in den Modellbefehl einfügen und den Kontext auslassen. Setzen wir einmal einen sehr großen Wert für die Dicke um zu sehen, ob der Befehl auch funktioniert. Also:

\override Slur #'thickness = #5.0

Vergessen Sie nicht das Rautenzeichen und Apostroph (#') vor der Eigenschaftsbezeichnung und das Rautenzeichen vor dem neuen Wert!

Die nächste Frage ist nun: „Wohin soll dieser Befehl geschrieben werden?“ Solange wir uns noch im Lernstadium befinden, ist die beste Antwort: „Innerhalb der Noten, vor den ersten Legatobogen und nahe bei ihm.“ Also etwa so:

{
  \key es \major
  \time 6/8
  {
    % Increase thickness of all following slurs from 1.2 to 5.0
    \override Slur #'thickness = #5.0
    r4 bes8 bes[( g]) g |
    g8[( es]) es d[( f]) as |
    as8 g
  }
  \addlyrics {
    The man who | feels love's sweet e -- | mo -- tion
  }
}

und wirklich wird der Legatobogen dicker.

Das ist also die grundlegende Herangehensweise, \override-Befehl zu formulieren. Es gibt einige zusätzliche Komplikationen, denen wir uns später widmen werden, aber Sie haben jetzt das Handwerkszeug, um Ihre eigenen Befehle zu konstruieren – wenn Sie auch noch etwas Übung benötigen. Die sollen Sie durch die folgenden Übungen erhalten.

Den Kontext finden

Manchmal muss dennoch der Kontext spezifiziert werden. Welcher aber ist der richtige Kontext? Wir könnten raten, dass Legatobögen sich im Voice-Kontext befinden, denn sie sind immer einzelnen Melodielinien zugewiesen. Aber wir können uns dessen nicht sicher sein. Um unsere Annahme zu überprüfen, gehen wir wieder zu der Seite im IR, die die Legatobögen beschreibt und die Überschrift Slur hat. Dort steht: „Slur objects are created by: Slur engraver“. Legatobögen werden also in dem Kontext erstellt, in dem sich der Slur_engraver befindet. Folgen Sie dem Link zu der Slur_engraver-Seite. Unten auf der Seite steht, dass der Slur_engraver sich in fünf Stimmen-Kontexten befindet, unter anderem auch im normalen Voice-Kontext. Unsere Annahme war also richtig. Und weil Voice einer der Kontexte der untersten Ebene ist, welcher eindeutig schon dadurch definiert ist, dass wir Noten eingeben, kann er an dieser Stelle auch weggelassen werden.

Nur einmal mit \override verändern

Im Beispiel oben wurden alle Legatobögen dicker gesetzt. Vielleicht wollen Sie aber nur den ersten Bogen dicker haben. Das können Sie mit dem \once-Befehl erreichen. Er wird direkt vor den \override-Befehl gesetzt und bewirkt, dass nur der Bogen geändert wird, der unmittelbar an der nächsten Note beginnt. Wenn die nächste Note keinen Bogenbeginn hat, dann passiert gar nichts – der Befehl wird nicht gespeichert, sondern einfach vergessen. Der Befehl, mit \once zusammen benutzt, muss also wie folgt positioniert werden:

{
  \time 6/8
  {
    \key es \major
    r4 bes8
    % Increase thickness of immediately following slur only
    \once \override Slur #'thickness = #5.0
    bes8[( g]) g |
    g8[( es]) es d[( f]) as |
    as8 g
  }
  \addlyrics {
    The man who | feels love's sweet e -- | mo -- tion
  }
}

Jetzt bezieht er sich nur noch auf den ersten Legatobogen.

Der \once-Befehl kann übrigens auch vor einem \set-Befehl eingesetzt werden.

Rückgängig machen

Eine weitere Möglichkeit: nur die beiden ersten Legatobögen sollen dicker gesetzt werden. Gut, wir könnten jetzt zwei Befehle benutzen, jeden mit dem \once-Präfix und direkt vor die entsprechende Note gestellt, an welcher der Bogen beginnt:

{
  \key es \major
  \time 6/8
  {
    r4 bes8
    % Increase thickness of immediately following slur only
    \once \override Slur #'thickness = #5.0
    bes[( g]) g |
    % Increase thickness of immediately following slur only
    \once \override Slur #'thickness = #5.0
    g8[( es]) es d[( f]) as |
    as8 g
  }
  \addlyrics {
    The man who | feels love's sweet e -- | mo -- tion
  }
}

Wir könnten aber auch den \once-Befehl weglassen und anstelle dessen später den \revert-Befehl einsetzen, um die thickness-Eigenschaft wieder auf ihren Standardwert zurückzusetzen:

{
  \key es \major
  \time 6/8
  {
    r4 bes8
    % Increase thickness of all following slurs from 1.2 to 5.0
    \override Slur #'thickness = #5.0
    bes[( g]) g |
    g8[( es]) es
    % Revert thickness of all following slurs to default of 1.2
    \revert Slur #'thickness
    d8[( f]) as |
    as8 g
  }
  \addlyrics {
    The man who | feels love's sweet e -- | mo -- tion
  }
}

Der \revert-Befehl kann benutzt werden, um eine beliebige Eigenschaft, die mit \override geändert worden ist, wieder in ihre Standardeinstellungen zurückzuversetzen. In unserem Beispiel können Sie die Methode benutzen, die Ihnen lieber ist, beide haben das gleiche Resultat.

Damit endet die Einleitung in die Referenz der Interna (IR) und die grundlegenden Optimierungsmethoden. Einige Beispiele folgen in späteren Abschnitten dieses Kapitel, einerseits um Sie mit weiteren Möglichkeiten der IR bekanntzumachen, andererseits um Ihnen mehr Übungsmöglichkeiten zu geben, die relevante Information dort zu finden. Die Beispiele werden Schritt für Schritt immer weniger Erklärungen beinhalten.

4.2.2 Eigenschaften, die Schnittstellen besitzen können

Der Text unseres Beispiels soll jetzt kursiv gesetzt werden. Was für ein \override-Befehl wird dazu benötigt? Schauen wir uns zunächst das Inhaltsverzeichnis in der IR an: „All layout objects“, wie auch schon zuvor. Welches Objekt könnte die Darstellung des Textes (engl. lyrics) beeinflussen? Es gibt den Eintrag LyricText, das hört sich schon sehr gut an. Ein Klick hierauf zeigt alle Eigenschaften an, die verändert werden können. Dazu gehört font-series und font-size, aber nichts, womit man kursiven Text erreichen könnte. Das liegt daran, dass die Schnitteigenschaft allen Schrift-Objekten gemeinsam ist. Sie findet sich also nicht in jedem einzelnen Layout-Objekt aufgelistet, sondern ist mit anderen ähnlichen Eigenschaften zusammen in einem Interface – einer Schnittstelle – verortet; in diesem Fall das font-interface.

Jetzt müssen wir also lernen, wie wir Eigenschaften von Schnittstellen finden und wie wir herausfinden, welche Objekte diese Schnittstelleneigenschaften benutzen.

Schauen Sie sich noch einmal die Seite in der IR an, die LyricText beschreibt. Unten auf der Seite ist eine klickbare Liste (in der HTML-Version der IR) an Eigenschaften, die von LyricText unterstützt werden. Diese Liste enthält sieben Einträge, darunter auch font-interface. Ein Klick hierauf bringt uns zu den Eigenschaften, die mit dieser Schnittstelle verbunden sind, also auch LyricText.

Jetzt sehen wir alle die Eigenschaften, die der Benutzer verändern kann, um die Schriftartendarstellung zu beeinflussen. Dazu gehört nun auch font-shape(symbol), wobei symbol auf die Werte upright (gerade), italics (kursiv) oder caps (Kapitälchen) gesetzt werden kann.

Sie werden gemerkt haben, dass font-series und font-size hier auch aufgelistet sind. Es stellt sich die Frage, warum diese allgemeinen Schriftarteigenschaften font-series und font-size sowohl unter der Überschrift LyricText als unter dem font-interface aufgelistet sind, aber font-shape befindet sich nur im font-interface? Die Antwort ist: Die globalen Einstellungen von font-series und font-size werden geändert, wenn ein LyricText-Objekt erstellt wird, aber font-shape wird davon nicht beeinflusst. Die zusätzlichen Einträge unter der Überschrift LyricText beinhalten dann die Werte der Standardeinstellungen dieser zwei Eigenschaften, wenn es sich um ein LyricText-Objekt handelt. Andere Objekte, die auch das font-interface unterstützen, setzen diese Eigenschaften anders, wenn sie erstellt werden.

Versuchen wir nun einen \override-Befehl zu konstruieren, der den Gesangstext kursiv setzt. Das Objekt hat die Bezeichnung LyricText, die Eigenschaft ist font-shape und der Wert italic. Wie vorher schon lassen wir den Kontext aus.

Am Rande sei angemerkt, dass die Werte der font-shape-Eigenschaft mit einem Apostroph (') gekennzeichnet werden müssen, weil es sich um Symbole handelt. Aus dem gleichen Grund mussten auch für thickness weiter oben im Text ein Apostroph gesetzt werden. Symbole sind besondere Bezeichnungen, die LilyPond intern bekannt sind. Einige sind Bezeichnungen von Eigenschaften, wie eben thickness oder font-shape. Andere sind besondere Werte, die an Eigenschaften übergeben werden können, wie italic. Im Unterschied hierzu gibt es auch beliebige Zeichenketten, die immer mit Anführungszeichen, also als "Zeichenkette" auftreten. Für weitere Einzelheiten zu Zeichenketten und Werten, siehe Scheme-Übung.

Gut, der \override-Befehl, mit dem der Gesangstext kursiv gesetzt wird, lautet:

\override LyricText #'font-shape = #'italic

und er muss direkt vor den Text gesetzt werden, auf den er sich bezieht, etwa so:

{
  \key es \major
  \time 6/8
  {
    r4 bes8 bes[( g]) g |
    g8[( es]) es d[( f]) as |
    as8 g
  }
  \addlyrics {
    \override LyricText #'font-shape = #'italic
    The man who | feels love's sweet e -- | mo -- tion
  }
}

Jetzt wird der Text kursiv gesetzt.

Den Kontext im Liedtextmodus bestimmen

Bei Gesangstexten funktioniert der \override-Befehl nicht mehr, wenn Sie den Kontext im oben dargestellten Format angeben. Eine Silbe wird im Gesangtextmodus (lyricmode) entweder von einem Leerzeichen, einer neuen Zeile oder einer Zahl beendet. Alle anderen Zeichen werden als Teil der Silbe integriert. Aus diesem Grund muss auch vor der schließenden Klammer } ein Leerzeichen gesetzt oder eine neue Zeile begonnen werden. Genauso müssen Leerzeichen vor und nach einem Punkt benutzt werden, um die Kontext-Bezeichnung von der Objekt-Bezeichnung zu trennen, denn sonst würden beide Bezeichnungen als ein Begriff interpretiert und von LilyPond nicht verstanden werden. Der Befehl muss also lauten:

\override Lyrics . LyricText #'font-shape = #'italic

Siehe auch

Erweitern: Scheme-Übung.

4.2.3 Typen von Eigenschaften

Bis jetzt hatten wir es mit zwei Arten von Eigenschaften zu tun: number (Zahl) und symbol. Damit ein Befehl funktioniert, muss der Wert einer Eigenschaft vom richtigen Typ sein und die Regeln befolgen, die für diesen Typ gelten. Der Eigenschaftstyp ist in der IR in Klammern hinter der Eigenschaftsbezeichnung angegeben. Hier eine Liste der Typen, die Sie vielleicht benötigen werden, mit den Regeln, die für den jeweiligen Typ gelten und einigen Beispielen. Sie müssen immer ein Rautenzeichen (#) vor den Typeintrag setzen, wenn sie in einem \override-Befehl benutzt werden.

Siehe auch

Erweitern: Scheme-Übung.

4.3 Erscheinung von Objekten

In diesem Abschnitt wollen wir zeigen, wie die Kenntnisse der vorigen Abschnitte in der Praxis angewandt werden können, um das Aussehen des Musiksatzes zu beeinflussen.

4.3.1 Sichtbarkeit und Farbe von Objekten

In Unterrichtsmaterial für den Musikunterricht wird oft eine Partitur dargestellt, in der bestimmte Notationselemente fehlen, so dass der Schüler die Aufgabe bekommt, die nachzutragen. Ein einfaches Beispiel ist etwa, die Taktlinien zu entfernen, damit der Schüler sie selber zeichnen kann. Aber die Tatklinien werden normalerweise automatisch eingefügt. Wie verhindern wir, dass sie ausgegeben werden?

Bevor wir uns hieran machen, sei daran erinnert, dass Objekteigenschaften in sogenannten Schnittstellen – engl. interface – gruppiert sind, siehe auch die Schnittstellen besitzen können. Das dient ganz einfach dazu, die Eigenschaften zusammenzufassen, die üblicherweise zusammen benötigt werden – wenn eine davon für ein Objekt gilt, dann auch die anderen. Manche Objekte brauchen die Eigenschaften von der einen Schnittstelle, andere von einer anderen. Die Schnittstellen, die die Eigenschaften von einem bestimmten Grob beinhalten, sind in der IR unten auf der Seite aufgelistet, die dieses Grob beschreibt. Die Eigenschaften können betrachtet werden, indem die Seite der entsprechenden Schnittstelle geöffnet wird.

Zu Information, wie man Eigenschaften von Grobs findet, siehe Eigenschaften von Layoutobjekten. Wir benutzen also jetzt die selbe Methode um in der IR das Layout-Objekt zu finden, dass für die Tatklinien zuständig ist. Über die Überschriften Backend und All layout objects kommen wir zu einem Layout-Objekt mit der Bezeichnung BarLine (engl. TaktLinie). Seine Eigenschaften beinhalten zwei, die über die Sichtbarkeit entscheiden: break-visibility und stencil. BarLine unterstützt auch einige Schnittstellen, unter anderem grob-interface, wo wir eine transparent und eine color-Eigenschaft finden. Alle können die Sichtbarkeit von Taktlinien (und natürlich auch die Sichtbarkeit von vielen anderen Objekten) beeinflussen. Schauen wir uns diese Eigenschaften eine nach der anderen an.

stencil (Matrize)

Diese Eigenschaft kontrolliert die Erscheinung der Taktlinien, indem sie das Symbol bestimmt, das ausgegeben werden soll. Wie bei vielen anderen Eigenschaften auch, kann sie so eingestellt werden, dass sie nichts ausgibt, indem ihr Wert auf #f (falsch) gesetzt wird. Ein Versuch also, wie vorher, indem wir den impliziten Kontext (Voice) auslassen:

{
  \time 12/16
  \override BarLine #'stencil = ##f
  c4 b8 c d16 c d8
  g,8 a16 b8 c d4 e16 |
  e8
}

Die Taktlinien werden aber immer noch angezeigt. Was ist da falsch gelaufen? Gehen Sie zurück zur IR und schauen Sie auf die Seite, die die Eigenschaften für BarLine angibt. Oben auf der Seite steht: „Barline objects are created by: Bar_engraver“. Schauen Sie sich die Bar_engraver-Seite an. Unten auf der Seite steht eine Liste der Kontexte, in denen der Takt-Engraver funktioniert. Alle Kontexte sind Staff-Typen (also Notensystem-Typen). Der Grund, warum der \override-Befehl nicht funktioniert hat, liegt also darin, dass das Taktlinie-Objekt (BarLine) sich nicht im Voice-Kontext befindet. Wenn der Kontext falsch angegeben wird, bewirkt der Befehl einfach gar nichts. Keine Fehlermeldung wird ausgegeben und auch nichts in die Log-Datei geschrieben. Versuchen wir also, den richtigen Kontext mit anzugeben:

{
  \time 12/16
  \override Staff.BarLine #'stencil = ##f
  c4 b8 c d16 c d8
  g,8 a16 b8 c d4 e16
  e8
}

Jetzt sind die Taktlinien wirklich verschwunden.

Es sollte jedoch beachtet werden, dass das Setzen der stencil-Eigenschaft auf #f zu Fehlerhinweisen führen kann, wenn die Dimensionen des Objekts für die richtige Behandlung benötigt werden. Zum Beispiel werden Fehler ausgegeben, wenn die stencil-Eigenschaft des NoteHead-Objekts auf #f gesetzt wird. Wenn dieser Fall auftritt, kann anstatt dessen die point-stencil-Funktion benutzt werden, welche den Stencil auf ein Objekt mit der Größe Null setzt:

{
  c4 c
  \once \override NoteHead #'stencil = #point-stencil
  c4 c
}

break-visibility (unsichtbar machen)

Aus der Beschreibung der Eigenschaften für BarLine in der IR geht hervor, dass die break-visibility-Eigenschaft einen Vektor mit drei Booleschen Werten benötigt. Diese kontrollieren jeweils, ob die Taktlinien am Ende einer Zeile, in der Mitte einer Zeile und am Anfang einer Zeile ausgegeben werden. Wenn also alle Taktlinien unsichtbar sein sollen, wie in unserem Beispiel, brauchen wir den Wert '#(#f #f #f). Versuchen wir es also, und berücksichtigen wir auch den Staff-Kontext. Beachten Sie auch, dass Sie #'# vor der öffnenden Klammer schreiben müssen: '# wird benötigt als Teil des Wertes, um einen Vektor zu signalisieren, und das erste # wird benötigt, um den Wert in einem \override-Befehl anzuführen.

{
  \time 12/16
  \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

Auch auf diesem Weg gelingt es, die Taktlinien unsichtbar zu machen.

transparent (durchsichtig)

Aus den Eigenschaftsdefinitionen auf der grob-interface-Seite in der IR geht hervor, dass die transparent-Eigenschaft boolesch ist. Mit #t (wahr) wird also ein Grob durchsichtig gemacht. Im unserem Beispiel soll jetzt die Taktart durchsichtig gemacht werden, anstatt die Taktlinien durchsichtig zu machen. Wir brauchen also wieder die Grob-Bezeichnung für die Taktart. Auf der „All layout objects“-Seite in der IR müssen wir die Eigenschaften des TimeSignature-Layout-Objekts suchen Das Objekt wird vom Time_signature_engraver erstellt, der sich auch im Staff-Kontext befindet und genauso das grob-interface unterstützt, wie Sie sich überzeugen können. Der Befehl, um die Taktangabe unsichtbar zu machen, ist also:

{
  \time 12/16
  \override Staff.TimeSignature #'transparent = ##t
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

Die Taktangabe ist verschwunden, aber mit diesem Befehl wird ein freier Platz gelassen, wo sich die Taktangabe eigentlich befinden würde. Das braucht man vielleicht für eine Schulaufgabe, in der die richtige Taktangabe eingefügt werden soll, aber in anderen Fällen ist diese Lücke nicht schön. Um auch die Lücke zu entfernen, muss die Matrize (stencil) der Taktangabe auf #f (falsch) gesetzt werden:

{
  \time 12/16
  \override Staff.TimeSignature #'stencil = ##f
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

Und der Unterschied wird deutlich: hiermit wird das gesamte Objekt entfernt, während man mit transparent ein Objekt unsichtbar machen kann, es aber an seinem Platz gelassen wird.

color (Farbe)

Abschließend wollen wir die Taktlinien unsichtbar machen, indem wir sie weiß einfärben. (Es gibt hier eine Schwierigkeit: die weiße Taktlinie übermalt manchmal die Taktlinien, wo sie sie kreuzt, manchmal aber auch nicht. Sie können in den Beispielen unten sehen, dass das nicht vorhersagbar ist. Die Einzelheiten dazu, warum das passiert und wie sie es kontrollieren können, werden dargestellt in Objekte weiß malen. Im Moment wollen wir lernen, wie man mit Farbe arbeitet, akzeptieren Sie bitte an dieser Stelle die Beschränkung.)

Das grob-interface bestimmt, dass der Wert der Farb-Eigenschaft eine Liste ist, aber es gibt keine Erklärung, was für eine Liste das sein soll. Die Liste, die benötigt wird, ist eine Liste mit Werten in internen Einheiten, aber damit Sie nicht wissen müssen, wie diese aussehen, gibt es mehrere Wege, Farben anzugeben. Der erste Weg ist es, „normale“ Farben zu benutzen, wie sie in der Tabelle in Liste der Farben aufgelistet sind. Beachten Sie, dass die Bezeichnungen auf Englisch sind. Um die Taktlinien auf weiß zu setzen, können Sie schreiben:

{
  \time 12/16
  \override Staff.BarLine #'color = #white
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

und die Taktlinien verschwinden in der Tat. Beachten Sie, dass white nicht mit einem Apostroph angeführt wird – es ist kein Symbol, sondern eine Funktion. Wenn sie aufgerufen wird, stellt sie eine Liste mit internen Werten zu Verfügung, mit welcher die Farbe auf weiß gestellt wird. Die anderen Farben in der Liste sind auch Funktionen. Um sich zu überzeugen, dass der Befehl auch wirklich funktioniert, können Sie die Farbe auf eine der anderen Funktionen dieser Liste abändern.

Die zweite Art die Farbe zu ändern geschieht, indem die Liste der X11-Farbbezeichnungen einzusetzen, siehe die zweite Liste in Liste der Farben. Diesen Farben muss jedoch eine andere Funktion vorangestellt werden, die die X11-Farbbezeichnungen in interne Werte konvertiert: x11-color. Das geschieht wie folgt:

{
  \time 12/16
  \override Staff.BarLine #'color = #(x11-color 'white)
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

In diesem Fall hat die Funktion x11-color ein Symbol als Argument, darum muss dem Symbol ein Apostroph vorangestellt und beide zusammen in Klammern gesetzt werden.

Es gibt noch eine dritte Funktion, die RGB-Werte in die internen Werte übersetzt – die rgb-color-Funktion. Sie braucht drei Argumente, um die Stärke von Rot, Grün und Blau darzustellen. Die Werte befinden sich zwischen 0 und 1. Um also die Farbe Rot darzustellen, muss der Wert der Funktion lauten: (rgb-color 1 0 0), weiß würde sein: (rgb-color 1 1 1).

{
  \time 12/16
  \override Staff.BarLine #'color = #(rgb-color 1 1 1)
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

Schließlich gibt es noch eine Grauskala, die zu den X11-Farben gehört. Sie reicht von schwarz ('grey0') bis weiß ('grey100), in Einerschritten. Wir wollen das illustrieren, indem alle Layout-Objekte im Beispiel verschiede Grauschattierungen erhalten:

{
  \time 12/16
  \override Staff.StaffSymbol   #'color = #(x11-color 'grey30)
  \override Staff.TimeSignature #'color = #(x11-color 'grey60)
  \override Staff.Clef          #'color = #(x11-color 'grey60)
  \override Voice.NoteHead      #'color = #(x11-color 'grey85)
  \override Voice.Stem          #'color = #(x11-color 'grey85)
  \override Staff.BarLine       #'color = #(x11-color 'grey10)
  c4 b8 c d16 c d8 |
  g,8 a16 b8 c d4 e16 |
  e8
}

Beachten Sie die Kontexte, die mit jedem einzelnen Layout-Objekt verbunden sind. Es ist wichtig, den richtigen Kontext einzusetzen, damit die Befehle funktionieren. Denken Sie daran, dass der Kontext sich daran orientiert, wo sich der entsprechende Engraver befindet. Den Standardkontext für Engraver finden Sie, indem Sie beim Layout-Objekt beginnen, zum Engraver gehen, der es produziert und auf der Seite des Engravers in der IR finden Sie Information, in welchem Kontext sich der Engraver normalerweise befindet.

4.3.2 Größe von Objekten

Als Startpunkt wollen wir wieder ein früheres Beispiel wählen, siehe Musikalische Ausdrücke ineinander verschachteln. Hier wurde ein neues Notensystem erstellt, wie man es für ein ossia braucht.

\new Staff ="main" {
  \relative g' {
    r4 g8 g c4 c8 d |
    e4 r8
    <<
      { f c c }
      \new Staff \with {
        alignAboveContext = #"main" }
      { f8 f c }
    >>
    r4 |
  }
}

Ossia-Systeme werden normalerweise ohne Schlüssel und Taktangabe geschrieben, und sie werden etwas kleiner als das Hauptsystem gesetzt. Wie man Schlüssel und Taktangabe entfernt, wissen wir schon: wir setzen den Stencil von beiden auf #f:

\new Staff ="main" {
  \relative g' {
    r4 g8 g c4 c8 d
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = #"main"
      }
      {
        \override Staff.Clef #'stencil = ##f
        \override Staff.TimeSignature #'stencil = ##f
        { f8 f c }
      }
    >>
    r4
  }
}

wobei ein zusätzliches Klammerpaar nach der \with-Konstruktion erforderlich ist um sicherzugehen, dass die Modifikation und die Noten sich auch auf das Ossia-System beziehen.

Was für einen Unterschied macht es, ob man den Staff-Kontext mit \with verändert, oder ob man die Stencils mit \override beeinflusst? Der größte Unterschied liegt darin, dass Änderungen, die mit \with eingeführt werden, während der Erstellung des Kontextes miterzeugt werden und als Standardeinstellungen für diesen Kontext während seiner gesamten Dauer gelten, während \set- oder \override-Befehle dynamisch in die Noten eingebettet werden – sie führen die Änderungen synchron mit einem bestimmten Zeitpunkt in der Musik aus. Wenn die Änderungen mit \unset oder \revert rückgängig gemacht werden, werden wieder die Standardwerte eingesetzt, die also die sind, die mit einer \with-Konstruktion definiert wurden, oder wenn hier keine definiert worden sind, die normalen Standardwerte.

Manche Kontexteigenschaften können nur ein einer \with-Konstruktion verändert werden. Das sind Eigenschaften, die nicht sinnvoll mitten im System geändert werden können. alignAboveContext (Orientierung über dem Kontext) und die Parallele, alignBelowContext (Orientierung unter dem Kontext) sind zwei derartige Eigenschaften – wenn das Notensystem einmal erstellt wurde, ist die Orientierung schon bestimmt und es wäre nicht sinnvoll, sie später zu ändern.

Die Standardwerte für Layout-Objekt-Eigenschaften können auch in der \with-Konstruktion gesetzt werden. Benutzen Sie einfach den normalen \override-Befehl ohne den Kontext, denn der Kontext ist eindeutig definiert durch die Stelle, an welcher sich \with befindet. Wenn an dieser Stelle ein Kontext angegeben wird, produziert LilyPond eine Fehlermeldung.

Das obige Beispiel könnte also auch so aussehen:

\new Staff ="main" {
  \relative g' {
    r4 g8 g c4 c8 d
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = #"main"
        % Don't print clefs in this staff
        \override Clef #'stencil = ##f
        % Don't print time signatures in this staff
        \override TimeSignature #'stencil = ##f
      }
      { f8 f c }
    >>
    r4
  }
}

Nun können wir daran gehen, auch wirklich die Größe der Objekte zu ändern.

Manche Layout-Objekte werden aus Glyphen erstellt, die sich in einer Schriftartdatei befinden. Dazu gehören die Notenköpfe, Versetzungszeichen, Text, Schlüssel, Taktbezeichnung, Dynamik und Gesangstext. Ihre Größe wird verändert, indem die font-size- (Schriftgröße)-Eigenschaft geändert wird, wie wir bald sehen werden. Andere Layout-Objekte, wie Bögen – oder allgemein Strecker-Objekte – werden individuell gezeichnet, es gibt dazu also keine font-size, die mit ihnen verknüpft wäre. Weitere Eigenschaften wie die Länge von Hälsen und Taktlinien, Dicke von Balken und anderen Linien und der Abstand der Notenlinien voneinander müssen auf spezielle Weise verändert werden.

In unserem Ossia-Beispiel wollen wir zuerst die Schriftgröße verändern. Das ist auf zwei Arten möglich. Entweder wir ändern die Schriftgröße für jede Objektart mit einem eigenen Befehl, etwa:

\override NoteHead #'font-size = #-2

oder wir ändern die Größe aller Schriftobjekte, indem wir den Wert einer besonderen Eigenschaft, fontSize, mit dem \set-Befehl bestimmen oder sie in eine \with-Konstruktion (ohne \set einschließen.

\set fontSize = #-2

Beide Beispiele reduzieren die Schriftgröße um zwei Schritte im Vergleich zum vorigen Wert, wobei jeder Schritt die Schriftgröße um etwa 12% verändert.

Setzen wir das also in unserem Ossia-Beispiel ein:

\new Staff ="main" {
  \relative g' {
    r4 g8 g c4 c8 d
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = #"main"
        \override Clef #'stencil = ##f
        \override TimeSignature #'stencil = ##f
        % Reduce all font sizes by ~24%
        fontSize = #-2
      }
      { f8 f c }
    >>
    r4
  }
}

Das sieht aber immer noch nicht richtig aus. Die Notenköpfe und Fähnchen sind kleiner, aber die Hälse im Vergleich dazu zu lang und die Notenlinien zu weit auseinander. Sie müssen auch proportional zur Schriftart verkleinert werden. Der nächste Abschnitt behandelt diese Anpassung.

4.3.3 Länge und Dicke von Objekten

Abstände und Längen werden in LilyPond üblicherweise in Notenlinienabständen (engl. staff-spaces) gemessen. Das ist der Abstand zwischen zwei Notenlinien im System. Die meisten Dicken (engl. thickness) dagegen werden in einer internen Einheit Linien-Dicke (engl. line-thickness) gemessen. Die Linien von Dynamikklammern zum Beispiel haben standardmäßig eine Dicke von einer Einheit line-thickness, während die Dicke eines Notenhalses 1,3 ist. Beachten Sie jedoch, dass sich manche Dicken anders verhalten: die Dicke von Balken etwa wird in Notenlinienabständen gemessen.

Wie also werden Längen skaliert um der Schriftgröße zu entsprechen? Das kann mit einer besonderen Funktion magstep vorgenommen werden, die genau für diesen Zweck vorhanden ist. Sie nimmt ein Argument auf, die Änderung der Schriftgröße (#-2 im obigen Beispiel) und gibt einen Skalierungsfaktor aus, der dazu dient, Objekte proportionell zueinander zu verändern. So wird sie benutzt:

\new Staff ="main" {
  \relative g' {
    r4 g8 g c4 c8 d
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = #"main"
        \override Clef #'stencil = ##f
        \override TimeSignature #'stencil = ##f
        fontSize = #-2
        % Reduce stem length and line spacing to match
        \override StaffSymbol #'staff-space = #(magstep -2)
      }
      { f8 f c }
    >>
    r4
  }
}

Da die Länge eines Halses und viele andere Längeneigenschaften relativ zum Wert des Notenlinienabstands (staff-space) errechnet werden, werden sie auch automatisch verkleinert. Das wirkt sich jedoch nur auf die vertikale Skalierung des Ossias aus – die horizontale Skala ist durch das Layout des Haupsystems bestimmt und wird also von diesen Größenänderungen nicht betroffen. Wenn natürlich die Größe der gesamten Noten reduziert würde, würde sich auch die horizontalen Abstände ändern. Dass wird später im Layout-Abschnitt betrachtet.

Mit dieser Änderung ist unser Ossia fertig. Die Größen und Längen aller anderen Objekte können auf analoge Weise geändert werden.

Für kleine Größenänderungen, wie in dem obigen Beispiel, braucht die Dicke der verschiedenen Linien, wie Taktlinien, Notenlinien, Balken, Dynamikklammern usw. normalerweise keine spezielle Anpassung. Wenn die Dicke eines bestimmten Layout-Objektes angepasst werden muss, kann man das erreichen, indem die entsprechende thickness-Eigenschaft des Objekts mit \override verändert wird. Ein Beispiel, wie man die Dicke von Bögen ändert, wurde schon gezeigt, siehe Eigenschaften von Layoutobjekten. Die Dicke aller gezeichneten Objekte (die also nicht aus einer Schriftart stammen) können auf gleiche Weise geändert werden.

4.4 Positionierung von Objekten

4.4.1 Automatisches Verhalten

Es gibt Objekte der Notation, die zum Notensystem gehören, und andere, die außerhalb des Systems gesetzt werden müssen. Sie werden within-staff-Objekte bzw. outside-staff-Objekte genannt.

within-staff-Objekte werden innerhalb des Notensystems (engl. staff) gesetzt: Notenköpfe, Hälse, Versetzungszeichen usw. Ihre Position ist üblicherweise durch die notierte Musik bestimmt – sie werden vertikal auf bestimmten Linien notiert oder sind an andere Objekte gebunden, die vertikal festgelegt sind. Kollisionen von Notenköpfen, Hälsen und Versetzungszeichen werden normalerweise automatisch vermieden. Es gibt Befehle, um dieses automatische Verhalten zu verändern, wie unten gezeigt werden soll.

Objekte, die außerhalb des Notensystems gesetzt werden, sind unter Anderem Übungsmarkierungen, Text und Dynamikzeichen. LilyPonds Regel für ihre vertikale Positionierung lautet, sie so nah wie möglich am Notensystem zu setzen, aber nicht so nah, dass sie mit anderen Objekten kollidieren. Dabei wird die outside-staff-priority-(Priorität außerhalb des Notensystems)-Eigenschaft eingesetzt, um die Reihenfolge zu bestimmen, in denen Objekte gesetzt werden sollen.

Zuerst werden alle Innersystemobjekte von LilyPond gesetzt. Dann werden die Objekte außerhalb des Systems nach ihrer outside-staff-priority geordnet. Die outside-staff-Objekte werden dann nacheinander gesetzt, mit der niedrigsten Priorität beginnend, und so gesetzt, dass sie nicht mit anderen Objekten kollidieren, die schon gesetzt wurden. Wenn also zwei outside-staff-Objekte um den selben Platz streiten, wird das mit der geringeren outside-staff-priority näher am System gesetzt werden. Wenn zwei Objekte die selbe Priorität haben, wird das näher am System gesetzt, welches zuerst auftritt.

Im folgenden Beispiel haben alle Textbeschriftungen die gleiche Priorität (weil sie nicht explizit gesetzt worden ist). Beachten Sie, dass „Text3“ wieder dicht am System gesetzt wurde, weil er unter „Text2“ passt.

c2^"Text1"
c2^"Text2"
c2^"Text3"
c2^"Text4"

Notensysteme werden in den Standardeinstellungen auch so dicht beieinander gesetzt wie es möglich ist (mit einem minimalen Abstand). Wenn Noten sehr weit aus einem System herausragen, zwingen sie das nächste System weiter weg, wenn eine Kollision drohen würde. Im nächsten Beispiel sehen Sie, wie Noten auf zwei Systemen „ineinander greifen“.

<<
  \new Staff {
    \relative c' { c4 a, }
  }
  \new Staff {
    \relative c'''' { c4 a, }
  }
>>

4.4.2 within-staff (Objekte innerhalb des Notensystems)

Es wurde schon gezeigt, wie die Befehle \voiceXXX die Richtung von Bögen, Fingersatz und allen anderen Objekten beeinflusst, die von der Richtung der Notenhälsen abhängen. Diese Befehle sind nötig, wenn polyphone Musik geschrieben wird, damit sich die einzelnen Melodielinien klar abzeichnen. Es kann aber von Zeit zu Zeit nötig sein, dieses automatische Verhalten zu verändern. Das kann entweder für ganze Abschnitte, aber genauso auch nur für eine einzelne Note vorgenommen werden. Die Eigenschaft, die die Richtung bestimmt, ist die direction-Eigenschaft jedes Layout-Objekts. Es soll erst erklärt werden, was sie bewirkt und dann eine Anzahl an fertigen Befehlen für die üblicheren Situationen präsentiert werden, mit denen Sie gleich loslegen können.

Manche Layout-Objekte, wie Legato- und Bindebögen, biegen sich oder zeigen entweder nach oben oder nach unten, andere, wie Hälse und Fähnchen, verändern auch die Position rechts oder links, je nach der Richtung, in die sie zeigen. Das wird automatisch berücksichtigt, wenn die direction-Eigenschaft verändert wird.

Das folgende Beispiel zeigt im ersten Takt die Standardeinstellung für Hälse, die bei hohen Noten nach unten zeigen und bei tiefen noten nach oben. Im nächsten Takt werden alle Hälse nach unten gezwungen, im dritten Takt nach oben, und im vierten wird wieder der Standard eingestellt.

a4 g c a
\override Stem #'direction = #DOWN
a4 g c a
\override Stem #'direction = #UP
a4 g c a
\revert Stem #'direction
a4 g c a

Hier werden die Konstanten DOWN und UP eingesetzt. Sie haben die Werte -1 bzw. +1, und diese numerischen Werte können ebenso benutzt werden. Auch der Wert 0 kann in manchen Fällen benutzt werden. Er bedeutet für die Hälse das gleiche wie UP, für einige andere Objekte jedoch „zentriert“. Es gibt hierzu die Konstante CENTER, die den Wert 0 hat.

Es gibt aber einfachere Befehle, die normalerweise benutzt werden. Hier eine Tabelle der häufigsten. Die Bedeutung des Befehls wird erklärt, wenn sie nicht selbstverständlich ist.

Diese vordefinierten Befehl können allerdings nicht zusammen mit \once benutzt werden. Wenn Sie die Wirkung eines Befehl auf eine einzige Noten begrenzen wollen, müssen Sie den entsprechenden \once \override-Befehl benutzen oder den definierten Befehl, gefolgt von dem entsprechenden neutralisierenden xxxNeutral-Befehl nach der Note.

Fingersatz

Die Positionierung von Fingersatz kann auch durch den Wert seiner direction-Eigenschaft beeinflusst werden, aber eine Veränderung von direction hat keinen Einfluss auf Akkorde. es gibt auch hier besondere Befehle, mit denen der Fingersatz von einzelnen Noten in Akkorden kontrolliert werden kann, wobei mögliche Positionen über, unter der Note und rechts bzw. links von ihr sind.

Zunächst die Wirkungsweise von direction auf den Fingersatz: im ersten Takt der Standard, dann die Wirkung von DOWN (runter) und UP (hinauf).

c4-5 a-3 f-1 c'-5
\override Fingering #'direction = #DOWN
c4-5 a-3 f-1 c'-5
\override Fingering #'direction = #UP
c4-5 a-3 f-1 c'-5

Eine Beeinflussung der direction-Eigenschaft ist jedoch nicht die einfachste Art, Fingersatzbezeichnungen manuell über oder unter das System zu setzen. Normalerweise bietet es sich an, _ oder ^ anstelle von - vor der Fingersatz-Zahl zu benutzen. Hier das vorherigen Beispiel mit dieser Methode:

c4-5 a-3 f-1 c'-5
c4_5 a_3 f_1 c'_5
c4^5 a^3 f^1 c'^5

Die direction-Eigenschaft wirkt sich nicht auf Akkorde aus, während die Präfixe _ und ^ funktionieren. Standardmäßig wird der Fingersatz automatisch entweder über oder unter dem Akkord gesetzt:

<c-5 g-3>4
<c-5 g-3 e-2>4
<c-5 g-3 e-2 c-1>4

aber das kann manuell geändert werden, um einzelne Fingersatzanweisungen nach oben oder unten zu zwingen:

<c-5 g-3 e-2 c-1>4
<c^5 g_3 e_2 c_1>4
<c^5 g^3 e^2 c_1>4

Noch bessere Kontrolle über die Positionierung von Fingersatz für einzelne Noten in einem Akkord ist mit dem \set fingeringOrientations-Befehl möglich. Die Syntax lautet:

\set fingeringOrientations = #'([up] [left/right] [down])

\setwird benutzt, weil fingeringOrientations eine Eigenschaft des Voice-Kontextes ist, erstellt und eingesetzt vom New_fingering_engraver.

Die Eigenschaft kann als Wert eine Liste mit einem bis drei Einträgen haben. Damit wird bestimmt, ob Fingersatz oberhalb gesetzt werden kann (wenn up in der Liste auftaucht), darunter (wenndown auftaucht), links (wenn left auftaucht) oder rechts (wenn right auftaucht). Wenn andererseits ein Wert nicht auftaucht, wir auch kein Fingersatz in dieser Richtung gesetzt. LilyPond nimmt diese Beschränkung als Bedingung und errechnet die besten Positionen für die Noten des nächsten Akkordes. Die seitliche Positionierung kann nur auf einer Seite des Akkordes geschehen, nicht auf beiden gleichzeitig, es kann also nur entweder left oder right auftreten, nicht beide gleichzeitig.

Hier ein paar Beispiele:

\set fingeringOrientations = #'(left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(up left down)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(up left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(right)
<f-2>4
<c-1  e-2 g-3 b-5>4

Wenn die Fingersatzbezeichnung zu gedrungen aussieht, kann auch die Schriftgröße (font-size) verringert werden. Der Standardwert kann aus dem Fingering-Objekt in der IR entnommen werden, er ist -5, versuchen wir es also mit -7.

\override Fingering #'font-size = #-7
\set fingeringOrientations = #'(left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(up left down)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(up left)
<f-2>4
<c-1  e-2 g-3 b-5>4
\set fingeringOrientations = #'(right)
<f-2>4
<c-1  e-2 g-3 b-5>4

4.4.3 Objekte außerhalb des Notensystems

Objekte außerhalb des Notensystems werden automatisch gesetzt, um Kollisionen zu vermeiden. Objekten mit einem geringeren Prioritätswert der Eigenschaft outside-staff-priority werden näher an das System gesetzt, und andere Objekte außerhalb des Systems werden dann soweit vom System entfernt gesetzt, dass Zusammenstöße vermieden werden. Die outside-staff-priority-Eigenschaft ist im grob-interface definiert und ist also eine Eigenschaft von allen Layout-Objekten. Standardmäßig ist sie für alle Objekte auf falsch (#f) gesetzt; dieser Wert wird in einen numerischen Wert dem Objekt entsprechend geändert, wenn das Objekt für die Notenausgabe erstellt wird. Die Tabelle unten zeigt die Standardwerte für die meistbenutzten outside-staff-Objekte, die den Voreinstellungen nach im Staff- oder Voice-Kontext gesetzt werden.

Achtung bei einigen ungewöhnlichen Objektbezeichnungen: Strecker-Objekte werden automatisch erstellt, um die vertikale Position von Grobs zu kontrollieren, die an unterschiedlichen musikalischen Momenten beginnen und enden (könnten). Wenn also outside-staff-priority des darunterliegenden Grobs geändert wird, hat das keine Auswirkung. Zum Beispiel bringt das Ändern von outside-staff-priority des Hairpin-(Dynamikklammer)-Objekts keine Änderung in der vertikalen Position von Crescendo-Klammern – anstatt dessen muss outside-staff-priority des hiermit assoziierten DynamicLineSpanne-Objekts geändert werden. Dieser \override-Befehl muss zu Beginn des Streckers gesetzt werden, welcher womöglich mehrere verbundene Dynamikklammern und Dynamikbezeichnung beinhaltet.

Hier ein Beispiel, das die Standardpositionierung von einigen Objekten zeigt.

% Set details for later Text Spanner
\override TextSpanner #'(bound-details left text)
    = \markup { \small \bold Slower }
% Place dynamics above staff
\dynamicUp
% Start Ottava Bracket
\ottava #1
c'4 \startTextSpan
% Add Dynamic Text and hairpin
c4\pp\<
c4
% Add Text Script
c4^Text
c4 c
% Add Dynamic Text and terminate hairpin
c4\ff c \stopTextSpan
% Stop Ottava Bracket
\ottava #0
c,4 c c c

Dieses Beispiel zeigt auch, wie man Text-Strecker erstellt, d.h. Text mit Bindestrichen, der sich über eine bestimmte Länge erstreckt. Der Strecker beginnt mit dem \startTextSpan-Befehl und endet mit dem \stopTextSpan-Befehl, und das Format des Textes wird mit dem \override TextSpanner-Befehl bestimmt. Mehr Einzelheiten siehe Text mit Verbindungslinien.

Im Beispiel wird auch gezeigt, wie Oktavierungsklammern (Ottava) erstellt werden.

Beachten Sie, dass Taktnummern, Metronombezeichnungen und Übungszeichen nicht gezeigt werden. Sie werden standardmäßig im Score-(Partitur)-Kontext erstellt und ihre outside-staff-priority wird in Bezug auf die Layout-Objekte, die im Staff-Kontext erstellt werden, ignoriert. Wenn Sie Taktnummern, Metronombezeichnungen oder Übungszeichen entsprechend ihrer Außersystem-Priorität setzen wollen, müssen Sie die entsprechenden Engraver (Bar_number_engraver, Metronome_mark_engraver oder Mark_engraver) vom Score-Kontext entfernen und dem Staff-Kontext hinzufügen. Wenn die Engraver so geändert werden, erhalten sie folgenden Werte für outside-staff-priority:

Wenn die Standardwerte der outside-staff-priority nicht die Positionierung hervorrufen, die Sie wünschen, kann die Priorität eines jeden Objektes geändert werden. Als Beispiel wollen wir zeigen, wie sich die Oktavierungsklammer unter den Textstrecker des vorigen Beispiels setzen lässt. Wir müssen nur die Priorität des OttavaBracket-Objektes in der IR oder der Tabelle oben herausfinden und einen kleineren Wert angeben als der Wert, den das TextSpanner-(Strecker)-Objekt bekommt, wobei noch daran zu denken ist, dass OttavaBracket im Staff-Kontext erstellt wird:

% Set details for later Text Spanner
\override TextSpanner #'(bound-details left text)
    = \markup { \small \bold Slower }
% Place dynamics above staff
\dynamicUp
% Place following Ottava Bracket below Text Spanners
\once \override Staff.OttavaBracket #'outside-staff-priority = #340
% Start Ottava Bracket
\ottava #1
c'4 \startTextSpan
% Add Dynamic Text
c4\pp
% Add Dynamic Line Spanner
c4\<
% Add Text Script
c4^Text
c4 c
% Add Dynamic Text
c4\ff c \stopTextSpan
% Stop Ottava Bracket
\ottava #0
c,4 c c c

Legatobögen werden als Innersystem-Objekte klassifiziert, aber sie erscheinen oft auch über dem System, wenn die Noten, an die sie verbunden sind, sehr hoch im System notiert sind. Dadurch können Außersystem-Objekte, wie Artikulationszeichen, zu hoch gerückt werden. Die avoid-slur-Eigenschaft hat nur eine Auswirkung, wenn auch die outside-staff-priority auf #f gesetzt ist. Alternativ kann die outside-staff-priority des Legatobogens auf einen numerischen Wert gesetzt werden, sodass er mit anderen Außersystem-Objekten anhand dieses Wertes gesetzt wird. Hier ein Beispiel, das die beiden Möglichkeiten veranschaulicht:

c4( c^\markup { \tiny \sharp } d4.) c8
c4(
\once \override TextScript #'avoid-slur = #'inside
\once \override TextScript #'outside-staff-priority = ##f
c4^\markup { \tiny \sharp } d4.) c8
\once \override Slur #'outside-staff-priority = #500
c4( c^\markup { \tiny \sharp } d4.) c8

Eine Änderung der outside-staff-priority kann auch dazu benutzt werden, die vertikale Plazierung von individuellen Objekten zu kontrollieren, auch wenn das Ergebnis nicht immer optimal ist. Im nächsten Beispiel soll „Text3“ oberhalb von „Text4“ gesetzt werden, das Beispiel wurde behandelt in Automatisches Verhalten. Der Wert der Priorität muss also für die Eigenschaft TextScript entweder in der IR oder in der Tabelle oben festgestellt werden und dann die Priorität für „Text3“ höher eingestellt werden:

c2^"Text1"
c2^"Text2" |
\once \override TextScript #'outside-staff-priority = #500
c2^"Text3"
c2^"Text4" |

Damit wird zwar „Text3“ ganz richtig über „Text4“ platziert, aber auch über „Text2“, und „Text4“ wird jetzt weiter unten gesetzt. Eigentlich sollten ja alle diese Anmerkungen gleichweit vom System entfernt sein. Dazu muss offensichtlich horizontal etwas Platz gemacht werden. Das kann erreicht werden mit dem textLengthOn-(Textlänge an)-Befehl.

\textLengthOn (Textlänge berücksichtigen)

Standardmäßig wird Text, der mit dem Beschriftungsbefehl \markup bzw. Äquivalenten erstellt wird, kein zusätzlicher Platz in Bezug auf die Positionierung der Noten zugestanden. Der \textLengthOn-Befehl ändert dieses Verhalten, so dass die Noten gespreizt werden, wenn die Breite des Textes es erfordert:

\textLengthOn  % Cause notes to space out to accommodate text
c2^"Text1"
c2^"Text2" |
c2^"Text3"
c2^"Text4" |

Dieses Verhalten wird mit dem \textLengthOff-Befehl rückgängig gemacht. Erinnern Sie sich, dass \once nur mit \override, \set, \revert oder unset funktioniert, der Befehl kann also nicht zusammen mit \textLengthOn benutzt werden.

Textbeschriftung vermeidet auch Noten, die über das System hinausstehen. Wenn das nicht gewünscht ist, kann die automatische Verschiebung nach oben hin auch vollständig ausgeschaltet werden, indem die Priorität auf #f gesetzt wird. Hier ein Beispiel, wie eine Textbeschriftung mit diesen Noten reagiert:

% This markup is short enough to fit without collision
c2^"Tex" c'' |
R1 |

% This is too long to fit, so it is displaced upwards
c,,2^"Text" c'' |
R1 |

% Turn off collision avoidance
\once \override TextScript #'outside-staff-priority = ##f
c,,2^"Long Text   " c'' |
R1 |

% Turn off collision avoidance
\once \override TextScript #'outside-staff-priority = ##f
\textLengthOn        % and turn on textLengthOn
c,,2^"Long Text   "  % Spaces at end are honored
c''2 |

Dynamik

Dynamikbezeichnung wird üblicherweise unter dem System gesetzt, kann aber auch nach oben mit dem Befehl dynamicUp gezwungen werden. Die Bezeichnung wird vertikal relativ zu der Note positioniert, an die sie angefügt wurde. Sie wird vertikal variabel gesetzt in Bezug zu Innersystemobjekten wie Bögen oder Taktnummern. Damit können oft recht gute Resultate erreicht werden, wie im folgenden Beispiel:

\clef "bass"
\key aes \major
\time 9/8
\dynamicUp
bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\!
ees,2.~\)\mf ees4 r8

Wenn aber Noten und Dynamikzeichen sehr dicht beieinander stehen, positioniert die automatische Kollisionsvermeidung später kommende Dynamikzeichen weiter weg, was allerdings nicht immer die beste Möglichkeit ist, wie in dem folgenden, etwas gewollten Beispiel zu sehen ist:

\dynamicUp
a4\f b\mf c\mp b\p |

Wenn eine ähnliche Situation in „echter“ Musik auftaucht, kann es nötig sein, die Noten etwas zu spreizen, damit die Dynamikzeichen alle auf der selben vertikalen Position gesetzt werden können. Dieses Verhalten war im Falle von Textbeschriftungen möglich mit dem \textLengthOn-Befehl, aber es gibt keinen entsprechenden Befehl für Dynamik. Wir müssen also unsere eigenen Befehle mit \override konstruieren.

Verändern der Größe von grobs

Zuallererst müssen wir lernen, wie die Größe von Grobs verändert wird. Alle Grobs besitzen einen Referenzpunkt, der benutzt wird, um ihre Position in Relation zu ihnen übergeordneten Objekten zu bestimmen. Dieser Punkt innerhalb des Grobs wird dann auf einer horizontalen Position (X-offset) und einer vertikalen Position (Y-offset) ausgerichtet, immer bezüglich des übergeordneten Objektes. Eine horizontale Strecke wird durch ein Zahlenpaar angegeben (X-extent), welche die linke und rechte Grenze relativ zum übergeordneten Objekt bezeichnen. Die vertikale Strecke wir genauso durch ein Zahlenpaar (Y-extent) definiert. Diese Eigenschaften gehören zu allen Grobs, die das grob-interface unterstützen.

Standardmäßig haben Außersystemobjekte eine Länge von Null, so dass sie sich in horizontaler Richtung überlappen können. Das geschieht, indem dem linken Rand Unendlich zugewiesen wird und dem rechten Rand minus Unendlich (der Code der extra-spacing-width-(zusätzliche Positionierungslänge)-Eigenschaft lautet: '(+inf.0 . -inf.0)). Damit sich diese Objekte also horizontal nicht überschneiden, muss der Wert von extra-spacing-width auf '(0 . 0) gesetzt werden, sodass die wirkliche Länge eines Objektes zur Geltung kommt. Mit diesem Befehl wird das für Dynamik-Zeichen erledigt:

\override DynamicText #'extra-spacing-width = #'(0 . 0)

Schauen wir uns an, wie es mit dem vorigen Beispiel funktioniert:

\dynamicUp
\override DynamicText #'extra-spacing-width = #'(0 . 0)
a4\f b\mf c\mp b\p

Damit werden die Dynamik-Zeichen also wirklich nebeneinander gesetzt, aber es gibt noch zwei Probleme. Die Zeichen sollten etwas weiter außeinander stehen und es wäre gut, wenn sie alle den gleichen Abstand zum System hätte. Das erste Problem ist einfach behoben. Anstatt der extra-spacing-width-Eigenschaft Null zuzuweisen, können wir auch einen etwas größeren Wert wählen. Die Einheit wird gemessen in dem Abstand zwischen zwei Notenlinien, es scheint also gut, den rechten und linken Rand eine halbe Einheit zu vergrößern:

\dynamicUp
% Extend width by 1 staff space
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
a4\f b\mf c\mp b\p

Das sieht schon besser aus, aber es wäre noch besser, wenn die Dynamik-Zeichen alle an einer Linie ausgerichtet wären, anstatt höher und tiefer zu sitzen. Das kann mit der staff-padding-Eigenschaft erreicht werden, die wir uns im folgenden Abschnitt genauer anschauen werden.

4.5 Kollision von Objekten

4.5.1 Verschieben von Objekten

Es wird vielleicht eine Überraschung sein, aber LilyPond ist nicht perfekt. Einige Notationselemente können sich überschneiden. Das ist nicht schön, aber zum Glück sehr selten. Normalerweise müssen die Objekte zur Klarheit oder aus ästhetischen Gründen verschoben werden – sie könnten besser aussehen, wenn sie etwas zusätzlichen Platz erhalten.

Es gibt im Grunde drei Herangehensweisen, überlappende Notation zu verbessern. Man sollte sie in der folgenden Reihenfolge anwenden:

1. Die Richtung eines der überlappenden Objekte kann geändert werden, indem die vordefinierten Befehle für Innersystemobjekte verwendet werden, wie beschrieben in within-staff (Objekte innerhalb des Notensystems). Hälse, Bögen, Balken, Dynamik-Zeichen und Triolen können auf diese Weise einfach umgeordnet werden. Beschränkt ist diese Methode insofern, als es nur zwei Möglichkeiten zur Veränderung gibt: oben oder unten.
2. Die Objekteigenschaft, die LilyPond benutzt um die Layout-Objekte zu platzieren, können mit dem \override-Befehl positioniert werden. Die Vorteile von Änderungen dieser Art sind a) dass einige Objekte automatisch verschoben werden, wenn es nötig ist Platz zu schaffen und b) ein einziges \override sich auf alle Fälle eines Objekttyps bezieht. Zu diesen Eigenschaften gehören:
   • direction (Richtung)

     Das wurde schon detailliert behandelt, siehe within-staff (Objekte innerhalb des Notensystems).

   • padding, right-padding, staff-padding (Verschiebung)

     Wenn ein Objekt platziert wird, bestimmt der Wert seiner padding-(Füllungs)-Eigenschaft die Größe des Abstandes, der zwischen dem Objekt selber und dem Objekt, relativ zu welchem es positioniert wird, gelassen werden muss. Dabei zählt der padding-Wert des Objektes, das platziert werden soll, der padding-Wert des Objektes, das schon gesetzt wurde, wird hingegen ignoriert. Abstände mit padding können zu allen Objekten hinzugefügt werden, die das side-position-interface unterstützen.

     Anstelle von padding wird die Position von Versetzungszeichengruppen durch die Eigenschaften right-padding bestimmt. Diese Eigenschaft wird im AccidentalPlacement-(Versetzungszeichen-Positionierungs)-Objekt gefunden, das sich innerhalb des Staff-Kontexts befindet. Während des Notensatzes werden die Notenköpfe zuerst gesetzt und dann die Versetzungszeichen, wenn denn welche gesetzt werden, durch die right-padding-Eigenschaft auf die linke Seite der Notenköpfe positioniert, um die Entfernung von den Notenköpfen und zwischen den einzelnen Versetzungszeichen zu bestimmen. Also nur die right-padding-(Verschiebung nach rechts)-Eigenschaft des AccidentalPlacement-Objekts hat Einfluss auf die Positionierung der Versetzungszeichen.

     Die staff-padding-(Verschiebung zum System)-Eigenschaft ist sehr ähnlich wie die padding-Eigenschaft: padding bestimmt den Minimalabstand zwischen einem Objekt, das das side-position-interface unterstützt, und dem nächsten anderen Objekt (normalerweise die Note oder Notenlinie); staff-padding dagegen wirkt nur auf Objekte die immer außerhalb des Notensystems sind – damit wird der minimale Abstand bestimmt, der zwischen dem Objekt und dem Notensystem gelassen werden soll. staff-padding hat also keinen Einfluss auf Objekte, die relativ zu einer Note positioniert werden, sondern nur auf solche, die zum System relativ stehen. Wenn es mit einem anderen Objekt eingesetzt wird, erhält man keine Fehlermeldung, aber der Befehl hat auch keine Auswirkungen.

     Um herauszufinden, welche padding-Eigenschaft für das bestimmte Objekt nötig, ist, das Sie verschieben wollen, müssen Sie in der IR nach den Objekt-Eigenschaften schauen. Dabei sollten Sie bedenken, dass sich die padding-Eigenschaften nicht unbedingt in dem Objekt selber befinden, schauen Sie also auch in Objekten nach, die offensichtlich Ähnlichkeiten haben.

     Alle padding-Werte werden in Notenlinienabständen gemessen. Für die meisten Objekte ist der Wert ungefähr auf 1.0 oder weniger gesetzt (das variiert von Objekt zu Objekt). Der Wert kann geändert werden, wenn ein größerer (oder kleinerer) Abstand gewünscht wird.

   • self-alignment-X (Selbstpositionierung)

     Diese Eigenschaft kann benutzt werden, um ein Objekt nach links, rechts oder zentriert an dem Referenzpunkt des Objekts auszurichten, an das es verknüpft ist. Es kann bei allen Objekten benutzt werden, die das self-alignment-interface unterstützen. Das sind üblicherweise Objekte, die Text enthalten. Die möglichen Werte der Eigenschaft sind LEFT, RIGHT oder CENTER. Alternativ kann ein numerischer Wert zwischen -1 und +1 bestimmt werden: -1 heißt linksbündig, +1 rechtsbündig und Zahlen dazwischen bewegen den Text schrittweise von links nach rechts. Zahlen größer als 1 können angegeben werden, um den Text noch weiter nach links zu bewegen, oder weniger als -1, um ihn weiter nach rechts zu schieben. Eine Änderung um 1 des Wertes entspricht einer Bewegung um die halbe Textbreite.

   • extra-spacing-width (zusätzliche Breite)

     Diese Eigenschaft steht für alle Objekte zur Verfügung, die das item-interface unterstützen. Es braucht zwei Zahlen als Argument, die erste wird zur rechten Ausdehnung, die zweite zur linken Ausdehnung hinzugerechnet. Negative Zahlen verschieben die Ausdehnung nach rechts, positive nach links, um also ein Objekt zu verbreitern, muss die erste Zahl negativ und die zweite positiv sein. Allerdings beachten nicht alle Objekte beide Zahlen. Das accidental-(Versetzungszeichen)-Objekt etwa beachtet nur erste Zahl für die linke Ausdehnung.

   • staff-position (Notensystempositionierung)

     staff-position ist eine Eigenschaft des staff-symbol-referencer-interface, die von Objekten unterstützt wird, die relativ zum Notensystem (engl. staff) positioniert werden. Hiermit wird die vertikale Position eines Objekts relativ zur Mittellinie des Systems in halben Notenlinienabständen angegeben. Das ist sehr nützlich, um Zusammenstöße zwischen Layout-Objekten wie Ganztaktpausen, Bögen und Noten in verschiedenen Stimmen zu lösen.

   • force-hshift (vertikale Verschiebung erzwingen)

     Eng beieinander stehende Noten in einem Akkord oder Noten, die zum gleichen Zeitpunkt in unterschiedlichen Stimmen stehen, werden in zwei oder manchmal auch mehr Kolumnen gesetzt, um Kollisionen zu umgehen. Diese Kolumnen werden Notenkolumnen genannt; ein NoteColumn-Objekt wird erstellt um die Noten in den Kolumnen zu setzen.

     Die force-hshift-(erzwinge horizontale Verschiebung)-Eigenschaft ist eine Eigenschaft von NoteColumn (bzw. vom note-column-interface). Eine Veränderung dieser Eigenschaft macht es möglich, eine Notenkolumne zu verschieben, dabei gilt als Einheit die Breite einer Kolumne, also die Breite des Notenkopfes der ersten Stimme. Diese Eigenschaft kann in Situationen benutzt werden, in denen die normalen \shiftOn-Befehle (siehe auch Stimmen explizit beginnen) das Problem nicht beseitigen. Diese Eigenschaft ist besser in solchen Fällen zu verwenden als die extra-offset-Eigenschaft, weil man die richtige Entfernung nicht in Notenlinienabständen ausrechnen muss. Wenn eine Note in eine Notenkolumne oder aus ihr heraus geschoben wird, werden auch andere Funktionen beeinflusst, wie etwa die Verschmelzung von Notenköpfen.

3. Zu guter Letzt, wenn alles andere nicht funktioniert, können Objekte auch manuell positioniert werden, entweder vertikal in Bezug auf die Mittellinie des Systems, oder indem sie einen beliebigen Abstand weit auf eine neue Position verschoben werden. Der Nachteil ist, dass die richtigen Werte für eine gute Position manuell ausprobiert werden müssen, meistens durch Herantasten an den richtigen Wert, und das für jedes einzelne Objekt extra. Und weil diese Verschiebungen erst vorgenommen werden, wenn LilyPond alle anderen Objekte gesetzt hat, ist man als Notensetzer selber dafür verantwortlich, ob es Zusammenstöße gibt. Am schwerwiegendsten ist aber die Tatsache, dass die Verschiebungskoordinaten wahrscheinlich neu errechnet oder ausprobiert werden müssen, wenn sich an den Noten und deren Layout später irgend etwas ändert. Die Eigenschaften, die für diese Arte der manuellen Verschiebung verwendet werden können, sind:

   extra-offset (zusätzlicher Abstand)

   Diese Eigenschaft gehört zu jedem Layout-Objekt, das das grob-interface unterstützt. Sie braucht ein Zahlenpaar, das die exakte Verschiebung in horizontaler und vertikaler Richtung bezeichnet. Negative Zahlen verschieben das Objekt nach links oder unten. Die Einheit sind Notenlinienabstände. Die zusätzliche Positionierung wird vorgenommen, nachdem alle anderen Objekte platziert sind, weshalb ein Objekt irgendwohin verschoben werden kann, ohne den restlichen Satz zu beeinflussen.

   positions (Position)

   Diese Eigenschaft ist am sinnvollsten, um die Steigung und die Höhe von Balken, Bögen und Triolenklammern anzupassen. Sie braucht ein Zahlenpaar, das die Position des rechten und linken Endes relativ zur Mittellinie des Notensystems bestimmt. Die Einheit sind Notenlinienabstände. Bögen allerdings können nicht beliebig weit weg positioniert werden. LilyPond erstellt zunächst eine Liste an möglichen Positionen für den Bogen und findet normalerweise die Version, die „am besten aussieht“. Wenn die positions-Eigenschaft verändert worden ist, wird der Bogen aus der Liste gewählt, der der gewünschten Position am nächsten kommt.

Ein bestimmtes Objekt hat vielleicht nicht alle dieser Eigenschaften. Darum ist es nötig, in der IR nachzuschlagen, welche Eigenschaften ein bestimmtes Objekt unterstützt.

Hier ist eine Liste an Objekten, die am wahrscheinlichsten an einer Kollision beteiligt sind, daneben findet sich die Bezeichnung des Objektes, mit der Sie es in der IR finden, um zu bestimmen, welche Eigenschaften benutzt werden können, um es zu verschieben.

4.5.2 Überlappende Notation in Ordnung bringen

Hier soll nun gezeigt werden, wie die Eigenschaften, die im vorigen Abschnitt vorgestellt wurden, bei der Problemlösung mit sich überschneidenden Notationselementen eingesetzt werden können.

padding (Fülleigenschafte)

Die padding-(Verschiebungs-)Eigenschaft kann benutzt werden, um den Abstand zwischen Symbolen zu vergößern (oder zu verkleinern), die über oder unter den Noten gesetzt werden.

c2\fermata
\override Script #'padding = #3
b2\fermata

% This will not work, see below
\override MetronomeMark #'padding = #3
\tempo 4 = 120
c1 |
% This works
\override Score.MetronomeMark #'padding = #3
\tempo 4 = 80
d1 |

Im zweiten Beispiel können Sie sehen, wie wichtig es ist den richtigen Kontext anzugeben. Weil das MetronomeMark-Objekt sich im Score-Kontext befindet, werden Eigenschaftsänderungen im Voice-Kontext einfach ignoriert. Für mehr Einzelheiten siehe Eigenschaften verändern.

Wenn die padding-Eigenschaft eines Objektes erhöht wird, das sich in einem Stapel von Objekten befindet, die nach ihrer Außersystempriorität (outside-staff-priority) positioniert werden, werden das Objekt und alle, die sich außerhalb davon befinden, entsprechend verschoben.

right-padding (Verschieben nach links)

Die right-padding-Eigenschaft wirkt sich auf den Abstand zwischen einem Versetzungszeichen und der Note, auf das sie sich bezieht, aus. Sie wird nicht sehr oft benötigt, aber die Standardanordnung kann für einige spezielle Versetzungszeichen-Glyphen oder Kombinationsglyphen, wie sie für Mikrotonale Musik benutzt werden, falsch sein. Derartige Glyphen müssen notiert werden, indem man den Stencil des Versetzungszeichens mit einer Textbeschriftung (Markup) ersetzt, wie im folgenden Beispiel:

sesquisharp = \markup { \sesquisharp }
 \relative c'' {
  c4
  % This prints a sesquisharp but the spacing is too small
  \once \override Accidental
    #'stencil = #ly:text-interface::print
  \once \override Accidental #'text = #sesquisharp
  cis4 c
  % This improves the spacing
  \once \override Score.AccidentalPlacement #'right-padding = #0.6
  \once \override Accidental
    #'stencil = #ly:text-interface::print
  \once \override Accidental #'text = #sesquisharp
  cis4
}

Dazu ist aber ein \override-Befehl für den Stencil des Versetzungszeichens nötig, der bisher nicht behandelt wurde. Der Typ des Stencils muss eine Prozedur sein, die hier geändert wurde, um den Inhalt der text-Eigenschaft des Accidental (Versetzungszeichen)-Objekts zu setzen. Die text-Eigenschaft wiederum wird als sesquisharp-Glyph definiert. Dieser Glyph wird dann weiter vom Notenkopf entfernt durch die Veränderung von right-padding mit einem \override-Befehl.

staff-padding (Systemfüllungseigenschaft)

staff-padding (Verschiebung zum Notensystem) kann verwendet werden um Objekte wie Dynamikzeichen an einer Grundlinie auf einer bestimmten Höhe über dem System auszurichten, sodass sie nicht von der Position der Note abhängen, an die sie angehängt sind. Diese Verschiebung ist keine Eigenschaft von DynamicText, sondern von DynamicLineSpanner. Das liegt daran, dass die Grundlinie sich gleicherweise auf alle Dynamikzeichen beziehen soll, also auch auf die, die als Strecker erstellt wurden. Hier also die Lösung, die Dynamikzeichen aus dem Beispiel des vorigen Abschnitts auszurichten:

\dynamicUp
% Extend width by 1 unit
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
% Align dynamics to a base line 2 units above staff
\override DynamicLineSpanner #'staff-padding = #2
a4\f b\mf c\mp b\p

self-alignment-X (Selbstausrichtung-X-Eigenschaft)

Das nächste Beispiel zeigt, wie man den Zusammenstoß einer Fingersatzbezeichnung mit einem Notenhals verhindern kann, indem die rechte Ecke an dem Referenzpunkt der abhängigen Note angeordnet wird:

\voiceOne
< a\2 >
\once \override StringNumber #'self-alignment-X = #RIGHT
< a\2 >

staff-position (Position innerhalb des Systems)

Vieltaktpausen in einer Stimmen können mit Noten in anderen Stimmen kollidieren. Da diese Pausen zentriert zwischen den Taktlinien gesetzt werden, würde es für LilyPond eine recht große Anstrengung bedeuten herauszufinden, welche Noten mit ihnen zusammenstoßen könnten, denn alle Kollisionsvermeidung für Noten und Pausen funktioniert nur für Noten bzw. Pausen, die zur selben Zeit auftreten. Hier ein typisches Beispiel für eine Kollision dieser Art:

<< { c4 c c c } \\ { R1 } >>

Die beste Lösung ist es, die Ganztaktpause nach unten zu schieben, denn die Pause ist in der zweiten Stimme. Per Standardeinstellung für die zweite Stimme (\voiceTwo, also die zweite Stimme in der <<{...} \\ {...}>>-Konstruktion) wird die Position auf dem System (staff-position) auf -4 für MultiMeasureRest, in unserem Beispiel muss es also bspw. auf die Position -8 gesetzt werden, d.h. vier halbe Notenlinienabstände weiter nach unten:

<<
  { c4 c c c }
  \\
  \override MultiMeasureRest #'staff-position = #-8
  { R1 }
>>

Das ist besser, als etwa extra-offset zu benutzen, denn in unserem Fall wird die Hilfslinie der Pause automatisch gesetzt.

extra-offset (Genaues Positionieren)

Die extra-offset-Eigenschaft bietet vollständige Kontrolle über die Positionierung von Objekten in horizontaler und vertikaler Richtung.

Im Beispiel unten ist das zweite Fingersatzzeichen (Fingering) etwas nach links und 1,8 Notenlinienabstände nach unten verschoben:

\stemUp
f4-5
\once \override Fingering #'extra-offset = #'(-0.3 . -1.8)
f4-5

Ausrichtungseigenschaft

Die positions-Eigenschaft erlaubt die Kontrolle von Position und Steigung von Balken, Legato- und Phrasierungsbögen sowie Triolenklammern. Hier ein Beispiel, in der ein unschöner Phrasierungsbogen auftritt, weil er den Bogen des Vorschlags vermeidet:

r4  \acciaccatura e8\( d8 c~ c d c d\)

Man könnte einfach den Phrasierungsbogen oberhalb der Noten setzen, und das wäre auch die beste Lösung:

r4
\phrasingSlurUp
\acciaccatura e8\( d8 c~ c d c d\)

aber wenn es einen Grund geben sollte, warum das nicht geht, könnte man das linke Ende des Phrasierungsbogens etwas nach unten verschieben, indem man die positions-Eigenschaft einsetzt. Damit verschwindet auch die etwas unschöne Form:

r4
\once \override PhrasingSlur #'positions = #'(-4 . -3)
\acciaccatura e8\( d8 c~ c d c d\)

Hier noch ein weiteres Beispiel aus der Einleitung von Chopins Prelude Op. 28 Nr. 2, das untere System. Wie zu sehen ist, stößt der Balken mit den oberen Noten zusammen:

{
  \clef "bass"
  << { b,8 ais, b, g, } \\ { e, g e, g } >>
  << { b,8 ais, b, g, } \\ { e, g e, g } >>
}

Das kann manuell gelöst werden, indem beide Enden des Balkens von ihrer Position 2 Notenlinienabstände über der Mittellinie hochgeschoben werden, etwa auf 3:

{
  \clef "bass"
  <<
    \override Beam #'positions = #'(3 . 3)
    { b,8 ais, b, g, }
  \\
    { e, g e, g }
  >>
  << { b,8 ais, b, g, } \\ { e, g e, g } >>
}

Hier ist zu beobachten, dass die Veränderung sich auch auf die weiteren Achtelbalken der ersten Stimme auswirkt, während sie keine Auswirkung auf die Balken der zweiten Stimme hat.

force-hshift (vertikale Verschiebunseigenschaft)

An diesem Punkt können wir den letzten Feinschliff an unserem Chopin-Beispiel vornehmen, das wir behandelt haben in Ich höre Stimmen. Wir hatten es in folgende Form gebracht:

\new Staff \relative c'' {
  \key aes \major
  <<
    { c2 aes4. bes8 }
    \\
    { aes2 f4 fes }
    \\
    {
      \voiceFour
      <ees c>2 des
    }
  >> |
  <c ees aes c>1 |
}

Die unteren zwei Noten des ersten Akkords (also die in der dritten Stimme) sollten nicht aus der Notenkolumne der oberen zwei Noten weggeschoben werden. Um das zu korrigieren, setzen wir force-hshift, das eine Eigenschaft von NoteColumn ist, für diese Noten auf Null. Die untere Note des zweiten Akkordes wird am besten direkt rechts von den oberen Noten gesetzt. Das erreichen wir, indem wir force-hshift für diese Note auf 0.5 setzen, also eine halbe Notenkopfbreite nach rechts von der Kolumne der oberen Noten aus.

Hier das Endergebnis:

\new Staff \relative c'' {
  \key aes \major
  <<
    { c2 aes4. bes8 }
    \\
    { aes2 f4 fes }
    \\
    {
      \voiceFour
      \once \override NoteColumn #'force-hshift = #0
      <ees c>2
      \once \override NoteColumn #'force-hshift = #0.5
      des2
    }
  >> |
  <c ees aes c>1 |
}

4.5.3 Beispiele aus dem Leben

Das Kapitel zu Optimierungen soll mit einem komplizierten Beispiel beendet werden, in dem verschiedene Optimierungen vorgenommen werden müssen, bis das Ergebnis gut aussieht. Das Beispiel wurde ganz bewusst gewählt um die Benutzung der Notationsreferenz zu zeigen, wenn ungewöhnliche Notationsprobleme gelöst werden müssen. Es ist nicht repräsentativ für normale Notationsprojekte, lassen Sie sich also nicht durch dieses Beispiel entmutigen! Zum Glück sind Probleme wie die hier gezeigten nicht sehr häufig.

Das Beispiel stammt aus Chopins Premiére Ballade, Op. 23, Takte 6–9, der Übergang vom Lento der Einleitung zum Moderato. Hier zunächst der Satz, wie er aussehen soll, allerdings ohne Dynamik, Fingersatz und Pedalbezeichnung, um das Beispiel nicht zu kompliziert zu machen.

Die erste Überlegung ist, dass das System für die rechte Hand im dritten Takt vier Stimmen braucht. Das sind die fünf Achtelnoten mit Balken, das übergebundene C, die Halbe D, die mit der Achtel D verschmolzen ist, und die punktierte Viertel Fis, die auch mit einer Achtelnote verschmolzen ist. Alles andere ist eine einzige Stimme, es ist also am einfachsten, die zusätzlichen drei Stimmen nur zeitweise zu erstellen, wenn sie auftreten. Wenn Sie vergessen haben, wie man das anstellt, schauen Sie sich nochmal den Abschnitt Ich höre Stimmen und Stimmen explizit beginnen an. Hier wollen wir explizit begonnene Stimmen für die polyphone Stelle benutzen, weil LilyPond Kollisionen besser vermeidet, wenn alle Stimmen auf diese Weise explizit begonnen werden.

Wir wollen anfange, indem wir die Noten in zwei Variablen notieren und dann die Systemstruktur in einer \score-Umgebung erstellen. Das ist, was LilyPond erstellt:

rhMusic = \relative c'' {
  \new Voice {    r2 c4. g8 |
    bes1~ |
    \time 6/4
    bes2. r8
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        c,8~ c2
      }
      \new Voice {
        \voiceThree
        s8 d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    g2.  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2 |
  <d g, d>1 |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
    \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

Alle Noten sind richtig, aber die Positionierung sehr verbesserungsbedürftig. Der Bindebogen kollidiert mit der veränderten Taktart zusammen, einige Noten werden nicht verschmolzen und einige Notationselemente fehlen ganz. Behandeln wir zunächst die einfacheren Dinge. Der Balken kann durch eine manuelle Begrenzung einfach korrigiert werden, und auch der Legatobogen der linken Hand und der Phrasierungsbogen der rechten Hand sind schnell gesetzt, denn sie wurden schon in der Übung erklärt. Damit haben wir folgendes Notenbild:

rhMusic = \relative c'' {
  \new Voice {
    r2 c4.\( g8 |
    bes1~ |
    \time 6/4
    bes2. r8
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        c,8~ c2
      }
      \new Voice {
        \voiceThree
        s8 d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    g2.\)  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2( |
  <d g, d>1) |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
    \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

Der erste Takt stimmt jetzt schon. Der zweite Takt enthält ein Arpeggio und wird mit einer doppelten Taktlinie beschlossen. Wie können wir diese notieren, denn sie sind im Handbuch zum Lernen nicht vorgekommen? Hier brauchen wir jetzt die Notationsreferenz. Ein Blick in den Index zeigt uns die Einträge für „Arpeggio“ und „Taktlinien“: ein Arpeggio also erstellt man mit dem Befehl \arpeggio hinter einem Akkord und eine doppelte Taktlinie wird mit dem Befehl \bar "||" erstellt. Das ist einfach. Als nächstes muss der Zusammenstoß des Bindebogens mit der Taktartbezeichnung gelöst werden. Das geht am besten, indem wir den Bogen nach oben verschieben. Wie man Objekte verschiebt wurde schon behandelt in Verschieben von Objekten, wo stand, dass Objekte die relativ zum System positioniert werden, vertikal verschoben werden können, indem ihre staff-position-Eigenschaft geändert wird, die in halben Notenlinienabständen relativ zur Mittellinie angegeben wird. Dieser \override-Befehl also, direkt vor die erste übergebundene Note gestellt, verschiebt den Bindebogen (tie) 3,5 halbe Notenlinienabstände über die Mittellinie:

\once \override Tie #'staff-position = #3.5

Damit ist auch der zweite Takt vollständig:

rhMusic = \relative c'' {
  \new Voice {
    r2 c4.\( g8 |
    \once \override Tie #'staff-position = #3.5
    bes1~ |
    \bar "||"
    \time 6/4
    bes2. r8
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        c,8~ c2
      }
      \new Voice {
        \voiceThree
        s8 d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    g2.\)  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2( |
  <d g, d>1)\arpeggio |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
    \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

In Takt drei beginnt der Moderato-Abschnitt. In der Übung wurde behandelt, wie man fetten Text mit dem \markup-Befehl eingibt, es ist also einfach, das „Moderato“ in fetter Schrift hinzuzufügen. Wie aber werden Noten verschmolzen? Hier nehmen wir wieder die Notationsreferenz zu Hilfe. Die Suche nach „Verschmelzen“ (engl. merge) im Index führt uns zu den Befehlen, um Noten mit unterschiedlichen Köpfen und unterschiedlichen Punkten zu verschmelzen, in Auflösung von Zusammenstößen. In unserem Beispiel müssen sowohl unterschiedliche Köpfe also auch unterschiedliche Punktierung verschmolzen werden, wir brauchen also die Befehle

\mergeDifferentlyHeadedOn
\mergeDifferentlyDottedOn

aus der Notationsreferenz, die wir an den Beginn unseres Abschnittes stellen und

\mergeDifferentlyHeadedOff
\mergeDifferentlyDottedOff

um das Verhalten wieder auszuschalten. Das sieht so aus:

rhMusic = \relative c'' {
  \new Voice {
    r2 c4.\( g8 |
    \once \override Tie #'staff-position = #3.5
    bes1~ |
    \bar "||"
    \time 6/4
    bes2.^\markup { \bold "Moderato" } r8
    \mergeDifferentlyHeadedOn
    \mergeDifferentlyDottedOn
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        c,8~ c2
      }
      \new Voice {
        \voiceThree
        s8 d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    \mergeDifferentlyHeadedOff
    \mergeDifferentlyDottedOff
    g2.\)  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2( |
  <d g, d>1)\arpeggio |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
    \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

Mit diesen Veränderungen wurden die beiden Fis-Noten verschmolzen, aber nicht die zwei Ds. Warum nicht? Die Antwort befindet sich im gleicher Abschnitt der Notationsreferenz: Noten, die verschmolzen werden, müssen Hälse in entgegengesetzte Richtungen aufweisen und zwei Noten können nicht verschmolzen werden, wenn eine dritte Noten in der gleichen Kolumne stört. In unserem Fall weisen beide Hälse nach oben und es befindet sich zur gleichen Zeit auch noch eine dritte Note, das C. Wie die Richtung von Hälsen geändert wird, wissen wir schon: mit \stemDown, und in der Notationsreferenz findet sich auch Information, wie das C verschoben werden kann: mit dem \shift-Befehl. Aber welcher von ihnen? Das C befindet sich in der zweiten Stimme, die „shift off“ hat, die zwei Ds sind in den Stimmen eins und drei, die „shift off“ bzw. „shift on“ haben. Das C muss also noch eine Stufe weiter verschoben werden mit \shiftOnn, damit es die Verschmelzung der Ds nicht stört. Das sieht jetzt so aus:

rhMusic = \relative c'' {
  \new Voice {
    r2 c4.\( g8 |
    \once \override Tie #'staff-position = #3.5
    bes1~ |
    \bar "||"
    \time 6/4
    bes2.^\markup { \bold "Moderato" } r8
    \mergeDifferentlyHeadedOn
    \mergeDifferentlyDottedOn
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        % Move the c2 out of the main note column so the merge will work
        c,8~ \shiftOnn c2
      }
      \new Voice {
        \voiceThree
        % Stem on the d2 must be down to permit merging
        s8 \stemDown d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    \mergeDifferentlyHeadedOff
    \mergeDifferentlyDottedOff
    g2.\)  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2( |
  <d g, d>1)\arpeggio |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
   \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

Fast schon geschafft. Nur noch ein Problem ist übrig: Der Hals nach unten des verschmolzenen sollte nicht da sein, und das C sähe besser auf der rechten Seite des Ds aus. Beides können wir mit den gelernten Optimierungsmethoden erreichen. Den Hals machen wir durchsichtig und das C verschieben wir mit der force-hshift-Eigenschaft. Hier ist das Endergebnis:

rhMusic = \relative c'' {
  \new Voice {
    r2 c4.\( g8 |
    \once \override Tie #'staff-position = #3.5
    bes1~ |
    \bar "||"
    \time 6/4
    bes2.^\markup { \bold "Moderato" } r8
    \mergeDifferentlyHeadedOn
    \mergeDifferentlyDottedOn
    % Start polyphonic section of four voices
    <<
      { c,8 d fis bes a }  % continuation of main voice
      \new Voice {
        \voiceTwo
        c,8~
        % Reposition the c2 to the right of the merged note
        \once \override NoteColumn #'force-hshift = #1.0
        % Move the c2 out of the main note column so the merge will work
        \shiftOnn
        c2
      }
      \new Voice {
        \voiceThree
        s8
        % Stem on the d2 must be down to permit merging
        \stemDown
        % Stem on the d2 should be invisible
        \once \override Stem #'transparent = ##t
        d2
      }
      \new Voice {
        \voiceFour
        s4 fis4.
      }
    >> |
    \mergeDifferentlyHeadedOff
    \mergeDifferentlyDottedOff
    g2.\)  % continuation of main voice
  }
}

lhMusic = \relative c' {
  r2 <c g ees>2( |
  <d g, d>1)\arpeggio |
  r2. d,,4 r4 r |
  r4
}

\score {
  \new PianoStaff <<
    \new Staff = "RH"  <<
      \key g \minor
      \rhMusic
    >>
    \new Staff = "LH" <<
      \key g \minor
      \clef "bass"
      \lhMusic
    >>
  >>
}

4.6 Weitere Optimierungen

4.6.1 Andere Benutzung von Optimierungen

Noten zwischen unterschiedlichen Stimmen überbinden

Das nächste Beispiel zeigt, wie man Noten von verschiedenen Stimmen miteinander verknüpfen kann, indem man Bindebögen für Überbindungen benutzt. Normalerweise können nur zwei Noten der gleichen Stimme übergebunden werden. Wenn man zwei Stimmen benutzt, wobei die überbundenen Noten sich in der selben befinden,

und dann den ersten Hals nach oben unsichtbar macht, sieht es so aus, als ob die Überbindung zwischen den Stimmen stattfindet:

<<
  {
    \once \override Stem #'transparent = ##t
    b8~ b\noBeam
  }
\\
  { b8[ g] }
>>

Um sicherzugehen, dass der unsichtbare Hals den Bindebogen nicht zu sehr verkleinert, kann er verlängert werden, indem seine Länge (length) auf den Wert 8 gesetzt wird:

<<
  {
    \once \override Stem #'transparent = ##t
    \once \override Stem #'length = #8
    b8~ b\noBeam
  }
\\
  { b[ g8] }
>>

Eine Fermate in MIDI simulieren

Für Objekte außerhalb des Notensystems ist es normalerweise besser, die stencil-Eigenschaft anstelle der transparent-Eigenschaft zu verändern, wenn man sie vom fertigen Notensatz entfernen will. Indem die stencil-Eigenschaft auf falsch (#f) gesetzt wird, wird das entsprechende Objekt vollständig entfernt. Das bedeutet, dass es die Positionierung der anderen Objekte nicht beeinflusst.

Auf diese Art kann etwa das Tempo geändert werden, damit in der MIDI-Ausgabe eine Fermate zu hören ist, ohne dass im Notensatz etwas von diesen Tempoänderungen zu sehen ist. Die Metronombezeichnung soll auch nicht die Position von Text an der gleichen Stelle oder die Abstände zwischen zwei Systemen beeinflussen. Darum ist es am besten, stencil auf #f zu setzen. Im Beispiel wird der Unterschied zwischen einem unsichtbaren Objekt und einem entfernten Objekt gezeigt:

\score {
  \relative c'' {
    % Visible tempo marking
    \tempo 4=120
    a4 a a
    \once \override Score.MetronomeMark #'transparent = ##t
    % Invisible tempo marking to lengthen fermata in MIDI
    \tempo 4=80
    a4\fermata
    % New tempo for next section
    \tempo 4=100
    a4 a a a
  }
  \layout { }
  \midi { }
}

\score {
  \relative c'' {
    % Visible tempo marking
    \tempo 4=120
    a4 a a
    \once \override Score.MetronomeMark #'stencil = ##f
    % Invisible tempo marking to lengthen fermata in MIDI
    \tempo 4=80
    a4\fermata
    % New tempo for next section
    \tempo 4=100
    a4 a a a
  }
  \layout { }
  \midi { }
}

Mit beiden Methoden wird die Tempobezeichnung entfernt, mit der die Fermate verlängert wird, und beide beeinflussen die MIDI-Ausgabe wie gewünscht. Die unsichtbare Metronombezeichnung schiebt aber die folgende Bezeichnung in die Höhe, während das im zweiten Beispiel, in dem der stencil entfernt wurde, nicht passiert.

Siehe auch

Glossar: system.

4.6.2 Variablen für Optimierungen einsetzen

\override-Befehle sind oft lang und mühsam zu tippen, und sie müssen immer absolut richtig sein. Wenn derselbe Befehl mehrere Male benutzt werden muss, lohnt es sich oft schon, eine Variable zu definieren, in der er sich befindet.

Als Beispiel sollen einige Worte im Gesangstext fett und kursiv hervorgehoben werden. Die Befehle \italic und \bold funktionieren im Gesangstext-Kontext nur, wenn sie gleichzeitig mit den Wörtern, auf die sie angewendet werden sollen, zusätzlich in eine \markup-Umgebung eingeschlossen werden. Durch diese Einbettung können einzelne Wörter nicht einfach zu einer Variable umgeformt werden. Als Alternative versuchen wir, einen Befehl mit \override und \revert zu konstruieren.

\override Lyrics . LyricText #'font-shape = #'italic
\override Lyrics . LyricText #'font-series = #'bold

\revert Lyrics . LyricText #'font-shape
\revert Lyrics . LyricText #'font-series

Das wäre natürlich noch viel mühsamer, wenn viele Wörter eine Hervorhebung benötigen. Anstelle dieser Befehlsketten können wir jedoch zwei Variablen definieren. Mit ihnen und dem entsprechenden Wort in geschweiften Klammern erreichen wir den gewünschten Effekt. Ein weiterer Vorteil ist, dass in diesem Fall die Leerzeichen um die Punkte herum nicht benötigt werden, weil sie nicht innerhalb des lyricmode-Kontextes interpretiert werden. Hier ein Beispiel; die Bezeichnungen können natürlich auch kürzer sein, um noch weniger schreiben zu müssen:

emphasize = {
  \override Lyrics.LyricText #'font-shape = #'italic
  \override Lyrics.LyricText #'font-series = #'bold
}
normal = {
  \revert Lyrics.LyricText #'font-shape
  \revert Lyrics.LyricText #'font-series
}

global = { \key c \major \time 4/4 \partial 4 }

SopranoMusic = \relative c' { c4 | e4. e8 g4 g    | a4   a   g  }
AltoMusic    = \relative c' { c4 | c4. c8 e4 e    | f4   f   e  }
TenorMusic   = \relative c  { e4 | g4. g8 c4.  b8 | a8 b c d e4 }
BassMusic    = \relative c  { c4 | c4. c8 c4 c    | f8 g a b c4 }

VerseOne = \lyrics {
  E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
}

VerseTwo = \lyricmode {
  O | \emphasize Christ, \normal whose voice the | wa -- ters heard,
}

VerseThree = \lyricmode {
  O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
}

VerseFour = \lyricmode {
  O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
}

\score {
  \new ChoirStaff <<
    \new Staff <<
      \clef "treble"
      \new Voice = "Soprano"  { \voiceOne \global \SopranoMusic }
      \new Voice = "Alto" { \voiceTwo \AltoMusic }
      \new Lyrics \lyricsto "Soprano" { \VerseOne }
      \new Lyrics \lyricsto "Soprano" { \VerseTwo }
      \new Lyrics \lyricsto "Soprano" { \VerseThree }
      \new Lyrics \lyricsto "Soprano" { \VerseFour }
    >>
    \new Staff <<
      \clef "bass"
      \new Voice = "Tenor" { \voiceOne \TenorMusic }
      \new Voice = "Bass"  { \voiceTwo \BassMusic }
    >>
  >>
}

4.6.3 Globale Formatierung

Die Ausgabe von LilyPond kann sehr stark verändert werden, siehe zu Einzelheiten Die Ausgabe verändern. Aber was ist, wenn man mehrere Eingabedateien hat, die die gleichen Anpassungen erfahren sollen? Oder wenn Sie einfach nur die Anpassungen von der eigentlichen Musik trennen wollen? Das lässt sich recht einfach erreichen.

Schauen wir uns ein Beispiel an. Sorgen Sie sich nicht, wenn Sie den Abschnitt mit den vielen #() nicht verstehen. Das wird erklärt in Fortgeschrittene Optimierungen mit Scheme.

mpdolce =
#(make-dynamic-script
  (markup #:hspace 0
          #:translate '(5 . 0)
          #:line (#:dynamic "mp"
                  #:text #:italic "dolce")))

inst =
#(define-music-function
     (parser location string)
     (string?)
   (make-music
    'TextScriptEvent
    'direction UP
    'text (markup #:bold (#:box string))))

\relative c'' {
  \tempo 4=50
  a4.\mpdolce d8 cis4--\glissando a |
  b4 bes a2 |
  \inst "Clarinet"
  cis4.\< d8 e4 fis |
  g8(\! fis)-. e( d)-. cis2 |
}

Es gibt einige Probleme mit sich überschneidender Ausgabe, die wird zurechtgerückt mit den Techniken von Verschieben von Objekten. Aber jetzt zu den Definitionen von mpdolce und inst. Sie erstellen die gewünschte Ausgabe, aber wir wollen sie vielleicht auch in einem anderen Stück verwenden. Wir könnten sie immer wieder kopieren und oben in jedes Stück einfügen, aber das ist sehr aufwändig. Dadurch werden die Definitionen auch in der Eingabedatei belassen, und ich finde diese #() irgendwie hässlich. Verstecken wir sie also:

%%% in Datei "definitions.ily" speichern
mpdolce =
#(make-dynamic-script
  (markup #:hspace 0
          #:translate '(5 . 0)
          #:line (#:dynamic "mp"
                  #:text #:italic "dolce")))

inst =
#(define-music-function
     (parser location string)
     (string?)
   (make-music
    'TextScriptEvent
    'direction UP
    'text (markup #:bold (#:box string))))

Diese Datei wir mit dem \include-Befehl ziemlich weit oben in der Datei eingefügt. (Die Erweiterung ‘.ily’ wird benutzt, um diese Datei als eine eingefügte, inkludierte zu kennzeichnen, die man nicht alleinstehend kompilieren kann.) Jetzt ändern wir die Noten (in der Datei ‘music.ly’).

\include "definitions.ily"

\relative c'' {
  \tempo 4=50
  a4.\mpdolce d8 cis4--\glissando a |
  b4 bes a2 |
  \inst "Clarinet"
  cis4.\< d8 e4 fis |
  g8(\! fis)-. e( d)-. cis2 |
}

Das sieht schon besser aus, aber einige Änderungen könnten wir noch vornehmen. Das Glissando ist kaum sichtbar, machen wir es also etwas dicker und näher an den Notenkopf. Die Metronombezeichnung soll über dem Schlüssel stehen, anstatt über der ersten Note. Und schließlich mag mein Kompositionsprofessor keine „C“-Taktangaben, das ändern wir also in „4/4“.

Ändern Sie jetzt jedoch nicht ‘music.ly’. Ändern Sie die ‘definitions.ily’ mit dem Folgenden:

%%%  definitions.ily
mpdolce =
#(make-dynamic-script
  (markup #:hspace 0
          #:translate '(5 . 0)
          #:line (#:dynamic "mp"
                  #:text #:italic "dolce")))

inst =
#(define-music-function
     (parser location string)
     (string?)
   (make-music
    'TextScriptEvent
    'direction UP
    'text (markup #:bold (#:box string))))

\layout{
  \context {
    \Score
    \override MetronomeMark #'extra-offset = #'(-9 . 0)
    \override MetronomeMark #'padding = #'3
  }
  \context {
    \Staff
    \override TimeSignature #'style = #'numbered
  }
  \context {
    \Voice
    \override Glissando #'thickness = #3
    \override Glissando #'gap = #0.1
  }
}

Das sieht besser aus! Aber nehmen wir an, Ich will dieses Stück publizieren. Mein Professor mag die „C“-Taktangabe nicht, mir gefällt sie aber sehr gut. Kopieren wir also die Datei ‘definitions.ily’ nach ‘web-publish.ily’ und verändern diese. Weil die Noten als PDF auf dem Monitor dargestellt werden sollen, wird auch die Notengröße global geändert.

%%%  definitions.ily
mpdolce =
#(make-dynamic-script
  (markup #:hspace 0
          #:translate '(5 . 0)
          #:line (#:dynamic "mp"
                  #:text #:italic "dolce")))

inst =
#(define-music-function
     (parser location string)
     (string?)
   (make-music
    'TextScriptEvent
    'direction UP
    'text (markup #:bold (#:box string))))

#(set-global-staff-size 23)

\layout{
  \context {
    \Score
    \override MetronomeMark #'extra-offset = #'(-9 . 0)
    \override MetronomeMark #'padding = #'3
  }
  \context {
    \Staff
  }
  \context {
    \Voice
    \override Glissando #'thickness = #3
    \override Glissando #'gap = #0.1
  }
}

In der Eingabedatei muss jetzt nur noch die Zeile \include "definitions.ily" mit \include "web-publish.ily" ersetzt werden. Das könnte man natürlich noch besser machen. Es könnte eine Datei ‘definitions.ily’ mit allen Definitionen (also mpdolce und inst) geben, eine Datei ‘web-publish.ily’, die nur die \layout-Veränderung enthält und eine Datei ‘university.ily’, die nur die Prozedur enthält, die Ausgabe meinem Professor angenehm zu machen. Der Anfang von ‘music.ly’ würde dann folgendermaßen aussehen:

\include "definitions.ily"

%%%  nur eine der zwei Zeilen auskommentieren!
\include "web-publish.ily"
%\include "university.ily"

Diese Herangehensweise kann auch schon nützlich sein, wenn man nur ein paar Stimmen schreiben will. Ich habe eine ganze Anzahl an „Stylesheets“ für meine Projekte. Ich fange jede Datei mit der Zeile \include "../global.ily" an, die etwa folgendes einbindet:

%%%   global.ily
\version "2.13.45"

#(ly:set-option 'point-and-click #f)

\include "../init/init-defs.ly"
\include "../init/init-layout.ly"
\include "../init/init-headers.ly"
\include "../init/init-paper.ly"

4.6.4 Mehr Information

Die Programmreferenz enthält sehr viel Information über LilyPond, aber noch mehr Information findet sich in den internen LilyPond-Dateien. Um sie erforschen zu können, müssen Sie erst das richtige Verzeichnis auf Ihrem System finden. Die Position hängt a) davon ab, ob Ihre LilyPond-Installation mit der vorkompilierten Version von der LilyPond-Internetseite vorgenommen wurde oder Sie die Version durch Ihren Paketmanager installiert haben (also z. B. in einer Linux-Distribution oder unter fink oder cygwin installiert), und b) auf welchem Betriebssystem Sie das Programm benutzen:

Von lilypond.org heruntergeladen

• Linux

  Wechseln Sie in das Verzeichnis ‘INSTALL_VERZ/lilypond/usr/share/lilypond/current/’

• MacOS X

  Wechseln Sie in das Verzeichnis ‘INSTALL_VERZ/LilyPond.app/Contents/Resources/share/lilypond/current/’ indem Sie entweder mit dem Befehl cd vom Terminal aus in das Verzeichnis wechseln, oder mit Control-Klick auf das LilyPond-Programmsymbol gehen und „Show Package Contents“ auswählen.

• Windows

  Wechseln Sie mit dem Windows Explorer ins Verzeichnis ‘INSTALL_VERZ/LilyPond/usr/share/lilypond/current/’

Mit einem Paket-Manager installiert oder selber aus den Quellen kompiliert

Wechseln Sie in das Verzeichnis ‘PREFIX/share/lilypond/X.Y.Z/’, wobei PREFIX bei Ihrem Paket-Manager oder dem configure-Skript gesetzt wird, und X.Y.Z die LilyPond-Versionsnummer.

In diesem Ordner sind die zwei interessanten Unterordner:

• ‘ly/’ - beinhaltet Dateien im LilyPond-Format
• ‘scm/’ - beinhaltet Dateien im Scheme-Format

Schauen wir uns zuerst einige Dateien in ‘ly/’ an. Öffnen Sie ‘ly/property-init.ly’ in einem Texteditor. Der, den Sie normalerweise für ‘.ly’-Dateien benutzen, genügt. Diese Datei enthält die Definitionen aller vordefinierten Befehle für LilyPond, wie etwa \stemUp und \slurDotted. Sie können sehen, dass es sich um nichts mehr handelt als Definitionen von Variablen, die eine oder mehrere \override-Befehle enthalten. Der Befehl /tieDotted etwa wird folgendermaßen definiert:

tieDotted = {
  \override Tie #'dash-period = #0.75
  \override Tie #'dash-fraction = #0.1
}

Wenn Sie diese Voreinstellungen der vordefinierten Befehl nicht mögen, können Sie sie ganz einfach umdefinieren, genauso wie jede andere Variable auch, indem Sie sie an den Anfang Ihrer Quelldatei schreiben.

Hier sind die wichtigsten Dateien, die sich im Ordner ‘ly/’ befinden:

Andere Einstellungen (wie die Definitionen von Beschriftungsbefehlen) sind in ‘.scm’-(Scheme)-Dateien gespeichert. Die Scheme-Programmiersprache wird benutzt, um eine programmierbare Schnittstelle zu den internen Operationen von LilyPond zu haben. Eine weitere Erklärung dieser Dateien ist im Moment außerhalb des Rahmens dieses Handbuchs, denn sie erfordern einige Kenntnis der Scheme-Sprache. Die Warnung ist hier angebracht, dass des ein gutes technisches Verständnis oder sehr viel Zeit braucht, um Scheme und diese Dateien zu verstehen (siehe auch Scheme-Übung).

Wenn Sie sich mit Scheme auskennen, sind hier mögliche interessante Dateien:

4.6.5 Vermeiden von Optimierungen durch langsamere Übersetzung

LilyPond kann einige zusätzliche Tests durchführen, während die Noten gesetzt werden. Dadurch braucht das Programm länger, um den Notensatz zu produzieren, aber üblicherweise werden weniger nachträgliche Anpassungen nötig sein. Wenn eine Textsilbe oder eine Beschriftung aus dem Rand der Partitur ragt, wird durch diese Tests die Zeile gerade so weit komprimiert, dass sie sich innerhalb der Ränder befindet.

Damit diese Tests immer funktionieren, müssen sie aktiviert werden, indem die \override-Befehle in einer context-Umgebung innerhalb der layout-Umgebung notiert werden und nicht innerhalb der Noten:

\score {
  { …Noten… }
  \layout {
    \context {
      \Score
 %  Um sicher zu gehen, dass Texte und Liedtext
 %  innerhalb der Papierränder bleiben
 \override PaperColumn #'keep-inside-line = ##t
 \override NonMusicalPaperColumn #'keep-inside-line = ##t
    }
  }
}

keep-inside-line braucht jedoch sehr viel Berechnungen, sodass es sich anbietet, diese Funktion zunächst nicht zu aktivieren und erst einzufügen, wenn man die endgültige Version erstellt. Auf diese Weise muss man nicht mit der Hand \break-Befehle hinzufügen, um zu vermeiden, dass Text über den rechten Rand der Seite hinausragt.

4.6.6 Fortgeschrittene Optimierungen mit Scheme

Auch wenn viele Sachen mit \override und \tweak möglich sind, gibt es eine sehr viel mächtigere Möglichkeit, die Arbeitsweise von LilyPond mit Hilfe der programmierbaren Schnittstelle zu beeinflussen. Code, der in der Scheme-Programmiersprache geschrieben ist, kann direkt in die interne Satzmaschine von LilyPond eingefügt werden. Natürlich brauchen Sie dazu wenigstens ein grundlegendes Verständnis von Scheme. Eine Einleitung finden Sie in der Scheme-Übung.

Zur Illustration der vielen Möglichkeiten soll gezeigt werden, dass eine Eigenschaft nicht nur auf eine Konstante, sondern auch auf eine Scheme-Prozedur gesetzt werden kann, die dann jedes Mal aufgerufen wird, wenn die Eigenschaft von LilyPond benutzt wird. Die Eigenschaft kann damit dynamisch auf einen Wert gesetzt werden, der durch die Prozedur jedes Mal neu bestimmt wird. In diesem Beispiel wird die Farbe der Notenköpfe entsprechend zu ihrer Position innerhalb der Tonleiter gesetzt.

#(define (color-notehead grob)
   "Color the notehead according to its position on the staff."
   (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
                               7)))
     (case mod-position
       ;;   Return rainbow colors
       ((1) (x11-color 'red    ))  ; for C
       ((2) (x11-color 'orange ))  ; for D
       ((3) (x11-color 'yellow ))  ; for E
       ((4) (x11-color 'green  ))  ; for F
       ((5) (x11-color 'blue   ))  ; for G
       ((6) (x11-color 'purple ))  ; for A
       ((0) (x11-color 'violet ))  ; for B
       )))

\relative c' {
  % Arrange to obtain color from color-notehead procedure
  \override NoteHead #'color = #color-notehead
  a2 b | c2 d | e2 f | g2 a |
}

Weiter Beispiele, die die Benutzung dieser programmierbaren Schnittstelle zeigen, finden sich in Optimierungen mit Scheme.

A. Vorlagen

Dieser Abschnitt des Handbuches enthält Vorlagen, in denen die LilyPond-Partitur schon eingerichtet ist. Sie müssen nur noch Ihre Noten einfügen, die Datei mit LilyPond übersetzen und sich an dem schönen Notenbild erfreuen!