Mercurial > mplayer.hg
diff DOCS/codecs.html @ 1682:dba45a1aafad
*** empty log message ***
| author | gabucino |
|---|---|
| date | Fri, 24 Aug 2001 18:48:13 +0000 |
| parents | a5cb1b1d47a8 |
| children | 390bbb52e371 |
line wrap: on
line diff
--- a/DOCS/codecs.html Fri Aug 24 16:28:26 2001 +0000 +++ b/DOCS/codecs.html Fri Aug 24 18:48:13 2001 +0000 @@ -1,228 +1,218 @@ <HTML> - <BODY> -<PRE> - - <A NAME=2.1>2.1. Video Formats, Audio & Video Codecs</A> - - - <A NAME=2.1.1>2.1.1. Supported input formats</A> +<P><B><A NAME=2.1>2.1. Video Formats, Audio & Video Codecs</A></B></P> - <B>MPlayer</B> 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 optional libcss for decryption - - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file - formats - - RIFF AVI file format - - ASF 1.0 file format - - supports reading from file, stdin, DVD drive or network via HTTP - - Note: about quicktime (.mov/.qt) and realmedia (.ra/.rm) support read the FAQ! - - - <A NAME=2.1.2>2.1.2. Supported audio & video codecs</A> +<P><B><A NAME=2.1.1>2.1.1. Supported input formats</A></B></P> - See http://mplayerhq.hu/MPlayer/DOCS/codecs.html for the complete, - daily updated list!!! - - The most important video codecs: - - MPEG1 (VCD) and MPEG2 (DVD) video - - DivX, FFmpeg, OpenDivX and other MPEG4 variants - - Windows Media Video 7 (WMV1) and Windows Media Video 8 used in .wmv files - - Intel Indeo codecs (3.1,3.2,4.1,5.0) - - MJPEG, ASV2 and other hardware formats +<P><B>MPlayer</B> can read/play from the following devices/formats:<BR> +<UL> +<LI> VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file +<LI> DVD, directly from your DVD disk, using optional libcss for decryption +<LI> MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file + formats +<LI> RIFF AVI file format +<LI> ASF 1.0 file format +<LI> supports reading from file, stdin, DVD drive or network via HTTP +</UL></P> - The most important audio codecs: - - MPEG layer 2, and layer 3 (MP3) audio (native code, with 3dnow optimization) - - AC3 dolby audio (native code, with 3dnow optimization) - - AC3 passthrough to soundcard's decoder - - Voxware audio - - alaw, msgsm, pcm and other simple old audio formats - - If you have a codec not listed here, and not supported yet, just - read http://mplayerhq.hu/MPlayer/DOCS/codecs.html - to get info about its status and about how to help us adding support for it! +<P>Note: about quicktime (.mov/.qt) and realmedia (.ra/.rm) support read the FAQ!</P> - <A NAME=2.1.2.1>2.1.2.1. DivX4</A> +<P><B><A NAME=2.1.2>2.1.2. Supported audio & video codecs</A></B></P> - This section contains information about the DivX4 codec of - <A HREF="http://www.projectmayo.com">ProjectMayo</A>. Their first available alpha version was the OpenDivX 4.0 - alpha 47 and 48. Support for this was/is included in <B>MPlayer</B>, and built by - default. We even used its postprocessing code to optionally enhance visual - quality of MPEG1/2 movies. - - The new generation of this codec can even decode movies made with the - infamous DivX codec! And it's not everything, it's MUCH faster than the - traditional Win32 DivX DLL's. See below for configuration. The only - disadvantage of this codec is that it's currently closed-source. :( +<P>See http://mplayer.sourceforge.net/DOCS/codecs.html for the complete, +daily updated list!!!</P> - The codec can be downloaded from the following URL: - - - http://download2.projectmayo.com/dnload/divx4linux/divx4linux-20010718.zip - +<P>The most important video codecs:<BR> +<UL> +<LI>MPEG1 (VCD) and MPEG2 (DVD) video +<LI>DivX, FFmpeg, OpenDivX and other MPEG4 variants +<LI>Windows Media Video 7 (WMV1) and Windows Media Video 8 used in .wmv files +<LI>Intel Indeo codecs (3.1,3.2,4.1,5.0) +<LI>MJPEG, ASV2 and other hardware formats +</UL></P> - No automatic installing available at this time, so install it manually, - EXACTLY as described here. Unpack it, and copy files to their place: - +<P>The most important audio codecs:<BR> +<UL> +<LI>MPEG layer 2, and layer 3 (MP3) audio (native code, with 3dnow optimization) +<LI>AC3 dolby audio (native code, with 3dnow optimization) +<LI>Voxware audio +<LI>alaw, msgsm, pcm and other simple old audio formats +</UL></P> - cp libdivxdecore.so.0.0.0 /usr/local/lib/ - ln -s /usr/local/lib/libdivxdecore.so.0.0.0 /usr/local/lib/libdivxdecore.so.0 - ln -s /usr/local/lib/libdivxdecore.so.0 /usr/local/lib/libdivxdecore.so - ldconfig - cp decore.h /usr/local/include/ +<P>If you have a codec not listed here, and not supported yet, just +read http://mplayer.sourceforge.net/DOCS/codecs.html +to get info about its status and about how to help us adding support for it!</P> - <B>MPlayer</B> autodetects if DivX4 is (properly) installed, just compile - as usual. If it doesn't detect it, you didn't install it exactly as above, - and/or has fucked up config (see last question of 5.1 section). - - Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is - very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX - driver calls this library too. +<P><B><A NAME=2.1.2.1>2.1.2.1. DivX4</A></B></P> - Generally we can pinpoint this issue to that you have two options to use - this codec: - +<P>This section contains information about the DivX4 codec of +<A HREF="http://www.projectmayo.com">ProjectMayo</A>. Their first available alpha version was the OpenDivX 4.0 +alpha 47 and 48. Support for this was/is included in <B>MPlayer</B>, and built by +default. We even used its postprocessing code to optionally enhance visual +quality of MPEG1/2 movies.</P> - -vc odivx : using divx4 codec as a new version of OpenDivX. - in this case it produces YV12 image in its own buffer, - and <B>MPlayer</B> (libvo) does colorspace conversion. +<P>The new generation of this codec can even decode movies made with the +infamous DivX codec! And it's not everything, it's MUCH faster than the +traditional Win32 DivX DLL's. See below for configuration. The only +disadvantage of this codec is that it's currently closed-source. :(</P> - -vc divx4 : using divx4 codec's colorspace conversion. - in this mode, you can use YUY2/UYVY too. +<P>The codec can be downloaded from the following URL:</P> + +<P> <CODE>http://download2.projectmayo.com/dnload/divx4linux/divx4linux-20010718.zip</CODE></P> - The 'odivx' method is usually faster, due to the fact that it transfers - image data in YV12 (planar YUV 4:2:0) format, thus requiring much less - bandwidth on the bus. For packed YUV modes (YUY2, UYVY) use the 'divx4' - method. For RGB modes you can choose freely, their speed is same, maybe - differ according to the current bpp. +<P>No automatic installing available at this time, so install it manually, +EXACTLY as described here. Unpack it, and copy files to their place:</P> - Note: it supports postprocessing too, but range of values is strange: - - 0 no postproc - 10 .. 20 postprocessing, normal - (like level 2 with divxds) - 30 .. 60 hard postprocessing, eats many CPU. - (like level 4 with divxds) +<P><CODE>cp libdivxdecore.so.0.0.0 /usr/local/lib/<BR> +ln -s /usr/local/lib/libdivxdecore.so.0.0.0 /usr/local/lib/libdivxdecore.so.0<BR> +ln -s /usr/local/lib/libdivxdecore.so.0 /usr/local/lib/libdivxdecore.so<BR> +ldconfig<BR> +cp decore.h /usr/local/include/</CODE></P> - <A NAME=2.1.2.2>2.1.2.2. ffmpeg's DivX/libavcodec</A> +<P><B>MPlayer</B> autodetects if DivX4 is (properly) installed, just compile +as usual. If it doesn't detect it, you didn't install it exactly as above, +and/or has fucked up config (see last question of 5.1 section).</P> + +<P>Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is +very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX +driver calls this library too.</P> + +<P>Generally we can pinpoint this issue to that you have two options to use +this codec:</P> + +<P><TABLE BORDER=0> +<TD> </TD><TD VALIGN=top>-vc odivx</TD><TD> </TD> +<TD>using divx4 codec as a new version of OpenDivX. +in this case it produces YV12 image in its own buffer, +and <B>MPlayer</B> (libvo) does colorspace conversion.</TD><TR> +<TD></TD><TD VALIGN=top>-vc divx4</TD><TD></TD> +<TD>using divx4 codec's colorspace conversion. +in this mode, you can use YUY2/UYVY too.</TD><TR> +</TABLE></P> - Beginning with version 0.4.2 , <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> contains an <B>opensource</B> DivX codec, - which is compatible with the traditional DivX. <B>MPlayer</B> supports this codec, - and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B> - It was removed from <B>MPlayer</B>'s cvs tree, you have to download it - manually directly from <B>FFmpeg</B>'s tree : +<P>The 'odivx' method is usually faster, due to the fact that it transfers +image data in YV12 (planar YUV 4:2:0) format, thus requiring much less +bandwidth on the bus. For packed YUV modes (YUY2, UYVY) use the 'divx4' +method. For RGB modes you can choose freely, their speed is same, maybe +differ according to the current bpp.</P> + +<P>Note: it supports postprocessing too, but range of values is strange:</P> +<P><TABLE BORDER=0> +<TD> </TD><TD>0</TD><TD> </TD> +<TD>no postproc</TD><TR> +<TD></TD><TD>10 .. 20</TD> +<TD></TD><TD>postprocessing, normal (like level 2 with divxds)</TD><TR> +<TD></TD><TD>30 .. 60</TD> +<TD></TD><TD>hard prostprocessing, eats many CPU (like level 4 with divxds</TD><TR> +</TABLE></P> +<P><B><A NAME=2.1.2.2>2.1.2.2. ffmpeg's DivX/libavcodec</A></B></P> + +<P>Beginning with version 0.4.2 , <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> contains an <B>opensource</B> DivX codec, +which is compatible with the traditional DivX. <B>MPlayer</B> supports this codec, +and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B> +It was removed from <B>MPlayer</B>'s cvs tree, you have to download it +manually directly from <B>FFmpeg</B>'s tree:</P> + +<P><CODE> cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg - - - Note: if you copy with CVS subdirs, next time it's enough to do - 'cvs update'. +</CODE></P> - Now, move the newly downloaded ffmpeg source's <B>libavcodec</B> directory, - (with all it's subdirectories) to <B>MPlayer</B>'s tree, so it will look - like this : - +<P>Note: <I>if you copy with CVS subdirs, next time it's enough to do +'cvs update'.</I></P> - main/libavcodec - - - Symlinking is NOT enough, you have to copy it. +<P>Now, move the newly downloaded ffmpeg source's <B>libavcodec</B> directory, +(with all it's subdirectories) to <B>MPlayer</B>'s tree, so it will look +like this:</P> - ./configure detects if it can be built. At the moment it doesn't support - postprocessing, and is under optimization (it's faster than the DS/VfW DivX - codec). - - In order to use it, refresh your codecs.conf file, and do as the manpage, - or the example.conf says (the -vfm option). +<P> <CODE>main/libavcodec</CODE></P> - Note: libavcodec contains other codecs as well, but at the moment we mostly - focus on ffdivx, and it's unlikely that this will change. - - - <A NAME=2.1.2.3>2.1.2.3. Hardware AC3 decoding</A> +<P>Symlinking is NOT enough, you have to copy it.</P> - You will need a soundcard with AC3 passthrough capability to digital out - (SP/DIF). Also, the its driver has to support AFMT_AC3 (SB Live! for example) - Connect the hardware AC3 decoder to your soundcard's SP/DIF, and use - -ac hwac3 . It may work. - +<P>./configure detects if it can be built. At the moment it doesn't support +postprocessing, and is under optimization (it's faster than the DS/VfW DivX +codec).</P> - <A NAME=2.1.4>2.1.4. Codec importing howto</A> - - - <A NAME=2.1.4.1>2.1.4.1. VFW codecs</A> +<P>In order to use it, refresh your codecs.conf file, and do as the manpage, +or the example.conf says (the -vfm option).</P> - VfW (Video for Windows) is the old Video API for Windows. Its codecs have - the .DLL or (rarely) .DRV extension. - If <B>MPlayer</B> fails with your AVI: - - - UNKNOWN video codec: HFYU (0x55594648) +<P>Note: libavcodec contains other codecs as well, but at the moment we mostly +focus on ffdivx, and it's unlikely that this will change.</P> - It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = - HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that we know this, we'll - have to find out which DLL Windows loads in order to play this file. In our - case, the system.ini contains this (with many others): +<P><B><A NAME=2.1.4>2.1.4. Codec importing howto</A></B></P> + +<P><B><A NAME=2.1.4.1>2.1.4.1. VFW codecs</A></B></P> + +<P>VfW (Video for Windows) is the old Video API for Windows. Its codecs have +the .DLL or (rarely) .DRV extension. +If <B>MPlayer</B> fails with your AVI:</P> + +<P> <CODE>UNKNOWN video codec: HFYU (0x55594648)</CODE></P> +<P>It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = +HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that we know this, we'll +have to find out which DLL Windows loads in order to play this file. In our +case, the system.ini contains this (with many others):</P> - VIDC.HFYU=huffyuv.dll +<P> <CODE>VIDC.HFYU=huffyuv.dll</CODE></P> + +<P>So we'll need the huffyuv.dll file. Note that the audio codecs are specified +with the MSACM prefix:</P> + +<P> <CODE>msacm.l3acm=L3codeca.acm</CODE></P> - So we'll need the huffyuv.dll file. Note that the audio codecs are specified - with the MSACM prefix : - - - msacm.l3acm=L3codeca.acm +<P>This is the MP3 codec. +So, now we have all the info needed (fourcc, codec file, sample AVI), submit +your codec support request in mail, and upload these files to the FTP:</P> - - This is the MP3 codec. - So, now we have all the info needed (fourcc, codec file, sample AVI), submit - your codec support request in mail, and upload these files to the FTP: - ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/ +<P> <CODE>ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/</CODE></P> - <A NAME=2.1.4.2>2.1.4.2. DirectShow codecs</A> +<P><B><A NAME=2.1.4.2>2.1.4.2. DirectShow codecs</A></B></P> - DirectShow is the newer Video API, which is even worse than its predecessor. - Things are harder with DirectShow, since - - system.ini doesn't contain the needed information, instead it's stored in - the registry :( - - we'll need the GUID of the codec. +<P>DirectShow is the newer Video API, which is even worse than its predecessor. +Things are harder with DirectShow, since +<UL> +<LI>system.ini doesn't contain the needed information, instead it's stored in +the registry :( +<LI>we'll need the GUID of the codec. +</UL></P> - So let's search that goddamn registry.. - - Start 'regedit' - - press ctrl-f, disable the first two checkbox, and enable the third. Type - the fourcc of the codec. (for ex.: TM20) - - you should see a field which contains the path and filename - (for ex. : C:\WINDOWS\SYSTEM\TM20DEC.AX) - - now that we have the file, we'll need the GUID. Try searching again, but - now we'll search for the codec's name, not the fourcc. Its name can be acquired - when Media Player is playing that file, by checking File/Properties/Advanced. - If not, bad luck ;) Try guessing. - (for ex. search for : TrueMotion) - - if found (in registry), there should be a FriendlyName field, and a CLSID - field. Write down that 16 byte of CLSID, this is the GUID required by us. +<P>So let's search that goddamn registry.. +<UL> +<LI>Start 'regedit' +<LI>press ctrl-f, disable the first two checkbox, and enable the third. Type +the fourcc of the codec. (for ex.: TM20) +<LI>you should see a field which contains the path and filename +(for ex. : C:\WINDOWS\SYSTEM\TM20DEC.AX) +<LI>now that we have the file, we'll need the GUID. Try searching again, but +now we'll search for the codec's name, not the fourcc. Its name can be acquired +when Media Player is playing that file, by checking File/Properties/Advanced. +If not, bad luck ;) Try guessing. +(for ex. search for : TrueMotion) +<LI>if found (in registry), there should be a FriendlyName field, and a CLSID +field. Write down that 16 byte of CLSID, this is the GUID required by us. +</UL></P> + +<P>NOTE: if searching fails, try to enable all the checkboxes.. you may have +false hits, but maybe you'll have the right, too...</P> +<P>NOTE: dump that M$ shit.</P> - NOTE : if searching fails, try to enable all the checkboxes.. you may have - false hits, but maybe you'll have the right, too... - NOTE : dump that M$ shit. - +<P>So, now we have all the info needed (fourcc, GUID, codec file, sample AVI), +submit your codec support request in mail, and upload these files to the FTP:<BR> +ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/</P> - So, now we have all the info needed (fourcc, GUID, codec file, sample AVI), - submit your codec support request in mail, and upload these files to the FTP: - ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/ - -</PRE> +<BR> +<HR>MPlayer documentation project </BODY> - </HTML>