# HG changeset patch # User gabucino # Date 1005066296 0 # Node ID 62bcea66003e646dedad6966ce5fbfc59127311d # Parent 205deb33f8ee9eb026da80cbf8664064b866ce11 oh my god what have i done... format.html, codecs, video, sound.html renumbered, etc diff -r 205deb33f8ee -r 62bcea66003e DOCS/codecs.html --- a/DOCS/codecs.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/codecs.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,32 +3,15 @@ -

2.1. Video Formats, Audio & Video Codecs

- -

2.1.1. Supported input formats

- -

MPlayer can read/play from the following devices/formats:
-

- -

Note: about realmedia (.ra/.rm) support read the FAQ!

+

2.2. Supported codecs

-

2.1.2. Supported audio & video codecs

+

2.2.1. Video codecs

See http://www.mplayerhq.hu/DOCS/codecs-status.html for the complete, daily generated list!!!

-

The most important video codecs:
+

The most important ones above all:

-

The most important audio codecs:
-

- -

If you have a codec not listed here, and not supported yet, just read section 2.1.3 to get info about how to help us adding support +

If you have a Win32 codec not listed here, and not supported yet, just read the codec importing to get info about how to help us adding support for it!

-

2.1.2.1. DivX4

+

2.2.1.1. DivX4

