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

<book lang="&language;">


<bookinfo>
<title
>Das Handbuch zu &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
>René</firstname
> <surname
>Landert</surname
> <affiliation
><address
><email
>rene.landert@bluewin.ch</email
> </address
> </affiliation
> <contrib
>Deutsche Übersetzung </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; ist die Benutzeroberfläche des Programmes <application
>MPlayer</application
> für das &kde;. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>tdemultimedia</keyword>
<keyword
>MPlayer</keyword>
<keyword
>Konqueror</keyword>
<keyword
>Video</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Einleitung</title>
<para
>&kmplayer; ist eine einfache Benutzeroberfläche für <application
>MPlayer</application
>, <application
>Xine</application
> und <application
>FFMpeg</application
>. Das Programm wird gebraucht zum Abspielen von Videodateien der von <application
>MPlayer</application
>/<application
>Xine</application
> unterstützten Formate, sowie zur Wiedergabe von <acronym
>DVD</acronym
>s, <acronym
>VCD</acronym
>s oder <acronym
>TV</acronym
>/<acronym
>Kamera</acronym
>. </para>
<para
>Die Dokumentation für &kappname; war noch nicht beendet als &kde; auf diesem Rechner installiert wurde.</para
> <para
>Für Hilfe bitte die Seite <ulink url="http://www.kde.org"
> The KDE Website</ulink
> auf neue Versionen überprüfen, oder die Frage an <ulink url="mailto:kde-user@kde.org"
>The &kde; User Mailing list</ulink
> schicken.</para>
<para
><emphasis
>Das &kde;-Team</emphasis
></para>

</chapter>
<chapter id="settings">
<title
>Einstellungen</title>
<section>
    <title
>Animation beim Starten / Beenden</title>
    <para
>Die Animation beim Starten und Beenden kann deaktiviert werden durch das Editieren von <filename
>~/.trinity/share/config/kmplayerrc</filename
> und Ändern von <programlisting>
[General Options]
  No Intro=0
    </programlisting
> obiger Option auf '1'. Falls die Option nicht vorhanden ist, kann sie einfach eingefügt werden. </para>
<para
>Es ist auch möglich eine andere Animation zu aktivieren. KMPlayer wird die Dateien <filename
>~/.trinity/share/apps/kmplayer/intro.xml</filename
> und <filename
>~/.trinity/share/apps/kmplayer/exit.xml</filename
> beachten. Das Format muss eine unterstützte <acronym
>XML</acronym
> Datei sein. </para>
<para
>Die Animation beim Starten braucht nicht kurz zu sein, sie wird automatisch beendet durch das Öffnen einer anderen Quelle. Dies wäre bei der Ende-Animation allerdings störend, der Benutzer kann daher die Applikation ein zweites Mal beenden. </para>
<para
>Ein einfaches Beispiel einer Start-Animation kann das Anzeigen eines Lieblingsfotos sein:  <programlisting>
&lt;smil&gt;
  &lt;body&gt;
    &lt;img dur="indefinite" src="file:///home/koos/mum.gif" fit="meet"/&gt;
  &lt;/body&gt;
&lt;/smil&gt;
    </programlisting
> Im Quellpaket von KMPlayer sind im Verzeichnis <filename
>tests/</filename
> einige Beispiele von <acronym
>SMIL</acronym
> die von KMPlayer unterstützt werden. </para>
</section>
</chapter>
<chapter id="sources">
<title
>Die abspielbaren Quellen</title>
<para
>&kmplayer; kann von verschiedenen Quellen abspielen. Diese Quellen sind im Menü Quellen aufgeführt. </para>
<section id="tvsource">
    <title
>TV</title>
    <para
>&kmplayer; kann von TV Karten abspielen, entweder mittels <application
>MPlayer</application
> oder <acronym
>XVideo</acronym
> (dies braucht <application
>kxvplayer</application
>). Bevor TV geschaut werden kann, müssen das zu gebrauchende Gerät und die TV Kanäle konfiguriert werden. Dazu kann der Scanner aus dem Konfigurationsdialog benutzt werden oder die Konfigurationsdatei kann manuell editiert werden. </para>
<para
>Die Konfigurationsdatei für die TV Einstellungen ist eine  <acronym
>XML</acronym
>-Datei mit dem Namen <filename
>~/.trinity/share/apps/kmplayer/tv.xml</filename
>. Das <acronym
>XML</acronym
> Format ist wie im folgenden Beispiel: <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
> Es ist darauf zu achten, dass <quote
>input</quote
> Elemente mit <quote
>channels</quote
> das <quote
>tuner</quote
> Attribut auf <quote
>1</quote
> gesetzt haben sollten. </para>
<para
><acronym
>XVideo</acronym
> braucht nur die <quote
>xvport</quote
> und <quote
>xvenc</quote
> Attribute; diese können nur durch manuelles Editieren der Datei gesetzt werden. Die Werte dieser beiden Attribute können ausgelesen werden, indem <quote
>kxvplayer</quote
> in einer Terminal Anwendung wie z.B. <quote
>konsole</quote
> gestartet wird. Für jeden Port wird <quote
>kxvplayer</quote
> eine Zeile wie unten aufgeführt ausgeben. Die Werte können daraufhin für die erwähnten Attribute gesetzt werden. <programlisting>
    xvport 240
    ....
    encoding: 0 PAL-television
    encoding: 1 NTSC-television
    encoding: 2 SECAM-television
    ....   
</programlisting
> Die Attribute für die Breite und die Höhe werden vom <acronym
>XVideo</acronym
>-Spieler nicht beachtet. Dieses Programm erhält seine Bildgröße vom X Server. Einer der Vorteile von <acronym
>XVideo</acronym
> ist die Eigenschaft, dass die Skalierung durch die Hardware erledigt wird, d.h. durch die Video Karte, und somit auch im Vollbildmodus ohne CPU Belastung und ohne Wechsel der Bildschirmauflösung. Ebensowenig gibt es ein Flickern wenn ein anderes Fenster das Videobild überlagert. </para>
<para
>Im Kapitel VDR sind mehr Informationen enthalten über den Gebrauch von <acronym
>XVideo</acronym
>. </para>
</section>
<section id="vdrsource">
    <title
>VDR</title>
<para
>Zum Konfigurieren der VDR (Video Daten Rekorder) Einstellungen im kmplayer ist der Dialog in den Einstellungen unter ->Quelle->VDR->XVideo Port zu benutzen. Dort sollten Ports erkannt werden, von denen einer ausgewählt wird. Die zu verwendende Codierung muss herausgefunden werden (z.B. ist es PAL für West Europa), der korrekte Name hat wahrscheinlich ein<quote
>dvb</quote
> darin enthalten. </para>
<para
>Als Beispiel sei im PC eine TV Karte, eine DVB-S Karte und eine Webkamera eingebaut. In diesem Fall enthält die Konfiguration drei Ports. Der erste Port enthält eine lange Liste mit Einträgen für NTSC(-JP)/PAL(-M)/SECAM , die alle etwas über Television/Composite/Svideo (die TV Karte) aussagen. Der zweite Port enthält NTSC-dvb/PAL-dvb/SECAM-dvb (die DVB-S Karte). Und schliesslich der dritte Port, der nur ntsc/pal enthält (vermutlich die Webkamera). Daher ist in diesem Fall der zweite Port mit dem zweiten Eintrag (diesen einfach nur auswählen) zu konfigurieren (PAL-dvb). </para>
<para
>Da die VDR Unterstützung von kmplayer nur <acronym
>XVideo</acronym
> nutzen kann, sollte <acronym
>XVideo</acronym
> auch funktionieren (vermutlich ist diese Art des Abspielens von Video Geräten unter Linux die einzige die funktioniert). Dies wird zudem auch nur auf dem ersten Bildschirm (:0.0) untertstützt. Aus diesem Grund muss die <quote
>videoforlinux</quote
> Erweiterung für den X Server funktionstüchtig sein. Für den XFree86 Server muss daher in seiner Konfigurationsdatei (<filename
>/etc/X11/XF86Config</filename
>) folgendes enthalten sein <programlisting
>Section "Module" 
     .... 
     Load    "v4l" 
