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