<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kmplayer '<application
>Kmplayer</application
>'>
  <!ENTITY kappname "&kmplayer;"
><!-- replace kmplayer here -->
  <!ENTITY package "kdeextragear-2">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Italian "INCLUDE"
><!-- change language only here -->
 
]>

<book lang="&language;">


<bookinfo>
<title
>Manuale di &kmplayer;</title>

<authorgroup>
<author
><firstname
>Koos</firstname
> <surname
>Vriezen</surname
> <affiliation
> <address
><email
>koos dot vriezen at xs4all dot nl</email
></address>
</affiliation>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>Federico</firstname
><surname
>Zenith</surname
><affiliation
><address
><email
>zenith@chemeng.ntnu.no</email
></address
></affiliation
><contrib
>Quando ci sarà la documentazione, ah, allora la tradurrò...</contrib
></othercredit
> 

<copyright>
<year
>2002</year>
<year
>2003</year>
<holder
>Koos Vriezen</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook 
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>


<date
>2003-12-24</date>
<releaseinfo
>0.05.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&kmplayer; è un'applicazione di interfaccia tra &kde; e<application
>MPlayer</application
>. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>MPlayer</keyword>
<keyword
>konqueror</keyword>
<keyword
>video</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduzione</title>
<para
>&kmplayer; è una semplice interfaccia per <application
>MPlayer</application
>, <application
>Xine</application
> and <application
>FFMpeg</application
>.Puoi usarlo per vedere tutti i formati dei filmati che <application
>MPlayer</application
> e <application
>Xine</application
> supportano, e anche vedere <acronym
>DVD</acronym
>, <acronym
>VCD</acronym
>, <acronym
>TV</acronym
> o <acronym
>telecamere</acronym
>. </para>
<para
>La documentazione di &kappname; non era pronta quando &kde; è stato installato su questo computer.</para
> <para
>Se hai bisogno di aiuto, per piacere visita <ulink url="http://www.kde.org"
>il sito web di KDE</ulink
> per aggiornamenti, o manda la tua domanda alla <ulink url="mail to:kde-user@kde.org"
>Mailing list utenti &kde;</ulink
>.</para>
<para
><emphasis
>Il gruppo di &kde;</emphasis
></para>

</chapter>
<chapter id="settings">
<title
>Impostazioni</title>
<section>
    <title
>Animazione introduttiva e di uscita</title>
    <para
>È possibile disattivare l'animazione di avvio e di uscita modificando <filename
>~/.kde/share/config/kmplayerrc</filename
> e cambiando <programlisting>
[General Options]
  No Intro=0
    </programlisting
> questa opzione a '1'. Se l'opzione non c'è, basta aggiungerla. </para>
<para
>È anche possibile impostare un'animazione alternativa. KMPlayer cercherà rispettivamente <filename
>~/.kde/share/apps/kmplayer/intro.xml</filename
> e <filename
>~/.kde/share/apps/kmplayer/exit.xml</filename
>. Il formato deve essere un file <acronym
>XML</acronym
> supportato. </para>
<para
>L'animazione di avvio non deve essere breve, perché terminerà automaticamente quando viene aperta un'altra sorgente. Ovviamente ciò sarebbe un po' fastidioso per l'animazione di uscita, ma l'utente può sempre terminare l'applicazione due volte. </para>
<para
>Un semplice esempio di introduzione, che mostra le tue foto preferite, potrebbe essere: <programlisting>
&lt;smil&gt;
  &lt;body&gt;
    &lt;img dur="indefinite" src="file:///home/pippo/mamma.png" fit="meet"/&gt;
  &lt;/body&gt;
&lt;/smil&gt;
    </programlisting
>Nel pacchetto sorgente di KMPlayer, nella cartella <filename
>tests/</filename
>, ci sono degli esempi di <acronym
>SMIL</acronym
> supportati da KMPlayer. </para>
</section>
</chapter>
<chapter id="sources">
<title
>Le sorgenti riproducibili</title>
<para
>&kmplayer; può riprodurre diverse sorgenti. Queste sono elencate nel menu Sorgente. </para>
<section id="tvsource">
    <title
>TV</title>
    <para
