From 1bcedca760e003c8c2d34797b7f96bbb68cd55bd Mon Sep 17 00:00:00 2001 From: diego Date: Wed, 24 Jul 2002 01:56:08 +0000 Subject: [PATCH] Moved RealPlayer libs installation to codecs.html where all the other installation instructions are. Always use Note: for consistency, reworded parts all over the place. git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6776 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/codecs.html | 38 ++++++++++++++++-------- DOCS/formats.html | 76 +++++++++++++++++++---------------------------- 2 files changed, 56 insertions(+), 58 deletions(-) diff --git a/DOCS/codecs.html b/DOCS/codecs.html index f5d0e8cd05..b3e398bec1 100644 --- a/DOCS/codecs.html +++ b/DOCS/codecs.html @@ -60,7 +60,7 @@ encoding. One disadvantage of this codec is that it is currently closed source.<

Unpack it, and run ./install.sh as root.

-

Note: Do NOT forget adding /usr/local/lib to your +

Note: Do not forget adding /usr/local/lib to your /etc/ld.so.conf and running ldconfig!

MPlayer autodetects DivX4/DivX5 if it is properly installed, just @@ -85,18 +85,18 @@ bandwidth on the bus. For packed YUV modes (YUY2, UYVY) use the -vc divx4< method. For RGB modes the speed is the same, differing at best according to your current color depth.

-

NOTE: If your -vo driver supports direct rendering, then -vc divx4 may be -faster, or even the fastest solution.

+

Note: If your -vo driver supports direct rendering, then + -vc divx4 may be faster or even the fastest solution.

2.2.1.2. FFmpeg DivX/libavcodec

Beginning with version 0.4.2, FFmpeg contains an -open source DivX codec, which is compatible with the traditional DivX. +open source DivX codec, which is compatible with traditional DivX. MPlayer supports this codec, making it possible to watch -DivX/DivX4/DivX5/MP41/MP42 movies on non-x86 platforms. Furthermore it offers higher -decoding speed than the Win32 codecs or the original +DivX/DivX4/DivX5/MP41/MP42 movies on non-x86 platforms. Furthermore it +offers higher decoding speed than the Win32 codecs or the original DivX4 library!

