@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 7ba0a22641cb0c7f5949d66a06d1e2e1fd0b3033
+ 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
@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
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"
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
È 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.
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.
@{ 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