Author: diego Date: Sat Dec 27 15:38:42 2008 New Revision: 28203 Log: Convert Win32 codec importing HOWTO into a text document in the tech section. Modified: trunk/DOCS/xml/en/codecs.xml trunk/DOCS/xml/en/faq.xml Changes in other areas also in this revision: Added: trunk/DOCS/tech/win32-codec-howto.txt Modified: trunk/DOCS/xml/en/codecs.xml ============================================================================== --- trunk/DOCS/xml/en/codecs.xml Sat Dec 27 14:58:20 2008 (r28202) +++ trunk/DOCS/xml/en/codecs.xml Sat Dec 27 15:38:42 2008 (r28203) @@ -12,8 +12,8 @@ of our homepage. </para> <para> -If you have a Win32 codec which is not supported yet, -please read the <link linkend="codec-importing">codec importing HOWTO</link> +If you have a Win32 codec which is not supported yet, please read the +<ulink url="../../tech/win32-codec-howto">Win32 codec HOWTO</ulink> and help us add support for it. </para> @@ -96,161 +96,4 @@ only white noise). </sect1> - -<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> - - -<sect1 id="codec-importing"> -<title>Win32 codecs importing HOWTO</title> - -<!-- TODO: a short paragraph of text would be nice here... --> - -<sect2 id="vfw-codecs"> -<title>VFW codecs</title> - -<para> -VFW (Video for Windows) is the old Video API for Windows. Its codecs have -the <filename>.DLL</filename> or (rarely) <filename>.DRV</filename> -extension. If <application>MPlayer</application> fails at playing your AVI -with this kind of message: -<screen>UNKNOWN video codec: HFYU (0x55594648)</screen> -It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = -HuffYUV codec, DIV3 = DivX Low Motion, etc.). Now that you know this, you -have to find out which DLL Windows loads in order to play this file. In our -case, the <filename>system.ini</filename> contains this information in a -line that reads: -<programlisting>VIDC.HFYU=huffyuv.dll</programlisting> -</para> - -<para> -So you need the <filename>huffyuv.dll</filename> file. Note that the audio -codecs are specified by the MSACM prefix: -<programlisting>msacm.l3acm=L3codeca.acm</programlisting> -</para> - -<para> -This is the MP3 codec. Now that you have all the necessary information -(fourcc, codec file, sample AVI), submit your codec support request by -mail, and upload these files to the FTP site: -<systemitem role="url">ftp://upload.mplayerhq.hu/MPlayer/incoming/<replaceable><codecname></replaceable>/</systemitem> -</para> - -<note><para> -On Windows NT/2000/XP search for this info in the registry, -e.g. search for "VIDC.HFYU". To find out how to do this, look at -the old DirectShow method below. -</para></note> -</sect2> - -<!-- ********** --> - -<sect2 id="dshow-codecs"> -<title>DirectShow codecs</title> - -<para> -DirectShow is the newer Video API, which is even worse than its predecessor. -Things are harder with DirectShow, since -<itemizedlist> -<listitem><para> - <filename>system.ini</filename> does not contain the needed information, - instead it is stored in the registry and -</para></listitem> -<listitem><para> - we need the GUID of the codec. -</para></listitem> -</itemizedlist> -</para> - -<procedure> -<title>New Method:</title> -<para> -Using <application>Microsoft GraphEdit</application> (fast) -</para> -<step><para> - Get <application>GraphEdit</application> from either DirectX SDK or - <ulink url="http://doom9.net">doom9</ulink>. -</para></step> -<step><para> - Start <command>graphedit.exe</command>. -</para></step> -<step><para> - From the menu select - <menuchoice><guimenu>Graph</guimenu> - <guisubmenu>Insert Filters</guisubmenu></menuchoice>. -</para></step> -<step><para> - Expand item <systemitem>DirectShow Filters</systemitem>. -</para></step> -<step><para> - Select the right codec name and expand item. -</para></step> -<step><para> - In the entry <systemitem>DisplayName</systemitem> look at the text in - winged brackets after the backslash and write it down (five dash-delimited - blocks, the GUID). -</para></step> -<step><para> - The codec binary is the file specified in the - <systemitem>Filename</systemitem> entry. -</para></step> -</procedure> - -<note><para> -If there is no <systemitem>Filename</systemitem> and -<systemitem>DisplayName</systemitem> contains something like -<systemitem>device:dmo</systemitem>, then it is a DMO-Codec. -</para></note> - -<procedure> -<title>Old Method:</title> -<para> -Take a deep breath and start searching the registry... -</para> -<step><para> - Start <command>regedit</command>. -</para></step> -<step><para> - Press <keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>, disable - the first two checkboxes, and enable the third. Type in the fourcc of the - codec (e.g. <userinput>TM20</userinput>). -</para></step> -<step><para> - You should see a field which contains the path and the filename (e.g. - <filename>C:\WINDOWS\SYSTEM\TM20DEC.AX</filename>). -</para></step> -<step><para> - Now that you have the file, we need the GUID. Try searching again, but - now search for the codec's name, not the fourcc. Its name can be acquired - when Media Player is playing the file, by checking - <menuchoice><guimenu>File</guimenu> <guisubmenu>Properties</guisubmenu> - <guimenuitem>Advanced</guimenuitem></menuchoice>. - If not, you are out of luck. Try guessing (e.g. search for TrueMotion). -</para></step> -<step><para> - If the GUID is found you should see a <guilabel>FriendlyName</guilabel> - and a <guilabel>CLSID</guilabel> field. Write down the 16 byte CLSID, - this is the GUID we need. -</para></step> -</procedure> - -<note><para> -If searching fails, try enabling all the checkboxes. You may have -false hits, but you may get lucky... -</para></note> - -<para> -Now that you have all the necessary information (fourcc, GUID, codec file, -sample AVI), submit your codec support request by mail, and upload these files -to the FTP site: -<systemitem role="url">ftp://upload.mplayerhq.hu/MPlayer/incoming/<replaceable><codecname></replaceable>/</systemitem> -</para> - -<para> -If you want to add a codec yourself, read -<ulink url="http://www.mplayerhq.hu/MPlayer/DOCS/tech/codecs.conf.txt">DOCS/tech/codecs.conf.txt</ulink>. -</para> - -</sect2> -</sect1> - </chapter> Modified: trunk/DOCS/xml/en/faq.xml ============================================================================== --- trunk/DOCS/xml/en/faq.xml Sat Dec 27 14:58:20 2008 (r28202) +++ trunk/DOCS/xml/en/faq.xml Sat Dec 27 15:38:42 2008 (r28203) @@ -236,7 +236,8 @@ I have problems playing files with the . Check the <ulink url="../../codecs-status.html">codec status</ulink>, if it doesn't contain your codec, read the <link linkend="codecs">codec documentation</link>, especially the -<link linkend="codec-importing">codec importing HOWTO</link> and contact us. +<ulink url="../../tech/win32-codec-howto">Win32 codec HOWTO</ulink> +and contact us. </para></answer> </qandaentry>