4.1.4 Vertikale \paper
-Variablen mit flexiblen Abständen
In den meisten Fällen bietet es sich an, dass die vertikalen
Abstände zwischen bestimmten Objekten (wie Ränder, Titel,
Notensystemgruppen und einzelne Partituren) flexibel gehalten
werden, sodass sie je nach Situation gedehnt oder komprimiert
werden können. Es gibt eine Anzahl von Variablen für die
\paper
-Umgebung, mit denen man das Dehnungsverhalten dieser
Dimensionen beeinflussen kann. Sie finden sich unten aufgelistet.
Dabei sollte beachtet werden, dass die Variablen, die in diesem
Abschnitt behandelt werden, nicht die Platzierung und das
Dehnungsverhalten von Notensystemen innerhalb der einzelnen
Systemgruppen behandelt. Die Dehnung zwischen Notensystemen
wird mit Grob-Eigenschaften kontrolliert, deren Einstellungen
normalerweise innerhalb der \score
-Umgebung vorgenommen
werden, und nicht innerhalb der \paper
-Umgebung. Siehe auch
Flexible vertikale Abstände in Systemgruppen.
Struktur der Alisten für flexible vertikale Abstände | ||
Liste der flexiblen vertikalen Abstandsvariablen in \paper |
Struktur der Alisten für flexible vertikale Abstände
Jede der flexiblen vertikalen Abstandsvariablen ist eine Aliste (eine assoziative Liste), die vier Schlüssel (engl. key) enthält:
-
basic-distance
(Grund-Abstand) – der vertikale Abstand, gemessen in Systemzwischenräumen, zwischen den Referenzpunkten zweier Elemente, wenn keine Zusammenstöße vorkommen würden und keine Dehnung oder Kompression stattfindet. Der Referenzpunkt einer (Titel-)Beschriftung (auf höchster Ebene) ist sein höchster Punkt und der Referenzpunkt einer Systemgruppe ist der vertikale Mittelpunkt des nächstenStaffSymbol
– sogar wenn eine Nicht-Notensystemzeile (wie etwa einLyrics
-Kontext) dazwischen kommt. Werte fürbasic-distance
, die weniger als entwederpadding
oderminimum-distance
sind, haben keine Bedeutung, weil der sich daraus ergebende Abstand niemals weniger als entwederpadding
oderminimum-distance
ergibt. -
minimum-distance
(minimaler Abstand) – der kleinste erlaubte vertikale Abstand, gemessen in Systemzwischenräumen, zwischen den Referenzpunkten der zwei Elemente, wenn Kompression stattfindet. Werte fürminimum-distance
, die geringer alspadding
sind, haben keine Bedeutung, weil der sich daraus ergebende Abstand niemals weniger alspadding
ergibt. -
padding
(Verschiebung) – der minimal benötigte vertikale blanke Freiraum zwischen den Bounding-Boxen (oder Skyline) der zwei Objekten, gemessen in Notenlinienabständen. -
stretchability
(Dehnbarkeit) – ein einheitsloses Maß der Leichtigkeit, mit der sich die Dimension dehnen lässt (ohne dass Zusammenstöße auftreten). Wenn es null ist, wird der Abstand nicht gedehnt (außer ein Zusammenstoß würde auftreten), wenn es positiv ist, hängt die Wichtigkeit der Dehnbarkeit eines bestimmten Objekts nur noch von seiner Beziehung zu dem Wert des anderen Objekts ab. Beispielsweise wennn eine Dimension die doppelte Dehnbarkeit als die andere hat, wird sie auch zweimal so einfach gedehnt. Werte sollten nicht-negativ und reale Zahlen sein. Der Wert+inf.0
ruft einenprogramming_error
hervor und wird ignoriert, aber1.0e7
kann für einen so gut wie unendlich dehnbaren Abstand eingesetzt werden. Wenn der Wert nicht gesetzt wird, ist der Standardwert der vonbasic-distance
. Die Wahrscheinlichkeit einer Dimension, sich zu verkleinern, kann man nicht direkt beeinflussen, sondern sie ergibt sich aus (space
-minimum-distance
).
Wenn eine Seite einen nicht ausgeglichenen unteren Rand hat, ist der resultierende Abstand der größte von:
-
basic-distance
, -
minimum-distance
und -
padding
plus der kleinste nötige Abstand, um Zusammenstöße zu vermeiden.
Bei Partituren über mehrere Seiten mit nicht ausgeglichenem unteren Rand greift die letzte Seite auf die gleiche Positionierung zurück wie die vorhergehende Seite, vorausgesetzt, dafür ist genügend Platz vorhanden.
Spezifische Methoden, um Alisten zu verändern, werden behandelt in Alisten verändern. Das folgende Beispiel demonstriert beide Arten, wie diese Alisten verändert werden können. Der erste Aufruf verändert nur einen Schlüsselwert einzeln, während der zweite die Variable vollständig neu definiert:
\paper { system-system-spacing.basic-distance = #8 score-system-spacing = #'((basic-distance . 12) (minimum-distance . 6) (padding . 1) (stretchability . 12)) }
Liste der flexiblen vertikalen Abstandsvariablen in \paper
Die Bezeichnungen dieser Variablen entsprechen dem Format
obere-untere-platzierung
, wobei obere
und untere
die zu platzierenden Elemente darstellen. Jeder
Abstand wird zwischen den Referenzpunkten der beiden Elemente gemessen
(siehe Beschreibung der Alistenstruktur oben). In diesen Variablenbezeichnungen
bedeutet ‚markup
‘ (Beschriftung) sowohl
Titelbeschriftungen (bookTitleMarkup
oder
scoreTitleMarkup
) als auch Beschriftungen auf höchster Ebene
(siehe Die Dateistruktur). Alle Entfernungen werden in Systemzwischenräumen
gemessen.
Standardwerte sind in ‘ly/paper-defaults-init.ly’ definiert.
-
markup-system-spacing
-
der Abstand zwischen einer (Titel-)Beschriftung (auf höchster Ebene) und der darauf folgenden Systemgruppe.
-
score-markup-spacing
-
der Abstand zwischen dem letzten System einer Partitur und der darauf folgenden (Titel-)Beschriftung (auf höchster Ebene).
-
score-system-spacing
-
der Abstand zwischen dem letzten System einer Partitur und dem ersten System der folgenden Partitur, wenn keine (Titel-)Beschriftung (auf höchster Ebene) dazwischen vorkommt.
-
system-system-spacing
-
der Abstand zwischen zwei Systemgruppen der selben Partitur.
-
markup-markup-spacing
-
der Abstand zwischen zwei (Titel-)Beschriftungen (auf höchster Ebene).
-
last-bottom-spacing
-
der Abstand vom letzten System oder Beschriftung auf höchster Ebene auf einer Seite zum unteren Rand des bedruckbaren Bereichs (also bis zum Anfang des unteren Randes).
-
top-system-spacing
-
der Abstand zwischen dem oberen Rand des bedruckbaren Bereichs (also dem Ende des oberen Rands) und dem ersten System auf der Seite, wenn keine (Titel-)Beschriftung (auf höchster Ebene) dazwischen kommt.
-
top-markup-spacing
-
der Abstand vom oberen Rand des bedruckbaren Bereichs (also dem Ende des oberen Randes) zur ersten (Titel-)Beschriftung (auf höchster Ebene) auf einer Seite, wenn keine Systemgruppe dazwischen kommt.
Siehe auch
Notationsreferenz: Flexible vertikale Abstände in Systemgruppen.
Installierte Dateien: ‘ly/paper-defaults-init.ly’.
Schnipsel: Spacing.