]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/it/learning/tweaks.itely
Doc-it: update
[lilypond.git] / Documentation / it / learning / tweaks.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
2
3 @ignore
4     Translation of GIT committish: ff7d82711b47d3d31f26e1e6fc012c4055a20059
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  For details, see the Contributors'
8     Guide, node Updating translation committishes..
9 @end ignore
10
11 @c \version "2.17.20"
12
13 @node Modifica dell'output
14 @chapter Modifica dell'output
15 @translationof Tweaking output
16
17 Questo capitolo spiega come modificare l'output.  LilyPond è estremamente
18 configurabile; praticamente si può modificare qualsiasi elemento dell'output.
19
20
21 @menu
22 * Modifiche di base::
23 * Manuale del Funzionamento interno::
24 * Aspetto degli oggetti::
25 * Posizionamento degli oggetti::
26 * Spaziatura verticale::
27 * Collisioni tra oggetti::
28 * Altre modifiche::
29 @end menu
30
31 @node Modifiche di base
32 @section Modifiche di base
33 @translationof Tweaking basics
34
35 @menu
36 * Introduzione alle modifiche::
37 * Oggetti e interfacce::
38 * Convenzioni per i nomi di oggetti e proprietà::
39 * Metodi di modifica::
40 @end menu
41
42 @node Introduzione alle modifiche
43 @subsection Introduzione alle modifiche
44 @translationof Introduction to tweaks
45
46 Nella terminologia di LilyPond un @emph{tweak} (modifica, ritocco) si
47 riferisce ai vari metodi che l'utente ha a disposizione per modificare
48 le azioni intraprese durante l'interpretazione del file di input e per
49 cambiare l'aspetto dell'output.  Alcune modifiche sono molto semplici, altre
50 sono più complesse.  Ma nel loro insieme i metodi disponibili permettono
51 di modificare quasi qualsiasi aspetto della partitura come si desidera.
52
53 In questa sezione vengono trattati i concetti di base necessari per
54 comprendere le modifiche.  Più avanti presenteremo vari comandi già
55 pronti che possono essere semplicemente copiati per ottenere lo stesso
56 effetto nelle proprie partiture; allo stesso tempo mostreremo come
57 costruire questi comandi così da rendere possibile imparare a scrivere
58 le proprie modifiche personali.
59
60 Prima di iniziare questo capitolo si consiglia di rileggere la sezione
61 @ref{Contexts and engravers}, perché i contesti, gli incisori e le proprietà
62 contenute al loro interno sono fondamentali per comprendere e
63 costruire le modifiche.
64
65 @node Oggetti e interfacce
66 @subsection Oggetti e interfacce
67 @translationof Objects and interfaces
68
69 @cindex oggetto
70 @cindex oggetto grafico (grob)
71 @cindex estensore (spanner)
72 @cindex interfaccia
73 @cindex oggetto, proprietà dell'
74 @cindex proprietà dell'oggetto
75 @cindex oggetto di formattazione
76 @cindex formattazione, oggetto di
77
78 I @emph{tweak} implicano la modifica delle operazioni e delle strutture
79 interne del programma LilyPond, dunque per prima cosa bisogna
80 introdurre alcuni termini usati per descriverle.
81
82 Il termine @q{Oggetto} è un termine generico che si riferisce all'insieme
83 di strutture interne create da LilyPond durante l'elaborazione
84 di un file di input.  Quando incontra un comando come @code{\new
85 Staff}, LilyPond crea un nuovo oggetto di tipo @code{Staff} (un rigo).  Questo
86 oggetto @code{Staff} possiede tutte le proprietà associate a
87 quel rigo, come ad esempio il suo nome e la sua armatura di chiave,
88 insieme ai dettagli relativi agli incisori assegnati per operare all'interno
89 del contesto di quel rigo.  Analogalmente, ci sono oggetti che hanno
90 le proprietà di tutti gli altri contesti, come  gli oggetti @code{Voice},
91 gli oggetti @code{Score}, gli oggetti @code{Lyrics} e gli oggetti che
92 rappresentano tutti gli elementi della notazione, come le stanghette,
93 le teste di nota, le legature di valore, le dinamiche, etc.  A ogni
94 oggetto corrisponde un relativo insieme di valori di proprietà.
95
96 Alcuni tipi di oggetto hanno dei nomi speciali.  Gli oggetti che rappresentano
97 elementi della notazione visibili nell'output come le teste di nota, i gambi,
98 le legature di portamento e di valore, le diteggiature, le chiavi, etc. sono
99 chiamati «Oggetti di formattazione» (in inglese @emph{Layout Objects}).  Sono
100 chiamati anche «Oggetti grafici» (in inglese @emph{Graphical Objects} o
101 @emph{Grob} per brevità).  Si tratta sempre di oggetti nel senso generico
102 descritto prima e quindi hanno tutti delle proprietà a loro associate, come la
103 posizione, la dimensione, il colore, etc.
104
105 Alcuni oggetti di formattazione sono ancora più specializzati.  Le legature
106 di frase, le forcelle del crescendo, i segni di ottava e molti altri @q{grob}
107 non sono localizzati in un punto preciso -- hanno invece un punto iniziale,
108 un punto finale e talvolta altre proprietà relative alla loro forma.  Gli
109 oggetti che hanno una forma estesa in questo modo vengono chiamati «Estensori»
110 (in inglese @emph{Spanner}).
111
112 Resta da spiegare cosa sono le «Interfacce».  Molti oggetti, pur essendo
113 piuttosto diversi, condividono delle caratteristiche comuni che devono
114 essere elaborate nello stesso modo.  Ad esempio, tutti i @emph{grob} hanno un
115 colore, una dimensione, una posizione, etc.; tutte queste proprietà vengono
116 elaborate nello stesso modo durante l'interpretazione del file di input.  Per
117 semplificare queste operazioni interne, le azioni e proprietà comuni
118 sono riunite in un oggetto chiamato @code{grob-interface}.
119 Esistono molti altri raggruppamenti di proprietà comuni come queste, ognuno
120 con un nome che finisce con @code{interface}.  In totale ci sono più di
121 100 interfacce.  Vedremo in seguito perché questo sia di interesse
122 e di utilità per l'utente.
123
124 Questi sono dunque i termini principali riguardanti gli oggetti che useremo
125 in questo capitolo.
126
127 @node Convenzioni per i nomi di oggetti e proprietà
128 @subsection Convenzioni per i nomi di oggetti e proprietà
129 @translationof Naming conventions of objects and properties
130
131 @cindex convenzioni per i nomi di oggetti
132 @cindex convenzioni per i nomi di proprietà
133 @cindex oggetti, convenzioni per i nomi di
134 @cindex proprietà, convenzioni per i nomi di
135
136 Abbiamo già visto, in @ref{Contexts and engravers}, le convenzioni per i
137 nomi di oggetti.  Ecco una lista dei più comuni tipi di oggetti e
138 proprietà insieme alle convenzioni usate per nominarli e alcuni
139 esempi di nomi reali.  Abbiamo usato @q{A} per indicare un
140 qualsiasi carattere alfabetico maiuscolo e @q{aaa} per indicare un qualsiasi
141 numero di caratteri alfabetici minuscoli.  Gli altri caratteri sono indicati
142 normalmente.
143
144 @multitable @columnfractions .33 .33 .33
145 @headitem Tipo di oggetto/proprietà
146   @tab Convenzione per il nome
147   @tab Esempi
148 @item Contesti
149   @tab Aaaa o AaaaAaaaAaaa
150   @tab Staff, GrandStaff
151 @item Oggetti di formattazione
152   @tab Aaaa o AaaaAaaaAaaa
153   @tab Slur, NoteHead
154 @item Incisori
155   @tab Aaaa_aaa_engraver
156   @tab Clef_engraver, Note_heads_engraver
157 @item Interfacce
158   @tab aaa-aaa-interface
159   @tab grob-interface, break-aligned-interface
160 @item Proprietà del contesto
161   @tab aaa o aaaAaaaAaaa
162   @tab alignAboveContext, skipBars
163 @item Proprietà degli oggetti di formattazione
164   @tab aaa o aaa-aaa-aaa
165   @tab direction, beam-thickness
166 @end multitable
167
168 Come vedremo tra poco, ogni tipo di oggetto richiede un comando diverso
169 per modificare le sue proprietà, dunque è utile poter riconoscere i tipi
170 di oggetti e proprietà dai loro nomi.
171
172
173 @node Metodi di modifica
174 @subsection Metodi di modifica
175 @translationof Tweaking methods
176
177 @cindex metodi di modifica
178 @cindex modifica, metodi
179
180 @menu
181 * Il comando override::
182 * Il comando revert::
183 * Il prefisso once::
184 * Il comando overrideProperty::
185 * Il comando tweak::
186 @end menu
187
188 @node Il comando override
189 @unnumberedsubsubsec Il comando @code{@bs{}override}
190 @translationof The override command
191
192 @cindex override, comando
193 @cindex override, sintassi
194
195 @funindex \override
196 @funindex override
197
198 Abbiamo già incontrato i comandi @code{\set} e @code{\with}, che servono
199 a modificare le proprietà dei @strong{contesti} e a togliere o aggiungere
200 gli @strong{incisori}, nei paragrafi @ref{Modifying context properties} e
201 @ref{Adding and removing engravers}.  Ora dobbiamo introdurre alcuni
202 comandi più importanti.
203
204 Il comando che cambia le proprietà degli @strong{oggetti di formattazione} è
205 @code{\override}.  Dato che questo comando ha il compito di modificare
206 le caratteristiche interne fondamentali di LilyPond, la sua sintassi non è
207 semplice come quella dei comandi presentati finora.  Deve sapere esattamente
208 quale proprietà di quale oggetto in quale contesto deve essere
209 modificata e quale deve essere il suo nuovo valore.  Vediamo come
210 funziona.
211
212 La sintassi generale di questo comando è:
213
214 @example
215 \override @var{Contesto}.@var{OggettoDiFormattazione}.@var{proprietà-formattazione} = #@var{valore}
216 @end example
217
218 @noindent
219 Questo comando assegnerà alla proprietà chiamata @var{proprietà-formattazione}
220 dell'oggetto di formattazione chiamato @var{OggettoDiFormattazione}, che fa
221 parte del contesto @var{Contesto}, il valore @var{valore}.
222
223 Il @var{Contesto} può essere ommesso (e di solito lo è) quando il
224 contesto richiesto è implicito e si trova a uno dei livelli più
225 bassi dei contesti, come ad esempio @code{Voice}, @code{ChordNames} o
226 @code{Lyrics}.  Lo ometteremo in molti degli esempi seguenti; vedremo
227 poi quando deve essere specificato.
228
229 Le sezioni successive tratteranno in modo dettagliato le proprietà e
230 i loro valori, si veda @ref{Types of properties}; in questa sezione, invece,
231 useremo soltanto alcune proprietà e valori di facile comprensione,
232 in modo da spiegare il formato e l'uso di questo comando.
233
234 Le espressioni fondamentali di LilyPond sono gli elementi musicali come le note,
235 le durate e le annotazioni.  Le espressioni basilari come numeri,
236 stringhe di testo e liste sono elaborate nella @q{modalità Scheme}, che viene
237 invocata inserendo @samp{#} prima del valore.  Sebbene i valori possano
238 avere talvolta una valida rappresentazione nella modalità musicale di LilyPond,
239 per coerenza questo manuale li farà sempre precedere da @samp{#}.  Per maggiori
240 informazioni sulla modalità Scheme, si veda @rextend{LilyPond Scheme syntax}.
241
242 @code{\override} è il comando più usato nelle modifiche e quasi tutto
243 il resto del capitolo ha lo scopo di mostrare alcuni esempi
244 di utilizzo.  Ecco un semplice esempio che mostra come cambiare
245 il colore della testa di nota:
246
247 @cindex proprietà del colore, esempio
248 @cindex colore, proprietà del
249 @cindex NoteHead, esempio di sovrascrittura
250
251 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
252 c4 d
253 \override NoteHead.color = #red
254 e4 f |
255 \override NoteHead.color = #green
256 g4 a b c |
257 @end lilypond
258
259 @node Il comando revert
260 @unnumberedsubsubsec Il comando @code{@bs{}revert}
261 @translationof The revert command
262
263 @cindex revert, comando
264 @cindex ripristino, comando \revert
265
266 @funindex \revert
267 @funindex revert
268
269 Quando viene sovrascritta, la proprietà mantiene il suo nuovo valore finché
270 non viene sovrascritta di nuovo o non si incontra un comando @code{\revert}.
271 Il comando @code{\revert} fa sì che il valore della proprietà sia ripristinato
272 al suo valore predefinito.  Attenzione: non al suo valore precedente (nel caso
273 siano stati inseriti vari comandi @code{\override}).  Impiega la seguente sintassi:
274
275 @example
276 \revert @var{Contesto}.@var{OggettoDiFormmattazione}.@var{proprietà-formattazione}
277 @end example
278
279 Anche in questo caso, come per il comando @code{\override}, @var{Contesto} di
280 solito non è necessario e verrà omesso in molti degli esempi seguenti.
281 In questo esempio ripristiniamo il colore della testa delle ultime due
282 note al valore predefinito:
283
284 @cindex proprietà del colore, esempio
285 @cindex colore, proprietà del
286 @cindex NoteHead, esempio di sovrascrittura
287
288 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
289 c4 d
290 \override NoteHead.color = #red
291 e4 f |
292 \override NoteHead.color = #green
293 g4 a
294 \revert NoteHead.color
295 b4 c |
296 @end lilypond
297
298 @node Il prefisso once
299 @unnumberedsubsubsec Il prefisso @code{@bs{}once}
300 @translationof The once prefix
301
302 @funindex \once
303 @funindex once
304
305 Sia il comando @code{\override} che il comando @code{\set} possono essere
306 preceduti da @code{\once}.  Questo fa sì che il successivo comando @code{\override}
307 o @code{\set} sia effettivo solo in relazione a quel determinato momento musicale,
308 prima che la proprietà sia ripristinata al suo valore precedente (che può essere diverso da quello predefinito se un altro @code{\override} è
309 ancora attivo).  Usando lo stesso esempio, possiamo cambiare il colore di
310 una singola nota in questo modo:
311
312 @cindex proprietà del colore, esempio
313 @cindex colore, proprietà del
314 @cindex NoteHead, esempio di sovrascrittura
315
316 @lilypond[quote,verbatim,relative=1]
317 c4 d
318 \override NoteHead.color = #red
319 e4 f |
320 \once \override NoteHead.color = #green
321 g4 a
322 \revert NoteHead.color
323 b c |
324 @end lilypond
325
326 Il prefisso @code{\once} può essere usato anche di fronte a molti
327 comandi predefiniti per limitare il loro effetto a un momento musicale:
328
329 @lilypond[quote,verbatim,relative=1]
330 c4 d
331 \once \stemDown
332 e4 f |
333 g4 a
334 \once \hideNotes
335 b c |
336 @end lilypond
337
338 Tuttavia, i comandi prefediniti che hanno la forma @code{\@dots{}Neutral},
339 @code{\@dots{}Off} e @code{\un@dots{}} usano internamente @code{\revert} invece
340 di @code{\override} dunque inserire @code{\once} prima di questi comandi
341 non produce alcun effetto.
342
343
344 @node Il comando overrideProperty
345 @unnumberedsubsubsec Il comando @code{@bs{}overrideProperty}
346 @translationof The overrideProperty command
347
348 @cindex overrideProperty, comando
349
350 @funindex \overrideProperty
351 @funindex overrideProperty
352
353 Esiste un'altra forma di comando di sovrascrittura,
354 @code{\overrideProperty}, che si rende necessario raramente.
355 Lo menzioniamo qui per completezza, ma per approfondire l'argomento
356 si veda @rextend{Difficult tweaks}.
357 @c Maybe explain in a later iteration  -td
358
359 @node Il comando tweak
360 @unnumberedsubsubsec Il comando @code{@bs{}tweak}
361 @translationof The tweak command
362
363 @cindex tweak, comando
364
365 @funindex \tweak
366 @funindex tweak
367
368 L'ultimo comando di modifica a disposizione è @code{\tweak}.  Si usa
369 quando vari oggetti compaiono nello stesso momento musicale,
370 ma si vogliono modificare soltanto le proprietà di alcuni oggetti, come
371 ad esempio una singola nota all'interno di un accordo.  Se si usa @code{\override}
372 la modifica ha effetto su tutte le note di un accordo, mentre @code{\tweak} ha
373 effetto solo sul singolo elemento che segue.
374
375 Per esempio, supponiamo di voler modificare la dimensione della
376 testa della nota centrale (il Mi) in un accordo di Do maggiore.  Vediamo prima
377 cosa succede se si usa @code{\once \override}:
378
379 @cindex proprietà font-size, esempio
380 @cindex font-size, esempio
381 @cindex NoteHead, esempio di sovrascrittura
382
383 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
384 <c e g>4
385 \once \override NoteHead.font-size = #-3
386 <c e g>4
387 <c e g>4
388 @end lilypond
389
390 Come si vede, la sovrascrittura riguarda @emph{tutte} le teste di nota
391 dell'accordo.  Ciò è dovuto al fatto che tutte le note di un accordo
392 si trovano nello stesso @emph{momento musicale} e l'azione di @code{\once}
393 consiste nell'applicare la sovrascrittura a tutti gli oggetti di formattazione
394 del tipo specificato che si trovano nello stesso momento musicale del comando
395 @code{\override} stesso.
396
397 Il comando @code{\tweak} funziona in modo diverso.  Agisce sull'elemento
398 immediatamente successivo nel flusso di codice.  Nella sua forma più
399 semplice funziona solo sugli oggetti creati direttamente dall'elemento
400 seguente, in particolare teste di nota e articolazioni.
401
402 Tornando al nostro esempio, la dimensione della nota centrale
403 di un accordo si cambia in questo modo:
404
405 @cindex proprietà font-size, esempio
406 @cindex font-size, esempio
407 @cindex @code{\tweak}, esempio
408
409 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
410 <c e g>4
411 <c \tweak font-size #-3 e g>4
412 @end lilypond
413
414 Si noti che la sintassi di @code{\tweak} è diversa da quella di
415 @code{\override}.  Il contesto non deve essere specificato; anzi,
416 se lo fosse verrebbe generato un errore.  Sia il contesto che l'oggetto
417 di formattazione sono sottintesi dall'elemento che segue nel flusso di
418 input.  Nota anche che non ci devono essere segni di uguale (@code{=}).  Dunque la
419 forma semplice del comando @code{\tweak} è
420
421 @example
422 \tweak @var{proprietà-formattazione} #@var{valore}
423 @end example
424
425 Il comando @code{\tweak} serve anche a modificare soltanto una di una serie
426 di articolazioni:
427
428 @cindex proprietà del colore, esempio
429 @cindex colore, proprietà del
430 @cindex @code{\tweak}, esempio
431
432 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
433 a4^"Black"
434   -\tweak color #red ^"Red"
435   -\tweak color #green _"Green"
436 @end lilypond
437
438 @noindent
439 Nota che il comando @code{\tweak} deve essere preceduto da un segno di
440 articolazione, perché la stessa espressione modificata deve essere applicata come articolazione.  In caso di più sovrascritture della
441 direzione (@code{^} o @code{_}), prevale la sovrascrittura posizionata più a sinistra,
442 perché viene applicata per ultima.
443
444 @cindex @code{\tweak}, alterazione
445 @cindex @code{\tweak}, oggetto di formattazione specifico
446
447 Alcuni oggetti, come gambi e alterazioni, vengono creati dopo, non
448 direttamente dall'evento che segue.  È comunque possibile usare
449 @code{\tweak} con questi oggetti creati indirettamente se si indica
450 esplicitamente l'oggetto di formattazione, purché LilyPond riesca a
451 seguire la sua origine fino all'evento originale:
452
453 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
454 <\tweak Accidental.color #red   cis4
455  \tweak Accidental.color #green es
456                                   g>
457 @end lilypond
458
459 Questa forma estesa del comando @code{\tweak} può essere descritta così
460 @example
461 \tweak @var{oggetto-formattazione}.@var{proprietà-formattazione} @var{valore}
462 @end example
463
464 @cindex gruppi irregolari, annidati
465 @cindex terzine, annidate
466 @cindex parentesi, gruppo irregolare
467 @cindex parentesi, terzina
468 @cindex parentesi del gruppo irregolare
469 @cindex parentesi della terzina
470
471 @funindex TupletBracket
472
473 Il comando @code{\tweak} è necessario anche quando si vuole cambiare
474 l'aspetto di uno di una serie di gruppi irregolari annidati che iniziano
475 nello stesso momento musicale.  Nell'esempio seguente, la prima lunga
476 parentesi del gruppo irregolare e la prima delle tre brevi parentesi
477 iniziano nello stesso momento musicale, quindi qualsiasi comando
478 @code{\override} produrrebbe degli effetti su entrambi.  In questo esempio,
479 si usa @code{\tweak} per distinguerli.  Il primo comando @code{\tweak}
480 indica che la lunga parentesi del gruppo irregolare deve essere posizionata
481 sopra le note e il secondo indica che il numero del primo gruppo irregolare
482 deve essere in rosso.
483
484 @cindex @code{\tweak}, esempio
485 @cindex proprietà della direzione, esempio
486 @cindex direzione, esempio
487 @cindex proprietà del colore, esempio
488 @cindex colore, esempio
489
490 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
491 \tweak direction #up
492 \tuplet 3/4 {
493   \tweak color #red
494   \tuplet 3/2 { c8[ c c] }
495   \tuplet 3/2 { c8[ c c] }
496   \tuplet 3/2 { c8[ c c] }
497 }
498 @end lilypond
499
500 Se i gruppi irregolari annidati non iniziano nello stesso momento, il loro
501 aspetto può essere modificato come di consueto con i comandi @code{\override}:
502
503 @cindex proprietà text, esempio
504 @cindex text, esempio
505 @cindex funzione tuplet-number, esempio
506 @cindex proprietà transparent, esempio
507 @cindex transparent, esempio
508 @cindex TupletNumber, esempio di sovrascrittura
509
510 @c NOTE Tuplet brackets collide if notes are high on staff
511 @c See issue 509
512 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
513 \tuplet 3/2 { c8[ c c] }
514 \once \override TupletNumber.text = #tuplet-number::calc-fraction-text
515 \tuplet 3/2 {
516   c8[ c]
517   c8[ c]
518   \once \override TupletNumber.transparent = ##t
519   \tuplet 3/2 { c8[ c c] }
520   \tuplet 3/2 { c8[ c c] }
521 }
522 @end lilypond
523
524
525 @seealso
526 Guida alla Notazione:
527 @ruser{The tweak command}.
528
529
530 @node Manuale del Funzionamento interno
531 @section Manuale del Funzionamento interno
532 @translationof The Internals Reference manual
533
534 @cindex Guida al Funzionamento interno
535
536 @menu
537 * Proprietà degli oggetti di formattazione::
538 * Proprietà presenti nelle interfacce::
539 * Tipi di proprietà::
540 @end menu
541
542 @node Proprietà degli oggetti di formattazione
543 @subsection Proprietà degli oggetti di formattazione
544 @translationof Properties of layout objects
545
546 @cindex proprietà degli oggetti di formattazione
547 @cindex proprietà degli oggetti grafici (grob)
548 @cindex ogggetti grafici, proprietà degli
549 @cindex oggetti di formattazione, proprietà degli
550 @cindex manuale del Funzionamento Interno
551
552 Immagina di avere una legatura di portamento che ai tuoi
553 occhi appare troppo sottile e che vorresti un po' più spessa.
554 Come fare?  Sai che LilyPond è molto flessibile e che quindi
555 dovrebbe essere possibile farlo; e probabilmente immagini
556 che sia necessario un comando @code{\override}.  Ma esiste una
557 proprietà che controlla lo spessore di una legatura? E se esiste
558 come può essere modificata?  Qui entra in gioco il manuale del Funzionamento
559 Interno, che contiene tutte le informazioni necessarie per costruire
560 tutti i comandi @code{\override}.
561
562 Prima di dare un'occhiata alla guida al Funzionamento Interno, vogliamo
563 avvisarti: si tratta di un documento di @strong{riferimento}, che significa
564 che ci sono poche o nessune spiegazioni al suo interno, dato che il suo
565 scopo è presentare le informazioni in modo preciso e conciso.  Dunque potrà
566 sembrare scoraggiante al primo impatto.  Ma non ti preoccupare!  I consigli
567 e le spiegazioni presentate qui, insieme a un po' di pratica, ti permetteranno
568 di estrarre da solo da quella guida le informazioni che cerchi.
569
570 @cindex esempio di sovrascrittura
571 @cindex sovrascrittura, esempio
572 @cindex Guida al Funzionamento Interno, esempio d'uso
573 @cindex @code{\addlyrics}, esempio
574
575 Partiamo da un esempio concreto, un semplice frammento di musica:
576
577 @c Mozart, Die Zauberflöte Nr.7 Duett
578
579 @lilypond[quote,verbatim,relative=2]
580 {
581   \key es \major
582   \time 6/8
583   {
584     r4 bes8 bes[( g]) g |
585     g8[( es]) es d[( f]) as |
586     as8 g
587   }
588   \addlyrics {
589     The man who | feels love's sweet e -- | mo -- tion
590   }
591 }
592 @end lilypond
593
594 Supponiamo ora che si vogliano rendere un po' più spesse le
595 legature di portamento.  È possibile?  La legatura di portamento
596 è certamente un oggetto di formattazione, dunque la domanda è: @q{Esiste una
597 proprietà che appartiene a una legatura di portamento in grado di controllare
598 lo spessore?}  Per rispondere a questa domanda dobbiamo guardare
599 nella guida al Funzionamento interno.
600
601 Puoi trovare la guida nella versione di LilyPond che stai usando
602 sul sito di LilyPond: @uref{http://lilypond.org}.  Vai alla
603 pagina della documentazione e clicca sul link alla guida del Funzionamento
604 interno.  Per poter seguire questo manuale dovresti usare la versione HTML standard,
605 non quella in un'unica grande pagina né il PDF.  Nei prossimi paragrafi ti
606 servirà per seguire gli esempi che faremo.
607
608 Sotto il titolo vedrai cinque link.  Seleziona il
609 link al @strong{Backend}, dove si trovano le informazioni
610 sugli oggetti di formattazione (@emph{layout objects}).  Poi sotto il titolo
611 @emph{Backend}, seleziona il link a @strong{All layout objects}.
612 La pagina che compare elenca tutti gli oggetti di formattazione usati
613 nella tua versione di LilyPond, in ordine alfabetico.  Seleziona il link a
614 Slur (legatura di portamento) e verranno elencate le sue proprietà.
615
616 Si può trovare questa pagina anche dalla Guida alla notazione.  In una
617 delle pagine che tratta le legature di portamento potrai trovare un
618 link alla Guida al funzionamento interno.  Il link ti porterà direttamente
619 a questa pagina, ma se hai un'idea di quale sia l'oggetto di formattazione
620 da modificare, è più semplice andare direttamente nella guida del Funzionamento
621 interno e cercare lì.
622
623 La pagina sulla legatura di portamento (@emph{Slur}) ci dice per prima cosa che gli
624 oggetti Slur sono creati dall'incisore Slur_engraver.  Poi elenca le impostazioni
625 standard.  Scorrile cercando la proprietà che potrebbe controllare lo spessore
626 delle legature di portamento; dovresti trovare
627
628 @example
629 @code{thickness} (number)
630      @code{1.2}
631      Line thickness, generally measured in @code{line-thickness}
632 @end example
633
634 Sembra che sia quel che stiamo cercando.  Ci dice che il valore
635 di @code{thickness} (spessore) è un semplice @emph{numero},
636 che il valore predefinito è 1.2 e che le unità si trovano in
637 un'altra proprietà chiamata @code{line-thickness}.
638
639 Come abbiamo detto prima, ci sono poche spiegazioni nella guida al
640 Funzionamento interno, tuttavia abbiamo già informazioni sufficienti
641 per cercare di cambiare lo spessore delle legature di portamento.
642 Vediamo che il nome dell'oggetto di formattazione è @code{Slur}, che
643 il nome della proprietà da modificare è @code{thickness} e che il
644 nuovo valore dovrà essere un numero un po' più grande di 1.2
645 se vogliamo rendere più spesse le legature.
646
647 Ora possiamo costruire il comando @code{\override} sostituendo
648 i valori che abbiamo trovato per i nomi e omettendo il
649 contesto.  Inizialmente usiamo un valore molto grande per lo
650 spessore, per essere sicuri che il comando funzioni:
651
652 @example
653 \override Slur.thickness = #5.0
654 @end example
655
656 Non dimenticare il@tie{}@code{#} che precede il nuovo valore!
657
658 L'ultima domanda è: @q{dove va messo questo comando?}  Finché non sei sicuro
659 e stai ancora imparando, la risposta migliore è: @q{dentro la musica, prima della
660 prima legatura di portamento e accanto ad essa.}  Facciamolo:
661
662 @cindex legatura di portamento, esempio di sovrascrittura
663 @cindex proprietà thickness, esempio
664 @cindex thickness (spessore), esempio
665
666 @lilypond[quote,verbatim,relative=2]
667 {
668   \key es \major
669   \time 6/8
670   {
671     % Increase thickness of all following slurs from 1.2 to 5.0
672     \override Slur.thickness = #5.0
673     r4 bes8 bes[( g]) g |
674     g8[( es]) es d[( f]) as |
675     as8 g
676   }
677   \addlyrics {
678     The man who | feels love's sweet e -- | mo -- tion
679   }
680 }
681 @end lilypond
682
683 @noindent
684 e vediamo che la legatura di portamento è davvero più grossa.
685
686 Questi sono i fondamenti per costruire i comandi @code{\override}.  Incontreremo
687 delle situazioni più complesse nelle sezioni successive, ma ora possiedi già
688 tutte le conoscenze di base che ti permetteranno di costruire i tuoi comandi.
689 Ti manca solo un po' di pratica, che potrai fare grazie ai prossimi esempi.
690
691 @subsubheading Trovare il contesto
692
693 @cindex contesto, trovare il
694 @cindex contesto, identificare il corretto
695
696 E se avessimo bisogno di specificare il contesto?
697 Quale dovrebbe essere?  Potremmo immaginare che le legature
698 di portamento si trovino nel contesto Voice, dato che sono ovviamente
699 collegate strettamente alle singole voci, ma possiamo
700 esserne sicuri?  Per scoprirlo, vai in cima alla pagina del Funzionamento
701 Interno relativa a «Slur», dove dice @q{Slur objects are created by: Slur
702 engraver}.  Significa che le legature di portamento sono create nel contesto
703 in cui si trova l'incisore @code{Slur_engraver}.  Segui il link alla pagina
704 @code{Slur_engraver}.  In fondo dice che lo @code{Slur_engraver} fa parte di
705 vari contesti Voice, incluso il contesto standard della voce, @code{Voice}.
706 Dunque la nostra supposizione era corretta.  E dato che @code{Voice} è uno dei
707 contesti che si trovano al livello più basso, come è sottinteso senza ambiguità
708 dal fatto che stiamo inserendo delle note, in questo caso possiamo ometterlo.
709
710 @subsubheading Sovrascrivere una volta sola
711
712 @cindex sovrascrivere una volta sola
713 @cindex \once \override
714
715 @funindex \once
716 @funindex once
717
718 Come puoi vedere, @emph{tutte} le legature di portamento sono più spesse nell'ultimo
719 esempio.  E se volessimo rendere più spessa solo la prima legatura di portamento?
720 Dovremmo usare il comando @code{\once}.  Se posto immediatamente prima
721 di @code{\override} fa sì che questo modifichi soltanto la legatura di portamento
722 che inizia sulla nota @strong{immediatamente seguente}.  Se la nota immediatamente
723 seguente non inizia la legatura, il comando non ha alcun effetto -- non è
724 ricordato finché non si incontra una legatura di portamento, ma
725 viene direttamente scartato.  Quindi il comando con @code{\once} deve essere riposizionato
726 nel modo seguente:
727
728 @cindex Slur, esempio di sovrascrittura
729 @cindex proprietà thickness, esempio
730 @cindex thickness (spessore), esempio
731
732 @lilypond[quote,verbatim,relative=2]
733 {
734   \key es \major
735   \time 6/8
736   {
737     r4 bes8
738     % Aumenta lo spessore solo della legatura che segue
739     \once \override Slur.thickness = #5.0
740     bes8[( g]) g |
741     g8[( es]) es d[( f]) as |
742     as8 g
743   }
744   \addlyrics {
745     The man who | feels love's sweet e -- | mo -- tion
746   }
747 }
748 @end lilypond
749
750 @noindent
751 Ora solo la prima legatura è più spessa.
752
753 Il comando @code{\once} può essere usato anche prima del comando @code{\set}.
754
755 @subsubheading Ripristinare
756
757 @cindex revert
758 @cindex ripristinare le proprietà predefinite
759 @cindex proprietà predefinite, ripristinare le
760
761 @funindex \revert
762 @funindex revert
763
764 E se volessimo che soltanto le prime due legature di portamento fossero
765 più spesse?  Potremmo usare due comandi, ciascuno preceduto da
766 @code{\once}, messo immediatamente prima di ognuna delle note da cui
767 iniziano le legature:
768
769 @cindex Slur, esempio di sovrascrittura
770 @cindex proprietà thickness, esempio
771 @cindex thickness (spessore), esempio
772
773 @lilypond[quote,verbatim,relative=2]
774 {
775   \key es \major
776   \time 6/8
777   {
778     r4 bes8
779     % Aumenta lo spessore solo della legatura che segue
780     \once \override Slur.thickness = #5.0
781     bes[( g]) g |
782     % Aumenta lo spessore solo della legatura che segue
783     \once \override Slur.thickness = #5.0
784     g8[( es]) es d[( f]) as |
785     as8 g
786   }
787   \addlyrics {
788     The man who | feels love's sweet e -- | mo -- tion
789   }
790 }
791 @end lilypond
792
793 @noindent
794 oppure potremmo omettere il comando @code{\once} e usare il comando @code{\revert}
795 per far sì che la proprietà @code{thickness} ritorni al valore predefinito
796 dopo la seconda legatura:
797
798 @cindex Slur, esempio di sovrascrittura
799 @cindex proprietà thickness, esempio
800 @cindex thickness (spessore), esempio
801
802 @lilypond[quote,verbatim,relative=2]
803 {
804   \key es \major
805   \time 6/8
806   {
807     r4 bes8
808     % Aumenta lo spessore di tutte le legature di portamento che seguono da 1.2 a 5.0
809     \override Slur.thickness = #5.0
810     bes[( g]) g |
811     g8[( es]) es
812     % Ripristina lo spessore di tutte le legature di portamento che seguono al valore predefinito 1.2
813     \revert Slur.thickness
814     d8[( f]) as |
815     as8 g
816   }
817   \addlyrics {
818     The man who | feels love's sweet e -- | mo -- tion
819   }
820 }
821 @end lilypond
822
823 @noindent
824 Il comando @code{\revert} serve a riportare qualsiasi proprietà
825 modificata con @code{\override} al suo valore predefinito.
826 Puoi usare qualsiasi metodo si adatti meglio a quello che vuoi fare.
827
828 Si conclude l'introduzione alla guida al Funzionamento interno e ai metodi
829 di base delle modifiche.  Nelle sezioni successive di questo capitolo
830 seguiranno vari esempi, in parte per presentarti ulteriori caratteristiche
831 della guida al Funzionamento interno e in parte per farti esercitare
832 nell'estrarre informazioni da esso.  Questi esempi conterranno sempre meno
833 consigli e spiegazioni.
834
835
836 @node Proprietà presenti nelle interfacce
837 @subsection Proprietà presenti nelle interfacce
838 @translationof Properties found in interfaces
839
840 @cindex interfaccia
841 @cindex proprietà dell'interfaccia
842 @cindex proprietà nelle interfacce
843
844 Supponiamo ora di voler produrre un testo vocale in corsivo.  Che tipo di
845 comando @code{\override} ci serve?  Consultiamo prima la pagina
846 della guida al Funzionamento interno che elenca @q{All layout objects}, come
847 prima, e cerchiamo un oggetto che potrebbe controllare il testo (in inglese
848 @emph{lyrics}).  Troviamo @code{LyricText}, che sembra quello giusto.  Clicchiamo
849 su di esso e troviamo le proprietà del testo.  Queste comprendono @code{font-series}
850 e @code{font-size}, ma niente che possa dare una forma corsiva.  Ciò è dovuto
851 al fatto che la proprietà della forma è comune a tutti gli oggetti di tipi
852 di carattere (@emph{font}).  Quindi, invece di includerla in ogni oggetto di
853 formattazione, viene raggruppata insieme ad altre simili proprietà comuni
854 e inserita in un'@strong{Interfaccia}: @code{font-interface}.
855
856 Ora dobbiamo capire come trovare le proprietà delle interfacce e
857 come scoprire quali oggetti usano queste proprietà.
858
859 Torna a vedere la pagina che descrive LyricText.  In fondo alla
860 pagina c'è una lista di interfacce cliccabili supportate da LyricText.
861 La lista ha molti elementi, incluso @code{font-interface}.  Cliccando
862 su di essa arriviamo alle proprietà associate con questa interfaccia, che
863 sono anche le proprietà di tutti gli oggetti che la supportano, tra cui
864 LyricText.
865
866 Vediamo tutte le proprietà configurabili dall'utente che controllano i
867 tipi di carattere, compresa @code{font-shape(symbol)}, dove @code{symbol} può
868 essere impostato su @code{upright}, @code{italic} o @code{caps}.
869
870 Puoi notare che lì sono elencate anche @code{font-series} e @code{font-size}.
871 Ti potresti chiedere: perché le proprietà comuni dei tipi di carattere
872 @code{font-series} e @code{font-size} fanno parte sia dell'oggetto
873 @code{LyricText} sia dell'interfaccia @code{font-interface} mentre @code{font-shape}
874 è presente solo nell'interfaccia?  Ciò è dovuto al fatto che i valori globali
875 predefiniti di @code{font-series} e @code{font-size} cambiano quando viene
876 creato un oggetto @code{LyricText}, mentre i valori di @code{font-shape} non
877 cambiano.  Gli elementi in @code{LyricText} indicano quali sono i
878 valori per queste due proprietà che si applicano a @code{LyricText}.  Altri
879 oggetti che supportano @code{font-interface} imposteranno queste proprietà
880 in modo diverso quando vengono creati.
881
882 Vediamo se ora riusciamo a costruire il comando @code{\override}
883 per rendere il testo corsivo.  L'oggetto è @code{LyricText},
884 la proprietà è @code{font-shape} e il valore è
885 @code{italic}.  Come in precedenza, ometteremo il contesto.
886
887 Per inciso, è importante notare che alcune proprietà prendono come valori
888 dei simboli, ad esempio @code{italic}; in questo caso i valori devono essere
889 preceduti da un apostrofo, @code{'}.  I simboli vengono letti internamente da
890 LilyPond.  Nota che sono diversi dalle stringhe di testo arbitrarie, che
891 appaiono nella forma @code{"una stringa di testo"}; maggiori informazioni sui
892 simboli e le stringhe si trovano in @rextend{Scheme tutorial}.
893
894 Quindi il comando @code{\override} che rende il testo corsivo è:
895
896 @example
897 \override LyricText.font-shape = #'italic
898 @end example
899
900 @noindent
901 Deve essere posizionato proprio di fronte al testo che vogliamo modificare,
902 in questo modo:
903
904 @cindex proprietà font-shape, esempio
905 @cindex font-shape, esempio
906 @cindex italic, esempio
907 @cindex corsivo, esempio
908 @cindex LyricText, esempio di sovrascrittura
909 @cindex @code{\addlyrics}, esempio
910
911 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
912 {
913   \key es \major
914   \time 6/8
915   {
916     r4 bes8 bes[( g]) g |
917     g8[( es]) es d[( f]) as |
918     as8 g
919   }
920   \addlyrics {
921     \override LyricText.font-shape = #'italic
922     The man who | feels love's sweet e -- | mo -- tion
923   }
924 }
925 @end lilypond
926
927 @noindent
928 e tutto il testo è in corsivo.
929
930 @warning{Nel testo bisogna lasciare sempre uno spazio bianco tra l'ultima
931 sillaba e la parentesi graffa che chiude il blocco.}
932
933
934 @seealso
935 Estendere: @rextend{Scheme tutorial}.
936
937
938 @node Tipi di proprietà
939 @subsection Tipi di proprietà
940 @translationof Types of properties
941
942 @cindex tipi di proprietà
943 @cindex proprietà, tipi di
944
945 Finora abbiamo visto due tipi di proprietà: @code{number} e
946 @code{symbol}.  Per essere valido, il valore dato a una proprietà
947 deve essere del tipo corretto e obbedire alle regole di quel tipo.
948 Nella guida al Funzionamento interno il tipo di proprietà è indicato
949 tra parentesi dopo il nome della proprietà.  Ecco una lista dei tipi
950 che ti possono servire, corredata dalle regole per ciascun tipo e da alcuni
951 esempi.  Ovviamente, se inseriti in un comando @code{\override}, devono
952 essere sempre preceduti dal simbolo di cancelletto,@tie{}@code{#}, anche se
953 il valore stesso già inizia con@tie{}@code{#}.  In questa sede diamo solo
954 esempi di costanti: se si desidera elaborare un valore con Scheme, si veda
955 @rextend{Calculations in Scheme}.
956
957 @multitable @columnfractions .2 .45 .35
958 @headitem Tipo di proprietà
959   @tab Regole
960   @tab Esempi
961 @item Boolean
962   @tab O Vero (True) o Falso (False), rappresentato da #t o #f
963   @tab @code{#t}, @code{#f}
964 @item Dimension (in staff space)
965   @tab Un numero decimale (nell'unità di misura dello spazio del rigo)
966   @tab @code{2.5}, @code{0.34}
967 @item Direction
968   @tab Una valida direzione costante o il suo equivalente numerico
969   (@code{0} o @code{CENTER} indicano una direzione neutrale)
970   @tab @code{LEFT}, @code{CENTER}, @code{UP},
971        @code{1}, @w{@code{-1}}
972 @item Integer
973   @tab Un numero intero
974   @tab @code{3}, @code{-1}
975 @item List
976   @tab Una sequenza di costanti o simboli separata da spazi, racchiusa
977   tra parentesi e preceduta da un apostrofo
978   @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'()},
979        @code{'(1.0 0.25 0.5)}
980 @item Markup
981   @tab Qualsiasi valido blocco markup
982   @tab @code{\markup @{ \italic "cresc." @}}, @code{"bagpipe"}
983 @item Moment
984   @tab Una frazione di una nota intera costruita con la
985 funzione make-moment
986   @tab @code{(ly:make-moment 1/4)},
987        @code{(ly:make-moment 3/8)}
988 @item Number
989   @tab Qualsiasi valore positivo o negativo, possibilmente decimale
990   @tab @code{3}, @w{@code{-2.45}}
991 @item Pair (of numbers)
992   @tab Due numeri separati da un @q{spazio . spazio} e racchiusi tra
993 parentesi precedute da un apostrofo
994   @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
995 @item Symbol
996   @tab Qualsiasi insieme di simboli ammesso per quella proprietà,
997 preceduto da un apostrofo
998   @tab @code{'italic}, @code{'inside}
999 @item Unknown
1000   @tab Una procedura o un valore @code{#f} che impedisca l'azione
1001   @tab @code{bend::print}, @code{ly:text-interface::print},
1002        @code{#f}
1003 @item Vector
1004   @tab Costanti
1005   racchiuse tra @code{#(}@dots{}@code{)}.
1006   @tab @code{#(#t #t #f)}
1007 @end multitable
1008
1009
1010 @seealso
1011 Estendere: @rextend{Scheme tutorial}.
1012
1013
1014 @node Aspetto degli oggetti
1015 @section Aspetto degli oggetti
1016 @translationof Appearance of objects
1017
1018 Mettiamo in pratica quello che abbiamo imparato con un po' di
1019 esempi che mostrano come modificare l'aspetto degli elementi
1020 di una partitura.
1021
1022 @menu
1023 * Visibilità e colore degli oggetti::
1024 * Dimensione degli oggetti::
1025 * Lunghezza e spessore degli oggetti::
1026 @end menu
1027
1028 @node Visibilità e colore degli oggetti
1029 @subsection Visibilità e colore degli oggetti
1030 @translationof Visibility and color of objects
1031
1032 Potremmo voler creare una partitura priva di alcuni elementi a
1033 scopo didattico, perché lo studente possa esercitarsi
1034 a inserirli.  Vediamo un semplice esempio e immaginiamo che
1035 l'esercizio consista nell'inserire le stanghette mancanti
1036 di un brano.  Ma di norma le stanghette sono inserite
1037 automaticamente: come lo possiamo impedire?
1038
1039 Prima di iniziare, occorre ricordare che le proprietà degli oggetti sono
1040 raggruppate nelle cosiddette @emph{interfacce} -- si veda @ref{Properties
1041 found in interfaces}.  Queste servono semplicemente a raggruppare quelle
1042 proprietà che possono essere usate insieme per modificare un oggetto
1043 grafico -- se una di queste è ammessa per un oggetto, lo sono anche le
1044 altre.  Alcuni oggetti usano le proprietà di alcune interfacce, altri
1045 quelle di altre interfacce.  Le interfacce che contengono le proprietà
1046 usate da un particolare grob (oggetto grafico) sono elencate nella guida al
1047 Funzionamento interno in fondo alla pagina che descrive il grob; queste
1048 proprietà possono essere individuate consultando quelle interfacce.
1049
1050 In @ref{Properties of layout objects} abbiamo spiegato come trovare le
1051 informazioni sui grob.  Usando lo stesso approccio, andiamo nella guida
1052 al Funzionamento interno per trovare l'oggetto grafico relativo alla
1053 stanghetta (@emph{bar line}).  Passando da @emph{Backend} e @emph{All layout objects}
1054 troviamo un oggetto grafico chiamato @code{BarLine}.  Tra le sue proprietà ce ne sono
1055 due che controllano la visibilità: @code{break-visibility} e @code{stencil}.  Anche
1056 Barline supporta varie interfacce, tra cui la @code{grob-interface},
1057 dove troviamo le proprietà @code{transparent} e @code{color}.
1058 Tutte queste proprietà hanno degli effetti sulla visibilità delle stanghette (e,
1059 ovviamente, anche di molti altri oggetti grafici).  Vediamole una per
1060 volta.
1061
1062 @menu
1063 * La proprietà stencil::
1064 * La proprietà break-visibility::
1065 * La proprietà transparent::
1066 * La proprietà color::
1067 @end menu
1068
1069 @node La proprietà stencil
1070 @unnumberedsubsubsec La proprietà @code{stencil}
1071 @translationof The stencil property
1072
1073 @cindex proprietà stencil
1074 @cindex stencil, proprietà
1075
1076 Questa proprietà controlla l'aspetto delle stanghette specificando il
1077 simbolo (glifo) da usare.  Come nel caso di molte altre proprietà,
1078 si può far in modo che non usi nessun simbolo impostando il suo
1079 valore su @code{#f}.  Proviamo, come prima, omettendo il contesto
1080 implicito, @code{Voice}:
1081
1082 @cindex BarLine, esempio di sovrascrittura
1083 @cindex proprietà stencil, esempio
1084 @cindex stencil, esempio
1085
1086 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1087 {
1088   \time 12/16
1089   \override BarLine.stencil = ##f
1090   c4 b8 c d16 c d8 |
1091   g,8 a16 b8 c d4 e16 |
1092   e8
1093 }
1094 @end lilypond
1095
1096 Le stanghette sono ancora visibili.  Cosa abbiamo sbagliato?  Torna alla
1097 guida del Funzionamento interno e scorri di nuovo la pagina che elenca
1098 le proprietà di BarLine.  In cima alla pagina dice @qq{Barline objects are
1099 created by: Bar_engraver}.  Vai alla pagina @code{Bar_engraver}.  In fondo
1100 si trova una lista dei contesti nel quale opera l'incisore della battuta.
1101 Tutti questi sono di tipo @code{Staff}, dunque la ragione per cui il comando
1102 @code{\override} precedente non funziona è che @code{Barline} non si trova
1103 nel contesto predefinito, @code{Voice}.  Se il contesto indicato non è
1104 corretto, il comando non funziona.  Non viene generato alcun messaggio
1105 di errore e non viene registrato niente nel file di log.  Proviamo a
1106 correggerlo specificando il contesto giusto:
1107
1108 @cindex BarLine, esempio di sovrascrittura
1109 @cindex proprietà stencil, esempio
1110 @cindex stencil, esempio
1111
1112 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1113 {
1114   \time 12/16
1115   \override Staff.BarLine.stencil = ##f
1116   c4 b8 c d16 c d8 |
1117   g,8 a16 b8 c d4 e16 |
1118   e8
1119 }
1120 @end lilypond
1121
1122 Ora le stanghette sono sparite.  Impostare la proprietà @code{stencil}
1123 su @code{#f} è un'operazione talmente frequente che è stata creata una
1124 scorciatoia, @code{\omit}:
1125 @funindex \omit
1126
1127 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1128 {
1129   \time 12/16
1130   \omit Staff.BarLine
1131   c4 b8 c d16 c d8 |
1132   g,8 a16 b8 c d4 e16 |
1133   e8
1134 }
1135 @end lilypond
1136
1137 Si noti però che impostare la proprietà @code{stencil} su @code{#f}
1138 causerà degli errori nel caso in cui le dimensioni dell'oggetto
1139 siano necessarie per elaborarlo correttamente.  Ad esempio, si creano
1140 degli errori se la proprietà @code{stencil} dell'oggetto @code{NoteHead} è
1141 impostata su @code{#f}.  In questo caso è possibile usare invece la funzione
1142 @code{point-stencil}, che trasforma lo stencil in un oggetto a dimensione
1143 zero:
1144
1145 @lilypond[quote,verbatim,relative=2]
1146 {
1147   c4 c
1148   \once \override NoteHead.stencil = #point-stencil
1149   c4 c
1150 }
1151 @end lilypond
1152
1153 @node La proprietà break-visibility
1154 @unnumberedsubsubsec La proprietà @code{break-visibility}
1155 @translationof The break-visibility property
1156
1157 @cindex proprietà break-visibility
1158 @cindex break-visibility, proprietà
1159
1160 Nella pagina di @code{BarLine} della guida al Funzionamento interno
1161 vediamo che la proprietà @code{break-visibility} richiede un vettore di
1162 tre valori booleani.
1163 Questi valori controllano rispettivamente se le stanghette debbano
1164 comparire alla fine, in mezzo o all'inizio dei righi.  Dato
1165 che nel nostro esempio vogliamo sopprimere tutte le stanghette, il valore
1166 che ci serve è @code{#(#f #f #f)} (equivalente al nome @code{all-invisible}).
1167 Proviamo, ricordando di includere il contesto @code{Staff}.  Si noti che prima
1168 della parentesi di apertura abbiamo @code{##}.  Un @code{#} è necessario
1169 perché introduce un vettore, mentre il primo@tie{}@code{#} deve precedere, come
1170 sempre, il valore del comando @code{\override}.
1171
1172 @cindex BarLine, esempio di sovrascrittura
1173 @cindex proprietà break-visibility, esempio
1174 @cindex break-visibility, esempio
1175
1176 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1177 {
1178   \time 12/16
1179   \override Staff.BarLine.break-visibility = ##(#f #f #f)
1180   c4 b8 c d16 c d8 |
1181   g,8 a16 b8 c d4 e16 |
1182   e8
1183 }
1184 @end lilypond
1185
1186 E vediamo che anche questo comando elimina tutte le stanghette.
1187
1188 @node La proprietà transparent
1189 @unnumberedsubsubsec La proprietà @code{transparent}
1190 @translationof The transparent property
1191
1192 @cindex proprietà transparent
1193 @cindex transparent, proprietà
1194 @cindex trasparenza
1195
1196 Nelle proprietà specificate nella pagina @code{grob-interface} della
1197 guida al Funzionamento interno vediamo che la proprietà @code{transparent} è
1198 un booleano.  Quindi deve essere impostata su @code{#t} («true», 'vero') per
1199 rendere trasparente il grob.  Nel prossimo esempio rendiamo trasparente
1200 il segno di tempo invece delle stanghette.  Per farlo dobbiamo trovare
1201 il nome del grob del segno di tempo (in inglese @emph{time signature}).
1202 Torniamo alla pagina @q{All layout objects} per scoprire quali sono le
1203 proprietà dell'oggetto di formattazione @code{TimeSignature}.  Tale grob
1204 è generato dall'incisore @code{Time_signature_engraver}, che opera
1205 nel contesto @code{Staff} e supporta l'interfaccia @code{grob-interface}.
1206 Quindi il comando che rende trasparente l'indicazione di tempo è:
1207
1208 @cindex TimeSignature, esempio di sovrascrittura
1209 @cindex proprietà transparent, esempio
1210 @cindex transparent, esempio
1211
1212 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1213 {
1214   \time 12/16
1215   \override Staff.TimeSignature.transparent = ##t
1216   c4 b8 c d16 c d8 |
1217   g,8 a16 b8 c d4 e16 |
1218   e8
1219 }
1220 @end lilypond
1221
1222 @noindent
1223 Impostare la proprietà @code{transparent} è un'operazione piuttosto
1224 frequente, perciò è stata creata la scorciatoia @code{\hide}:
1225 @funindex \hide
1226
1227 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1228 {
1229   \time 12/16
1230   \hide Staff.TimeSignature
1231   c4 b8 c d16 c d8 |
1232   g,8 a16 b8 c d4 e16 |
1233   e8
1234 }
1235 @end lilypond
1236
1237 @noindent
1238 L'indicazione di tempo è scomparsa; è rimasto però uno spazio al suo posto.  Magari
1239 questo è quello che si desidera, ad esempio per creare un esercizio in cui uno
1240 studente deve riempire degli spazi vuoti.  Ma in altre circostanze ciò può
1241 non essere gradito.  Per eliminare lo spazio vuoto bisogna impostare la
1242 proprietà stencil su @code{#f}:
1243
1244 @cindex TimeSignature, esempio di sovrascrittura
1245 @cindex proprietà stencil, esempio
1246 @cindex stencil, esempio
1247
1248 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1249 {
1250   \time 12/16
1251   \omit Staff.TimeSignature
1252   c4 b8 c d16 c d8 |
1253   g,8 a16 b8 c d4 e16 |
1254   e8
1255 }
1256 @end lilypond
1257
1258 @noindent
1259 la differenza è ovvia: se si imposta lo stencil su @code{#f} (possibilmente
1260 con @code{\omit}) l'oggetto scompare del tutto; se si rende l'oggetto
1261 @code{trasparente} questo resta dove è, anche se invisibile.
1262
1263 @node La proprietà color
1264 @unnumberedsubsubsec La proprietà @code{color}
1265 @translationof The color property
1266
1267 @cindex proprietà color
1268 @cindex color, proprietà
1269
1270 Infine, proviamo a rendere le stanghette invisibili colorandole
1271 di bianco.  (Si tratta di un metodo problematico perché la
1272 stanghetta bianca può imbiancare o meno le linee del rigo che
1273 incrocia.  Puoi vedere in alcuni degli esempi successivi che questo
1274 accade in modo imprevedibile.  I motivi per cui questo accade e il
1275 modo in cui è possibile controllarlo sono esposti in @ruser{Painting objects white}.
1276 Ma per il momento stiamo imparando la proprietà color, quindi accettiamo questa limitazione.)
1277
1278 L'interfaccia @code{grob-interface} stabilisce che il valore della
1279 proprietà color è una lista, ma non spiega cosa debba essere questa
1280 lista.  La lista di cui ha bisogno è in realtà una lista di valori
1281 in unità interne, ma per evitare di dover imparare quali siano queste
1282 unità vengono forniti vari modi di specificare un colore.  Il primo
1283 modo consiste nell'usare uno dei colori @q{normali} elencati nella
1284 prima tabella in @ruser{List of colors}.  Per rendere bianche le
1285 stanghette scriviamo:
1286
1287 @cindex BarLine, esempio di sovrascrittura
1288 @cindex proprietà color
1289 @cindex color, proprietà
1290
1291 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1292 {
1293   \time 12/16
1294   \override Staff.BarLine.color = #white
1295   c4 b8 c d16 c d8 |
1296   g,8 a16 b8 c d4 e16 |
1297   e8
1298 }
1299 @end lilypond
1300
1301 @noindent
1302 e di nuovo vediamo che le stanghette non sono visibili.  Si noti
1303 che @emph{white} non è preceduto da un apostrofo, perché non
1304 è un simbolo, ma una @emph{variabile}.  Quando viene esaminata, fornisce
1305 la lista di valori interni necessari per impostare il colore su
1306 bianco.  Gli altri colori nella lista normale sono anch'essi
1307 delle variabili.  Per convincerti che funziona potresti provare a
1308 cambiare il colore e usare una delle altre variabili presenti
1309 nella lista.
1310
1311 @cindex color, X11
1312 @cindex colori X11
1313 @cindex X11, colori
1314
1315 @funindex x11-color
1316
1317 Il secondo modo per cambiare il colore è attraverso la lista
1318 di nomi di colori X11 che si trova in @ruser{List of colors}.
1319 Questi colori vengono trasformati in valori reali dalla funzione
1320 @code{x11-color}, che converte i simboli di colore X11 nella lista
1321 di valori interni:
1322
1323 @cindex BarLine, esempio di sovrascrittura
1324 @cindex proprietà color, esempio
1325 @cindex color, esempio
1326
1327 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1328 {
1329   \time 12/16
1330   \override Staff.BarLine.color = #(x11-color 'white)
1331   c4 b8 c d16 c d8 |
1332   g,8 a16 b8 c d4 e16 |
1333   e8
1334 }
1335 @end lilypond
1336
1337 @noindent
1338 Si noti che in questo caso la funzione @code{x11-color} prende
1339 un simbolo come argomento, dunque il simbolo deve essere preceduto
1340 da un apostrofo per impedire che sia considerato una variabile e
1341 l'intera funzione deve essere racchiusa tra parentesi.
1342
1343 @cindex colori rgb
1344 @cindex rgb, colori
1345 @cindex color, rgb
1346
1347 @funindex rgb-color
1348
1349 Esiste un'altra funzione, che converte i valori RGB in colori
1350 interni, la funzione @code{rgb-color}.  Prende tre argomenti
1351 che specificano l'intensità dei colori rosso, verde e blu.
1352 I valori vanno da 0 a 1.  Quindi per avere il colore rosso
1353 il valore sarà @code{(rgb-color 1 0 0)}
1354 e per avere il bianco sarà @code{(rgb-color 1 1 1)}:
1355
1356 @cindex BarLine, esempio di sovrascrittura
1357 @cindex proprietà color, esempio
1358 @cindex color, esempio
1359
1360 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1361 {
1362   \time 12/16
1363   \override Staff.BarLine.color = #(rgb-color 1 1 1)
1364   c4 b8 c d16 c d8 |
1365   g,8 a16 b8 c d4 e16 |
1366   e8
1367 }
1368 @end lilypond
1369
1370 Infine, è disponibile anche una scala di grigi, appartenente all'insieme
1371 di colori X11.  Questi vanno dal nero, @code{'grey0},
1372 al bianco, @code{'grey100}, con cadenza di 1.  Ecco un
1373 esempio in cui tutti gli oggetti di formattazione sono
1374 impostati su diverse tonalità di grigio:
1375
1376 @cindex StaffSymbol, esempio di sovrascrittura
1377 @cindex TimeSignature, esempio di sovrascrittura
1378 @cindex Clef, esempio di sovrascrittura
1379 @cindex NoteHead, esempio di sovrascrittura
1380 @cindex Stem, esempio di sovrascrittura
1381 @cindex BarLine, esempio di sovrascrittura
1382 @cindex proprietà color, esempio
1383 @cindex color, esempio
1384 @cindex x11-color, esempio di utilizzo
1385
1386 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1387 {
1388   \time 12/16
1389   \override Staff.StaffSymbol.color = #(x11-color 'grey30)
1390   \override Staff.TimeSignature.color = #(x11-color 'grey60)
1391   \override Staff.Clef.color = #(x11-color 'grey60)
1392   \override Voice.NoteHead.color = #(x11-color 'grey85)
1393   \override Voice.Stem.color = #(x11-color 'grey85)
1394   \override Staff.BarLine.color = #(x11-color 'grey10)
1395   c4 b8 c d16 c d8 |
1396   g,8 a16 b8 c d4 e16 |
1397   e8
1398 }
1399 @end lilypond
1400
1401 @noindent
1402 Nota i contesti associati a ciascuno degli oggetti di formattazione.
1403 È importante scegliere quelli giusti, altrimenti i comandi non
1404 funzioneranno!  Ricorda, il contesto è quello in cui si trova il
1405 relativo incisore.  Il contesto predefinito per gli incisori si trova
1406 partendo dall'oggetto di formattazione (@emph{layout object}) per poi
1407 andare all'incisore che lo produce: la pagina dell'incisore nella
1408 guida al Funzionamento interno riporterà a quale contesto
1409 appartenga di norma l'incisore.
1410
1411
1412 @node Dimensione degli oggetti
1413 @subsection Dimensione degli oggetti
1414 @translationof Size of objects
1415
1416 @cindex modificare la dimensione degli oggetti
1417 @cindex dimensione degli oggetti
1418 @cindex oggetti, dimensione degli
1419 @cindex oggetti, modificare la dimensione degli
1420
1421 Iniziamo rivedendo l'esempio precedente (vedi
1422 @ref{Nesting music expressions}) che mostrava come
1423 inserire un nuovo rigo temporaneo, come in un @rglos{ossia}.
1424
1425 @cindex proprietà alignAboveContext, esempio
1426 @cindex @code{\with}, esempio
1427
1428 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1429 \new Staff ="main" {
1430   \relative g' {
1431     r4 g8 g c4 c8 d |
1432     e4 r8
1433     <<
1434       { f8 c c }
1435       \new Staff \with {
1436         alignAboveContext = #"main" }
1437       { f8 f c }
1438     >>
1439     r4 |
1440   }
1441 }
1442 @end lilypond
1443
1444 Gli ossia di norma vengono scritti senza chiave e senza indicazione di
1445 tempo e hanno solitamente una dimensione leggermente inferiore a
1446 quella del rigo pricipale.  Sappiamo già come togliere la chiave e
1447 il segno di tempo, cioè impostando semplicemente la proprietà stencil di
1448 ciascun oggetto su @code{#f}, così:
1449
1450 @cindex proprietà alignAboveContext, esempio
1451 @cindex @code{\with}, esempio
1452 @funindex \omit
1453 @cindex Clef, esempio di sovrascrittura
1454 @cindex TimeSignature, esempio di sovrascrittura
1455
1456 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1457 \new Staff ="main" {
1458   \relative g' {
1459     r4 g8 g c4 c8 d |
1460     e4 r8
1461     <<
1462       { f8 c c }
1463       \new Staff \with {
1464         alignAboveContext = #"main"
1465       }
1466       {
1467         \omit Staff.Clef
1468         \omit Staff.TimeSignature
1469         { f8 f c }
1470       }
1471     >>
1472     r4 |
1473   }
1474 }
1475 @end lilypond
1476
1477 @noindent
1478 dove l'ulteriore coppia di parentesi dopo il blocco @code{\with} è
1479 necessaria perché le sovrascritture e la musica racchiusi
1480 siano applicati al rigo dell'ossia.
1481
1482 Ma qual è la differenza tra modificare il contesto del rigo con
1483 @code{\with} e modificare la proprietà stencil della chiave e
1484 del segno di tempo con @code{\override} o in questo caso @code{\omit}?  La
1485 principale differenza è che le modifiche inserite in un blocco @code{\with}
1486 vengono applicate nel momento in cui viene creato il contesto e permangono
1487 come valori @strong{predefiniti} per la durata di quel contesto, mentre i
1488 comandi @code{\set} o @code{\override} incorporati nel blocco
1489 della musica sono dinamici -- le loro modifiche sono sincronizzate
1490 con un punto preciso della musica.  Se le modifiche sono disattivate o
1491 ripristinate con @code{\unset} o @code{\revert} tornano ai valori
1492 stabiliti nel blocco @code{\with} o, in mancanza di impostazioni
1493 al suo interno, a quelli predefiniti.
1494
1495 Alcune proprietà di contesto possono essere modificate solo nei blocchi
1496 @code{\with}.  Si tratta di quelle proprietà che non si possono
1497 modificare in seguito alla creazione del contesto.  @code{alignAboveContext} e
1498 @code{alignBelowContext} sono due di esse: dopo la creazione
1499 del rigo il suo allineamento è fissato, e non ha
1500 senso tentare di cambiarlo successivamente.
1501
1502 I valori predefiniti delle proprietà degli oggetti di formattazione possono
1503 essere definiti anche nei blocchi @code{\with}.  Basta usare il normale comando
1504 @code{\override} senza specificare il nome del contesto, dato che questo è
1505 definito senza ambiguità come il contesto che il blocco @code{\with} sta
1506 modificando.  Anzi, viene generato un errore se si specifica un contesto
1507 in questa situazione.
1508
1509 Dunque possiamo sostituire l'esempio precedente con
1510
1511 @cindex alignAboveContext property, esempio
1512 @cindex @code{\with}, esempio
1513 @cindex Clef, esempio di sovrascrittura
1514 @cindex TimeSignature, esempio di sovrascrittura
1515
1516 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1517 \new Staff ="main" {
1518   \relative g' {
1519     r4 g8 g c4 c8 d |
1520     e4 r8
1521     <<
1522       { f8 c c }
1523       \new Staff \with {
1524         alignAboveContext = #"main"
1525         % Nasconde le chiavi di questo rigo
1526         \override Clef.stencil = ##f
1527         % Nasconde le indicazioni di tempo di questo rigo
1528         \override TimeSignature.stencil = ##f
1529       }
1530       { f8 f c }
1531     >>
1532     r4 |
1533   }
1534 }
1535 @end lilypond
1536
1537 Si possono usare anche le scorciatoie @code{\hide} e @code{\omit} per
1538 impostare la proprietà @code{transparent} e togliere lo @code{stencil}
1539
1540 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1541 \new Staff ="main" {
1542   \relative g' {
1543     r4 g8 g c4 c8 d |
1544     e4 r8
1545     <<
1546       { f8 c c }
1547       \new Staff \with {
1548         alignAboveContext = #"main"
1549         % Nasconde le chiavi di questo rigo
1550         \omit Clef
1551         % Nasconde le indicazioni di tempo di questo rigo
1552         \omit TimeSignature
1553       }
1554       { f8 f c }
1555     >>
1556     r4 |
1557   }
1558 }
1559 @end lilypond
1560
1561 Infine arriviamo a modificare la dimensione degli oggetti di formattazione.
1562
1563 Alcuni oggetti di formattazione sono dei glifi scelti da un tipo di
1564 carattere.  Ad esempio le teste di nota, le alterazioni, le annotazioni,
1565 le chiavi, le indicazioni di tempo, le dinamiche, il testo vocale.  La loro dimensione
1566 varia se si modifica la proprietà @code{font-size}, come vedremo a
1567 breve.  Altri oggetti di formattazione come le legature di portamento e
1568 di valore -- in generale, tutti gli oggetti estensori (@emph{spanner}) -- vengono
1569 disegnati individualmente, dunque non esiste un @code{font-size} a loro
1570 associato.  Questi oggetti generalmente derivano la loro dimensione dagli
1571 oggetti a cui sono connessi, quindi di solito non è necessario modificare
1572 la loro dimensione a mano.  Altre proprietà, come la lunghezza dei gambi
1573 e delle stanghette, lo spessore delle travature e di altre linee e la
1574 separazione delle linee del rigo, devono essere modificate in modi speciali.
1575
1576 Tornando all'esempio dell'ossia, proviamo prima a cambiare font-size.
1577 Possiamo farlo in due modi.  Possiamo modificare la dimensione dei
1578 tipi di carattere di ogni tipo di oggetto, come le teste di nota
1579 (@code{NoteHead}) con un comando di questo tipo
1580
1581 @example
1582 \override NoteHead.font-size = #-2
1583 @end example
1584
1585 oppure possiamo modificare la dimensione di tutti i tipi di carattere usando
1586 una proprietà speciale, @code{fontSize}, con @code{\set} oppure includendola
1587 in un blocco @code{\with} (ma senza @code{\set}).
1588
1589 @example
1590 \set fontSize = #-2
1591 @end example
1592
1593 Entrambe queste dichiarazioni fanno sì che la dimensione del tipo di carattere
1594 sia ridotta di due unità rispetto al valore precedente, dove ogni unità
1595 riduce o aumenta la dimensione di circa il 12%.
1596
1597 Proviamolo nel nostro esempio dell'ossia:
1598
1599 @cindex alignAboveContext property, esempio
1600 @cindex @code{\with}, esempio
1601 @cindex Clef, esempio di sovrascrittura
1602 @cindex TimeSignature, esempio di sovrascrittura
1603 @cindex proprietà fontSize, esempio
1604 @cindex fontSize, esempio
1605
1606 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1607 \new Staff ="main" {
1608   \relative g' {
1609     r4 g8 g c4 c8 d |
1610     e4 r8
1611     <<
1612       { f8 c c }
1613       \new Staff \with {
1614         alignAboveContext = #"main"
1615         \omit Clef
1616         \omit TimeSignature
1617         % Riduce la dimensione di tutti i tipi di carattere di circa il 24%
1618         fontSize = #-2
1619       }
1620       { f8 f c }
1621     >>
1622     r4 |
1623   }
1624 }
1625 @end lilypond
1626
1627 L'esempio non è ancora a posto.  Le teste di nota e  le code sono
1628 più piccole, ma in proporzione i gambi sono troppo lunghi e le linee
1629 del rigo sono troppo separate.  Dovrebbero essere scalati in proporzione
1630 alla riduzione del tipo di carattere.  La prossima sezione spiega come
1631 farlo.
1632
1633 @node Lunghezza e spessore degli oggetti
1634 @subsection Lunghezza e spessore degli oggetti
1635 @translationof Length and thickness of objects
1636
1637 @cindex distanze
1638 @cindex thickness, proprietà
1639 @cindex spessore
1640 @cindex lunghezza
1641 @cindex magstep
1642 @cindex dimensione, modificare la
1643 @cindex lunghezza del gambo, modificare la
1644 @cindex spaziatura delle linee del rigo, modificare la
1645
1646 Distanze e lunghezze in LilyPond sono misurate generalmente in @code{staff-space},
1647 ovvero la distanza tra linee adiacenti del rigo (o talvolta la metà di uno
1648 spazio rigo), mentre gran parte delle proprietà che controllano lo spessore
1649 (@code{thickness}) sono misurate con l'unità di misura di una proprietà
1650 interna chiamata @code{line-thickness.}  Ad esempio, lo spessore predefinito
1651 delle linee delle forcine è di 1 unità di @code{line-thickness},
1652 mentre lo spessore (@code{thickness}) di un gambo di nota è 1.3.  Si noti
1653 che alcune proprietà dello spessore sono diverse; per esempio, lo spessore
1654 delle travature è controllato dal valore della proprietà @code{beam-thickness},
1655 che si misura in @code{staff-space}.
1656
1657 Dunque come si possono scalare le lunghezze in proporzione alla
1658 dimensione del carattere?
1659 È possibile ricorrendo a una funzione speciale chiamata
1660 @code{magstep}, che serve proprio a questo scopo.  Prende un
1661 argomento, la modifica della dimensione del tipo di carattere (#-2
1662 nell'esempio precedente) e restituisce un fattore di ridimensionamento
1663 adatto a ridurre gli altri oggetti proporzionalmente.  Si usa in
1664 questo modo:
1665
1666 @cindex proprietà alignAboveContext, esempio
1667 @cindex alignAboveContext, esempio
1668 @cindex @code{\with}, esempio
1669 @cindex Clef, esempio di sovrascrittura
1670 @cindex TimeSignature, esempio di sovrascrittura
1671 @cindex proprietà fontSize, esempio
1672 @cindex fontSize, esempio
1673 @cindex StaffSymbol, esempio di sovrascrittura
1674 @cindex funzione magstep, esempio di uso
1675 @cindex magstep, esempio di uso
1676 @cindex proprietà staff-space, esempio
1677 @cindex staff-space, esempio
1678 @cindex proprietà stencil, esempio
1679 @cindex stencil, esempio
1680
1681 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1682 \new Staff ="main" {
1683   \relative g' {
1684     r4 g8 g c4 c8 d |
1685     e4 r8
1686     <<
1687       { f8 c c }
1688       \new Staff \with {
1689         alignAboveContext = #"main"
1690         \omit Clef
1691         \omit TimeSignature
1692         fontSize = #-2
1693         % Riduce proporzionalmente la lunghezza dei gambi e la spaziatura tra le linee
1694         \override StaffSymbol.staff-space = #(magstep -2)
1695       }
1696       { f8 f c }
1697     >>
1698     r4 |
1699   }
1700 }
1701 @end lilypond
1702
1703 @noindent
1704 Dato che la lunghezza dei gambi e molte altre proprietà relative alla
1705 lunghezza sono sempre calcolate in relazione al valore della proprietà
1706 @code{staff-space}, anche queste sono automaticamente ridimensionate
1707 in lunghezza.  Nota che ciò riguarda solo la scala verticale
1708 dell'ossia -- la scala orizzontale è determinata dalla formattazione
1709 della musica principale perché deve restare sincronizzata con quest'ultima,
1710 quindi le modifiche di dimensione non la riguardano.  Ovviamente, se
1711 la scala di tutta la musica principale venisse cambiata allora la
1712 spaziatura orizzontale cambierebbe.  Tratteremo questo argomento più
1713 avanti, nella parte relativa alla formattazione.
1714
1715 Questo completa la creazione dell'ossia.  Le dimensioni e le lunghezze
1716 di tutti gli altri oggetti possono essere modificati in modi analoghi.
1717
1718 Per piccole modifiche della dimensione, come nell'esempio precedente, non
1719 sono necessari solitamente degli aggiustamenti globali dello spessore delle
1720 varie linee disegnate (come stanghette, travature, forcine, legature di
1721 portamento, etc.).  Se si deve aggiustare lo spessore di un
1722 particolare oggetto di formattazione, è meglio sovrascrivere la sua
1723 proprietà @code{thickness}.  Un esempio di come modificare lo spessore
1724 delle legature di portamento è stato mostrato prima in @ref{Properties of layout objects}.
1725 Lo spessore di tutti gli oggetti disegnati (ovvero quelli non prodotti
1726 da un tipo di carattere) può essere cambiato nello stesso modo.
1727
1728
1729 @node Posizionamento degli oggetti
1730 @section Posizionamento degli oggetti
1731 @translationof Placement of objects
1732
1733 @menu
1734 * Comportamento automatico::
1735 * Oggetti interni al rigo::
1736 * Oggetti esterni al rigo::
1737 @end menu
1738
1739
1740 @node Comportamento automatico
1741 @subsection Comportamento automatico
1742 @translationof Automatic behavior
1743
1744 @cindex within-staff, oggetti
1745 @cindex outside-staff, oggetti
1746 @cindex oggetti dentro il rigo
1747 @cindex oggetti fuori dal rigo
1748
1749 Nella notazione musicale, alcuni oggetti appartengono al rigo, altri
1750 devono esserne posizionati al di fuori.  In LilyPond si chiamano rispettivamente oggetti within-staff
1751 (dentro il rigo) e oggetti outside-staff (fuori dal rigo).
1752
1753 Gli oggetti within-staff sono quelli che si trovano nel rigo, come
1754 le teste e i gambi delle note, le alterazioni, etc@dots{}  La loro posizione
1755 è determinata perlopiù dalla musica stessa: in verticale sono collocati
1756 su determinate posizioni del rigo o sono collegati
1757 ad altri oggetti disposti in questo modo. Di norma LilyPond evita
1758 automaticamente le collisioni tra teste di nota, gambi e alterazioni
1759 in accordi con note ravvicinate.  Esistono comunque dei comandi che
1760 permettono di modificare questo comportamento automatico, come
1761 vedremo tra poco.
1762
1763 Gli oggetti che appartengono allo spazio fuori dal rigo comprendono
1764 gli andamenti, i numeri di chiamata, il testo vocale, le indicazioni dinamiche. Il comportamento di
1765 LilyPond per il posizionamento verticale degli oggetti outside-staff
1766 prevede che questi vengano collocati il più vicino possibile al rigo, mantenendo
1767 però una distanza sufficiente da evitare collisioni con gli altri oggetti.  LilyPond
1768 usa la proprietà @code{outside-staff-priority} per determinare in quale ordine
1769 gli oggetti siano posizionati.
1770
1771 Per prima cosa LilyPond posiziona tutti gli oggetti within-staff.
1772 Poi ordina gli oggetti outside-staff in base alla loro proprietà
1773 @code{outside-staff-priority}.  Gli oggetti outside-staff vengono
1774 considerati uno a uno, a partire dall'oggetto che ha il valore più basso
1775 di priorità (@code{outside-staff-priority}), e disposti in modo
1776 da non entrare in collisione con alcun oggetto già posizionato.
1777 Questo significa che se due oggetti outside-staff si contendono lo
1778 stesso spazio, quello col valore più basso di @code{outside-staff-priority}
1779 sarà più vicino al rigo.  Se due oggetti presentano lo stesso valore per
1780 @code{outside-staff-priority}, quello incontrato per primo viene posizionato
1781 più vicino al rigo.
1782
1783 Nell'esempio seguente tutti i testi hanno la stessa priorità (perché
1784 questa non è impostata in modo esplicito).  Come puoi vedere, @q{Testo3}
1785 è di nuovo posto automaticamente in prossimità del rigo, infilato
1786 sotto @q{Testo2}.
1787
1788 @cindex markup, esempio
1789
1790 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1791 c2^"Testo1"
1792 c2^"Testo2" |
1793 c2^"Testo3"
1794 c2^"Testo4" |
1795 @end lilypond
1796
1797 Di norma, anche i righi sono collocati quanto più possibile ravvicinati
1798 (ma con una distanza minima).  Se delle note si estenderanno molto
1799 al di fuori del rigo, fino a quello adiacente, costringeranno i righi a distanziarsi
1800 solo in caso di sovrapposizione degli elementi della notazione.  L'esempio
1801 seguente mostra questo @q{annidamento} delle note su righi adiacenti:
1802
1803 @lilypond[quote,ragged-right,verbatim]
1804 <<
1805   \new Staff {
1806     \relative c' { c4 a, }
1807   }
1808   \new Staff {
1809     \relative c'''' { c4 a, }
1810   }
1811 >>
1812 @end lilypond
1813
1814
1815 @node Oggetti interni al rigo
1816 @subsection Oggetti interni al rigo
1817 @translationof Within-staff objects
1818
1819 Abbiamo già visto come i comandi @code{\voiceXXX} influenzino
1820 la direzione di legature di portamento e di valore, delle diteggiature e
1821 di qualsiasi altro elemento che dipenda dalla direzione dei gambi (vedi
1822 @ref{Explicitly instantiating voices}).
1823 Questi comandi sono fondamentali quando si scrive musica polifonica,
1824 perché permettono di distinguere le linee melodiche che si intrecciano.
1825 Talvolta, però, capita di voler modificare questo comportamento
1826 automatico.  Si può fare per intere sezioni musicali o anche per
1827 una singola nota.  La proprietà che controlla questo comportamento
1828 è la proprietà @code{direction} di ogni oggetto di formattazione.
1829 Spieghiamo prima che cosa fa e poi presentiamo alcuni comandi
1830 già pronti, che ti eviteranno di dover scrivere sovrascritture
1831 esplicite per le modifiche più comuni.
1832
1833 Alcuni oggetti di formattazione, come le legature di portamento e di
1834 valore, si incurvano, si piegano o puntano verso l'alto o il basso; altri,
1835 come i gambi e le code, a seconda dell'orientamento si dispongono anche sulla
1836 destra o sulla sinistra.  Tutto questo viene controllato automaticamente
1837 quando si imposta la proprietà @code{direction}.
1838
1839 @menu
1840 * La proprietà direction::
1841 * Diteggiatura::
1842 @end menu
1843
1844 @node La proprietà direction
1845 @unnumberedsubsubsec La proprietà @code{direction}
1846 @translationof The direction property
1847
1848 @cindex down
1849 @cindex direzione, giù
1850 @cindex up
1851 @cindex direzione, su
1852 @cindex center
1853 @cindex direzione, centrale
1854 @cindex neutral
1855 @cindex direzione, neutrale
1856
1857 L'esempio seguente mostra nella prima battuta il comportamento predefinito
1858 dei gambi, per cui i gambi delle note superiori puntano in basso e quelli delle
1859 note inferiori in alto; poi seguono quattro note con tutti i gambi
1860 forzati verso il basso, quattro con i gambi forzati verso l'alto e, infine, quattro
1861 con i gambi nuovamente disposti secondo il comportamento predefinito.
1862
1863 @cindex Stem, esempio di sovrascrittura
1864 @cindex proprietà direction, esempio
1865 @cindex direction, esempio
1866
1867 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1868 a4 g c a |
1869 \override Stem.direction = #DOWN
1870 a4 g c a |
1871 \override Stem.direction = #UP
1872 a4 g c a |
1873 \revert Stem.direction
1874 a4 g c a |
1875 @end lilypond
1876
1877 Abbiamo usato le costanti @code{DOWN} (giù) e @code{UP} (su).
1878 Queste hanno rispettivamente i valori @w{@code{-1}} e @code{+1}, ed
1879 è possibile usare tali valori numerici al loro posto.  In alcuni casi
1880 si può usare anche il valore @code{0}, che significa @code{UP} per i
1881 gambi, ma per alcuni oggetti significa @q{center} (centro).
1882 Esiste una costante, @code{CENTER} che ha valore @code{0}.
1883
1884 Tuttavia queste sovrascritture esplicite solitamente non vengono usate, perché
1885 ci sono dei comandi predefiniti equivalenti e più semplici.  Ecco una tabella
1886 con quelli più utilizzati; il significato di ognuno è esplicitato laddove
1887 non è ovvio.
1888
1889 @multitable @columnfractions .2 .2 .25 .35
1890 @headitem Giù/Sinistra
1891   @tab Su/Destra
1892   @tab Ripristina
1893   @tab Effetto
1894 @item @code{\arpeggioArrowDown}
1895   @tab @code{\arpeggioArrowUp}
1896   @tab @code{\arpeggioNormal}
1897   @tab Aggiunge una freccia in fondo, in cima o toglie la freccia
1898 @item @code{\dotsDown}
1899   @tab @code{\dotsUp}
1900   @tab @code{\dotsNeutral}
1901   @tab Direzione dello spostamento per evitare le linee del rigo
1902 @item @code{\dynamicDown}
1903   @tab @code{\dynamicUp}
1904   @tab @code{\dynamicNeutral}
1905   @tab
1906 @item @code{\phrasingSlurDown}
1907   @tab @code{\phrasingSlurUp}
1908   @tab @code{\phrasingSlurNeutral}
1909   @tab Nota: è diverso dai comandi slur
1910 @item @code{\slurDown}
1911   @tab @code{\slurUp}
1912   @tab @code{\slurNeutral}
1913   @tab
1914 @item @code{\stemDown}
1915   @tab @code{\stemUp}
1916   @tab @code{\stemNeutral}
1917   @tab
1918 @item @code{\textSpannerDown}
1919   @tab @code{\textSpannerUp}
1920   @tab @code{\textSpannerNeutral}
1921   @tab Il testo inserito come oggetto estensore (spanner) va sotto/sopra il rigo
1922 @item @code{\tieDown}
1923   @tab @code{\tieUp}
1924   @tab @code{\tieNeutral}
1925   @tab
1926 @item @code{\tupletDown}
1927   @tab @code{\tupletUp}
1928   @tab @code{\tupletNeutral}
1929   @tab I gruppi irregolare sono sotto/sopra le note
1930 @end multitable
1931
1932
1933 Le varianti neutral/normal di questi comandi usano @code{\revert} e quindi
1934 @strong{non} possono essere precedute da @code{\once}.  Se desideri limitare
1935 l'effetto degli altri comandi (che usano @code{\override}) a un singolo
1936 momento temporale, devi farli precedere da @code{\once} come faresti con
1937 delle sovrascritture esplicite.
1938
1939
1940 @node Diteggiatura
1941 @unnumberedsubsubsec Diteggiatura
1942 @translationof Fingering
1943
1944 @cindex diteggiatura, posizionamento
1945 @cindex diteggiatura, accordi
1946
1947 Anche il posizionamento della diteggiatura sulle singole note può essere
1948 controllato dalla proprietà @code{direction}, ma la modifica di @code{direction}
1949 non produce effetti sugli accordi.  Come vedremo, ci sono comandi specifici
1950 che permettono di controllare la diteggiatura delle singole note degli
1951 accordi, col segno di diteggiatura posizionato sopra, sotto, a sinistra
1952 o a destra di ogni nota.
1953
1954 Vediamo innanzitutto l'effetto di @code{direction} sulla diteggiatura
1955 attaccata alle singole note.  La prima battuta mostra il comportamento
1956 predefinito e le due battute successive mostrano gli effetti dei valori
1957 @code{DOWN} e @code{UP}:
1958
1959 @cindex Fingering, esempio di sovrascrittura
1960 @cindex proprietà direction, esempio
1961 @cindex direction, esempio
1962
1963 @lilypond[quote,verbatim,relative=2]
1964 c4-5 a-3 f-1 c'-5 |
1965 \override Fingering.direction = #DOWN
1966 c4-5 a-3 f-1 c'-5 |
1967 \override Fingering.direction = #UP
1968 c4-5 a-3 f-1 c'-5 |
1969 @end lilypond
1970
1971 Tuttavia sovrascrivere la proprietà @code{direction} non è il modo
1972 più semplice di definire a mano la diteggiatura sopra o sotto
1973 le note; di solito è preferibile usare @code{_} o @code{^} invece di @code{-}
1974 prima del numero della diteggiatura.  Ecco l'esempio precedente riscritto
1975 usando questo metodo:
1976
1977 @cindex fingering, esempio
1978
1979 @lilypond[quote,verbatim,relative=2]
1980 c4-5 a-3 f-1 c'-5 |
1981 c4_5 a_3 f_1 c'_5 |
1982 c4^5 a^3 f^1 c'^5 |
1983 @end lilypond
1984
1985 La proprietà @code{direction} viene ignorata negli accordi, ma i
1986 prefissi direzionali, @code{_} e @code{^} funzionano.  Per impostazione
1987 predefinita, la diteggiatura viene disposta automaticamente sopra e
1988 sotto le note di un accordo:
1989
1990 @cindex fingering, esempio
1991
1992 @lilypond[quote,verbatim,relative=2]
1993 <c-5 g-3>4
1994 <c-5 g-3 e-2>4
1995 <c-5 g-3 e-2 c-1>4
1996 @end lilypond
1997
1998 @noindent
1999 ma può essere sovrascritta per forzare manualmente in su o in giù tutti o
2000 alcuni dei singoli numeri della diteggiatura:
2001
2002 @cindex fingering, esempio
2003
2004 @lilypond[quote,verbatim,relative=2]
2005 <c-5 g-3 e-2 c-1>4
2006 <c^5 g_3 e_2 c_1>4
2007 <c^5 g^3 e^2 c_1>4
2008 @end lilypond
2009
2010 È possibile avere un controllo ancora maggiore sulla disposizione della
2011 diteggiatura delle singole note di un accordo usando il comando
2012 @code{\set fingeringOrientations}.  Il formato di questo comando è:
2013
2014 @example
2015 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
2016 @end example
2017
2018 @noindent
2019 Si usa @code{\set} perché @code{fingeringOrientations} è una
2020 proprietà del contesto @code{Voice}, creato e usato dall'incisore
2021 @code{New_fingering_engraver}.
2022
2023 Questa proprietà accetta come valori una lista comprendente da uno a tre elementi.
2024 Stabilisce se la diteggiatura debba essere posizionata sopra (se nella
2025 lista c'è @code{up}), sotto (se c'è @code{down}), a sinistra (se c'è
2026 @code{left}) o a destra (se c'è @code{right}).  Nel caso vengano inseriti valori
2027 non accettati dalla lista, non sarà invece collocata alcuna diteggiatura.  LilyPond
2028 prende in considerazione questi limiti e trova la migliore disposizione per
2029 la diteggiatura delle note degli accordi che seguono.  Nota che @code{left} e
2030 @code{right} si escludono a vicenda -- la diteggiatura può essere posta
2031 solo da un lato o dall'altro, non da entrambi.
2032
2033 @warning{Per controllare la posizione della diteggiatura di una
2034 singola nota con questo comando bisogna scrivere la nota come un accordo
2035 con una nota sola, ovvero racchiuderla tra parentesi angolari.}
2036
2037 Ecco alcuni esempi:
2038
2039 @cindex fingering, esempio
2040 @cindex @code{\set}, esempio di utilizzo
2041 @cindex proprietà fingeringOrientations, esempio
2042
2043 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2044 \set fingeringOrientations = #'(left)
2045 <f-2>4
2046 <c-1 e-2 g-3 b-5>4
2047 \set fingeringOrientations = #'(left)
2048 <f-2>4
2049 <c-1 e-2 g-3 b-5>4 |
2050 \set fingeringOrientations = #'(up left down)
2051 <f-2>4
2052 <c-1 e-2 g-3 b-5>4
2053 \set fingeringOrientations = #'(up left)
2054 <f-2>4
2055 <c-1 e-2 g-3 b-5>4 |
2056 \set fingeringOrientations = #'(right)
2057 <f-2>4
2058 <c-1 e-2 g-3 b-5>4
2059 @end lilypond
2060
2061 @noindent
2062 Se la diteggiatura appare eccessivamente fitta, si può ridurre la dimensione del
2063 tipo di carattere modificando la proprietà @code{font-size}.  Si può vedere
2064 nell'oggetto @code{Fingering} della guida al Funzionamento interno che il
2065 valore predefinito di tale proprietà è @w{@code{-5}}, dunque proviamo
2066 con @w{@code{-7}}:
2067
2068 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2069 \override Fingering.font-size = #-7
2070 \set fingeringOrientations = #'(left)
2071 <f-2>4
2072 <c-1 e-2 g-3 b-5>4
2073 \set fingeringOrientations = #'(left)
2074 <f-2>4
2075 <c-1 e-2 g-3 b-5>4 |
2076 \set fingeringOrientations = #'(up left down)
2077 <f-2>4
2078 <c-1 e-2 g-3 b-5>4
2079 \set fingeringOrientations = #'(up left)
2080 <f-2>4
2081 <c-1 e-2 g-3 b-5>4 |
2082 \set fingeringOrientations = #'(right)
2083 <f-2>4
2084 <c-1 e-2 g-3 b-5>4
2085 @end lilypond
2086
2087 @node Oggetti esterni al rigo
2088 @subsection Oggetti esterni al rigo
2089 @translationof Outside-staff objects
2090
2091 Gli oggetti esterni al rigo sono disposti automaticamente in modo da evitare
2092 collisioni.  Ci sono vari modi per modificare la disposizione automatica
2093 se questa non è ottimale.
2094
2095 @menu
2096 * La proprietà outside-staff-priority::
2097 * Il comando textLengthOn::
2098 * Posizionamento delle dinamiche::
2099 * Dimensione dei grob::
2100 @end menu
2101
2102
2103 @node La proprietà outside-staff-priority
2104 @unnumberedsubsubsec La proprietà @code{outside-staff-priority}
2105 @translationof The outside-staff-priority property
2106
2107 Gli oggetti dai valori più bassi per la proprietà
2108 @code{outside-staff-priority} vengono posizionati più vicino al rigo,
2109 mentre gli altri oggetti esterni al rigo vengono distanziati quanto
2110 basta per evitare collisioni.  La proprietà @code{outside-staff-priority} è
2111 definita nell'interfaccia @code{grob-interface} ed è quindi una proprietà di
2112 tutti gli oggetti di formattazione.  Il valore predefinito è @code{#f} per
2113 tutti gli oggetti interni al rigo e un valore numerico appropriato, determinato
2114 al momento della creazione dell'oggetto, per ogni oggetto esterno al rigo.  La
2115 seguente tabella mostra i valori numerici predefiniti di alcuni dei più comuni
2116 oggetti esterni al rigo.
2117
2118 @cindex estensori (spanner)
2119 @cindex spanner
2120
2121 Si notino i nomi insoliti di alcuni oggetti: gli oggetti estensori (spanner)
2122 sono creati automaticamente per controllare la disposizione verticale dei
2123 grob che (potrebbero) iniziare e finire in diversi momenti musicali, quindi
2124 la modifica della proprietà @code{outside-staff-priority} del grob sottostante
2125 non produrrebbe alcun effetto.  Ad esempio, la modifica di
2126 @code{outside-staff-priority} dell'oggetto @code{Hairpin} non avrà alcun
2127 effetto sulla disposizione verticale delle forcelle.  Occorre invece modificare
2128 la proprietà @code{outside-staff-priority} dell'oggetto associato
2129 @code{DynamicLineSpanner}.  Questa sovrascrittura deve essere posta
2130 all'inizio dell'estensore, che potrebbe includere più forcelle e indicazioni dinamiche
2131 tra loro collegate.
2132
2133 @multitable @columnfractions .3 .3 .3
2134 @headitem Oggetto di formattazione
2135   @tab Priorità
2136   @tab Controlla la posizione di:
2137 @item @code{RehearsalMark}
2138   @tab @code{1500}
2139   @tab Numeri di chiamata (e oggetti di testo analoghi)
2140 @item @code{MetronomeMark}
2141   @tab @code{1000}
2142   @tab Indicazioni metronomiche
2143 @item @code{VoltaBracketSpanner}
2144   @tab @code{600}
2145   @tab Delimitatori dei finali alternativi delle ripetizioni
2146 @item @code{TextScript}
2147   @tab @code{450}
2148   @tab Oggetti di testo
2149 @item @code{MultiMeasureRestText}
2150   @tab @code{450}
2151   @tab Testi sopra pause di più misure
2152 @item @code{OttavaBracket}
2153   @tab @code{400}
2154   @tab Estensioni del segno d'ottava
2155 @item @code{TextSpanner}
2156   @tab @code{350}
2157   @tab Estensori del testo
2158 @item @code{DynamicLineSpanner}
2159   @tab @code{250}
2160   @tab Tutte le indicazioni dinamiche
2161 @item @code{BarNumber}
2162   @tab @code{ 100}
2163   @tab Numeri di battuta
2164 @item @code{TrillSpanner}
2165   @tab @code{50}
2166   @tab Linee ondulate del trillo
2167 @end multitable
2168
2169 Ecco un esempio che mostra il posizionamento predefinito di alcuni di
2170 questi oggetti.
2171
2172 @cindex estensore del testo
2173 @cindex segno del cambio d'ottava
2174
2175 @funindex \startTextSpan
2176 @funindex startTextSpan
2177 @funindex \stopTextSpan
2178 @funindex stopTextSpan
2179
2180 @cindex TextSpanner, esempio di sovrascrittura
2181 @cindex proprietà bound-details, esempio
2182 @cindex bound-details, esempio
2183
2184 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2185 % Set details for later Text Spanner
2186 \override TextSpanner.bound-details.left.text
2187     = \markup { \small \bold Slower }
2188 % Place dynamics above staff
2189 \dynamicUp
2190 % Start Ottava Bracket
2191 \ottava #1
2192 c'4 \startTextSpan
2193 % Add Dynamic Text and hairpin
2194 c4\pp\<
2195 c4
2196 % Add Text Script
2197 c4^Text |
2198 c4 c
2199 % Add Dynamic Text and terminate hairpin
2200 c4\ff c \stopTextSpan |
2201 % Stop Ottava Bracket
2202 \ottava #0
2203 c,4 c c c |
2204 @end lilypond
2205
2206 Questo esempio mostra anche come creare gli estensori (spanner) del testo,
2207 ovvero testo con delle linee che si estendono sopra una sezione musicale.
2208 L'estensore si allunga dal comando @code{\startTextSpan} fino al comando
2209 @code{\stopTextSpan} e il formato del testo è definito dal comando
2210 @code{\override TextSpanner}.  Per maggiori dettagli si veda @ruser{Text spanners}.
2211
2212 Mostra anche come si creano le estensioni del segno d'ottava.
2213
2214 @cindex modificare il posizionamento del numero di battuta
2215 @cindex numeri di battuta, modificare il posizionamento
2216 @cindex modificare il posizionamento dell'indicazione metronomica
2217 @cindex indicazione metronomica, modificare il posizionamento
2218 @cindex modificare il posizionamento dei numeri di chiamata
2219 @cindex numeri di chiamata, modificare il posizionamento
2220
2221 Se i valori predefiniti di @code{outside-staff-priority} non producono
2222 il posizionamento desiderato, è possibile sovrascrivere la priorità di
2223 qualsiasi oggetto.  Immaginiamo di voler posizionare l'estensione del segno d'ottava
2224 sotto l'estensore del testo nell'esempio precedente.  Basta controllare la
2225 priorità dell'oggetto @code{OttavaBracket} nella guida al Funzionamento interno
2226 o nelle tabelle precedenti e ridurla a un valore inferiore di quello di un
2227 oggetto @code{TextSpanner}, ricordando che @code{OttavaBracket} è creato
2228 nel contesto @code{Staff}:
2229
2230 @cindex TextSpanner, esempio di sovrascrittura
2231 @cindex proprietà bound-details, esempio
2232 @cindex bound-details, esempio
2233
2234 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2235 % Imposta i dettagli per l'estensione del testo vocale seguente
2236 \override TextSpanner.bound-details.left.text
2237     = \markup { \small \bold Slower }
2238 % Posiziona le indicazione dinamiche sopra il rigo
2239 \dynamicUp
2240 % Posiziona l'estensione del segno d'ottava sotto il testo vocale
2241 \once \override Staff.OttavaBracket.outside-staff-priority = #340
2242 % Inizia l'estensione del segno d'ottava
2243 \ottava #1
2244 c'4 \startTextSpan
2245 % Aggiunge l'indicazione dinamica
2246 c4\pp
2247 % Aggiunge la forcella della dinamica
2248 c4\<
2249 % Aggiunge l'oggetto di testo
2250 c4^Text |
2251 c4 c
2252 % Aggiunge l'indicazione dinamica
2253 c4\ff c \stopTextSpan |
2254 % Termina l'estensione de segno d'ottava
2255 \ottava #0
2256 c,4 c c c |
2257 @end lilypond
2258
2259 Si noti che alcuni di questi oggetti, in particolare i numeri di
2260 battuta, i segni di metronomo e i numeri di chiamata, si trovano nel
2261 contesto @code{Score}; dunque, assicurati di richiamare il contesto
2262 giusto per sovrascriverli.
2263
2264 @cindex legature di portamento e outside-staff-priority
2265 @cindex legature di portamento e articolazioni
2266 @cindex articolazioni e legature di portamento
2267
2268 Le legature di portamento sono classificate come oggetti interni al rigo, anche
2269 se spesso sono poste sopra il rigo, se le note alle quali sono collegate si
2270 trovano nella aprte superiore del pentagramma.  Questo può far sì che gli oggetti esterni al rigo,
2271 come le articolazioni, siano spinti troppo in alto, dato che la legatura viene
2272 posizionata prima.  La proprietà @code{avoid-slur} dell'articolazione
2273 può essere impostata su @code{'inside} per portare l'articolazione
2274 dentro la legatura, ma la proprietà @code{avoid-slur} funziona solo se anche
2275 @code{outside-staff-priority} è impostata su @code{#f}.
2276 Altrimenti, si può impostare la proprietà @code{outside-staff-priority} della
2277 legatura di portamento su un valore numerico, in modo che sia posizionata
2278 insieme ad altri oggetti esterni al rigo in base a quel valore.  Ecco un
2279 esempio che mostra l'effetto dei due metodi:
2280
2281 @lilypond[quote,verbatim,relative=2]
2282 c4( c^\markup { \tiny \sharp } d4.) c8 |
2283 c4(
2284 \once \override TextScript.avoid-slur = #'inside
2285 \once \override TextScript.outside-staff-priority = ##f
2286 c4^\markup { \tiny \sharp } d4.) c8 |
2287 \once \override Slur.outside-staff-priority = #500
2288 c4( c^\markup { \tiny \sharp } d4.) c8 |
2289 @end lilypond
2290
2291 Attraverso la proprietà @code{outside-staff-priority} si può
2292 regolare anche la disposizone verticale di singoli oggetti;
2293 i risultati potrebbero tuttavia risultare non sempre ottimali.  Supponiamo
2294 di voler posizionare @qq{Testo3} sopra @qq{Testo4} nell'esempio
2295 precedente (si veda @ref{Automatic behavior}).
2296 Basta andare a cercare la priorità di @code{TextScript} nella
2297 guida al Funzionamento interno o nelle tabelle precedenti e
2298 aumentare la priorità di @qq{Testo3} assegnando un valore più alto:
2299
2300 @cindex TextScript, esempio di sovrascrittura
2301 @cindex proprietà outside-staff-priority, esempio
2302 @cindex outside-staff-priority, esempio
2303
2304 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2305 c2^"Testo1"
2306 c2^"Testo2" |
2307 \once \override TextScript.outside-staff-priority = #500
2308 c2^"Testo3"
2309 c2^"Testo4" |
2310 @end lilypond
2311
2312 Questo ovviamente pone @qq{Testo3} sopra @qq{Testo4}, ma anche
2313 sopra @qq{Testo2}, mentre @qq{Testo4} si sposta più in basso.  Forse questo
2314 risultato non ci soddisfa:  vorremmo piuttosto collocare
2315 tutti i testi alla stessa distanza dal rigo.  Per riuscirci,
2316 naturalmente, dobbiamo creare più spazio orizzontale tra le note per
2317 far posto al testo.  Lo si può ottenere con il comando
2318 @code{textLengthOn}.
2319
2320 @node Il comando textLengthOn
2321 @unnumberedsubsubsec Il comando @code{@bs{}textLengthOn}
2322 @translationof The textLengthOn command
2323
2324 @cindex note, distanziarle insieme al testo
2325
2326 @funindex \textLengthOn
2327 @funindex textLengthOn
2328 @funindex \textLengthOff
2329 @funindex textLengthOff
2330
2331 Per impostazione predefinita, finché si tratta di formattare la musica il
2332 testo prodotto dal comando @code{\markup} non occupa uno spazio orizzontale.
2333 Il comando @code{\textLengthOn} inverte questo comportamento e fa sì che
2334 le note si distanzino quanto basti per introdurre il testo:
2335
2336 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2337 \textLengthOn  % Fa sì che le note si distanzino per introdurre il testo
2338 c2^"Text1"
2339 c2^"Text2" |
2340 c2^"Text3"
2341 c2^"Text4" |
2342 @end lilypond
2343
2344 Il comando che ripristina il comportamento predefinito è
2345 @code{\textLengthOff}.  Altrimenti si può usare @code{\once}
2346 con @code{\textLengthOn} se l'effetto deve essere limitato
2347 a un singolo momento musicale.
2348 Analogalmente, la spaziatura per i segni di chiamata e le indicazioni
2349 di tempo è regolata in modo indipendente con i comandi @code{\markLengthOn}
2350 e @code{\markLengthOff}.
2351
2352 @cindex testo a margine, permettere le collisioni
2353
2354 Per parte sua, anche il testo a margine eviterà le note che si estendono sopra il
2355 rigo.  Se lo si vuole evitare, la disposizione automatica in alto può
2356 essere disattivata impostando la priorità su @code{#f}.  Ecco un esempio
2357 che mostra come il testo a margine interagisce con tali note.
2358
2359 @cindex TextScript, esempio di sovrascrittura
2360 @cindex proprietà outside-staff-priority, esempio
2361 @cindex outside-staff-priority, esempio
2362
2363 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2364 % Questo testo è abbastanza corto per starci senza creare collisioni
2365 c2^"Tes" c'' |
2366 R1 |
2367
2368 % Questo è troppo lungo per starci, quindi è spostato più in alto
2369 c,,2^"Testo" c'' |
2370 R1 |
2371
2372 % Disattiva l'elusione delle collisioni
2373 \once \override TextScript.outside-staff-priority = ##f
2374 c,,2^"Testo Lungo   " c'' |
2375 R1 |
2376
2377 % Disattiva l'elusione delle collisioni
2378 \once \override TextScript.outside-staff-priority = ##f
2379 \textLengthOn        % e attiva textLengthOn
2380 c,,2^"Testo Lungo   "  % Gli spazi finali vengono rispettati
2381 c''2 |
2382 @end lilypond
2383
2384
2385 @node Posizionamento delle dinamiche
2386 @unnumberedsubsubsec Posizionamento delle dinamiche
2387 @translationof Dynamics placement
2388
2389 @cindex modificare il posizionamento delle dinamiche
2390 @cindex dinamiche, modificare il posizionamento
2391
2392 Le indicazioni dinamiche sono di norma poste sotto il
2393 rigo, ma possono essere collocati al di sopra del pentagramma col comando @code{\dynamicUp}.
2394 Vengono posizionati verticalmente rispetto alla figura cui
2395 si riferiscono e fluttuano sopra (o sotto) tutti gli oggetti
2396 interni al rigo come le legature di fraseggio e i numeri di battuta.
2397 Si ottengono risultati abbastanza accettabili, come dimostra
2398 questo esempio:
2399
2400 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2401 \clef "bass"
2402 \key aes \major
2403 \time 9/8
2404 \dynamicUp
2405 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2406 ees,2.~\)\mf ees4 r8 |
2407 @end lilypond
2408
2409 Tuttavia, se le note e le loro dinamiche sono molto vicine,
2410 la disposizione automatica eviterà le collisioni spostando
2411 più all'esterno i segni di dinamica successivi.  Questo
2412 potrebbe non essere però il posizionamento migliore, come mostra
2413 questo esempio piuttosto improbabile:
2414
2415 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2416 \dynamicUp
2417 a4\f b\mf a\mp b\p
2418 @end lilypond
2419
2420 @noindent
2421 Se si dovesse presentare una situazione simile in un @q{vero} brano musicale,
2422 converrebbe distanziare un po' di più le note, in modo che i segni di dinamica
2423 possano essere tutti collocati alla stessa distanza verticale dal rigo.  Abbiamo
2424 potuto farlo per il testo a margine usando il comando @code{\textLengthOn},
2425 ma non esiste un comando equivalente per i segni di dinamica.  Dunque
2426 dovremo scoprire come farlo usando i comandi @code{\override}.
2427
2428 @node Dimensione dei grob
2429 @unnumberedsubsubsec Dimensione dei grob
2430 @translationof Grob sizing
2431
2432 @subheading Estensione dei grob
2433
2434 @cindex estensione dei grob
2435 @cindex grob, estensione
2436
2437 Dobbiamo innanzitutto sapere come i grob occupano lo spazio.  Tutti i grob
2438 hanno al loro interno un punto di riferimento che viene usato
2439 per posizionarli in modo relativo all'oggetto genitore da cui derivano.  Questo
2440 punto nel grob viene poi disposto a una distanza orizzontale,
2441 @code{X-offset}, e a una distanza verticale, @code{Y-offset}, dall'oggetto
2442 genitore.  L'estensione (@emph{extent}) orizzontale dell'oggetto è data da una
2443 coppia di numeri, @code{X-extent}, che indica dove si trovano i margini
2444 sinistro e destro rispetto al punto di riferimento.  L'ampiezza verticale
2445 è ugualmente definita da una coppia di numeri, @code{Y-extent}.
2446 Queste proprietà appartengono a tutti i grob che supportano l'interfaccia
2447 @code{grob-interface}.
2448
2449 @cindex @code{extra-spacing-width}
2450
2451 Per impostazione predefinita, gli oggetti esterni al rigo presentano estensione
2452 pari a zero, in modo da potersi sovrapporre nella direzione orizzontale.
2453 Ciò si ottiene con un trucco, ovvero dando un valore infinito all'estensione
2454 sinistra e infinito negativo a quella destra, impostando la proprietà
2455 @code{extra-spacing-width} su @code{'(+inf.0 . -inf.0)}.  Per
2456 assicurarci che non si sovrappongano nella direzione orizzontale, dobbiamo
2457 sovrascrivere il valore di @code{extra-spacing-width} per dar loro un po' più
2458 di spazio.  Le unità sono lo spazio tra due linee del rigo, dunque spostare
2459 il margine sinistro di mezza unità a sinistra e quello destro di mezza unità
2460 a destra dovrebbe dare il risultato desiderato:
2461
2462 @example
2463 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2464 @end example
2465
2466 @noindent
2467 Vediamo se funziona nell'esempio precedente:
2468
2469 @cindex DynamicText, esempio di sovrascrittura
2470 @cindex proprietà extra-spacing-width, esempio
2471 @cindex extra-spacing-width, esempio
2472
2473 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2474 \dynamicUp
2475 % Aumenta la larghezza di 1 spazio rigo
2476 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2477 a4\f b\mf a\mp b\p
2478 @end lilypond
2479
2480 @noindent
2481 L'aspetto è migliore, ma sarebbe preferibile avere i segni di dinamica
2482 allineati alla stessa linea di base invece di spostarsi su e giù seguendo
2483 la posizione delle note.  La proprietà che permette di ottenere tale
2484 risultato è @code{staff-padding} ed è trattata nella sezione relativa
2485 alle collisioni (vedi @ref{Collisions of objects}).
2486
2487
2488 @node Spaziatura verticale
2489 @section Spaziatura verticale
2490 @translationof Vertical spacing
2491
2492 Di norma, la spaziatura verticale degli oggetti musicali decisa da
2493 LilyPond è molto buona.  Vediamo come si comporta con una semplice
2494 canzone, composta da due voci e un accompagnamento per pianoforte:
2495
2496 @lilypond[quote,fragment,ragged-right]
2497 <<
2498   \new ChoirStaff
2499   <<
2500     \new Staff {
2501       \new Voice = "music" {
2502         b'2 c' c' c'
2503       }
2504     }
2505     \new Lyrics
2506     \lyricsto "music" {
2507       Here are some lyrics
2508     }
2509     \new Staff {
2510       \clef bass e'2 f e c
2511     }
2512   >>
2513   \new PianoStaff
2514   <<
2515     \new Staff {
2516       g''2 c'' c'' a''
2517     }
2518     \new Staff {
2519       \clef bass e2 f c e
2520     }
2521   >>
2522 >>
2523 @end lilypond
2524
2525 Non c'è niente di sbagliato con la spaziatura verticale predefinita.  Tuttavia,
2526 supponiamo che si stia lavorando con un editore che abbia requisiti specifici
2527 per la spaziatura verticale dei righi e del testo vocale, ovvero maggior spazio
2528 tra testo e note, e tra l'accompagnamento del pianoforte e la linea vocale, e
2529 minor spazio tra i righi del pianoforte.  Iniziamo dal testo.
2530
2531 the lyrics spaced away from any notes, they want the piano
2532 accompaniment spaced away from the vocal line and they want the two
2533 piano staves pushed together tightly.  Let's start with the lyrics.
2534
2535 Il testo vocale si trova all'interno di un sistema, dunque i comandi per
2536 modificarne la spaziatura sono descritti in @ruser{Flexible vertical spacing within systems}.
2537 Quel paragrafo ci dice che il testo è costituito da linee che non appartengono
2538 al rigo (@code{non-staff lines}), quindi il comando per cambiarne la spaziatura
2539 sarà riferito alla proprietà @code{nonstaff}.  Per allontanarlo dal rigo a cui
2540 si riferiscono (la linea superiore) si usa la proprietà @code{relatedstaff}.
2541 Per allontanarli dalla linea più bassa si usa la proprietà @code{unrelatedstaff}.
2542 Le parti vocali fanno parte del @code{VerticalAxisGroup}, dunque dobbiamo
2543 aggiustare le sue proprietà.  Proviamo a vedere se funziona.
2544
2545 @lilypond[quote,fragment,ragged-right,verbatim]
2546 <<
2547   \new ChoirStaff
2548   <<
2549     \new Staff {
2550       \new Voice = "music" {
2551         b'2 c' c' c'
2552       }
2553     }
2554     \new Lyrics \with {
2555       \override VerticalAxisGroup.
2556         nonstaff-relatedstaff-spacing.padding = #5
2557       \override VerticalAxisGroup.
2558         nonstaff-unrelatedstaff-spacing.padding = #5
2559     }
2560     \lyricsto "music" {
2561       Here are some lyrics
2562     }
2563     \new Staff {
2564       \clef bass e'2 f e c
2565     }
2566   >>
2567   \new PianoStaff
2568   <<
2569     \new Staff {
2570       g''2 c'' c'' a''
2571     }
2572     \new Staff {
2573       \clef bass e2 f c e
2574     }
2575   >>
2576 >>
2577 @end lilypond
2578
2579 Funziona, ma forse non molto bene.  Quando impostiamo il
2580 @code{padding} su 5, LilyPond aggiunge 5 spazi rigo alla distanza
2581 tra gli oggetti, che è troppo in questo caso.  Useremo 2.
2582
2583 Ora allontaniamo la musica per pianoforte dalle parti vocali.  La musica
2584 vocale si trova nel rigo @code{ChoirStaff}, quindi dobbiamo aumentare lo
2585 spazio tra quel gruppo di righi e il rigo per pianoforte che si trova sotto.
2586 Lo faremo modificando la proprietà @code{basic-distance} del
2587 @code{staffgroup-staff-spacing} di @code{StaffGrouper}.
2588
2589 @lilypond[quote,fragment,ragged-right,verbatim]
2590 <<
2591   \new ChoirStaff \with {
2592     \override StaffGrouper.
2593       staffgroup-staff-spacing.basic-distance = #15
2594   }
2595   <<
2596     \new Staff {
2597       \new Voice = "music" {
2598         b'2 c' c' c'
2599       }
2600     }
2601     \new Lyrics \with {
2602       \override VerticalAxisGroup.
2603         nonstaff-relatedstaff-spacing.padding = #2
2604       \override VerticalAxisGroup.
2605         nonstaff-unrelatedstaff-spacing.padding = #2
2606     }
2607     \lyricsto "music" {
2608       Here are some lyrics
2609     }
2610     \new Staff {
2611       \clef bass e'2 f e c
2612     }
2613   >>
2614   \new PianoStaff
2615   <<
2616     \new Staff {
2617       g''2 c'' c'' a''
2618     }
2619     \new Staff {
2620       \clef bass e2 f c e
2621     }
2622   >>
2623 >>
2624 @end lilypond
2625
2626 Ottimo.  Non ci resta che avvicinare i righi del pianoforte.  Per farlo,
2627 modifichiamo di nuovo le proprietà di @code{StaffGrouper}, ma questa volta
2628 riduciamo sia @code{basic-distance} che @code{padding}.  Ecco come fare:
2629
2630 @lilypond[quote,fragment,ragged-right,verbatim]
2631 <<
2632   \new ChoirStaff \with {
2633     \override StaffGrouper.
2634       staffgroup-staff-spacing.basic-distance = #15
2635   }
2636   <<
2637     \new Staff {
2638       \new Voice = "music" {
2639         b'2 c' c' c'
2640       }
2641     }
2642     \new Lyrics \with {
2643       \override VerticalAxisGroup.
2644         nonstaff-relatedstaff-spacing.padding = #2
2645       \override VerticalAxisGroup.
2646         nonstaff-unrelatedstaff-spacing.padding = #2
2647     }
2648     \lyricsto "music" {
2649       Here are some lyrics
2650     }
2651     \new Staff {
2652       \clef bass e'2 f e c
2653     }
2654   >>
2655   \new PianoStaff \with {
2656     \override StaffGrouper.staff-staff-spacing = #'(
2657                             (basic-distance . 0)
2658                             (padding . 0))
2659   }
2660   <<
2661     \new Staff {
2662       g''2 c'' c'' a''
2663     }
2664     \new Staff {
2665       \clef bass e2 f c e
2666     }
2667   >>
2668 >>
2669 @end lilypond
2670
2671 In questo modo sono molto vicini, ma è quello che vuole l'editore.
2672 Se necessario, possono essere allontanati modificando @code{padding} o
2673 @code{basic-distance}.
2674
2675 Ci sono molti modi per modificare la spaziatura verticale.  Il punto fondamentale
2676 da ricordare è che la spaziatura degli oggetti in un contesto @code{StaffGroup}
2677 (come i gruppi @code{GrandStaff} o @code{PianoStaff}) è controllata dalle
2678 variabili spaziali di @code{StaffGrouper}.  La spaziatura relativa ai righi
2679 non raggruppati (come @code{Lyrics} e @code{Staff}) è regolata dalle variabili
2680 del @code{VerticalAxisGroup}.  Ulteriori dettagli in
2681 @ruser{Flexible vertical spacing paper variables} e
2682 @ruser{Flexible vertical spacing within systems}.
2683
2684
2685 @node Collisioni tra oggetti
2686 @section Collisioni tra oggetti
2687 @translationof Collisions of objects
2688
2689 @menu
2690 * Spostare gli oggetti::
2691 * Correggere la sovrapposizione di elementi della notazione::
2692 * Esempio musicale::
2693 @end menu
2694
2695 @node Spostare gli oggetti
2696 @subsection Spostare gli oggetti
2697 @translationof Moving objects
2698
2699 @cindex spostare gli oggetti che si sovrappongono
2700 @cindex spostare gli oggetti che collidono
2701 @cindex spostare i grob che collidono
2702 @cindex oggetti, spostarli se collidono
2703 @cindex grob, spostarli se collidono
2704
2705 Per quanto possa apparire sorprendente, LilyPond non è perfetto.  Alcuni elementi
2706 della notazione possono sovrapporsi.  Si tratta di un caso spiacevole, anche se in
2707 realtà piuttosto raro.  Di solito l'esigenza di spostare gli
2708 oggetti dipende da motivi di chiarezza o da ragioni estetiche: gli elementi
2709 possono ottenere un aspetto migliore con un po' più o un po' meno
2710 spazio intorno.
2711
2712 Esistono tre principali approcci per risolvere la sovrapposizione
2713 degli elementi della notazione.  Vediamoli nel seguente ordine:
2714
2715 @enumerate
2716 @item
2717 Si può cambiare la @strong{direzione} di uno degli oggetti che si
2718 sovrappongono usando i comandi predefiniti elencati prima, in riferimento agli
2719 oggetti interni al rigo (vedi @ref{Within-staff objects}).
2720 In questo modo si possono riposizionare facilmente gambi, legature di
2721 portamento e di valore, travature, segni di dinamica, testo e gruppi
2722 irregolari.  La limitazione è che si tratta di una scelta circoscritta a due sole
2723 posizioni, nessuna delle quali potrebbe essere appropriata.
2724
2725 @item
2726 Le @strong{proprietà degli oggetti}, che LilyPond usa quando dispone
2727 gli oggetti di formattazione, si possono modificare con @code{\override}.  I
2728 vantaggi dell'intervenire su questo tipo di proprietà sono che (a)
2729 gli altri oggetti saranno spostati automaticamente se è necessario far
2730 spazio, e (b) ogni sovrascrittura può essere applicata a tutte le occorrenze
2731 di oggetti dello stesso tipo.  Tali proprietà sono:
2732
2733 @itemize
2734
2735 @item
2736 @code{direction}
2737
2738 Questa è già stata trattata in dettaglio (vedi
2739 @ref{Within-staff objects}).
2740
2741 @item
2742 @code{padding}, @code{right-padding}, @code{staff-padding}
2743
2744 @cindex distanza
2745 @cindex spaziatura
2746 @cindex proprietà padding
2747 @cindex proprietà right-padding
2748 @cindex proprietà staff-padding
2749 @cindex padding, proprietà
2750 @cindex right-padding, proprietà
2751 @cindex staff-padding, proprietà
2752
2753 Quando un oggetto viene posizionato, il valore della sua proprietà
2754 @code{padding} specifica lo spazio intermedio da lasciare tra l'oggetto stesso
2755 e il bordo più vicino di quello accanto a cui si trova.  Nota che si
2756 tratta del valore di @code{padding} dell'oggetto che @strong{si sta
2757 posizionando}, mentre quello dell'oggetto già posizionato viene
2758 ignorato.  Gli spazi specificati da @code{padding} possono essere
2759 applicati a tutti gli oggetti che supportano l'interfaccia
2760 @code{side-position-interface}.
2761
2762 Invece che da @code{padding}, la disposizione dei gruppi di alterazioni
2763 è regolata da @code{right-padding}.  Questa proprietà appartiene all'oggetto
2764 @code{AccidentalPlacement} che si trova nel contesto @strong{Staff}.  Il
2765 processo di formattazione della partitura crea per prime le teste di
2766 nota e poi, se presenti, aggiunge le alterazioni alla sinistra delle
2767 teste di nota usando la proprietà @code{right-padding} per stabilire
2768 la distanza tra le teste e le singole alterazioni.
2769 Dunque, solo la proprietà @code{right-padding} dell'oggetto @code{AccidentalPlacement}
2770 produce un effetto sul posizionamento delle alterazioni.
2771
2772 La proprietà @code{staff-padding} è strettamente connessa alla proprietà
2773 @code{padding}: @code{padding} regola la quantità minima di spazio tra
2774 qualsiasi oggetto che supporti l'interfaccia @code{side-position-interface} e
2775 quello più vicino (solitamente, la nota o le linee del rigo); @code{staff-padding}
2776 si applica solo a quegli oggetti che stanno sempre fuori dal rigo e regola
2777 la distanza minima tra l'oggetto e il rigo.  Nota che
2778 @code{staff-padding} non ha alcun effetto sugli oggetti disposti relativamente
2779 alla nota invece che al rigo, anche se può essere sovrascritto senza generare
2780 degli errori per tali oggetti; quindi viene semplicemente ignorata.
2781
2782 Per scoprire quale proprietà padding è richiesta per l'oggetto che
2783 desideri riposizionare, devi tornare alla guida del Funzionamento
2784 interno e cercare le proprietà dell'oggetto.  Presta attenzione al fatto
2785 che le proprietà padding potrebbero non trovarsi nell'oggetto più
2786 ovvio; in tal caso devi cercare negli oggetti simili.
2787
2788 I valori delle proprietà padding sono misurati in spazi del rigo.  Il valore
2789 predefinito della maggior parte degli oggetti è circa 1.0 o meno (a seconda
2790 dell'oggetto).  Può essere sovrascritto per ottenere una distanza maggiore
2791 o minore.
2792
2793 @item
2794 @code{self-alignment-X}
2795
2796 @cindex proprietà self-alignment-X
2797 @cindex self-alignment-X, proprietà
2798
2799 Questa proprietà serve ad allineare l'oggetto a sinistra, a destra o
2800 al centro rispetto al punto di riferimento dell'oggetto genitore.
2801 Si può usare con tutti gli oggetti che supportano l'interfaccia
2802 @code{self-alignment-interface}.  Generalmente si tratta di oggetti
2803 che contengono testo.  I valori sono @code{LEFT} (sinistra), @code{RIGHT}
2804 (destra) o @code{CENTER} (centro).  Altrimenti, è possibile definire un valore
2805 numerico compreso tra @w{@code{-1}} e @code{+1}, dove @w{@code{-1}} indica
2806 allineamento a sinistra e @code{+1} allineamento a destra, mentre gli altri
2807 numeri spostano progressivamente il testo dall'allineamento a sinistra
2808 all'allineamento a destra.  È possibile specificare valori numerici maggiori
2809 di @code{1}, per spostare il testo ancora più a sinistra, o valori inferiori
2810 a @w{@code{-1}}, per spostarlo ancora più a destra.  Ogni modifica di @code{1}
2811 nel valore corrisponde a uno spostamento pari alla metà della lunghezza
2812 del testo.
2813
2814 @item
2815 @code{extra-spacing-width}
2816
2817 @cindex proprietà extra-spacing-width
2818 @cindex extra-spacing-width, proprietà
2819
2820 Questa proprietà è disponibile per tutti gli oggetti che supportano
2821 l'interfaccia @code{item-interface}. Accetta due numeri: il primo è
2822 aggiunto all'estensione più a sinistra, il secondo a quella più a
2823 destra.  I numeri negativi spostano il bordo verso sinistra, quelli
2824 positivi verso destra: quindi, per allargare un oggetto il primo
2825 numero deve essere negativo, il secondo deve essere positivo.
2826 Nota che non tutti gli oggetti rispettano entrambi i numeri.  Ad
2827 esempio, l'oggetto @code{Accidental} considera soltanto il primo
2828 numero (bordo sinistro).
2829
2830 @item
2831 @code{staff-position}
2832
2833 @cindex proprietà staff-position
2834 @cindex staff-position, proprietà
2835
2836 @code{staff-position} è una proprietà dell'interfaccia
2837 @code{staff-symbol-referencer-interface}, supportata dagli oggetti
2838 che vengono posizionati in relazione al rigo.  Specifica in unità
2839 di mezzo spazio di rigo la posizione verticale dell'oggetto rispetto
2840 alla linea centrale del rigo stesso.  È utile per risolvere collisioni
2841 tra oggetti come le pause di più misure, le legature di valore e le
2842 note in voci diverse.
2843
2844 @item
2845 @code{force-hshift}
2846
2847 @cindex proprietà force-hshift
2848 @cindex force-hshift, proprietà
2849
2850 Le note ravvicinate di un accordo o quelle simultanee appartenenti
2851 a voci diverse sono disposte su due e talvolta più colonne per
2852 impedire la sovrapposizione delle teste.  Tali colonne si chiamano
2853 colonne di note (@emph{note columns}) e l'oggetto che provvede a crearle
2854 si chiama @code{NoteColumn}.
2855
2856 La proprietà @code{force-hshift} appartiene a @code{NoteColumn}
2857 (più precisamente all'interfaccia @code{note-column-interface}).  Modificandola
2858 è possibile spostare la colonna di note proporzionalmente,
2859 assumendo come unità la larghezza della testa della nota nella voce superiore.  Si usa
2860 in situazioni complesse in cui i normali comandi @code{\shiftOn} (vedi
2861 @ref{Explicitly instantiating voices}) non risolvono adeguatamente le collisioni tra le
2862 note.  Per questo scopo, è preferibile alla proprietà @code{extra-offset}
2863 perché non c'è bisogno di trovare la giusta distanza in spazi di rigo e
2864 lo spostamento delle note dentro o fuori da una @code{NoteColumn}
2865 si ripercuote su altre azioni, come il congiungimento delle teste delle note.
2866
2867 @end itemize
2868
2869 @item
2870 Infine, se i metodi precedenti non funzionano, si possono riposizionare
2871 verticalmente gli oggetti rispetto alla linea centrale del rigo
2872 oppure collocarli a una qualsiasi distanza rispetto a una nuova
2873 posizione.  Gli svantaggi di questo metodo consistono nel fatto che i corretti
2874 valori per il riposizionamento debbano essere trovati per tentativi e per ogni
2875 singolo oggetto; inoltre, dato che lo spostamento avviene dopo che LilyPond
2876 ha posizionato tutti gli altri oggetti, spetta all'utente evitare le
2877 eventuali collisioni.  La principale
2878 difficoltà che questo approccio comporta, però, è che i valori di riposizionamento
2879 potrebbero dover essere ricalcolati se la musica venisse successivamente
2880 modificata.  Le proprietà che si possono usare con questo tipo di
2881 riposizionamento manuale sono:
2882
2883 @table @code
2884 @item extra-offset
2885
2886 @cindex proprietà extra-offset
2887 @cindex extra-offset, proprietà
2888
2889 Questa proprietà si applica a qualsiasi oggetto di formattazione che supporta
2890 l'interfaccia @code{grob-interface}.  Accetta come valore una coppia di numeri
2891 che specificano l'ulteriore spostamento nelle direzioni orizzontale e verticale.
2892 I numeri negativi spostano l'oggetto a sinistra o in basso.  Le unità sono
2893 gli spazi del rigo.  Questo spostamento aggiuntivo è applicato dopo la formattazione
2894 degli oggetti, dunque gli oggetti possono essere riposizionati ovunque senza
2895 incidere sugli altri.
2896
2897 @item positions
2898
2899 @cindex proprietà positions
2900 @cindex positions, proprietà
2901
2902 Questa proprietà è utile specialmente per correggere manualmente l'inclinazione e
2903 l'altezza di travature, legature di portamento e graffette dei gruppi irregolari.  Accetta
2904 come valore una coppia di numeri, che specifica la posizione dei bordi sinistro
2905 e destro della travatura, della legatura, etc., rispetto alla linea centrale
2906 del rigo.  L'unità di misura è lo spazio del rigo.  Considera, però,
2907 che le legature di portamento e di frase non possono essere riposizionate
2908 del tutto arbitrariamente.  LilyPond, infatti, genera prima una lista
2909 delle possibili posizioni per la legatura e poi determina la legatura che
2910 @qq{ritiene migliore}.  Se la proprietà @code{positions} è stata sovrascritta,
2911 viene scelta dalla lista la legatura più vicina alle posizioni richieste.
2912 @end table
2913
2914 @end enumerate
2915
2916 Alcuni oggetti potrebbero non disporre di tutte queste proprietà.
2917 Occorre andare a vedere nella guida al Funzionamento interno
2918 quali proprietà siano disponibili per l'oggetto che si intende
2919 modificare.
2920
2921 Segue una lista degli oggetti che hanno la maggiore probabilità
2922 di essere coinvolti in collisioni, insieme al nome dell'oggetto
2923 che deve essere cercato nella guida al Funzionamento interno per
2924 poter sapere quali proprietà si possono usare per spostarlo.
2925
2926 @multitable @columnfractions .5 .5
2927 @headitem Tipo di oggetto            @tab Nome dell'oggetto
2928 @item Articolazioni                  @tab @code{Script}
2929 @item Travature                      @tab @code{Beam}
2930 @item Dinamiche (verticalmente)      @tab @code{DynamicLineSpanner}
2931 @item Dinamiche (orizzontalmente)    @tab @code{DynamicText}
2932 @item Diteggiature                   @tab @code{Fingering}
2933 @item Numeri di chiamata / Testi     @tab @code{RehearsalMark}
2934 @item Legature di portamento         @tab @code{Slur}
2935 @item Testi, ovvero @code{^"testo"}  @tab @code{TextScript}
2936 @item Legature di valore             @tab @code{Tie}
2937 @item Gruppi irregolari              @tab @code{TupletBracket}
2938 @end multitable
2939
2940
2941 @node Correggere la sovrapposizione di elementi della notazione
2942 @subsection Correggere la sovrapposizione di elementi della notazione
2943 @translationof Fixing overlapping notation
2944
2945 Vediamo ora come le proprietà presentate nella sezione precedente possano
2946 aiutare a risolvere la sovrapposizione degli elementi della notazione.
2947
2948 @menu
2949 * La proprietà padding::
2950 * La proprietà right-padding::
2951 * La proprietà staff-padding::
2952 * La proprietà self-alignment-X::
2953 * La proprietà staff-position::
2954 * La proprietà extra-offset::
2955 * La proprietà positions::
2956 * La proprietà force-hshift::
2957 @end menu
2958
2959 @node La proprietà padding
2960 @unnumberedsubsubsec La proprietà @code{padding}
2961 @translationof The padding property
2962
2963 @cindex padding
2964 @cindex spaziatura
2965 @cindex correggere la sovrapposizione di elementi della notazione
2966 @cindex sovrapposizione degli elementi della notazione
2967
2968 La proprietà @code{padding} serve a aumentare (o diminuire)
2969 la distanza tra i simboli che si trovano sopra o sotto le
2970 note.
2971
2972 @cindex Script, esempio di sovrascrittura
2973 @cindex proprietà padding, esempio
2974 @cindex padding, esempio
2975
2976 @lilypond[quote,fragment,relative=1,verbatim]
2977 c2\fermata
2978 \override Script.padding = #3
2979 b2\fermata
2980 @end lilypond
2981
2982 @cindex MetronomeMark, esempio di sovrascrittura
2983 @cindex proprietà padding, esempio
2984 @cindex padding, esempio
2985
2986 @lilypond[quote,fragment,relative=1,verbatim]
2987 % Questo non funziona, vedi sotto
2988 \override MetronomeMark.padding = #3
2989 \tempo 4 = 120
2990 c1 |
2991 % Questo funziona
2992 \override Score.MetronomeMark.padding = #3
2993 \tempo 4 = 80
2994 d1 |
2995 @end lilypond
2996
2997 Nota nel secondo esempio come è importante sapere quale contesto
2998 gestisce un certo oggetto.  Dato che l'oggetto @code{MetronomeMark}
2999 è regolato dal contesto @code{Score}, le modifiche della proprietà
3000 nel contesto @code{Voice} non vengono prese in considerazione.  Per
3001 approfondire l'argomento si veda @ruser{Modifying properties}.
3002
3003 Se la proprietà @code{padding} di un oggetto viene aumentata quando
3004 quell'oggetto si trova insieme ad altri oggetti disposti secondo la
3005 loro proprietà @code{outside-staff-priority}, allora si sposteranno
3006 quell'oggetto e tutti gli oggetti esterni a esso.
3007
3008
3009 @node La proprietà right-padding
3010 @unnumberedsubsubsec La proprietà @code{right-padding}
3011 @translationof The right-padding property
3012
3013 @cindex proprietà right-padding
3014 @cindex right-padding, proprietà
3015
3016 La proprietà @code{right-padding} agisce sullo spazio tra l'alterazione
3017 e la nota corrispondente.  Non è una necessità frequente, ma la
3018 spaziatura predefinita potrebbe risultare errata nei casi di alcuni
3019 speciali glifi delle alterazioni usati nella musica microtonale.
3020 Questi si inseriscono sovrascrivendo lo stampo (stencil) dell'alterazione
3021 con un segno che contenga il simbolo desiderato:
3022
3023 @cindex Accidental, esempio di sovrascrittura
3024 @cindex proprietà text, esempio
3025 @cindex text, esempio
3026 @cindex proprietà stencil, esempio
3027 @cindex stencil, esempio
3028 @cindex AccidentalPlacement, esempio di sovrascrittura
3029 @cindex proprietà right-padding, esempio
3030 @cindex right-padding, esempio
3031
3032 @lilypond[quote,ragged-right,verbatim]
3033 sesquisharp = \markup { \sesquisharp }
3034 \relative c'' {
3035   c4
3036   % Mostra un triesis (alterazione ascendente di tre quarti di tono) ma lo spazio è troppo stretto
3037   \once \override Accidental.stencil = #ly:text-interface::print
3038   \once \override Accidental.text = #sesquisharp
3039   cis4 c
3040   % Ecco come migliorare lo spazio
3041   \once \override Score.AccidentalPlacement.right-padding = #0.6
3042   \once \override Accidental.stencil = #ly:text-interface::print
3043   \once \override Accidental.text = #sesquisharp
3044   cis4 |
3045 }
3046 @end lilypond
3047
3048 @noindent
3049 Siamo costretti a usare una sovrascrittura dello stampo dell'alterazione che
3050 verrà spiegata successivamente.  Il tipo di stampo deve essere una
3051 procedura e in questo esempio è stato modificato per mostrare i
3052 contenuti della proprietà @code{text} dell'oggetto @code{Accidental}, che
3053 è esso stesso impostato sul segno di triesis.  Poi
3054 questo segno viene distanziato dalla testa di nota grazie alla sovrascrittura
3055 di @code{right-padding}.
3056
3057 @noindent
3058
3059 @node La proprietà staff-padding
3060 @unnumberedsubsubsec La proprietà @code{staff-padding}
3061 @translationof The staff-padding property
3062
3063 @cindex allineare gli oggetti a una base
3064 @cindex oggetti, allinearli a una base
3065
3066 @code{staff-padding} serve ad allineare gli oggetti come i segni di
3067 dinamica lungo una linea di base a una certa distanza dal rigo, quando
3068 nessun altro elemento della notazione li allontana dal rigo.
3069 Non è una proprietà di @code{DynamicText} bensì
3070 di @code{DynamicLineSpanner}, perché la base deve essere applicata
3071 ugualmente a @strong{tutti} i segni dinamica, compresi quelli creati
3072 come estensori.  Ecco come allineare i segni di dinamica nell'esempio
3073 preso dalla sezione precedente:
3074
3075 @cindex DynamicText, esempio di sovrascrittura
3076 @cindex proprietà extra-spacing-width, esempio
3077 @cindex extra-spacing-width, esempio
3078 @cindex DynamicLineSpanner, esempio di sovrascrittura
3079 @cindex proprietà staff-padding, esempio
3080 @cindex staff-padding, esempio
3081
3082 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
3083 \override DynamicLineSpanner.staff-padding = #3
3084 a4\f b\mf a\p b\mp
3085 @end lilypond
3086
3087
3088 @node La proprietà self-alignment-X
3089 @unnumberedsubsubsec La proprietà @code{self-alignment-X}
3090 @translationof The self-alignment-X property
3091
3092 L'esempio successivo mostra come aggiustare la posizione di un numero
3093 di corda rispetto a un gambo allineando il bordo destro del numero
3094 al punto di riferimento della nota a cui si riferisce:
3095
3096 @cindex StringNumber, esempio di sovrascrittura
3097 @cindex proprietà self-alignment-X, esempio
3098 @cindex self-alignment-X, esempio
3099
3100 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
3101 \voiceOne
3102 <a\2>
3103 \once \override StringNumber.self-alignment-X = #RIGHT
3104 <a\2>
3105 @end lilypond
3106
3107
3108 @node La proprietà staff-position
3109 @unnumberedsubsubsec La proprietà @code{staff-position}
3110 @translationof The staff-position property
3111
3112 @cindex collisione tra oggetti all'interno del rigo
3113
3114 Le pause d'intero di una voce possono entrare in collisione con le note
3115 di un'altra.  Dal momento che queste pause sono centrate rispetto
3116 alle stanghette della battuta, calcolare quali altre note potrebbero
3117 sovrapporsi richiederebbe un notevole grado d'elaborazione, dato che l'attuale
3118 gestione delle collisioni tra note e tra note e pause riguarda solo
3119 le note e le pause simultanee.  Ecco un esempio
3120 di collisione di questo tipo:
3121
3122 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
3123 << { c4 c c c } \\ { R1 } >>
3124 @end lilypond
3125
3126 In questo caso la soluzione migliore è spostare in basso la pausa d'intero, poiché
3127 si trova nella seconda voce.  In @code{\voiceTwo} (ovvero nella seconda
3128 voce di un costrutto @code{<<@{@dots{}@} \\ @{@dots{}@}>>}) il valore predefinito
3129 di @code{staff-position} è -4 per la pausa multipla (MultiMeasureRest), quindi
3130 dobbiamo spostarla più in basso, ad esempio di altri quattro semispazi del
3131 rigo; il nuovo valore sarà @w{@code{-8}}.
3132
3133 @cindex MultiMeasureRest, esempio di sovrascrittura
3134 @cindex proprietà staff-position, esempio
3135 @cindex staff-position, esempio
3136
3137 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
3138 <<
3139   { c4 c c c }
3140   \\
3141   \override MultiMeasureRest.staff-position = #-8
3142   { R1 }
3143 >>
3144 @end lilypond
3145
3146 Questa soluzione è preferibile all'uso di @code{extra-offset}, perché
3147 il taglio addizionale sopra la pausa è inserito automaticamente.
3148
3149 @node La proprietà extra-offset
3150 @unnumberedsubsubsec La proprietà @code{extra-offset}
3151 @translationof The extra-offset property
3152
3153 @cindex posizionare gli oggetti
3154 @cindex posizionare i grob
3155 @cindex oggetti, posizionarli
3156 @cindex grob, posizionarli
3157
3158 La proprietà @code{extra-offset} fornisce un controllo completo
3159 sul posizionamento di un oggetto sia in orizzontale che in verticale.
3160
3161 Nell'esempio seguente, la seconda diteggiatura viene spostata un po' a
3162 sinistra e in basso di 1.8 spazi rigo:
3163
3164 @cindex Fingering, esempio di sovrascrittura
3165 @cindex proprietà extra-offset, esempio
3166 @cindex extra-offset, esempio
3167
3168 @lilypond[quote,fragment,relative=1,verbatim]
3169 \stemUp
3170 f4-5
3171 \once \override Fingering.extra-offset = #'(-0.3 . -1.8)
3172 f4-5
3173 @end lilypond
3174
3175
3176 @node La proprietà positions
3177 @unnumberedsubsubsec La proprietà @code{positions}
3178 @translationof The positions property
3179
3180 @cindex controllo manuale di graffette dei gruppi irregolari, travature, legature di portamento e di frase
3181 @cindex travature dei gruppi irregolari, controllo manuale
3182 @cindex legature di portamento, controllo manuale
3183 @cindex legature di frase, controllo manuale
3184 @cindex travature, controllo manuale
3185
3186 La proprietà @code{positions} permette di controllare manualmente la
3187 posizione verticale e quindi l'inclinazione delle graffette dei
3188 gruppi irregolari, delle legature di portamento e di frase e
3189 delle travature.  Ecco un esempio in cui una legatura di frase
3190 e una legatura di portamento collidono:
3191
3192 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
3193 a8 \( ( a'16 ) a \)
3194 @end lilypond
3195
3196 @cindex PhrasingSlur, esempio di sovrascrittura
3197 @cindex proprietà positions, esempio
3198 @cindex positions, esempio
3199
3200 @noindent
3201 Si potrebbero spostare più in alto le due estremità della legatura
3202 di frase.  Possiamo provare a impostare quella sinistra su 2.5 spazi
3203 sopra la linea centrale e quella destra a 4.5 spazi; LilyPond
3204 sceglierà la legatura di frase tra quelle candidate che hanno le
3205 estremità più vicine a queste:
3206
3207 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
3208 \once \override PhrasingSlur.positions = #'(2.5 . 4.5)
3209 a8 \( ( a'16 ) a \)
3210 @end lilypond
3211
3212 È migliorato, ma perché non abbassare un po' l'estremità destra
3213 della legatura di portamento?  Se provi vedrai che non può essere
3214 fatto in questo modo.  Il motivo è che non ci sono legature di
3215 portamento candidate più basse di quella già selezionata, quindi
3216 in questo caso la proprietà @code{positions} non può produrre
3217 effetti.  Tuttavia, legature di valore, di portamento e di frase
3218 @emph{possono} essere posizionate e disegnate in modo molto preciso
3219 se necessario.  Per sapere come fare si veda @ruser{Modifying ties and slurs}.
3220
3221 Ecco un altro esempio.  Vediamo che le travature collidono
3222 con le legature di valore:
3223
3224 @lilypond[quote,verbatim,fragment,ragged-right]
3225 {
3226   \time 4/2
3227   <<
3228     { c'1 ~ c'2. e'8 f' }
3229     \\
3230     { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
3231   >>
3232   <<
3233     { c'1 ~ c'2. e'8 f' }
3234     \\
3235     { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
3236   >>
3237 }
3238 @end lilypond
3239
3240 @noindent
3241 Si può risolvere spostando manualmente in su entrambi gli estremi della
3242 travatura dalla loro posizione di 1.81 spazi rigo sotto la linea
3243 centrale a, per esempio, 1:
3244
3245 @cindex Beam, esempio di sovrascrittura
3246 @cindex proprietà positions, esempio
3247 @cindex positions, esempio
3248
3249 @lilypond[quote,verbatim,fragment,ragged-right]
3250 {
3251   \time 4/2
3252   <<
3253     { c'1 ~ c'2. e'8 f' }
3254     \\
3255     {
3256       \override Beam.positions = #'(-1 . -1)
3257       e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g''
3258     }
3259   >>
3260   <<
3261     { c'1 ~ c'2. e'8 f' }
3262     \\
3263     { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
3264   >>
3265 }
3266 @end lilypond
3267
3268 @noindent
3269 Come vedi, la sovrascrittura si applica anche alla prima voce della seconda
3270 misura di otto note, ma a nessuna delle travature nella seconda voce.
3271
3272 @node La proprietà force-hshift
3273 @unnumberedsubsubsec La proprietà @code{force-hshift}
3274 @translationof The force-hshift property
3275
3276 Possiamo vedere ora come applicare le correzioni finali all'esempio di Chopin
3277 introdotto alla fine del paragrafo @ref{I'm hearing Voices}, che avevamo
3278 lasciato così:
3279
3280 @lilypond[quote,verbatim,fragment,ragged-right]
3281 \new Staff \relative c'' {
3282   \key aes \major
3283   <<
3284     { c2 aes4. bes8 }
3285     \\
3286     { <ees, c>2 des }
3287     \\
3288     \\
3289     { aes'2 f4 fes }
3290   >> |
3291   <c ees aes c>1 |
3292 }
3293 @end lilypond
3294
3295 @noindent
3296 La nota interna del primo accordo (ovvero il La bemolle della quarta
3297 voce) non deve essere allontanata dalla colonna della nota più
3298 alta.  Per correggerlo impostiamo @code{force-hshift}, una proprietà
3299 di @code{NoteColumn}, su zero.
3300
3301 Nel secondo accordo preferiamo che il Fa sia allineato al La bemolle e che
3302 la nota più grave sia posizionata leggermente più a destra, in modo da
3303 evitare la collisione dei gambi.  Per farlo dobbiamo impostare
3304 @code{force-hshift} nella colonna (@code{NoteColumn}) del Re bemolle
3305 grave in modo che si sposti a destra di mezzo spazio di rigo.
3306
3307 Ecco il risultato finale:
3308
3309 @cindex NoteColumn, esempio di sovrascrittura
3310 @cindex proprietà force-hshift, esempio
3311 @cindex force-hshift, esempio
3312
3313 @lilypond[quote,verbatim,fragment,ragged-right]
3314 \new Staff \relative c'' {
3315   \key aes \major
3316   <<
3317     { c2 aes4. bes8 }
3318     \\
3319     {
3320       <ees, c>2
3321       \once \override NoteColumn.force-hshift = #0.5
3322       des2
3323     }
3324     \\
3325     \\
3326     {
3327       \override NoteColumn.force-hshift = #0
3328       aes'2 f4 fes
3329     }
3330   >> |
3331   <c ees aes c>1 |
3332 }
3333 @end lilypond
3334
3335
3336 @node Esempio musicale
3337 @subsection Esempio musicale
3338 @translationof Real music example
3339
3340 Completiamo questa sezione delle modifiche (@emph{tweak}) mostrando passo passo
3341 come affrontare un esempio complesso che necessita varie modifiche per
3342 poter raggiungere l'aspetto desiderato.  L'esempio è stato scelto
3343 appositamente per mostrare come usare la guida alla Notazione per
3344 risolvere problemi inusuali di notazione.  Non rispecchia l'uso
3345 abituale di LilyPond, quindi non farti scoraggiare da queste difficoltà!
3346 Per fortuna problemi come questi sono molto rari!
3347
3348 L'esempio è tratto dalla Première Ballade op. 23 di Chopin e va
3349 dalla battuta 6 alla 9, la transizione dal Lento iniziale al Moderato.
3350 Vediamo prima come vogliamo che l'output appaia; per evitare di
3351 complicare troppo l'esempio abbiamo però tolto le dinamiche, le diteggiature
3352 e le pedalizzazioni.
3353
3354 @c The following should appear as music without code
3355 @c This example should not be indexed
3356 @c line-width ensures no break
3357 @lilypond[quote,ragged-right,line-width=6\in]
3358 rhMusic = \relative c'' {
3359   \new Voice {
3360     r2 c4.\( g8 |
3361     \once \override Tie.staff-position = #3.5
3362     bes1~ |
3363     \bar "||"
3364     \time 6/4
3365     \mergeDifferentlyHeadedOn
3366     \mergeDifferentlyDottedOn
3367     bes2.^\markup { \bold "Moderato" } r8
3368     <<
3369       { c,8 d fis bes a }
3370       \new Voice {
3371         \voiceTwo
3372         c,8~
3373         % Riposiziona il c2 a destra della nota unita
3374         \once \override NoteColumn.force-hshift = #1.0
3375         % Sposta il c2 fuori dalla colonna della nota principale
3376         % in modo che l'unione di note (merge) funzioni
3377         \shiftOnn
3378         c2
3379       }
3380       \new Voice {
3381         \voiceThree
3382         s8
3383         % Il gambo di d2 deve essere in giù per permettere l'unione delle note
3384         \stemDown
3385         % Il gambo di d2 deve essere invisibile
3386         \tweak Stem.transparent ##t
3387         d2
3388       }
3389       \new Voice {
3390         \voiceFour
3391         s4 fis4.
3392       }
3393     >> |
3394     \mergeDifferentlyHeadedOff
3395     \mergeDifferentlyDottedOff
3396     g2.\)
3397   }
3398 }
3399
3400 lhMusic = \relative c' {
3401   r2 <c g ees>2( |
3402   <d g, d>1)\arpeggio |
3403   r2. d,,4 r4 r |
3404   r4
3405 }
3406
3407 \score {
3408   \new PianoStaff <<
3409     \new Staff = "RH"  <<
3410       \key g \minor
3411       \rhMusic
3412     >>
3413     \new Staff = "LH" <<
3414       \key g \minor
3415       \clef "bass"
3416       \lhMusic
3417     >>
3418   >>
3419 }
3420 @end lilypond
3421
3422 Vediamo che la parte della mano destra nella terza battuta
3423 richiede quattro voci.  Si tratta delle cinque crome unite da travatura,
3424 il Do legato, la minima di Re che è unita alla croma di
3425 Re, e la semiminima puntata del Fa diesis, anch'essa unita
3426 alla croma della stessa altezza.  Tutto il resto è su una
3427 voce singola, quindi il sistema più semplice è introdurre queste
3428 ulteriori voci temporaneamente, quando sono richieste.  Se ti
3429 sei dimenticato come fare, rileggi i paragrafi @ref{I'm hearing Voices} e
3430 @ref{Explicitly instantiating voices}.  In questo caso scegliamo di
3431 usare per il passaggio polifonico le voci definite esplicitamente, dato
3432 che LilyPond riesce a evitare meglio le collisioni se tutte le voci
3433 sono definite esplicitamente in questo modo.
3434
3435 Dunque iniziamo con l'inserire le note in due variabili, impostare la
3436 struttura del rigo in un blocco \score e vedere che cosa LilyPond
3437 produce senza modifiche manuali:
3438
3439 @c line-width ensures no break
3440 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3441 rhMusic = \relative c'' {
3442   \new Voice {
3443     r2 c4. g8 |
3444     bes1~ |
3445     \time 6/4
3446     bes2. r8
3447     % Inizia la sezione polifonica a quattro voci
3448     <<
3449       { c,8 d fis bes a }  % continuazione della voce principale
3450       \new Voice {
3451         \voiceTwo
3452         c,8~ c2
3453       }
3454       \new Voice {
3455         \voiceThree
3456         s8 d2
3457       }
3458       \new Voice {
3459         \voiceFour
3460         s4 fis4.
3461       }
3462     >> |
3463     g2.  % continuazione della voce principale
3464   }
3465 }
3466
3467 lhMusic = \relative c' {
3468   r2 <c g ees>2 |
3469   <d g, d>1 |
3470   r2. d,,4 r4 r |
3471   r4
3472 }
3473
3474 \score {
3475   \new PianoStaff <<
3476     \new Staff = "RH"  <<
3477       \key g \minor
3478       \rhMusic
3479     >>
3480     \new Staff = "LH" <<
3481       \key g \minor
3482       \clef "bass"
3483       \lhMusic
3484     >>
3485   >>
3486 }
3487 @end lilypond
3488
3489 Le note sono giuste ma l'aspetto è ben lontano dall'essere
3490 soddisfacente.  La legatura collide col nuovo segno di tempo,
3491 alcune note non sono accorpate e mancano vari elementi
3492 della notazione.  Partiamo dalle cose più semplici.  Possiamo
3493 aggiungere la legatura di portamento della mano sinistra e la legatura
3494 di frase della mano destra, dato che queste sono state già trattate
3495 nel Tutorial.  In questo modo abbiamo:
3496
3497 @c line-width ensures no break
3498 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3499 rhMusic = \relative c'' {
3500   \new Voice {
3501     r2 c4.\( g8 |
3502     bes1~ |
3503     \time 6/4
3504     bes2. r8
3505     % Inizia la sezione polifonica a quattro voci
3506     <<
3507       { c,8 d fis bes a }  % continuazione della voce principale
3508       \new Voice {
3509         \voiceTwo
3510         c,8~ c2
3511       }
3512       \new Voice {
3513         \voiceThree
3514         s8 d2
3515       }
3516       \new Voice {
3517         \voiceFour
3518         s4 fis4.
3519       }
3520     >> |
3521     g2.\)  % continuazione della voce principale
3522   }
3523 }
3524
3525 lhMusic = \relative c' {
3526   r2 <c g ees>2( |
3527   <d g, d>1) |
3528   r2. d,,4 r4 r |
3529   r4
3530 }
3531
3532 \score {
3533   \new PianoStaff <<
3534     \new Staff = "RH"  <<
3535       \key g \minor
3536       \rhMusic
3537     >>
3538     \new Staff = "LH" <<
3539       \key g \minor
3540       \clef "bass"
3541       \lhMusic
3542     >>
3543   >>
3544 }
3545 @end lilypond
3546
3547 Ora la prima battuta è corretta.  La seconda battuta contiene un arpeggio e
3548 è terminata da una stanghetta doppia.  Dato che non sono stati menzionati
3549 in questo manuale di Apprendimento, come possiamo ottenerli?  Dobbiamo
3550 andare a vedere nella guida alla Notazione.  Cercando nell'indice
3551 i termini @qq{arpeggio} e @qq{stanghetta}, scopriamo rapidamente che un arpeggio
3552 viene prodotto posponendo @code{\arpeggio} a un accordo e che la stanghetta
3553 doppia si ottiene col comando @code{\bar "||"}.  Questo è stato facile.  Ora
3554 dobbiamo correggere la collisione della legatura di valore con l'indicazione di tempo.
3555 Il modo migliore è spostare la legatura verso l'alto.  Lo spostamento degli oggetti
3556 è stato trattato prima in @ref{Moving objects}, dove si dice che gli oggetti
3557 posizionati relativamente al rigo possono essere spostati verticalmente
3558 sovrascrivendo la proprietà @code{staff-position}, specificata in metà spazi-rigo
3559 rispetto alla linea centrale del rigo.  Dunque la seguente sovrascrittura
3560 posizionata proprio prima della prima nota della legatura sposta la legatura
3561 3.5 mezzi spazi di rigo sopra la linea centrale:
3562
3563 @code{\once \override Tie.staff-position = #3.5}
3564
3565 Questo completa la seconda battuta:
3566
3567 @c line-width ensures no break
3568 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3569 rhMusic = \relative c'' {
3570   \new Voice {
3571     r2 c4.\( g8 |
3572     \once \override Tie.staff-position = #3.5
3573     bes1~ |
3574     \bar "||"
3575     \time 6/4
3576     bes2. r8
3577     % Inizia la sezione polifonica a quattro voci
3578     <<
3579       { c,8 d fis bes a }  % continuazione della voce principale
3580       \new Voice {
3581         \voiceTwo
3582         c,8~ c2
3583       }
3584       \new Voice {
3585         \voiceThree
3586         s8 d2
3587       }
3588       \new Voice {
3589         \voiceFour
3590         s4 fis4.
3591       }
3592     >> |
3593     g2.\)  % continuazione della voce principale
3594   }
3595 }
3596
3597 lhMusic = \relative c' {
3598   r2 <c g ees>2( |
3599   <d g, d>1)\arpeggio |
3600   r2. d,,4 r4 r |
3601   r4
3602 }
3603
3604 \score {
3605   \new PianoStaff <<
3606     \new Staff = "RH"  <<
3607       \key g \minor
3608       \rhMusic
3609     >>
3610     \new Staff = "LH" <<
3611       \key g \minor
3612       \clef "bass"
3613       \lhMusic
3614     >>
3615   >>
3616 }
3617 @end lilypond
3618
3619 Proseguiamo con la terza battuta e l'inizio della sezione del Moderato.  Nel
3620 tutorial abbiamo visto come aggiungere del testo in grassetto tramite il
3621 comando @code{\markup}, quindi aggiungere @qq{Moderato} in grassetto è
3622 facile.  Ma come facciamo ad accorpare le note appartenenti a voci
3623 diverse?  Ancora una volta dobbiamo rivolgerci alla guida alla Notazione per
3624 un aiuto.  Una ricerca del termine @qq{accorpare} (@emph{merge}) nell'indice della
3625 guida ci porta rapidamente al paragrafo @ruser{Collision resolution}, dove
3626 troviamo i comandi per allineare le note con teste e punti diversi.  Nel
3627 nostro esempio abbiamo bisogno di accorpare entrambi i tipi di note per la
3628 durata della sezione polifonica della terza battuta.  Dunque, usando le
3629 informazioni trovate nella guida alla Notazione, aggiungiamo
3630
3631 @example
3632 \mergeDifferentlyHeadedOn
3633 \mergeDifferentlyDottedOn
3634 @end example
3635
3636 @noindent
3637 all'inizio di questa sezione e
3638
3639 @example
3640 \mergeDifferentlyHeadedOff
3641 \mergeDifferentlyDottedOff
3642 @end example
3643
3644 @noindent
3645 alla fine, ottenendo:
3646
3647 @c line-width ensures no break
3648 @lilypond[quote,ragged-right,line-width=6\in]
3649 rhMusic = \relative c'' {
3650   \new Voice {
3651     r2 c4.\( g8 |
3652     \once \override Tie.staff-position = #3.5
3653     bes1~ |
3654     \bar "||"
3655     \time 6/4
3656     bes2.^\markup { \bold "Moderato" } r8
3657     \mergeDifferentlyHeadedOn
3658     \mergeDifferentlyDottedOn
3659     % Inizia la sezione polifonica a quattro voci
3660     <<
3661       { c,8 d fis bes a }  % continuazione della voce principale
3662       \new Voice {
3663         \voiceTwo
3664         c,8~ c2
3665       }
3666       \new Voice {
3667         \voiceThree
3668         s8 d2
3669       }
3670       \new Voice {
3671         \voiceFour
3672         s4 fis4.
3673       }
3674     >> |
3675     \mergeDifferentlyHeadedOff
3676     \mergeDifferentlyDottedOff
3677     g2.\)  % continuazione della voce principale
3678   }
3679 }
3680
3681 lhMusic = \relative c' {
3682   r2 <c g ees>2( |
3683   <d g, d>1)\arpeggio |
3684   r2. d,,4 r4 r |
3685   r4
3686 }
3687
3688 \score {
3689   \new PianoStaff <<
3690     \new Staff = "RH"  <<
3691       \key g \minor
3692       \rhMusic
3693     >>
3694     \new Staff = "LH" <<
3695       \key g \minor
3696       \clef "bass"
3697       \lhMusic
3698     >>
3699   >>
3700 }
3701 @end lilypond
3702
3703 Queste sovrascritture hanno accorpato i due Fa diesis, ma non i due
3704 Re.  Perché?  La risposta si trova nella stessa sezione della
3705 guida alla Notazione: le note da unire devono avere i gambi in
3706 direzioni opposte e due note non possono essere accorpate se c'è
3707 una terza nota nella stessa colonna.  In questo esempio i due Re
3708 hanno entrambi i gambi in su e c'è una terza nota, il Do. Sappiamo
3709 come cambiare la direzione dei gambi con @code{\stemDown} e la
3710 guida alla Notazione ci dice anche come spostare il Do, applicando
3711 uno spostamento con uno dei comandi @code{\shift}.  Ma quale? Il Do
3712 si trova nella seconda voce che ha lo spostamento (@emph{shift}) disattivato,
3713 mentre i due Re sono nella prima e nella terza voce, che ce l'hanno
3714 rispettivamente disattivato e attivato.  Dunque dobbiamo distanziare il
3715 Do di un ulteriore livello usando @code{\shiftOnn} per evitare che
3716 interferisca con i due Re.  Applicando queste modifiche abbiamo:
3717
3718 @cindex Tie, esempio di sovrascrittura
3719 @cindex proprietà staff-position, esempio
3720 @cindex staff-position, esempio
3721
3722 @c line-width ensures no break
3723 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3724 rhMusic = \relative c'' {
3725   \new Voice {
3726     r2 c4.\( g8 |
3727     \once \override Tie.staff-position = #3.5
3728     bes1~ |
3729     \bar "||"
3730     \time 6/4
3731     bes2.^\markup { \bold "Moderato" } r8
3732     \mergeDifferentlyHeadedOn
3733     \mergeDifferentlyDottedOn
3734     % Inizia la sezione polifonica a quattro voci
3735     <<
3736       { c,8 d fis bes a }  % continuazione della voce principale
3737       \new Voice {
3738         \voiceTwo
3739         % Sposta il c2 fuori dalla colonna della nota principale
3740         % in modo che l'unione di note funzioni
3741         c,8~ \shiftOnn c2
3742       }
3743       \new Voice {
3744         \voiceThree
3745         % Il gambo di d2 deve essere in giù per permettere l'unione delle note
3746         s8 \stemDown d2
3747       }
3748       \new Voice {
3749         \voiceFour
3750         s4 fis4.
3751       }
3752     >> |
3753     \mergeDifferentlyHeadedOff
3754     \mergeDifferentlyDottedOff
3755     g2.\)  % continuazione della voce principale
3756   }
3757 }
3758
3759 lhMusic = \relative c' {
3760   r2 <c g ees>2( |
3761   <d g, d>1)\arpeggio |
3762   r2. d,,4 r4 r |
3763   r4
3764 }
3765
3766 \score {
3767   \new PianoStaff <<
3768     \new Staff = "RH"  <<
3769       \key g \minor
3770       \rhMusic
3771     >>
3772     \new Staff = "LH" <<
3773       \key g \minor
3774       \clef "bass"
3775       \lhMusic
3776     >>
3777   >>
3778 }
3779 @end lilypond
3780
3781 Ci siamo quasi, restano solo due problemi: il gambo in giù del
3782 Re unito non ci dovrebbe essere e il Do dovrebbe essere posizionato
3783 a destra dei Re.  Sappiamo come fare grazie alle modifiche precedenti:
3784 rendiamo il gambo trasparente e spostiamo il Do con la proprietà
3785 @code{force-hshift}.  Ecco il risultato finale:
3786
3787 @cindex NoteColumn, esempio di sovrascrittura
3788 @cindex proprietà force-hshift, esempio
3789 @cindex force-hshift, esempio
3790 @cindex Stem, esempio di sovrascrittura
3791 @cindex proprietà transparent, esempio
3792 @cindex transparent, esempio
3793
3794 @c line-width ensures no break
3795 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3796 rhMusic = \relative c'' {
3797   \new Voice {
3798     r2 c4.\( g8 |
3799     \once \override Tie.staff-position = #3.5
3800     bes1~ |
3801     \bar "||"
3802     \time 6/4
3803     bes2.^\markup { \bold "Moderato" } r8
3804     \mergeDifferentlyHeadedOn
3805     \mergeDifferentlyDottedOn
3806     % Inizia la sezione polifonica a quattro voci
3807     <<
3808       { c,8 d fis bes a }  % continuazione della voce principale
3809       \new Voice {
3810         \voiceTwo
3811         c,8~
3812         % Riposiziona il c2 a destra della nota unita
3813         \once \override NoteColumn.force-hshift = #1.0
3814         % Sposta il c2 fuori dalla colonna della nota principale
3815         % in modo che l'unione di note funzioni
3816         \shiftOnn
3817         c2
3818       }
3819       \new Voice {
3820         \voiceThree
3821         s8
3822         % Il gambo di d2 deve essere in giù per permettere l'unione delle note
3823         \stemDown
3824         % Il gambo di d2 deve essere invisibile
3825         \tweak Stem.transparent ##t
3826         d2
3827       }
3828       \new Voice {
3829         \voiceFour
3830         s4 fis4.
3831       }
3832     >> |
3833     \mergeDifferentlyHeadedOff
3834     \mergeDifferentlyDottedOff
3835     g2.\)  % continuazione della voce principale
3836   }
3837 }
3838
3839 lhMusic = \relative c' {
3840   r2 <c g ees>2( |
3841   <d g, d>1)\arpeggio |
3842   r2. d,,4 r4 r |
3843   r4
3844 }
3845
3846 \score {
3847   \new PianoStaff <<
3848     \new Staff = "RH"  <<
3849       \key g \minor
3850       \rhMusic
3851     >>
3852     \new Staff = "LH" <<
3853       \key g \minor
3854       \clef "bass"
3855       \lhMusic
3856     >>
3857   >>
3858 }
3859 @end lilypond
3860
3861
3862 @node Altre modifiche
3863 @section Altre modifiche
3864 @translationof Further tweaking
3865
3866 @menu
3867 * Altri usi delle modifiche con \tweak::
3868 * Uso delle variabili per modificare la formattazione::
3869 * Fogli di stile::
3870 * Altre fonti di informazione::
3871 * Modifiche avanzate con Scheme::
3872 @end menu
3873
3874 @node Altri usi delle modifiche con \tweak
3875 @subsection Altri usi delle modifiche con @code{\tweak}
3876 @translationof Other uses for tweaks
3877
3878 @menu
3879 * Legature di valore tra note di voci diverse::
3880 * Simulare una corona nel MIDI::
3881 @end menu
3882
3883
3884 @cindex proprietà transparent, uso della
3885 @cindex oggetti, renderli invisibili
3886 @cindex togliere gli oggetti
3887 @cindex oggetti, toglierli
3888 @cindex nascondere gli oggetti
3889 @cindex oggetti, nascondere
3890 @cindex oggetti invisibili
3891 @cindex legature di valore tra note di voci diverse
3892
3893 @node Legature di valore tra note di voci diverse
3894 @unnumberedsubsubsec Legature di valore tra note di voci diverse
3895 @translationof Tying notes across voices
3896
3897 L'esempio seguente mostra come unire con legature di valore
3898 note appartenenti a voci diverse.  Di norma, solo le note nella
3899 stessa voce possono essere unite da una legatura di valore.
3900 Se si usano due voci con le note legate in una voce
3901
3902 @lilypond[quote,fragment,relative=2]
3903 << { b8~ b\noBeam } \\ { b8[ g] } >>
3904 @end lilypond
3905
3906 @noindent
3907 e si cancella il primo gambo di quella voce, la legatura sembra
3908 attraversare le voci:
3909
3910 @cindex Stem, esempio di sovrascrittura
3911 @cindex proprietà transparent, esempio
3912 @cindex transparent, esempio
3913
3914 @lilypond[quote,fragment,relative=2,verbatim]
3915 <<
3916   {
3917     \tweak Stem.transparent ##t
3918     b8~ b\noBeam
3919   }
3920 \\
3921   { b8[ g] }
3922 >>
3923 @end lilypond
3924
3925 Per far sì che il gambo cancellato non schiacci troppo la legatura,
3926 possiamo allungarlo impostando la proprietà
3927 @code{length} su @code{8},
3928
3929 @lilypond[quote,fragment,relative=2,verbatim]
3930 <<
3931   {
3932     \tweak Stem.transparent ##t
3933     \tweak Stem.length #8
3934     b8~ b\noBeam
3935   }
3936 \\
3937   { b8[ g] }
3938 >>
3939 @end lilypond
3940
3941 @funindex \single
3942 @cindex tweak, generato da un override
3943
3944 Per @emph{sovrascrivere} (con @code{\override}) la trasparenza di un oggetto
3945 grafico, avremmo potuto usare la scorciatoia @code{\hide}, come spiegato
3946 in precedenza.  Ma la modifica manuale con @emph{\tweak} è un'operazione
3947 diversa, che riguarda solo le proprietà generate da una singola espressione
3948 musicale.  Tuttavia è possibile convertire le sovrascritture in @emph{tweak}
3949 usando @code{\single}. Questo ci permette di riscrivere l'esempio precedente
3950 in questo modo
3951
3952 @lilypond[quote,fragment,relative=2,verbatim]
3953 <<
3954   {
3955     \single \hide Stem
3956     \single \hide Flag
3957     \tweak Stem.length #8
3958     b8~ b\noBeam
3959   }
3960 \\
3961   { b8[ g] }
3962 >>
3963 @end lilypond
3964
3965 In questo caso particolare, la differenza rispetto a @code{\once \hide} non
3966 è evidente.  La differenza è evidente quando ci sono vari oggetti che
3967 si trovano nello stesso punto del tempo musicale (come le teste delle note
3968 in un accordo).  In quel caso, @code{\once} avrà effetto su tutti quegli
3969 oggetti mentre @code{\single} solo su uno, ovvero quello generato
3970 dall'espressione musicale immediatamente seguente.
3971
3972
3973 @node Simulare una corona nel MIDI
3974 @unnumberedsubsubsec Simulare una corona nel MIDI
3975 @translationof Simulating a fermata in MIDI
3976
3977 @cindex proprietà stencil, uso della
3978 @cindex corona, usarla nel MIDI
3979
3980 Per gli oggetti esterni al rigo è di solito preferibile sovrascrivere
3981 la proprietà @code{stencil} piuttosto che la proprietà @code{transparent}
3982 dell'oggetto se si desidera toglierlo dall'output.  Se si imposta la
3983 proprietà @code{stencil} su @code{#f} l'oggetto verrà completamente
3984 rimosso dall'output e quindi non potrà influenzare la disposizone
3985 di altri oggetti posizionati rispetto a esso.
3986
3987 Ad esempio, se volessimo modificare il segno di metronomo solo per
3988 simulare una corona nel MIDI, non vorremmo che il segno apparisse
3989 nella partitura né vorremmo influenzare la spaziatura tra i due
3990 sistemi o la posizione di annotazioni adiacenti nel rigo.  Dunque,
3991 il modo migliore è impostare la proprietà @code{stencil} su
3992 @code{#f}.  Ecco l'effetto dei due metodi:
3993
3994 @cindex MetronomeMark, esempio di sovrascrittura
3995 @cindex proprietà transparent, esempio
3996 @cindex transparent, esempio
3997
3998 @lilypond[quote,verbatim,ragged-right]
3999 \score {
4000   \relative c'' {
4001     % Indicazione di tempo visibile
4002     \tempo 4=120
4003     a4 a a
4004     \once \hide Score.MetronomeMark
4005     % Indicazione di tempo invisibile per allungare la fermata nel MIDI
4006     \tempo 4=80
4007     a4\fermata |
4008     % Nuovo tempo per la sezione successiva
4009     \tempo 4=100
4010     a4 a a a |
4011   }
4012   \layout { }
4013   \midi { }
4014 }
4015 @end lilypond
4016
4017 @cindex MetronomeMark, esempio di sovrascrittura
4018 @cindex proprietà stencil, esempio
4019 @cindex stencil, esempio
4020
4021 @lilypond[quote,verbatim,ragged-right]
4022 \score {
4023   \relative c'' {
4024     % Indicazione di tempo visibile
4025     \tempo 4=120
4026     a4 a a
4027     \once \omit Score.MetronomeMark
4028     % Indicazione di tempo invisibile per allungare la fermata nel MIDI
4029     \tempo 4=80
4030     a4\fermata |
4031     % Nuovo tempo per la sezione successiva
4032     \tempo 4=100
4033     a4 a a a |
4034   }
4035   \layout { }
4036   \midi { }
4037 }
4038 @end lilypond
4039
4040 @noindent
4041 Entrambi i metodi tolgono dalla partitura l'indicazione metronomica
4042 ed entrambi cambiano il tempo del MIDI come volevamo, ma nel primo esempio l'indicazione
4043 metronomica trasparente sposta troppo in alto
4044 l'indicazione di tempo successiva, mentre nel secondo esempio, dove
4045 viene tolto lo stampo (@emph{stencil}), ciò non accade.
4046
4047 @seealso
4048 Glossario musicale:
4049 @rglosnamed{system,sistema}.
4050
4051 @node Uso delle variabili per modificare la formattazione
4052 @subsection Uso delle variabili per modificare la formattazione
4053 @translationof Using variables for layout adjustments
4054
4055 @cindex variabili, usarle per le sovrascritture
4056 @cindex sovrascritture, usare le variabili per
4057 @cindex formattazione, usare le variabili per modificare la
4058
4059 I comandi di sovrascrittura sono spesso lunghi e tediosi da
4060 scrivere, e devono essere assolutamente corretti.  Se si usa
4061 più volte la stessa sovrascrittura conviene definire una
4062 variabile che la contenga.
4063
4064 Immaginiamo di voler enfatizzare certe parole del testo usando
4065 grassetto e corsivo.  I comandi @code{\italic} (corsivo) e @code{\bold}
4066 (grassetto) funzionano all'interno del testo solo se inclusi,
4067 insieme alla parola o alle parole da modificare, in un blocco
4068 @code{\markup}: dunque sono scomodi da inserire.  Dovendo inserire
4069 le parole stesse non si possono usare variabili semplici.  Come
4070 alternativa possiamo usare i comandi @code{\override} e @code{\revert}?
4071
4072 @example
4073 @code{\override Lyrics.LyricText.font-shape = #'italic}
4074 @code{\override Lyrics.LyricText.font-series = #'bold}
4075
4076 @code{\revert Lyrics.LyricText.font-shape}
4077 @code{\revert Lyrics.LyricText.font-series}
4078 @end example
4079
4080 Anche questi sarebbero molto noiosi da inserire se ci fossero
4081 molte parole che richiedono enfasi.  Ma possiamo inserirli
4082 in due variabili e poi usare queste per le parole da enfatizzare.
4083 Un altro vantaggio dell'uso di variabili per queste sovrascritture
4084 è che gli spazi intorno al punto non sono necessari, perché non
4085 sono interpretati direttamente in @code{\lyricmode}.  Ecco un
4086 esempio, anche se nella pratica comune avremmo scelto dei nomi
4087 più brevi per le variabili in modo da poterle inserire più
4088 rapidamente:
4089
4090 @cindex LyricText, esempio di sovrascrittura
4091 @cindex proprietà font-shape, esempio
4092 @cindex font-shape, esempio
4093 @cindex proprietà font-series, esempio
4094 @cindex font-series, esempio
4095
4096 @lilypond[quote,verbatim]
4097 emphasize = {
4098   \override Lyrics.LyricText.font-shape = #'italic
4099   \override Lyrics.LyricText.font-series = #'bold
4100 }
4101
4102 normal = {
4103   \revert Lyrics.LyricText.font-shape
4104   \revert Lyrics.LyricText.font-series
4105 }
4106
4107 global = { \key c \major \time 4/4 \partial 4 }
4108
4109 SopranoMusic = \relative c' { c4 | e4. e8 g4 g    | a4   a   g  }
4110 AltoMusic    = \relative c' { c4 | c4. c8 e4 e    | f4   f   e  }
4111 TenorMusic   = \relative c  { e4 | g4. g8 c4.  b8 | a8 b c d e4 }
4112 BassMusic    = \relative c  { c4 | c4. c8 c4 c    | f8 g a b c4 }
4113
4114 VerseOne = \lyrics {
4115   E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
4116 }
4117
4118 VerseTwo = \lyricmode {
4119   O | \once \emphasize Christ, whose voice the | wa -- ters heard,
4120 }
4121
4122 VerseThree = \lyricmode {
4123   O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
4124 }
4125
4126 VerseFour = \lyricmode {
4127   O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
4128 }
4129
4130 \score {
4131   \new ChoirStaff <<
4132     \new Staff <<
4133       \clef "treble"
4134       \new Voice = "Soprano"  { \voiceOne \global \SopranoMusic }
4135       \new Voice = "Alto" { \voiceTwo \AltoMusic }
4136       \new Lyrics \lyricsto "Soprano" { \VerseOne }
4137       \new Lyrics \lyricsto "Soprano" { \VerseTwo }
4138       \new Lyrics \lyricsto "Soprano" { \VerseThree }
4139       \new Lyrics \lyricsto "Soprano" { \VerseFour }
4140     >>
4141     \new Staff <<
4142       \clef "bass"
4143       \new Voice = "Tenor" { \voiceOne \TenorMusic }
4144       \new Voice = "Bass"  { \voiceTwo \BassMusic }
4145     >>
4146   >>
4147 }
4148 @end lilypond
4149
4150
4151 @node Fogli di stile
4152 @subsection Fogli di stile
4153 @translationof Style sheets
4154
4155 L'output prodotto da LilyPond può essere ampiamente modificato, come
4156 abbiamo visto nel capitolo @ref{Tweaking output}.  Ma se avessi molti
4157 file di input a cui voler applicare delle modifiche?  O se volessi
4158 semplicemente separare le modifiche dalla musica vera e propria?
4159 È molto semplice.
4160
4161 Prendiamo un esempio.  Non ti preoccupare se non capisci le
4162 parti che hanno @code{#()}; verranno spiegate nel capitolo
4163 @ref{Advanced tweaks with Scheme}.
4164
4165 @lilypond[quote,verbatim,ragged-right]
4166 mpdolce =
4167   \tweak self-alignment-X #-0.6
4168   #(make-dynamic-script
4169     #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4170
4171 inst =
4172 #(define-music-function
4173      (parser location string)
4174      (string?)
4175    #{ <>^\markup \bold \box #string #})
4176
4177 \relative c'' {
4178   \tempo 4=50
4179   a4.\mpdolce d8 cis4--\glissando a |
4180   b4 bes a2 |
4181   \inst "Clarinet"
4182   cis4.\< d8 e4 fis |
4183   g8(\! fis)-. e( d)-. cis2 |
4184 }
4185 @end lilypond
4186
4187 Facciamo qualcosa a proposito delle definizioni di @code{mpdolce} e
4188 @code{inst}.  Producono l'output che desideriamo, ma potremmo volerle
4189 usare in un altro brano.  Potremmo semplicemente copiarle e incollarle
4190 in cima a ogni file, ma sarebbe una seccatura e lascerebbe queste
4191 definizioni nel file di input; personalmente trovo tutti quei @code{#()}
4192 piuttosto brutti, dunque nascondiamoli in un altro file:
4193
4194 @example
4195 %%% salva queste righe in un file chiamato "definitions.ily"
4196 mpdolce =
4197   \tweak self-alignment-X #-0.6
4198   #(make-dynamic-script
4199     #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4200
4201
4202 inst =
4203 #(define-music-function
4204      (parser location string)
4205      (string?)
4206    #@{ <>^\markup \bold \box #string #@})
4207 @end example
4208
4209 Ci riferiremo a questo file tramite il comando @code{\include} in cima
4210 al file dove c'è la musica.  Si usa l'estensione @file{.ily} per distinguere
4211 il file da includere, che non intendiamo compilare da solo, dal file principale.
4212 Ora modifichiamo la musica (e salviamo questo file come @file{music.ly}).
4213
4214 @c  We have to do this awkward example/lilypond-non-verbatim
4215 @c  because we can't do the \include stuff in the manual.
4216
4217 @example
4218 \include "definitions.ily"
4219
4220 \relative c'' @{
4221   \tempo 4=50
4222   a4.\mpdolce d8 cis4--\glissando a |
4223   b4 bes a2 |
4224   \inst "Clarinet"
4225   cis4.\< d8 e4 fis |
4226   g8(\! fis)-. e( d)-. cis2 |
4227 @}
4228 @end example
4229
4230 @lilypond[quote,ragged-right]
4231 mpdolce =
4232   \tweak self-alignment-X #-0.6
4233   #(make-dynamic-script
4234     #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4235
4236 inst =
4237 #(define-music-function
4238      (parser location string)
4239      (string?)
4240    #{ <>^\markup \bold \box #string #})
4241
4242 \relative c'' {
4243   \tempo 4=50
4244   a4.\mpdolce d8 cis4--\glissando a |
4245   b4 bes a2 |
4246   \inst "Clarinet"
4247   cis4.\< d8 e4 fis |
4248   g8(\! fis)-. e( d)-. cis2 |
4249 }
4250 @end lilypond
4251
4252 L'aspetto è migliore, ma facciamo ancora qualche modifica.  Il glissando si
4253 vede appena, rendiamolo quindi più spesso e più vicino alle teste di nota.
4254 Mettiamo l'indicazione metronomica al di sopra della chiave invece che della prima
4255 nota.  E, infine, dato che il mio professore di composizione odia l'indicazione
4256 di tempo @qq{C}, usiamo @qq{4/4} al suo posto.
4257
4258 Ma non devi cambiare @file{music.ly} bensì @file{definitions.ily}, in
4259 questo modo:
4260
4261 @example
4262 %%%  definitions.ily
4263 mpdolce =
4264   \tweak self-alignment-X #-0.6
4265   #(make-dynamic-script
4266     #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4267
4268 inst =
4269 #(define-music-function
4270      (parser location string)
4271      (string?)
4272    #@{ <>^\markup \bold \box #string #@})
4273
4274 \layout@{
4275   \context @{
4276     \Score
4277     \override MetronomeMark.extra-offset = #'(-5 . 0)
4278     \override MetronomeMark.padding = #'3
4279   @}
4280   \context @{
4281     \Staff
4282     \override TimeSignature.style = #'numbered
4283   @}
4284   \context @{
4285     \Voice
4286     \override Glissando.thickness = #3
4287     \override Glissando.gap = #0.1
4288   @}
4289 @}
4290 @end example
4291
4292 @lilypond[quote,ragged-right]
4293 mpdolce =
4294   \tweak self-alignment-X #-0.6
4295   #(make-dynamic-script
4296     #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4297
4298 inst =
4299 #(define-music-function
4300      (parser location string)
4301      (string?)
4302    #{ <>^\markup \bold \box #string #})
4303
4304 \layout{
4305   \context {
4306     \Score
4307     \override MetronomeMark.extra-offset = #'(-5 . 0)
4308     \override MetronomeMark.padding = #'3
4309   }
4310   \context {
4311     \Staff
4312     \override TimeSignature.style = #'numbered
4313   }
4314   \context {
4315     \Voice
4316     \override Glissando.thickness = #3
4317     \override Glissando.gap = #0.1
4318   }
4319 }
4320
4321 \relative c'' {
4322   \tempo 4=50
4323   a4.\mpdolce d8 cis4--\glissando a |
4324   b4 bes a2 |
4325   \inst "Clarinet"
4326   cis4.\< d8 e4 fis |
4327   g8(\! fis)-. e( d)-. cis2 |
4328 }
4329 @end lilypond
4330
4331 Ora l'aspetto è decisamente migliore!  Supponiamo ora di voler pubblicare
4332 questo brano.  Il mio professore di composizione non ama il segno di
4333 tempo @qq{C}, mentre a me piace.  Copiamo l'attuale file @file{definitions.ily}
4334 in @file{web-publish.ily} e modifichiamolo.  Dato che questa musica
4335 verrà distribuita su un pdf da leggere a schermo, aumenteremo anche
4336 la dimensione complessiva dell'output.
4337
4338 @example
4339 %%%  web-publish.ily
4340 mpdolce =
4341   \tweak self-alignment-X #-0.6
4342   #(make-dynamic-script
4343     #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4344
4345 inst =
4346 #(define-music-function
4347      (parser location string)
4348      (string?)
4349    #@{ <>^\markup \bold \box #string #@})
4350
4351 #(set-global-staff-size 23)
4352
4353 \layout@{
4354   \context @{
4355     \Score
4356     \override MetronomeMark.extra-offset = #'(-5 . 0)
4357     \override MetronomeMark.padding = #'3
4358   @}
4359   \context @{
4360     \Staff
4361   @}
4362   \context @{
4363     \Voice
4364     \override Glissando.thickness = #3
4365     \override Glissando.gap = #0.1
4366   @}
4367 @}
4368 @end example
4369
4370 @lilypond[quote,ragged-right]
4371 mpdolce =
4372   \tweak self-alignment-X #-0.6
4373   #(make-dynamic-script
4374     #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4375
4376 inst =
4377 #(define-music-function
4378      (parser location string)
4379      (string?)
4380    #{ <>^\markup \bold \box #string #})
4381
4382 #(set-global-staff-size 23)
4383
4384 \layout{
4385   \context { \Score
4386     \override MetronomeMark.extra-offset = #'(-5 . 0)
4387     \override MetronomeMark.padding = #'3
4388   }
4389   \context { \Voice
4390     \override Glissando.thickness = #3
4391     \override Glissando.gap = #0.1
4392   }
4393 }
4394
4395 \relative c'' {
4396   \tempo 4=50
4397   a4.\mpdolce d8 cis4--\glissando a |
4398   b4 bes a2 |
4399   \inst "Clarinet"
4400   cis4.\< d8 e4 fis |
4401   g8(\! fis)-. e( d)-. cis2 |
4402 }
4403 @end lilypond
4404
4405 Nel file che contiene la musica non rimane che sostituire
4406 @code{\include "definitions.ily"} con
4407 @code{\include "web-publish.ily"}.  Potremmo usare un sistema
4408 ancora più conveniente: creare un file @file{definitions.ily} che
4409 contenga solo le definizioni di @code{mpdolce} e @code{inst}, un file
4410 @file{web-publish.ily} che contenga solo la sezione @code{\layout}
4411 vista prima, e un file @file{university.ily} che contenga solo le
4412 modifiche necessarie per produrre l'output preferito dal mio
4413 professore.  L'inizio di @file{music.ly} apparirebbe così:
4414
4415 @example
4416 \include "definitions.ily"
4417
4418 %%% Una sola di queste linee deve essere commentata
4419 \include "web-publish.ily"
4420 %\include "university.ily"
4421 @end example
4422
4423 Questo approccio può essere utile anche se si sta creando un
4424 insieme di parti.  Uso una mezza dozzina di diversi
4425 @q{fogli di stile} per i miei progetti.  Faccio iniziare
4426 ogni file musicale con @code{\include "../global.ily"}, che contiene
4427
4428 @example
4429 %%%   global.ily
4430 \version @w{"@version{}"}
4431
4432 #(ly:set-option 'point-and-click #f)
4433
4434 \include "../init/init-defs.ly"
4435 \include "../init/init-layout.ly"
4436 \include "../init/init-headers.ly"
4437 \include "../init/init-paper.ly"
4438 @end example
4439
4440
4441 @node Altre fonti di informazione
4442 @subsection Altre fonti di informazione
4443 @translationof Other sources of information
4444
4445 La guida al Funzionamento interno contiene molte informazioni su
4446 LilyPond, ma si possono trovare ancora più informazioni nei file
4447 interni di LilyPond.  Per studiarli devi prima trovare la giusta
4448 directory nel tuo sistema operativo.  Il percorso di questa
4449 directory dipende da quale sistema operativo si sta usando e da
4450 come si è ottenuto LilyPond, se scaricando un binario precompilato
4451 da lilypond.org oppure installandolo da un gestore di pacchetti
4452 (come nelle distribuzioni GNU/Linux o nelle istallazioni tramite
4453 fink o cygwin) o compilandolo dai sorgenti:
4454
4455 @subsubheading Scaricato da lilypond.org
4456
4457 @itemize @bullet
4458 @item GNU/Linux
4459
4460 Vai in
4461 @example
4462 @file{@var{INSTALLDIR}/lilypond/usr/@/share/lilypond/current/}
4463 @end example
4464
4465 @item MacOS X
4466
4467 Vai in
4468 @example
4469 @file{@var{INSTALLDIR}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4470 @end example
4471
4472 usando @code{cd} in un terminale per entrare in questa
4473 directory oppure facendo un Ctrl+click sull'applicazione LilyPond e
4474 scegliendo @qq{Mostra i contenuti dei pacchetti}.
4475
4476 @item Windows
4477
4478 Con Windows Explorer vai in
4479 @example
4480 @file{@var{INSTALLDIR}/LilyPond/usr/@/share/lilypond/current/}
4481 @end example
4482
4483 @end itemize
4484
4485 @subsubheading Istallato da un gestore di pacchetti o compilato da sorgenti
4486
4487 Vai in
4488 @file{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, dove
4489 @var{PREFIX} è definito dal gestore pacchetti o dallo
4490 script @code{configure} e @var{X.Y.Z} è il numero di
4491 versione di LilyPond.
4492
4493 @smallspace
4494
4495 All'interno di questa directory le due sottodirectory interessanti sono
4496
4497 @itemize
4498 @item @file{ly/} - contiene i file nel linguaggio di LilyPond
4499 @item @file{scm/} - contiene i file nel linguaggio Scheme
4500 @end itemize
4501
4502 Iniziamo col vedere alcuni file in @file{ly/}.
4503 Apri @file{ly/property-init.ly} in un editor di testo.  Quello
4504 che usi normalmente per i file @code{.ly} va bene.  Questo file
4505 contiene le definizioni di tutti i comandi predefiniti standard
4506 di LilyPond, come @code{\stemUp} e @code{\slurDotted}.  Vedrai
4507 che questi non sono altro che definizioni di variabili che
4508 contengono uno o più comandi @code{\override}.  Ad esempio,
4509 @code{/tieDotted} è definito così:
4510
4511 @example
4512 tieDotted = @{
4513   \override Tie.dash-period = #0.75
4514   \override Tie.dash-fraction = #0.1
4515 @}
4516 @end example
4517
4518 Se non ti piacciono i valori predefiniti, puoi facilmente
4519 definire nuovamente questi comandi, proprio come qualsiasi
4520 altra variabile, all'inizio del file di input.
4521
4522 Ecco i file più utili che si trovano in @file{ly/}:
4523
4524 @multitable @columnfractions .4 .6
4525 @headitem Nome del file
4526   @tab Contenuti
4527 @item @file{ly/engraver-init.ly}
4528   @tab Definizioni dei contesti degli incisori (@emph{engraver})
4529 @item @file{ly/paper-defaults-init.ly}
4530   @tab Specifiche dei valori predefiniti relativi al foglio
4531 @item @file{ly/performer-init.ly}
4532   @tab Definizioni dei contesti dei @emph{performer}
4533 @item @file{ly/property-init.ly}
4534   @tab Definizioni di tutti i comandi predefiniti più comuni
4535 @item @file{ly/spanner-init.ly}
4536   @tab Definizioni dei comandi predefiniti relativi agli estensori (@emph{spanner})
4537 @end multitable
4538
4539 Altre impostazioni (come le definizioni dei comandi di markup) sono
4540 salvate come file @file{.scm} (Scheme).  Il linguaggio di programmazione
4541 Scheme serve a fornire un'interfaccia di programmazione per modificare
4542 il funzionamento interno di LilyPond.  Una spiegazione dettagliata di
4543 questi file non rientra nell'obiettivo di questo manuale, dal momento che
4544 è necessario conoscere il linguaggio Scheme.  Avvisiamo gli utenti che
4545 è richiesta una notevole quantità di abilità tecnica o di tempo per
4546 comprendere Scheme e questi file (vedi @rextend{Scheme tutorial}).
4547
4548 Nel caso tu conosca Scheme, i file che potrebbero essere di interesse sono:
4549
4550 @multitable @columnfractions .4 .6
4551 @headitem Nome del file
4552   @tab Contenuti
4553 @item @file{scm/auto-beam.scm}
4554   @tab Valori predefiniti della disposizione delle travature
4555 @item @file{scm/define-grobs.scm}
4556   @tab Impostazioni predefinite delle proprietà dei grob
4557 @item @file{scm/define-markup-commands.scm}
4558   @tab Definizione di tutti i comandi di markup
4559 @item @file{scm/midi.scm}
4560   @tab Impostazioni predefinite dell'output MIDI
4561 @item @file{scm/output-lib.scm}
4562   @tab Impostazioni che modificano l'aspetto di tasti, colori,
4563        alterazioni, stanghette, etc.
4564 @item @file{scm/parser-clef.scm}
4565   @tab Definizioni delle chiavi supportate
4566 @item @file{scm/script.scm}
4567   @tab Impostazioni predefinite delle articolazioni
4568 @end multitable
4569
4570
4571 @node Modifiche avanzate con Scheme
4572 @subsection Modifiche avanzate con Scheme
4573 @translationof Advanced tweaks with Scheme
4574
4575 Anche se molte cose sono possibili con i comandi @code{\override} e
4576 @code{\tweak}, un modo ancor più potente di modificare l'azione
4577 di LilyPond è resa possibile da un interfaccia programmabile al
4578 funzionamento interno di LilyPond.  Il codice scritto nel linguaggio
4579 di programmazione Scheme può essere incorporato direttamente nel
4580 funzionamento interno di LilyPond.  Ovviamente, per farlo è necessaria
4581 almeno una conoscenza di base della programmazione in Scheme;
4582 abbiamo scritto un'introduzione in @rextend{Scheme tutorial}.
4583
4584 Come esempio di una delle tante possibilità, invece di impostare
4585 una proprietà su un valore costante, si può impostare su una
4586 procedura Scheme che viene poi chiamata ogni volta che LilyPond
4587 accede a quella proprietà.  La proprietà può essere poi impostata
4588 dinamicamente su un valore determinato dalla procedura nel momento
4589 in cui viene chiamata.  In questo esempio coloriamo le teste delle
4590 note in base alla loro posizione sul rigo.
4591
4592 @cindex funzione x11-color, esempio d'uso
4593 @cindex x11-color, esempio d'uso
4594 @cindex NoteHead, esempio di sovrascrittura
4595 @cindex proprietà color, impostare su procedura Scheme
4596 @cindex color, impostare su procedura Scheme
4597
4598 @lilypond[quote,verbatim,ragged-right]
4599 #(define (color-notehead grob)
4600    "Colora le teste di nota in base alla loro posizione sul rigo."
4601    (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4602                                7)))
4603      (case mod-position
4604        ;;   Return rainbow colors
4605        ((1) (x11-color 'red    ))  ; for C
4606        ((2) (x11-color 'orange ))  ; for D
4607        ((3) (x11-color 'yellow ))  ; for E
4608        ((4) (x11-color 'green  ))  ; for F
4609        ((5) (x11-color 'blue   ))  ; for G
4610        ((6) (x11-color 'purple ))  ; for A
4611        ((0) (x11-color 'violet ))  ; for B
4612        )))
4613
4614 \relative c' {
4615   % Fa sì che il colore sia preso dalla procedura color-notehead
4616   \override NoteHead.color = #color-notehead
4617   a2 b | c2 d | e2 f | g2 a |
4618 }
4619 @end lilypond
4620
4621 Altri esempi che mostrano l'uso di queste interfacce programmabili
4622 si trovano in @rextend{Callback functions}.