Guida alla Notazione di LilyPond: 5.2 Come funziona la Guida al funzionamento interno

5.2 Come funziona la Guida al funzionamento interno

@translationof Explaining the Internals Reference

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[Inizio]

[Contenuti]

[Indice]

[ ? ]

5.2.1 Navigazione nella guida al programma

@translationof Navigating the program reference

Supponiamo di voler togliere l’indicazione di diteggiatura nel seguente frammento:

c''-2

Consultando la documentazione sulle istruzioni di diteggiatura (in Indicazioni di diteggiatura), si nota:

Vedi anche

Guida al funzionamento interno: (internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno.

Seguire il collegamento a (internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno. In cima alla pagina si vede

Fingering objects are created by: (internals)Fingering_engraver section ‘Fingering_engraver’ in Guida al Funzionamento Interno and (internals)New_fingering_engraver section ‘New_fingering_engraver’ in Guida al Funzionamento Interno.

Seguendo i collegamenti correlati nella guida del programma, possiamo seguire il flusso di informazione del programma:

(internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno: (internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno objects are created by: (internals)Fingering_engraver section ‘Fingering_engraver’ in Guida al Funzionamento Interno
(internals)Fingering_engraver section ‘Fingering_engraver’ in Guida al Funzionamento Interno: Music types accepted: (internals)fingering-event section ‘fingering-event’ in Guida al Funzionamento Interno
(internals)fingering-event section ‘fingering-event’ in Guida al Funzionamento Interno: Music event type fingering-event is in Music expressions named (internals)FingeringEvent section ‘FingeringEvent’ in Guida al Funzionamento Interno

Questo percorso va in direzione contraria al flusso dell’informazione nel programma: parte dall’output e termina nell’evento di input. Si può anche partire da un evento di input e leggere seguendo il flusso di informazione arrivando infine all’oggetto di output.

La guida al programma può anche essere sfogliata come un normale documento. Contiene capitoli su (internals)Music definitions section ‘Music definitions’ in Guida al Funzionamento Interno, su (internals)Translation section ‘Translation’ in Guida al Funzionamento Interno, e sul (internals)Backend section ‘Backend’ in Guida al Funzionamento Interno. Ogni capitolo elenca tutte le definizioni usate e tutte le proprietà che possono essere ritoccate.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[Inizio]

[Contenuti]

[Indice]

[ ? ]

5.2.2 Interfacce di formattazione

@translationof Layout interfaces

La pagina HTML che abbiamo incontrato nella sezione precedente descrive l’oggetto di formattazione chiamato (internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno. Tale oggetto è un simbolo interno alla partitura. Ha delle proprietà che contengono numeri (come gli spessori e le direzioni), ma anche collegamenti a oggetti correlati. Un oggetto di formattazione viene chiamato anche Grob, che è un diminutivo di Graphical Object (oggetto grafico). Maggiori dettagli sui Grob si trovano in (internals)grob-interface section ‘grob-interface’ in Guida al Funzionamento Interno.

La pagina relativa al grob Fingering elenca le definizioni per l’oggetto Fingering. Per esempio, la pagina dice

padding (dimension, in staff space):

0.5

che significa che il numero verrà tenuto a una distanza di almento 0.5 spazi rigo dalla testa della nota.

Ogni oggetto di formattazione può avere varie funzioni come elemento della notazione o tipografico. Per esempio, l’oggetto Fingering ha i seguenti aspetti

La sua dimensione è indipendente dalla spaziatura orizzontale, diversamente da legature di portamento o travature.
È un frammento testuale, solitamente molto breve.
Questo frammento di testo viene rappresentato con un tipo di carattere, diversamente da legature di portamento o travature.
Orizzontalmente, il centro del simbolo deve essere allineato al centro della testa della nota.
Verticalmente, il simbolo viene posto accanto alla nota e sul rigo.
La posizione verticale viene coordinata anche con altri simboli di apici o pedici.

Ognuno di questi aspetti viene registrato nelle cosiddette interfacce (interface), che sono elencate in fondo alla pagina (internals)Fingering section ‘Fingering’ in Guida al Funzionamento Interno:

This object supports the following interfaces: (internals)item-interface section ‘item-interface’ in Guida al Funzionamento Interno, (internals)self-alignment-interface section ‘self-alignment-interface’ in Guida al Funzionamento Interno, (internals)side-position-interface section ‘side-position-interface’ in Guida al Funzionamento Interno, (internals)text-interface section ‘text-interface’ in Guida al Funzionamento Interno, (internals)text-script-interface section ‘text-script-interface’ in Guida al Funzionamento Interno, (internals)font-interface section ‘font-interface’ in Guida al Funzionamento Interno, (internals)finger-interface section ‘finger-interface’ in Guida al Funzionamento Interno, and (internals)grob-interface section ‘grob-interface’ in Guida al Funzionamento Interno.

Facendo clic su uno di questo collegamenti si arriva alla pagina dell’interfaccia del rispettivo oggetto. Ogni interfaccia ha una serie di proprietà. Alcune non sono a disposizione dell’utente (‘Internal properties’), ma altre possono essere modificate.

Abbiamo parlato dell’oggetto Fingering, ma in realtà non si tratta di niente di troppo complesso. Il file di inizializzazione (vedi (learning)Altre fonti di informazione section ‘Altre fonti di informazione’ in Manuale di Apprendimento) ‘scm/define-grobs.scm’ mostra l’anima di questo “oggetto”,

(Fingering
  . ((padding . 0.5)
     (avoid-slur . around)
     (slur-padding . 0.2)
     (staff-padding . 0.5)
     (self-alignment-X . 0)
     (self-alignment-Y . 0)
     (script-priority . 100)
     (stencil . ,ly:text-interface::print)
     (direction . ,ly:script-interface::calc-direction)
     (font-encoding . fetaText)
     (font-size . -5) 		; don't overlap when next to heads.
     (meta . ((class . Item)
     (interfaces . (finger-interface
                    font-interface
                    text-script-interface
                    text-interface
                    side-position-interface
                    self-alignment-interface
                    item-interface))))))

Come si può vedere, l’oggetto Fingering non è niente più di un insieme di impostazioni di variabili e la pagina web nella Guida al funzionamento interno è generata direttamente da questa definizione.

[ < ]

[ > ]

[ << ]

[ Su ]

[ >> ]

[Inizio]

[Contenuti]

[Indice]

[ ? ]

5.2.3 Determinazione della proprietà del grob

@translationof Determining the grob property

Volevamo cambiare la posizione del 2 in

c''-2

Dato che il 2 è posizionato verticalmente vicino alla sua nota, dobbiamo fare delle prove con l’interfaccia associata a questo posizionamento, ovvero side-position-interface. La pagina relativa a questa interfaccia dice

side-position-interface

Position a victim object (this one) next to other objects (the support). The property direction signifies where to put the victim object relative to the support (left or right, up or down?)

Sotto questa descrizione, la variabile padding viene descritta come

padding

(dimension, in staff space)

Add this much extra space between objects that are next to each other.

Aumentando il valore di padding, possiamo spostare la diteggiatura lontana dalla testa di nota. Il seguente comando inserisce “tre spazi rigo” di distanza tra la nota e un segno di diteggiatura:

\once \override Voice.Fingering.padding = #3

L’inserimento di spazio prima che l’oggetto della diteggiatura venga creato produce il seguente risultato:

\once \override Voice.Fingering.padding = #3
c''-2

In questo caso, il contesto per questa modifica è Voice. Come è scritto nella pagina sull’incisore (internals)Fingering_engraver section ‘Fingering_engraver’ in Guida al Funzionamento Interno: