<sect1 id="howto-troubleshooting">
<title
>Risoluzione dei problemi</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 segnalazione errori</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"
>correzioni 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
>Il file <filename
>kplayerui.rc</filename
> è stato inserito nella posizione sbagliata durante l'installazione e &kplayer; non riesce a trovarlo. Se hai eseguito l'installazione usando un pacchetto binario, contatta il responsabile del pacchetto. Se compili da sorgente, assicurati di seguire le istruzioni nel <link linkend="howto-compilation"
>micro-HOWTO Compilazione</link
>, in special modo la parte relativa a <command
>kde-config</command
>. Prima di iniziare, esegui</para>

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

<para
>dalla riga di comando per essere sicuri che restituisca 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 directory globale di &kde;.</para>

<para
>Potrebbe anche esistere un file chiamato <filename
>kde-kplayer.desktop</filename
> in <filename
>~/.local/share/applications</filename
>. La sua rimozione aggiornerà automaticamente il menu <guisubmenu
>Multimedia</guisubmenu
> quando installi o rimuovi &kplayer;, ma eliminerà anche le modifiche fatte alle associazioni di &kplayer; con i tipi di media nella scheda <guilabel
>Associazioni dei file</guilabel
> nella finestra di configurazione di &konqueror; o 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 nome dell'eseguibile di &mplayer; non è <command
>mplayer</command
> o non è nel percorso attuale. In questo caso, devi spostarti nella scheda <link linkend="settings-advanced"
>Avanzate</link
> delle <guilabel
>Impostazioni 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. Cerca un pacchetto della tua distribuzione che contenga file tipo X.h e XEvent.h. Per esempio, in Debian si chiama <literal
>xlibs-dev</literal
>.</para>

<para
>In modo simile, se <command
>configure</command
> invia avvisi sulla mancanza di file Qt, devi cercare e installare il pacchetto di sviluppo Qt. Se controlli il file <filename
>config.log</filename
>, probabilmente troverai indicazioni sul nome esatto del file che non si trova, all'incirca verso la fine del file. Il file <filename
>config.log</filename
> è piuttosto articolato, e dovrai scorrere diverse pagine dal basso in alto per trovare il punto in cui è riportato l'errore.</para>

</sect3>

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

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

<para
>Prova a riprodurre i file con <command
>mplayer</command
> dalla riga di comando. Se &mplayer; li può riprodurre, confronta le opzioni che hai usato nella riga di comando con quelle che &kplayer; ha passato a &mplayer;. Imposta le opzioni richieste nelle <link linkend="settings"
>Impostazioni di &kplayer;</link
>. Le più importanti sono le opzioni <guilabel
>Driver</guilabel
> nelle schede <link linkend="settings-video"
>Video</link
> e <link linkend="settings-audio"
>Audio</link
>. Nella <link linkend="settings-advanced"
>scheda Avanzate</link
> verifica l'opzione <guilabel
>Percorso dell'eseguibile</guilabel
> assicurandoti che &kplayer; sia in grado di trovare l'eseguibile di &mplayer; e, se esistono altre opzioni non rinvenibili nella finestra di dialogo <guilabel
>Impostazioni di &kplayer;</guilabel
> inseriscile nel campo <guilabel
>Argomenti aggiuntivi della riga comando</guilabel
>.</para>

</sect3>

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

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

<para
>Prova a riprodurre il file con <command
>mplayer</command
> dalla riga di comando. Se &mplayer; lo può riprodurre ma richiede opzioni speciali per riprodurlo, inseriscile nelle <link linkend="properties"
>Proprietà del file</link
> di quel file. Due opzioni che a volte aiutano &mplayer; quando non riesce a rilevare automaticamente il tipo di file sono <option
>-vc</option
> e <option
>-ac</option
>, che corrispondono alle opzioni <guilabel
>Codec</guilabel
> nelle schede <link linkend="properties-video"
>Video</link
> e <link linkend="properties-audio"
>Audio</link
> delle <guilabel
>Proprietà del file</guilabel
>. Se esistono altre opzioni non rinvenibili nella finestra di dialogo <guilabel
>Proprietà del file</guilabel
> inseriscile nel campo <guilabel
>Argomenti aggiuntivi della riga comando</guilabel
>.</para>

