Guida alla Notazione di LilyPond: 4.1.1 Il blocco \paper

### 4.1.1 Il blocco `\paper`

I blocchi `\paper` possono essere posizionati in tre punti diversi, in modo da formare una gerarchia discendente di blocchi `\paper`:

- All’inizio del file di input, prima di tutti i blocchi `\book`, `\bookpart` e `\score`.
- Dentro un blocco `\book` ma fuori da tutti i blocchi `\bookpart` e `\score` in esso racchiusi.
- Dentro un blocco `\bookpart` ma fuori da tutti i blocchi `\score` in esso racchiusi.

Non è possibile inserire un blocco `\paper` in un blocco `\score`.

I valori dei campi vengono filtrati dall’alto verso il basso attraverso questa gerarchia: i valori impostati nei livelli più alti della gerarchia persistono finché non sono sovrascritti da un valore impostato in un livello più basso.

Vari blocchi `\paper` possono apparire in ognuno di questi livelli, per esempio come parti di vari file inclusi con `\include`. In questo caso, i campi di ciascun livello vengono combinati e i valori riscontrati per ultimi avranno la precedenza in caso di campi duplicati.

Le impostazioni che possono apparire in un blocco `\paper` comprendono:

- la funzione Scheme `set-paper-size`,
- le variabili `\paper` per personalizzare la formattazione della pagina e
- le definizioni di markup usate per personalizzare la formattazione di intestazioni, piè di pagina e titoli.

La funzione `set-paper-size` è trattata nella prossima sezione, Formato carta e ridimensionamento automatico. Le variabili `\paper` che si occupano della formattazione della pagina sono trattate in sezioni successive. Le definizioni di markup relative a intestazioni, piè di pagina e titoli sono trattate in Titoli intestazioni e piè di pagina personalizzati.

La maggior parte delle variabili `\paper` funzionano soltanto in un blocco `\paper`. Le poche che funzionano anche in un blocco `\layout` sono elencate in Il blocco `\layout`.

Se non indicato diversamente, tutte le variabili `\paper` che corrispondono a distanze sulla pagina sono misurate in millimetri, a meno che un’unità di misura diversa non sia specificata dall’utente. Per esempio, la seguente dichiarazione imposta `top-margin` su dieci millimetri:

>     \paper {
>       top-margin = 10
>     }

Per impostarla su `0.5` pollici, usare il suffisso di unità `\in` (inch = pollice):

>     \paper {
>       top-margin = 0.5\in
>     }

I suffissi di unità disponibili sono `\mm`, `\cm`, `\in` e `\pt`. Queste unità sono semplici valori utili per convertire dai millimetri e sono definite in ‘`ly/paper-defaults-init.ly`’. Solo per chiarezza, quando si usano i millimetri, di solito si usa il suffisso `\mm`, anche se non è tecnicamente necessario.

È anche possibile definire i valori di `\paper` con Scheme. L’equivalente Scheme dell’esempio precedente è:

>     \paper {
>       #(define top-margin (* 0.5 in))
>     }

#### Vedi anche

Guida alla notazione: Formato carta e ridimensionamento automatico, Titoli intestazioni e piè di pagina personalizzati, Il blocco `\layout`.

File installati: ‘`ly/paper-defaults-init.ly`’.

#### LilyPond — Guida alla Notazione v2.24.4 (ramo stabile).