[kmplayer/0.11] doc: Update XVideo info

[Koos Vriezen]

Git commit 45395b71e41f171e76a16c8d29a162ff0d6d96e4 by Koos Vriezen.
Committed on 10/07/2005 at 13:23.
Pushed by ltoscano into branch '0.11'.

Update XVideo info

CCMAIL: rjenster at arcor.de

I hope you will correct your statements about scaling at
http://forums.gentoo.org/viewtopic-t-346406-highlight-kmplayer+vdr.html
?


svn path=/trunk/extragear/multimedia/doc/kmplayer/; revision=433331

M  +15   -7    doc/index.docbook

https://commits.kde.org/kmplayer/45395b71e41f171e76a16c8d29a162ff0d6d96e4

diff --git a/doc/index.docbook b/doc/index.docbook
index 8de759b..2a91149 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -83,13 +83,14 @@ to:kde-user at kde.org">The &kde; User Mailing list</ulink>.</para>
 <section>
     <title>TV</title>
     <para>
-        KMPlayer can play from TV cards using <quote>MPlayer</quote> or <quote>XVideo</quote>. Before you can watch TV, you have to configure which device to use and the TV channels. You can use the scanner from the configure dialog for this or edit the config file manually.
+        &kmplayer; can play from TV cards using <application>MPlayer</application> or <acronym>XVideo</acronym> (using <application>kxvplayer</application>). Before you can watch TV, you have to configure which device to use and the TV channels. You can use the scanner from the configure dialog for this or edit the config file manually.
 </para>
 <para>
-    The config file for TV settings is a XML file, located <filename>~/.kde/share/apps/kmplayer/tv.xml</filename>. The XML format is like this example:
+    The config file for TV settings is a <acronym>XML</acronym> file, located <filename>~/.kde/share/apps/kmplayer/tv.xml</filename>. The <acronym>XML</acronym> format is like this example:
     <programlisting>
 <tvdevices>
-    <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">
+    <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">
         <input name="Television" id="0" tuner="1" norm="PAL" xvenc="0">
             <channel name="Ned1" frequency="21600"/>
             <channel name="VCR" frequency="59490"/>
@@ -98,12 +99,16 @@ to:kde-user at kde.org">The &kde; User Mailing list</ulink>.</para>
         <input name="S-Video" id="2" xvenc="14"/>
         <input name="Composite3" id="3"/>
     </device>
-    <device path="/dev/video1" width="640" height="480" name="Philips 740 webcam" audio="" minwidth="160" minheight="120" maxwidth="640" maxheight="480" playback="1">
+    <device path="/dev/video1" width="640" height="480" name="Philips 740 webcam" audio=""
+              minwidth="160" minheight="120" maxwidth="640" maxheight="480" playback="1">
         <input name="Webcam" id="0"/>
     </device>
 </tvdevices>
 </programlisting>
-Note that currently the <quote>xvport</quote> and <quote>xvenc</quote> attributes can only be set manually editing this file. The values of these two attributes can be retrieved by running <quote>kxvplayer</quote> in a terminal application like <quote>konsole</quote>. For every port, <quote>kxvplayer</quote> will output lines like below and the numbers can be set for the attributes mentioned.
+Note that <quote>input</quote> elements having channels, should have the <quote>tuner</quote> attribute set to <quote>1</quote>.
+</para>
+<para>
+<acronym>XVideo</acronym> only uses the <quote>xvport</quote> and <quote>xvenc</quote> attributes and they can only be set by manually editing this file. The values of these two attributes can be retrieved by running <quote>kxvplayer</quote> in a terminal application like <quote>konsole</quote>. For every port, <quote>kxvplayer</quote> will output lines like below and the numbers can be set for the attributes mentioned.
 <programlisting>
     xvport 240
     ....
@@ -112,7 +117,10 @@ Note that currently the <quote>xvport</quote> and <quote>xvenc</quote> attribute
     encoding: 2 SECAM-television
     ....   
 </programlisting>
-See the VDR section for more information about using <quote>XVideo</quote>.
+Also with and heigt attributes are ignored by the <acronym>XVideo</acronym> player. This player gets the sizes from the X server. One of the nice things of <acronym>XVideo</acronym> is that scaling is done in hardware, by the video card, so fullscreen support without CPU usage and without resolution change of you monitor. Also no annoying flicker when another window overlaps this video window.
+</para>
+<para>
+See the VDR section for more information about using <acronym>XVideo</acronym>.
 </para>
 </section>
 <section>
@@ -124,7 +132,7 @@ To configure your VDR settings in kmplayer, see the Configure panel->Source->VDR
  For instance, I have a TV card, a DVB-S card and a webcam pluged into my system. With these, my settings are that there are three Ports. The first one has a long list of NTSC(-JP)/PAL(-M)/SECAM entries all saying something about television/composite/svideo (my TV card). The second one has NTSC-dvb/PAL-dvb/SECAM-dvb (my DVB-S card). And finally the third has only ntsc/pal (probably my webcam). I should therefore configure (just select it) the second port and second entry (PAL-dvb). 
 </para>
 <para>
- Because VDR support from kmplayer can only use XVideo, of course XVideo should work (and I believe for video devices, this way of viewing only works on linux). Also this only works on your first display (:0.0). So make sure <quote>videoforlinux</quote> extension works with the X server. For the XFree86 server, therefor in its configuration (<filename>/etc/X11/XF86Config</filename>) it should have
+    Because VDR support from kmplayer can only use <acronym>XVideo</acronym>, of course <acronym>XVideo</acronym> should work (and I believe for video devices, this way of viewing only works on linux). Also this only works on your first display (:0.0). So make sure <quote>videoforlinux</quote> extension works with the X server. For the XFree86 server, therefor in its configuration (<filename>/etc/X11/XF86Config</filename>) it should have
 <programlisting>
 Section "Module" 
      ....