Imported Upstream version 2.16.0

[lilypond.git] / Documentation / it / usage / external.itely

diff --git a/Documentation/it/usage/external.itely b/Documentation/it/usage/external.itely
index 8bcd600884d6e83205596b1583f2451fa1ae388b..ed52247469b5e52d582dae2ee21de8ba158e3dd2 100644 (file)
--- a/Documentation/it/usage/external.itely
+++ b/Documentation/it/usage/external.itely
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
 
 @ignore
-    Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48
+    Translation of GIT committish: da632500cfc55fcd3660f72b39c7dbcd7542f9bc
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.13.36"
+@c \version "2.16.0"
 
 @node Programmi esterni
 @chapter Programmi esterni
@@ -29,6 +29,18 @@ LilyPond può interagire con altri programmi in vari modi.
 @section Punta e clicca
 @translationof Point and click
 
+Il "punta e clicca" aggiunge dei collegamenti ai documenti pdf per certi
+elementi musicali.
+
+@menu
+* Abilitare il punta e clicca::
+* Punta e clicca selettivo::
+@end menu
+
+@node Abilitare il punta e clicca
+@unnumberedsubsec Abilitare il punta e clicca
+@translationof Enabling point and click
+
 @cindex punta e clicca
 
 Il "punta e clicca" (@emph{point and click}) permette di individuare gli elementi
@@ -44,8 +56,8 @@ in modo che segua i collegamenti ipertestuali usando lo script @file{lilypond-in
 fornito insieme a LilyPond.
 
 Per Xpdf su UNIX, occorre inserire la seguente linea nel file
-@file{xpdfrc}@footnote{Su UNIX, questo file si trova in
-@file{/etc/xpdfrc} o come @file{.xpdfrc} nella propria directory home.}
+@file{xpdfrc}.  Su UNIX, questo file si trova in
+@file{/etc/xpdfrc} o @file{$HOME/.xpdfrc}.
 
 @example
 urlCommand     "lilypond-invoke-editor %s"
@@ -115,6 +127,84 @@ lilypond -dno-point-and-click file.ly
 che si vogliano diffondere, per evitare di includere nel file .pdf delle informazioni
 sui percorsi del proprio computer: questo infatti può costituire un rischio di
 sicurezza.}
+
+@node Punta e clicca selettivo
+@unnumberedsubsec Punta e clicca selettivo
+@translationof Selective point-and-click
+
+Per alcune applicazioni interattive, si potrebbe voler includere
+soltanto alcuni elementi punta e clicca.  Ad esempio, se qualcuno
+volesse creare un'applicazione che riproduca audio o video a partire
+da una nota in particolare, sarebbe inopportuno che il clic sulla
+nota portasse alla posizione di un'alterazione o di una legatura
+che si trovi sopra quella nota.
+
+Questo può essere controllato indicando quali eventi includere:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'note-event
+\relative c' @{
+  c2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click 'note-event)
+\relative c' @{
+  c2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@example
+lilypond -dpoint-and-click=note-event   example.ly
+@end example
+
+@end itemize
+
+Si può includere più di un evento:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'(note-event dynamic-event)
+\relative c' @{
+  c2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click '(note-event dynamic-event))
+\relative c' @{
+  c2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@smallexample
+lilypond \
+  -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
+  example.ly
+@end smallexample
+
+
+@end itemize
+
+
 @node LilyPond e gli editor di testo
 @section LilyPond e gli editor di testo
 @translationof Text editor support
@@ -246,7 +336,7 @@ la modalità relativa, mentre le durate sono precisate solo quando necessario.
 È possibile registrare un file MIDI usando una tastiera digitale e poi
 convertirlo in file @file{.ly}.  Tuttavia, la conversione da MIDI a LY non
 è banale: l'esecuzione umana non sarà mai sufficientemente precisa dal punto di vista
-ritmico.  Se lanciata con la quantizzazione (opzioni @code{-s} e @code{-d})
+ritmico.  Se lanciata con la quantizzazione (opzioni @option{-s} e @option{-d})
 @command{midi2ly} cerca di compensare questi errori di tempo, ma non è
 molto efficace.  Dunque non si raccomanda l'uso di @command{midi2ly}
 per i file midi generati a partire da un'esecuzione umana.
@@ -350,10 +440,17 @@ mostra una sintesi dell'utilizzo e delle opzioni.
 usa LANG per i nomi delle altezze, ad esempio 'deutsch' per i nomi delle note
 in tedesco.
 
+@item --loglevel=@var{loglevel}
+Imposta la verbosità dell'output su @var{loglevel}. I valori possibili sono @code{NONE},
+@code{ERROR}, @code{WARNING}, @code{PROGRESS} (predefinito) e @code{DEBUG}.
+
 @item --lxml
 usa il pacchetto Python lxml.etree per l'analisi della sintassi XML; usa meno
 memoria e tempo del processore.
 
+@item -m, --midi
+attiva il blocco midi.
+
 @item --nd --no-articulation-directions
 non converte le direzioni (@code{^}, @code{_} o @code{-}) per
 articolazioni, dinamiche, etc.
@@ -563,13 +660,21 @@ le seguenti opzioni
 @{ c1 @}
 @end example
 
-Per creare un file @file{EPS}, si usa
+Per creare file immagine utili, si usa
 
 @example
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts   miofile.ly
+EPS
+
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly
+
+PNG
 
-@file{PNG}:
 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miofile.ly
+
+Un file PNG transparente
+
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
+  -dpixmap-format=pngalpha --png miofile.ly
 @end example