[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    extragear/multimedia/doc/kmplayer
From:       Koos Vriezen <koos.vriezen () xs4all ! nl>
Date:       2006-09-03 13:31:03
Message-ID: 1157290263.735610.30577.nullmailer () svn ! kde ! org
[Download RAW message or body]

SVN commit 580409 by vriezen:

Add some help to get the backends running

BUG:133214


 M  +67 -1     index.docbook  


--- trunk/extragear/multimedia/doc/kmplayer/index.docbook #580408:580409
@@ -28,7 +28,7 @@
 
 <copyright>
 <year>2002</year>
-<year>2003</year>
+<year>2006</year>
 <holder>Koos Vriezen</holder>
 </copyright>
 <!-- Translators: put here the copyright notice of the translation -->
@@ -106,6 +106,72 @@
 </para>
 </section>
 </chapter>
+<chapter id="backends">
+<title>The backend players</title>
+<para>
+&kmplayer; uses external programs to do the actual playing.
+</para>
+<section id="mplayer">
+<title>MPlayer</title>
+<para>
+There is a configuration tab for MPlayer in &kmplayer;'s config dialog. Here
+you can set MPlayer's path and it cache size for network stream, among other
+things.
+</para>
+<section id="mplayer-debug">
+<title>Trouble shooting</title>
+<para>
+The best way to debug this backend is to start &kmplayer; from a console
+application like konsole. Then start a movie with kmplayer and see the exact
+commandline that is used to start mplayer in the console application.
+Now copy/paste that to another console, remove the '-wid 12344' options, and
+make it play. Probably it's just choosing the right -ao/-vo params. Also make
+sure mplayer doesn't start default with a GUI.
+</para>
+<para>
+Another debugging tool is the 'console' button in kmplayer's toolbar. Here you
+can see the output from mplayer.
+</para>
+</section>
+</section>
+<section id="xine">
+<title>Xine</title>
+<para>
+When configured &kmplayer; with Xine support, there will be configuration tab
+for Xine in &kmplayer;'s config dialog. Here you can set various options.
+These options are dynamic retrieved from the Xine library. Use context help to
+get information on what these options do (ie. click on the question mark
+button from the dialog title bar and then click on an option).
+</para>
+<para>
+The options are saved in
+<filename>.kde/share/apps/kmplayer/xine_config</filename> as a text document.
+</para>
+<section id="xine-debug">
+<title>Trouble shooting</title>
+<para>
+Basically the same way as trouble shooting
+<link linkend="mplayer-debug">MPlayer</link>, with the application name of
+<filename>kxineplayer</filename>.
+</para>
+</section>
+</section>
+<section id="gstreamer">
+<title>GStreamer</title>
+<para>
+There is no configuration tab for GStreamer in &kmplayer;'s config dialog. The
+common options for eg. <acronym>DVD</acronym> device are used when appropriate.
+</para>
+<section id="gstremaer-debug">
+<title>Trouble shooting</title>
+<para>
+Basically the same way as trouble shooting
+<link linkend="mplayer-debug">MPlayer</link>, with the application name of
+<filename>kgstplayer</filename>.
+</para>
+</section>
+</section>
+</chapter>
 <chapter id="sources">
 <title>The playable sources</title>
 <para>
[prev in list] [next in list] [prev in thread] [next in thread]