La propietat outside-staff-priority (prioritat fora del pentagrama) (Manual d’aprenentatge del GNU LilyPond)

#### La propietat `outside-staff-priority` (prioritat fora del pentagrama)

Els objectes fora-del-pentagrama es col·loquen automàticament per evitar les col·lisions. Els objectes que tenen el valor més bais de la propietat `outside-staff-priority` se situen més a prop del pentagrama, i llavors altres objectes fora-del-pentagrama s’aixequen tant com sigui necessari per evitar la col·lisió. La prioritat `outside-staff-priority` es defineix al `grob-interface` i així és una propietat de totes els objectes de presentació. De forma predeterminada s’estableix a `#f` per a tots els objectes dins-del-pentagrama, i a un valor numèric adequat a cada objecte fora-del-pentagrama quan es crea l’objecte. La taula següent presenta els valors numèrics predeterminats per a alguns dels objectes fora-del-pentagrama més comuns.

Observeu els noms una mica inusuals d’alguns dels objectes: els objectes d’extensió es creen automàticament per controlar el posicionament vertical dels grobs que (potser) comencen i acaben en diferents moments musicals, de manera que qualsevol modificació a la prioritat `outside-staff-priority` del grob subjacent no té cap efecte. Per exemple, canviar la `outside-staff-priority` de l’objecte de regulador `Hairpin` no té efecte sobre la posició vertical dels reguladors: en comptes d’això, hem de canviar la `outside-staff-priority` de l’objecte associat `DynamicLineSpanner`. Aquesta sobreescriptura s’ha de fer al començament de l’objecte d’extensió, que podria incloure diversos reguladors o matisos dinàmics encadenats.

Objecte de presentació | Prioritat | Controla la posició de:
--- | --- | ---
`RehearsalMark` | `1500` | Lletres d’assaig
`MetronomeMark` | `1000` | Indicacions metronòmiques
`VoltaBracketSpanner` | `600` | Caixetes de primer i segona vegada
`TextScript` | `450` | Text en elements de marcatge
`MultiMeasureRestText` | `450` | Text sobre silencis de compàs complet
`OttavaBracket` | `400` | Indicadors d’octava alta i baixa
`TextSpanner` | `350` | Objectes d’extensió de text
`DynamicLineSpanner` | `250` | Totes les indicacions dinàmiques
`VoltaBracketSpanner` | `100` | Números de compàs
`TrillSpanner` | `50` | Trins mantinguts

Vet aquí un exemple que mostra la situació predeterminada d’alguns d’ells.

>     % Estableix els detalls per a un Text Spanner posterior
>     \override TextSpanner.bound-details.left.text
>         = \markup { \small \bold Slower }
>     % Col·loca la indicació dinàmica a sobre del pentagrama
>     \dynamicUp
>     % Inicia l'indicador d'octava
>     \ottava #1
>     c''4 \startTextSpan
>     % Afegeix el text de la indicació dinàmica i el símbol
>     c''4\pp\<
>     c''4
>     % Afegeix el fragment de text
>     c''4^Text |
>     c''4 c''
>     % Afegeix el text de la dinàmica i finalitza el símbol
>     c''4\ff c'' \stopTextSpan |
>     % Atura l'indicador d'octava
>     \ottava #0
>     c'4 c' c' c' |

Aquest exemple també mostra com crear textos amb extensió (Text Spanners): textos amb línies extensores per sobre d’una secció de música. L’extensor abasta des de l’ordre`\startTextSpan` fins l’ordre `\stopTextSpan`, i el format del text es defineix per mitjà de l’ordre `\override TextSpanner`. Per veure més detalls, consulteu Extensions de text.

També mostra la manera de crear indicadors d’octava alta i baixa.

