Die outside-staff-priority-Eigenschaft (LilyPond Handbuch zum Lernen)

#### Die `outside-staff-priority`-Eigenschaft

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

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

Layout-Objekt | Priorität | Kontrolliert Position von:
--- | --- | ---
`RehearsalMark` | `1500` | Übungszeichen
`MetronomeMark` | `1000` | Metronomzeichen
`VoltaBracketSpanner` | `600` | Volta-Wiederholungsklammern
`TextScript` | `450` | Textbeschriftung
`MultiMeasureRestText` | `450` | Text über Ganztaktpausen
`OttavaBracket` | `400` | Ottava (Oktavierungsklammern)
`TextSpanner` | `350` | Text-Strecker
`DynamicLineSpanner` | `250` | Alle Dynamik-Bezeichnungen
`BarNumber` | `100` | Taktzahlen
`TrillSpanner` | `50` | Triller-Strecker

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

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

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

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

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

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

Beachten Sie, dass einige dieser Objekte, insbesondere Taktzahlen, Metronomzeichen und Übungszeichen standardmäßig im `Score`-Kontext zu Hause sind; benutzen Sie also den richtigen Kontext, wenn sie deren Einstellungen verändern wollen.

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

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

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

>     c''2^"Text1"
>     c''2^"Text2" |
>     \once \override TextScript.outside-staff-priority = #500
>     c''2^"Text3"
>     c''2^"Text4" |

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

#### LilyPond Handbuch zum Lernen v2.26.0 (stable-branch).

- 1 Installing
  - 1.1 Graphical setup
  - 1.2 Command line setup
- 2 Tutorium
  - 2.1 Eine Quelldatei übersetzen
  - 2.2 Wie werden Eingabe-Dateien geschrieben
    - 2.2.1 Einfache Notation
      - Tonhöhen
      - Tondauern (Rhythmen)
      - Pausen
      - Taktartangabe
      - Tempobezeichnung
      - Notenschlüssel
      - Alles zusammen
    - 2.2.2 Arbeiten an Eingabe-Dateien
  - 2.3 Fehlerbehandlung
    - 2.3.1 Allgemeine Fehlerbehandlungstipps
    - 2.3.2 Einige häufige Fehler
  - 2.4 Wie die Handbücher gelesen werden sollten
    - 2.4.1 Ausgelassenes Material
    - 2.4.2 Anklickbare Beispiele
    - 2.4.3 Überblick über die Handbücher
- 3 Übliche Notation
  - 3.1 Notation auf einem System
    - 3.1.1 Taktstriche und Taktüberprüfung
      - Taktstriche
      - Taktüberprüfungen
    - 3.1.2 Tonhöhen und Tonartbezeichnungen (Vorzeichen)
      - Tonhöhenveränderungen
      - Tonartbezeichnungen (Vorzeichen)
      - Warnung bzgl. Tonartbezeichnungen und Tonhöhen
    - 3.1.3 Bindebögen und Legatobögen
      - Bindebögen
      - Legatobögen
      - Phrasierungsbögen
      - Achtung Bindebögen sind nicht Legatobögen
    - 3.1.4 Artikulationszeichen und Lautstärke
      - Artikulationszeichen
      - Fingersätze
      - Dynamik
    - 3.1.5 Text hinzufügen
    - 3.1.6 Automatische und manuelle Balken
    - 3.1.7 Zusätzliche rhythmische Befehle
      - Auftakt
      - N-tolen
      - Verzierungen
  - 3.2 Mehrere Noten auf einmal
    - 3.2.1 Musikalische Ausdrücke erklärt
      - Analogie mathematische Ausdrücke
      - Gleichzeitige musikalische Ausdrücke mehrere Notensysteme
      - Gleichzeitige musikalische Ausdrücke ein Notensystem
    - 3.2.2 Mehrere Notensysteme
    - 3.2.3 Notensysteme gruppieren
    - 3.2.4 Noten zu Akkorden verbinden
    - 3.2.5 Mehrstimmigkeit in einem System
  - 3.3 Lieder
    - 3.3.1 Einfache Lieder setzen
    - 3.3.2 Text an einer Melodie ausrichten
    - 3.3.3 Text zu mehreren Systemen
  - 3.4 Letzter Schliff
    - 3.4.1 Stücke durch Variablen organisieren
    - 3.4.2 Titel hinzufügen
    - 3.4.3 Absolute Notenbezeichnungen
    - 3.4.4 Nach dem Tutorium
- 4 Grundbegriffe
  - 4.1 Wie eine LilyPond-Eingabe-Datei funktioniert
    - 4.1.1 Einführung in die Dateistruktur von LilyPond
    - 4.1.2 Score ist ein (einziger) zusammengesetzter musikalischer Ausdruck
    - 4.1.3 Musikalische Ausdrücke ineinander verschachteln
    - 4.1.4 Über die Nicht-Schachtelung von Klammern und Bindebögen
  - 4.2 Voice enthält Noten
    - 4.2.1 Ich höre Stimmen
    - 4.2.2 Stimmen explizit beginnen
    - 4.2.3 Stimmen und Text
  - 4.3 Kontexte und Engraver
    - 4.3.1 Was sind Kontexte?
    - 4.3.2 Kontexte erstellen
    - 4.3.3 Was sind Engraver?
    - 4.3.4 Kontexteigenschaften verändern
    - 4.3.5 Engraver hinzufügen und entfernen
  - 4.4 Erweiterung der Vorlagen
    - 4.4.1 Sopran und Cello
    - 4.4.2 Vierstimmige SATB-Partitur
    - 4.4.3 Eine Partitur von Grund auf erstellen
    - 4.4.4 Tipparbeit durch Variablen und Funktionen einsparen
    - 4.4.5 Partituren und Stimmen
