<sect1 id="howto-troubleshooting">
<title
>Individuare il problema</title>

<sect2 id="howto-troubleshooting-support">
<title
>Ottenere supporto</title>

<para
>Ci sono diversi modi per ottenere aiuto con &kplayer;. Se vuoi porre una domanda, entra nel <ulink url="irc://irc.freenode.net/#kplayer"
>canale #kplayer</ulink
> su FreeNode <acronym
>IRC</acronym
> o scrivi sul <ulink url="http://sourceforge.net/forum/forum.php?forum_id=244388"
>forum utenti</ulink
> dove altri utenti potranno vedere il messaggio, così come lo sviluppatore che certamente ha sottoscritto la ricezione degli avvisi quando un nuovo messaggio viene inserito. Il canale <acronym
>IRC</acronym
> e il forum utenti sono anche buoni posti per discutere di un problema.</para>

<para
>Eventuali bug dovrebbero essere segnalati attraverso il <ulink url="http://sourceforge.net/tracker/?atid=532182&amp;group_id=71710"
>sistema di bug tracking</ulink
>, seguendo le istruzioni contenute nel <link linkend="howto-bug-reporting"
>micro-HOWTO Segnalazione bug</link
>. Ci sono inoltre sezioni speciali del <ulink url="http://sourceforge.net/projects/kplayer/"
>progetto &kplayer;</ulink
> su SourceForge per <ulink url="http://sourceforge.net/tracker/?atid=532183&amp;group_id=71710"
>richieste di supporto</ulink
>, <ulink url="http://sourceforge.net/tracker/?atid=532185&amp;group_id=71710"
>richieste di funzionalità</ulink
> e <ulink url="http://sourceforge.net/tracker/?group_id=71710&amp;atid=532184"
>patch al codice</ulink
>.</para>

</sect2>

<sect2 id="howto-troubleshooting-problems">
<title
>Problemi comuni</title>

<sect3>
<title
>La maggior parte dei comando nel menu e nella barra degli strumenti sono mancanti</title>

<para
>The <filename
>kplayerui.rc</filename
> file was misplaced during installation, and &kplayer; cannot find it. If you installed using a binary package, complain to the package maintainer. When compiling from source, be sure to follow the instructions in the <link linkend="howto-compilation"
>Compilation micro-HOWTO</link
>, especially the part about <command
>kde-config</command
>. Before starting, run</para>

<para
><userinput
><command
>kde-config</command
> <option
>--prefix</option
></userinput
></para>

<para
>dalla riga di comando per essere sicuri che il percorso prefisso di &kde;.</para>

</sect3>

<sect3>
<title
>Dopo un aggiornamento di &kplayer; le nuove funzionalità sono mancanti</title>

<para
>Potresti avere un file chiamato <filename
>kplayerui.rc</filename
> in <filename
>~/.kde/share/apps/kplayer</filename
>. La sua rimozione ti permetterà di ottenere i nuovi menu, ma azzererà anche le scorciatoie da tastiera che potresti aver modificato nella <link linkend="configuration-shortcuts"
>finestra di associazione dei tasti</link
>.</para>

</sect3>

<sect3>
<title
>&kplayer; non viene visualizzato nel sottomenu <guisubmenu
>Multimedia</guisubmenu
> del &kmenu;</title>

<para
>Il file <filename
>kplayer.desktop</filename
> deve essere installato nella corretta posizione, in <filename
>share/applnk/Multimedia</filename
> o in <filename
>share/applications/kde</filename
> nella cartella globale di &kde;.</para>

<para
>There also may be a file called <filename
>kde-kplayer.desktop</filename
> in <filename
>~/.local/share/applications</filename
>. Removing it will get the <guisubmenu
>Multimedia</guisubmenu
> menu updated automatically again when you install or uninstall &kplayer;, but it will also reset changes you made to &kplayer; associations with media types on the <guilabel
>File Associations</guilabel
> page in &konqueror; configuration dialog or in &kcontrolcenter;.</para>

<para
>La scheda <guilabel
>Indice</guilabel
> in &khelpcenter; dovrebbe elencare anche &kplayer; nella sezione <guilabel
>Multimedia</guilabel
> sotto <guilabel
>Manuali delle applicazioni</guilabel
>.</para>

</sect3>

<sect3>
<title
>Impossibile avviare &mplayer;</title>

<para
>Se ottieni questo errore cercando di riprodurre un file, è necessario installare &mplayer; prima di poter utilizzare &kplayer;. Questo errore si può verificare anche se il nomde dell'eseguibile di &mplayer; non è <command
>mplayer</command
> o non è nel percorso attuale. In questo caso, occorre spostarsi nella pagina <link linkend="settings-advanced"
>Avanzate</link
> in <guilabel
>Impostazione di &kplayer;</guilabel
> e fornire il nome dell'eseguibile o il percorso assoluto nel campo <guilabel
>Percorso dell'eseguibile</guilabel
></para>