Si els valors predeterminats de `outside-staff-priority` no us ofereixen les col·locacions desitjades es pot sobreescriure la prioritat de qualssevol dels objectes. Suposeu que volguéssim que l’indicador d’octava estigués situat per sota de l’element extensor de text a l’exemple de dalt. Tot el que hem de fer és localitzar la prioritat de `OttavaBracket` al RFI o en les taules anteriors, i reduir-lo a un valor inferior al de `TextSpanner`, recordant que `OttavaBracket` es crea dins del context `Staff`:

>     % Estableix els detalls per a un Text Spanner posterior
>     \override TextSpanner.bound-details.left.text
>         = \markup { \small \bold Slower }
>     % Ubica els indicadors de dinàmica a sobre del pentagrama
>     \dynamicUp
>     % Posa els següent indicador d'octava a sota dels Text Spanners
>     \once \override Staff.OttavaBracket.outside-staff-priority = #340
>     % Inicia l'indicador d'octava
>     \ottava #1
>     c''4 \startTextSpan
>     % Afegeix el text de la dinàmica
>     c''4\pp
>     % Afegeix l'extensor de la línia de dinàmica
>     c''4\<
>     % Afegeix el fragment de text
>     c''4^Text |
>     c''4 c''
>     % Afegeix el text de la dinàmica
>     c''4\ff c'' \stopTextSpan |
>     % Atura l'indicador d'octava
>     \ottava #0
>     c'4 c' c' c' |

Observeu que alguns d’aquests objectes, concretament els números de compàs, les indicacions metronòmiques i les lletres d’assaig, es fiquen de forma predeterminada dins del context `Score`; així doncs, us heu d’assegurar que utilitzeu el context adequat quan se sobreescriuen les propietats.

De forma predeterminada, les lligadures d’expressió estan classificades com objectes dins-del-pentagrama, però amb freqüència apareixen a sobre del pentagrama si les notes que uneixen són molt agudes. Això pot empènyer els objectes fora-del-pentagrama com les articulacions a una posició molt elevada, atès que la lligadura es col·locarà en primer lloc. La propietat `avoid-slur` de l’articulació es pot establir al valor `'inside` (per dins) per portar-la a l’interior de la lligadura, però la propietat `avoid-slur` és efectiva sols si la prioritat `outside-staff-priority` està també establerta al valor `#f`. De forma alternativa, la prioritat `outside-staff-priority` de la lligadura es pot fixar en un valor numèrica per fer que se situï en línia amb altres objectes fora del pentagrama d’acord amb aquest valor. Vet aquí un exemple que mostra l’efecte dels dos mètodes:

>     \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 |
>     }

Els canvis a `outside-staff-priority` també es poden usar per controlar la ubicació vertical dels objectes individuals, tot i que els resultats poden no ser sempre desitjables. Suposeu que voleu que “Text3” se situï per sobre de “Text4” a l’exemple sota l’epígraf Comportament Automàtic de més a dalt (vegeu Comportament automàtic). Tot el que estem fer és localitzar la prioritat de `TextScript` en el RFI o en les taules de dalt, i augmentar la prioritat de “Text3” fins un valor superior:

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

Això, certament, aixeca a “Text3” per sobre de “Text4”, però també l’aixeca per sobre de “Text2”, i “Text4” ara cau cap a baix. Potser no sigui tan bona idea. I si el que realment volem fer és posicionar totes les anotacions a la mateixa distància per sobre del pentagrama? Per fer-lo, ens caldrà clarament espaiar les notes en sentit horitzontal per fer lloc per al text Això es fa usant l’ordre `textLengthOn`.

#### Manual d’aprenentatge del GNU LilyPond v2.26.0 (stable-branch).

- 1 Installing
  - 1.1 Graphical setup
  - 1.2 Command line setup