It also contains a lot of nice codecs, such as RealVideo 1.0, WMV7, @@ -117,7 +117,7 @@ libavcodec from the FFmpeg CVS tree as FFmpeg 0.4.5 does not work with

  • Compile. Configure should detect problems before compilation.
  • -

    NOTE: MPlayer from CVS does contain a libavcodec +

    Note: MPlayer from CVS does contain a libavcodec subdirectory, but it does NOT contain the source for libavcodec! You must follow the steps above to obtain the source for this library.

    @@ -207,8 +207,20 @@ video output driver permits it.

  • RealVideo 3.0 (fourcc RV30) - decoding supported by RealPlayer libraries
  • -

    On how to install RealPlayer libraries, see the - RealMedia file format section.

    +

    It is recommended to download and install RealPlayer8 or RealONE, because + MPlayer can use their libraries to decode files with RealVideo 2.0 or + RealVideo 3.0 video. You may also just take the RealPlayer libraries from a + full installation and put them in a suitable directory like + /usr/lib/real or $LIBDIR/real. The MPlayer + configure script should detect the RealPlayer libraries there or in the + standard locations of a full installation. If it does not, tell configure + where to look with the --with-reallibdir switch.

    + +

    Note: RealPlayer libraries currently only work with Linux, FreeBSD, + NetBSD and Cygwin on the x86 platform!

    + +

    Note2: We cannot distribute the RealPlayer libraries, the license does + not allow this. You have to get them yourself.

    2.2.1.9. XViD

    @@ -253,16 +265,16 @@ video output driver permits it.

    2.2.1.10. Sorenson

    Sorenson is a video codec developed by Apple. We are currently - able to decode the first version of it (SVQ1), with a native decoder.

    + able to decode the first version (SVQ1) with a native decoder.

    Advantages:

    Disadvantages:

    Installation: it's compiled and usable per default.

    @@ -408,7 +420,7 @@ If not, you are out of luck. Try guessing (e.g. search for TrueMotion). field. Write down the 16 byte CLSID, this is the GUID we need. -

    NOTE: If searching fails, try enabling all the checkboxes. You may have +

    Note: If searching fails, try enabling all the checkboxes. You may have false hits, but you may get lucky...

    Now that you have all the necessary information (fourcc, GUID, codec file, diff --git a/DOCS/formats.html b/DOCS/formats.html index 8ac90adb72..c45368928a 100644 --- a/DOCS/formats.html +++ b/DOCS/formats.html @@ -42,7 +42,7 @@ and MEncoder can create these files.

    MPEG1 video, and MP2 (MPEG-1 layer 2) or rarely MP1 audio.
  • DAT: This is the very same format as MPG with a different extension. It is used on Video CDs. Due to the way VCDs are created and Linux is designed, -the DAT files cannot be played nor copied from VCDs as regular files. You have +DAT files cannot be played nor copied from VCDs as regular files. You have to use the -vcd option to play the Video CD.
  • VOB: This is the MPEG file format on DVDs. It is the same as MPG, plus the capability to contain subtitles or non-MPEG (AC3) audio. It contains encoded MPEG2 @@ -51,8 +51,8 @@ video and usually AC3 audio, but DTS, MP2 and uncompressed LPCM are allowed, too

    Series of frames form independent groups in MPEG files. This means that you -can cut/join an MPEG file with standard file tools (like dd, cut), and it -remains completely functional.

    +can cut/join an MPEG file with standard file tools (like dd, +cut), and it remains completely functional.

    One important feature of MPGs is that they have a field to describe the aspect ratio of the video stream within. For example SVCDs have @@ -63,22 +63,22 @@ rescaled during encoding or played with the -aspect option.

    2.1.1.2. AVI files

    -

    Designed by Micro$oft, AVI (Audio Video Interleaved) is a +

    Designed by Microsoft, AVI (Audio Video Interleaved) is a widespread multipurpose format currently used mostly for DivX and DivX4 video. It has many known drawbacks and shortcomings (for example in streaming). -It supports one video stream and 0 to 99 audio streams and can be as big as -2GB. There exists an extension allowing bigger files called OpenDMS. -M$ currently strongly discourages its use and encourages ASF/WMV. Not that +It supports one video stream and 0 to 99 audio streams. File size is limited to +2GB, but there exists an extension allowing bigger files called OpenDMS. +Microsoft currently strongly discourages its use and encourages ASF/WMV. Not that anybody cares.

    There is a hack that allows AVI files to contain an Ogg Vorbis audio stream, but makes them incompatible with standard AVI. MPlayer supports playing these files. Seeking is also implemented but severely hampered by badly encoded files with confusing headers. Unfortunately the - only encoder currently capable of creating these files, nandub, has this + only encoder currently capable of creating these files, NanDub, has this problem.

    -

    NOTE: DV cameras create raw DV streams that DV grabbing utilities +

    Note: DV cameras create raw DV streams that DV grabbing utilities convert to two different types of AVI files. The AVI will then contain either separate audio and video streams that MPlayer can play or the raw DV stream for which support is under development.

    @@ -99,8 +99,8 @@ stream for which support is under development.

    • bps-based: It is based on the bitrate/samplerate of the video/audio stream. This method is used by most players, including avifile - and windows media player. - Files with broken headers, and files created with VBR audio but not + and Windows Media Player. + Files with broken headers, and files created with VBR audio but not with a VBR-compliant encoder will result in A/V desync with this method (mostly at seeking).
    • interleaving-based: It does not use the bitrate value of the header, instead @@ -111,16 +111,16 @@ stream for which support is under development.

      Any audio and video codec is allowed, but note that VBR audio is not well supported by most players. The file format makes it possible to use VBR audio, but most players expect CBR audio, thus they fail with VBR. VBR is -uncommon and Microsoft's AVI specs only describe CBR audio. I also noticed that -most AVI encoders/multiplexers create bad files when using VBR audio. There are only -two exceptions (known to me): NaNDub and MEncoder.

      +uncommon and the Microsoft AVI specs only describe CBR audio. Most AVI +encoders/multiplexers create bad files when using VBR audio. There are only +two known exceptions: NanDub and MEncoder.

      2.1.1.3. ASF/WMV files

      ASF (active streaming format) comes from Microsoft. They developed two -variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (windows -media player and windows media encoder) and is very secret. v2.0 is published +variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (Windows +Media Player and Windows Media Encoder) and is very secret. v2.0 is published and patented :). Of course they differ, there is no compatibility at all (it is just another legal game). MPlayer supports only v1.0, as nobody has ever seen v2.0 files :). Note that ASF files nowadays come with the extension .WMA or @@ -129,16 +129,16 @@ v2.0 files :). Note that ASF files nowadays come with the extension .WMA or

      2.1.1.4. QuickTime/MOV files

      -

      These formats were designed by Apple. They usually have a .QT or .MOV extension. Note -that since the MPEG4 group chose QuickTime as the recommended file format -for MPEG4, their MOV files come with a .MPG or .MP4 extension (Interestingly -the video and audio streams in these files are real MPG and AAC files. With the --dumpvideo and -dumpaudio options you can even extract them!).

      +

      These formats were designed by Apple and can contain any codec, CBR or VBR. +They usually have a .QT or .MOV extension. Ever since the MPEG4 group chose +QuickTime as the recommended file format for MPEG4, their MOV files come with a +.MPG or .MP4 extension (Interestingly the video and audio streams in these +files are real MPG and AAC files. You can even extract them with the +-dumpvideo and -dumpaudio options.).

      -

      Codecs: Any codec is allowed, both CBR and VBR. Note: most new QuickTime files use -Sorenson video and QDesign Music audio. See our -Sorenson codec section. QDesign Music -audio currently can't be played.

      +

      Note: Most new QuickTime files use Sorenson video and QDesign + Music audio. See our Sorenson codec + section. QDesign Music audio currently cannot be played.

      2.1.1.5. VIVO files

      @@ -173,21 +173,6 @@ will be messy for a short time after seeking.

      RealVideo and RealAudio codecs.

      -

      It's recommended to download and install RealPlayer8 or RealONE, because - MPlayer can use their libraries to decode files with RealVideo 2.0 or - RealVideo 3.0 video!

      - -

      The MPlayer configure script should detect the RealPlayer libraries - in all standard locations. If it does not, tell configure where to look with - the --with-reallibdir switch.

      - -

      It is also possible to just take the RealPlayer libraries from somewhere and - put them in a suitable directory like /usr/lib/real or - $LIBDIR/real.

      - -

      NOTE: RealPlayer libraries currently only work with Linux, FreeBSD, - NetBSD and Cygwin on the x86 platform!

      -

      2.1.1.8. NuppelVideo files

      @@ -195,15 +180,15 @@ will be messy for a short time after seeking.

      is a TV grabber tool (AFAIK:). MPlayer can read its .NUV files (only NuppelVideo 5.0). Those files can contain uncompressed YV12, YV12+RTJpeg compressed, YV12 RTJpeg+lzo compressed, and YV12+lzo compressed -frames. MPlayer decodes (and also encodes them with MEncoder to -DivX/etc!) them all. Seeking works.

      +frames. MPlayer decodes them all (and also encodes them with +MEncoder to DivX/etc!). Seeking works.

      2.1.1.9. yuv4mpeg files

      yuv4mpeg / yuv4mpeg2 is a file format used by the mjpegtools programs. -You can grab, produce, filter or encode video in this format using these. +You can grab, produce, filter or encode video in this format using these tools. The file format is really a sequence of uncompressed YUV 4:2:0 images.

      @@ -221,8 +206,9 @@ The file format is really a sequence of uncompressed YUV 4:2:0 images.

      2.1.1.12. OGG files

      -

      This is a new fileformat from Xiphophorus, developed to contain Vorbis - audio. You'll need libogg and libvorbis installed +

      This is a new file format from Xiphophorus. + It can contain any video or audio codec, CBR or VBR. You will need to + have libogg and libvorbis installed before compiling MPlayer to be able to play it.