</sect3>

<sect3>
<title
>configure: errore: Impossibile trovare le librerie di X</title>

<para
>Ciò significa che mancano i file include di X, che normalmente sono forniti dal pacchetto di sviluppo di X. Cercare un pacchetto della propria distribuzione che contenga file tipo X.h e XEvent.h. Per esempio, in Debian si chiama <literal
>xlibs-dev</literal
>.</para>

<para
>Similarly, if <command
>configure</command
> complains about missing Qt files, you need to find and install the Qt development package. If you look in the <filename
>config.log</filename
>, it will probably tell you the exact name of the file it couldn't find, somewhere near the bottom. The <filename
>config.log</filename
> file is quite verbose, so you would have to scroll a few pages up from the bottom to find the place where it reports the error.</para>

</sect3>

<sect3>
<title
>Impossibile riprodurre alcun file</title>

<para
>Guardare alla fine del registro messaggi per vedere gli errori che &mplayer; restituisce quando si cerca di riprodurre i file. Premere <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> se &kplayer; non mostra automaticamente il registro.</para>

<para
>Try playing the files with <command
>mplayer</command
> from the command line. If &mplayer; can play them, compare the options you used on the command line to the ones &kplayer; passed to &mplayer;. Set the required options in <link linkend="settings"
>&kplayer; Settings</link
>. The most important ones are the <guilabel
>Driver</guilabel
> options on the <link linkend="settings-video"
>Video</link
> and <link linkend="settings-audio"
>Audio</link
> pages. On the <link linkend="settings-advanced"
>Advanced page</link
> check the <guilabel
>Executable path</guilabel
> option to make sure &kplayer; will be able to find the &mplayer; executable, and if there are any options that are not found anywhere in the <guilabel
>&kplayer; Settings</guilabel
> dialog, put them in the <guilabel
>Additional command line arguments</guilabel
> field.</para>

</sect3>

<sect3>
<title
>Impossbile riprodurre uno specifico file</title>

<para
>Guardare alla fine del registro messaggi per vedere gli errori che &mplayer; restituisce quando si cerca di riprodurre il file. Premere <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> se &kplayer; non mostra automaticamente il registro.</para>

<para
>Try playing the file with <command
>mplayer</command
> from the command line. If &mplayer; can play it, but requires special option to play this particular file, put them in the <link linkend="properties"
>File Properties</link
> for that file. Two options that sometimes help &mplayer; when it cannot detect the file type automatically are <option
>-vc</option
> and <option
>-ac</option
>, which correspond to the <guilabel
>Codec</guilabel
> options on the <link linkend="properties-video"
>Video</link
> and <link linkend="properties-audio"
>Audio</link
> pages in <guilabel
>File Properties</guilabel
>. If there are any options that are not found anywhere in the <guilabel
>File Properties</guilabel
> dialog, put them in the <guilabel
>Additional command line arguments</guilabel
> field.</para>

<para
>If it is a playlist file but it does not have one of the standard playlist file extensions, go to the <link linkend="properties-general"
>General page</link
> in the <guilabel
>File Properties</guilabel
> and set the <guilabel
>Playlist</guilabel
> option to <guilabel
>yes</guilabel
>. In rare cases a file that is not a playlist may have a playlist extension. Then you will need to set the <guilabel
>Playlist</guilabel
> property to <guilabel
>no</guilabel
>. For more details see the <link linkend="howto-playlist-files"
>Playlist files</link
> section in the Playlist micro-HOWTO.</para>

</sect3>

<sect3>
<title
>Impossibile riprodurre file video</title>

<para
>Se &kplayer; riproduce solo file audio ma non file video, potrebbe esserci un problema con l'uscita video. In modo predefinito &kplayer; utilizza l'<link linkend="howto-installation-xvideo"
>estensione XVideo</link
> per l'uscita video. Se l'estensione non è abilitata o è utilizzata da un altro programma come <application
>Kino</application
>, &kplayer; potrebbe non essere in grado di utilizzare un'uscita video differente. Puoi abilitare l'estensione XVideo o dire a &kplayer; di utilizzare un'altra uscita video. Vedi il <link linkend="howto-configuration"
>micro-HOWTO Configurazione</link
> per i dettagli.</para>

</sect3>

<sect3>
<title
>Il video è riprodotto correttamente, ma non c'è suono</title>

<para
>Guardare nel <link linkend="parts-message-log"
>Registro messaggi</link
> per vedere perché &mplayer; non è in grado di riprodurre l'audio. Il problema più comune è legato al blocco del dispositivo audio da parte di un altro programma. In questo caso il sospetto principale è <command
>artsd</command
>. Prova ad eseguire</para>

<para
><userinput
><command
>killall</command
> artsd</userinput
></para>