- 2 Tutorial
  - 2.1 Compilació d’un fitxer
  - 2.2 Com escriure fitxers d’entrada
    - 2.2.1 Notació senzilla
      - Altures
      - Duracions (valors rítmics)
      - Silencis
      - Indicació de compàs
      - Indicacions de tempo
      - Clau
      - Tot a l’hora
    - 2.2.2 Treball sobre els fitxers d’entrada
  - 2.3 Gestió dels errors
    - 2.3.1 Consells generals de solució de problemes
    - 2.3.2 Alguns errors comuns
  - 2.4 Com llegir els manuals
    - 2.4.1 Material omès
    - 2.4.2 Exemples amb enllaç
    - 2.4.3 Panoràmica dels manuals
- 3 Notació corrent
  - 3.1 Notació en un sol pentagrama
    - 3.1.1 Línies divisòries i comprovacions de compàs
      - Línies divisòries
      - Comprovacions de compàs
    - 3.1.2 Alteracions accidentals i armadures
      - Alteracions accidentals
      - Armadures
      - Advertiment: armadures i altures
    - 3.1.3 Lligadures d’unió i d’expressió
      - Lligadures d’unió
      - Lligadures d’expressió
      - Lligadures de fraseig
      - Advertiments: lligadures d’expressió en front a lligadures d’unió
    - 3.1.4 Articulacions i matisos dinàmics
      - Articulacions
      - Indicacions de digitació
      - Matisos dinàmics
    - 3.1.5 Addició de text
    - 3.1.6 Barres automàtiques i manuals
    - 3.1.7 Instruccions rítmiques avançades
      - Compàs parcial
      - Grups especials
      - Notes d’adorn
  - 3.2 Diverses notes a l’hora
    - 3.2.1 Explicació de les expressions musicals
      - Analogia: expressions matemàtiques
      - Expressions musicals simultànies: diversos pentagrames
      - Expressions musicals simultànies: un sol pentagrama
    - 3.2.2 Diversos pentagrames
    - 3.2.3 Grups de pentagrames
    - 3.2.4 Combinar notes per formar acords
    - 3.2.5 Polifonia a un sol pentagrama
  - 3.3 Cançons
    - 3.3.1 Elaborar cançons senzilles
    - 3.3.2 Alineació de la lletra a una melodia
    - 3.3.3 Lletra en diversos pentagrames
  - 3.4 Retocs finals
    - 3.4.1 Organitzar les peces mitjançant variables
    - 3.4.2 Afegir títols
    - 3.4.3 Noms de nota absoluts
    - 3.4.4 Més enllà del tutorial
- 4 Conceptes fonamentals
  - 4.1 Com funcionen els fitxers d’entrada del LilyPond
    - 4.1.1 Introducció a l’estructura dels fitxers del LilyPond
    - 4.1.2 La partitura és una (única) expressió musical composta
    - 4.1.3 Niuat d’expressions musicals
    - 4.1.4 Quant a la impossibilitat de niuar claus i lligadures
  - 4.2 Les veus contenen música
    - 4.2.1 Sento veus
    - 4.2.2 Veus explícites
    - 4.2.3 Veus i música vocal
  - 4.3 Contextos i gravadors
    - 4.3.1 Explicació dels contextos
    - 4.3.2 Creació de contextos
    - 4.3.3 Explicació dels gravadors
    - 4.3.4 Modificar les propietats dels contextos
    - 4.3.5 Afegir i eliminar gravadors
  - 4.4 Extensió de les plantilles
    - 4.4.1 Soprano i violoncel
    - 4.4.2 Partitura vocal a quatre veus SATB
    - 4.4.3 Crear una partitura partint de zero
    - 4.4.4 Estalvi de tecleig mitjançant variables i funcions
    - 4.4.5 Partitures i particel·les
