DOCS/xml/en/codecs.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!-- $Revision$ -->
   3 <chapter id="codecs">
   4 <title>Codecs</title>
   5
   6 <sect1 id="video-codecs">
   7 <title>Video codecs</title>
   8
   9 <para>
  10 The <ulink url="../../codecs-status.html">codec status table</ulink> is a
  11 complete list of all supported codecs, regenerated daily.
  12 Some binary codecs for use with MPlayer are available in the
  13 <ulink url="http://www.mplayerhq.hu/design7/dload.html#binary_codecs">download section</ulink>
  14 of our homepage.
  15 </para>
  16
  17 <para>
  18 The most important ones above all:
  19 </para>
  20
  21 <itemizedlist>
  22 <listitem><para>
  23   <emphasis role="bold">MPEG-1</emphasis> (<emphasis role="bold">VCD</emphasis>) and
  24   <emphasis role="bold">MPEG-2</emphasis> (<emphasis role="bold">DVD</emphasis>) video
  25 </para></listitem>
  26 <listitem><para>
  27   native decoders for <emphasis role="bold">all DivX variants,
  28   3ivX, Microsoft MPEG-4</emphasis> v1, v2 and other MPEG-4 variants
  29 </para></listitem>
  30 <listitem><para>
  31   native decoder for <emphasis role="bold">Windows Media Video 7/8</emphasis>
  32   (<emphasis role="bold">WMV1/WMV2</emphasis>), and Win32 DLL decoder
  33   for <emphasis role="bold">Windows Media Video 9</emphasis>
  34   (<emphasis role="bold">WMV3</emphasis>),
  35   both used in <filename>.wmv</filename> files
  36 </para></listitem>
  37 <listitem><para>
  38   native <emphasis role="bold">Sorenson 1 (SVQ1)</emphasis> decoder
  39 </para></listitem>
  40 <listitem><para>
  41   native <emphasis role="bold">Sorenson 3 (SVQ3)</emphasis> decoder
  42 </para></listitem>
  43 <listitem><para>
  44   <emphasis role="bold">3ivx</emphasis> v1, v2 decoder
  45 </para></listitem>
  46 <listitem><para>
  47   Cinepak and <emphasis role="bold">Intel Indeo</emphasis> codecs
  48   (3.1,3.2,4.1,5.0)
  49 </para></listitem>
  50 <listitem><para>
  51   <emphasis role="bold">MJPEG</emphasis>, AVID, VCR2, ASV2 and other hardware
  52   formats
  53 </para></listitem>
  54 <listitem><para>
  55   VIVO 1.0, 2.0, I263 and other <emphasis role="bold">H.263(+)</emphasis>
  56   variants
  57 </para></listitem>
  58 <listitem><para>
  59   FLI/FLC
  60 </para></listitem>
  61 <listitem><para>
  62   <emphasis role="bold">RealVideo 1.0 &amp; 2.0</emphasis> from
  63   <systemitem class="library">libavcodec</systemitem>, and
  64   <emphasis role="bold">RealVideo 3.0 &amp; 4.0</emphasis> codecs using
  65   RealPlayer libraries
  66 </para></listitem>
  67 <listitem><para>
  68   native decoder for HuffYUV
  69 </para></listitem>
  70 <listitem><para>
  71   Various old simple RLE-like formats
  72 </para></listitem>
  73 </itemizedlist>
  74
  75 <para>
  76 If you have a Win32 codec not listed here which is not supported yet,
  77 please read the <link linkend="codec-importing">codec importing HOWTO</link>
  78 and help us add support for it.
  79 </para>
  80
  81 <!-- ********** -->
  82
  83 <sect2 id="ffmpeg" xreflabel="FFmpeg/libavcodec">
  84 <title>FFmpeg/libavcodec</title>
  85
  86 <para>
  87 <ulink url="http://ffmpeg.org">FFmpeg</ulink> contains
  88 <systemitem class="library">libavcodec</systemitem>, the leading
  89 open source video and audio codec library. It is capable
  90 of decoding most multimedia formats, usually at higher speeds
  91 than the alternatives, and aims to add support for
  92 the rest of them eventually. It is the default decoder for
  93 the majority of codecs that <application>MPlayer</application>
  94 supports. Encoding is also possible for some formats and
  95 supported in <application>MEncoder</application>.
  96 </para>
  97
  98 <para>
  99 For a complete list of supported
 100 <ulink url="http://ffmpeg.org/ffmpeg-doc.html#SEC19">video</ulink>
 101 and <ulink url="http://ffmpeg.org/ffmpeg-doc.html#SEC20">audio</ulink>
 102 codecs please visit the FFmpeg homepage.
 103 </para>
 104
 105 <para>
 106 <application>MPlayer</application> contains
 107 <systemitem class="library">libavcodec</systemitem>.
 108 Just run <filename>./configure</filename> and compile.
 109 </para>
 110 </sect2>
 111
 112 <!-- ********** -->
 113
 114 <sect2 id="xvid">
 115 <title>Xvid</title>
 116
 117 <para>
 118 <ulink url="http://www.xvid.org">Xvid</ulink> is a free software MPEG-4 ASP
 119 compliant video codec, which features two pass encoding and full MPEG-4 ASP
 120 support, making it a lot more efficient than the well-known DivX codec.
 121 It yields very good video quality and good performance due to CPU
 122 optimizations for most modern processors.
 123 </para>
 124
 125 <para>
 126 It began as a forked development of the OpenDivX codec.
 127 This happened when ProjectMayo changed OpenDivX to closed source
 128 DivX4, and the non-ProjectMayo people working on OpenDivX got angry,
 129 then started Xvid. So both projects have the same origin.
 130 </para>
 131
 132 <para>
 133 Note that Xvid is not necessary to decode Xvid-encoded video.
 134 <systemitem class="library">libavcodec</systemitem> is used by
 135 default as it offers better speed.
 136 </para>
 137
 138 <procedure>
 139 <title>Installing <systemitem class="library">Xvid</systemitem></title>
 140 <para>
 141   Like most open source software, it is available in two flavors:
 142   <ulink url="http://www.xvid.org/downloads.html">official releases</ulink>
 143   and the CVS version.
 144   The CVS version is usually stable enough to use, as most of the time it
 145   features fixes for bugs that exist in releases.
 146   Here is what to do to make <systemitem class="library">Xvid</systemitem>
 147   CVS work with <application>MEncoder</application> (you need at least
 148   <application>autoconf</application> 2.50,
 149   <application>automake</application> and <application>libtool</application>):
 150 </para>
 151 <step><para>
 152   <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen>
 153 </para></step>
 154 <step><para>
 155   <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen>
 156 </para></step>
 157 <step><para>
 158   <screen>cd xvidcore/build/generic</screen>
 159 </para></step>
 160 <step><para>
 161   <screen>./bootstrap.sh</screen>
 162 </para></step>
 163 <step><para>
 164   <screen>./configure</screen>
 165   You may have to add some options (examine the output of
 166   <command>./configure --help</command>).
 167 </para></step>
 168 <step><para>
 169   <screen>make &amp;&amp; make install</screen>
 170 </para></step>
 171 <step><para>
 172   If you specified <option>--enable-divxcompat</option>,
 173   copy <filename>../../src/divx4.h</filename> to
 174   <filename class="directory">/usr/local/include/</filename>.
 175 </para></step>
 176 <step><para>
 177   Recompile <application>MPlayer</application> with
 178   <option>--with-xvidlibdir=<replaceable>/path/to/</replaceable>libxvidcore.a</option>
 179   <option>--with-xvidincdir=<replaceable>/path/to/</replaceable>xvid.h</option>.
 180 </para></step>
 181 </procedure>
 182 </sect2>
 183
 184 <!-- ********** -->
 185
 186 <sect2 id="codec-x264">
 187 <title><systemitem class="library">x264</systemitem></title>
 188
 189 <sect3 id="codec-x264-whatis">
 190 <title>What is <systemitem class="library">x264</systemitem>?</title>
 191
 192 <para>
 193 <ulink url="http://developers.videolan.org/x264.html"><systemitem class="library">x264</systemitem></ulink>
 194 is a library for creating H.264 video streams.
 195 It is not 100% complete, but supports most of H.264's features which impact
 196 quality.
 197 There are also many advanced features in the H.264 specification
 198 which have nothing to do with video quality per se; many of these
 199 are not yet implemented in <systemitem class="library">x264</systemitem>.
 200 </para>
 201
 202 <itemizedlist>
 203 <title>Encoder features</title>
 204   <listitem><para>CAVLC/CABAC</para></listitem>
 205   <listitem><para>Multi-references</para></listitem>
 206   <listitem><para>
 207   Intra: all macroblock types (16x16, 8x8, and 4x4 with all predictions)
 208   </para></listitem>
 209   <listitem><para>
 210   Inter P: all partitions (from 16x16 down to 4x4)
 211   </para></listitem>
 212   <listitem><para>
 213   Inter B: partitions from 16x16 down to 8x8 (including SKIP/DIRECT)
 214   </para></listitem>
 215   <listitem><para>
 216   Ratecontrol: constant quantizer, constant bitrate, single or multipass ABR,
 217   optional VBV
 218   </para></listitem>
 219   <listitem><para>Scene cut detection</para></listitem>
 220   <listitem><para>Adaptive B-frame placement</para></listitem>
 221   <listitem><para>
 222   B-frames as references / arbitrary frame order
 223   </para></listitem>
 224   <listitem><para>8x8 and 4x4 adaptive spatial transform</para></listitem>
 225   <listitem><para>Lossless mode</para></listitem>
 226   <listitem><para>Custom quantization matrices</para></listitem>
 227   <listitem><para>Parallel encoding of multiple slices</para></listitem>
 228   <listitem><para>Interlacing</para></listitem>
 229 </itemizedlist>
 230 </sect3>
 231
 232
 233 <sect3 id="codec-h264-whatis">
 234 <title>What is H.264?</title>
 235
 236 <para>
 237 H.264 is one name for a new digital video codec jointly developed
 238 by the ITU and MPEG.
 239 It can also be correctly referred to by the cumbersome names of
 240 "ISO/IEC 14496-10" or "MPEG-4 Part 10".
 241 More frequently, it is referred to as "MPEG-4 AVC" or just "AVC".
 242 </para>
 243
 244 <para>
 245 Whatever you call it, H.264 may be worth trying because it can typically match
 246 the quality of MPEG-4 ASP with 5%-30% less bitrate.
 247 Actual results will depend on both the source material and the encoder.
 248 The gains from using H.264 do not come for free: Decoding H.264
 249 streams seems to have steep CPU and memory requirements.
 250 For instance, on a 1733 MHz Athlon, a DVD-resolution 1500kbps H.264
 251 video requires around 35% CPU to decode.
 252 By comparison, decoding a DVD-resolution 1500kbps MPEG-4 ASP stream
 253 requires around 10% CPU.
 254 This means that decoding high-definition streams is almost out of
 255 the question for most users.
 256 It also means that even a decent DVD rip may sometimes stutter on
 257 processors slower than 2.0 GHz or so.
 258 </para>
 259
 260 <para>
 261 At least with <systemitem class="library">x264</systemitem>,
 262 encoding requirements are not much worse than what you are used to
 263 with MPEG-4 ASP.
 264 For instance, on a 1733 MHz Athlon a typical DVD encode would run
 265 at 5-15fps.
 266 </para>
 267
 268 <para>
 269 This document is not intended to explain the details of H.264,
 270 but if you are interested in a brief overview, you may want to read
 271 <ulink url="http://www.cdt.luth.se/~peppar/kurs/smd151/spie04-h264OverviewPaper.pdf">The H.264/AVC Advanced Video Coding Standard: Overview and Introduction to the Fidelity Range Extensions</ulink>.
 272 </para>
 273 </sect3>
 274
 275
 276 <sect3 id="codec-x264-playback">
 277 <title>How can I play H.264 videos with
 278   <application>MPlayer</application>?</title>
 279
 280 <para>
 281 <application>MPlayer</application> uses
 282 <systemitem class="library">libavcodec</systemitem>'s H.264 decoder.
 283 <systemitem class="library">libavcodec</systemitem> has had at
 284 least minimally usable H.264 decoding since around July 2004,
 285 however major changes and improvements have been implemented since
 286 that time, both in terms of more functionalities supported and in
 287 terms of improved CPU usage.
 288 Just to be certain, it is always a good idea to use a recent Subversion
 289 checkout.
 290 </para>
 291
 292 <para>
 293 If you want a quick and easy way to know whether there have been
 294 recent changes to <systemitem class="library">libavcodec</systemitem>'s
 295 H.264 decoding, you might keep an eye on
 296 <ulink url="http://svn.mplayerhq.hu/ffmpeg/trunk/libavcodec/h264.c?view=log">FFmpeg Subversion repository's web interface</ulink>.
 297 </para>
 298 </sect3>
 299
 300
 301 <sect3 id="codec-x264-encode">
 302 <title>How can I encode videos using <application>MEncoder</application>
 303   and <systemitem class="library">x264</systemitem>?</title>
 304
 305 <para>
 306 If you have the GIT client installed, the latest x264
 307 sources can be gotten with this command:
 308 <screen>git clone git://git.videolan.org/x264.git</screen>
 309 <application>MPlayer</application> sources are updated whenever
 310 an <systemitem class="library">x264</systemitem> API change
 311 occurs, so it is always suggested to use
 312 <application>MPlayer</application> from Subversion as well.
 313 Perhaps this situation will change when and if an
 314 <systemitem class="library">x264</systemitem> "release" occurs.
 315 Meanwhile, <systemitem class="library">x264</systemitem> should
 316 be considered a bit unstable, in the sense that its programming
 317 interface is subject to change.
 318 </para>
 319
 320 <para>
 321 <systemitem class="library">x264</systemitem> is built and
 322 installed in the standard way:
 323 <screen>./configure &amp;&amp; make &amp;&amp; sudo make install</screen>
 324 This installs libx264.a in /usr/local/lib and x264.h is placed in
 325 /usr/local/include.
 326
 327 With the <systemitem class="library">x264</systemitem> library
 328 and header placed in the standard locations, building
 329 <application>MPlayer</application> with
 330 <systemitem class="library">x264</systemitem> support is easy.
 331 Just run the standard:
 332 <screen>./configure &amp;&amp; make &amp;&amp; sudo make install</screen>
 333 The <filename>./configure</filename> script will autodetect that you have
 334 satisfied the requirements for <systemitem class="library">x264</systemitem>.
 335 </para>
 336 </sect3>
 337 </sect2>
 338 </sect1>
 339
 340
 341 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 342
 343
 344 <sect1 id="audio-codecs">
 345 <title>Audio codecs</title>
 346
 347 <itemizedlist>
 348 <title>The most important audio codecs above all:</title>
 349 <listitem><para>
 350   MPEG layer 1/2/3 (MP1/2/3) audio (<emphasis role="bold">native</emphasis>
 351   code, with MMX/SSE/3DNow! optimization)
 352 </para></listitem>
 353 <listitem><para>
 354   Windows Media Audio 7 and 8 (AKA WMAv1 and WMAv2)
 355   (<emphasis role="bold">native</emphasis> code, with
 356   <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>)
 357 </para></listitem>
 358 <listitem><para>
 359   Windows Media Audio 9 (WMAv3) (using DMO DLL)
 360 </para></listitem>
 361 <listitem><para>
 362   AC-3 Dolby audio (<emphasis role="bold">native</emphasis> code, with
 363   MMX/SSE/3DNow! optimization)
 364 </para></listitem>
 365 <listitem><para>
 366   AC-3 passing through sound card hardware
 367 </para></listitem>
 368 <listitem><para>
 369   AAC
 370 </para></listitem>
 371 <listitem><para>
 372   Ogg Vorbis audio codec (<emphasis role="bold">native</emphasis> library)
 373 </para></listitem>
 374 <listitem><para>
 375   RealAudio: DNET (low bitrate AC-3), Cook, Sipro and ATRAC3
 376 </para></listitem>
 377 <listitem><para>
 378   QuickTime: Qualcomm and QDesign audio codecs
 379 </para></listitem>
 380 <listitem><para>
 381   VIVO audio (g723, Vivo Siren)
 382 </para></listitem>
 383 <listitem><para>
 384   Voxware audio (using DirectShow DLL)
 385 </para></listitem>
 386 <listitem><para>
 387   alaw and ulaw, various gsm, adpcm and pcm formats and other simple old
 388   audio codecs
 389 </para></listitem>
 390 <listitem><para>
 391   Adaptive Multi-Rate (AMR) speech codecs
 392 </para></listitem>
 393 </itemizedlist>
 394
 395 <!-- ********** -->
 396
 397 <sect2 id="swac3">
 398 <title>Software AC-3 decoding</title>
 399
 400 <para>
 401 This is the default decoder used for files with AC-3 audio.
 402 </para>
 403
 404 <para>
 405 The AC-3 decoder can create audio output mixes for 2, 4, or 6 speakers.
 406 When configured for 6 speakers, this decoder provides separate output of
 407 all the AC-3 channels to the sound driver, allowing for full "surround
 408 sound" experience without the external AC-3 decoder required to use the
 409 hwac3 codec.
 410 </para>
 411
 412 <para>
 413 Use the <option>-channels</option> option to select the number of output
 414 channels.  Use <option>-channels 2</option> for a stereo downmix.  For a 4
 415 channel downmix (Left Front, Right Front, Left Surround and Right Surround
 416 outputs), use <option>-channels 4</option>.  In this case, any center
 417 channel will be mixed equally to the front channels.
 418 <option>-channels 6</option> will output all the AC-3 channels as they are
 419 encoded - in the order Left, Right, Left Surround, Right Surround, Center and
 420 LFE.
 421 </para>
 422
 423 <para>
 424 The default number of output channels is 2.
 425 </para>
 426
 427 <para>
 428 To use more than 2 output channels, you will need to use OSS, and have a
 429 sound card that supports the appropriate number of output channels via the
 430 SNDCTL_DSP_CHANNELS ioctl.  An example of a suitable driver is emu10k1
 431 (used by Soundblaster Live! cards) from August 2001 or newer (ALSA CVS is
 432 also supposed to work).
 433 </para>
 434 </sect2>
 435
 436 <!-- ********** -->
 437
 438 <sect2 id="hwac3">
 439 <title>Hardware AC-3 decoding</title>
 440
 441 <para>
 442 You need an AC-3 capable sound card, with digital out (S/PDIF). The card's
 443 driver must properly support the AFMT_AC3 format (C-Media does).  Connect
 444 your AC-3 decoder to the S/PDIF output, and use the <option>-ac
 445 hwac3</option> option. It is experimental but known to work with C-Media
 446 cards and Soundblaster Live! + ALSA (but not OSS) drivers and DXR3/Hollywood+
 447 MPEG decoder cards.
 448 </para>
 449 </sect2>
 450
 451 <!-- ********** -->
 452
 453 <sect2 id="libmad">
 454 <title><systemitem class="library">libmad</systemitem> support</title>
 455
 456 <para>
 457 <ulink url="http://www.underbit.com/products/mad/"><systemitem class="library">libmad</systemitem></ulink>
 458 is a multiplatform, integer (internally 24bit PCM) only
 459 MPEG audio decoding library. It does not handle broken files well, and it
 460 sometimes has problems with seeking, but it may perform better on FPU-less
 461 (such as <link linkend="arm">ARM</link>)
 462 platform than <systemitem class="library">mp3lib</systemitem>.
 463 </para>
 464
 465 <para>
 466 If you have a proper installation of
 467 <systemitem class="library">libmad</systemitem>,
 468 <filename>./configure</filename> will notice and support for MPEG audio
 469 decoding via <systemitem class="library">libmad</systemitem> will be built
 470 automatically.
 471 </para>
 472 </sect2>
 473
 474 <!-- ********** -->
 475
 476 <sect2 id="hwmpa">
 477 <title>Hardware MPEG audio codec</title>
 478
 479 <para>
 480 This codec (selected by <option>-ac hwmpa</option>) passes through MPEG audio
 481 packets to hardware decoders, such as the ones found in full-featured DVB cards
 482 and DXR2 adapters.
 483 Don't use it in combination with any other audio output device
 484 (such as OSS and ALSA) that isn't able to decode it (you will hear
 485 only white noise).
 486 </para>
 487 </sect2>
 488
 489 <!-- ********** -->
 490
 491 <sect2 id="aac">
 492 <title>AAC codec</title>
 493
 494 <para>
 495 AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4
 496 files. An open source decoder called FAAD is available from
 497 <ulink url="http://www.audiocoding.com"/>.
 498 <application>MPlayer</application> includes a CVS snapshot of libfaad 2.1
 499 beta, so you do not need to get it separately.
 500 </para>
 501
 502 <para>
 503 If you use gcc 3.2 which fails to compile our internal FAAD or want to use
 504 the external library for some other reason, download the library from the
 505 <ulink url="http://www.audiocoding.com/modules/mydownloads/">download page</ulink>
 506 and pass <option>--enable-faad-external</option>
 507 to <filename>./configure</filename>.
 508 You do not need all of faad2 to decode AAC files, libfaad is enough. Build
 509 it like this:
 510 <screen>
 511 cd faad2/
 512 sh bootstrap
 513 ./configure
 514 cd libfaad
 515 make
 516 make install
 517 </screen>
 518 Binaries are not available from audiocoding.com, but you can (apt-)get Debian
 519 packages from
 520 <ulink url="http://www.debian-multimedia.org/">Christian Marillat's homepage</ulink>,
 521 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink>
 522 and Fedora RPMs from <ulink url="http://rpm.livna.org/">Livna</ulink>.
 523 </para>
 524 </sect2>
 525
 526 <!-- ********** -->
 527
 528 <sect2 id="amr">
 529 <title>AMR codecs</title>
 530
 531 <para>
 532 Adaptive Multi-Rate speech codec is used in third generation (3G) mobile
 533 phones.
 534 Reference implementation is available from
 535 <ulink url="http://www.3gpp.org">The 3rd Generation Partnership Project</ulink>
 536 (free for private use).
 537 To enable support, download and install support libraries for
 538 <ulink url="http://www.penguin.cz/~utx/amr">AMR-NB and AMR-WB</ulink>
 539 following the instructions on that page. Recompile MPlayer afterwards.
 540 </para>
 541 </sect2>
 542
 543 </sect1>
 544
 545
 546 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 547
 548
 549 <sect1 id="codec-importing">
 550 <title>Win32 codecs importing HOWTO</title>
 551
 552 <!-- TODO: a short paragraph of text would be nice here... -->
 553
 554 <sect2 id="vfw-codecs">
 555 <title>VFW codecs</title>
 556
 557 <para>
 558 VFW (Video for Windows) is the old Video API for Windows. Its codecs have
 559 the <filename>.DLL</filename> or (rarely) <filename>.DRV</filename>
 560 extension.  If <application>MPlayer</application> fails at playing your AVI
 561 with this kind of message:
 562 <screen>UNKNOWN video codec: HFYU (0x55594648)</screen>
 563 It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU =
 564 HuffYUV codec, DIV3 = DivX Low Motion, etc.). Now that you know this, you
 565 have to find out which DLL Windows loads in order to play this file. In our
 566 case, the <filename>system.ini</filename> contains this information in a
 567 line that reads:
 568 <programlisting>VIDC.HFYU=huffyuv.dll</programlisting>
 569 </para>
 570
 571 <para>
 572 So you need the <filename>huffyuv.dll</filename> file. Note that the audio
 573 codecs are specified by the MSACM prefix:
 574 <programlisting>msacm.l3acm=L3codeca.acm</programlisting>
 575 </para>
 576
 577 <para>
 578 This is the MP3 codec.  Now that you have all the necessary information
 579 (fourcc, codec file, sample AVI), submit your codec support request by
 580 mail, and upload these files to the FTP site:
 581 <systemitem role="url">ftp://upload.mplayerhq.hu/MPlayer/incoming/<replaceable>&lt;codecname&gt;</replaceable>/</systemitem>
 582 </para>
 583
 584 <note><para>
 585 On Windows NT/2000/XP search for this info in the registry,
 586 e.g. search for "VIDC.HFYU". To find out how to do this, look at
 587 the old DirectShow method below.
 588 </para></note>
 589 </sect2>
 590
 591 <!-- ********** -->
 592
 593 <sect2 id="dshow-codecs">
 594 <title>DirectShow codecs</title>
 595
 596 <para>
 597 DirectShow is the newer Video API, which is even worse than its predecessor.
 598 Things are harder with DirectShow, since
 599 <itemizedlist>
 600 <listitem><para>
 601   <filename>system.ini</filename> does not contain the needed information,
 602   instead it is stored in the registry and
 603 </para></listitem>
 604 <listitem><para>
 605   we need the GUID of the codec.
 606 </para></listitem>
 607 </itemizedlist>
 608 </para>
 609
 610 <procedure>
 611 <title>New Method:</title>
 612 <para>
 613 Using <application>Microsoft GraphEdit</application> (fast)
 614 </para>
 615 <step><para>
 616   Get <application>GraphEdit</application> from either DirectX SDK or
 617   <ulink url="http://doom9.net">doom9</ulink>.
 618 </para></step>
 619 <step><para>
 620   Start <command>graphedit.exe</command>.
 621 </para></step>
 622 <step><para>
 623   From the menu select
 624   <menuchoice><guimenu>Graph</guimenu>
 625   <guisubmenu>Insert Filters</guisubmenu></menuchoice>.
 626 </para></step>
 627 <step><para>
 628   Expand item <systemitem>DirectShow Filters</systemitem>.
 629 </para></step>
 630 <step><para>
 631   Select the right codec name and expand item.
 632 </para></step>
 633 <step><para>
 634   In the entry <systemitem>DisplayName</systemitem> look at the text in
 635   winged brackets after the backslash and write it down (five dash-delimited
 636   blocks, the GUID).
 637 </para></step>
 638 <step><para>
 639   The codec binary is the file specified in the
 640   <systemitem>Filename</systemitem> entry.
 641 </para></step>
 642 </procedure>
 643
 644 <note><para>
 645 If there is no <systemitem>Filename</systemitem> and
 646 <systemitem>DisplayName</systemitem> contains something like
 647 <systemitem>device:dmo</systemitem>, then it is a DMO-Codec.
 648 </para></note>
 649
 650 <procedure>
 651 <title>Old Method:</title>
 652 <para>
 653 Take a deep breath and start searching the registry...
 654 </para>
 655 <step><para>
 656   Start <command>regedit</command>.
 657 </para></step>
 658 <step><para>
 659   Press <keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>, disable
 660   the first two checkboxes, and enable the third. Type in the fourcc of the
 661   codec (e.g. <userinput>TM20</userinput>).
 662 </para></step>
 663 <step><para>
 664   You should see a field which contains the path and the filename (e.g.
 665   <filename>C:\WINDOWS\SYSTEM\TM20DEC.AX</filename>).
 666 </para></step>
 667 <step><para>
 668   Now that you have the file, we need the GUID. Try searching again, but
 669   now search for the codec's name, not the fourcc. Its name can be acquired
 670   when Media Player is playing the file, by checking
 671   <menuchoice><guimenu>File</guimenu> <guisubmenu>Properties</guisubmenu>
 672   <guimenuitem>Advanced</guimenuitem></menuchoice>.
 673   If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
 674 </para></step>
 675 <step><para>
 676   If the GUID is found you should see a <guilabel>FriendlyName</guilabel>
 677   and a <guilabel>CLSID</guilabel> field. Write down the 16 byte CLSID,
 678   this is the GUID we need.
 679 </para></step>
 680 </procedure>
 681
 682 <note><para>
 683 If searching fails, try enabling all the checkboxes. You may have
 684 false hits, but you may get lucky...
 685 </para></note>
 686
 687 <para>
 688 Now that you have all the necessary information (fourcc, GUID, codec file,
 689 sample AVI), submit your codec support request by mail, and upload these files
 690 to the FTP site:
 691 <systemitem role="url">ftp://upload.mplayerhq.hu/MPlayer/incoming/<replaceable>&lt;codecname&gt;</replaceable>/</systemitem>
 692 </para>
 693
 694 <para>
 695 If you want to add a codec yourself, read
 696 <ulink url="http://www.mplayerhq.hu/MPlayer/DOCS/tech/codecs.conf.txt">DOCS/tech/codecs.conf.txt</ulink>.
 697 </para>
 698
 699 </sect2>
 700 </sect1>
 701
 702 </chapter>