-@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
-@c This file is part of lilypond-learning.tely
-@ignore
- Translation of GIT committish: d96023d8792c8af202c7cb8508010c0d3648899d
-
- When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
-@end ignore
-
-@c \version "2.12.0"
-
-@node Tweaking output
-@chapter Tweaking output
-
-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.
-
-
-@menu
-* Tweaking basics::
-* The Internals Reference manual::
-* Appearance of objects::
-* Placement of objects::
-* Collisions of objects::
-* Further tweaking::
-@end menu
-
-
-@node Tweaking basics
-@section Tweaking basics
-
-@menu
-* Introduction to tweaks::
-* Objects and interfaces::
-* Naming conventions of objects and properties::
-* Tweaking methods::
-@end menu
-
-@node Introduction to tweaks
-@subsection Introduction to tweaks
-
-@qq{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 Opitmierungen sind sehr
-einfach, andere dagegen recht komplex. Aber insgesamt erlaubt das
-System an Optimierungen so gut wie alle möglichen Erscheindungsformen
-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 @ref{Contexts and engravers} 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.
-
-
-@node Objects and interfaces
-@subsection Objects and interfaces
-
-@cindex Objekte
-@cindex Grobs
-@cindex Spanners
-@cindex Interfaces
-@cindex Strecker
-@cindex Schnittstellen
-@cindex graphische Objekte (Grob)
-@cindex Objekteigenschaften
-@cindex Layout-Objekt
-@cindex Objekt, Layout-
-@cindex Eigenschaften von Objekten
-
-Optimierung bedeutet, die internen Operationen und Strukturen
-des LilyPond-Programmes zu verändern, darum sollen hier
-zunächst die wichtigesten Begriffe erklärt werden, die zur
-Beschreibung dieser Operationen und Strukturen benutzt werden.
-
-Der Begriff @qq{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 @code{\new Staff} auftritt, wird ein neues Objekt
-vom Typ @code{Staff} erstellt. Dieses Objekt @code{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
-@code{Voice}-Objekte, @code{Score}-Objekte, @code{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
-@qq{Layout-Objekte}, oft auch @qq{Graphische Objekte} genannt.
-Daraus resultiert die künstliche Abkürzung @qq{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 @qq{Strecker} (engl. Spanners)
-bezeichnet.
-
-Es bleibt uns noch übrig zu erklären, was @qq{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 @code{grob-interface} (Schnittstelle eines
-graphischen Objektes) zusammengefasst. Es gibt viele andere
-Gruppen gemeinsamer Eigenschaften, die jede eine Bezeichnung
-besitzen, welche auf @code{-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.
-
-
-@node Naming conventions of objects and properties
-@subsection Naming conventions of objects and properties
-
-@cindex Benennungskonventionen für Objekte
-@cindex Benennungskonventionen für Eigenschaften
-@cindex Objekte, Benennungskonventionen
-@cindex Eigenschaften, Benennungskonventionen
-@cindex Regeln zur Benennung von Objekten/Eigenschaften
-
-Es wurden schon früher einige Regeln zur Benennung von
-Objekten vorgestellt, siehe
-@ref{Contexts and engravers}. Hier eine Referenzliste der
-häufigsten Objekt- und Eigenschaftsbezeichnungen mit
-den Regeln für ihre Bezeichnung und
-illustrierenden echten Bezeichnungen. Es wurde @qq{A}
-für einen beliebigen Großbuchstaben und @qq{aaa} für eine
-beliebige Anzahl an Kleinbuchstaben eingesetzt. Andere
-Zeichen werden explizit angegeben.
-
-@multitable @columnfractions .33 .33 .33
-@headitem Objekt-/Eigenschaftstyp
- @tab Naming convention
- @tab Beispiele
-@item Kontexte
- @tab Aaaa oder AaaaAaaaAaaa
- @tab Staff, GrandStaff
-@item Layout-Objekte
- @tab Aaaa oder AaaaAaaaAaaa
- @tab Slur, NoteHead
-@item Engraver
- @tab Aaaa_aaa_engraver
- @tab Clef_engraver, Note_heads_engraver
-@item Schnittstellen
- @tab aaa-aaa-interface
- @tab grob-interface, break-aligned-interface
-@item Kontext-Eigenschaften
- @tab aaa oder aaaAaaaAaaa
- @tab alignAboveContext, skipBars
-@item Layout-Objekt-Eigenschaften
- @tab aaa oder aaa-aaa-aaa
- @tab direction, beam-thickness
-@end multitable
-
-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.
-
-
-@node Tweaking methods
-@subsection Tweaking methods
-
-@cindex override-Befehl
-@funindex \override
-@funindex override
-
-@strong{Der \override-Befehl}
-
-Wir haben uns schon mit den Befehlen @code{\set}
-und @code{\with} bekannt gemacht, mit welchen
-Eigenschaften von @strong{Kontexten} verändert
-und @strong{Engraver} entfernt oder hinzugefügt
-werden können. Siehe dazu
-@ref{Modifying context properties} und @ref{Adding
-and removing engravers}. Jetzt wollen wir uns weitere
-wichtige Befehle anschauen.
-
-Der Befehl, um die Eigenschaften von @strong{Layout-Objekten}
-zu ändern, ist @code{\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 werder 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:
-
-@example
-\override @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft} =
-#@var{Wert}
-@end example
-
-@noindent
-Damit wir die Eigenschaft mit der Bezeichnung @var{layout-property}
-das Layout-Objektes mit der Bezeichnung@var{LayoutObject},
-welches ein Mitglied des @var{Kontext}-Kontextes ist, auf den
-Wert @var{value}.
-
-Der @var{Kontext} kann (und wird auch normalerweise) ausgelassen
-werden, wenn der benötigte Kontext eindeutig impliziert ist und einer
-der untersten Kontexte ist, also etwa @code{Voice}, @code{ChordNames}
-oder @code{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 @code{#'}-Zeichen ignorieren, die vor jeder
-Layout-Eigenschaft, und die @code{#}-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:
-
-@cindex color-Eigenschaft, Beispiel
-@cindex Farb-Eigenschaft, Beispiel
-@cindex NoteHead, Beispiel für override
-@cindex Notenkopf, Beispiel für Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c d
-\override NoteHead #'color = #red
-e f g
-\override NoteHead #'color = #green
-a b c
-@end lilypond
-
-
-@strong{Der \revert-Befehl}
-
-@cindex revert-Befehl
-@funindex \revert
-@funindex revert
-
-Wenn eine Eigenschaft einmal überschrieben wurde, wird ihr
-neuer Wert so lange bewahrt, bis er noch einmal überschrieben
-wird oder ein @code{\revert}-Befehl vorkommt. Der
-@code{\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
-@code{\override}-Befehle benutzt wurden.
-
-@example
-\revert @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft}
-@end example
-
-Wiederum, genauso wie der @var{Kontext} bei dem @code{\override}-Befehl,
-wird @var{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.
-
-@cindex color-Eigenschaft, Beispiel
-@cindex Farb-Eigenschaft, Beispiel
-@cindex NoteHead, Beispiel für override
-@cindex Notenkopf, Beispiel für Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c d
-\override NoteHead #'color = #red
-e f g
-\override NoteHead #'color = #green
-a
-\revert NoteHead #'color
-b c
-@end lilypond
-
-@strong{\once-Präfix}
-
-@funindex \once
-@funindex once
-
-Sowohl der @code{\override}-Befehl als auch der @code{\set}-Befehl können mit
-dem Präfix @code{\once} (@emph{einmal}) versehen werden. Dadurch wird
-der folgende @code{\override}- oder @code{\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:
-
-@cindex color-Eigenschaft, Beispiel
-@cindex Farb-Eigenschaft, Beispiel
-@cindex NoteHead, Beispiel für override
-@cindex Notenkopf, Beispiel für Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c d
-\once \override NoteHead #'color = #red
-e f g
-\once \override NoteHead #'color = #green
-a b c
-@end lilypond
-
-
-@strong{Der \overrideProperty-Befehl}
-
-@cindex overrideProperty-Befehl
-
-@funindex \overrideProperty
-@funindex overrideProperty
-
-Es gibt eine andere Form des @code{override}-Befehls,
-@code{\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 @ruser{Difficult tweaks}.
-@c Maybe explain in a later iteration -td
-
-
-@strong{Der \tweak-Befehl}
-
-@cindex tweak-Befehl
-@funindex \tweak
-@funindex tweak
-
-Der letzte Optimierungsbefehl in LilyPond ist @code{\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
-@code{\override} würde alle Noten des Akkords beeinflussen,
-während mit @code{\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
-@code{\once \override} erhalten:
-
-@cindex Schriftgröße, Beispiel
-@cindex NoteHead, Beispiel für override
-@cindex Notenkopf, Beispiel für Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
- <c e g>4
- \once \override NoteHead #'font-size = #-3
- <c e g>
- <c e g>
-@end lilypond
-
-Wie man sehen kann, beeinflusst @code{override} @emph{alle}
-Notenköpfe des Akkordes. Das liegt daran, dass alle die Noten
-eines Akkordes zum selben Musik-Moment auftreten und
-die Funktion von @code{\once} ist es, die Optimierung auf
-an allen Objekten auszuführen, die zum selben Musik-Moment
-auftreten wie der @code{\override}-Befehl.
-
-Der @code{\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 kreirt
-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 @emph{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 @code{\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:
-
-@cindex font-size-Eigenschaft, Beispiel
-@cindex Schriftgröße, Beispiel
-@cindex @code{\tweak}-Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
- <c e g>4
- <c \tweak #'font-size #-3 e g>4
-@end lilypond
-
-Beachten Sie, dass die Syntax des @code{\tweak}-Befehls sich
-von der des @code{\override}-Befehls unterscheidet. Weder
-Kontext noch Layout-Objekt konnen angegeben werden, denn
-das würde zu einem Fehler führen. Beide Angaben sind
-durch das folgende Element impliziert. Hier sollte auch
-kein Gleichheitzeichen vorhanden sein. Die verallgemeinerte
-Syntax des @code{\tweak}-Befehls ist also einfach
-
-@example
-\tweak #'@var{layout-eigenschaft} #@var{Wert}
-@end example
-
-Ein @code{\tweak}-Befehl kann auch benutzt werden, um nur
-eine von mehreren Artikulationen zu ändern, wie im nächsten
-Beispiel zu sehen ist.
-
-@cindex Farb-Eigenschaft, Beispiel
-@cindex @code{\tweak}-Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-a ^Black
- -\tweak #'color #red ^Red
- -\tweak #'color #green _Green
-@end lilypond
-
-@noindent
-Beachten Sie, dass dem @code{\tweak}-Befehl ein Artikulationsmodifikartor
-vorangestellt werden muss, ganz als ob er selbst ein Artikulationszeichen
-wäre.
-
-@cindex Triolen, geschachtelt
-@cindex N-tolen, geschachtelt
-@cindex Klammer, Triole
-@cindex Triolenklammer
-@cindex N-tolenklammer
-@cindex Komplizierte Rhythmen, Schachtelung von
-@funindex TupletBracket
-
-Der @code{\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
-@code{\override}-Befehl sich auf beide beziehen würde.
-In dem Beispiel wird @code{\tweak} benutzt, um zwischen
-ihnen zu unterscheiden. Der erste @code{\tweak}Befehl
-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.
-
-@cindex Farb-Eigenschaft, Beispiel
-@cindex @code{\tweak}-Beispiel
-@cindex Richtungs-Eigenschaft, Beispiel
-@cindex color-Eigenschaft, Beispiel
-@cindex direction-Eigenschaft, Beispiel
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-\tweak #'direction #up
-\times 4/3 {
- \tweak #'color #red
- \times 2/3 { c8[ c8 c8] }
- \times 2/3 { c8[ c8 c8] }
- \times 2/3 { c8[ c8 c8] }
-}
-@end lilypond
-
-Wenn geschachtelte N-tolen nicht zum gleichen Zeitpunkt
-beginnen, kann ihr Aussehen auf die übliche Art mit dem
-@code{\override}-Befehl geändert werden:
-
-@cindex text-Eigenschaft, Beispiel
-@cindex tuplet-number-Funktion, Beispiel
-@cindex transparent-Eigenschaft, Beispiel
-@cindex TupletNumber, Beispiel zur Veränderung
-@cindex Triolennummer, Beispiel zur Veränderung
-@cindex Triolen-Nummer-Funktion, Beispiel
-
-@c NOTE Tuplet brackets collide if notes are high on staff
-@c See issue 509
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\times 2/3 { c8[ c c]}
-\once \override TupletNumber
- #'text = #tuplet-number::calc-fraction-text
-\times 2/3 {
- c[ c]
- c[ c]
- \once \override TupletNumber #'transparent = ##t
- \times 2/3 { c8[ c c] }
-\times 2/3 { c8[ c c]}
-}
-@end lilypond
-
-
-@seealso
-Notationsreferenz:
-@ruser{The tweak command}.
-
-
-@node The Internals Reference manual
-@section The Internals Reference manual
-
-@menu
-* Properties of layout objects::
-* Properties found in interfaces::
-* Types of properties::
-@end menu
-
-@node Properties of layout objects
-@subsection Properties of layout objects
-
-@cindex Eigenschaften von Layout-Objekten
-@cindex Eigenschaften von Grobs
-@cindex Grobs, Eigenschaften von
-@cindex Layout-Objekte, Eigenschaften von
-@cindex Property (Layout-Objekte, Grobs)
-@cindex Regerenz der Interna
-
-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 @code{\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 @code{\override}-Befehle zu
-konstruieren.
-
-Bevor Sie jetzt in die Referenz der Interna wechseln, ist
-eine Warnung angebracht. Es handelt sich um ein
-@strong{Referenz}dokument, 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.
-@c For German users
-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
-@rglosnamed{Top,Musikglossar})
- verwenden, in dem
-die englischen Begriffe in viele andere Sprachen übersetzt sind.
-
-@cindex Override-Beispiel
-@cindex Referenz der Interna, Benutzung
-@cindex IR (Referenz der Interna), Benutzung
-@cindex @code{\addlyrics}-Beispiel
-
-Das Vorgehen soll an einem konkreten Beispiel einer echten
-Komposition demonstriert werden. Hier das Beispiel:
-
-@lilypond[quote,verbatim,relative=2]
-{
- \time 6/8
- {
- r4 b8 b[( g]) g |
- g[( e]) e d[( f]) a |
- a g
- }
- \addlyrics {
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-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:
-@qq{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
-@uref{http://lilypond.org}. Gehen Sie zur Dokumentationsseite
-und klicken Sie auf den Link zur Referenz der Interna.
-@c Addition for German users
-Die Sprache ändert sich ab hier nach englisch. Für diese Übung
-sollten Sie die HTML-Version benutzen, nicht die
-@qq{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 @strong{Top} befinden sich fünf Links.
-Wählen Sie den Link zum @emph{Backend}, wo sich die Information
-über Layout-Objekte befindet. Hier, unter der Überschrift
-@strong{Backend}, wählen Sie den Link @emph{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 @emph{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 @strong{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:
-
-@example
-@code{thickness} (number)
- @code{1.2}
- Line thickness, generally measured in @code{line-thickness}
-@end example
-
-Das sieht ganz danach aus, als ob damit die Dicke geändert
-werden kann. Es bedeutet, dass der Wert von
-@code{thickness} einfach eine Zahl (@emph{number}) ist,
-dass der Standardwert 1.2 ist, und dass die Einheit
-für die Dicke eine andere Eigenschaft mit der
-Bezeichnung @code{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
-@code{Slur} und die Bezeichnung der Eigenschaft, die geändert
-werden soll
-@code{thickness}. Der neue Wert sollte etwas mehr als 1.2 sein,
-denn der Bogen soll ja dicker werden.
-
-Den benötigten @code{\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:
-
-@example
-\override Slur #'thickness = #5.0
-@end example
-
-Vergessen Sie nicht das Rautenzeichen und Apostroph
-(@code{#'}) vor der Eigenschaftsbezeichnung und das
-Rautenzeichen vor dem neuen Wert!
-
-Die nächste Frage ist nun: @qq{Wohin soll dieser Befehl geschrieben
-werden?} Solange wir uns noch im Lernstadium befinden, ist
-die beste Antwort: @qq{Innerhalb der Noten, vor den ersten
-Legatobogen und nahe bei ihm.} Also etwa so:
-
-@cindex Legatobogen, Beispiel für Veränderung
-@cindex thickness-Eigenschaft, Beispiel
-@cindex Dicke-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-{
- \time 6/8
- {
- % Increase thickness of all following slurs from 1.2 to 5.0
- \override Slur #'thickness = #5.0
- r4 b8 b[( g]) g |
- g[( e]) e d[( f]) a |
- a g
- }
- \addlyrics {
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-@noindent
-und wirklich wird der Legatobogen dicker.
-
-Das ist also die grundlegende Herangehensweise,
-@code{\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.
-
-
-@subheading Finding the context
-
-@cindex Kontext, Finden und identifizieren
-
-Manchmal muss dennoch der Kontext spezifiziert werden.
-Welcher aber ist der richtige Kontext? Wir könnten raten,
-dass Legatobögen sich im @code{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
-@emph{Slur} hat. Dort steht: @qq{Slur objects are created
-by: Slur engraver}. Legatobögen werden also in dem Kontext
-erstellt, in dem sich der @code{Slur_engraver} befindet.
-Folgen Sie dem Link zu der @code{Slur_engraver}-Seite.
-Unten auf der Seite steht, dass der @code{Slur_engraver}
-sich in fünf Stimmen-Kontexten befindet, unter anderem
-auch im normalen @code{Voice}-Kontext. Unsere Annahme
-war also richtig. Und weil @code{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.
-
-
-@subheading Overriding once only
-
-@cindex Override nur einmal
-@cindex once override
-@funindex \once
-@funindex once
-
-Im Beispiel oben wurden @emph{alle} Legatobögen dicker
-gesetzt. Vielleicht wollen Sie aber nur den ersten Bogen
-dicker haben. Das können Sie mit dem @code{\once}-Befehl
-erreichen. Er wird direkt vor den @code{\override}-Befehl
-gesetzt und bewirkt, dass nur der Bogen geändert wird, der
-@strong{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 @code{\once} zusammen benutzt,
-muss also wie folgt positioniert werden:
-
-@cindex Legatobogen, Beispiel zur Veränderung
-@cindex thickness-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-{
- \time 6/8
- {
- r4 b8
- % Increase thickness of immediately following slur only
- \once \override Slur #'thickness = #5.0
- b[( g]) g |
- g[( e]) e d[( f]) a |
- a g
- }
- \addlyrics {
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-@noindent
-Jetzt bezieht er sich nur noch auf den ersten Legatobogen.
-
-Der @code{\once}-Befehl kann übrigens auch vor einem @code{\set}-Befehl
-eingesetzt werden.
-
-
-@subheading Reverting
-
-@cindex Revert
-@cindex Rückgängig machen
-@cindex Wiederherstellen von Standardeinstellungen
-@cindex Standardeinstellungen, Wiederherstellen
-@funindex \revert
-@funindex revert
-
-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 @code{\once}-Präfix und direkt vor die entsprechende
-Note gestellt, an welcher der Bogen beginnt:
-
-@cindex Legatobogen, Beispiel zur Veränderung
-@cindex thickness-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-{
- \time 6/8
- {
- r4 b8
- % Increase thickness of immediately following slur only
- \once \override Slur #'thickness = #5.0
- b[( g]) g |
- % Increase thickness of immediately following slur only
- \once \override Slur #'thickness = #5.0
- g[( e]) e d[( f]) a |
- a g
- }
- \addlyrics {
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-@noindent
-Wir könnten aber auch den @code{\once}-Befehl weglassen und anstelle
-dessen später den @code{\revert}-Befehl einsetzen, um die
-@code{thickness}-Eigenschaft wieder auf ihren Standardwert zurückzusetzen:
-
-@cindex Legatobogen, Beispiel zur Veränderung
-@cindex thickness-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-{
- \time 6/8
- {
- r4 b8
- % Increase thickness of all following slurs from 1.2 to 5.0
- \override Slur #'thickness = #5.0
- b[( g]) g |
- g[( e])
- % Revert thickness of all following slurs to default of 1.2
- \revert Slur #'thickness
- e d[( f]) a |
- a g
- }
- \addlyrics {
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-@noindent
-Der @code{\revert}-Befehl kann benutzt werden, um eine beliebige
-Eigenschaft, die mit @code{\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.
-
-
-@node Properties found in interfaces
-@subsection Properties found in interfaces
-
-@cindex Interface-Eigenschaften
-@cindex Eigenschaften von Interfaces
-@cindex Schnittstellen, Eigenschaften von
-@cindex Eigenschaften von Schnittstellen
-
-Der Text unseres Beispiels soll jetzt kursiv gesetzt werden. Was für
-ein @code{\override}-Befehl wird dazu benötigt? Schauen wir
-uns zunächst das Inhaltsverzeichnis in der IR an: @qq{All layout objects},
-wie auch schon zuvor. Welches Objekt könnte die Darstellung des
-Textes (engl. lyrics) beeinflussen? Es gibt den Eintrag @code{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
-@code{font-series} und @code{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 einzlenen
-Layout-Objekt aufgelistet, sondern ist mit anderen ähnlichen Eigenschaften
-zusammen in einem @strong{Interface} -- einer Schnittstelle -- verortet;
-in diesem Fall das
-@code{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 @code{LyricText}
-beschreibt. Unten auf der Seite ist eine klickbare Liste (in der HTML-Version
-der IR) an Eigenschaften, die von @code{LyricText} unterstützt
-werden. Diese Liste enthält sieben Einträge, darunter auch
-@code{font-interface}. Ein Klick hierauf bringt uns zu den Eigenschaften,
-die mit dieser Schnittstelle verbunden sind, also auch @code{LyricText}.
-
-Jetzt sehen wir alle die Eigenschaften, die der Benutzer verändern kann,
-um die Schriftartendarstellung zu beeinflussen. Dazu gehört nun auch
-@code{font-shape(symbol)}, wobei @code{symbol} auf die Werte
-@code{upright} (gerade), @code{italics} (kursiv) oder @code{caps}
-(Kapitälchen) gesetzt werden kann.
-
-Sie werden gemerkt haben, dass @code{font-series} und @code{font-size}
-hier auch aufgelistet sind. Es stellt sich die Frage, warum diese
-allgemeinen Schriftarteigenschaften @code{font-series} und
-@code{font-size} sowohl unter der Überschrift
-@code{LyricText} als unter dem @code{font-interface} aufgelistet
-sind, aber @code{font-shape} befindet sich nur im
-@code{font-interface}? Die Antwort ist: Die globalen Einstellungen
-von @code{font-series} und @code{font-size} werden geändert, wenn
-ein @code{LyricText}-Objekt erstellt wird, aber @code{font-shape}
-wird davon nicht beeinflusst. Die zusätzlichen Einträge unter der
-Überschrift @code{LyricText} beinhalten dann die Werte der
-Standardeinstellungen dieser zwei Eigenschaften, wenn es sich
-um ein @code{LyricText}-Objekt handelt. Andere Objekte,
-die auch das @code{font-interface} unterstützen, setzen diese
-Eigenschaften anders, wenn sie erstellt werden.
-
-Versuchen wir nun einen @code{\override}-Befehl zu konstruieren,
-der den Gesantext kursiv setzt. Das Objekt hat die Bezeichnung
-@code{LyricText}, die Eigenschaft ist @code{font-shape}
-und der Wert @code{italic}. Wie vorher schon lassen wir den
-Kontext aus.
-
-Am Rande sei angemerkt, dass die Werte der @code{font-shape}-Eigenschaft
-mit einem Apostroph (@code{'}) gekennzeichnet werden
-müssen, weil es sich um Symbole handelt. Aus dem gleichen
-Grund mussten auch für @code{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 @code{thickness}
-oder @code{font-shape}. Andere sind besondere Werte,
-die an Eigenschaften übergeben werden können, wie
-@code{italic}. Im Unterschied hierzu gibt es auch beliebige
-Zeichenketten, die immer mit Anführungszeichen, also
-als @code{"Zeichenkette"} auftreten. Für weitere
-Einzelheiten zu Zeichenketten und Werten, siehe
-@ref{Scheme tutorial}.
-
-Gut, der @code{\override}-Befehl, mit dem der Gesangstext
-kursiv gesetzt wird, lautet:
-
-@example
-\override LyricText #'font-shape = #'italic
-@end example
-
-@noindent
-und er muss direkt vor den Text gesetzt werden, auf den er sich
-bezieht, etwa so:
-
-@cindex font-shape-Eigenschaft, Beispiel
-@cindex LyricText, Beispiel zur Veränderung
-@cindex kursiv, Beispiel
-@cindex @code{\addlyrics}, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 6/8
- {
- r4 b8 b[( g]) g |
- g[( e]) e d[( f]) a |
- a g
- }
- \addlyrics {
- \override LyricText #'font-shape = #'italic
- The man who feels love's sweet e -- mo -- tion
- }
-}
-@end lilypond
-
-@noindent
-Jetzt wird der Text kursiv gesetzt.
-
-
-@subheading Specifying the context in lyric mode
-
-
-@cindex Kontext im Gesangstextmodus angeben
-@cindex Gesangstextmodus, Kontext angeben
-
-Bei Gesangstexten funktioniert der @code{\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
-@code{@}} 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:
-
-@example
-\override Lyrics . LyricText #'font-shape = #'italic
-@end example
-
-@warning{Innerhalb von Gesangstext muss immer ein
-Leerzeichen zwischen der letzten Silbe und der schließenden
-Klammer gesetzt werden.}
-
-@warning{Innerhalb von @code{\override}-Befehlen in
-Gesangstexten müssen Leerzeichen um Punkte zwischen
-Kontext- und Objektbezeichnungen gesetzt werden.}
-
-
-@node Types of properties
-@subsection Types of properties
-
-@cindex Eigenschaftsarten
-
-Bis jetzt hatten wir es mit zwei Arten von Eigenschaften zu
-tun: @code{number} (Zahl) und @code{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 (@code{#}) vor den Typeintrag setzen,
-wenn sie in einem @code{\override}-Befehl benutzt werden.
-
-@multitable @columnfractions .2 .45 .35
-@headitem Eigenschaftstyp
- @tab Regeln
- @tab Beispiele
-@item Boolesch
- @tab Entweder wahr oder falsch, dargestellt als #t oder #f
- @tab @code{#t}, @code{#f}
-@item Dimension (in Notenlinienabständen)
- @tab Eine positive Dezimalzahl (in Notenlinienabstand-Einheiten)
- @tab @code{2.5}, @code{0.34}
-@item Richtung
- @tab Eine gültige Richtungskonstante oder das numerische Äquivalent
- @tab @code{LEFT}, @code{CENTER}, @code{UP},
- @code{1}, @code{-1}
-@item Integer
- @tab Eine positive ganze Zahl
- @tab @code{3}, @code{1}
-@item Liste
- @tab Eine eingeklammerte Anzahl von Einträgen, mit Klammern getrennt
- und angeführt von einem Apostroph
- @tab @code{'(left-edge staff-bar)}, @code{'(1)},
- @code{'(1.0 0.25 0.5)}
-@item Textbeschriftung (markup)
- @tab Beliebige gültige Beschriftung
- @tab @code{\markup @{ \italic "cresc." @}}
-@item Moment
- @tab Ein Bruch einer ganzen Note, mit der make-moment-Funktion
- konstruiert
- @tab @code{(ly:make-moment 1 4)},
- @code{(ly:make-moment 3 8)}
-@item Zahl
- @tab Eine beliebige positive oder negative Dezimalzahl
- @tab @code{3.5}, @code{-2.45}
-@item Paar (Zahlenpaar)
- @tab Zwei Zahlen getrennt von @qq{Leerzeichen . Leerzeichen}, eingeklammert
- und angeführt von einem Apostroph
- @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
-@item Symbol
- @tab Eine beliebige Anzahl von Symbolen, die für die Eigenschaft
- gültig sind, angeführt von einem Apostroph
- @tab @code{'italic}, @code{'inside}
-@item Unbekannt
- @tab Eine Prozedur oder @code{#f} (um keine Aktion hervorzurufen)
- @tab @code{bend::print}, @code{ly:text-interface::print},
- @code{#f}
-@item Vektor
- @tab Eine Liste mit drei Einträgen, eingeklammert und mit
- Apostroph-Raute ( @code{'#}) angeführt.
- @tab @code{'#(#t #t #f)}
-@end multitable
-
-
-@seealso
-Handbuch zum Lernen: @ref{Scheme tutorial}.
-
-
-@node Appearance of objects
-@section Appearance of objects
-
-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.
-
-@menu
-* Visibility and color of objects::
-* Size of objects::
-* Length and thickness of objects::
-@end menu
-
-
-@node Visibility and color of objects
-@subsection Visibility and color of objects
-
-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 @emph{Schnittstellen}
--- engl. interface -- gruppiert sind, siehe auch
-@ref{Properties found in interfaces}. 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
-@ref{Properties of layout objects}. 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
-@emph{Backend} und @emph{All layout objects} kommen
-wir zu einem Layout-Objekt mit der Bezeichnung
-@code{BarLine} (engl. TaktLinie). Seine Eigenschaften
-beinhalten zwei, die über die Sichtbarkeit entscheiden:
-@code{break-visibility} und @code{stencil}.
-@code{BarLine} unterstützt auch einige Schnittstellen,
-unter anderem @code{grob-interface}, wo wir eine
-@code{transparent} und eine @code{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.
-
-@subheading stencil
-
-@cindex Stencil-Eigenschaft
-@cindex Matrizen-Eigenschaft
-
-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 @code{#f} (falsch) gesetzt wird. Ein Versuch also,
-wie vorher, indem wir den impliziten Kontext (@code{Voice})
-auslassen:
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex stencil-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override BarLine #'stencil = ##f
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-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 Eigenschafter für @code{BarLine} angibt.
-Oben auf der Seite steht: @qq{Barline objects are created
-by: Bar_engraver}. Schauen Sie sich die
-@code{Bar_engraver}-Seite an. Unten auf der Seite steht
-eine Liste der Kontexte, in denen der Takt-Engraver
-funktioniert. Alle Kontexte sind @code{Staff}-Typen (also
-Notensystem-Typen). Der Grund, warum der
-@code{\override}-Befehl nicht funktioniert hat, liegt
-also darin, dass das Taktlinie-Objekt (@code{BarLine}) sich nicht
-im @code{Voice}-Kontextbefindet. 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 mitanzugeben:
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex stencil-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.BarLine #'stencil = ##f
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-Jetzt sind die Taktlinien wirklich verschwunden.
-
-Es sollte jedoch beachtet werden, dass das Setzen der
-@code{stencil}-Eigenschaft auf @code{#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 @code{stencil}-Eigenschaft des @code{NoteHead}-Objekts auf
-@code{#f} gesetzt wird.
-
-
-@subheading break-visibility
-
-@cindex break-visibility-Eigenschaft
-@cindex Unsichtbar machen (break-visibility)
-
-Aus der Beschreibung der Eigenschaften für @code{BarLine}
-in der IR geht hervor, dass die @code{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 @code{'#(#f #f #f)}.
-Versuchen wir es also, und berücksichtigen wir auch den
-@code{Staff}-Kontext. Beachten Sie auch, dass Sie @code{#'#}
-vor der öffnenden Klammer schreiben müssen:
-@code{'#} wird benötigt als Teil des Wertes, um einen Vektor zu
-signalisieren, und das erste @code{#} wird benötigt, um
-den Wert in einem @code{\override}-Befehl anzuführen.
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex break-visibility-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-Auch auf diesem Weg gelingt es, die Taktlinien unsichtbar zu machen.
-
-
-@subheading transparent
-
-@cindex transparent-Eigenschaft
-@cindex Durchsichtig machen (transparent)
-
-Aus den Eigenschaftsdefinitionen auf der @code{grob-interface}-Seite
-in der IR geht hervor, dass die @code{transparent}-Eigenschaft
-boolesch ist. Mit @code{#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 @qq{All layout objects}-Seite in der IR müssen wir die
-Eigenschaften des @code{TimeSignature}-Layout-Objekts suchen
-Das Objekt wird vom @code{Time_signature_engraver} erstellt,
-der sich auch im @code{Staff}-Kontext befindet und genauso das
-@code{grob-interface} unterstützt, wie Sie sich
-überzeugen können. Der Befehl, um die Taktangabe unsichtbar zu
-machen, ist also:
-
-@cindex Taktart, Beispiel zur Veränderung
-@cindex transparent-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.TimeSignature #'transparent = ##t
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-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 @code{#f} (falsch)
-gesetzt werden:
-
-@cindex Taktart, Beispiel zur Veränderung
-@cindex stencil-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.TimeSignature #'stencil = ##f
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-Und der Unterschied wird deutlich: hiermit wird das gesamte Objekt
-entfernt, während man mit @code{transparent} ein Objekt
-unsichtbar machen kann, es aber an seinem Platz gelassen wird.
-
-
-@subheading color
-
-@cindex color-Eigenschaft
-@cindex Farb-Eigenschaft
-
-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 Taktlinienen, 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 @ruser{Painting objects white}. Im Moment wollen wir lernen, wie
-man mit Farbe arbeitet, akzeptieren Sie bitte an dieser Stelle die
-Beschränkung.)
-
-Das @code{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, @qq{normale} Farben zu benutzen, wie sie in der
-Tabelle in @ruser{List of colors} aufgelistet sind. Beachten Sie,
-dass die Bezeichnungen auf English sind. Um die Taktlinien auf
-weiß zu setzen, können Sie schreiben:
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex color-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.BarLine #'color = #white
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-und die Taktlinien verschwinden in der Tat. Beachten Sie,
-dass @emph{white} nicht mit einem Apostroph angeführt
-wird -- es ist kein Symbol, sondern eine @emph{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.
-
-@cindex Farben, X11
-@cindex X11-Farben
-@funindex x11-color
-
-Die zweite Art die Farbe zu ändern geschieht, indem die Liste
-der X11-Farbbezeichnungen einzusetzen, siehe die zweite Liste
-in @ruser{List of colors}. Diesen Farben muss jedoch eine
-andere Funktion vorangestellt werden, die die X11-Farbbezeichnungen
-in interne Werte konvertiert:
-@code{x11-color}. Das geschieht wie folgt:
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex color-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.BarLine #'color = #(x11-color 'white)
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-In diesem Fall hat die Funktion @code{x11-color} ein Symbol
-als Argument, darum muss dem Symbol ein Apostroph vorangestellt
-und beide zusammen in Klammern gesetzt werden.
-
-@cindex RGB-Farben
-@cindex Farben, RGB
-@funindex rgb-color
-
-Es gibt noch eine dritte Funktion, die RGB-Werte in die
-internen Werte übersetzt -- die @code{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: @code{(rgb-color 1 0 0)}, weiß
-würde sein: @code{(rgb-color 1 1 1)}.
-
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex color-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \time 12/16
- \override Staff.BarLine #'color = #(rgb-color 1 1 1)
- c4 b8 c d16 c d8 |
- g, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-Schließlich gibt es noch eine Grauskala, die zu den X11-Farben
-gehört. Sie reicht von schwarz (@code{'grey0'}) bis
-weiß (@code{'grey100}), in Einserschritten. Wir wollen das
-illustrieren, indem alle Layout-Objekte im Beispiel
-verschiede Grauschattierungen erhalten:
-
-@cindex StaffSymbol, Beispiel zur Veränderung
-@cindex TimeSignature, Beispiel zur Veränderung
-@cindex Schlüssel, Beispiel zur Veränderung
-@cindex Notenhals, Beispiel zur Veränderung
-@cindex Taktlinie, Beispiel zur Veränderung
-@cindex Farbeigenschaft, Beispiel
-@cindex x11-Farben, Beispiel
-@cindex Taktlinien, Beispiel zur Veränderung
-@cindex Taktart, Beispiel zur Veränderung
-@cindex Clef, Beispiel zur Veränderung
-@cindex Stem, Beispiel zur Veränderung
-@cindex NoteHead, Beispiel zur Veränderung
-@cindex Notenkopf, Beispiel zur Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-{
- \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, a16 b8 c d4 e16 |
- e8
-}
-@end lilypond
-
-@noindent
-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.
-
-
-@node Size of objects
-@subsection Size of objects
-
-@cindex Veränderung von Objektgrößen
-@cindex Objektgrößen, verändern
-@cindex Größen von Objekten verändern
-
-Als Startpunkt wollen wir wieder ein früheres Beispiel
-wählen, siehe @ref{Nesting music expressions}. Hier wurde
-ein neues Notensystem erstellt, wie man es für ein @rglos{ossia}
-braucht.
-
-@cindex alignAboveContext-Eigenschaft, Beispiel
-@cindex über dem System anordnen, Beispiel
-@cindex @code{\with}-Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\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 |
- }
- }
-@end lilypond
-
-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 @code{#f}:
-
-@cindex alignAboveContext-Eigenschaft, Beispiel
-@cindex über dem System anordnen, Beispiel
-@cindex @code{\with}-Beispiel
-@cindex stencil-Eigenschaft, Beispiel
-@cindex Schlüssel, Beispiel zur Veränderung
-@cindex Taktart, Beispiel zur Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\new Staff ="main" {
- \relative g' {
- r4 g8 g c4 c8 d |
- e4 r8
- <<
- { f c c }
- \new Staff \with {
- alignAboveContext = #"main"
- }
- {
- \override Staff.Clef #'stencil = ##f
- \override Staff.TimeSignature #'stencil = ##f
- { f8 f c }
- }
- >>
- r4 |
- }
-}
-@end lilypond
-
-@noindent
-wobei ein zusätzliches Klammerpaar nach der @code{\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 @code{Staff}-Kontext
-mit @code{\with} verändert, oder ob man die Stencils mit
-@code{\override} beeinflusst? Der größte Unterschied liegt
-darin, dass Änderungen, die mit @code{\with} eingeführt werden,
-während der Erstellung des Kontextes miterzeugt werden und
-als @strong{Standardeinstellungen} für diesen Kontext während seiner
-gesamten Dauer gelten, während @code{\set}- oder @code{\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 @code{\unset}
-oder @code{\revert} rückgängig gemacht werden, werden
-wieder die Standardwerte eingesetzt, die also die sind, die
-mit einer @code{\with}-Konstruktion definiert wurden, oder
-wenn hier keine definiert worden sind, die normalen
-Standardwerte.
-
-Manche Kontexteigenschaften können nur ein einer
-@code{\with}-Konstruktion verändert werden. Das sind
-Eigenschaften, die nicht sinnvoll mitten im System geändert
-werden können. @code{alignAboveContext} (Orientierung
-über dem Kontext) und die Parallele,
-@code{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 @code{\with}-Konstruktion gesetzt werden.
-Benutzen Sie einfach den normalen @code{\override}-Befehl
-ohne den Kontext, denn der Kontext ist eindeutig definiert
-durch die Stelle, an welcher sich @code{\with} befindet.
-Wenn an dieser Stelle ein Kontext angegeben wird, produziert LilyPond
-eine Fehlermeldung.
-
-Das obige Beispiel könnte also auch so aussehen:
-
-@cindex alignAboveContext-Eigenschaft, Beispiel
-@cindex über dem System anordnen, Beispiel
-@cindex @code{\with}-Beispiel
-@cindex stencil-Eigenschaft, Beispiel
-@cindex Schlüssel, Beispiel zur Veränderung
-@cindex Taktart, Beispiel zur Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\new Staff ="main" {
- \relative g' {
- r4 g8 g c4 c8 d |
- e4 r8
- <<
- { f 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 |
- }
-}
-@end lilypond
-
-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
-@code{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
-@code{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:
-
-@example
-\override NoteHead #'font-size = #-2
-@end example
-
-@noindent
-oder wir ändern die Größe aller Schriftobjekte, indem wir
-den Wert einer besonderen Eigenschaft, @code{fontSize},
-mit dem @code{\set}-Befehl bestimmen oder sie in
-eine @code{\with}-Konstruktion (ohne @code{\set} einschließen.
-
-@example
-\set fontSize = #-2
-@end example
-
-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:
-
-@cindex alignAboveContext-Eigenschaft, Beispiel
-@cindex über dem System anordnen, Beispiel
-@cindex @code{\with}-Beispiel
-@cindex stencil-Eigenschaft, Beispiel
-@cindex Schlüssel, Beispiel zur Veränderung
-@cindex Taktart, Beispiel zur Veränderung
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Staff ="main" {
- \relative g' {
- r4 g8 g c4 c8 d |
- e4 r8
- <<
- { f 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 |
- }
-}
-@end lilypond
-
-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.
-
-
-@node Length and thickness of objects
-@subsection Length and thickness of objects
-
-@cindex Entfernungen
-@cindex Dicke
-@cindex Länge
-@funindex magstep
-@cindex Größe, verändern
-@cindex Notenhalslänge, verändern
-@cindex Hälse, Länge verändern
-@cindex Notenlinien, Länge verändern
-
-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
-@code{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
-@code{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:
-
-@cindex alignAboveContext-Eigenschaft, Beispiel
-@cindex über dem System anordnen, Beispiel
-@cindex @code{\with}-Beispiel
-@cindex stencil-Eigenschaft, Beispiel
-@cindex Schlüssel, Beispiel zur Veränderung
-@cindex Taktart, Beispiel zur Veränderung
-@cindex Notenlinienabstände verändern
-@cindex staff-space-Eigenschaft verändern
-@cindex magstep-Funktion, Beispiel
-@cindex Schriftart-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Staff ="main" {
- \relative g' {
- r4 g8 g c4 c8 d |
- e4 r8
- <<
- { f 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 |
- }
-}
-@end lilypond
-
-@noindent
-Da die Länge eines Halses und viele andere Längeneigenschaften
-relativ zum Wert des Notenlinienabstands (@code{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 @code{thickness}-Eigenschaft des
-Objekts mit @code{\override} verändert wird. Ein Beispiel,
-wie man die Dicke von Bögen ändert, wurde schon gezeigt,
-siehe @ref{Properties of layout objects}. Die Dicke aller
-gezeichneten Objekte (die also nicht aus einer Schriftart
-stammen) können auf gleiche Weise geändert werden.
-
-
-@node Placement of objects
-@section Placement of objects
-
-@menu
-* Automatic behavior::
-* Within-staff objects::
-* Outside-staff objects::
-@end menu
-
-
-@node Automatic behavior
-@subsection Automatic behavior
-
-@cindex within-staff-Objekte
-@cindex outside-staff-Objekte
-@cindex Objekte innerhalb des Notensystems
-@cindex Objekte außerhalb des Notensystems
-
-Es gibt Objekte der Notation, die zum Notensystem gehören, und
-andere, die außerhalb des Systems gesetzt werden müssen. Sie
-werden @code{within-staff}-Objekte bzw.
-@code{outside-staff}-Objekte genannt.
-
-@code{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
-@code{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
-@code{outside-staff-priority} geordnet. Die @code{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
-@code{outside-staff}-Objekte um den selben Platz streiten,
-wird das mit der geringeren @code{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 @qq{Text3} wieder dicht am System gesetzt wurde, weil
-er unter @qq{Text2} passt.
-
-@cindex Textbeschriftungsbeispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-c2^"Text1"
-c^"Text2"
-c^"Text3"
-c^"Text4"
-@end lilypond
-
-Notensysteme werden in den Standardeinstellungen auch so dicht
-beeinander 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
-@qq{ineinander greifen}.
-
-@lilypond[quote,ragged-right,verbatim]
-<<
- \new Staff {
- \relative c' { c a, }
- }
- \new Staff {
- \relative c'''' { c a, }
- }
->>
-@end lilypond
-
-
-@node Within-staff objects
-@subsection Within-staff objects
-
-Es wurde schon gezeigt, wie die Befehle @code{\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 @code{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 @code{direction}-Eigenschaft verändert
-wird.
-
-@funindex down
-@funindex up
-@funindex center
-@funindex neutral
-@cindex hoch-Eigenschaft
-@cindex runter-Eigenschaft
-@cindex zentriert-Eigenschaft
-@cindex neutral-Eigenschaft
-
-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.
-
-@cindex Notenhals, Beispiel zur Veränderung
-@cindex Richtungseigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-a4 g c a
-\override Stem #'direction = #DOWN
-a g c a
-\override Stem #'direction = #UP
-a g c a
-\revert Stem #'direction
-a g c a
-@end lilypond
-
-Hier werden die Konstanten @code{DOWN} und @code{UP}
-eingesetzt. Sie haben die Werte @code{-1} bwz. @code{+1}, und
-diese numerischen Werte können ebenso benutzt werden. Auch
-der Wert @code{0} kann in manchen Fällen benutzt werden. Er
-bedeutet für die Hälse das gleiche wie @code{UP}, für einige
-andere Objekte jedoch @qq{zentiert}. Es gibt hierzu die Konstante
-@code{CENTER}, die den Wert @code{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 selbsverständlich ist.
-
-@multitable @columnfractions .2 .2 .25 .35
-@headitem Runter/Links
- @tab Rauf/Rechts
- @tab Rückgängig
- @tab Wirkung
-@item @code{\arpeggioArrowDown}
- @tab @code{\arpeggioArrowUp}
- @tab @code{\arpeggioNormal}
- @tab Arpeggio mit Pfeil nach unten, oben oder ohne Pfeil
-@item @code{\dotsDown}
- @tab @code{\dotsUp}
- @tab @code{\dotsNeutral}
- @tab Richtung der Verschiebung eines Punktes, um Notenlinien zu vermeiden
-@item @code{\dynamicDown}
- @tab @code{\dynamicUp}
- @tab @code{\dynamicNeutral}
- @tab Position der Dynamik-Bezeichnung relativ zum System
-@item @code{\phrasingSlurDown}
- @tab @code{\phrasingSlurUp}
- @tab @code{\phrasingSlurNeutral}
- @tab Befehl für Richtung von Phrasierungsbögen
-@item @code{\slurDown}
- @tab @code{\slurUp}
- @tab @code{\slurNeutral}
- @tab Befehl für Richtung von Legatobögen
-@item @code{\stemDown}
- @tab @code{\stemUp}
- @tab @code{\stemNeutral}
- @tab Befehl für Richtung von Hälsen
-@item @code{\textSpannerDown}
- @tab @code{\textSpannerUp}
- @tab @code{\textSpannerNeutral}
- @tab Position von Textbeschrifungen, die als Strecker eingegeben werden
-@item @code{\tieDown}
- @tab @code{\tieUp}
- @tab @code{\tieNeutral}
- @tab Befehl für Richtung von Bindebögen
-@item @code{\tupletDown}
- @tab @code{\tupletUp}
- @tab @code{\tupletNeutral}
- @tab Befehl für Richtung von Klammern/Zahlen der N-tolen
-@end multitable
-
-Diese vordefinierten Befehl können allerdings @strong{nicht}
-zusammen mit @code{\once} benutzt werden. Wenn Sie die
-Wirkung eines Befehl auf eine einzige Noten begrenzen wollen,
-müssen Sie den entsprechenden
-@code{\once \override}-Befehl benutzen oder den definierten
-Befehl, gefolgt von dem entsprechenden neutralisierenden
-@code{xxxNeutral}-Befehl nach der Note.
-
-
-@subheading Fingering
-
-@cindex Fingersatz, Positionierung
-@cindex Fingersatz, Akkorde
-
-Die Positionierung von Fingersatz kann auch durch den Wert
-seiner @code{direction}-Eigenschaft beeinflusst werden, aber
-eine Veränderung von @code{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 @code{direction} auf
-den Fingersatz: im ersten Takt der Standard, dann
-die Wirkung von @code{DOWN} (runter) und @code{UP}
-(hinauf).
-
-@cindex Fingersatz, Beispiel zur Veränderung
-@cindex direction-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-c-5 a-3 f-1 c'-5
-\override Fingering #'direction = #DOWN
-c-5 a-3 f-1 c'-5
-\override Fingering #'direction = #UP
-c-5 a-3 f-1 c'-5
-@end lilypond
-
-Eine Beeinflussung der @code{direction}-Eigenschaft ist jedoch
-nicht die einfachste Art, Fingersatzbezeichnungen manuell über oder
-unter das System zu setzen. Normalerweise bietet es sich an,
-@code{_} oder @code{^} anstelle von @code{-} vor der Fingersatz-Zahl
-zu benutzen. Hier das vorherigen Beispiel mit dieser Methode:
-
-@cindex Fingersatz-Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-c-5 a-3 f-1 c'-5
-c_5 a_3 f_1 c'_5
-c^5 a^3 f^1 c'^5
-@end lilypond
-
-Die @code{direction}-Eigenschaft wirkt sich nicht auf
-Akkorde aus, während die Präfixe @code{_} und @code{^} funktionieren.
-Standardmäßig wird der Fingersatz automatisch entweder
-über oder unter dem Akkord gesetzt:
-
-@cindex Fingersatz-Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-<c-5 g-3>
-<c-5 g-3 e-2>
-<c-5 g-3 e-2 c-1>
-@end lilypond
-
-@noindent
-aber das kann manuell geändert werden, um einzelne Fingersatzanweisungen
-nach oben oder unten zu zwingen:
-
-@cindex Fingersatz-Beispiel
-
-@lilypond[quote,verbatim,relative=2]
-<c-5 g-3 e-2 c-1>
-<c^5 g_3 e_2 c_1>
-<c^5 g^3 e^2 c_1>
-@end lilypond
-
-Noch bessere Kontrolle über die Positionierung von Fingersatz für
-einzelne Noten in einem Akkord ist mit dem
-@code{\set fingeringOrientations}-Befehl möglich. Die Syntax
-lautet:
-
-@example
-@code{\set fingeringOrientations = #'([up] [left/right] [down])}
-@end example
-
-@noindent
-@code{\set}wird benutzt, weil @code{fingeringOrientations} eine
-Eigenschaft des @code{Voice}-Kontextes ist, erstellt und eingesetzt
-vom @code{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 @code{up} in der Liste auftaucht), darunter
-(wenn@code{down} auftaucht), links (wenn @code{left} auftaucht)
-oder rechts (wenn @code{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
-@code{left} oder @code{right} auftreten, nicth beide gleichzeitig.
-
-@warning{Damit eine einzelne Note mit diesem Befehl beeinflusst werden
-kann, muss sie als ein @qq{Ein-Noten-Akkord} geschrieben
-werden, indem einfache spitze Klammern um die Note positioniert
-werden.}
-
-Hier ein paar Beispiele:
-
-@cindex Fingersatz-Beispiel
-@cindex @code{\set}, Benutzungsbeispiel
-@cindex fingerOrientations-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,relative=1]
-\set fingeringOrientations = #'(left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(up left down)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(up left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(right)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-@end lilypond
-
-@noindent
-Wenn die Fingersatzbezeichnung zu gedrungen aussieht,
-kann auch die Schriftgröße (@code{font-size}) verringert
-werden. Der Standardwert kann aus dem
-@code{Fingering}-Objekt in der IR entnommen werden,
-er ist @code{-5}, versuchen wir es also mit @code{-7}.
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-\override Fingering #'font-size = #-7
-\set fingeringOrientations = #'(left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(up left down)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(up left)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-\set fingeringOrientations = #'(right)
-<f-2>
-< c-1 e-2 g-3 b-5 > 4
-@end lilypond
-
-
-
-@node Outside-staff objects
-@subsection Outside-staff objects
-
-Objekte außerhalb des Notensystems werden automatisch gesetzt,
-um Kollisionen zu vermeiden. Objekten mit einem geringeren
-Prioritätswert der Eigenschaft @code{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
-@code{outside-staff-priority}-Eigenschaft ist im
-@code{grob-interface} definiert und ist also eine Eigenschaft
-von allen Layout-Objekten. Standardmäßig ist sie für alle Objekte
-auf falsch (@code{#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 @code{outside-staff}-Objekte,
-die den Voreinstellungen nach im
-@code{Staff}- oder @code{Voice}-Kontext gesetzt werden.
-
-@multitable @columnfractions .3 .3 .3
-@headitem Layout-Objekt
- @tab Priorität
- @tab Kontrolliert Position von:
-@item @code{MultiMeasureRestText}
- @tab @code{450}
- @tab Text über Ganztaktpausen
-@item @code{TextScript}
- @tab @code{450}
- @tab Textbeschriftung
-@item @code{OttavaBracket}
- @tab @code{400}
- @tab Ottava (Oktavierungsklammern)
-@item @code{TextSpanner}
- @tab @code{350}
- @tab Text-Strecker
-@item @code{DynamicLineSpanner}
- @tab @code{250}
- @tab Alle Dynamik-Bezeichnungen
-@item @code{VoltaBracketSpanner}
- @tab @code{100}
- @tab Volta-Klammern
-@item @code{TrillSpanner}
- @tab @code{50}
- @tab Triller-Strecker
-@end multitable
-
-Hier ein Beispiel, das die Standardpositionierung von einigen
-Objekten zeigt.
-
-@cindex Text-Strecker
-@cindex Text-Spanner
-@funindex \startTextSpan
-@funindex \stopTextSpan
-@funindex startTextSpan
-@funindex stopTextSpan
-@cindex Ottava-Klammer
-@cindex Oktavierungsklammer
-
-@cindex TextSpanner, Beispiel zur Veränderung
-@cindex bound-details-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-% 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' \startTextSpan
-% Add Dynamic Text
-c\pp
-% Add Dynamic Line Spanner
-c\<
-% Add Text Script
-c^Text
-c c
-% Add Dynamic Text
-c\ff c \stopTextSpan
-% Stop Ottava Bracket
-\ottava #0
-c, c c c
-@end lilypond
-
-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
-@code{\startTextSpan}-Befehl und endet mit dem
-@code{\stopTextSpan}-Befehl, und das Format des Textes
-wird mit dem @code{\override TextSpanner}-Befehl bestimmt.
-Mehr Einzelheiten siehe @ruser{Text spanners}.
-
-Im Beispiel wird auch gezeigt, wie Oktavierungsklammern
-(Ottava) erstellt werden.
-
-@cindex Taktzahlposition verändern
-@cindex Verändern der Taktzahlposition
-@cindex Position der Taktzahl, verändern
-@cindex Metronom-Bezeichnungsposition verändern
-@cindex Verändern der Metronom-Bezeichnungsposition
-@cindex Übungszeichenposition verändern
-@cindex Verändern der Übungszeichenposition
-
-Beachten Sie, dass Taktnummern, Metronombezeichnungen
-und Übungszeichen nicht gezeigt werden. Sie werden
-standardmäßig im @code{Score}-(Partitur)-Kontext
-erstellt und ihre @code{outside-staff-priority} wird
-in Bezug auf die Layout-Objekte, die im @code{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 (@code{Bar_number_engraver},
-@code{Metronome_mark_engraver} oder @code{Mark_engraver})
-vom @code{Score}-Kontext entfernen und dem
-@code{Staff}-Kontext hinzufügen. Wenn die Engraver so
-geändert werden, erhalten sie folgenden Werte für
-@code{outside-staff-priority}:
-
-@multitable @columnfractions .3 .3
-@headitem Layout-Objekt @tab Priorität
-@item @code{RehearsalMark} @tab @code{1500}
-@item @code{MetronomeMark} @tab @code{1000}
-@item @code{BarNumber} @tab @code{ 100}
-@end multitable
-
-Wenn die Standardwerte der @code{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
-@code{OttavaBracket}-Objektes in der IR oder der Tabelle oben
-herausfinden und einen kleineren Wert angeben als der Wert, den
-das @code{TextSpanner}-(Strecker)-Objekt bekommt, wobei noch daran
-zu denken ist, dass @code{OttavaBracket} im @code{Staff}-Kontext
-erstellt wird:
-
-@cindex TextSpanner, Beispiel zur Veränderung
-@cindex bound-details-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-% 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' \startTextSpan
-% Add Dynamic Text
-c\pp
-% Add Dynamic Line Spanner
-c\<
-% Add Text Script
-c^Text
-c c
-% Add Dynamic Text
-c\ff c \stopTextSpan
-% Stop Ottava Bracket
-\ottava #0
-c, c c c
-@end lilypond
-
-@cindex Legatobögen und outside-staff-priority
-@cindex Legatobögen und Artikulationszeichen
-@cindex Artikulationszeichen und Legatobögen
-
-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 @code{avoid-slur}-Eigenschaft hat nur
-eine Auswirkung, wenn auch die @code{outside-staff-priority}
-auf @code{#f} gesetzt ist. Alternativ kann die
-@code{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:
-
-@lilypond[quote,verbatim,relative=2]
-c4( c^\markup\tiny\sharp d4.) c8
-c4(
-\once \override TextScript #'avoid-slur = #'inside
-\once \override TextScript #'outside-staff-priority = ##f
-c^\markup\tiny\sharp d4.) c8
-\once \override Slur #'outside-staff-priority = #500
-c4( c^\markup\tiny\sharp d4.) c8
-@end lilypond
-
-Eine Änderung der @code{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 @qq{Text3} oberhalb von @qq{Text4}
-gesetzt werden, das Beispiel wurde behandelt in
-@ref{Automatic behavior}. Der Wert der Priorität muss also für
-die Eigenschaft @code{TextScript} entweder in der IR oder in der
-Tabelle oben festgestellt werden und dann die Priorität für
-@qq{Text3} höher eingestellt werden:
-
-@cindex TextScript, Beispiel zur Veränderung
-@cindex outside-staff-priority-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-c2^"Text1"
-c^"Text2"
-\once \override TextScript #'outside-staff-priority = #500
-c^"Text3"
-c^"Text4"
-@end lilypond
-
-Damit wird zwar @qq{Text3} ganz richtig über @qq{Text4}
-platziert, aber auch über @qq{Text2}, und @qq{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
-@code{textLengthOn}-(Textlänge an)-Befehl.
-
-@subheading \textLengthOn
-
-@cindex Noten, durch Text gespreizt
-@funindex \textLengthOn
-@funindex textLengthOn
-@funindex \textLengthOff
-@funindex textLengthOff
-
-Standardmäßig wird Text, der mit dem Beschriftungsbefehl
-@code{\markup} bzw. Äquivalenten erstellt wird, kein
-zusätzlicher Platz in Bezug auf die Positionierung der Noten
-zugestanden. Der @code{\textLengthOn}-Befehl ändert
-dieses Verhalten, so dass die Noten gespreizt werden, wenn
-die Breite des Textes es erfordert:
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\textLengthOn % Cause notes to space out to accommodate text
-c2^"Text1"
-c^"Text2"
-c^"Text3"
-c^"Text4"
-@end lilypond
-
-Dieses Verhalten wird mit dem @code{\textLengthOff}-Befehl
-rückgängig gemacht. Erinnern Sie sich, dass @code{\once} nur mit
-@code{\override}, @code{\set}, @code{\revert} oder @code{unset}
-funktioniert, der Befehl kann also nicht zusammen mit
-@code{\textLengthOn} benutzt werden.
-
-@cindex Textbeschriftung, Vermeidung von Zusammenstößen
-@cindex Zusammenstöße vermeiden mit Textbeschriftung
-
-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 @code{#f} gesetzt wird. Hier ein Beispiel, wie
-eine Textbeschriftung mit diesen Noten reagiert:
-
-@cindex Textbeschriftung, Beispiel zur Veränderung
-@cindex outside-staff-priority-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-% This markup is short enough to fit without collision
-c2^"Tex"
-c''2
-R1
-% This is too long to fit, so it is displaced upwards
-c,,2^"Text"
-c''2
-R1
-% Turn off collision avoidance
-\once \override TextScript #'outside-staff-priority = ##f
-c,,2^"Long Text "
-c''2
-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
-@end lilypond
-
-
-@subheading Dynamics
-
-@cindex Verändern der Positionierung von Dynamikzeichen
-@cindex Dynamikzeichen: Positionierung verändern
-
-Dynamikbezeichnung wird üblicherweise unter dem System
-gesetzt, kann aber auch nach oben mit dem Befehl
-@code{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:
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-\clef "bass"
-\key aes \major
-\time 9/8
-\dynamicUp
-bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
-ees,2.~\)\mf ees4 r8 |
-@end lilypond
-
-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:
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\dynamicUp
-a4\f b\mf c\mp b\p
-@end lilypond
-
-@noindent
-Wenn eine ähnliche Situation in @qq{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 @code{\textLengthOn}-Befehl,
-aber es gibt keinen entsprechenden Befehl für Dynamik. Wir
-müssen also unsere eigenen Befehle mit @code{\override}
-konstruieren.
-
-
-@subheading Grob sizing
-
-@cindex Grob, Größenveränderung
-@cindex Größenveränderung 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 (@code{X-offset}) und einer
-vertikalen Position (@code{Y-offset}) ausgerichtet, immer bezüglich
-des übergeordneten Objektes. Eine horizontale Strecke wird
-durch ein Zahlenpaar angegeben (@code{X-extent}), welche
-die linke und rechte Grenze relativ zum übergeordneten Objekt
-bezeichnen. Die vertikale Strecke wir genauso durch ein
-Zahlenpaar (@code{Y-extent}) definiert. Diese Eigenschaften
-gehören zu allen Grobs, die das
-@code{grob-interface} unterstützen.
-
-@cindex @code{extra-spacing-width}
-
-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 Undendlich (der Code der
-@code{extra-spacing-width}-(zusätzliche Positionierungslänge)-Eigenschaft
-lautet: @code{'(+inf.0 . -inf.0)}).
-Damit sich diese Objekte also horizontal nicht überschneiden, muss
-der Wert von @code{extra-spacing-width} auf
-@code{'(0 . 0)} gesetzt werden, sodass die wirkliche Länge eines
-Objektes zur Geltung kommt. Mit diesem Befehl wird das für
-Dynamik-Zeichen erledigt:
-
-@example
-\override DynamicText #'extra-spacing-width = #'(0 . 0)
-@end example
-
-@noindent
-Schauen wir uns an, wie es mit dem vorigen Beispiel funktioniert:
-
-@cindex DynamicText, Beispiel zur Veränderung
-@cindex extra-spacing-width-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\dynamicUp
-\override DynamicText #'extra-spacing-width = #'(0 . 0)
-a4\f b\mf c\mp b\p
-@end lilypond
-
-@noindent
-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 @code{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:
-
-@cindex DynamicText, Beispiel zur Veränderung
-@cindex extra-spacing-width-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\dynamicUp
-% Extend width by 1 staff space
-\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
-a4\f b\mf c\mp b\p
-@end lilypond
-
-@noindent
-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
-@code{staff-padding}-Eigenschaft erreicht werden,
-die wir uns im folgenden Abschnitt genauer anschauen werden.
-
-
-
-@node Collisions of objects
-@section Collisions of objects
-
-@menu
-* Moving objects::
-* Fixing overlapping notation::
-* Real music example::
-@end menu
-
-@node Moving objects
-@subsection Moving objects
-
-@cindex Verschieben von überschneidenden Objekten
-@cindex Verschieben von Zusammenstößen
-@cindex Zusammenstöße vermeiden
-@cindex Objekte, verschieben von Zusammestößen
-@cindex Vermeiden von Zusammenstößen
-
-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:
-
-@enumerate
-@item
-Die @strong{Richtung} eines der überlappenden Objekte kann
-geändert werden, indem die vordefinierten Befehle für
-Innersystemobjekte verwendet werden, wie beschrieben in
-@ref{Within-staff objects}. 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.
-
-@item
-Die @strong{Objekteigenschaft}, die LilyPond benutzt um die
-Layout-Objekte zu platzieren, können mit dem
-@code{\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 @code{\override} sich auf
-alle Fälle eines Objekttyps bezieht. Zu diesen Eigenschaften
-gehören:
-
-@itemize
-
-@item
-@code{direction} (Richtung)
-
-Das wurde schon detailliert behandelt, siehe
-@ref{Within-staff objects}.
-
-@item
-@code{padding}, @code{left-padding},
-@code{right-padding}, @code{staff-padding} (Verschiebung)
-
-@cindex left-padding-Eigenschaft
-@cindex Padding-Eigenschaft
-@cindex right-padding-Eigenschaft
-@cindex staff-padding-Eigenschaft
-@cindex Verschieben (padding)
-@cindex Füllung (padding)
-@cindex padding (Füllung)
-
-Wenn ein Objekt platziert wird, bestimmt der Wert seiner
-@code{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 @code{padding}-Wert
-des Objektes, das platziert werden soll, der @code{padding}-Wert
-des Objektes, das schon gesetzt wurde, wird hingegegen
-ignoriert. Abstände mit @code{padding} können zu
-allen Objekten hinzugefügt werden, die das
-@code{side-position-interface} unterstützen.
-
-Anstelle von @code{padding} wird die Position von
-Versetzungszeichengruppen durch die Eigenschaften
-@code{left-padding} und @code{right-padding} bestimmt.
-Diese Eigenschaften werden im
-@code{AccidentalPlacement}-(Versetzungszeichen-Positionierungs)-Objekt
-gefunden, das sich innerhalb des @strong{Staff}-Kontexts
-befindet. Während des Notensatzes werden die Notenköpfe
-zuerst gesetzt und dann die Versetzungszeichen, wenn denn
-welche gesetzt werden, durch die @code{right-padding}-Eigenschaft
-auf die linke Seite der Notenköpfe positioniert, um die Entfernung
-von den Notenköpfen zu bestimmen. Also nur die
-@code{right-padding}-(Verschiebung nach rechts)-Eigenschaft des
-@code{AccidentalPlacement}-Objekts hat Einfluss auf die
-Positionierung der Versetzungszeichen.
-
-Die @code{staff-padding}-(Verschiebung zum System)-Eigenschaft
-ist sehr ähnlich wie die @code{padding}-Eigenschaft:
-@code{padding} bestimmt den Minimalabstand zwischen
-einem Objekt, das das @code{side-position-interface}
-unterstützt, und dem nächsten anderen Objekt (normalerweise
-die Note oder Notenlinie); @code{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. @code{staff-padding} hat also @strong{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 @code{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 @code{padding}-Eigenschaften
-nicht unbedingt in dem Objekt selber befinden, schauen Sie
-also auch in Objekten nach, die offensichtlich Ähnlichkeiten
-haben.
-
-Alle @code{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.
-
-@item
-@code{self-alignment-X} (Selbstpositionierung)
-
-@cindex self-alignment-X-Eigenschaft
-@cindex Selbstpositionierung von Objekten
-@cindex Ausrichtung von Objekten
-
-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 @code{self-alignment-interface}
-unterstützen. Das sind üblicherweise Objekte, die Text
-enthalten. Die möglichen Werte der Eigenschaft sind @code{LEFT},
-@code{RIGHT} oder @code{CENTER}. Alternativ kann ein
-numerischer Wert zwischen @code{-1} und @code{+1}
-bestimmt werden: @code{-1} heißt linksbündig, @code{+1}
-rechtsbündig und Zahlen dazwischen bewegen den Text
-schrittweise von links nach rechts. Zahlen größer als
-@code{1} können angegeben werdne, um den Text
-noch weiter nach links zu bewegen, oder weniger als @code{-1},
-um ihn weiter nach rechts zu schieben. Eine Änderung
-um @code{1} des Wertes entspricht einer Bewegung um
-die halbe Textbreite.
-
-@item
-@code{extra-spacing-width} (zusätzliche Breite)
-
-@cindex extra-spacing-width-Eigenschaft
-
-Diese Eigenschaft steht für alle Objekte zur Verfügung, die
-das @code{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
-@code{accidental}-(Versetzungszeichen)-Objekt etwa beachtet
-nur erste Zahl für die linke Ausdehnung.
-
-@item
-@code{staff-position} (Notensystempositionierung)
-
-@cindex staff-position-Eigenschaft
-
-@code{staff-position} ist eine Eigenschaft des
-@code{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.
-
-@item
-@code{force-hshift} (vertikale Verschiebung erzwingen)
-
-@cindex force-hshift-Eigenschaft
-
-Eng beeinander 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 @code{NoteColumn}-Objekt wird erstellt um die Noten in den
-Kolumnen zu setzen.
-
-Die @code{force-hshift}-(erzwinge horizontale Verschiebung)-Eigenschaft
-ist eine Eigenschaft von @code{NoteColumn} (bzw. vom
-@code{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 @code{\shiftOn}-Befehle (siehe auch
-@ref{Explicitly instantiating voices}) das Problem nicht beseitigen.
-Diese Eigenschaft ist besser in solchen Fällen zu verwenden als die
-@code{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.
-
-@end itemize
-
-@item
-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 errechnent 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:
-
-@table @code
-@item extra-offset (zusätzlicher Abstand)
-
-@cindex extra-offset-Eigenschaft
-
-Diese Eigenschaft gehört zu jedem Layout-Objekt, das das
-@code{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.
-
-@item positions (Position)
-
-@cindex positions-Eigenschaft
-
-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 @qq{am besten aussieht}. Wenn die
-@code{positions}-Eigenschaft verändert worden ist, wird der
-Bogen aus der Liste gewählt, der der gewünschten Position am
-nächsten kommt.
-@end table
-
-@end enumerate
-
-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.
-
-@multitable @columnfractions .5 .5
-@headitem Objekttyp @tab Objektbezeichnung
-@item Articulationszeichen @tab @code{Script}
-@item Balken @tab @code{Beam}
-@item Dynamikzeichen (vertikal) @tab @code{DynamicLineSpanner}
-@item Dynamikzeichen (horizontal) @tab @code{DynamicText}
-@item Fingersatz @tab @code{Fingering}
-@item Übungs-/Textmarken @tab @code{RehearsalMark}
-@item Legatobögen @tab @code{Slur}
-@item Text z. B. @code{^"text"} @tab @code{TextScript}
-@item Bindebögen @tab @code{Tie}
-@item N-tolen @tab @code{TupletBracket}
-@end multitable
-
-
-@node Fixing overlapping notation
-@subsection Fixing overlapping notation
-
-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.
-
-@subheading padding property
-
-@cindex padding (Verschiebungs-Eigenschaft)
-@cindex Überschneidende Notation korrigieren
-@cindex Korrigieren von überschneidender Notation
-
-Die @code{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.
-
-@cindex Script, Beispiel zur Veränderung
-@cindex Verschiebungs-Eigenschaft, Beispiel
-@cindex padding (Verschiebuns-Eigenschaft), Beispiel
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c2\fermata
-\override Script #'padding = #3
-b2\fermata
-@end lilypond
-
-@cindex MetronomMark, Beispiel zur Veränderung
-@cindex Verschiebungs-Eigenschaft, Beispiel
-@cindex padding (Verschiebuns-Eigenschaft), Beispiel
-
-@lilypond[quote,fragment,relative=1,verbatim]
-% 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
-@end lilypond
-
-Im zweiten Beispiel können Sie sehen, wie wichtig es ist den richtigen
-Kontext anzugeben. Weil das @code{MetronomeMark}-Objekt
-sich im @code{Score}-Kontext befindet, werden Eigenschaftsänderungen
-im @code{Voice}-Kontext einfach ignoriert. Für mehr Einzelheiten siehe
-@ruser{Modifying properties}.
-
-Wenn die @code{padding}-Eigenschaft eines Objektes erhöht wird, das
-sich in einem Stapel von Objekten befindet, die nach ihrer
-Außersystempriorität (@code{outside-staff-priority}) positioniert werden,
-werden das Objekt und alle, die sich außerhalb davon befinden,
-entsprechend verschoben.
-
-@subheading left-padding and right-padding
-
-@cindex left-padding-Eigenschaft (Verschiebung nach links)
-@cindex Verschiebung nach rechts oder links
-@cindex right-padding-Eigenschaft (Verschiebung nach rechts)
-
-Die @code{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 das folgende
-Beispiel zeigt eine Situation, wo man sie braucht. Das Beispiel
-stellt eine Situation dar, in der in einem Akkord sowohl H als auch
-B vorkommen sollen. Damit keine Ambiguität ensteht, sollen beide
-Noten ein Zeichen haben, also ein B und ein Auflösungszeichen.
-Hier einige Notationsversuche:
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-<b bes>
-<b! bes>
-<b? bes>
-@end lilypond
-
-@noindent
-Keiner davon funktioniert, und der zweite und dritte weist
-hässliche Zusammenstöße zwischen den Zeichen auf.
-
-Eine Möglichkeit, das Gewünschte zu erhalten, ist es den
-Stencil des Versetzungszeichens zu ersetzen mit einer
-Textbeschriftung (Markup), die sowohl das B als auch das
-Aulösungszeichen enthält:
-
-@cindex Versetzungszeichen, Beispiel zur Veränderung
-@cindex Accidental, Beispiel zur Veränderung
-@cindex Text-Eigenschaft, Beispiel
-@cindex stencil-Eigenschaft, Beispiel
-@cindex AccidentalPlacement, Beispiel zur Veränderung
-@cindex right-padding-Eigenschaft, Beispiel
-@cindex Verschiebung nach rechts (rigth-padding), Beispiel
-
-@lilypond[quote,ragged-right,verbatim]
-naturalplusflat = \markup { \natural \flat }
-\relative c'' {
- \once \override Accidental
- #'stencil = #ly:text-interface::print
- \once \override Accidental #'text = #naturalplusflat
- \once \override Score.AccidentalPlacement #'right-padding = #1.5
- <b bes>
-}
-@end lilypond
-
-@noindent
-Dazu ist aber ein @code{\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 @code{text}-Eigenschaft des
-@code{Accidental} (Versetzungszeichen)-Objekts zu setzen,
-die dann so definiert wird, dass sie ein Auflösungszeichen gefolgt
-von einem B enthält. Diese werden dann mit @code{right-padding}
-weiter nach rechts verschoben.
-
-
-@subheading staff-padding property
-
-@cindex staff-padding-Eigenschaft
-@cindex Objekte an der Grundlinie ausrichten
-@cindex Ausrichten von Objekten an der Grundlinie
-
-@code{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 @code{DynamicText}, sondern von @code{DynamicLineSpanner}.
-Das liegt daran, dass die Grundlinie sich gleicherweise auf
-@strong{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:
-
-@cindex DynamikText, Beispiel zur Veränderung
-@cindex extra-spacing-width-Eigenschaft, Beispiel
-@cindex DynamicLineSpanner, Beispiel zur Veränderung
-@cindex staff-padding-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\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
-@end lilypond
-
-
-@subheading self-alignment-X property
-
-@cindex self-alignment-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:
-
-@cindex StringNumber, Beispiel zur Veränderung
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
-\voiceOne
-< a \2 >
-\once \override StringNumber #'self-alignment-X = #RIGHT
-< a \2 >
-@end lilypond
-
-
-@subheading staff-position property
-
-@cindex staff-position-Eigenschaft
-@cindex Notensystem-Position-Eigenschaft
-@cindex Kollision von Objekten im System
-@cindex Zusammenstöße von Objekten im System
-
-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:
-
-@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
-<< {c c c c} \\ {R1} >>
-@end lilypond
-
-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 (@code{\voiceTwo},
-also die zweite Stimme in der
-@code{<<@{...@} \\ @{...@}>>}-Konstruktion) wird die
-Position auf dem System (@code{staff-position}) auf -4
-für @code{MultiMeasureRest}, in unserem Beispiel muss
-es also bspw. auf die Position @code{-8} gesetzt werden,
-d.h. vier halbe Notenlinienabstände weiter nach unten:
-
-@cindex MultiMeasureRest, Beispiel zur Veränderung
-@cindex Ganztaktpausen, Beispiel zur Veränderung
-@cindex staff-position-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
-<<
- {c c c c}
-\\
- \override MultiMeasureRest #'staff-position = #-8
- {R1}
->>
-@end lilypond
-
-Das ist besser, als etwa @code{extra-offset} zu benutzen, denn
-in unserem Fall wird die Hilfslinie der Pause automatisch gesetzt.
-
-
-@subheading extra-offset property
-
-@cindex extra-offset-Eigenschaft
-@cindex Zusätzlicher Abstand, Positionierung
-@cindex Positionierung von Objekten
-@cindex Objekte, Positionierung
-
-Die @code{extra-offset}-Eigenschaft bietet vollständige Kontrolle
-über die Positionierung von Objekten in horizontaler und vertikaler
-Richtung.
-
-Im Beispiel unten ist das zweite Fingersatzzeichen (@code{Fingering}) etwas nach
-links und 1,8 Notenlinienabstände nach unten verschoben:
-
-@cindex Fingersatz, Beispiel zur Veränderung
-@cindex extra-offset-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,relative=1,verbatim]
-\stemUp
-f-5
-\once \override Fingering
- #'extra-offset = #'(-0.3 . -1.8)
-f-5
-@end lilypond
-
-
-@subheading positions property
-
-@cindex positions-Eigenschaft
-@cindex Kontrolle über Triolen, Bögen und Balken manuell
-@cindex manuelle Kontrolle über Triolen, Bögen, Balken
-@cindex Balken, manuelle Kontrolle
-@cindex Bögen, manuelle Kontrolle
-@cindex Legatobögen, manuelle Kontrolle
-@cindex Phrasierungsbögen, manuelle Kontrolle
-@cindex Triollen-Klammer, manuelle Kontrolle
-
-Die @code{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:
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4 \acciaccatura e8\( d8 c ~c d c d\)
-@end lilypond
-
-@noindent
-Man könnte einfach den Phrasierungsbogen oberhalb der Noten setzen, und
-das wäre auch die beste Lösung:
-
-@cindex Phrasierungsbogen, Beispiel zur Veränderung
-@cindex positions-Eigenschaft, Beispiel
-@cindex Positionierung, Beispiel
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4
-\phrasingSlurUp
-\acciaccatura e8\( d8 c ~c d c d\)
-@end lilypond
-
-@noindent
-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 @code{positions}-Eigenschaft einsetzt. Damit
-verschwindet auch die etwas unschöne Form:
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4
-\once \override PhrasingSlur #'positions = #'(-4 . -3)
-\acciaccatura
-e8\( d8 c ~c d c d\)
-@end lilypond
-
-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:
-
-@lilypond[quote,verbatim,fragment,ragged-right]
-{
-\clef "bass"
-<< {b,8 ais, b, g,} \\ {e, g e, g} >>
-<< {b,8 ais, b, g,} \\ {e, g e, g} >>
-}
-@end lilypond
-
-@noindent
-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:
-
-@cindex Balken, Beispiel zur Veränderung
-@cindex positions-Eigenschaft, Beispiel
-@cindex Positionierung, Beispiel
-
-@lilypond[quote,verbatim,fragment,ragged-right]
-{
- \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} >>
-}
-@end lilypond
-
-@noindent
-Hier ist zu beobachten, dass die Veränderung sich auch auf die
-weiteren Achtelbalken der ersten Stimme auwirkt, während sie keine
-Auswirkung auf die Balken der zweiten Stimme hat.
-
-@subheading force-hshift property
-
-@cindex force-hshift-Eigenschaft
-@cindex Vertikale Verschiebung erzwingen
-
-@c FIXME: formatting stuff (ie not important right now IMO)
-@c @a nchor Chopin finally corrected TODOgp
-
-An diesem Punkt können wir den letzten Feinschliff an unserem
-Chopin-Beispiel vornhemen, das wir behandelt haben in
-@ref{I'm hearing Voices}. Wir hatten es in folgende Form
-gebracht:
-
-@lilypond[quote,verbatim,fragment,ragged-right]
-\new Staff \relative c'' {
- \key aes \major
- <<
- { c2 aes4. bes8 } \\
- { aes2 f4 fes } \\
- { \voiceFour
- <ees c>2
- des2
- }
- >> |
- <c ees aes c>1 |
-}
-@end lilypond
-
-@noindent
-Die unteren zwei Noten des ersten Akkords (also diein der
-dritten Stimme) sollten nicht aus der Notenkolumne der
-oberen zwei Noten weggeschoben werden. Um das zu
-korrigieren, setzen wir @code{force-hshift}, das eine
-Eigenschaft von
-@code{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 @code{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:
-
-@cindex Notenkolumne, Beispiel zur Veränderung
-@cindex force-hshift-Eigenschaft, Beispiel
-@cindex vertikale Verschiebung, Beispiel
-
-@lilypond[quote,verbatim,fragment,ragged-right]
-\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 |
-}
-@end lilypond
-
-
-@node Real music example
-@subsection Real music example
-
-Das Kapitel zu Optimierungen soll mit einem komplizierten Beispiel
-beendet werden, in dem verschiedene Optimierungen vorgenommen
-werden müssen, bis das Ergebnis gut ausssieht. 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.
-
-@c This example should not be indexed
-@lilypond[quote,ragged-right]
-rhMusic = \relative c'' {
- r2
- c4.\( g8 |
- \once \override Tie #'staff-position = #3.5
- bes1~ |
- \bar "||"
- \time 6/4
- \mergeDifferentlyHeadedOn
- \mergeDifferentlyDottedOn
- bes2.^\markup {\bold "Moderato"} r8
- <<
- {c,8[ d fis bes a] | }
- \\
- % Reposition the c2 to the right of the merged note
- {c,8~ \once \override NoteColumn #'force-hshift = #1.0
- % Move the c2 out of the main note column so the merge will work
- \shiftOnn c2}
- \\
- % Stem on the d2 must be down to permit merging
- {s8 \stemDown \once \override Stem #'transparent = ##t d2}
- \\
- {s4 fis4.}
- >>
- \mergeDifferentlyHeadedOff
- \mergeDifferentlyDottedOff
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-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
-Stimmen nur zeitweise zu erstellen, wenn sie auftreten. Wenn
-Sie vergessen haben, wie man das anstellt, schauen Sie sich
-nochmal den Abschnitt @ref{I'm hearing Voices} an. Wir
-wollen anfange, indem wir die Noten in zwei Variablen
-notieren und dann die Systemstruktur in einer
-@code{\score}-Umgebung erstellen. Das ist, was LilyPond
-erstellt:
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- r2 c4. g8 |
- bes1~ |
- \time 6/4
- bes2. r8
- % Start polyphonic section of four voices
- <<
- {c,8 d fis bes a | }
- \\
- {c,8~ c2 | }
- \\
- {s8 d2 | }
- \\
- {s4 fis4. | }
- >>
- g2.
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-Alle Noten sind richtig, aber die Positionierung sehr
-verbesserungsbedürftig. Der Bindebogen stößt mit
-der veränderten Taktart zusammen, die Balkung im
-dritten Takt ist falsch, die 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:
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- r2 c4.\( g8 |
- bes1~ |
- \time 6/4
- bes2. r8
- % Start polyphonic section of four voices
- <<
- {c,8[ d fis bes a] | }
- \\
- {c,8~ c2 | }
- \\
- {s8 d2 | }
- \\
- {s4 fis4. | }
- >>
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-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 @qq{Arpeggio} und @qq{Taktlinien}: ein
-Arpeggio also erstellt man mit dem Befehl @code{\arpeggio}
-hinter einem Akkord und eine doppelte Taktlinie wird mit dem
-Befehl @code{\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 @ref{Moving objects}, wo stand, dass Objekte
-die
-relativ zum System positioniert werden, verschoben werden
-können, indem ihre @code{staff-position}-Eigenschaft
-geändert wird, die in halben Notenlienienabständen relativ
-zur Mittellinie angegeben wird. Dieser @code{\override}-Befehl
-also, direkt vor die erste übergebundene Note gestellt, verschiebt
-den Bindebogen (@code{tie}) 3,5 halbe Notenlinienabstände
-über die Mittellinie:
-
-@code{\once \override Tie #'staff-position = #3.5}
-
-Damit ist auch der zweite Takt vollständig:
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- 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] | }
- \\
- {c,8~ c2 | }
- \\
- {s8 d2 | }
- \\
- {s4 fis4. | }
- >>
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-In Takt drei beginnt der Moderato-Abschnitt. In der
-Übung wurde behandelt, wie man fetten Text mit dem
-@code{\markup}-Befehl eingibt, es ist also einfach, das
-@qq{Moderato} hinzuzufügen. Wie aber werden Noten
-verschmolzen? Hier nehmen wir wieder die Notationsreferenz
-zu Hilfe. Die Suche nach @qq{Verschmelzen} (engl. merge)
-im Index führt uns zu den Befehlen um Noten mit
-unterschiedlichen Köpfen und unterschiedlichen Punkten
-zu verschmelzen in @ruser{Collision resolution}. In unserem
-Beispiel müssen sowohl unterschiedliche Köpfe also auch
-unterschiedliche Punktierung verschmolzen werden, wir
-brauchen also die Befehle
-
-@example
-\mergeDifferentlyHeadedOn
-\mergeDifferentlyDottedOn
-@end example
-
-@noindent
-aus der Notationsreferenz, die wir an den Beginn unseres
-Abschnittes stellen und
-
-@example
-\mergeDifferentlyHeadedOff
-\mergeDifferentlyDottedOff
-@end example
-
-@noindent
-um das Verhalten wieder auszuschalten. Das sieht so aus:
-
-@cindex Bindebogen, Beispiel zur Veränderung
-@cindex staff-position-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- 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] | }
- \\
- {c,8~ c2 | }
- \\
- {s8 d2 | }
- \\
- {s4 fis4. | }
- >>
- \mergeDifferentlyHeadedOff
- \mergeDifferentlyDottedOff
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-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 @code{\stemDown}, und in der Notationsreferenz findet
-sich auch Information, wie das C verschoben werden kann: mit
-dem @code{\shift}-Befehl. Aber welcher von ihnen? Das C
-befindet sich in der zweiten Stimme, die @qq{shift off} hat,
-die zwei Ds sind in den Stimmen eins und drei, die @qq{shift
-off} bzw. @qq{shift on} haben. Das C muss also noch eine
-Stufe weiter verschoben werden mit @code{\shiftOnn}, damit
-es die Verschmelzung der Ds nicht stört. Das sieht jetzt so
-aus:
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- 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] | }
- \\
- % Move the c2 out of the main note column so the merge will work
- {c,8~ \shiftOnn c2 | }
- \\
- % Stem on the d2 must be down to permit merging
- {s8 \stemDown d2 | }
- \\
- {s4 fis4. | }
- >>
- \mergeDifferentlyHeadedOff
- \mergeDifferentlyDottedOff
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-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
-@code{force-hshift}-Eigenschaft. Hier ist das Endergebnis:
-
-@cindex Notenkolumne, Beispiel zur Veränderung
-@cindex force-hshift-Eigenschaft, Beispiel
-@cindex Hals, Beispiel zur Veränderung
-@cindex Notenhals, Beispiel zur Veränderung
-@cindex transparent-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,ragged-right]
-rhMusic = \relative c'' {
- r2
- c4.\( g8 |
- \once \override Tie #'staff-position = #3.5
- bes1~ |
- \bar "||"
- \time 6/4
- bes2.^\markup {\bold "Moderato"} r8
- \mergeDifferentlyHeadedOn
- \mergeDifferentlyDottedOn
- <<
- {c,8[ d fis bes a] | }
- \\
- % Reposition the c2 to the right of the merged note
- {c,8~ \once \override NoteColumn #'force-hshift = #1.0
- % Move the c2 out of the main note column so the merge will work
- \shiftOnn c2}
- \\
- % Stem on the d2 must be down to permit merging
- {s8 \stemDown \once \override Stem #'transparent = ##t d2}
- \\
- {s4 fis4.}
- >>
- \mergeDifferentlyHeadedOff
- \mergeDifferentlyDottedOff
- g2.\)
-}
-
-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
- >>
- >>
-}
-@end lilypond
-
-
-@node Further tweaking
-@section Further tweaking
-
-@menu
-* Other uses for tweaks::
-* Using variables for tweaks::
-* Other sources of information::
-* Avoiding tweaks with slower processing::
-* Advanced tweaks with Scheme::
-@end menu
-
-@node Other uses for tweaks
-@subsection Other uses for tweaks
-
-@cindex Transparente Objekte
-@cindex Entfernen von Objekten
-@cindex Verstecken von Objekten
-@cindex Unsichtbare Objekte
-@cindex transparent-Eigenschaft, Benutzung
-@cindex Objekte unsichtbar machen
-@cindex Objekte entfernen
-@cindex Objekte verstecken
-@cindex Noten zwischen Stimmen überbinden
-@cindex Überbinden von Noten zwischen Stimmen
-
-@subheading Tying notes across voices
-
-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,
-
-@lilypond[quote,fragment,relative=2]
-<< { b8~ b8\noBeam }
-\\ { b[ g8] }
->>
-@end lilypond
-
-@noindent
-und dann den ersten Hals nach oben unsichtbar macht,
-sieht es so aus, als ob die Überbindung zwischen
-den Stimmen stattfindet:
-
-@cindex Hals, Beispiel zur Veränderung
-@cindex Notenhals, Beispiel zur Veränderung
-@cindex transparent-Eigenschaft, Beispiel
-
-@lilypond[quote,fragment,relative=2,verbatim]
-<<
- {
- \once \override Stem #'transparent = ##t
- b8~ b8\noBeam
- }
-\\
- { b[ g8] }
->>
-@end lilypond
-
-Um sicherzugehen, dass der unsichtbare Hals den Bindebogen
-nicht zu sehr verkleinert, kann er verlängert werden, indem
-seine Länge (@code{length}) auf den Wert @code{8}
-gesetzt wird:
-
-@lilypond[quote,fragment,relative=2,verbatim]
-<<
- {
- \once \override Stem #'transparent = ##t
- \once \override Stem #'length = #8
- b8~ b8\noBeam
- }
-\\
- { b[ g8] }
->>
-@end lilypond
-
-
-@subheading Simulating a fermata in MIDI
-
-@cindex stencil-Eigenschaft, Benutzung
-@cindex Fermate, Benutzung in MIDI
-@cindex MIDI: Fermate erstellen
-
-Für Objekte außerhalb des Notensystems ist es normalerweise
-besser, die @code{stencil}-Eigenschaft anstelle der
-@code{transparent}-Eigenschaft zu verändern, wenn man
-sie vom fertigen Notensatz entfernen will. Indem die
-@code{stencil}-Eigenschaft auf falsch (@code{#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,
-@code{stencil} auf @code{#f} zu setzen. Im Beispiel wird
-der Unterschied zwischen einem unsichtbaren Objekt und
-einem entfernten Objekt gezeigt:
-
-@cindex Metronom-Bezeichnung, Beispiel zur Veränderung
-@cindex transparent-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim,ragged-right]
-\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
- a\fermata
- % New tempo for next section
- \tempo 4=100
- a a a a
- }
- \layout { }
- \midi { }
-}
-@end lilypond
-
-@lilypond[quote,verbatim,ragged-right]
-\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
- a\fermata
- % New tempo for next section
- \tempo 4=100
- a a a a
- }
- \layout { }
- \midi { }
-}
-@end lilypond
-
-@noindent
-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 @code{stencil} entfernt
-wurde, nicht passiert.
-
-
-@node Using variables for tweaks
-@subsection Using variables for tweaks
-
-@cindex Variablen, Benutzung zur Optimierung
-@cindex Optimierung mit Variablen
-
-@code{\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 @code{\italic} und @code{\bold} funktionieren
-im Gesangstext-Kontext nur, wenn sie gleichzeitig mit den Wörtern,
-auf die sie angewendet werden sollen, zusätzlich
-in eine @code{\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
-@code{\override} und @code{\revert} zu konstruieren.
-
-@example
-@code{\override Lyrics . LyricText #'font-shape = #'italic}
-@code{\override Lyrics . LyricText #'font-series = #'bold}
-
-@code{\revert Lyrics . LyricText #'font-shape}
-@code{\revert Lyrics . LyricText #'font-series}
-@end example
-
-Das wäre natürlich noch viel mühsamer, wenn viele Wörter eine
-Hervorhebung benötigen. Anstelle dieser Befehlsketten @emph{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 Leerzeichn um die
-Punkte herum nicht benötigt werden, weil sie nicht innerhalb des
-@code{lyricmode}-Kontextes interpretiert werden. Hier ein Beispiel;
-die Bezeichnungen können natürlich auch kürzer sein,
-um noch weniger schreiben zu müssen:
-
-@cindex LyricText, Beispiel zur Veränderung
-@cindex Gesangstext, Beispiel zur Veränderung
-@cindex font-shape-Eigenschaft, Beispiel
-@cindex font-series-Eigenschaft, Beispiel
-
-@lilypond[quote,verbatim]
-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 = { \time 4/4 \partial 4 \key c \major}
-SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
-AltoMusic = \relative c' { c4 | c4. c8 e4 e | f 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 }
- >>
- >>
-}
-@end lilypond
-
-
-@node Other sources of information
-@subsection Other sources of 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:
-
-@strong{Von lilypond.org heruntergeladen}
-
-@itemize @bullet
-@item Linux
-
-Wechseln Sie in das Verzeichnis
-@file{@var{INSTALL_VERZ}/lilypond/usr/share/lilypond/current/}
-
-@item MacOS X
-
-Wechseln Sie in das Verzeichnis
-@file{@var{INSTALL_VERZ}/LilyPond.app/Contents/Resources/share/lilypond/current/}
-indem Sie entweder mit dem Befehl @code{cd} vom Terminal aus
-in das Verzeichnis wechseln, oder mit Control-Klick auf das
-LilyPond-Programmsymbol gehen und @qq{Show Package Contents}
-auswählen.
-
-@item Windows
-
-Wechseln Sie mit dem Windows Explorer ins Verzeichnis
-@file{@var{INSTALL_VERZ}/LilyPond/usr/share/lilypond/current/}
-
-@end itemize
-
-@strong{Mit einem Paket-Manager installiert oder selber aus
-den Quellen kompiliert}
-
-Wechseln Sie in das Verzeichnis
-@file{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, wobei
-@var{PREFIX} bei Ihrem Paket-Manager oder dem
-@code{configure}-Skript gesetzt wird, und @var{X.Y.Z}
-die LilyPond-Versionsnummer.
-
-@smallspace
-
-In diesem Ordner sind die zwei interessanten Unterordner:
-
-@itemize
-@item @file{ly/} - beinhaltet Dateien im LilyPond-Format
-@item @file{scm/} - beinhaltet Dateien im Scheme-Format
-@end itemize
-
-Schauen wir uns zuerst einige Dateien in @file{ly/} an.
-Öffnen Sie @file{ly/property-init.ly} in einem Texteditor.
-Der, den Sie normalerweise für @code{.ly}-Dateien benutzen,
-genügt. Diese Datei enthält die Definitionen aller vordefinierten
-Befehle für LilyPond, wie etwa @code{\stemUp} und
-@code{\slurDotted}. Sie können sehen, dass es sich um
-nichts mehr handelt als Definitionen von Variablen, die eine
-oder mehrere @code{\override}-Befehle enthalten. Der
-Befehl @code{/tieDotted} etwa wird folgendermaßen definiert:
-
-@example
-tieDotted = @{
- \override Tie #'dash-period = #0.75
- \override Tie #'dash-fraction = #0.1
-@}
-@end example
-
-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 wichtisgsten Dateien, die sich im Ordner
-@file{ly/} befinden:
-
-@multitable @columnfractions .4 .6
-@headitem Dateiname
- @tab Inhalt
-@item @file{ly/engraver-init.ly}
- @tab Definitionen von Engraver-Kontexten
-@item @file{ly/paper-defaults-init.ly}
- @tab Spezifikationen von Voreinstellungen für Papiermaße
-@item @file{ly/performer-init.ly}
- @tab Definitionen von Performer-Kontexten
-@item @file{ly/property-init.ly}
- @tab Definitionen aller vordefinierten Befehle
-@item @file{ly/spanner-init.ly}
- @tab Definitionen aller vordefinierten Strecker-Befehle
-@end multitable
-
-Andere Einstellungen (wie die Definitionen von Beschriftungsbefehlen)
-sind in @code{.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 @ref{Scheme tutorial}).
-
-Wenn Sie sich mit Scheme auskennen, sind hier mögliche
-interessante Dateien:
-
-@multitable @columnfractions .4 .6
-@headitem Dateiname
- @tab Inhalt
-@item @file{scm/auto-beam.scm}
- @tab Sub-Balken-Voreinstellungen
-@item @file{scm/define-grobs.scm}
- @tab Voreinstellungen für Grob-Eigenschaften
-@item @file{scm/define-markup-commands.scm}
- @tab Definition aller Markup-Beschriftungsbefehle
-@item @file{scm/midi.scm}
- @tab Voreinstellung für die MIDI-Ausgabe
-@item @file{scm/output-lib.scm}
- @tab Einstellungen mit Einfluss auf die Darstellung von Bunddiagrammen, Farben, Versetzungszeichen, Taktlinien usw.
-@item @file{scm/parser-clef.scm}
- @tab Definitionen der unterstützten Schlüssel
-@item @file{scm/script.scm}
- @tab Voreinstellungen for Artikulationszeichen
-@end multitable
-
-
-@node Avoiding tweaks with slower processing
-@subsection Avoiding tweaks with slower processing
-
-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.
-
-@example
-\new Score \with @{
- % 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
-@} @{
- ...
-@}
-@end example
-
-
-@node Advanced tweaks with Scheme
-@subsection Advanced tweaks with Scheme
-
-Auch wenn viele Sachen mit @code{\override} und @code{\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 @ref{Scheme tutorial}.
-
-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.
-
-@cindex x11-Farben, Beispiel zur Benutzung
-@cindex Notenkopf, Beispiel zur Veränderung
-@cindex Farb-Eigenschaft, in Scheme-Prozedur gesetzt
-
-@lilypond[quote,verbatim,ragged-right]
-#(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
- c2 c' |
- b4 g8 a b4 c |
- c,2 a' |
- g1 |
-}
-\addlyrics {
- Some -- where o -- ver the Rain -- bow, way up high,
-}
-@end lilypond
-
-Weiter Beispiele, die die Benutzung dieser programmierbaren
-Schnittstelle zeigen, finden sich in @ref{Tweaking with Scheme}.
projects / lilypond.git / commitdiff
