RealVideo libraries support

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

3 files changed, 42 insertions, 8 deletions

diff --git a/DOCS/codecs.html b/DOCS/codecs.html
index 594d1b1979..6977dfb0af 100644
--- a/DOCS/codecs.html
+++ b/DOCS/codecs.html
@@ -29,7 +29,8 @@ daily generated list!!!</P>
 <LI>MJPEG, AVID, VCR2, ASV2 and other hardware formats</LI>
 <LI>VIVO 1.0, 2.0, I263 and other h263(+) variants</LI>
 <LI>FLI/FLC</LI>
-<LI>RealVideo 1.0</LI>
+<LI>RealVideo 1.0 from ffmpeg, and RealVideo 2.0, 3.0 using RealPlayer
+  libraries</LI>
 <LI>Various old simple RLE-like formats</LI>
 </UL>
 
@@ -217,9 +218,16 @@ video output driver permits it.</P>
 
 <P><B><A NAME=2.2.1.8>2.2.1.8.  RealVideo</A></B></P>
 
-<P>Currently <B>only</B> the RealVideo 1.0 (fourcc RV10) codec is supported through
-FFmpeg. Sadly, new RealMedia files come with the newer and closed source RV20 and
-RV30 codecs instead. Their future support is unlikely :(</P>
+<P><B>MPlayer</B> supports decoding all versions of RealVideo:
+  <UL>
+    <LI>RealVideo 1.0 (fourcc RV10) - en/decoding supported by <B>libavcodec</B></LI>
+    <LI>RealVideo 2.0 (fourcc RV20) - decoding supported by <B>RealPlayer libraries</B></LI>
+    <LI>RealVideo 3.0 (fourcc RV20) - decoding supported by <B>RealPlayer libraries</B></LI>
+  </UL>
+</P>
+
+<P>On how to install RealPlayer libraries, see the
+  <A HREF="formats.html#2.1.1.7">RealMedia file format</A> section.</P>
 
 
 <P><B><A NAME=2.2.1.9>2.2.1.9.  XViD</A></B></P>
@@ -336,6 +344,8 @@ then copy it into the <CODE>/usr/lib/win32</CODE> directory.</P>
 low-bitrate version of the well known AC3 codec. It can be found in both
 old and new RealMedia movies.</P>
 
+<P>RealAudio libraries from RealPlayer can't be used right now.</P>
+
 
 <P><B><A NAME=2.2.3>2.2.3. Win32 codec importing HOWTO</A></B></P>
 
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index 4e93bce4db..0a67029e1d 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -481,6 +481,11 @@ movies are best played with <B>MPlayer</B>'s own Cinepak decoder !</LI>
   <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A>
   (this is a nightly updated tarball of vorbis CVS).</LI>
 
+<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
+  <B>RealVideo 2.0 and 3.0</B> files. See
+  <A HREF="formats.html#2.1.1.7">RealMedia file format</A> section for
+  installation instructions and more information!</LI>
+
 </UL>
 
 <P><B><I>VIDEOCARDS</I></B></P>
@@ -2080,6 +2085,11 @@ version (/usr/ports/x11/mplayer).</P>
   <LI>OSD/subtitles outside movie - for SDL</LI>
 </UL></LI>
 
+<LI><B><A HREF="mailto:flo-mplayer-dev@gmx.net">Florian Schneider</A></B>
+<UL>
+  <LI>RealVideo libraries loader</LI>
+</UL></LI>
+
 </UL></P>
 
 <P>Main testers:</P>
diff --git a/DOCS/formats.html b/DOCS/formats.html
index 8cc132d77f..14258a6e41 100644
--- a/DOCS/formats.html
+++ b/DOCS/formats.html
@@ -170,10 +170,24 @@ will be messy for a short time after seeking.</P>
 
 <P><B><A NAME=2.1.1.7>2.1.1.7. RealMedia (RM) files</A></B></P>
 
-<P>Yes, <B>MPlayer</B> can read (demux) RealMedia (.rm) files. Seeking works
-(the format supports keyframes). Here are the lists of the supported
-<A HREF="codecs.html#2.2.1.8">RealVideo</A>
-and <A HREF="codecs.html#2.2.2.5">RealAudio</A> codecs.
+<P>Yes, <B>MPlayer</B> can read (demux) RealMedia (.rm) files. Seeking works,
+  but you have to explicitly specify the <CODE>-forceidx</CODE> option
+  (the format supports keyframes). Here are the lists of the supported
+  <A HREF="codecs.html#2.2.1.8">RealVideo</A>
+  and <A HREF="codecs.html#2.2.2.5">RealAudio</A> codecs.</P>
+
+<P>It's recommended to download and install RealPlayer8 or RealONE, because
+  <B>MPlayer</B> can use their libraries to decode files with RealVideo 2.0 or
+  RealVideo 3.0 video! All you have to do is:</P>
+<P>
+  &nbsp;&nbsp;<CODE>ln -s /usr/local/RealPlayer8/Codecs $PREFIX/real</CODE>
+</P>
+
+<P>NOTE: RealPlayer's installation path may differ from the above, please check
+  it.</P>
+
+<P>NOTE: RealPlayer libraries currently <B>can only be used on x86 platform,
+  and Linux or FreeBSD</B>!</P>
 
 
 <P><B><A NAME=2.1.1.8>2.1.1.8. NuppelVideo files</A></B></P>