<?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 % Portuguese "INCLUDE"
><!-- change language only here -->
 
]>

<book lang="&language;">


<bookinfo>
<title
>O Manual do &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
>Pedro</firstname
><surname
>Morais</surname
><affiliation
><address
><email
>morais@kde.org</email
></address
></affiliation
><contrib
>Tradução</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
>O &kmplayer; é uma interface &kde; para o <application
>MPlayer</application
>. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>MPlayer</keyword>
<keyword
>konqueror</keyword>
<keyword
>vídeo</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>
<para
>O &kmplayer; é uma interface simples para o <application
>MPlayer</application
>, o <application
>Xine</application
> e o <application
>FFMpeg</application
>. Você poderá usá-lo para ver todos os tipos de formatos de ficheiros que o <application
>MPlayer</application
>/<application
>Xine</application
> suportam, assim como ver <acronym
>DVD</acronym
>s, <acronym
>VCD</acronym
> ou <acronym
>TV</acronym
>/<acronym
>vídeo</acronym
>. </para>
<para
>A documentação do &kappname; não estava terminada quando o &kde; foi instalado neste computador.</para
> <para
>Se necessitar de ajuda, procure na <ulink url="http://www.kde.org"
>Página do KDE</ulink
> actualizações, ou envie perguntas para <ulink url="mail to:kde-user@kde.org"
>A Lista de E-mail dos Utilizadores do &kde;</ulink
>.</para>
<para
><emphasis
>A Equipa do &kde;</emphasis
></para>

</chapter>
<chapter id="settings">
<title
>Configuração</title>
<section>
    <title
>Animação no arranque/saída</title>
    <para
>A desactivação da animação inicial/final poderá ser configurada se editar o ficheiro <filename
>~/.kde/share/config/kmplayerrc</filename
> e modificar <programlisting>
[General Options]
  No Intro=0
    </programlisting
> a opção anterior para '1'. Basta adicionar a opção se não existir no ficheiro. </para>
<para
>Também é possível definir uma animação alternativa. O KMPlayer irá ver, respectivamente, em <filename
>~/.kde/share/apps/kmplayer/intro.xml</filename
> e <filename
>~/.kde/share/apps/kmplayer/exit.xml</filename
>. O formato terá de ser um ficheiro <acronym
>XML</acronym
> suportado. </para>
<para
>A animação inicial não terá de ser reduzida, dado que irá terminar imediatamente, quando for aberto outro ficheiro. Claro que, para a animação final, isso poder-se-á tornar incómodo; contudo, o utilizador poderá terminar a aplicação duas vezes. </para>
<para
>Um exemplo simples de uma introdução que mostre a sua fotografia favorito poderá ser<programlisting>
&lt;smil&gt;
  &lt;body&gt;
    &lt;img dur="indefinite" src="file:///home/ze/namorada.gif" fit="meet"/&gt;
  &lt;/body&gt;
&lt;/smil&gt;
    </programlisting
> No pacote de código do KMPlayer, em <filename
>tests/</filename
> existem alguns exemplos de ficheiros <acronym
>SMIL</acronym
> que o KMPlayer suporta. </para>
</section>
</chapter>
<chapter id="sources">
<title
>Fontes que podem ser lidas</title>
<para
>O &kmplayer; pode ler a partir de várias fontes. Estas estão listadas no menu Fonte. </para>
<section id="tvsource">
    <title
>TV</title>
    <para
>O &kmplayer; poderá ver o conteúdo das placas de TV com o <application
>MPlayer</application
> ou o <acronym
>XVideo</acronym
> (usando o <application
>kxvplayer</application
>). Antes de poder ver televisão, terá de configurar o dispositivo a usar e os canais de TV. Poderá usar o sintonizador da janela de configuração para tal ou editar o ficheiro de configuração manualmente. </para>
<para
>O ficheiro de configuração da TV é um ficheiro <acronym
>XML</acronym
>, localizado em <filename
>~/.kde/share/apps/kmplayer/tv.xml</filename
>. O formato <acronym
>XML</acronym
> é como o deste exemplo: <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
> Repare que os elementos <quote
>input</quote
> que tẽm canais deverão ter o atributo <quote
>tuner</quote
> igual a <quote
>1</quote
>. </para>
<para
>O <acronym
>XVideo</acronym
> só usa os atributos <quote
>xvport</quote
> e <quote
>xvenc</quote
>, e eles só poderão ser definidos se editar manualmente este ficheiro. Os valores destes dois atributos poderão ser obtidos se executar o <quote
>kxvplayer</quote
> numa aplicação de terminal, como o <quote
>konsole</quote
>. Para todos os portos, o <quote
>kxvplayer</quote
> irá mostrar linhas como as que aparecem abaixo e os números poderão definidos para os atributos mencionados.<programlisting>
    xvport 240
    ....
    encoding: 0 PAL-television
    encoding: 1 NTSC-television
    encoding: 2 SECAM-television
    ....   
</programlisting
> Também os atributos 'width' e 'height' são ignorados pelo leitor do <acronym
>XVideo</acronym
>. Este leitor obtém os tamanhos do servidor do X.  Uma das coisas boas do <acronym
>XVideo</acronym
> é que o dimensionamento é feito por 'hardware', pela placa de vídeo, como tal o suporte de ecrã completo é feito sem utilizar o CPU e sem a mudança de resolução do seu monitor. Do mesmo modo, também não haverá nenhuma interferência incómoda quando outra janela se sobrepor a esta janela de vídeo. </para>
<para
>Veja a secção de VDR para mais informações sobre o uso do <acronym
>XVideo</acronym
>. </para>
</section>
<section id="vdrsource">
    <title
