<chapter id="advanced-features">
<title
>Caratteristiche avanzate di amaroK</title>


<sect1 id="keybd-shortcuts">
<title
>Scorciatoie tastiera</title>

<para
>&amarok; usa scorciatoie di tastiera come la maggior parte delle altre applicazioni. Sotto trovi una lista di queste scorciatoie e le rispettive azioni. Le scorciatoie globali possono essere configurate facendo click con il pulsante destro del mouse nella finestra del lettore e selezionando <guimenuitem
>Configura scorciatoie globali...</guimenuitem
>. Le scorciatoie di &amarok; possono essere configurate facendo click con il pulsante destro del mouse nella finestra del lettore e selezionando <guimenuitem
>Configura scorciatoie...</guimenuitem
>.</para>

<tip
><para
>Puoi programmare i tasti multimediali affinché funzionino come scorciatoie per &amarok; facendo divenire la tua tastiera un centro di controllo di &amarok;.</para
></tip>

<para
>Le scorciatoie globali sono:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinazione tasti</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>X</keycap
></keycombo
></entry>
<entry
>Play</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Pausa</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>V</keycap
></keycombo
></entry>
<entry
>Stop</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Prossima traccia</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Traccia precedente</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>tasto + in tast.num.</keycap
></keycombo
></entry>
<entry
>Aumenta volume</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>tasto - in tast.num.</keycap
></keycombo
></entry>
<entry
>Diminuisci volume</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Aggiungi file</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Attiva/disattiva playlist</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>Mostra OSD</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>Le scorciatoie di &amarok; sono:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinazione tasti</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Copia</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>invio in tast.num.</keycap
></keycombo
></entry>
<entry
>Vai all'attuale</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Chiudi</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Ripeti</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Salva la playlist</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Seleziona tutto</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>H</keycap
></keycombo
></entry>
<entry
>Mescola</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Annulla</entry>
</row>


</tbody>
</tgroup>
</informaltable>


<para
>Le scorciatoie per il navigatore della playlist sono:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinazione tasti</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Barra spazio</keycap
></entry>
<entry
>Carica playlist</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Rinomina playlist</entry>
</row>

<row>
<entry
><keycap
>Tasto di cancellazione a sinistra</keycap
></entry>
<entry
>Rimuove playlist</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="the-dcop-interface">
<title
>L'interfaccia DCOP</title>

<para
>Con l'interfaccia DCOP di amaroK, puoi controllare facilmente amaroK con script tuoi.</para>

<para
>L'interfaccia DCOP di amaroK ha multe funzioni generiche che possono essere trovate in altre applicazioni KDE. Questa sezione descrive le funzioni DCOP del lettore. Un esempio della funzione dcop <quote
>pausa</quote
> potrebbe essere il seguente:</para>

<para
><prompt
>&percnt;</prompt
>dcop amarok player pause</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Funzione DCOP</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
>album</entry>
<entry
>La funzione <quote
>album</quote
> mostra l'album della traccia in riproduzione.</entry>
</row>

<row>
<entry
>artist</entry>
<entry
>La funzione <quote
>artist</quote
> mostra l'artista della traccia in riproduzione</entry>
</row>

<row>
<entry
>bitrate</entry>
<entry
>La funzione <quote
>bitrate</quote
> mostra il bitrate della traccia in riproduzione.</entry>
</row>

<row>
<entry
>comment</entry>
<entry
>La funzione <quote
>comment</quote
> mostra il commento della traccia in riproduzione.</entry>
</row>

<row>
<entry
>coverImage</entry>
<entry
>La funzione <quote
>coverImage</quote
> mostra l'URL della copertina della traccia attuale.</entry>
</row>

<row>
<entry
>currentTime</entry>
<entry
>La funzione <quote
>currentTime</quote
> mostra la posizione (mm:ss) della traccia in riproduzione.</entry>
</row>

<row>
<entry
>encodedURL</entry>
<entry
>La funzione <quote
>encodeURL</quote
> mostra l'URL della traccia attuale con spazi codificati.</entry>
</row>

<row>
<entry
>genre</entry>
<entry
>La funzione <quote
>genre</quote
> mostra il genere della traccia in riproduzione.</entry>
</row>

<row>
<entry
>nowPlaying</entry>
<entry
>La funzione <quote
>nowPlaying</quote
> mostra "Artista - Titolo" della traccia in riproduzione. Se uno dei due tag id3 è vuoto, verrà mostrato solo "Artista" o "Titolo" (senza il "-").</entry>
</row>

<row>
<entry
>title</entry>
<entry
>La funzione <quote
>title</quote
> mostra il titolo della traccia in riproduzione.</entry>
</row>

<row>
<entry
>totalTime</entry>
<entry
>La funzione <quote
>totalTime</quote
> mostra la durata totale (mm:ss) della traccia in riproduzione.</entry>
</row>

<row>
<entry
>traccia</entry>
<entry
>La funzione <quote
>track</quote
> mostra il numero della traccia in riproduzione.</entry>
</row>

<row>
<entry
>year</entry>
<entry
>La funzione <quote
>year</quote
> mostra l'anno della traccia in riproduzione.</entry>
</row>

<row>
<entry
>isPlaying</entry>
<entry
>La funzione <quote
>isPlaying</quote
> restituisce un valore di vero o falso per indicare le il lettore è in riproduzione o meno.</entry>
</row>

<row>
<entry
>randomModeStatus</entry>
<entry
>La funzione <quote
>randomModeStatus</quote
> mostra lo stato della modalità casuale con un valore di vero o falso.</entry>
</row>

<row>
<entry
>repeatPlaylistStatus</entry>
<entry
>La funzione <quote
>repeatPlaylistStatus</quote
> mostra lo stato di Ripeti Playlist con un valore di vero o falso.</entry>
</row>

<row>
<entry
>repeatTrackStatus</entry>
<entry
>La funzione <quote
>repeatTrackStatus</quote
> mostra lo stato di Ripeti Traccia con un valore di vero o falso.</entry>
</row>

<row>
<entry
>getVolume</entry>
<entry
>La funzione <quote
>getVolume</quote
> ritorna un valore per il livello del volume specificato da un valore tra 0 e 100.</entry>
</row>

<row>
<entry
>sampleRate</entry>
<entry
>La funzione <quote
>sampleRate</quote
> mostra il campionamento della traccia in riproduzione.</entry>
</row>

<row>
<entry
>score</entry>
<entry
>La funzione <quote
>score</quote
> mostra il punteggio della traccia attuale.</entry>
</row>

<row>
<entry
>status</entry>
<entry
>La funzione <quote
>status</quote
> ritorna un valore per lo stato del motore, 2 se in uso, 1 se in pausa e 0 se inattivo.</entry>
</row>

<row>
<entry
>trackCurrentTime</entry>
<entry
>La funzione <quote
>trackCurrentTime</quote
> restituisce un valore dell'attuale tempo trascorso della traccia in secondi.</entry>
</row>

<row>
<entry
>trackTotalTime</entry>
<entry
>La funzione <quote
>trackTotalTime</quote
> restituisce un valore della durata totale della traccia attuale in secondi.</entry>
</row>

<row>
<entry
>addMedia</entry>
<entry
>La funzione <quote
>addMedia</quote
> è usata per aggiungere singoli file alla playlist.</entry>
</row>

<row>
<entry
>addMediaList</entry>
<entry
>La funzione <quote
>addMediaList</quote
> è usata per aggiungere più file alla playlist.</entry>
</row>

<row>
<entry
>clearPlaylist</entry>
<entry
>La funzione <quote
>clearPlaylist</quote
> è usata per pulire l'intera playlist.</entry>
</row>

<row>
<entry
>configEqualizer</entry>
<entry
>La funzione <quote
>configEqualizer</quote
> alza la finestra di configurazione dell'equalizzatore.</entry>
</row>

<row>
<entry
>enableOSD</entry>
<entry
>La funzione <quote
>enableOSD</quote
> permette di gestire l'On-Screen-Display con un valore di vero o falso.</entry>
</row>

<row>
<entry
>enableRandomMode</entry>
<entry
>La funzione <quote
>enableRandomMode</quote
> è usata per gestire la modalità casuale con un valore di 0 disabilitata, e 1 abilitata.</entry>
</row>

<row>
<entry
> mute</entry>
<entry
>La funzione <quote
>mute</quote
> permette di togliere e rimettere il suono alla traccia in riproduzione.</entry>
</row>

<row>
<entry
>next</entry>
<entry
>La funzione <quote
>next</quote
> fa avanzare il lettore di una traccia.</entry>
</row>

<row>
<entry
>pause</entry>
<entry
>La funzione <quote
>pause</quote
> mette in pausa la traccia in riproduzione.</entry>
</row>

<row>
<entry
>play</entry>
<entry
>La funzione <quote
>play</quote
> fa ripartire il lettore da dove fu fermato.</entry>
</row>

<row>
<entry
>playMedia</entry>
<entry
>La funzione <quote
>playMedia</quote
> fa partire la riproduzione di una traccia specificata con il suo KURL.</entry>
</row>

<row>
<entry
>playPause</entry>
<entry
>La funzione <quote
>playPause</quote
> fa partire il lettore se questo è attualmente fermo od in pausa. Questa funzione, inoltre, mette in pausa il lettore se era in riproduzione.</entry>
</row>

<row>
<entry
>prev</entry>
<entry
>La funzione <quote
>prev</quote
> muove il lettore indietro di una traccia.</entry>
</row>