<para
>dalla riga di comando. Se ciò è di aiuto, la soluzione definitiva è aprire il &kcontrolcenter; e disabilitare &arts;. &arts; e tutto ciò che ne deriva è decisamente la parte peggiore di &kde;.Fortunatamente è prevista la sua sostituzione in &kde; 4.</para>

<para
>Per ulteriori informazioni sulla configurazione audio di &kplayer; vedi il <link linkend="howto-configuration-audio"
>micro-HOWTO Configurazione</link
>.</para>

</sect3>

<sect3>
<title
>&kplayer; non può riprodurre un file che viene riprodotto correttamente con &mplayer;</title>

<para
>Quando &kplayer; è in <guilabel
>Esecuzione</guilabel
> o <guilabel
>Riproduzione</guilabel
>, esegui</para>

<para
><userinput
><command
>ps</command
> <option
>auxww</option
></userinput
></para>

<para
>from the command line. Compare the command line options that &kplayer; uses to run &mplayer; to what you are using to play the file with &mplayer;. Then start adding missing options one by one until you get the same problem you are getting in &kplayer;. After you find out what option is causing the problem, you can open the <link linkend="settings"
>configuration dialog</link
> in &kplayer; and remove or change that option. If you need to make the change just for that one file, go to the <link linkend="properties"
>File Properties</link
> instead.</para>

</sect3>

<sect3>
<title
>Problemi al ritorno dalla modalità a schermo intero</title>

<para
>If you are getting problems when you try to go back to normal window size from full screen mode, for example the window becomes too large or you are seeing endless flickering, you can try unselecting the <guilabel
>Resize main window automatically</guilabel
> option on the <link linkend="settings-general"
>General page</link
> in <guilabel
>&kplayer; Settings</guilabel
>. Also read the thread about this problem at the <ulink url="http://sourceforge.net/forum/forum.php?thread_id=1122221&amp;forum_id=244388"
>&kplayer; user forum</ulink
> and watch it for updates.</para>

</sect3>

<sect3>
<title
>La stazione radio richiede troppo tempo per iniziare la riproduzione</title>

<para
>In modo predefinito &kplayer; permette a &mplayer; di scegliere una dimensione ottimale della cache. La riproduzione di media a basso bitrate come una stazione radio richiederà del tempo per riempirla. Se ciò accade, puoi scegliere una <guilabel
>dimensione della cache</guilabel
> minore impostandola nella pagina <guilabel
>Avanzate</guilabel
> sia globalmente in <link linkend="settings-advanced"
>Impostazione di &kplayer;</link
> che nelle <link linkend="properties-advanced"
>Proprietà del file</link
> per i singoli media. Inserisci la dimensione minima della cache nel campo <guilabel
>Parametri aggiuntivi della riga di comando</guilabel
>, ad esempio <literal
>-cache-min 5</literal
>, o scegli <guilabel
>imposta dimensioni</guilabel
> per l'opzione <guilabel
>Cache</guilabel
> e inserisci una dimensione in kilobyte. Per ulteriori informazioni sulla riproduzione di media in linea vedi il <link linkend="howto-streams"
>micro-HOWTO Flussi</link
>.</para>

</sect3>

<sect3>
<title
>I file video di grandi dimensioni richiedono troppo tempo per iniziare la riproduzione</title>

<para
>Potresti aver impostato l'opzione <guilabel
>Dimensione cache</guilabel
> a un valore troppo basso nelle <link linkend="settings-advanced"
>Impostazioni di &kplayer;</link
>. Se necessiti di impostarla a un valore maggiore o inferiore per un singolo file o flusso, devi farlo nella <link linkend="properties-advanced"
>pagina Avanzate</link
> in <guilabel
>Proprietà del file</guilabel
>.</para>

</sect3>

<sect3>
<title
>&konqueror; mostra solo l'area del video</title>

<para
>If you open a web page with an embedded multimedia object in &konqueror;, only the video area is displayed, with no controls. Then you should <mousebutton
>right</mousebutton
> click the <link linkend="parts-video-area"
>video area</link
> and choose the <guimenuitem
>Start &kplayer;</guimenuitem
> command. Playback will then stop, and the full &kplayer; will open up and start playing the file or <acronym
>URL</acronym
>.</para>

</sect3>

<sect3>
<title
>I controlli di contrasto e luminosità non funzionano</title>

<para
>You need to enable the <link linkend="howto-installation-xvideo"
>XVideo extension</link
> in your X11 configuration and make sure the XVideo video output is selected on the <link linkend="settings-advanced"
><guilabel
>Video</guilabel
> page</link
> in <guilabel
>&kplayer; Settings</guilabel
>. However, if you cannot use the XVideo output, you can still make the video controls to work by putting the <literal
>-vf eq2</literal
> or <literal
>-vf eq</literal
> option into the <guilabel
>Additional command line parameters</guilabel
> field on the <link linkend="properties-advanced"
>Advanced page</link
> in <guilabel
>&kplayer; Settings</guilabel
>.</para>

</sect3>

</sect2>

</sect1>