>VDR</title>
<para
>Para configurar as suas opções de VDR no 'kmplayer', veja o painel Configurar->Fonte->VDR->XVideo. Deverão existir portos detectados, nos quais deverá seleccionar um deles. Terá de descobrir a codificação que deverá usar (p.ex., para a Europa ocidental, este é o PAL) e, provavelmente, o correcto terá um nome com <quote
>dvb</quote
> incluído. </para>
<para
>Por exemplo, o autor tem uma placa de TV, uma placa de DVB-S e uma webcam ligada ao seu sistema. Graças a elas, a configuração acusa três portos. O primeiro tem uma lista extensa de itens NTSC(-JP)/PAL(-M)/SECAM que dizem algo sobre a televisão/composto/svideo (corresponde à placa de TV). O segundo tem opções referente a NTSC-dvb/PAL-dvb/SECAM-dvb (da placa DVB-S). Finalmente, o terceiro só tem ntsc/pal (talvez a webcam). Como tal, deverá ser configurado (bastando para tal seleccioná-lo) o segundo porto e o segundo item (PAL-dvb). </para>
<para
>Dado que o suporte de VDR do 'kmplayer' só poderá usar o <acronym
>XVideo</acronym
>, claro que o <acronym
>XVideo</acronym
> deverá funcionar (no caso dos dispositivos, segundo a opinião do autor, esta forma de visualização só funciona no Linux). Do mesmo modo, também só funciona no seu primeiro ecrã (:0.0). Como tal, deverá certificar-se que a extensão <quote
>videoforlinux</quote
> funciona para o servidor do X. Para o servidor XFree86, na sua configuração (em <filename
>/etc/X11/XF86Config</filename
>), deverá existir <programlisting
>Section "Module" 
     .... 
     Load    "v4l" 
EndSection
</programlisting>
</para>
<para
>Infelizmente, sempre que actualizar o seu controlador de vídeo, terá de configurar de novo esta opção. </para>
</section>
<section id="kmplayer_url">
    <title
>Linha de comandos</title>
<para
>Internamente, no que respeita às fontes, o KMPlayer usa nomes distintos. Na altura em que este documento foi escrito, são as seguintes: "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" e "vdrsource". Quando estiver activado, o programa irá executar a lista de itens com possibilidade de reprodução. </para>
<para
>Poderá activar uma fonte em particular com um <acronym
>URL</acronym
> do tipo <filename
>kmplayer://</filename
>. Basta definir o nome da máquina como nome da fonte e uma localização opcional como argumento extra, como tal, para um canal da fonte "vdrsource", isto poderá ficar algo do género <filename
>kmplayer://vdrsource/22 MTV 2</filename
>. P.ex., este programa inicia o 'kmplayer' com o "dvdnavsource" e a usar o <acronym
>DCOP</acronym
> para mostrar em todo o ecrã.<programlisting>
/bin/bash
kmplayer kmplayer://dvdnavsource/ &amp;
PID=$!
sleep 2
dcop kmplayer-$PID KMediaPlayer toggleFullScreen
    </programlisting
> Para algumas fontes, isto não fará muita coisa, porque não se pretende usá-las na reprodução normal. Na "pipesource", esta opção está desactivada, porque poderia ser um grave problema de segurança. </para>
</section>
</chapter>
<chapter id="questionsanswersandtips">
    <title
>Perguntas, Respostas e Dicas</title>

    <qandaset id="faq">
      <title
>Perguntas mais frequentes</title>
      <qandaentry>
        <question>
          <para
>O Xine demora muito a arrancar, porque é que tem que verificar a velocidade do meu processador todas as vezes?</para>
        </question>
        <answer>
            <para
>Repare que a resposta abaixo está desactualizada. O <application
>kxineplayer</application
> grava-a automaticamente com o último valor, como tal, da primeira vez, o 'xine' irá fazer o teste do CPU. </para>
            <para
>A interface do <application
>Xine</application
> para o &kmplayer;, o <application
>kxineplayer</application
>, usa o <filename
>~/.kde/share/apps/kmplayer/xine_config</filename
> para a sua configuração. As opções do <application
>Xine</application
> estão na janela de configuração <quote
>Opções Gerais</quote
>|<quote
>Xine</quote
>. (Se você mudar aqui uma opção e gravá-la, o <filename
>~/.kde/share/apps/kmplayer/xine_config</filename
> irá conter também algumas explicações). A medida de performance do CPU e devida à opção <computeroutput
>misc.memcpy_method</computeroutput
> configurada para <computeroutput
>probe</computeroutput
> (detectar). Para ver qual a versão do 'memcpy' que funciona mais rapidamente para si, active a opção <quote
>Mostrar o Resultado da Consola</quote
> do menu <quote
>Ver</quote
> e veja os resultados desta análise quando tocar algo com o Xine. Configure o <computeroutput
>misc.memcpy_method</computeroutput
> com o método com menor tempo.</para>
        </answer>
      </qandaentry>
      <qandaentry>
        <question>
            <para
>Algumas dicas em como tornar o CDROM menos barulhento quando é utilizado (não com VCD://)?</para>
        </question>
        <answer>
            <para
>Claro, tente o comando <command
>hdparm -E 8 /dev/cdrom</command
> como 'root' depois de montar o dispositivo. Mas certifique-se que tem o <filename
>/dev/cdrom</filename
> a apontar para a sua unidade de CDROM. </para>
        </answer>
      </qandaentry>
    </qandaset>

  </chapter>
<chapter id="credits-and-licenses">
<title
>Créditos e Licenças</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:
-->