EndSection
</programlisting>
</para>
<para
>Unglücklicherweise muss man bei jedem Aktualisieren des Video Treibers diese Einstellung wieder konfigurieren. </para>
</section>
<section id="kmplayer_url">
    <title
>Kommandozeile</title>
<para
>Intern werden von KMPlayer für die Quellen verschiedene Namen benutzt. Zum Zeitpunkt der Entstehung dieser Dokumentation sind dies "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" und "vdrsource". Wenn sie aktiviert werden, beginnen sie mit dem Abspielen der Wiedergabeliste. </para>
<para
>Eine bestimmte Quelle kann mit der <acronym
>URL</acronym
> der Form <filename
>kmplayer://</filename
> aktiviert werden. Für den Rechnernamen ist der Quellname zu setzen  und optional der Pfad als Teil des zusätzlichen Arguments; für einen Kanal der Quelle "vdrsource" könnte dies wie folgt aussehen: <filename
>kmplayer://vdrsource/22 MTV 2</filename
>. Die nachfolgende Kommandodatei startet kmplayer mit der Quelle "dvdnavsource" unter Nutzung von <acronym
>DCOP</acronym
> um im Vollbildmodus wiederzugeben. <programlisting>
/bin/bash
kmplayer kmplayer://dvdnavsource/ &amp;
PID=$!
sleep 2
dcop kmplayer-$PID KMediaPlayer toggleFullScreen
    </programlisting
> Für einige Quellen wird dies nicht viel ergeben, weil diese nicht für das übliche Abspielen vorgesehen sind. Für "pipesource" ist dies abgeschaltet, weil dies natürlich eine grosse Sicherheitslücke wäre. </para>
</section>
</chapter>
<chapter id="questionsanswersandtips">
    <title
>Fragen, Antworten, und Tips</title>

    <qandaset id="faq">
      <title
>Häufig gestellte Fragen</title>
      <qandaentry>
        <question>
          <para
>Xine startet nur langsam auf, wieso muss jedes Mal meine CPU auf ihre Leistung geprüft werden?</para>
        </question>
        <answer>
            <para
>Anmerkung: die Antwort ist überholt. <application
>kxineplayer</application
> braucht automatisch den letzten gespeicherten Wert, nur das erste Mal wird xine die CPU prüfen. </para>
            <para
>Die <application
>Xine</application
> Oberfläche für &kmplayer;, <application
>kxineplayer</application
>, braucht <filename
>~/.trinity/share/apps/kmplayer/xine_config</filename
> für ihre Konfiguration. Die Einstellungen für <application
>Xine</application
> befinden sich im Konfigurationsdialog <quote
>Generelle Optionen</quote
>|<quote
>Xine</quote
>. (Wird hier eine Option geändert und gesichert, so enthält <filename
>~/.trinity/share/apps/kmplayer/xine_config</filename
> ebenfalls einige Erklärungen). Die Leistungsmessung der CPU wird durch das Setzen der Option <computeroutput
>misc.memcpy_method</computeroutput
> auf den Wert <computeroutput
>probe</computeroutput
>aktiviert. Um festzustellen welche memcpy Version am schnellsten arbeitet, muss <quote
>Konsole</quote
> aus dem Menü <quote
>Ansicht</quote
> gewählt werden. Die Resultate der Leistungsmessung werden beim Abspielen mit Xine angezeigt. <computeroutput
>misc.memcpy_method</computeroutput
> ist mit der Methode mit der kleinsten gemessenen Zeit zu konfigurieren.</para>
        </answer>
      </qandaentry>
      <qandaentry>
        <question>
            <para
>Gibt es Hinweise wie ich mein CDROM Laufwerk leiser machen kann, wenn ich von ihm abspiele (nicht von der VCD://)?</para>
        </question>
        <answer>
            <para
>Ja, der Befehl <command
>hdparm -E 8 /dev/cdrom</command
> ist als Benutzer "root" nach dem Einbinden des Geräts auszuführen. Dabei ist unbedingt sicher zu stellen, dass  <filename
>/dev/cdrom</filename
> auf das CDROM Laufwerk zeigt. </para>
        </answer>
      </qandaentry>
    </qandaset>

  </chapter>
<chapter id="credits-and-licenses">
<title
>Mitwirkende und Lizenzen</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:
-->













