LilyPond Benutzerhandbuch: 4.1.4 Vertikale \paper-Variablen mit flexiblen Abständen

### 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

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ächsten `StaffSymbol` – sogar wenn eine Nicht-Notensystemzeile (wie etwa ein `Lyrics`-Kontext) dazwischen kommt. Werte für `basic-distance`, die weniger als entweder `padding` oder `minimum-distance` sind, haben keine Bedeutung, weil der sich daraus ergebende Abstand niemals weniger als entweder `padding` oder `minimum-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ür `minimum-distance`, die geringer als `padding` sind, haben keine Bedeutung, weil der sich daraus ergebende Abstand niemals weniger als `padding` 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 einen `programming_error` hervor und wird ignoriert, aber `1.0e7` kann für einen so gut wie unendlich dehnbaren Abstand eingesetzt werden. Wenn der Wert nicht gesetzt wird, ist der Standardwert der von `basic-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.

#### LilyPond – Notationsreferenz v2.22.2 (stabiler Zweig).