This section contains information about the DivX4 codec of ProjectMayo. Their first available alpha version was the OpenDivX 4.0 @@ -110,7 +85,7 @@ hard prostprocessing, eats many CPU (like level 4 with divxds

-

2.1.2.2. ffmpeg's DivX/libavcodec

+

2.2.1.2. ffmpeg's DivX/libavcodec

Beginning with version 0.4.2 , ffmpeg contains an opensource DivX codec, which is compatible with the traditional DivX. MPlayer supports this codec, @@ -150,15 +125,7 @@ highest resolution DivX/DivX4 movies on my K6/2 500, without framedrop.

-

2.1.2.3. Hardware AC3 decoding

- -

You'll need an AC3 capable soundcard, with digital out (SP/DIF). The -card's driver must support the AFMT_AC3 format (like SB Live! does). -Connect your AC3 decoder to the SP/DIF output, and use the '-ac hwac3' -option. It may or may not work (experimental). (probably won't...)

- - -

2.1.2.4. XAnim codecs

+

2.2.1.3. XAnim codecs

Foreword: using (some) XAnim codecs with other program than XAnim, is ILLEGAL. It is YOUR responsibility to read its license, @@ -185,7 +152,43 @@

Tested codecs are: Indeo 3.2, 4.1, 5.0, CVID, 3ivX, h263.

-

2.1.2.5. libmad support

+

2.2.1.4. VIVO video

+ +

TODO

+ + +

2.2.1.5. MPEG 1/2 video

+ +

MPEG1 and MPEG2 are decoded with the native library libmpeg2. +Its source code is included in MPlayer, and of course is multiplatform. +We handle buggy MPEG1/2 video files by checking for what signature does +libmpeg2 return, and when it gives sig11 (segmentation fault), we quickly +reinitialize the codec, and continue exactly from where the failure did occur. +No speed decrease is measurable.

+ + +

2.2.2. Audio codecs

+ +

The most important audio codecs above all :
+

+ + +

2.2.2.1. Hardware AC3 decoding

+ +

You'll need an AC3 capable soundcard, with digital out (SP/DIF). The +card's driver must support the AFMT_AC3 format (like SB Live! does). +Connect your AC3 decoder to the SP/DIF output, and use the '-ac hwac3' +option. It may or may not work (experimental). (probably won't...)

+ + +

2.2.2.2. libmad support

libmad is a multiplatform MPEG audio decoding library. If you don't know why is it good, you probably don't need it.

@@ -194,9 +197,9 @@ option.

-

2.1.3. Codec importing howto

+

2.2.3. Win32 codec importing howto

-

2.1.3.1. VFW codecs

+

2.2.3.1. VFW codecs

VfW (Video for Windows) is the old Video API for Windows. Its codecs have the .DLL or (rarely) .DRV extension. @@ -224,7 +227,7 @@

    ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/

-

2.1.3.2. DirectShow codecs

+

2.2.3.2. DirectShow codecs

DirectShow is the newer Video API, which is even worse than its predecessor. Things are harder with DirectShow, since diff -r 205deb33f8ee -r 62bcea66003e DOCS/documentation.html --- a/DOCS/documentation.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/documentation.html Tue Nov 06 17:04:56 2001 +0000 @@ -29,72 +29,88 @@

  • 2. Features
  • 3. Usage
  • Then build MPlayer:

    @@ -291,7 +320,7 @@ make make install -

    It is recommended to browse the output of ./configure , it contains info +

    ALWAYS browse the output of ./configure , it contains info about what will be built, and what won't. You may also want to view config.h and config.mak files.

    @@ -305,7 +334,9 @@ unzip mp-arial-iso-8859-1.zip

    Only one thing remains: copy the codecs.conf file from the etc -directory (relative to the MPlayer tree) to $HOME/.mplayer/codecs.conf.

    +directory (relative to the MPlayer tree) to $HOME/.mplayer/codecs.conf . +You should also check the manpage and example.conf for available options, and insert them +into your config file, $HOME/.mplayer/config .

    1.4. What about the GUI?

    @@ -410,11 +441,21 @@

    You can change default behaviour by setting osdlevel= variable in config file.

    +

    2. Features

    -

    2.1. Video Formats, Audio & Video Codecs

    + +

    2.1. Supported formats

    + + +

    2.2. Supported codecs

    -

    2.2. Video & Audio output devices

    + +

    2.3. Video & Audio output devices

    + + +

    2.4. MEncoder - An All-Purpose Encoder

    +

    3. Usage

    diff -r 205deb33f8ee -r 62bcea66003e DOCS/encoding.html --- a/DOCS/encoding.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/encoding.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,7 +3,7 @@ -

    2.3. Encoding with MEncoder

    +

    2.4. Encoding with MEncoder

    Overview

    MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, diff -r 205deb33f8ee -r 62bcea66003e DOCS/formats.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/DOCS/formats.html Tue Nov 06 17:04:56 2001 +0000 @@ -0,0 +1,105 @@ + + + + + + +

    2.1. Supported formats

    + +

    MPlayer can read/play from the following devices/formats:
    +

      +
    • VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file +
    • DVD, directly from your DVD disk, using libdvdread for decryption +
    • MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file + formats +
    • RIFF AVI file format +
    • ASF/WMV 1.0 file format +
    • QT/MOV file format with (un)compressed headers +
    • VIVO format (.viv files) +
    • supports reading from file, stdin, or network via HTTP +

    + +

    Note: about realmedia (.ra/.rm) support read the FAQ!

    + +

    It's important to clarify a popular mistake. When people see a file with +.AVI extension, they instantly declare that isn't an MPEG file. +That's not true. At least not entirely. If you tell them that such a file +can contain MPEG1 video, they laugh at you. Feel free to kick their dumbass +faces, then tell them to RTFM.

    + +

    You see, a codec isn't equal to a file format.
    +Video codecs are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.
    +Video formats are: MPG, VOB, AVI, ASF.
    +

    + +

    In theory, you can happily put an OpenDivX video and MP3 audio +into a .MPG format file. Though most players won't play it, since +they expect MPEG1 video and MP2 audio (.MPG doesn't have the +necessary fields to describe its video and audio streams, like .AVI +does). Or put MPEG1 video to an .AVI. For example ffmpeg can +create these files.

    + +

    Audio codecs and formats are basically the same terms.

    + + +

    2.1.1. Video formats

    + + +

    2.1.1.1. MPG, VOB, DAT files

    + +

    +

  • MPG : this is the most basic form of MPEG file formats. Contains +MPEG1 video, and MP2 audio.
  • +
  • VOB : this is the MPEG file format on DVDs. Contains optionally +encoded MPEG2 video, and usually AC3 audio.
    +Read the DVD section !
  • +
  • DAT : this is the MPEG file format on Video CDs. It's the same +as the MPG, but due to the nature VCDs are created and Linux is designed, +the DAT files can't be played nor copied from VCDs. You have to use the +-vcd option to play the VideoCD.
  • +

    + + +

    2.1.1.2. AVI files

    + +

    Designed by Micro$oft, the AVI (Audio Video Interleaved) is a +widespread multipurpose format, currently used mostly for DivX and DivX4 +videos. Has many known drawbacks, and inabilities (for example in streaming). +Has support for one video stream, and 99 audio streams. Can be as big as +2Gb. There exists an extension for it to be bigger, called OpenDMS. +M$ is currently strongly discourages its use and propagates ASF/WMV. Not if +anybody cares.
    +NOTE : DV cameras can create two types of AVI format, one is the usual and +playable, the other is neither.

    + + +

    2.1.1.3. ASF/WMV files

    + +

    ASF is a new very undocumented fileformat from M$, and WMV is its +successor. They are very commercial, and anyone who writes an opensource +parser for them, soon meets certain doom. While creating the parser, it +was obvious to see how bulky, shit, and unusable they are. Not if anybody +would expect something else from M$. + + +

    2.1.1.4. QT/MOV files

    + +

    They are Apple's formats. Not much to say, basically well designed, +multipurpose, streamable, many features etc. Kinda hard to find documentation, +but we think the parser is perfect. + +

    2.1.1.5. VIV files

    + +

    Hey this is new code in MPlayer, be gentle! Seeking is +currently nonexistent, audio too. TODO : complete this section.

    + + +

    2.1.2. Audio formats

    + +

    Currently MPlayer is still a Movie and not a Media +player, thus the pure audio formats (for example MP3, WAV, audio ASF) are +unplayable. Use xmms, mpg123 +or whatever.

    + + + diff -r 205deb33f8ee -r 62bcea66003e DOCS/sound.html --- a/DOCS/sound.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/sound.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,7 +3,7 @@ -

    2.2.2. Audio output devices

    +

    2.3.2. Audio output devices

    MPlayer's audio interface is called libao2. It currently contains these drivers :

    @@ -42,7 +42,7 @@

    On Solaris/FreeBSD systems, use the SUN audio driver with the -ao sun option, otherwise you'll have no video, nor audio playing.

    -

    2.2.2.1. Soundcard experiences, recommendations

    +

    2.3.2.1. Soundcard experiences, recommendations

    diff -r 205deb33f8ee -r 62bcea66003e DOCS/video.html --- a/DOCS/video.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/video.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,7 +3,7 @@ -

    2.2.1. Video output devices

    +

    2.3.1. Video output devices

    Aureal Vortex 2
    @@ -24,7 +24,7 @@   1.2.0: supports AAlib (-vo aa is very recommended, see below!) - + @@ -48,7 +48,7 @@

    NOTE: check the following subsections for details and requirements!

    -

    2.2.1.1. MTRR

    +

    2.3.1.1. Setting up MTRR

    It is VERY recommended to check if the MTRR registers are set up properly, because they can give a big performance boost.

    @@ -106,7 +106,7 @@ stepping 0] doesn't support MTRR, but stepping 12's do ('cat /proc/cpuinfo' to check it').

    -

    2.2.1.2. Xv

    +

    2.3.1.2. Xv

    Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines using the XVideo extension. This is what the option '-vo xv' uses. @@ -159,24 +159,24 @@

    -

    2.2.1.2.1. 3dfx cards

    +

    2.3.1.2.1. 3dfx cards

    Older 3dfx drivers were known to have problems with XVideo acceleration, it didn't support either YUY2 or YV12, and so. Verify that you have XFree86 version 4.1.0 or greater, it works ok. Alternatively, you can use DRI cvs. If you experience strange effects using -vo xv, try SDL (it has XVideo too) -and see if it helps. Check the SDL section for details.

    +and see if it helps. Check the SDL section for details.

    -

    OR, try the NEW -vo tdfxfb driver! See the 2.2.1.9 +

    OR, try the NEW -vo tdfxfb driver! See the 2.3.1.9 section!

    -

    2.2.1.2.2. S3 cards

    +

    2.3.1.2.2. S3 cards

    S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3 or greater (in case of image problems, try 16bpp). As for S3 Virge.. sell it.

    -

    2.2.1.2.3. nVidia cards

    +

    2.3.1.2.3. nVidia cards

    nVidia isn't a very good choice under Linux.. You'll have to use the binary nVidia driver, available at nVidia's website. The standard X @@ -187,7 +187,7 @@ Complain to NVidia.

    -

    2.2.1.2.4. ATI cards

    +

    2.3.1.2.4. ATI cards

  • The GATOS driver (which you should use) has VSYNC enabled by default. It means that decoding speed @@ -195,11 +195,11 @@ disabling VSYNC somehow, or set refresh rate to n*(fps of the movie) Hz.
  • Radeon VE - currently only XFree86 CVS has driver for this card, version -4.1.0 doesn't. No TV-out support. (But see VESA sections).
  • +4.1.0 doesn't. No TV-out support. (But see VESA sections).

    -

    2.2.1.2.5. NeoMagic cards

    +

    2.3.1.2.5. NeoMagic cards

    These cards can be found in many laptops. Under Linux, their peak is only DGA. @@ -211,15 +211,15 @@

    -

    2.2.1.3. DGA

    +

    2.3.1.3. DGA

    -

    2.2.1.3.1. Summary

    +

    2.3.1.3.1. Summary

    This document tries to explain in some words what DGA is in general and what the DGA video output driver for mplayer can do (and what it can't).

    -

    2.2.1.3.2. What is DGA

    +

    2.3.1.3.2. What is DGA

    DGA is short for Direct Graphics Access and is a means for a program to bypass the X-Server and directly modifying the framebuffer memory. @@ -246,7 +246,7 @@ driver that controls this chip. So it does not work on every system ...

    -

    2.2.1.3.3. Installing DGA support for MPlayer

    +

    2.3.1.3.3. Installing DGA support for MPlayer

    First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:

    @@ -282,7 +282,7 @@ You should also try if the '-vo sdl:dga' option works for you! It's much faster!!!

    -

    2.2.1.3.4. Resolution switching

    +

    2.3.1.3.4. Resolution switching

    The DGA driver allows for switching the resolution of the output signal. This avoids the need for doing (slow) software scaling and at the same @@ -297,14 +297,14 @@ /var/log/XFree86.0.log.

    See appendix A for some sample modeline definitions.

    -

    2.2.1.3.5. DGA & MPlayer

    +

    2.3.1.3.5. DGA & MPlayer

    DGA is used in two places with MPlayer: The SDL driver can be made to make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above said is true for both; in the following sections I'll explain how the DGA driver for MPlayer works.

    -

    2.2.1.3.6. Features of the DGA driver

    +

    2.3.1.3.6. Features of the DGA driver

    The DGA driver is invoked by specifying -vo dga at the command line. The default behaviour is to switch to a resolution matching the original @@ -343,7 +343,7 @@ CPU time!) depending on the implementation of DGA for your hardware.

    -

    2.2.1.3.7. Speed issues

    +

    2.3.1.3.7. Speed issues

    Generally spoken, DGA framebuffer access should be at least as fast as using the X11 driver with the additional benefit of getting a fullscreen image. @@ -366,7 +366,7 @@

    I've seen some avi files already be replayed on a Pentium MMX 266. AMD K6-2 CPUs might work at 400 MHZ and above.

    -

    2.2.1.3.8. Known bugs

    +

    2.3.1.3.8. Known bugs

    Well, according to some developpers of XFree, DGA is quite a beast. They tell you better not to use it. Its implementation is not always flawless @@ -387,13 +387,13 @@

  • OSD only works with doublebuffering enabled

    -

    2.2.1.3.9. Future work

    +

    2.3.1.3.9. Future work

    • use of the new X11 render interface for OSD
    • where is my TODO list ???? :-(((

    -

    2.2.1.3.A. Some modelines

    +

    2.3.1.3.A. Some modelines

       Section "Modes"
    @@ -412,7 +412,7 @@
     module.

    -

    2.2.1.3.B. Bug Reports

    +

    2.3.1.3.B. Bug Reports

    If you experience troubles with the DGA driver please feel free to file a bug report to me (e-mail address below). Please start mplayer with the @@ -426,7 +426,7 @@

    Acki (acki@acki-netz.de, www.acki-netz.de)

    -

    2.2.1.4. SDL

    +

    2.3.1.4. SDL

    Here are some notes about SDL out in MPlayer.

    @@ -454,7 +454,7 @@ It's bug in SDL, I can't change it (tested with SDL 1.2.1).

    -

    2.2.1.5. SVGAlib

    +

    2.3.1.5. SVGAlib

    If you don't have X, you can use the SVGAlib target! Be sure not to use the -fs switch, since it toggles the usage of the software scaler, and it's @@ -465,7 +465,7 @@ forced), and don't forget to edit /etc/vga/libvga.config to suit your card & monitor.

    -

    2.2.1.6. Framebuffer output (FBdev)

    +

    2.3.1.6. Framebuffer output (FBdev)

    Whether to build the FBdev target is autodetected during ./configure . Read the framebuffer documentation in the kernel sources @@ -508,7 +508,7 @@

    NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer, and don't ask for it, since it's not an MPlayer limitation.

    -

    2.2.1.7. Matrox framebuffer (mga_vid)

    +

    2.3.1.7. Matrox framebuffer (mga_vid)

    This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler) support, the mga_vid kernel driver. It's active developed by me (A'rpi), and @@ -550,7 +550,7 @@

    The mga_vid driver cooperates with Xv.

    -

    2.2.1.8. SiS 6326 framebuffer (sis_vid)

    +

    2.3.1.8. SiS 6326 framebuffer (sis_vid)

    SiS 6326 YUV Framebuffer driver -> sis_vid kernel driver

    @@ -558,13 +558,13 @@ updated after the mga_vid changes, so it's outdated now. Volunteers needed to test it and bring the code up-to-date.

    -

    2.2.1.9. 3dfx YUV support (tdfxfb)

    +

    2.3.1.9. 3dfx YUV support (tdfxfb)

    This driver uses the kernel's tdfx framebuffer driver to play movies with YUV acceleration. You'll need a kernel with tdfxfb support, and recompile with ./configure --enable-tdfxfb

    -

    2.2.1.10. OpenGL output

    +

    2.3.1.10. OpenGL output

    MPlayer support displaying movies using OpenGL. Unfortunately, not all drivers support this ability. For example the Utah-GLX drivers @@ -576,7 +576,7 @@ See http://dri.sourceforge.net for download, and installation instructions.

    -

    2.2.1.11. AAlib - text mode displaying

    +

    2.3.1.11. AAlib - text mode displaying

    AAlib is a library for displaying graphics in text mode, using powerful ASCII renderer. There are LOTS of programs already supporting it, like Doom, @@ -623,7 +623,7 @@ See http://aa-project.sourceforge.net/tune/ for further tuning issues.

    -

    2.2.1.12. VESA - output to VESA BIOS

    +

    2.3.1.12. VESA - output to VESA BIOS

    This driver was designed and introduced as generic driver for any video card which has VESA VBE 2.0 compatible BIOS. But exists still one reason of @@ -707,9 +707,9 @@

    -

    2.2.1.A. TV-out support

    +

    2.3.1.A. TV-out support

    -

    2.2.1.A.1. Matrox cards

    +

    2.3.1.A.1. Matrox cards

    Under Linux you have 2 methods to get TV out working :

    @@ -776,7 +776,7 @@

    -

    2.2.1.A.2. ATI cards

    +

    2.3.1.A.2. ATI cards

    A few word about ATI's TV-out:
    @@ -821,7 +821,7 @@

    Fortunately, owners of fast enough CPUs (Duron, Celeron2 and better) can watch -movies on their TV through VESA drivers. +movies on their TV through VESA drivers.

    @@ -842,12 +842,12 @@

    -For detail see VESA sections of this +For detail see VESA sections of this documentation.

    -

    2.2.1.A.3. Voodoo 3

    +

    2.3.1.A.3. Voodoo 3

    Check this URL.

  • ggisimilar to SDL
    aatextmode rendering with AAlib
    vesaOutput to VESA BIOS.
    vesaOutput to VESA BIOS.

    Card specific: