<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.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 % Danish "INCLUDE"
><!-- change language only here -->
 
]>

<book lang="&language;">


<bookinfo>
<title
>&kmplayer;-håndbogen</title>

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

&erik.kjaer.pedersen.role; 

<copyright>
<year
>2002</year>
<year
>2006</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; er et program som er en &kde;-grænseflade for <application
>Mplayer</application
>, <application
>Xine</application
> og <application
>GStreamer</application
>. </para>
</abstract>


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

</bookinfo>

<chapter id="introduction">
<title
>Indledning</title>
<para
>&kmplayer; er en simpel grænseflade for <application
>Mplayer</application
>, <application
>Xine</application
>, <application
>Gstreamer</application
> og <application
>FFMpeg</application
>. Du kan bruge det til at kigge på alle filmfilformat som <application
>Mplayer</application
>, <application
>Xine</application
> eller <application
>Gstreamer</application
> understøtter, samt kigge på en <acronym
>dvd</acronym
>, <acronym
>vcd</acronym
> eller <acronym
>tv</acronym
> og kamera. </para>
<para
>Dokumentationen for &kappname; var ikke færdig da &kde; blev installeret på denne computer.</para
> <para
>Hvis du behøver mere hjælp, kig på <ulink url="http://www.kde.org"
>KDE's hjemmeside</ulink
> for opdateringer, eller send dit spørgsmål til <ulink url="mailto:kde-user@kde.org"
>&kde;'s e-mail-liste for brugere</ulink
>. </para>
<para
><emphasis
>&kde;-gruppen</emphasis
></para>

</chapter>
<chapter id="gui">
<title
>Brugergrænsefladen</title>
<para
>Programvinduet består af såkaldte dokningsbare vinduer. Det centrale visningsvindue findes altid. Desuden er der et valgfrit spillelistevindue. Endelig  er der et informationsvindue, som kun vises når der er en information at vise. </para>
<section id="playlistwindow">
<title
>Spillelistevinduet</title>
<para
>Spillelistevinduet har fem kategorier når dette skrives, nuværende punkt, <guilabel
>Optiske diske</guilabel
>, <guilabel
>Television</guilabel
>, <guilabel
>Bevarede spillelister</guilabel
> og <guilabel
>Nyligste</guilabel
>. Ved et klik på en kategoris tekst vises dens indhold under linjen. Der skal naturligvis være noget indhold, se for eksempel <link linkend="tvsource"
><acronym
>TV</acronym
>-indstillinger</link
> om hvordan man tilføjer indhold for kategorien <guilabel
>Television</guilabel
>. Kategorien <guilabel
>Nyligste</guilabel
> udfyldes i når lokale mediafiler eller netværks-url'er afspilles. Denne kategori kan indeholde 60 punkter, hvoraf de sidste 50 er under grenen <guilabel
>Mere...</guilabel
>. </para>
<section>
<title
>Kategorien Bevarede spillelister</title>
<para
>Det er muligt at opbevare dine favoritlink i menuen <guilabel
>Bogmærker</guilabel
>, men de er enkelte punkter. Hvis du vil oprette en liste med punkter som spilles i rækkefølge, skal du bruge kategorien <guilabel
>Bevarede spillelister</guilabel
>. </para>
<para
>Den nemmeste måde at tilføje et punkt til listen er at trække det fra <guilabel
>Nyligste</guilabel
> og slippe det på <guilabel
>Bevarede spillelister</guilabel
>. Som du vil se, vises en menu når du slipper det, hvor du kan vælge at tilføje det til denne liste eller oprette en ny gruppe. Punkter på øverste niveau opfører sig som bogmærkepunkter, men punkter i grupper afspiller hele gruppen som de indgår i. Punkter i denne kategori kan nemt flyttes, kopieres, tilføjes til en ny gruppe eller fjernes, blot ved at trække punktet til et andet sted i kategorien. Desuden er der valgmulighederne <guimenu
>Slet punkt</guimenu
>, <guimenu
>Flyt opad</guimenu
> og <guimenu
>Flyt nedad</guimenu
> i den sammenhængsafhængige menu (ved klik med højre museknap på et punkt). </para>
<para
>Du kan naturligvis tilføje grupper til grupper for at få et dybere hierarki. Ved klik på et punkt, kopieres dets gruppe og alle undergrupper til den nuværende kategori, og afspilning begynder på det klikkede punkts position. </para>
<section>
<title
>Opbevaringsformat</title>
<para
>Data opbevares i <filename
>~/.trinity/share/apps/kmplayer/playlist.xml</filename
>, og dets format er som i dette eksempel. Kig <link linkend="XML-editing"
>her</link
> om hvordan man håndterer denne data direkte. <programlisting>
&lt;playlist&gt;
    &lt;group title="feeds"&gt;
        &lt;item url="http://www.lugradio.org/episodes.rss"/&gt;
        &lt;item url="http://science.nasa.gov/podcast.xml"/&gt;
        &lt;item url="http://www.theworld.org/rss/tech.xml"/&gt;
    &lt;/group&gt;
    &lt;group title="iradio"&gt;
        &lt;group title="sunny"&gt;
            &lt;item mplayeropts="-cache 256" url="http://www.swissgroove.ch/listen.m3u"/&gt;
            &lt;item url="http://www.boombasticradio.com/shoutcast/64.pls"/&gt;
        &lt;/group&gt;
        &lt;group title="rainy"&gt;
            &lt;item url="http://www.radioparadise.com/musiclinks/rp_64.m3u"/&gt;
            &lt;item url="http://www.woxy.com/stream/wma64.asx"/&gt;
            &lt;item url="http://radionigel.com/winmedia.asx"/&gt;
            &lt;item url="rtsp://livestreams.omroep.nl/live/vpro/vpro3voor12radioalt.rm"/&gt;
        &lt;/group&gt;
    &lt;/group&gt;
&lt;/playlist&gt;
</programlisting
> Bemærk også at egne tilvalg kan indstilles med flaget <computeroutput
>mplayeropts</computeroutput
> for <application
>Mplayer</application
>. &kmplayer; søger opad i træet efter dette flag, så du kan indstille det for en hel gruppe og sætte det ud af kraft for en undergruppe eller for et punkt. </para>
</section>
</section>
</section>
<section id="XML-editing">
<title
>Direkte XML-redigering</title>
<para
>Kategorierne Seneste, <guilabel
>Television</guilabel
> og <guilabel
>Bevarede spillelister</guilabel
> kan også håndteres ved at redigere deres <acronym
>XML</acronym
>-opbevaring. Man kan naturligvis gøre det når &kmplayer; ikke kører, og redigere de forskellige filer i <filename
>~/.trinity/share/apps/kmplayer/</filename
>, men også i selve programmet. Klik blot på en kategorioverskrift, og vælg derefter <guimenu
>Vis</guimenu
> og siden <guimenu
>Redigeringstilstand</guimenu
>. Du kan også klikke på en undergren og så ser du kun <acronym
>XML</acronym
>-indholdet for grenen. </para>
<para
>Efter at du har redigeret noget <acronym
>XML</acronym
>, klikkes på <guilabel
>Synkronisér med spilleliste</guilabel
> og afmarkér enten tilvalget <guimenu
>Redigeringstilstand</guimenu
> eller klik på en anden kategori. <caution
><para
>Alle ændringer går tabt hvis du forlader redigeringstilstand eller vælger en anden gren uden at synkronisere med spillelisten. </para
></caution>
</para>
<para
>På grund af dovenskab blandt &kmplayer;s forfattere, kan visse funktioner kun aktiveres ved at redigere XML. </para>
</section>
</chapter>
<chapter id="settings">
<title
>Opsætning</title>
<section>
    <title
>Animering ved start og afslutning</title>
    <para
>Deaktivering af start- og slutanimeringen kan udføres ved at redigere <filename
>~/.trinity/share/config/kmplayerrc</filename
> og ændre <programlisting>
[General Options]
  No Intro=0
    </programlisting
> ovenstående tilvalg til '1'. Tilføj blot dette tilvalg hvis der ikke allerede er der. </para>
<para
>Det er også muligt at angive alternative animeringer. Kmplayer kigger på <filename
>~/.trinity/share/apps/kmplayer/intro.xml</filename
> og <filename
>~/.trinity/share/apps/kmplayer/exit.xml</filename
>. Formatet skal være en <acronym
>XML</acronym
>-fil som understøttes. </para>
<para
>Den indledende animering behøver ikke være kort, eftersom den automatisk slutter når en anden kilde åbnes. Dette ville naturligvis være noget irriterende for slutanimeringen, men brugeren kan altid afslutte programmet to gange. </para>
<para
>Et simpelt eksempel på en indledning, som viser dit favoritfoto kunne være <programlisting>
&lt;smil&gt;
  &lt;body&gt;
    &lt;img dur="indefinite" src="file:///home/bruger/lillemor.gif" fit="meet"/&gt;
  &lt;/body&gt;
&lt;/smil&gt;
    </programlisting
> I Kmplayers kildekodepakke, under <filename
>tests/</filename
> er der nogle eksempler på <acronym
>SMIL</acronym
> som Kmplayer understøtter. </para>
</section>
</chapter>
<chapter id="backends">
<title
>Afspilningsgrænsefladen</title>
<para
>&kmplayer; bruger eksterne programmer til at udføre selve afspilningen. </para>
<section id="mplayer">
<title
>MPlayer</title>
<para
>Der er et indstillingsfaneblad for Mplayer i &kmplayer;s indstillingsdialog. Der kan man blandt andet indstille søgestien til Mplayer og dets cachestørrelse for netværksstrømme. </para>
<section id="mplayer-debug">
<title
>Fejlsøgning</title>
<para
>Den bedste måde at fejlsøge i grænsefladen er at starte &kmplayer; fra et terminalprogram såsom konsole. Start derefter en film med Kmplayer og se nøjagtigt den kommandolinje som bruges til at starte Mplayer i terminalprogrammet. Kopiér og indsæt den nu i et andet terminalprogram, fjerne flaget '-wid 12344' og spil den. Formodentlig er det blot om at vælge rigtige parametre for -ao og -vo. Sørg også for at Mplayer ikke er forudindstillet til at starte med en grafisk grænseflade. </para>
<para
>Et andet fejlsøgningsværktøj er knappen 'Terminal' i Kmplayers værktøjslinje. Der kan du se uddataen fra Mplayer. </para>
</section>
</section>
<section id="xine">
<title
>Xine</title>
<para
>Når &kmplayer; er konfigureret med understøttelse for Xine, er der indstillingsfaneblade for Xine i &kmplayer;s indstillingsdialog. Der kan du indstille diverse tilvalg. Disse tilvalg hentes dynamisk fra Xines bibliotek. Brug den sammenhængsafhængige hjælp til at få information om hvad valgmulighederne gør (dvs. klikke på spørgsmålstegnet i dialogens navnelist og klik derefter på et tilvalg). </para>
<para
>Tilvalgene gemmes i <filename
>.kde/share/apps/kmplayer/xine_config</filename
> som et tekstdokument. </para>
<section id="xine-debug">
<title
>Fejlsøgning</title>
<para
>Hovedsageligt på samme måde at fejlsøge som for <link linkend="mplayer-debug"
>Mplayer</link
>, men med progravnavnet <filename
>kxineplayer</filename
>. </para>
</section>
</section>
<section id="gstreamer">
<title
>GStreamer</title>
<para
>Der er intet indstillingsfaneblad for Gstreamer i &kmplayer;s indstillingsdialog. De sædvanlige valgmulighederne for f.eks. <acronym
>dvd</acronym
>-enheder bruges når det passer. </para>
<section id="gstremaer-debug">
<title
>Fejlsøgning</title>
<para
>Hovedsagelig på samme måde at fejlsøge som for <link linkend="mplayer-debug"
>Mplayer</link
>, men med programnavnet <filename
>kgstplayer</filename
>. </para>
</section>
</section>
</chapter>
<chapter id="sources">
<title
>Kilder som kan afspilles</title>
<para
>&kmplayer; kan afspille forskellige kilder. Disse kilder listes i menuen Kilde. </para>
<section id="tvsource">
    <title
>TV</title>
    <para
>&kmplayer; kan afspille fra et tv-kort med <application
>Mplayer</application
> eller <acronym
>Xvideo</acronym
> (ved brug af <application
>kxvplayer</application
>). Inden du kan kigge på tv skal du indstille hvilken enhed som skal bruges, og tv-kanalerne. Du kan bruge søgefunktionen i indstillingsdialogen til dette, eller redigere indstillingsfilen manuelt. </para>
<para
>Indstillingsfilen for tv-indstillingerne er en <acronym
>XML</acronym
>-fil, med navnet <filename
>~/.trinity/share/apps/kmplayer/tv.xml</filename
>. Kig <link linkend="XML-editing"
>her</link
> om hvordan man håndterer denne data direkte. <acronym
>XML</acronym
>-formatet er som følgende eksempel: <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
> Bemærk at elementerne <quote
>input</quote
> som har kanaler, skal have egenskaben <quote
>tuner</quote
> indstillet til <quote
>1</quote
>. </para>
<para
><acronym
>Xvideo</acronym
> bruger kun egenskaberne <quote
>xvport</quote
> og <quote
>xvenc</quote
> og kan kun indstilles ved at redigere filen manuelt. Egenskabernes værdier kan hentes ved at køre <quote
>kxvplayer</quote
> i et terminalvindue såsom <quote
>konsole</quote
>. For hver port skriver <quote
>kxvplayer</quote
> linjer ud som vises nedenfor, og værdierne kan indstilles for de nævnte egenskaber. <programlisting>
    xvport 240
    ....
    encoding: 0 PAL-television
    encoding: 1 NTSC-television
    encoding: 2 SECAM-television
    ....   
</programlisting
> Desuden ignoreres egenskaberne bredde og højde af <acronym
>Xvideo</acronym
>-afspilleren. Afspilleren henter størrelserna fra X-serveren. En af de gode ting ved <acronym
>Xvideo</acronym
> er at skalering gøres i hardware af videokortet, hvilket giver understøttelse for fuldskærmsvisning uden processorbrug og uden at ændre billedskærmens opløsning. Desuden opstår der ikke noget irriterende flimmer når et andet vindue overlapper videovinduet. </para>
<para
>Se afsnittet VDR for mere information om at bruge <acronym
>Xvideo</acronym
>. </para>
</section>
<section id="vdrsource">
    <title
>VDR</title>
<para
>For at indstille VDR-indstillinger i Kmplayer, bruges indstillingsfeltet Kilde -> VDR -> Xvideo port. Der skal være detekterede porte, hvorfra du skal vælge en. Du skal regne ud hvilken kodning du skal bruge (i vesteuropa er det f.eks. PAL) og formodentlig har den rigtige et navn som indeholder <quote
>dvb</quote
>. </para>
<para
>Jeg har for eksempel et tv-kort, et DVB-S kort og en web-kamera sluttet til i mit system. Med disse har mine indstillinger tre porte. Den første har en lang liste med NTSC(-JP)/PAL(-M)/SECAM-indgange som alle indeholder noget med television/composite/svideo (mit tv-kort). Den anden har NTSC-dvb/PAL-dvb/SECAM-dvb (mit DVB-S kort). Den tredje har endelig kun ntsc/pal (formodentlig mit web-kamera). Derfor skal jeg indstille (blot ved at markere den) den anden port og den anden indgang (PAL-dvb). </para>
<para
>Eftersom VDR-understøttelse i Kmplayer kun kan bruge <acronym
>Xvideo</acronym
>, burde <acronym
>Xvideo</acronym
> naturligvis virke (og jeg tror at denne måde at kigge på videoenheder kun virker med Linux). Dette virker  også kun på den første skærm (:0.0). Sørg altså for at udvidelsen <quote
>videoforlinux</quote
> virker med X-serveren. For XFree86-serveren, skal følgende være i indstillingsfilen (<filename
>/etc/X11/XF86Config</filename
>): <programlisting
>Section "Module" 
     .... 
     Load    "v4l" 
EndSection
</programlisting>
</para>
<para
>Desværre skal du indstille dette igen ligeså snart du opdaterer din videodriver. </para>
</section>
<section id="kmplayer_url">
    <title
>Kommandolinje</title>
<para
>Internt bruger Kmplayer distinkte navne for kilder. På det tidspunkt hvor dette skrives er de "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" og "vdrsource". Når de aktiveres begynder de som regel at spille listen med spilbare punkter. </para>
<para
>Du kan aktivere en bestemt kilde med URL <filename
>kmplayer://</filename
>. Angiv blot værtsdelen som kildens navn og den valgfrie del som ekstra argument, hvilket vil kunne se ud som <filename
>kmplayer://vdrsource/22 MTV 2</filename
> for en kanal fra "vdrsource". For eksempel starter følgende script Kmplayer med "dvdnavsource" og bruger <acronym
>DCOP</acronym
> til at afspille i fuldskærmstilstand. <programlisting>
/bin/bash
kmplayer kmplayer://dvdnavsource/ &amp;
PID=$!
sleep 2
dcop kmplayer-$PID KMediaPlayer toggleFullScreen
    </programlisting
> Dette udfører ikke meget for visse kilder, eftersom de ikke er beregnede til normal afspilning. Det er deaktiveret for "pipesource", eftersom det naturligvis ville være et alvorligt sikkerhedshul. </para>
</section>
</chapter>
<chapter id="questionsanswersandtips">
    <title
>Spørgsmål, svar og tips</title>

    <qandaset id="faq">
      <title
>Ofte stillede spørgsmål</title>
      <qandaentry>
        <question>
          <para
>Xine starter langsomt, hvorfor skal den måle min processorydelse hele tiden?</para>
        </question>
        <answer>
            <para
>Bemærk at svaret nedenfor er forældet. <application
>kxineplayer</application
> gemmer den automatisk til den seneste værdi, så xine udfører kun processortesten første gangen. </para>
            <para
>Grænsefladen for <application
>Xine</application
> i &kmplayer;, <application
>kxineplayer</application
>, bruger <filename
>~/.trinity/share/apps/kmplayer/xine_config</filename
> til sine indstillinger. Indstillingerne for <application
>Xine</application
> er i indstillingsdialogen <quote
>General Options</quote
>|<quote
>Xine</quote
>. (Hvis du ændrer et punkt der og gemmer det, indeholder <filename
>~/.trinity/share/apps/kmplayer/xine_config</filename
> også en del forklaringer). Målingen af processorydelse forårsages af at punktet <computeroutput
>misc.memcpy_method</computeroutput
> er indstillet til <computeroutput
>probe</computeroutput
>. For at finde ud af hvilken version af hukommelseskopiering som er hurtigst for dig, aktiveres <quote
>Vis terminaludskrift</quote
> i menuen <quote
>Vis</quote
> og kig på resultatet af målingen når du spiller noget med Xine. Indstil <computeroutput
>misc.memcpy_method</computeroutput
> til metoden med kortest tid.</para>
        </answer>
      </qandaentry>
      <qandaentry>
        <question>
            <para
>Nogle tip til at gøre cdrom-enheden mere stille når den bruges til afspilning (ikke VCD://)?</para>
        </question>
        <answer>
            <para
>Selvfølgelig, prøv <command
>hdparm -E 8 /dev/cdrom</command
> som systemadministrator, efter at have monteret enheden. Men sørg for  at du dobbelttjekker at <filename
>/dev/cdrom</filename
> peger på cdrom-enheden. </para>
        </answer>
      </qandaentry>
    </qandaset>

  </chapter>
<chapter id="credits-and-licenses">
<title
>Medvirkende og licens</title>

<para
>&kmplayer; ophavsret 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:
-->