<row>
<entry
>saveCurrentPlaylist</entry>
<entry
>La funzione <quote
>saveCurrentPlaylist</quote
> salva l'attuale playlist come ~/.kde/share/apps/amarok/current.xml.</entry>
</row>


<row>
<entry
>scanCollection</entry>
<entry
>La funzione <quote
>scanCollection</quote
> esegue una scansione manuale della collezione.</entry>
</row>

<row>
<entry
>seek</entry>
<entry
>La funzione <quote
>seek</quote
> è utilizzata per cercare in un punto specifico in una traccia per un valore specificato di secondi.</entry>
</row>

<row>
<entry
>seekRelative</entry>
<entry
>La funzione <quote
>seekRelative</quote
> è utilizzata per cercare in un punto relativo alla posizione della traccia attuale per un valore specificato in secondi.</entry>
</row>

<row>
<entry
>setEqualizerEnabled</entry>
<entry
>La funzione <quote
>setEqualizerEnabled</quote
> serve ad abilitare l'equalizzatore utilizzando un valore vero o false.</entry>
</row>

<row>
<entry
>setVolume</entry>
<entry
>La funzione <quote
>setVolume</quote
> regola il volume ad un livello specificato da un valore tra 0 e 100.</entry>
</row>

<row>
<entry
>showOSD</entry>
<entry
>La funzione <quote
>showOSD</quote
> fa apparire l'OSD per mostrare le informazioni della traccia attuale.</entry>
</row>

<row>
<entry
>stop</entry>
<entry
>La funzione <quote
>stop</quote
> ferma il lettore se è in riproduzione.</entry>
</row>

<row>
<entry
>togglePlaylist</entry>
<entry
>La funzione <quote
>togglePlaylist</quote
> abilita o meno la finestra della playlist.</entry>
</row>

<row>
<entry
>volumeDown</entry>
<entry
>La funzione <quote
>volumeDown</quote
> abbassa il volume di uno scalino.</entry>
</row>

<row>
<entry
>volumeUp</entry>
<entry
>La funzione <quote
>volumeUp</quote
> aumenta il volume di uno scalino.</entry>
</row>


</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmd-line-options">
<title
>Opzioni linea di comando</title>

<para
>amaroK supporta l'uso delle opzioni standard dei comandi di linea di Qt e kde. amaroK ha inoltre le proprie opzioni specifiche.</para>

<para
>Le opzioni Qt e kde:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Opzioni</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
>--help</entry>
<entry
>Mostra l'aiuto sulle opzioni.</entry>
</row>

<row>
<entry
>--help-qt</entry>
<entry
>Mostra le opzioni specifiche di Qt.</entry>
</row>

<row>
<entry
>--help-kde</entry>
<entry
>Mostra le opzioni specifiche di KDE.</entry>
</row>

<row>
<entry
>--help-all</entry>
<entry
>Mostra tutte le opzioni.</entry>
</row>

<row>
<entry
>--author</entry>
<entry
>Mostra le informazioni dell'autore.</entry>
</row>

<row>
<entry
>-v, --version</entry>
<entry
>Mostra le informazioni della versione.</entry>
</row>

<row>
<entry
>--license</entry>
<entry
>Mostra le informazioni della licenza.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>Le opzioni di amaroK:</para>

<note
><para
>Le opzioni di &amarok; sono costruite per essere usate mentre &amarok; è in funzione.</para
></note>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Opzioni</entry>
<entry
>Azione</entry>
</row>
</thead>
<tbody>

<row>
<entry
>-r, --previous</entry>
<entry
>Salta alla traccia precedente nella playlist.</entry>
</row>

<row>
<entry
>-p, --play</entry>
<entry
>Inizia a riprodurre l'attuale playlist.</entry>
</row>

<row>
<entry
>-s, --stop</entry>
<entry
>Ferma la riproduzione.</entry>
</row>

<row>
<entry
>--pause</entry>
<entry
>Mette in pausa la riproduzione.</entry>
</row>

<row>
<entry
>-f, --next</entry>
<entry
>Salta alla prossima traccia nella playlist.</entry>
</row>

<row>
<entry
>-a, --append</entry>
<entry
>Accoda file/URL alla playlist.</entry>
</row>

<row>
<entry
>-e, --enqueue</entry>
<entry
>Vedi append, disponibile per retro compatibilità.</entry>
</row>

<row>
<entry
>--queue</entry>
<entry
>Accoda file/URL dopo la traccia in riproduzione.</entry>
</row
> 

<row>
<entry
>-m, --toggle-playlist-window</entry>
<entry
>Attiva/disattiva la finestra della playlist.</entry>
</row>

<row>
<entry
>--wizard</entry>
<entry
>Lancia l'assistente del primo avvio.</entry>
</row>

<row>
<entry
>--engine "name"</entry>
<entry
>Avvia &amarok; con il motore "name".</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

</chapter>