- 5 Ajustament de la sortida
  - 5.1 Elements d’ajustament
    - 5.1.1 Introducció a l’ajustament
    - 5.1.2 Objectes i interfícies
    - 5.1.3 Convencions de noms d’objectes i propietats
    - 5.1.4 Mètodes d’ajustament
      - L’ordre `\override`
      - L’ordre `\revert`
      - El prefix `\once`
      - L’ordre `\overrideProperty`
      - L’ordre `\tweak`
      - El prefix `\single`
  - 5.2 Manual de referència de funcionament intern
    - 5.2.1 Propietats dels objectes de presentació
    - 5.2.2 Propietats de les interfícies
    - 5.2.3 Tipus de propietats
  - 5.3 Aparença dels objectes
    - 5.3.1 Visibilitat i color dels objectes
      - La propietat `stencil` (segell)
      - La propietat `break-visibility` (visibilitat del salt)
      - La propietat `transparent` (transparent)
      - La propietat `color`
    - 5.3.2 Mida dels objectes
    - 5.3.3 Longitud i gruix dels objectes
  - 5.4 Col·locació dels objectes
    - 5.4.1 Comportament automàtic
    - 5.4.2 Objectes interiors al pentagrama
      - La propietat `direction` (direcció)
      - Digitacions
    - 5.4.3 Objectes fora del pentagrama
      - La propietat `outside-staff-priority` (prioritat fora del pentagrama)
      - L’ordre `\textLengthOn`
      - Posicionament dels matisos dinàmics
      - Escalat d’un «Grob»
  - 5.5 Espaiat vertical
  - 5.6 Col·lisions d’objectes
    - 5.6.1 Moviment d’objectes
    - 5.6.2 Ajustament de la notació amb superposicions
      - La propietat `padding` (farciment))
      - La propietat `right-padding` (farciment per la dreta)
      - La propietat `staff-padding` (farciment de pentagrama)
      - La propietat `self-alignment-X` (auto-alineació en X)
      - La propietat `staff-position` (posició al pentagrama)
      - La propietat `extra-offset` (desplaçament addicional)
      - La propietat `positions` (posicions)
      - La propietat `force-hshift` (forçar desplaçament horitzontal)
    - 5.6.3 Exemple real de música
  - 5.7 Ajustaments addicionals
    - 5.7.1 Altres aplicacions dels ajustaments
      - Unió de notes entre veus diferents
      - Simulació de un calderó al MIDI
    - 5.7.2 Ús de variables per als ajustaments de disposició
    - 5.7.3 Fulls d’estil
    - 5.7.4 Altres fonts d’informació
    - 5.7.5 Ajustaments avançats amb l’Scheme
- Appendix A Plantilles
  - A.1 Plantilles incorporades
    - A.1.1 Plantilla coral SATB
    - A.1.2 Plantilla coral SSAATTBB
  - A.2 Plantilles de pentagrama únic
    - A.2.1 Sols notes
    - A.2.2 Notes i lletra
    - A.2.3 Notes i acords
    - A.2.4 Notes, lletra i acords
  - A.3 Plantilles de piano
    - A.3.1 Piano sol
    - A.3.2 Piano i melodia amb lletra
    - A.3.3 Piano amb lletra centrada
  - A.4 Plantilles de quartet de corda
    - A.4.1 Quartet de corda simple
    - A.4.2 Particel·les de quartet de corda
  - A.5 Plantilles de conjunts vocals
    - A.5.1 Partitura vocal SATB
    - A.5.2 Partitura vocal SATB i reducció per a piano automàtica
    - A.5.3 SATB amb contextos alineats
    - A.5.4 SATB sobre quatre pentagrames
    - A.5.5 Estrofes a sol y tornada a dues veus
    - A.5.6 Melodies d’himnes
    - A.5.7 Salms
  - A.6 Plantilles orquestrals
    - A.6.1 Orquestra, cor i piano
  - A.7 Plantilles per a notació antiga
    - A.7.1 Transcripció dfe música mensural
    - A.7.2 Plantilla per a transcripció de cant gregorià
  - A.8 Altres plantilles
    - A.8.1 Combo de jazz
- Appendix B GNU Free Documentation License
- Appendix C Índex