>&kmplayer; può usare le schede TV usando <application
>MPlayer</application
> o <acronym
>XVideo</acronym
> (usando <application
>kxvplayer</application
>). Prima di poter vedere la TV, devi configurare quale dispositivo usare e i canali televisivi. Puoi usare il programma di scansione dalla finestra di configurazione, oppure puoi configurare il file manualmente. </para>
<para
>Il file di configurazione per le impostazioni della TV è un file <acronym
>XML</acronym
>, posizionato a <filename
>~/.kde/share/apps/kmplayer/tv.xml</filename
>. Il formato <acronym
>XML</acronym
> è come in questo esempio: <programlisting>
&lt;tvdevices&gt;
    &lt;device path="/dev/video0" width="320" height="240" name="BT878 video (Hauppauge (bt878))" audio=""
              minwidth="48" minheight="32" maxwidth="924" maxheight="576" playback="0" xvport="240"&gt;
        &lt;input name="Television" id="0" tuner="1" norm="PAL" xvenc="0"&gt;
            &lt;channel name="Ned1" frequency="21600"/&gt;
            &lt;channel name="VCR" frequency="59490"/&gt;
        &lt;/input&gt;
        &lt;input name="Composite1" id="1" xvenc="7"/&gt;
        &lt;input name="S-Video" id="2" xvenc="14"/&gt;
        &lt;input name="Composite3" id="3"/&gt;
    &lt;/device&gt;
    &lt;device path="/dev/video1" width="640" height="480" name="Philips 740 webcam" audio=""
              minwidth="160" minheight="120" maxwidth="640" maxheight="480" playback="1"&gt;
        &lt;input name="Webcam" id="0"/&gt;
    &lt;/device&gt;
&lt;/tvdevices&gt;
</programlisting
> Nota che gli elementi <quote
>input</quote
> con dei canali dovrebbero avere l'attributo <quote
>tuner</quote
> impostato a <quote
>1</quote
>. </para>
<para
><acronym
>XVideo</acronym
> usa solo gli attributi <quote
>xvport</quote
> e <quote
>xvenc</quote
>, e possono essere impostati manualmente solo modificando questo file. I valori di questi attributi possono essere recuperati usando <quote
>kxvplayer</quote
> in un'applicazione di terminale come &konsole;. Per ogni porta, <quote
>kxvplayer</quote
> scriverà delle righe come le seguenti, e si possono impostare i numeri per gli attributi di cui si è parlato. <programlisting>
    xvport 240
    ....
    encoding: 0 PAL-television
    encoding: 1 NTSC-television
    encoding: 2 SECAM-television
    ....   
</programlisting
> Anche gli attributi di altezza e larghezza sono ignorati dal lettore <acronym
>XVideo</acronym
>. Questo lettore ottiene le dimensioni dal server X. Una delle cose carine di <acronym
>XVideo</acronym
> è che la scala è fatta dall'hardware, dalla scheda video, quindi è possibile avere il supporto a schermo intero senza uso di CPU e senza cambio di risoluzione del tuo monitor. Inoltre, non ci sarà un noioso sfarfallio quando un'altra finestra si sovrapporrà a questa finestra video. </para>
<para
>Vedi la sezione VDR per maggiori informazioni sull'uso di <acronym
>XVideo</acronym
>. </para>
</section>
<section id="vdrsource">
    <title
