DOXized and applied Nick's radeon_vid patch. Nick, should I update

the VESA section or do you want to do it ?


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@2957 b3059339-0415-0410-9bf9-f77b7e298cf2

2 files changed, 35 insertions, 2 deletions

diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index d1860cdec2..1e8b984b92 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -101,6 +101,7 @@
 	<LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - text mode displaying</A></LI>
 	<LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - output to VESA BIOS</A></LI>
 	<LI><A HREF="video.html#2.3.1.13">2.3.1.13 X11</A></LI>
+	<LI><A HREF="video.html#2.3.1.14">2.3.1.14 Radeon framebuffer (radeon_vid)</A></LI>
 	<LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A></LI>
 	<UL>
 	  <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox</A></LI>
@@ -292,7 +293,9 @@ otherwise no 3Dfx support will be built. Also see the <A HREF="video.html#2.3.1.
 TV out section</A>.</LI>
 
 <LI>If you own an ATI card, see the <A HREF="video.html#2.3.1.A.2">ATI cards
-section</A> of the TV-out documentation, to know what features of your card is supported under Linux/MPlayer.</LI>
+section</A> of the TV-out documentation, to know what features of your card is supported under Linux/MPlayer.
+If you have a <B>Radeon</B> card, we have a <B>radeon_vid</B> driver for you !
+Check <A HREF="video.html#2.3.1.14">this</A> section !</LI>
 
 <LI>If you plan to use the ProjectMayo's <B>DivX4</B> codec, check the
 <A HREF="codecs.html#2.2.1.1">2.2.1.1</A> section before compiling.
diff --git a/DOCS/video.html b/DOCS/video.html
index e36b50a0df..8b38bdf8f4 100644
--- a/DOCS/video.html
+++ b/DOCS/video.html
@@ -731,6 +731,36 @@ handy, but you need powerful CPU to use software scaling. Don't use the
 SDL driver's software output+scaler, it has worse image quality !</P>
 
 
+<P><B><A NAME=2.3.1.14>2.3.1.14. Radeon framebuffer (radeon_vid)</A></B></P>
+<P>
+<b>radeon_vid</b> provides support for the <b>BackEnd Scaler</b> on ATI <b>Radeon</b> chipsets.
+It was designed and introduced as analog of <a href="video.html#2.3.1.7">mga_vid</a> driver, so you can use it in the same way!<br>
+But main goal of this driver usage is <a href="video.html#2.3.1.12">VESA</a> driver.<br>
+Simply because VESA enables TV-out on ATI's card but Backend scaler is used after
+mode switching. This implementation outputs video stream on both: <b>TV-screen</b> and <b>CRTC</b>
+display simultaneously. (It slightly degrades quality of video output but it's
+much better than nothing).
+Sorry! I couldn't find out any video overlay's related information
+on ATI pages. (I planned to implement it through <b>int 10h</b> calls). But it was
+very easy to implement this stuff through reading/writing Radeon ports.
+<br><b>NOTE</b>: XXX_VID technology is perfectly undocumented and maybe in the
+future this stuff will be fully rewritten. This is the first public release of
+driver.</P>
+
+<P>
+  <b>Location:</b><BR>
+&nbsp;&nbsp;mplayer-CVS:main/drivers/radeon/radeon_vid*
+<br><b>Usage:</b><BR>
+&nbsp;&nbsp;<CODE>mplayer -vo vesa:lvo:/dev/radeon_vid &lt;your options&gt; filename</CODE>
+</P>
+
+<P><b>Limitations:</b> Currently it works only with <b>YUY2</b> format, so use the DirectShow codec
+family with it. You should have at least 32MB of video memory.<br>
+<b>Conclusion:</b> I know there are lot of lacks and bugs. So if you are able
+to improve something then simply send me your patches.
+</P>
+
+
 <P><B><A NAME=2.3.1.A>2.3.1.A. TV-out support</A></B></P>
 
 <P><B><A NAME=2.3.1.A.1>2.3.1.A.1. Matrox cards</A></B></P>
@@ -874,7 +904,7 @@ documentation.
 </P>
 
 
-<P><B><A NAME=2.3.1.A.3>2.3.1.A.3. Voodoo 3</A></B></P>
+<P><B><A NAME=2.3.1.A.4>2.3.1.A.4. Voodoo 3</A></B></P>
 
 <P>
 Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.