- 5 Die Ausgabe verbessern
  - 5.1 Grundlagen für die Optimierung
    - 5.1.1 Grundlagen zur Optimierung
    - 5.1.2 Objekte und Schnittstellen
    - 5.1.3 Regeln zur Benennung von Objekten und Eigenschaften
    - 5.1.4 Optimierungsmethoden
      - Der `\override`-Befehl
      - Der `\revert`-Befehl
      - Der `\once`-Präfix
      - Der `\tweak`-Befehl
      - Der `\single`-Präfix
  - 5.2 Die Referenz der Programminterna
    - 5.2.1 Eigenschaften von Layoutobjekten
    - 5.2.2 Eigenschaften, die Schnittstellen besitzen können
    - 5.2.3 Typen von Eigenschaften
  - 5.3 Erscheinung von Objekten
    - 5.3.1 Sichtbarkeit und Farbe von Objekten
      - Die `stencil`-Eigenschaft (Matrize)
      - The `break-visibility`-Eigenschaft (unsichtbar machen)
      - Die `transparent`-Eigenschaft (durchsichtig)
      - Die `color`-Eigenschaft (Farbe)
    - 5.3.2 Größe von Objekten
    - 5.3.3 Länge und Dicke von Objekten
  - 5.4 Positionierung von Objekten
    - 5.4.1 Automatisches Verhalten
    - 5.4.2 within-staff (Objekte innerhalb des Notensystems)
      - The `direction`-Eigenschaft (Richtung)
      - Fingersatz
    - 5.4.3 Objekte außerhalb des Notensystems
      - Die `outside-staff-priority`-Eigenschaft
      - Der `\textLengthOn`-Befehl (Textlänge berücksichtigen)
      - Positionierung von Dynamikzeichen
      - Verändern der Größe von grobs
  - 5.5 Vertikale Abstände
  - 5.6 Kollision von Objekten
    - 5.6.1 Verschieben von Objekten
    - 5.6.2 Überlappende Notation in Ordnung bringen
      - Die `padding`-Eigenschaft (auffüllen)
      - Die `right-padding`-Eigenschaft (rechts auffüllen)
      - The `staff-padding`-Eigenschaft (Systemfüllungseigenschaft)
      - Die `self-alignment-X`-Eigenschaft (Selbstausrichtung-X-Eigenschaft)
      - Die `staff-position`-Eigenschaft (Position innerhalb des Systems)
      - Die `extra-offset`-Eigenschaft (Genaues Positionieren)
      - Die `positions`-Eigenschaft (Ausrichtungseigenschaft)
      - Die `force-hshift`-Eigenschaft (horizontale Verschiebunseigenschaft)
    - 5.6.3 Beispiel aus dem Leben
  - 5.7 Weitere Optimierungen
    - 5.7.1 Andere Benutzung von Optimierungen
      - Noten zwischen unterschiedlichen Stimmen überbinden
      - Eine Fermate in MIDI simulieren
    - 5.7.2 Variablen für Layout Anpassungen einsetzen
    - 5.7.3 Formatvorlagen
    - 5.7.4 Mehr Information
    - 5.7.5 Fortgeschrittene Optimierungen mit Scheme
- Appendix A Vorlagen
  - A.1 Eingebaute Vorlagen
    - A.1.1 SATB Vorlage
    - A.1.2 SSAATTBB Vorlage
  - A.2 Vorlagen für ein einzelnes System
    - A.2.1 Nur Noten
    - A.2.2 Noten und Text
    - A.2.3 Noten und Akkordbezeichnungen
    - A.2.4 Noten, Text und Akkordbezeichnungen
  - A.3 Klaviervorlagen
    - A.3.1 Piano Solo
    - A.3.2 Klavier und Gesangsstimme
    - A.3.3 Klavier mit eingeschobenem Gesangstext
  - A.4 Vorlagen für Streichquartette
    - A.4.1 Streichquartett
    - A.4.2 Streichquartettstimmen
  - A.5 Vokalensemble
    - A.5.1 SATB-Partitur
    - A.5.2 SATB-Partitur und automatischer Klavierauszug
    - A.5.3 SATB mit daran ausgerichteten Kontexten
    - A.5.4 SATB auf vier Systemen
    - A.5.5 Sologesang und zweistimmiger Refrain
    - A.5.6 Kirchenlieder
    - A.5.7 Psalmengesang
  - A.6 Orchestervorlagen
    - A.6.1 Orchester, Chor und Klavier
  - A.7 Vorlagen für alte Notation
    - A.7.1 Transkription mensuraler Musik
    - A.7.2 Vorlage zur Transkription von Gregorianik
  - A.8 Andere Vorlagen
    - A.8.1 Jazz-Combo
- Appendix B GNU Free Documentation License
- Appendix C Register