Mercurial > mplayer.hg
annotate DOCS/xml/en/codecs.xml @ 10701:3ee7da8ee7d5
libfaad installation instructions
author | diego |
---|---|
date | Tue, 26 Aug 2003 09:56:58 +0000 |
parents | 4b2254f16fed |
children | 57f5eb4d884f |
rev | line source |
---|---|
9675 | 1 <?xml version="1.0" encoding="iso-8859-1"?> |
2 <sect1 id="codecs"> | |
3 <title>Supported codecs</title> | |
4 | |
5 <sect2 id="video-codecs"> | |
6 <title>Video codecs</title> | |
7 | |
8 <para> | |
9 See the <ulink url="http://www.mplayerhq.hu/DOCS/codecs-status.html">codec status table</ulink> | |
10 for the complete, daily generated list. Quite a few codecs are available for | |
11 download from our homepage. Grab them from our | |
12 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/">codecs page</ulink>. | |
13 </para> | |
14 | |
15 <para> | |
16 The most important ones above all: | |
17 </para> | |
18 | |
19 <itemizedlist> | |
20 <listitem><simpara> | |
21 <emphasis role="bold">MPEG1</emphasis> (<emphasis role="bold">VCD</emphasis>) and | |
22 <emphasis role="bold">MPEG2</emphasis> (<emphasis role="bold">DVD</emphasis>) video | |
23 </simpara></listitem> | |
24 <listitem><simpara> | |
25 native decoders for <emphasis role="bold">DivX ;-), OpenDivX (DivX4), | |
26 DivX 5.01, 3ivX, M$ MPEG4</emphasis> v1, v2 and other MPEG4 variants | |
27 </simpara></listitem> | |
28 <listitem><simpara> | |
29 native decoder for <emphasis role="bold">Windows Media Video 7/8</emphasis> | |
30 (<emphasis role="bold">WMV1/WMV2</emphasis>), and Win32 DLL decoder | |
31 for <emphasis role="bold">Windows Media Video 9</emphasis> | |
32 (<emphasis role="bold">WMV3</emphasis>), both used in <filename>.wmv</filename> | |
33 files | |
34 </simpara></listitem> | |
35 <listitem><simpara> | |
36 native <emphasis role="bold">Sorenson 1 (SVQ1)</emphasis> decoder | |
37 </simpara></listitem> | |
38 <listitem><simpara> | |
10132 | 39 native <emphasis role="bold">Sorenson 3 (SVQ3)</emphasis> decoder |
9675 | 40 </simpara></listitem> |
41 <listitem><simpara> | |
42 <emphasis role="bold">3ivx</emphasis> v1, v2 decoder | |
43 </simpara></listitem> | |
44 <listitem><simpara> | |
45 Cinepak and <emphasis role="bold">Intel Indeo</emphasis> codecs (3.1,3.2,4.1,5.0) | |
46 </simpara></listitem> | |
47 <listitem><simpara> | |
48 <emphasis role="bold">MJPEG</emphasis>, AVID, VCR2, ASV2 and other hardware | |
49 formats | |
50 </simpara></listitem> | |
51 <listitem><simpara> | |
52 VIVO 1.0, 2.0, I263 and other <emphasis role="bold">h263(+)</emphasis> variants | |
53 </simpara></listitem> | |
54 <listitem><simpara> | |
55 FLI/FLC | |
56 </simpara></listitem> | |
57 <listitem><simpara> | |
58 <emphasis role="bold">RealVideo 1.0</emphasis> from libavcodec, and | |
59 <emphasis role="bold">RealVideo 2.0, 3.0</emphasis> and | |
60 <emphasis role="bold">4.0</emphasis> codecs using RealPlayer libraries | |
61 </simpara></listitem> | |
62 <listitem><simpara> | |
63 native decoder for HuffYUV | |
64 </simpara></listitem> | |
65 <listitem><simpara> | |
66 Various old simple RLE-like formats | |
67 </simpara></listitem> | |
68 </itemizedlist> | |
69 | |
70 <para> | |
71 If you have a Win32 codec not listed here which is not supported yet, | |
72 please read the <link linkend="win32-codecs">codec importing HOWTO</link> | |
73 and help us add support for it. | |
74 </para> | |
75 | |
76 | |
77 <sect3 id="divx4-5"> | |
78 <title>DivX4/DivX5</title> | |
79 | |
80 <para> | |
9683 | 81 This section contains information about the DivX4 and DivX5 codecs of |
9675 | 82 <ulink url="http://www.projectmayo.com">Project Mayo</ulink>. |
83 Their first available alpha version was OpenDivX 4.0 alpha 47 and 48. | |
84 Support for this was included in <application>MPlayer</application> in the | |
85 past, and built by default. We also used its postprocessing code to | |
86 optionally enhance visual quality of MPEG1/2 movies. Now we use our own, | |
87 for all file types. | |
88 </para> | |
89 | |
90 <para> | |
91 The new generation of this codec is called DivX4 and can even decode | |
92 movies made with the infamous DivX codec! In addition it is much faster | |
93 than the native Win32 DivX DLLs but slower than <systemitem | |
94 class="library">libavcodec</systemitem>. Hence its usage as a decoder is | |
95 <emphasis role="bold">DISCOURAGED</emphasis>. However, it is useful for | |
96 encoding. One disadvantage of this codec is that it is not available under an | |
97 Open Source license. | |
98 </para> | |
99 | |
100 <para> | |
101 DivX4 works in two modes: | |
102 <variablelist> | |
103 <varlistentry><term><option>-vc odivx</option></term> | |
104 <listitem><simpara> | |
105 Uses the codec in OpenDivX fashion. In this case it produces YV12 images | |
106 in its own buffer, and <application>MPlayer</application> does colorspace | |
107 conversion via libvo. (<emphasis role="bold">Fast, recommended!</emphasis>) | |
108 </simpara></listitem> | |
109 </varlistentry> | |
110 <varlistentry><term><option>-vc divx4</option></term> | |
111 <listitem><simpara> | |
112 Uses the colorspace conversion of the codec. In this mode you can use | |
113 YUY2/UYVY, too. (<emphasis role="bold">SLOW</emphasis>) | |
114 </simpara></listitem> | |
115 </varlistentry> | |
116 </variablelist> | |
117 </para> | |
118 | |
119 <para> | |
120 The <option>-vc odivx</option> method is usually faster, due to the fact | |
121 that it transfers image data in YV12 (planar YUV 4:2:0) format, thus | |
122 requiring much less bandwidth on the bus. For packed YUV modes (YUY2, UYVY) | |
123 use the <option>-vc divx4</option> method. For RGB modes the speed is the | |
124 same, differing at best according to your current color depth. | |
125 <note> | |
126 <para> | |
127 If your <option>-vo</option> driver supports direct rendering, then <option>-vc | |
128 divx4</option> may be faster, or even the fastest solution. | |
129 </para> | |
130 | |
131 <para> | |
132 The Divx4/5 binary codec library can be downloaded from | |
133 <ulink url="http://avifile.sourceforge.net">avifile</ulink> or | |
134 <ulink url="http://www.divx.com">divx.com</ulink> | |
135 Unpack it, run <filename>./install.sh</filename> as root and do not forget adding | |
136 <filename class="directory">/usr/local/lib</filename> to your | |
137 <filename>/etc/ld.so.conf</filename> and running <command>ldconfig</command>. | |
138 </para> | |
139 | |
140 <para> | |
141 Get the CVS version of the OLD OpenDivx core library like this: | |
142 </para> | |
143 | |
144 <procedure> | |
145 <step><para> | |
146 <screen>cvs -d:pserver:anonymous@cvs.projectmayo.com:/cvsroot login</screen> | |
147 </para></step> | |
148 <step><para> | |
149 <screen>cvs -d:pserver:anonymous@cvs.projectmayo.com:/cvsroot co divxcore</screen> | |
150 </para></step> | |
151 <step><para> | |
152 This core library is split into a decore and encore library that have to be | |
153 compiled separately. For the decore Library, simply type | |
154 <screen> | |
155 cd divxcore/decore/build/linux | |
156 make | |
157 cp libdivxdecore.so /usr/local/lib | |
9815
eb55fee443d2
Make absolute symlinks relative as suggested by Rich, fix typo.
diego
parents:
9802
diff
changeset
|
158 ln -s libdivxdecore.so /usr/local/lib/libdivxdecore.so.0 |
9675 | 159 cp ../../src/decore.h /usr/local/include |
160 </screen> | |
161 </para></step> | |
162 <step><para> | |
163 Alas, for the encore library there is no Linux Makefile available, and the | |
164 MMX optimized code only works on Windows. You can still compile it, though, | |
165 by using this | |
166 <ulink url="ftp://ftp.mplayerhq.hu/MPlayer/contrib/divx-mf/Makefile">Makefile</ulink>. | |
167 <screen> | |
168 cd ../../../encore/build | |
169 mkdir linux | |
170 cd linux | |
171 cp path/Makefile . | |
172 make | |
173 cp libdivxencore.so /usr/local/lib | |
9815
eb55fee443d2
Make absolute symlinks relative as suggested by Rich, fix typo.
diego
parents:
9802
diff
changeset
|
174 ln -s libdivxencore.so /usr/local/lib/libdivxencore.so.0 |
9675 | 175 cp ../../src/encore.h /usr/local/include |
176 </screen> | |
177 </para></step> | |
178 </procedure> | |
179 | |
180 <para> | |
181 <application>MPlayer</application> autodetects DivX4/DivX5 if it is | |
182 properly installed, just compile as usual. If it does not detect it, you | |
183 did not install or configure it correctly. | |
184 </para> | |
185 | |
186 </note> | |
187 </para> | |
188 </sect3> | |
189 | |
190 | |
191 <sect3 id="ffmpeg" xreflabel="FFmpeg DivX/libavcodec"> | |
192 <title>FFmpeg DivX/libavcodec</title> | |
193 | |
194 <para> | |
195 <ulink url="http://ffmpeg.sourceforge.net">FFmpeg</ulink> contains an | |
196 <emphasis role="bold">open source</emphasis> codec package, which is capable | |
10132 | 197 of decoding streams encoded with H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1/WMV2/HuffYUV/SVQ1/SVQ3 |
9675 | 198 video, or WMA (Windows Media Audio) audio codecs. Not only some of them can be |
199 encoded with, but it also offers higher speed than the Win32 codecs or the | |
200 DivX.com DivX4/5 library! | |
201 </para> | |
202 | |
203 <para> | |
204 It contains a lot of nice codecs, especially important are the MPEG4 variants: | |
10132 | 205 DivX3, DivX4, DivX5, Windows Media Video 7/8 (WMV1/WMV2). Also a very interesting one |
9675 | 206 is the WMA decoder. |
207 </para> | |
208 | |
209 <para> | |
10132 | 210 The most recent codec deserving credit is the <emphasis role="bold">Sorenson 3</emphasis> |
211 (SVQ3) codec. This is the first, completely opensource implementation of this | |
212 codec. It's even faster than the original. Be sure to prefer this instead | |
213 of the binary codec! | |
214 </para> | |
215 | |
216 <para> | |
9675 | 217 If you use an <application>MPlayer</application> release you have libavcodec |
218 right in the package, just build as usual. If you use | |
219 <application>MPlayer</application> from CVS you have to extract libavcodec from | |
220 the FFmpeg CVS tree as FFmpeg releases <emphasis role="bold">don't</emphasis> | |
221 work with <application>MPlayer</application>. In order to achieve this do: | |
222 </para> | |
223 | |
224 <procedure> | |
225 <step><para> | |
226 <screen>cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login</screen> | |
227 </para></step> | |
228 <step><para> | |
229 <screen>cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg</screen> | |
230 </para></step> | |
231 <step><para> | |
232 Move the <filename>libavcodec</filename> directory from the FFmpeg | |
233 sources to the root of the <application>MPlayer</application> CVS tree. | |
234 It should look like this: | |
235 <filename>main/libavcodec</filename> | |
236 </para><para> | |
237 Symlinking is <emphasis role="bold">not</emphasis> enough, you have to | |
238 copy/move it! | |
239 </para></step> | |
240 <step><para> | |
241 Compile. <filename>configure</filename> should detect problems before | |
242 compilation. | |
243 </para></step> | |
244 </procedure> | |
245 | |
246 <note> | |
247 <para> | |
248 <application>MPlayer</application> from CVS does contain a | |
249 <filename>libavcodec</filename> subdirectory, but it does | |
250 <emphasis role="bold">not</emphasis> contain the source for libavcodec! | |
251 You must follow the steps above to obtain the source for this library. | |
252 </para> | |
253 </note> | |
254 | |
255 <para> | |
256 With FFmpeg and my Matrox G400, I can view even the highest resolution DivX | |
257 movies without dropped frames on my K6/2 500. | |
258 </para> | |
259 </sect3> | |
260 | |
261 | |
262 <sect3 id="xanim"> | |
263 <title>XAnim codecs</title> | |
264 | |
265 <note> | |
266 <para> | |
267 Be advised that the XAnim binary codecs are packaged with a piece of text | |
268 claiming to be a legally binding software license which, besides other | |
269 restrictions, forbids the user to use the codecs in conjunction with any | |
270 program other than <application>XAnim</application>. However, the XAnim | |
271 author has yet to bring legal action against anyone for codec-related issues. | |
272 </para> | |
273 </note> | |
274 | |
275 <formalpara> | |
276 <title>INSTALLATION AND USAGE</title> | |
277 <para> | |
278 <application>MPlayer</application> is capable of employing the XAnim codecs | |
279 for decoding. Follow the instructions to enable them: | |
280 </para> | |
281 </formalpara> | |
282 | |
283 <procedure> | |
284 <step><para> | |
285 Download the codecs you wish to use from the | |
286 <ulink url="http://xanim.va.pubnix.com">XAnim site</ulink>. | |
9683 | 287 The <emphasis role="bold">3ivx</emphasis> codec is not there, but at the |
9675 | 288 <ulink url="http://www.3ivx.com">3ivx site</ulink>. |
289 </para></step> | |
290 <step><para> | |
9683 | 291 <emphasis role="bold">OR</emphasis> download the codecs pack from our |
292 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/">codecs page</ulink> | |
293 </para></step> | |
294 <step><para> | |
9675 | 295 Use the <option>--with-xanimlibdir</option> option to tell |
296 <filename>configure</filename> where | |
297 to find the XAnim codecs. By default, it looks for them at | |
10229 | 298 <filename class="directory">/usr/local/lib/codecs</filename>, |
9675 | 299 <filename class="directory">/usr/local/lib/xanim/mods</filename>, |
300 <filename class="directory">/usr/lib/xanim/mods</filename> and | |
301 <filename class="directory">/usr/lib/xanim</filename>. | |
302 Alternatively you can set the environment variable | |
303 <envar>XANIM_MOD_DIR</envar> to the directory of the XAnim codecs. | |
304 </para></step> | |
305 <step><para> | |
306 Rename/symlink the files, cutting out the architecture stuff, so they | |
307 will have filenames like these: <filename>vid_cvid.xa</filename>, | |
308 <filename>vid_h263.xa</filename>, <filename>vid_iv50.xa</filename> | |
309 </para></step> | |
310 </procedure> | |
311 | |
312 <para> | |
313 XAnim is video codec family <systemitem>xanim</systemitem>, so you may want | |
314 to use the <option>-vfm xanim</option> option to tell <application>MPlayer</application> | |
315 to use them if possible. | |
316 </para> | |
317 | |
318 <para> | |
319 Tested codecs include: <emphasis role="bold">Indeo 3.2, 4.1, 5.0, CVID, 3ivX, | |
320 h263.</emphasis> | |
321 </para> | |
322 </sect3> | |
323 | |
324 | |
325 <sect3 id="vivo-video"> | |
326 <title>VIVO video</title> | |
327 <para> | |
328 <application>MPlayer</application> can play Vivo (1.0 and 2.0) videos. The | |
329 most suitable codec for 1.0 files is FFmpeg's H263 decoder, you can use it | |
330 with the <option>-vc ffh263</option> option. For 2.0 files, use the | |
331 Win32 DLL through the <option>-vc vivo</option> option. If you do not supply | |
332 command line options <application>MPlayer</application> selects the best codec | |
333 automatically. | |
334 </para> | |
335 </sect3> | |
336 | |
337 | |
338 <sect3 id="mpeg12"> | |
339 <title>MPEG 1/2 video</title> | |
340 <para> | |
341 MPEG1 and MPEG2 are decoded by the multiplatform native <systemitem | |
342 class="library">libmpeg2</systemitem> library, whose source code is | |
343 included in <application>MPlayer</application>. We handle buggy MPEG 1/2 | |
344 video files by catching <systemitem>Signal 11</systemitem> | |
345 (<systemitem>segmentation fault</systemitem>), and quickly | |
346 reinitializing the codec, continuing exactly from where the failure | |
347 occurred. This recovery technique has no measurable speed penalty. | |
348 </para> | |
349 </sect3> | |
350 | |
351 | |
352 <sect3 id="msvideo1"> | |
353 <title>MS Video1</title> | |
354 <para> | |
355 This is a very old and very bad codec from Microsoft. In the past it was | |
356 decoded with the <filename>msvidc32.dll</filename> Win32 codec, now we have | |
357 our own open source implementation | |
358 (by <ulink url="mailto:melanson@pcisys.net">Mike Melanson</ulink>). | |
359 </para> | |
360 </sect3> | |
361 | |
362 | |
363 <sect3 id="cinepak-cvid"> | |
364 <title>Cinepak CVID</title> | |
365 <para> | |
366 <application>MPlayer</application> uses its own open source, multiplatform | |
367 Cinepak decoder (by <ulink url="mailto:timf@csse.monash.edu.au">Dr. Tim Ferguson</ulink>) | |
368 by default. It supports YUV outputs, so that hardware | |
369 scaling is possible if the video output driver permits it. | |
370 </para> | |
371 </sect3> | |
372 | |
373 | |
374 <sect3 id="realvideo"> | |
375 <title>RealVideo</title> | |
376 | |
377 <para> | |
378 <application>MPlayer</application> supports decoding all versions of | |
379 RealVideo: | |
380 | |
381 <itemizedlist> | |
382 <listitem><simpara> | |
383 RealVideo 1.0 (fourcc RV10) - en/decoding supported by | |
384 <systemitem class="library">libavcodec</systemitem> | |
385 </simpara></listitem> | |
386 <listitem><simpara> | |
387 RealVideo 2.0, 3.0, 4.0 (fourcc RV20, RV30, RV40) - decoding supported by | |
388 <emphasis role="bold">RealPlayer libraries</emphasis> | |
389 </simpara></listitem> | |
390 </itemizedlist> | |
391 </para> | |
392 | |
393 <para> | |
394 It is recommended to download and install <application>RealPlayer8</application> | |
395 or <application>RealONE</application>, because <application>MPlayer</application> | |
396 can use their libraries to decode files with RealVideo 2.0 - 4.0 video. The | |
397 <application>MPlayer</application> <filename>configure</filename> script should | |
398 detect the <application>RealPlayer</application> libraries in the standard | |
399 locations of a full installation. If it does not, tell <filename>configure</filename> | |
400 where to look with the <option>--with-reallibdir</option> option. | |
401 </para> | |
402 | |
10229 | 403 <para> |
404 As a second chance you can download the codecs from | |
405 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/">http://www.mplayerhq.hu/MPlayer/releases/codecs/</ulink>. | |
406 After downloading the Real codecs package, extract it to the | |
407 <filename class="directory">/usr/local/lib/codecs</filename> directory, or you can | |
408 specify a unique path with the <option>--with-reallibdir</option> option. | |
409 </para> | |
410 | |
9675 | 411 <note><para> |
412 <application>RealPlayer</application> libraries currently | |
413 <emphasis role="bold">only work with Linux, FreeBSD, NetBSD and Cygwin on the x86, | |
414 Alpha and PowerPC (Linux/Alpha and Linux/PowerPC have been tested) platforms</emphasis>. | |
415 </para></note> | |
416 </sect3> | |
417 | |
418 | |
419 <sect3 id="xvid"> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
420 <title>XviD</title> |
9675 | 421 |
422 <para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
423 <ulink url="http://www.xvid.org">XviD</ulink> is a forked development of the |
9675 | 424 OpenDivX codec. It happened when ProjectMayo changed OpenDivX to closed source |
425 DivX4 (now DivX5), 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
|
426 then started XviD. So both projects have the same origin. |
9675 | 427 |
428 <itemizedlist> | |
429 <title>ADVANTAGES</title> | |
430 <listitem><simpara> | |
431 open source | |
432 </simpara></listitem> | |
433 <listitem><simpara> | |
434 its API is compatible with DivX4 so adding support for it is easy | |
435 </simpara></listitem> | |
436 <listitem><simpara> | |
437 2-pass encoding support | |
438 </simpara></listitem> | |
439 <listitem><simpara> | |
440 nice encoding quality, higher speed than DivX4 (you can optimize it for | |
441 your box while compiling) | |
442 </simpara></listitem> | |
443 </itemizedlist> | |
444 | |
445 <itemizedlist> | |
446 <title>DISADVANTAGES</title> | |
447 <listitem><simpara> | |
448 currently it does not properly <emphasis role="bold">decode</emphasis> all | |
449 DivX/DivX4 files (no problem as <link linkend="ffmpeg">libavcodec</link> | |
450 can play them) | |
451 </simpara></listitem> | |
452 <listitem><simpara> | |
453 under development | |
454 </simpara></listitem> | |
455 </itemizedlist> | |
456 </para> | |
457 | |
458 <procedure> | |
459 <title>INSTALLING XVID CVS</title> | |
460 <para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
461 It is currently available only from CVS. Here are download and installation |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
462 instructions (you need at least autoconf 2.50, automake and libtool): |
9675 | 463 </para> |
464 <step><para> | |
465 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen> | |
466 </para></step> | |
467 <step><para> | |
468 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen> | |
469 </para></step> | |
470 <step><para> | |
471 <screen>cd xvidcore/build/generic</screen> | |
472 </para></step> | |
473 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
474 <screen>./bootstrap.sh</screen> |
9675 | 475 </para></step> |
476 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
477 <screen>./configure</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
478 You may have to add some options (examine the output of |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
479 <screen>./configure --help</screen>). |
9675 | 480 </para></step> |
481 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
482 <screen>make && make install</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
483 </para></step> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
484 <step><para> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
485 If you specified <option>--enable-divxcompat</option>, |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
486 copy <filename>../../src/divx4.h</filename> to |
9675 | 487 <filename class="directory">/usr/local/include/</filename>. |
488 </para></step> | |
489 <step><para> | |
490 Recompile <application>MPlayer</application> with | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
491 <option>--with-xvidcore=<replaceable>/path/to/</replaceable>libxvidcore.a</option>. |
9675 | 492 </para></step> |
493 </procedure> | |
494 </sect3> | |
495 | |
496 | |
497 <sect3 id="sorenson"> | |
498 <title>Sorenson</title> | |
499 | |
500 <para> | |
501 Sorenson is a video codec developed by Sorenson Media and licensed to Apple who | |
502 distribute it with their <application>QuickTime Player</application>. We are | |
503 currently able to decode all version of Sorenson video files with the following | |
10132 | 504 decoders: |
9675 | 505 </para> |
506 | |
507 <itemizedlist> | |
508 <listitem><simpara> | |
10430 | 509 Sorenson Video v1 (fourcc <emphasis>SVQ1</emphasis>) - decoding supported |
510 by <emphasis role="bold">native codec</emphasis> | |
511 (<link linkend="ffmpeg">libavcodec</link>) | |
9675 | 512 </simpara></listitem> |
513 <listitem><simpara> | |
10430 | 514 Sorenson Video v3 (fourcc <emphasis>SVQ3</emphasis>) - decoding supported by |
515 <emphasis role="bold">native codec</emphasis> | |
516 (<link linkend="ffmpeg">libavcodec</link>) | |
9675 | 517 </simpara></listitem> |
518 </itemizedlist> | |
519 | |
520 <procedure> | |
9837 | 521 <title>COMPILING MPLAYER WITH QUICKTIME LIBRARIES SUPPORT</title> |
9675 | 522 <note><para>currently only 32bit Intel platforms are supported.</para></note> |
523 <step><para>download MPlayer CVS</para></step> | |
524 <step><para>download QuickTime DLL pack from | |
525 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/> | |
526 </para></step> | |
527 <step><para>extract QuickTime DLL pack to your Win32 codecs directory | |
10188 | 528 (default: <filename class="directory">/usr/local/lib/codecs/</filename>) |
9675 | 529 </para></step> |
10318 | 530 <step><para>compile MPlayer</para></step> |
9675 | 531 </procedure> |
532 | |
533 </sect3> | |
534 </sect2> | |
535 | |
536 <!-- ********** --> | |
537 | |
538 <sect2 id="audio-codecs"> | |
539 <title>Audio codecs</title> | |
540 | |
541 <itemizedlist> | |
542 <title>The most important audio codecs above all:</title> | |
543 <listitem><simpara> | |
544 MPEG layer 2 (MP2), and layer 3 (MP3) audio (<emphasis role="bold">native</emphasis> | |
545 code, with MMX/SSE/3DNow! optimization) | |
546 </simpara></listitem> | |
547 <listitem><simpara> | |
548 MPEG layer 1 audio (<emphasis role="bold">native</emphasis> code, with libavcodec) | |
549 </simpara></listitem> | |
550 <listitem><simpara> | |
551 Windows Media Audio v1, v2 (<emphasis role="bold">native</emphasis> code, with | |
552 libavcodec) | |
553 </simpara></listitem> | |
554 <listitem><simpara> | |
555 Windows Media Audio 9 (WMAv3) (using DMO DLL) | |
556 </simpara></listitem> | |
557 <listitem><simpara> | |
558 AC3 Dolby audio (<emphasis role="bold">native</emphasis> code, with | |
559 MMX/SSE/3DNow! optimization) | |
560 </simpara></listitem> | |
561 <listitem><simpara> | |
562 AC3 passing through soundcard hardware | |
563 </simpara></listitem> | |
564 <listitem><simpara> | |
565 Ogg Vorbis audio codec (<emphasis role="bold">native</emphasis> library) | |
566 </simpara></listitem> | |
567 <listitem><simpara> | |
568 RealAudio: DNET (low bitrate AC3), Cook, Sipro and ATRAC3 | |
569 </simpara></listitem> | |
570 <listitem><simpara> | |
571 QuickTime: Qualcomm and QDesign audio codecs | |
572 </simpara></listitem> | |
573 <listitem><simpara> | |
574 VIVO audio (g723, Vivo Siren) | |
575 </simpara></listitem> | |
576 <listitem><simpara> | |
577 Voxware audio (using DirectShow DLL) | |
578 </simpara></listitem> | |
579 <listitem><simpara> | |
580 alaw and ulaw, various gsm, adpcm and pcm formats and other simple old | |
581 audio codecs | |
582 </simpara></listitem> | |
9802 | 583 <listitem><simpara> |
584 AAC | |
585 </simpara></listitem> | |
9675 | 586 </itemizedlist> |
587 | |
588 | |
589 <sect3 id="swac3"> | |
590 <title>Software AC3 decoding</title> | |
591 | |
592 <para> | |
593 This is the default decoder used for files with AC3 audio. | |
594 </para> | |
595 | |
596 <para> | |
597 The AC3 decoder can create audio output mixes for 2, 4, or 6 speakers. | |
598 When configured for 6 speakers, this decoder provides separate output of | |
599 all the AC3 channels to the sound driver, allowing for full "surround | |
600 sound" experience without the external AC3 decoder required to use the | |
601 hwac3 codec. | |
602 </para> | |
603 | |
604 <para> | |
605 Use the <option>-channels</option> option to select the number of output | |
606 channels. Use <option>-channels 2</option> for a stereo downmix. For a 4 | |
607 channel downmix (Left Front, Right Front, Left Surround and Right Surround | |
608 outputs), use <option>-channels 4</option>. In this case, any center | |
609 channel will be mixed equally to the front channels. <option>-channels | |
610 6</option> will output all the AC3 channels as they are encoded - in the | |
611 order Left, Right, Left Surround, Right Surround, Center and LFE. | |
612 </para> | |
613 | |
614 <para> | |
615 The default number of output channels is 2. | |
616 </para> | |
617 | |
618 <para> | |
619 To use more than 2 output channels, you will need to use OSS, and have a | |
620 sound card that supports the appropriate number of output channels via the | |
621 SNDCTL_DSP_CHANNELS ioctl. An example of a suitable driver is emu10k1 | |
622 (used by Soundblaster Live! cards) from August 2001 or newer (ALSA CVS is | |
623 also supposed to work). | |
624 </para> | |
625 </sect3> | |
626 | |
627 | |
628 <sect3 id="hwac3"> | |
629 <title>Hardware AC3 decoding</title> | |
630 <para> | |
631 You need an AC3 capable sound card, with digital out (SP/DIF). The card's | |
632 driver must properly support the AFMT_AC3 format (C-Media does). Connect | |
633 your AC3 decoder to the SP/DIF output, and use the <option>-ac | |
634 hwac3</option> option. It is experimental but known to work with C-Media | |
635 cards and Soundblaster Live! + ALSA (but not OSS) drivers and DXR3/Hollywood+ | |
636 MPEG decoder cards. | |
637 </para> | |
638 </sect3> | |
639 | |
640 | |
641 <sect3 id="libmad"> | |
642 <title>libmad support</title> | |
643 | |
644 <para> | |
645 <ulink url="http://mad.sourceforge.net">libmad</ulink> is a multiplatform | |
646 MPEG audio decoding library. It does not handle broken files well, and it | |
647 sometimes has problems with seeking. | |
648 </para> | |
649 | |
650 <para> | |
651 To enable support, compile with the <option>--enable-mad</option> configure | |
652 option. | |
653 </para> | |
654 </sect3> | |
655 | |
656 | |
657 <sect3 id="vivo-audio"> | |
658 <title>VIVO audio</title> | |
659 <para> | |
660 The audio codec used in VIVO files depends on whether it is a VIVO/1.0 or | |
661 VIVO/2.0 file. VIVO/1.0 files have <emphasis role="bold">g.723</emphasis> audio, | |
662 and VIVO/2.0 files have <emphasis role="bold">Vivo Siren</emphasis> audio. Both are | |
663 supported. | |
664 </para> | |
665 </sect3> | |
666 | |
667 | |
668 <sect3 id="realaudio"> | |
669 <title>RealAudio</title> | |
670 | |
671 <para> | |
672 <application>MPlayer</application> supports decoding nearly all versions of | |
673 RealAudio: | |
674 </para> | |
675 | |
676 <itemizedlist> | |
677 <listitem><simpara> | |
678 RealAudio DNET - decoding supported by | |
679 <systemitem class="library">liba52</systemitem> | |
680 </simpara></listitem> | |
681 <listitem><simpara> | |
682 RealAudio Cook/Sipro/ATRAC3 - decoding supported by | |
683 <emphasis role="bold">RealPlayer libraries</emphasis> | |
684 </simpara></listitem> | |
685 </itemizedlist> | |
686 | |
687 <para> | |
688 On how to install RealPlayer libraries, see the | |
689 <link linkend="realmedia">RealMedia file format</link> section. | |
690 </para> | |
691 </sect3> | |
692 | |
693 <sect3 id="qdesign"> | |
694 <title>QDesign codecs</title> | |
695 <para> | |
696 QDesign audio streams (fourcc:<emphasis>QDMC, QDM2</emphasis>) are found | |
697 in MOV/QT files. Both versions of this codec can be decoded with QuickTime | |
698 libraries. For installation instructions please see the | |
699 <link linkend="sorenson">Sorenson video codec</link> section. | |
700 </para> | |
701 </sect3> | |
702 | |
703 <sect3 id="qualcomm"> | |
704 <title>Qualcomm codecs</title> | |
705 <para> | |
706 Qualcomm audio streams (fourcc:<emphasis>Qclp</emphasis>) is found | |
707 in MOV/QT files. It can be decoded with QuickTime | |
708 libraries. For installation instructions please see the | |
709 <link linkend="sorenson">Sorenson video codec</link> section. | |
710 </para> | |
711 </sect3> | |
9802 | 712 |
713 <sect3 id="aac"> | |
714 <title>AAC codec</title> | |
715 <para> | |
716 AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4 | |
717 files. An open source decoder called FAAD is available from | |
718 <ulink url="http://www.audiocoding.com"/>. You can download the second | |
719 generation codec FAAD2 at their <ulink url="http://www.audiocoding.com/download.php"> | |
720 download page</ulink>. Unfortunately FAAD2 1.1 does not compile under Linux, so you | |
10701 | 721 will have to use the CVS version: |
9802 | 722 <screen> |
723 cvs -d:pserver:anonymous@cvs.audiocoding.com:/cvsroot/faac login | |
724 cvs -z3 -d:pserver:anonymous@cvs.audiocoding.com:/cvsroot/faac co faad2 | |
10701 | 725 </screen> |
726 You do not need all of faad2 to decode AAC files, libfaad is enough. Build | |
727 it like this: | |
728 <screen> | |
9802 | 729 cd faad2/ |
730 chmod +x bootstrap | |
731 ./bootstrap | |
10039 | 732 ./configure |
10701 | 733 cd libfaad |
9802 | 734 make |
735 make install | |
736 </screen> | |
737 Binaries are not available from audiocoding.com, but you can (apt-)get Debian | |
738 packages from <ulink url="http://marillat.free.fr">Christian Marillat's homepage</ulink> | |
739 and Mandrake RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink>. | |
740 </para> | |
741 </sect3> | |
742 | |
9675 | 743 </sect2> |
744 | |
745 <!-- ********** --> | |
746 | |
747 <sect2 id="win32-codecs"> | |
748 <title>Win32 codecs importing HOWTO</title> | |
749 | |
750 <!-- TODO: a short paragraph of text would be nice here... --> | |
751 | |
752 <sect3 id="vfw-codecs"> | |
753 <title>VFW codecs</title> | |
754 | |
755 <para> | |
756 VFW (Video for Windows) is the old Video API for Windows. Its codecs have | |
757 the <filename>.DLL</filename> or (rarely) <filename>.DRV</filename> | |
758 extension. If <application>MPlayer</application> fails at playing your AVI | |
759 with this kind of message: | |
760 <screen>UNKNOWN video codec: HFYU (0x55594648)</screen> | |
761 </para> | |
762 | |
763 <para> | |
764 It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = | |
765 HuffYUV codec, DIV3 = DivX Low Motion, etc.). Now that you know this, you | |
766 have to find out which DLL Windows loads in order to play this file. In our | |
767 case, the <filename>system.ini</filename> contains this information in a | |
768 line that reads: | |
769 <programlisting>VIDC.HFYU=huffyuv.dll</programlisting> | |
770 </para> | |
771 | |
772 <para> | |
773 So you need the <filename>huffyuv.dll</filename> file. Note that the audio | |
774 codecs are specified by the MSACM prefix: | |
775 <programlisting>msacm.l3acm=L3codeca.acm</programlisting> | |
776 </para> | |
777 | |
778 <para> | |
779 This is the MP3 codec. Now that you have all the necessary information | |
780 (fourcc, codec file, sample AVI), submit your codec support request by | |
781 mail, and upload these files to the FTP site: | |
782 <systemitem role="url"> | |
783 ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/ | |
784 </systemitem> | |
785 </para> | |
786 | |
787 <note><para>On Windows NT/2000/XP search for this info in the registry, | |
788 e.g. search for "VIDC.HFYU". To find out how to do this, look at | |
789 the old DirectShow method below. | |
790 </para></note> | |
791 </sect3> | |
792 | |
793 | |
794 <sect3 id="dshow-codecs"> | |
795 <title>DirectShow codecs</title> | |
796 | |
797 <para> | |
798 DirectShow is the newer Video API, which is even worse than its predecessor. | |
799 Things are harder with DirectShow, since | |
800 <itemizedlist> | |
801 <listitem><simpara> | |
802 <filename>system.ini</filename> does not contain the needed information, | |
803 instead it is stored in the registry and | |
804 </simpara></listitem> | |
805 <listitem><simpara> | |
806 we need the GUID of the codec. | |
807 </simpara></listitem> | |
808 </itemizedlist> | |
809 </para> | |
810 | |
811 <procedure> | |
812 <title>New Method:</title> | |
813 <para> | |
814 Using <application>Microsoft GraphEdit</application> (fast) | |
815 </para> | |
816 <step><para> | |
817 Get <application>GraphEdit</application> from either DirectX SDK or | |
818 <ulink url="http://doom9.org">doom9</ulink> | |
819 </para></step> | |
820 <step><para> | |
821 Start <command>graphedit.exe</command>. | |
822 </para></step> | |
823 <step><para> | |
824 From the menu select Graph -> Insert Filters. | |
825 </para></step> | |
826 <step><para> | |
827 Expand item <systemitem>DirectShow Filters</systemitem> | |
828 </para></step> | |
829 <step><para> | |
830 Select the right codec name and expand item. | |
831 </para></step> | |
832 <step><para> | |
833 In the entry <systemitem>DisplayName</systemitem> look at the text in | |
834 winged brackets after the backslash and write it down (five dash-delimited | |
835 blocks, the GUID). | |
836 </para></step> | |
837 <step><para> | |
838 The codec binary is the file specified in the <systemitem>Filename</systemitem> | |
839 entry. | |
840 </para></step> | |
841 </procedure> | |
842 | |
843 <note> | |
844 <para> | |
845 If there is no <systemitem>Filename</systemitem> and | |
846 <systemitem>DisplayName</systemitem> contains something like | |
847 <systemitem>device:dmo</systemitem>, then it is a DMO-Codec. | |
848 </para> | |
849 </note> | |
850 | |
851 <procedure> | |
852 <title>Old Method:</title> | |
853 <para> | |
854 Take a deep breath and start searching the registry... | |
855 </para> | |
856 <step><para> | |
857 Start <command>regedit</command>. | |
858 </para></step> | |
859 <step><para> | |
860 Press <keycap>Ctrl</keycap>+<keycap>F</keycap>, disable the first two | |
861 checkboxes, and enable the third. Type in the fourcc of the codec (e.g. | |
862 <userinput>TM20</userinput>). | |
863 </para></step> | |
864 <step><para> | |
865 You should see a field which contains the path and the filename (e.g. | |
866 <filename>C:\WINDOWS\SYSTEM\TM20DEC.AX</filename>). | |
867 </para></step> | |
868 <step><para> | |
869 Now that you have the file, we need the GUID. Try searching again, but | |
870 now search for the codec's name, not the fourcc. Its name can be acquired | |
871 when Media Player is playing the file, by checking | |
872 <guimenu>File</guimenu> -> <guisubmenu>Properties</guisubmenu> -> | |
873 <guimenuitem>Advanced</guimenuitem>. | |
874 If not, you are out of luck. Try guessing (e.g. search for TrueMotion). | |
875 </para></step> | |
876 <step><para> | |
877 If the GUID is found you should see a <guilabel>FriendlyName</guilabel> | |
878 and a <guilabel>CLSID</guilabel> field. Write down the 16 byte CLSID, | |
879 this is the GUID we need. | |
880 </para></step> | |
881 </procedure> | |
882 | |
883 <note> | |
884 <para> | |
885 If searching fails, try enabling all the checkboxes. You may have | |
886 false hits, but you may get lucky... | |
887 </para> | |
888 </note> | |
889 | |
890 <para> | |
891 Now that you have all the necessary information (fourcc, GUID, codec file, | |
892 sample AVI), submit your codec support request by mail, and upload these files | |
893 to the FTP site: | |
894 <systemitem | |
895 role="url">ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/ | |
896 </systemitem> | |
897 </para> | |
898 </sect3> | |
899 </sect2> | |
900 </sect1> |