<para
>Se è un file di scaletta che non ha un'estensione di scaletta standard, vai nella <link linkend="properties-general"
>scheda Generale</link
> delle <guilabel
>Proprietà del file</guilabel
> e imposta l'opzione <guilabel
>Scaletta</guilabel
> a <guilabel
>sì</guilabel
>. In rari casi, un file che non è una scaletta può possedere un'estensione di scaletta. In questo caso dovrai impostare la proprietà della <guilabel
>Scaletta</guilabel
> a <guilabel
>no</guilabel
>. Per maggiori dettagli, consulta la sezione <link linkend="howto-playlist-files"
>File di scaletta</link
> all'interno del micro-HOWTO Scaletta.</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
>Guarda 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
>dalla riga di comando. Confronta le opzioni della riga di comando che &kplayer; usa per avviare &mplayer; con quelle che stai usando per riprodurre il file con &mplayer;. Inizia, poi, ad aggiungere le opzioni mancanti una per una, fino a che non ottieni lo stesso problema che stai avendo in &kplayer;. Una volta individuata l'opzione che crea il problema, puoi aprire la <link linkend="settings"
>finestra di configurazione</link
> in &kplayer; e rimuovere o modificare quell'opzione. Se devi eseguire modifiche solo per quel file, vai invece nelle <link linkend="properties"
>Proprietà del file</link
>.</para>

</sect3>

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

<para
>Se hai problemi a riportare la finestra dalla modalità schermo intero alla dimensione normale, per esempio la finestra diventa troppo grande o sperimenti uno sfarfallio continuo, puoi provare a deselezionare l'opzione <guilabel
>Ridimensiona automaticamente la finestra principale</guilabel
> nella <link linkend="settings-general"
>scheda Generale</link
> delle <guilabel
>Impostazioni di &kplayer;</guilabel
>. Leggi anche la discussione inerente il problema nel <ulink url="http://sourceforge.net/forum/forum.php?thread_id=1122221&amp;forum_id=244388"
>forum utenti di &kplayer;</ulink
> e sorvegliane gli aggiornamenti.</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 scheda <guilabel
>Avanzate</guilabel
> sia globalmente nelle <link linkend="settings-advanced"
>Impostazioni di &kplayer;</link
>, sia 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"
>scheda Avanzate</link
> in <guilabel
>Proprietà del file</guilabel
>.</para>

</sect3>

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

<para
>Se apri una pagina web con un oggetto multimediale incorporato in &konqueror;, viene visualizzata solo l'area video, senza controlli. Devi allora fare clic col <mousebutton
>pulsante destro</mousebutton
> del mouse nell'<link linkend="parts-video-area"
>area del video</link
> e scegliere il comando <guimenuitem
>Avvia &kplayer;</guimenuitem
>. la riproduzione si fermerà, verrà aperto il programma &kplayer; e si avvierà la riproduzione del file o <acronym
>URL</acronym
>.</para>

</sect3>

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

<para
>Devi abilitare l'<link linkend="howto-installation-xvideo"
>estensione XVideo </link
> nella tua configurazione X11 e assicurarti che l'uscita XVideo sia selezionata nella <link linkend="settings-advanced"
>scheda <guilabel
>Video</guilabel
></link
> delle <guilabel
>Impostazioni di &kplayer;</guilabel
>. Comunque, se non puoi usare l'uscita XVideo, puoi ancora fare in modo che i controlli funzionino aggiungendo l'opzione <literal
>-vf eq2</literal
> o <literal
>-vf eq</literal
> all'interno del campo <guilabel
>Parametri aggiuntivi della riga di comando</guilabel
> nella <link linkend="properties-advanced"
>scheda Avanzate</link
> delle <guilabel
>Impostazioni di &kplayer;</guilabel
>.</para>

</sect3>

</sect2>

</sect1>