>VDR</title>
<para
>Per configurare le tue impostazioni VDR in kmplayer, vedi il pannello Configura pannello->Sorgente->VDR->Porta XVideo. Ci dovrebbero essere le porte rilevate, tra cui dovresti sceglierne una. Devi decidere quale codifica usare (per esempio PAL per l'europa occidentale), e probabilmente quella giusta ha un nome contenente <quote
>dvb</quote
>. </para>
<para
>Per esempio, io ho una scheda TV, una scheda DVB-S e una webcam nel mio sistema. Con questi, ho tre porte nelle mie impostazioni. La prima è un lungo elenco di voci NTSC(-JP)/PAL(-M)/SECAM, tutte riguardo a un television/composite/svideo (la mia scheda TV). La seconda contiene NTSC-dvb/PAL-dvb/SECAM-dvb (la mia scheda DVB-S). Infine, la terza contiene solo ntsc/pal (probabilmente la mia webcam). Quindi dovrei configurare la seconda porta (basta selezionarla) e la seconda voce (PAL-dvb). </para>
<para
>Siccome il supporto VDR di kmplayer può usare solo <acronym
>XVideo</acronym
>, <acronym
>XVideo</acronym
> deve ovviamente funzionare (credo che per i dispositivi video, questo modo di visualizzazione funzioni solo in Linux). Ciò funziona solo sul tuo primo schermo (:0.0). Perciò assicurati che l'estensione <quote
>videoforlinux</quote
> funzioni nel server X. Per il server XFree86, nel suo file di configurazione (<filename
>/etc/X11/XF86Config</filename
>), dovrebbe esserci <programlisting
>Section "Module" 
     .... 
     Load    "v4l" 
EndSection
</programlisting>
</para>
<para
>Sfortunatamente, quando aggiorni il tuo driver video, devi riconfigurare questa impostazione. </para>
</section>
<section id="kmplayer_url">
    <title
>Riga di comando</title>
<para
>Internamente, KMPlayer usa diversi nomi per le sorgenti. Al momento della scrittura questi erano "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" e "vdrsource". Quando attivi, cominciano a riprodurre l'elenco di elementi riproducibili. </para>
<para
>Puoi attivare una sorgente particolare con un <acronym
>URL</acronym
> di tipo <filename
>kmplayer://</filename
>. Basta impostare la parte host come il nome della sorgente e la parte del percorso opzionale come argomenti aggiuntivi; quindi per un canale per "vdrsource" potrebbe essere: <filename
>kmplayer://vdrsource/22 MTV 2</filename
>. Per esempio, questo script avvia KMPlayer usando "dvdnavsource" e usando <acronym
>DCOP</acronym
> per riprodurre a schermo intero.<programlisting>
/bin/bash
kmplayer kmplayer://dvdnavsource/ &amp;
PID=$!
sleep 2
dcop kmplayer-$PID KMediaPlayer toggleFullScreen
</programlisting
>Per alcune sorgenti ciò non farà molto, perché non sono fatte per la riproduzione normale. Per "pipesource" questo è disattivato perché sarebbe una pericolosa falla nella sicurezza. </para>
</section>
</chapter>
<chapter id="questionsanswersandtips">
    <title
>Domande, risposte e suggerimenti</title>

    <qandaset id="faq">
      <title
>Domande frequenti</title>
      <qandaentry>
        <question>
          <para
>Xine si avvia lentamente, perché deve fare benchmark della mia CPU in continuazione?</para>
        </question>
        <answer>
            <para
>Nota che la risposta sotto è obsoleta. <application
>kxineplayer</application
> salva automaticamente l'ultimo valore, quindi solo xine farà il test della CPU solo la prima volta. </para>
            <para
>L'interfaccia di &kmplayer; per <application
>Xine</application
>, <application
>kxineplayer</application
>, usa <filename
>~/.kde/share/apps/kmplayer/xine_config</filename
> per la sua configurazione. Le impostazioni di <application
>Xine</application
> si trovano nella finestra di configurazione <quote
>Opzioni generali</quote
>|<quote
>Xine</quote
> (Se cambi un'opzione qui e la salvi, anche <filename
>~/.kde/share/apps/kmplayer/xine_config</filename
> conterrà delle spiegazioni). Il benchmarking della CPU è causato dall'opzione <computeroutput
>misc.memcpy_method</computeroutput
> impostata a <computeroutput
>probe</computeroutput
>. Per vedere quale versione di memcpy funziona più velocemente per te, attiva <quote
>Mostra output della console</quote
> dal menu <quote
>Visualizza</quote
>, e guarda i risultati di questo benchmark quando riproduci qualcosa con Xine. Configura <computeroutput
>misc.memcpy_method</computeroutput
> con il metodo con il tempo più basso.</para>
        </answer>
      </qandaentry>
      <qandaentry>
        <question>
            <para
>Ci sono trucchi per rendere il mio CDROM meno rumoroso quando sto riproducendo qualcosa (non VCD://)?</para>
        </question>
        <answer>
            <para
>Certo, prova <command
>hdparm -E 8 /dev/cdrom</command
> come root dopo aver montato il dispositivo. Assicurati di controllare bene che <filename
>/dev/cdrom</filename
> punti al tuo dispositivo CDROM. </para>
        </answer>
      </qandaentry>
    </qandaset>

  </chapter>
<chapter id="credits-and-licenses">
<title
>Riconoscimenti e licenza</title>

<para
>&kmplayer; copyright 2002,2003 Koos Vriezen</para>
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->













