LilyPond — Manuale di apprendimento

2.2.1 Notazione semplice

LilyPond aggiunge automaticamente alcuni elementi della notazione. Nell’esempio seguente, abbiamo specificato soltanto quattro note, ma LilyPond ha aggiunto una chiave, il tempo e le durate.

{
  c' e' g' e'
}

Questo comportamento può essere modificato, ma nella maggior parte dei casi questi valori automatici sono utili.

2.2.2 Lavorare sui file di input

I file di input di LilyPond sono simili ai file sorgenti di molti comuni linguaggi di programmazione. Contengono una dichiarazione di versione, sono sensibili alle maiuscole, e in generale gli spazi bianchi vengono ignorati. Le espressioni musicali si formano con parentesi graffe { }, e i commenti sono indicati con ‘%’ o ‘%{ … %}’.

Se le frasi precedenti ti sembrano assurde, non preoccuparti! Ora spieghiamo cosa significano tutti questi termini.

• Dichiarazione di versione: Ogni file LilyPond deve contenere una dichiarazione di versione. Una dichiarazione di versione è una linea che indica la versione di LilyPond per la quale il file è stato scritto, come nel seguente esempio:

  \version "2.25.22"
  

  Per convenzione, la dichiarazione di versione viene posta all’inizio del file LilyPond.

  La dichiarazione di versione è importante per almeno due ragioni. Primo, permette l’aggiornamento automatico del file di input via via che la sintassi di LilyPond cambia. Secondo, indica la versione di LilyPond richiesta per compilare il file.

  Se la dichiarazione di versione è omessa dal file di input, LilyPond mostra un avvertimento durante la compilazione del file.

• Sensibile alle maiuscole: distingue tra lettere in minuscolo (es: ‘a’, ‘b’, ‘s’, ‘t’) o in maiuscolo (es: ‘A’, ‘B’, ‘S’, ‘T’). Le note sono in minuscolo: ‘{ c d e }’ è un input valido; ‘{ C D E }’ produce un messaggio di errore.
• Insensibile agli spazi: non importa quanti spazi (o tabulazioni o nuove linee) aggiungi.

  { c4 d e}
  

  ha lo stesso significato di

  { c4       d e }
  

  o

  { c4                       d
                     e   }
  

  Certo, l’esempio precedente è scomodo da leggere. Una buona regola pratica è indentare i blocchi di codice con una tabulazione o due spazi:

  {
    c4 d e
  }
  

  Tuttavia, uno spazio bianco è necessario per separare molti elementi sintattici gli uni dagli altri. In altre parole, lo spazio bianco può essere aggiunto, ma non può essere eliminato. Dal momento che uno spazio bianco mancante può dare adito a strani errori, si consiglia di inserire sempre uno spazio bianco prima e dopo ogni elemento sintattico, ad esempio, prima e dopo ogni parentesi graffa.

• Espressioni: ogni parte dell’input di LilyPond deve avere { parentesi graffe } intorno. Queste parentesi dicono a LilyPond che l’input costituisce un’espressione musicale singola, proprio come le parentesi “()” in matematica. Per evitare ambiguità, le parentesi dovrebbero essere racchiuse tra spazi, a meno che non si trovino all’inizio o alla fine di una linea.

  Anche un comando di LilyPond seguito da un’espressione semplice in parentesi (come ‘\relative { … }’) conta come un’espressione musicale singola.

• Commenti: un commento è un appunto per il lettore umano dell’input musicale; viene ignorato quando l’input viene analizzato, dunque non ha alcun effetto sull’output finale. Ci sono due tipi di commenti. Il simbolo di percentuale ‘%’ introduce un commento di linea; tutto quello che sta dopo ‘%’ su quella linea verrà ignorato. Per convenzione, un commento di linea viene posto sopra il codice a cui si riferisce.

  a4 a a a
  % questo commento si riferisce alla prossima riga coi due Si (b)
  b2 b
  

  Un commento di blocco segna come commento un’intera sezione di input musicale. Tutto ciò che è compreso tra %{ e %} viene ignorato. Tuttavia, i commenti di blocco non si “annidano”. Ovvero non si può inserire un commento di blocco dentro a un altro commento di blocco. Se si prova, il primo %} interromperà entrambi i commenti di blocco. Il seguente frammento mostra gli usi possibili per i commenti.

  % ecco le note di "Ah! Vous dirai-je, Maman"
    c4 c g' g a a g2
  
  %{
    Questa linea e le note sotto vengono ignorate,
    perché si trovano in un commento di blocco.
  
    f4 f e e d d c2
  %}
  

2.3.1 Consigli generali per la risoluzione dei problemi

La risoluzione dei problemi in LilyPond può essere un compito impegnativo per le persone abituate a un’interfaccia grafica, perché può capitare di creare dei file di input non validi. Quando questo accade, un approccio logico è il modo migliore per identificare e risolvere il problema. Alcune linee guida che aiutano ad acquisire questa capacità si trovano in Risoluzione dei problemi.

2.3.2 Alcuni errori comuni

Ci sono alcuni errori comuni che sono difficili da risolvere basandosi soltanto sui messaggi di errore che compaiono. Questi sono descritti in Errori comuni.

2.4.1 Materiale omesso

L’input di LilyPond deve essere compreso dai segni { } o da ‘\relative { … }’ (see Lavorare sui file di input). Nel resto di questo manuale alcuni esempi brevi omettono questi segni. Per replicare questi esempi, puoi copiare l’input mostrato e incollarlo tra ‘{’ e ‘}’ nel tuo file di input:

{
  …inserire qui l'esempio…
}

Ricorda che i file LilyPond devono avere una dichiarazione di versione (\version). Nei manuali la dichiarazione è omessa perché gli esempi sono frammenti di codice e non file completi. Ma dovresti prendere l’abitudine di includerla nei tuoi file.

2.4.2 Esempi cliccabili

Molte persone imparano ad usare un programma provando e smanettando. Questo è possibile anche con LilyPond. Se clicchi su un’immagine nella versione HTML di questo manuale, vedrai l’esatto input LilyPond usato per generare quell’immagine. Provalo su questa immagine:

Tagliando e copiando quel che si trova nella sezione “ly snippet”, puoi ricavare un modello di partenza per sperimentare. Per vedere esattamente lo stesso output (larghezza della linea e tutto il resto), copia tutto da “Start cut-&-pastable section” alla fine del file.

2.4.3 Panoramica dei manuali

La documentazione su LilyPond è vasta. I nuovi utenti talvolta sono confusi su quali parti dovrebbero leggere, e ogni tanto saltano la lettura di parti fondamentali.

• Prima di fare qualsiasi tentativo: see Tutorial e Notazione comunemente utilizzata di questo manuale. Se ti imbatti in termini musicali che non conosci, cercali nel Glossario.
• Prima di tentare di scrivere un pezzo musicale completo: i see Concetti fondamentali di questo manuale. Dopo puoi dare un’occhiata alle sezioni rilevanti della Guida alla notazione.
• Prima di cercare di cambiare l’output predefinito: see Modifica dell’output in questo manuale.
• Prima di iniziare un grande progetto: leggi il documento Consigli su come scrivere i file del manuale di Uso del programma.

3.1.1 Stanghette e controlli di battuta

attenzione: controllo di battuta fallito a: 1/2
 g'1 | e1 | c2. c'
                   | g4 c g e | c4 r r2 |

3.1.2 Altezze e armature di chiave

3.1.3 Legature di valore e di portamento

3.1.4 Articolazioni e dinamiche

Le articolazioni e le dinamiche si indicano aggiungendo dei segni speciali dopo le note alle quali si applicano.

3.1.5 Aggiungere il testo

Puoi aggiungere del testo nei tuoi spartiti:

\relative { c''2^"espr" a_"legato" }

Per aggiungere delle formattazioni puoi usare il comando \markup:

\relative {
  c''2^\markup { \bold espr }
  a2_\markup {
    \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
}

Vedi anche

Guida alla notazione: Inserimento del testo.

3.1.6 Code automatiche e manuali

Glossario musicale: travatura.

Tutte le travature vengono disegnate automaticamente:

\relative { a'8 ais d ees r d c16 b a8 }

Se le travature automatiche non soddisfano le proprie esigenze, è possibile sovrascriverle manualmente. Per correggere soltanto una singola travatura, indicare la prima nota da raggruppare con ‘[’ e l’ultima con ‘]’. Notare che la parentesi di apertura ‘[’ segue la prima nota della travatura.

\relative { a'8[ ais] d[ ees r d] c16 b a8 }

Se desideri disattivare il raggruppamento automatico, interamente o per un’ampia sezione del brano, usa il comando \autoBeamOff per disattivare il raggruppamento automatico e \autoBeamOn per riattivarlo.

\relative {
  \autoBeamOff
  a'8 c b4 d8. c16 b4 |
  \autoBeamOn
  a8 c b4 d8. c16 b4 |
}

Vedi anche

Guida alla notazione: Travature automatiche, Travature manuali.

3.1.7 Comandi di tempo avanzati

3.2.1 Espressioni musicali

Nei file di input di LilyPond, la musica è rappresentata dalle espressioni musicali. Anche una singola nota è un’espressione musicale:

a'4

Se si racchiude della musica tra parentesi si crea un’espressione musicale composta. In questo esempio abbiamo creato un’espressione musicale composta da due note:

\relative { a'4 g4 }

Se si mette un gruppo di espressioni musicali (es: note) tra parentesi, significa che sono in sequenza (ovvero, ciascuna espressione segue la precedente). Il risultato è un’altra espressione musicale:

\relative { { a'4 g } f4 g }

1
1 + 2
(1 + 2) * 3
((1 + 2) * 3) / (4 * 5)

3.2.2 Righi multipli

I file di input di LilyPond si costruiscono in base alle espressioni musicali (see Espressioni musicali). Se la partitura inizia con espressioni musicali simultanee, LilyPond crea più di un rigo musicale. Tuttavia, è più facile vedere quel che accade se creiamo ogni rigo musicale esplicitamente.

Per ottenere più di un rigo musicale, ogni brano musicale che costituisce un rigo è contrassegnato da \new Staff. Questi elementi Staff vengono poi combinati in parallelo con << e >>:

<<
  \new Staff { \clef treble c''4 }
  \new Staff { \clef bass c4 }
>>

Il comando \new introduce un ‘contesto di notazione’. Un contesto è un ambiente in cui vengono interpretati gli eventi musicali (come le note o i comandi \clef). Nel caso di brani semplici, tali contesti vengono creati automaticamente. Per brani più complessi, è meglio contrassegnare esplicitamente i contesti.

Ci sono vari tipi di contesto. Score, Staff, e Voice gestiscono la notazione melodica, mentre Lyrics imposta i testi e ChordNames visualizza i nomi degli accordi.

In termini di sintassi, se si inserisce \new prima di un’espressione musicale, si crea un’espressione musicale più grande. In questo modo assomiglia al segno di minore in matematica. La formula (4+5) è un’espressione, quindi -(4+5) è un’espressione più grande.

Le indicazioni di tempo inserite in un rigo musicale si estendono a tutti gli altri righi. L’armatura di chiave di un rigo, invece, non si estende agli altri. Questo diverso comportamento predefinito è dovuto al fatto che le partiture con strumenti traspositori sono molto più frequenti delle partiture poliritmiche.

<<
  \new Staff { \clef treble \key d \major \time 3/4 c''4 }
  \new Staff { \clef bass c4 }
>>

3.2.3 Gruppi di pentagrammi

Glossario musicale: graffa, pentagramma o rigo, sistema.

La musica per pianoforte viene stampata su due righi musicali collegati con una graffa. Produrre un pentagramma di questo tipo è simile alla musica polifonica su righi multipli (see Righi multipli). In questo caso, però, l’intera espressione è inserita in un rigo PianoStaff:

\new PianoStaff <<
  \new Staff …
  \new Staff …
>>

Ecco un piccolo esempio:

\new PianoStaff <<
  \new Staff \relative { \time 2/4 c''4 e | g g, | }
  \new Staff \relative { \clef bass c4 c' | e c | }
>>

Altri raggruppamenti di pentagrammi vengono preceduti da \new GrandStaff, per le partiture orchestrali, e da \new ChoirStaff, per le partiture corali. Ognuno di questi gruppi di pentagramma costituiscono un altro tipo di contesto, un contesto che genera la graffa sul lato sinistro di ogni sistema e controlla inoltre l’estensione delle linee della battuta.

Vedi anche

Guida alla notazione: Tastiera e altri strumenti multirigo, Aspetto del rigo.

3.2.4 Combinare le note negli accordi

Glossario musicale: accordo.

Abbiamo visto in precedenza come le note possano essere combinate in accordi: racchiudendole tra parentesi a doppi angoli abbiamo indicato che sono simultanee. Tuttavia, il modo normale di produrre un accordo è quello di circondare le note con delle parentesi ad angolo singolo. Si noti che tutte le note in un accordo devono avere la stessa durata, e che la durata è posta dopo la parentesi chiusa.

\relative { r4 <c'' e g> <c f a>2 }

Pensa agli accordi come a qualcosa di equivalente alle note singole: quasi ogni cosa che puoi attaccare a una nota singola può essere attaccata a un accordo, e di solito tutto questo deve essere messo fuori dalle parentesi angolari. Ad esempio, con gli accordi si possono combinare simboli come le travature e le legature di valore.

\relative {
  r4 <c'' e g>~ <c f a>2 |
  <c e g>8[ <c f a> <c e g> <c f a>]
    <c e g>8\>[ <c f a> q q]\! |
  r4 <c e g>8.\p q16( q4-. <c f a>) |
}

L’esempio precedente mostra anche una funzionalità molto utile: un accordo può essere ripetuto usando il simbolo ‘q’. Funziona anche se inframezzato da note singole.

\relative { c'8 <e g>8 q q g, q q q }

Vedi anche

Guida alla notazione: Note in un accordo.

3.2.5 Polifonia su un singolo rigo

La musica polifonica in LilyPond, per quanto non difficile, fa riferimento a concetti non ancora affrontati, quindi non la presenteremo subito. Saranno le sezioni successive a introdurre le basi di questi concetti e a spiegarli via via.

Vedi anche

Manuale di Apprendimento: Le voci contengono la musica.

Guida alla notazione: Note simultanee.

3.3.1 Impostare canzoni semplici

Glossario musicale: testo.

Questo è l’inizio della melodia di una filastrocca, Girls and boys come out to play:

\relative {
  \key g \major
  \time 6/8
  d''4 b8 c4 a8 | d4 b8 g4
}

I testi possono essere collegati a queste note, combinandoli a esse per mezzo della parola chiave \addlyrics. I testi si inseriscono separando ogni sillaba con uno spazio.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4
  }
  \addlyrics {
    Girls and boys come | out to play,
  }
>>

Si notino le doppie parentesi ad angolo << … >> che circondano l’intero brano per indicare che la musica e il testo devono trovarsi in simultanea.

3.3.2 Allineare il testo alla melodia

Glossario musicale: melisma, linea di estensione.

La prossima riga della filastrocca è The moon doth shine as bright as day. Aggiungiamola:

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c b a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Osservando lo spartito, si può vedere che il testo aggiunto non risulta ben allineato alle note. La parola shine dovrebbe essere cantata su due note, non una. Questo si chiama melisma, una singola sillaba che viene cantata per più di una nota. Ci sono molti modi per estendere una sillaba su molteplici note, e il più semplice è aggiungere una legatura di portamento che le colleghi. Per maggiori informazioni, See Legature di valore e di portamento.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c( b) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Adesso le parole sono allineate correttamente con le note, ma il raggruppamento automatico per le note che si trovano sopra shine as non ha un aspetto corretto. Possiamo correggerlo inserendo i comandi per il raggruppamento manuale così da scavalcare, in questo caso, il raggruppamento automatico. Per maggiori informazioni, See Code automatiche e manuali.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c([ b]) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine as | bright as day; |
  }
>>

Come alternativa all’uso delle legature di portamento, si possono indicare i melismi nel testo stesso, usando il trattino basso ‘_’ per ogni nota che si voglia includere nel melisma.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c[ b] a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come | out to play,
    The | moon doth shine _ as | bright as day; |
  }
>>

Se una sillaba si estende per molte note o per una singola nota molto lunga, solitamente viene disegnata una linea di estensione che va dalla sillaba e si estende per tutte le note comprese in quella sillaba. Si scrive con due trattini bassi (__). È importante che i trattini bassi siano separati con uno o più spazi dalla sillaba che precede (e che segue).

Il seguente esempio è tratto dalle prime tre battute del Lamento di Didone, dall’opera Didone ed Enea di Purcell:

<<
  \relative {
    \key g \minor
    \time 3/2
    g'2 a bes | bes2( a) b2 |
    c4.( bes8 a4. g8 fis4.) g8 | fis1
  }
  \addlyrics {
    When I am | laid,
    am | laid __ in | earth,
  }
>>

Nessuno degli esempi visti finora ha comportato l’uso di parole aventi più di una sillaba. Tali parole vengono solitamente suddivise una sillaba per nota, con trattini posti tra le sillabe. Tali trattini vengono inseriti con due lineette consecutive (--), e producono un trattino centrato tra le sillabe. È importante che i trattini siano separati con uno o più spazi dalla sillaba precedente e seguente.

Ecco un esempio che, oltre a questo, mostra tutto quello che abbiamo imparato finora sull’allineamento del testo con le note.

<<
  \relative {
    \key g \major
    \time 3/4
    \partial 4
    d'4 | g4 g a8( b) | g4 g b8( c) |
    d4 d e | c2
  }
  \addlyrics {
    A -- | way in a __ | man -- ger,
    no __ | crib for a | bed, __
  }
>>

Alcuni testi, specialmente quelli in italiano, richiedono l’opposto: associare più di una sillaba a una singola nota. Questo può essere ottenuto collegando le sillabe insieme con un singolo trattino basso (‘_’, senza spazi), o includendole tra virgolette. Ecco un esempio tratto dall’opera Il barbiere di Siviglia di Rossini, dove al deve essere cantato sulla stessa nota del go di Largo, nell’aria di Figaro Largo al factotum:

<<
  \relative {
    \clef bass
    \key c \major
    \time 6/8
    c'4.~ 8 d b | c8([ d]) b c d b | c8
  }
  \addlyrics {
    Lar -- go_al fac -- | to -- tum del -- la cit -- | tà
  }
>>

Vedi anche

Guida alla notazione: Musica vocale.

3.3.3 Testo su più righi

Per porre lo stesso testo sotto più righi musicali, si può usare un approccio più semplice, ovvero \addlyrics. Ecco un esempio tratto dall’oratorio Judas Maccabæus di Handel:

<<
  \relative {
    \key f \major
    \time 6/8
    \partial 8
    c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- | dorn, __
  }
  \relative {
    \key f \major
    \time 6/8
    \partial 8
    r8 | r4. r4 c'8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- dorn,
  }
>>

Per scrivere partiture un po’ più complesse di questi semplici esempi, è meglio separare la struttura dello spartito dalle note e dai testi mediante l’uso di variabili. Per un’introduzione, See Organizzare i brani con le variabili.

Vedi anche

Guida alla notazione: Musica vocale.

3.4.1 Organizzare i brani con le variabili

Quando tutti gli elementi discussi precedentemente vengono combinati insieme per produrre file di maggiori dimensioni, anche le espressioni musicali diventano molto più grandi. Nella musica polifonica con molti righi musicali, i file di input possono diventare molto confusi. Possiamo ridurre tale confusione attraverso l’uso delle variabili.

Con le variabili (conosciute anche come identificatori o macro), possiamo scomporre le espressioni musicali complesse. Una variabile viene assegnata nel seguente modo:

namedMusic = { … }

I contenuti dell’espressione musicale namedMusic possono essere usati in seguito ponendo una barra inversa (backslash) di fronte al nome (\namedMusic), proprio come in un normale comando LilyPond.

violin = \new Staff {
  \relative {
    a'4 b c b
  }
}
cello = \new Staff {
  \relative {
    \clef bass
    e2 d
  }
}
{
  <<
    \violin
    \cello
  >>
}

Per convenzione, il nome di una variabile è composto soltanto da caratteri alfabetici. Informazioni più dettagliate in Struttura del file.

Le variabili devono essere definite prima della principale espressione musicale, ma possono poi essere usate quante volte si vuole e ovunque, una volta definite. Possono essere usate anche all’interno della definizione di un’altra variabile successiva, dando la possibilità di accorciare l’input se una sezione della musica viene ripetuta molte volte.

tripletA = \tuplet 3/2 { c,8 e g }
barA = { \tripletA \tripletA \tripletA \tripletA }

\relative c'' {
  \barA \barA
}

Le variabili possono essere utilizzate per molti tipi di oggetto nell’input. Ad esempio,

larghezza = 60        % un numero da passare a una variabile di \paper
                      % (l'unità di misura è il millimetro)
nome = "Wendy"        % una stringa da passare a un markup
foglioA5 = \paper { #(set-paper-size "a5") }

A seconda dei suoi contesti, la variabile può essere usata in punti differenti. L’esempio seguente usa le variabili mostrate sopra:

\paper {
  \foglioA5
  line-width = \larghezza
}
{
  c4^\nome
}

3.4.2 Aggiungere i titoli

Titolo, compositore, numero di opus e informazioni simili vengono inserite nel blocco \header. Questo si trova fuori dalla principale espressione musicale; il blocco \header viene solitamente posto sotto il numero di versione.

\version "2.25.22"
\header {
  title = "Symphony"
  composer = "Me"
  opus = "Op. 9"
}

{
  … music …
}

Quando il file viene elaborato, sopra la musica vengono visualizzati il titolo e il compositore. Si possono trovare maggiori informazioni sui titoli in Creazione di titoli intestazioni e piè di pagina.

3.4.3 Nomi assoluti delle note

Finora abbiamo usato \relative per definire le altezze. Questo è di solito il modo più veloce per inserire gran parte della musica. Se non viene usato \relative, le altezze vengono interpretate in modo assoluto.

In questa modalità, LilyPond tratta tutte le altezze come valori assoluti: un ‘c'’ si riferirà sempre al Do centrale, un ‘b’ si riferirà sempre alla nota che si trova un semitono sotto il Do centrale, e un ‘g,’ indicherà sempre la nota sulla linea più bassa di un rigo in chiave di basso.

{
  \clef bass
  c'4 b g, g, |
  g,4 f, f c' |
}

Scrivere una melodia in chiave di violino richiede un ampio uso di virgolette ‘'’. Si consideri questo frammento tratto da Mozart:

{
  \key a \major
  \time 6/8
  cis''8. d''16 cis''8 e''4 e''8 |
  b'8. cis''16 b'8 d''4 d''8 |
}

I segni di ottava possono essere indicati solo una volta usando il comando \fixed seguito da un’altezza di riferimento:

\fixed c'' {
  \key a \major
  \time 6/8
  cis8. d16 cis8 e4 e8 |
  b,8. cis16 b,8 d4 d8 |
}

Usando \relative, l’esempio precedente non ha bisogno di segni di ottava perché qusta melodia si muove per gradi inferiori alle tre posizioni del rigo:

\relative {
  \key a \major
  \time 6/8
  cis''8. d16 cis8 e4 e8
  b8. cis16 b8 d4 d8
}

Se si fa un errore con un segno di ottava (‘'’ o ‘,’) quando si lavora col modo \relative, è molto evidente – tante note saranno nell’ottava sbagliata. Quando si lavora in modo assoluto, un singolo errore non sarà tanto visibile, e non sarà così facile da trovare.

Tuttavia, il modo assoluto è utile per la musica che fa uso di ampi intervalli, e lo è ancora di più per i file LilyPond generati dal computer. Quando si tagliano e si incollano frammenti della melodia, il modo assoluto preserva l’ottava originale.

Talvolta la musica è organizzata in modi più complessi. Se si usa \relative all’interno di un altro \relative, ciascuna sezione \relative è indipendente:

\relative { c'4 \relative { f'' g } c }

Per usare la modalità assoluta all’interno di \relative, inserire la musica assoluta dentro \fixed c { … } e le altezze assolute non avranno effetto sulle ottave della musica inserita con la modalità relativa:

\relative {
  c'4 \fixed c { f'' g'' } c |
  c4 \fixed c'' { f g } c
}

3.4.4 Dopo il tutorial

Dopo aver finito di leggere la guida, probabilmente dovresti cercare di scrivere uno o due brani. Puoi iniziare aggiungendo delle note a uno dei modelli (see Modelli). Se necessiti di una qualche notazione che non è stata coperta nel tutorial, dai un’occhiata alla Guida alla notazione, a cominciare da Notazione musicale. Se vuoi scrivere per un gruppo di strumenti che non è incluso nei modelli, dai un’occhiata a see Estendere i modelli.

Una volta che hai scritto alcuni brevi pezzi, puoi proseguire la lettura del Manuale di Apprendimento (capitoli 3–5). Ovviamente non c’è niente di male nel leggerli subito! Però tieni conto che la parte restante del Manuale di Apprendimento parte dal presupposto che tu abbia già confidenza con l’input di LilyPond. Puoi saltare questi capitoli adesso, e tornare a leggerli quando ti sarai fatto un po’ di esperienza.

In questo tutorial e nel resto del Manuale di Apprendimento, alla fine di ogni sezione c’è un paragrafo Vedi anche, che contiene riferimenti incrociati ad altre sezioni: non dovresti seguire questi riferimenti quando leggi il manuale per la prima volta; quando avrai completato la lettura di tutto il Manuale di Apprendimento, potrai rileggere alcune sezioni e seguire i riferimenti incrociati per letture di approfondimento.

Se non lo hai già fatto, ti consigliamo di leggere Panoramica dei manuali. Contiene molte informazioni su LilyPond, ed è quindi utile per i nuovi utenti, che spesso non sanno dove cercare aiuto. Se dedichi cinque minuti all’attenta lettura di quella sezione, potresti risparmiarti ore di frustrazione sprecate a guardare in posti sbagliati!

4.1.1 Introduzione alla struttura di un file di LilyPond

Un esempio basilare di un file di input di LilyPond è

\version "2.25.22"

\header { }

\score {
   … espressione musicale composta …   % tutta la musica va qui!
  \layout { }
  \midi { }
}

Ci sono molte varianti a questo modello di base, ma questo esempio serve da utile punto di partenza.

Finora nessuno degli esempi che abbiamo visto ha usato il comando \score{}. Questo si spiega col fatto che LilyPond, quando elabora un input semplice, aggiunge automaticamente gli altri comandi necessari. LilyPond tratta un input come questo:

\relative {
  c''4 a b c
}

come forma abbreviata per questo:

\book {
  \score {
    \new Staff {
      \new Voice {
        \relative {
          c''4 a b c
        }
      }
    }
    \layout { }
  }
}

In altre parole, se l’input contiene un’espressione musicale singola, LilyPond interpreterà il file come se l’espressione musicale fosse racchiusa dentro i comandi mostrati sopra.

Attenzione! Molti esempi nella documentazione di LilyPond ometteranno i comandi \new Staff e \new Voice, lasciando che questi siano creati implicitamente. Per gli esempi semplici questo metodo funziona bene, ma per quelli più complessi, soprattutto quando vengono usati ulteriori comandi, la creazione implicita dei contesti può dare risultati inattesi, ad esempio creando dei righi non voluti. Il modo per creare i contesti esplicitamente è spiegato in Contesti e incisori.

Ora però torniamo al primo esempio ed esaminiamo il comando \score, lasciando gli altri comandi secondo l’impostazione predefinita.

Un blocco \score deve sempre contenere una sola espressione musicale. Ricorda che un’espressione musicale può essere qualsiasi cosa, da una singola nota a una grande espressione composta come

{
  \new StaffGroup <<
     … inserisci qui l'intera opera di Wagner … 
  >>
}

Tutto quanto è compreso in { … } costituisce un’unica espressione musicale.

Come abbiamo detto prima, il blocco \score può contenere altri elementi, come ad esempio

\score {
  { c'4 a b c' }
  \header { }
  \layout { }
  \midi { }
}

Si noti che questi tre comandi – \header, \layout e \midi – sono speciali: diversamente da molti altri comandi che iniziano con un backslash (\), non sono espressioni musicali né fanno parte di alcuna espressione musicale. Dunque, possono essere collocati dentro o fuori da un blocco \score. Di solito questi comandi vengono posti fuori dal blocco \score – ad esempio, \header spesso viene messo sopra il comando \score, come mostra l’esempio all’inizio di questa sezione.

Altri due comandi che non hai incontrato finora sono \layout { } e \midi {}. Se questi appaiono come in figura, LilyPond creerà rispettivamente un output per la stampa e uno per il MIDI. Sono descritti dettagliatamente nella Guida alla notazione, in Formattazione della partitura, e Creazione dell’output MIDI.

Puoi scrivere molteplici blocchi \score. Ciascuno verrà trattato come una partitura separata, ma saranno tutti combinati in un unico file di output. Non è necessario il comando \book – ne verrà creato uno automaticamente. Tuttavia, se si desiderano file di output separati da un file .ly, allora si deve usare il comando \book per separare le diverse sezioni: ogni blocco \book produrrà un file di output separato.

In breve:

Ogni blocco \book crea un file di output separato (ovvero, un file PDF). Se non ne hai aggiunto uno esplicitamente, LilyPond racchiude implicitamente tutto il tuo codice di input in un blocco \book.

Ogni blocco \score è un pezzo di musica separato all’interno di un blocco \book.

Ogni blocco \layout influenza il blocco \score o \book in cui compare – ovvero, un blocco \layout che si trova dentro un blocco \score riguarda solo quel blocco \score, mentre un blocco \layout che si trova fuori da un blocco \score (e quindi in un blocco \book, esplicitamente o implicitamente) riguarderà ogni \score in quel \book.

Per maggiori dettagli si veda Molteplici partiture in un libro.

Un’altra grande scorciatoia è la possibilità di definire variabili, come è spiegato in Organizzare i brani con le variabili). Tutti i modelli usano questa forma

melodia = \relative {
  c'4 a b c
}

\score {
  \melodia
}

Quando LilyPond esamina questo file, prende il valore di melodia (tutto ciò che si trova dopo il segno di uguale) e lo inserisce ovunque si trovi \melodia. Non c’è una regola specifica per i nomi – il nome può essere melodia, globale, tempo, manodestrapiano, o qualsiasi altro nome. Ricordati che puoi usare quasi ogni nome che vuoi, purché esso contenga solo caratteri alfabetici e sia diverso dai nomi dei comandi di LilyPond. Le esatte limitazioni relative ai nomi delle variabili sono spiegate dettagliatamente in Struttura del file.

Vedi anche

Per una definizione completa del formato di input, si veda Struttura del file.

4.1.2 La partitura è una (singola) espressione musicale composta

Abbiamo visto l’organizzazione generale dei file di input di LilyPond nella sezione precedente, Introduzione alla struttura di un file di LilyPond. Ma sembra che abbiamo saltato la parte più importante: cosa dobbiamo scrivere dopo \score?

In realtà non l’abbiamo affatto dimenticato. Il grande mistero è, semplicemente, che non c’è alcun mistero. La seguente frase spiega tutto:

Un blocco \score deve contenere una sola espressione musicale.

Per capire cosa si intende per espressione musicale, potrebbe esserti utile ripassare il tutorial, Espressioni musicali. In quella sezione, abbiamo visto come costruire grandi espressioni musicali a partire da piccoli brani – abbiamo iniziato con le note, poi gli accordi, etc. Adesso inizieremo da una grande espressione musicale e proseguiremo poi a spiegarne i dettagli. Per semplicità, nel nostro esempio useremo soltanto un canto e un pianoforte. Per questa formazione non abbiamo bisogno di StaffGroup, che non fa altro che raggruppare un insieme di righi con una parentesi graffa a sinistra, ma abbiamo comunque bisogno dei righi per il canto e per il pianoforte.

\score {
  <<
    \new Staff = "canto" <<
    >>
    \new PianoStaff = "pianoforte" <<
    >>
  >>
  \layout { }
}

In questo esempio abbiamo dato dei nomi ai righi – “canto” e “pianoforte”. Non è necessario in questo caso, ma è una buona abitudine da coltivare, perché ti permette di vedere a colpo d’occhio a cosa serve ciascun rigo.

Ricorda che si usa << … >> invece di { … } per indicare la musica simultanea. In questo modo la parte vocale e quella di pianoforte appaiono una sopra l’altra nello spartito. Il costrutto << … >> non sarebbe necessario per il rigo del cantante nell’esempio precedente se contenesse soltanto un’espressione musicale sequenziale, ma << … >> al posto delle parentesi è necessario se la musica sul rigo deve contenere due o più espressioni simultanee, ad esempio due voci simultanee, o una voce con del testo. Vogliamo avere una voce con del testo, dunque ci servono le parentesi ad angolo. Aggiungeremo la musica vera e propria in seguito; per adesso mettiamo soltanto delle semplici note e del testo. Se hai dimenticato come aggiungere del testo, potresti voler ripassare \addlyrics in Impostare canzoni semplici.

\score {
  <<
    \new Staff = "canto" <<
      \new Voice = "vocal" { c'1 }
      \addlyrics { And }
    >>
    \new PianoStaff = "piano" <<
      \new Staff = "upper" { c'1 }
      \new Staff = "lower" { c'1 }
    >>
  >>
  \layout { }
}

Ora abbiamo molti più dettagli. Abbiamo il rigo del cantante: esso contiene una Voice o voce (in LilyPond, questo termine si riferisce a un insieme di note, non necessariamente alle note della voce – ad esempio, un violino di solito costituisce una voce) e del testo. Abbiamo anche il rigo del pianoforte, che a sua volta comprende un rigo superiore (per la mano destra) e uno inferiore (per la mano sinistra), sebbene a quest’ultimo debba ancora essere assegnata una chiave di basso.

A questo punto possiamo iniziare ad inserire le note. All’interno delle parentesi graffe vicine a \new Voice = "vocal", possiamo iniziare a scrivere

\relative {
  r4 d''8\noBeam g, c4 r
}

Ma se facessimo così, la sezione \score diventerebbe molto lunga, e sarebbe più difficile comprendere quel che accade. Usiamo quindi le variabili piuttosto. Queste sono state introdotte alla fine della sezione precedente, ricordi? Per far sì che i contenuti della variabile text siano interpretati come testo, li facciamo precedere da \lyricmode. Come in \addlyrics, questo comando trasforma la modalità di input in modalità testo. Senza di esso, LilyPond cercherebbe di interpretare i contenuti come se fossero note, e questo produrrebbe degli errori. (Sono disponibili molte altre modalità di input, si veda Modalità di inserimento.)

Dunque se aggiungiamo un po’ di note e una chiave di basso per la mano sinistra, otteniamo un brano musicale vero e proprio:

melody = \relative { r4 d''8\noBeam g, c4 r }
text   = \lyricmode { And God said, }
upper  = \relative { <g' d g,>2~ <g d g,> }
lower  = \relative { b,2 e }

\score {
  <<
    \new Staff = "canto" <<
      \new Voice = "vocal" { \melody }
      \addlyrics { \text }
    >>
    \new PianoStaff = "piano" <<
      \new Staff = "upper" { \upper }
      \new Staff = "lower" {
        \clef "bass"
        \lower
      }
    >>
  >>
  \layout { }
}

Quando scrivi (o leggi) una sezione \score, prenditela comoda e stai attento. Comincia dal livello più esterno, poi lavora su ogni livello più piccolo. È anche molto utile essere rigorosi nell’indentare l’input – ovvero fare attenzione che ogni elemento di uno stesso livello presente nell’editor di testo si trovi nella stessa posizione orizzontale.

Vedi anche

Guida alla notazione: Struttura di una partitura.

4.1.3 Annidare le espressioni musicali

Non è obbligatorio dichiarare tutti i righi fin dall’inizio; possono essere invece introdotti temporaneamente in ogni momento. Questo è utile in particolare per creare le sezioni ossia – si veda ossia. Ecco un semplice esempio che mostra come inserire un nuovo rigo temporaneamente, per la durata di tre note:

\new Staff {
  \relative {
    r4 g'8 g c4 c8 d |
    e4 r8
    <<
      { f8 c c }
      \new Staff {
        f8 f c
      }
    >>
    r4 |
  }
}

Si noti che la dimensione della chiave è la stessa di una chiave che segue un cambio di chiave –ovvero leggermente più piccola della chiave all’inizio del rigo. Questo è utile per le chiavi che devono essere posizionate a metà di un rigo.

La sezione ossia può anche essere posta sopra il rigo nel seguente modo:

\new Staff = "main" {
  \relative {
    r4 g'8 g c4 c8 d |
    e4 r8
    <<
      { f8 c c }
      \new Staff \with {
        alignAboveContext = "main"
      } { f8 f c }
    >>
    r4 |
  }
}

Questo esempio usa \with, che verrà spiegato in modo più completo in seguito. È un modo per cambiare il comportamento predefinito di un singolo rigo. In questo caso, indica che il nuovo rigo deve essere posizionato sopra il rigo chiamato “main” invece che nella posizione predefinita, che è in basso.

Vedi anche

Gli ossia vengono spesso scritti senza armatura di chiave e senza tempo, e solitamente hanno un font più piccolo. Richiedono ulteriori comandi che non sono stati ancora presentati. Si veda Dimensione degli oggetti, e Righi ossia.

4.1.4 Struttura dell’inserimento note

L’inserimento di una nota in LilyPond consiste in un’altezza, seguita da una durata, seguita facoltativamente da uno o più ‘post-eventi’. I post-eventi di LilyPond aggiungono elementi quali le articolazioni, le diteggiature, i numeri di corda, le legature di portamento e di valore e il testo esplicativo.

L’altezza può essere definita esplicitamente usando il linguaggio di input corrente di LilyPond, come è descritto in Nomi delle note in altre lingue. L’altezza può essere omessa. Quando viene omessa, l’altezza di una nota corrente sarà identica all’altezza della nota precedente nel file di input, vedi Durata. Attenzione, né r né s sono un’altezza.

La durata è composta da un numero e eventualmente da uno o più punti. Se una durata non è definita esplicitamente, la durata di una nota corrente sarà identica alla durata della nota, accordo, pausa o pausa spaziatrice precedenti, vedi Durata.

I post-eventi seguono la nota alla quale sono collegati. Supponiamo di voler scrivere un Do di un ottavo con diteggiatura 1, articolazione tenuto, una legatura di portamento e una legatura di valore che iniziano con la nota e un’annotazione testuale. Ciò si può ottenere nel modo seguente:

{ c'8-1--(~^\markup{"text annotation"} c' d') }

Vedi anche

Manuale di apprendimento: Legature di valore e di portamento, Articolazioni e dinamiche, Aggiungere il testo.

Guida alla notazione: Altezze, Ritmi, Segni di espressione.

4.1.5 Sul non annidamento di parentesi e legature di valore

Abbiamo già incontrato vari tipi di parentesi e di costrutti che fanno uso di parentesi mentre scrivevamo il file di input di LilyPond. Ognuna obbedisce a diverse regole, e questo può generare confusione all’inizio. Rivediamo prima i diversi tipi di parentesi e di costrutti in parentesi.

A questi dovremmo aggiungere altri costrutti che generano linee tra e lungo le note: legature di valore (contrassegnate dal tilde, ~), i gruppi irregolari scritti in questa forma \tuplet x/y { … }, e gli abbellimenti, indicati con \grace{ … }.

Fuori da LilyPond, l’uso convenzionale delle parentesi esige che i diversi tipi siano annidati adeguatamente, in questo modo, << [ { ( … ) } ] >>, dove le parentesi che chiudono si trovano esattamente nell’ordine opposto alle parentesi che aprono. Questo è un requisito per i tre tipi di parentesi descritti dal termine ‘Racchiude’ nella tabella precedente – devono annidarsi correttamente. Tuttavia, i restanti costrutti in parentesi, descritti dal termine ‘Contrassegna’ nella tabella, così come le legature e i gruppi irregolari, non devono annidarsi correttamente con alcuna delle parentesi o dei costrutti in parentesi. Infatti queste non sono parentesi nel senso che racchiudono qualcosa – sono semplicemente dei contrassegni che indicano dove qualcosa inizia e finisce.

Quindi, ad esempio, una legatura di frase può iniziare prima di una travatura inserita manualmente e finire prima della fine della travatura – non molto musicale, forse, ma possibile:

\relative { g'8\( a b[ c b\) a] g4 }

In generale, tipi diversi di parentesi, costrutti in parentesi e segni che riguardano gruppi irregolari, legature e abbellimenti possono essere combinati liberamente. L’esempio seguente mostra una travatura che si estende su un gruppo irregolare (linea 1), una legatura di portamento che si estende su una terzina (linea 2), una travatura e una legatura di portamento che si estendono su una terzina, una legatura di valore che attraversa due gruppi irregolari, e una legatura di frase che si estende fuori da un gruppo irregolare (linee 3 e 4).

\relative {
  r16[ g' \tuplet 3/2 { r16 e'8] }
  g,16( a \tuplet 3/2 { b16 d) e }
  g,8[( a \tuplet 3/2 { b8 d) e~] } |
  \tuplet 5/4 { e32\( a, b d e } a4.\)
}

4.2.1 Sento le Voci

I livelli più profondi, più interni e più importanti di uno spartito di LilyPond sono chiamati ‘Voice contexts’ («Contesti della voce») o semplicemente ‘Voices’ («Voci»). In altri programmi di notazione le voci sono chiamate talvolta ‘layers’ («livelli»).

Il livello o contesto della voce è l’unico che può contenere la musica. Se un contesto della voce non è dichiarato esplicitamente, ne viene creato uno automaticamente, come abbiamo visto all’inizio di questo capitolo. Alcuni strumenti, come ad esempio un oboe, possono produrre una sola nota per volta. La musica scritta per tali strumenti necessita di una sola voce. Invece gli strumenti che possono produrre più di una nota contemporaneamente, come ad esempio il pianoforte, richiederanno spesso voci multiple per codificare le diverse note e ritmi simultanei che sono capaci di riprodurre.

Ovviamente, una singola voce può contenere molte note in un accordo, dunque quando l’uso delle voci multiple è davvero necessario? Si osservi questo esempio di quattro accordi:

\relative {
  \key g \major
  <d' g>4 <d fis> <d a'> <d g>
}

Questa musica può essere espressa usando soltanto i simboli dell’accordo, ovvero le parentesi angolari, < … >, e una singola voce è sufficiente. Ma cosa accadrebbe se il Fa# fosse in realtà una nota di un ottavo seguita da un Sol di un ottavo, una nota di passaggio che porta al La? In questo caso abbiamo due note che iniziano nello stesso momento ma hanno durate diverse: il Re da un quarto e il Fa# da un ottavo. Come si possono scrivere queste note? Non possono essere scritte come un accordo perché tutte le note di un accordo devono avere la stessa durata. E non possono nemmeno essere scritte come due note in sequenza perché devono iniziare in contemporanea. Si tratta quindi di un caso in cui sono necessarie due voci.

Vediamo come ottenerle nella sintassi di input di LilyPond.

Il modo più semplice per inserire frammenti che utilizzino più di una voce su un rigo è scrivere ogni voce come una sequenza (con { … }), e poi combinarle in simultanea tramite le doppie parentesi angolari, << … >>. Per collocarli in voci distinte, i frammenti devono essere separati da un doppio backslash, \\. Senza di esso, le note sarebbero inserite in un’unica voce, e questo normalmente causerebbe degli errori. Questa tecnica è particolarmente adatta ai brani che sono in gran parte omofonici ma con brevi e occasionali sezioni polifoniche.

Ecco come suddividere gli accordi precedenti in due voci e aggiungere sia la nota di passaggio che la legatura di portamento:

\relative {
  \key g \major
  %    Voce = "1"               Voce = "2"
  << { g'4 fis8( g) a4 g } \\ { d4 d d d }  >>
}

Si noti come i gambi della seconda voce adesso siano rivolti in basso.

Ecco un altro semplice esempio:

\relative {
  \key d \minor
  %    Voce = "1"            Voce = "2"
  << { r4 g' g4. a8 }   \\ { d,2 d4 g }       >> |
  << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
  << { a2. r4 }         \\ { fis2. s4 }       >> |
}

Non è necessario usare un costrutto con << \\ >> in ogni battuta. Per musiche che hanno poche note in ogni battuta questo layout può aiutare la leggibilità del codice, ma se ci sono molte note in ogni battuta è preferibile dividere ogni voce, così:

<<
  \key d \minor
  % Voce = "1"
  \relative {
    r4 g' g4. a8 |
    bes4 bes c bes |
    a2. r4 |
  } \\
  % Voce = "2"
  \relative {
    d'2 d4 g |
    g4 g g8( a) g4 |
    fis2. s4 |
  }
>>

Questo esempio ha solo due voci, ma si potrebbe usare lo stesso costrutto per scrivere tre o più voci aggiungendo più backslash.

I contesti della voce hanno i nomi "1", "2", etc. I primi contesti impostano le voci più esterne, la voce più alta nel contesto "1" e la più bassa nel "2". Le voci più interne vanno nei contesti "3" e "4". In ogni contesto, la direzione verticale di legature di portamento, gambi, legature di valore, dinamica, etc., è impostata correttamente.

\new Staff \relative {
  % Voce principale
  c'16 d e f
  %    Voce = "1"    Voce = "2"              Voce = "3"
  << { g4 f e } \\ { r8 e4 d c8~ } >> |
  << { d2 e }   \\ { c8 b16 a b8 g~ 2 } \\ { s4 b c2 } >> |
}

Se preferisci inserire le voci in un ordine diverso, per esempio dall’alto verso il basso, puoi specificare i rispettivi numeri di voce prima di un costrutto << … >> tramite il comando \voices:

\new Staff \relative {
  % Voce principale
  c'16 d e f
  %    Voce = "1"    Voce = "2"
  << { g4 f e } \\ { r8 e4 d c8~ } >> |
  \voices 1,3,2
  %    Voce = "1"    Voce = "3"     Voce = "2"
  << { d2 e }   \\ { s4 b c2 } \\ { c8 b16 a b8 g~ 2 } >> |
}

Tutte queste voci sono separate dalla voce principale che contiene le note e che si trova fuori dal costrutto << … >>, che chiameremo il costrutto simultaneo. Legature di portamento e di valore possono connettere solo note che fanno parte della stessa voce, quindi le legature non possono entrare in un costrutto simultaneo o uscirne. Viceversa, voci parallele appartenenti a costrutti simultanei distinti sullo stesso rigo sono la stessa voce. Anche altre caratteristiche della voce di riferimento sono trasferite ai costrutti simultanei. Ecco lo stesso esempio, ma con colori e teste delle note diversi per ogni voce. Si noti che i cambiamenti in una voce non interessano le altre voci, ma persistono sulla stessa voce in seguito. Si noti anche che le note legate possono essere divise sulle stesse voci in due costrutti, come mostra qui la voce con i triangoli blu.

\new Staff \relative {
  % Voce principale
  c'16 d e f
  <<  % Battuta 1
    {
      \voiceOneStyle
      g4 f e
    }
  \\
    {
      \voiceTwoStyle
      r8 e4 d c8~
    }
  >> |
  <<  % Battuta 2
     % Voce 1 continua
    { d2 e }
  \\
     % Voce 2 continua
    { c8 b16 a b8 g~ 2 }
  \\
    {
      \voiceThreeStyle
      s4 b c2
    }
  >> |
}