Mercurial > mplayer.hg
annotate DOCS/xml/en/codecs.xml @ 10185:d927b21b57c1
/usr/local/lib/codecs is now the default codecs directory.
author | diego |
---|---|
date | Sun, 25 May 2003 19:22:59 +0000 |
parents | c1b56a757f85 |
children | 13a2047cf94e |
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 | |
298 <filename class="directory">/usr/local/lib/xanim/mods</filename>, | |
299 <filename class="directory">/usr/lib/xanim/mods</filename> and | |
300 <filename class="directory">/usr/lib/xanim</filename>. | |
301 Alternatively you can set the environment variable | |
302 <envar>XANIM_MOD_DIR</envar> to the directory of the XAnim codecs. | |
303 </para></step> | |
304 <step><para> | |
305 Rename/symlink the files, cutting out the architecture stuff, so they | |
306 will have filenames like these: <filename>vid_cvid.xa</filename>, | |
307 <filename>vid_h263.xa</filename>, <filename>vid_iv50.xa</filename> | |
308 </para></step> | |
309 </procedure> | |
310 | |
311 <para> | |
312 XAnim is video codec family <systemitem>xanim</systemitem>, so you may want | |
313 to use the <option>-vfm xanim</option> option to tell <application>MPlayer</application> | |
314 to use them if possible. | |
315 </para> | |
316 | |
317 <para> | |
318 Tested codecs include: <emphasis role="bold">Indeo 3.2, 4.1, 5.0, CVID, 3ivX, | |
319 h263.</emphasis> | |
320 </para> | |
321 </sect3> | |
322 | |
323 | |
324 <sect3 id="vivo-video"> | |
325 <title>VIVO video</title> | |
326 <para> | |
327 <application>MPlayer</application> can play Vivo (1.0 and 2.0) videos. The | |
328 most suitable codec for 1.0 files is FFmpeg's H263 decoder, you can use it | |
329 with the <option>-vc ffh263</option> option. For 2.0 files, use the | |
330 Win32 DLL through the <option>-vc vivo</option> option. If you do not supply | |
331 command line options <application>MPlayer</application> selects the best codec | |
332 automatically. | |
333 </para> | |
334 </sect3> | |
335 | |
336 | |
337 <sect3 id="mpeg12"> | |
338 <title>MPEG 1/2 video</title> | |
339 <para> | |
340 MPEG1 and MPEG2 are decoded by the multiplatform native <systemitem | |
341 class="library">libmpeg2</systemitem> library, whose source code is | |
342 included in <application>MPlayer</application>. We handle buggy MPEG 1/2 | |
343 video files by catching <systemitem>Signal 11</systemitem> | |
344 (<systemitem>segmentation fault</systemitem>), and quickly | |
345 reinitializing the codec, continuing exactly from where the failure | |
346 occurred. This recovery technique has no measurable speed penalty. | |
347 </para> | |
348 </sect3> | |
349 | |
350 | |
351 <sect3 id="msvideo1"> | |
352 <title>MS Video1</title> | |
353 <para> | |
354 This is a very old and very bad codec from Microsoft. In the past it was | |
355 decoded with the <filename>msvidc32.dll</filename> Win32 codec, now we have | |
356 our own open source implementation | |
357 (by <ulink url="mailto:melanson@pcisys.net">Mike Melanson</ulink>). | |
358 </para> | |
359 </sect3> | |
360 | |
361 | |
362 <sect3 id="cinepak-cvid"> | |
363 <title>Cinepak CVID</title> | |
364 <para> | |
365 <application>MPlayer</application> uses its own open source, multiplatform | |
366 Cinepak decoder (by <ulink url="mailto:timf@csse.monash.edu.au">Dr. Tim Ferguson</ulink>) | |
367 by default. It supports YUV outputs, so that hardware | |
368 scaling is possible if the video output driver permits it. | |
369 </para> | |
370 </sect3> | |
371 | |
372 | |
373 <sect3 id="realvideo"> | |
374 <title>RealVideo</title> | |
375 | |
376 <para> | |
377 <application>MPlayer</application> supports decoding all versions of | |
378 RealVideo: | |
379 | |
380 <itemizedlist> | |
381 <listitem><simpara> | |
382 RealVideo 1.0 (fourcc RV10) - en/decoding supported by | |
383 <systemitem class="library">libavcodec</systemitem> | |
384 </simpara></listitem> | |
385 <listitem><simpara> | |
386 RealVideo 2.0, 3.0, 4.0 (fourcc RV20, RV30, RV40) - decoding supported by | |
387 <emphasis role="bold">RealPlayer libraries</emphasis> | |
388 </simpara></listitem> | |
389 </itemizedlist> | |
390 </para> | |
391 | |
392 <para> | |
393 It is recommended to download and install <application>RealPlayer8</application> | |
394 or <application>RealONE</application>, because <application>MPlayer</application> | |
395 can use their libraries to decode files with RealVideo 2.0 - 4.0 video. The | |
396 <application>MPlayer</application> <filename>configure</filename> script should | |
397 detect the <application>RealPlayer</application> libraries in the standard | |
398 locations of a full installation. If it does not, tell <filename>configure</filename> | |
399 where to look with the <option>--with-reallibdir</option> option. | |
400 </para> | |
401 | |
402 <note><para> | |
403 <application>RealPlayer</application> libraries currently | |
404 <emphasis role="bold">only work with Linux, FreeBSD, NetBSD and Cygwin on the x86, | |
405 Alpha and PowerPC (Linux/Alpha and Linux/PowerPC have been tested) platforms</emphasis>. | |
406 </para></note> | |
407 </sect3> | |
408 | |
409 | |
410 <sect3 id="xvid"> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
411 <title>XviD</title> |
9675 | 412 |
413 <para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
414 <ulink url="http://www.xvid.org">XviD</ulink> is a forked development of the |
9675 | 415 OpenDivX codec. It happened when ProjectMayo changed OpenDivX to closed source |
416 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
|
417 then started XviD. So both projects have the same origin. |
9675 | 418 |
419 <itemizedlist> | |
420 <title>ADVANTAGES</title> | |
421 <listitem><simpara> | |
422 open source | |
423 </simpara></listitem> | |
424 <listitem><simpara> | |
425 its API is compatible with DivX4 so adding support for it is easy | |
426 </simpara></listitem> | |
427 <listitem><simpara> | |
428 2-pass encoding support | |
429 </simpara></listitem> | |
430 <listitem><simpara> | |
431 nice encoding quality, higher speed than DivX4 (you can optimize it for | |
432 your box while compiling) | |
433 </simpara></listitem> | |
434 </itemizedlist> | |
435 | |
436 <itemizedlist> | |
437 <title>DISADVANTAGES</title> | |
438 <listitem><simpara> | |
439 currently it does not properly <emphasis role="bold">decode</emphasis> all | |
440 DivX/DivX4 files (no problem as <link linkend="ffmpeg">libavcodec</link> | |
441 can play them) | |
442 </simpara></listitem> | |
443 <listitem><simpara> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
444 you have to choose between DivX4 <emphasis role="bold">or</emphasis> XviD |
9675 | 445 support at compiletime |
446 </simpara></listitem> | |
447 <listitem><simpara> | |
448 under development | |
449 </simpara></listitem> | |
450 </itemizedlist> | |
451 </para> | |
452 | |
453 <procedure> | |
454 <title>INSTALLING XVID CVS</title> | |
455 <para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
456 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
|
457 instructions (you need at least autoconf 2.50, automake and libtool): |
9675 | 458 </para> |
459 <step><para> | |
460 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen> | |
461 </para></step> | |
462 <step><para> | |
463 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen> | |
464 </para></step> | |
465 <step><para> | |
466 <screen>cd xvidcore/build/generic</screen> | |
467 </para></step> | |
468 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
469 <screen>./bootstrap.sh</screen> |
9675 | 470 </para></step> |
471 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
472 <screen>./configure</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
473 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
|
474 <screen>./configure --help</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>make && make install</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
478 </para></step> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
479 <step><para> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
480 If you specified <option>--enable-divxcompat</option>, |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
481 copy <filename>../../src/divx4.h</filename> to |
9675 | 482 <filename class="directory">/usr/local/include/</filename>. |
483 </para></step> | |
484 <step><para> | |
485 Recompile <application>MPlayer</application> with | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
486 <option>--with-xvidcore=<replaceable>/path/to/</replaceable>libxvidcore.a</option>. |
9675 | 487 </para></step> |
488 </procedure> | |
489 </sect3> | |
490 | |
491 | |
492 <sect3 id="sorenson"> | |
493 <title>Sorenson</title> | |
494 | |
495 <para> | |
496 Sorenson is a video codec developed by Sorenson Media and licensed to Apple who | |
497 distribute it with their <application>QuickTime Player</application>. We are | |
498 currently able to decode all version of Sorenson video files with the following | |
10132 | 499 decoders: |
9675 | 500 </para> |
501 | |
502 <itemizedlist> | |
503 <listitem><simpara> | |
504 Sorenson 1 (fourcc <emphasis>SVQ1</emphasis>) - decoding supported by | |
505 <emphasis role="bold">native codecs</emphasis>. Actually there are two | |
506 (nearly equal) decoders for SVQ1: one is built in <application>MPlayer</application>, | |
507 the other in libavcodec. You can invoke each of them with the <option>-vc svq1</option> | |
508 and <option>-vc ffsvq1</option> options respectively. Some files may work | |
10132 | 509 with one of them, and not with the other, so test both decoders. |
9675 | 510 </simpara></listitem> |
511 <listitem><simpara> | |
512 Sorenson 3 (fourcc <emphasis>SVQ3</emphasis>) - decoding supported by | |
10132 | 513 <emphasis role="bold">native codec</emphasis> (<link linkend="ffmpeg">libavcodec</link>) |
9675 | 514 </simpara></listitem> |
515 </itemizedlist> | |
516 | |
517 <procedure> | |
9837 | 518 <title>COMPILING MPLAYER WITH QUICKTIME LIBRARIES SUPPORT</title> |
9675 | 519 <note><para>currently only 32bit Intel platforms are supported.</para></note> |
520 <step><para>download MPlayer CVS</para></step> | |
521 <step><para>compile MPlayer with: | |
522 <screen>$ ./configure --enable-qtx-codecs</screen> | |
523 </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 | |
10185
d927b21b57c1
/usr/local/lib/codecs is now the default codecs directory.
diego
parents:
10132
diff
changeset
|
528 (default: <filename class="directory">/usr/local/lib/codecs</filename>) |
9675 | 529 </para></step> |
530 </procedure> | |
531 | |
532 </sect3> | |
533 </sect2> | |
534 | |
535 <!-- ********** --> | |
536 | |
537 <sect2 id="audio-codecs"> | |
538 <title>Audio codecs</title> | |
539 | |
540 <itemizedlist> | |
541 <title>The most important audio codecs above all:</title> | |
542 <listitem><simpara> | |
543 MPEG layer 2 (MP2), and layer 3 (MP3) audio (<emphasis role="bold">native</emphasis> | |
544 code, with MMX/SSE/3DNow! optimization) | |
545 </simpara></listitem> | |
546 <listitem><simpara> | |
547 MPEG layer 1 audio (<emphasis role="bold">native</emphasis> code, with libavcodec) | |
548 </simpara></listitem> | |
549 <listitem><simpara> | |
550 Windows Media Audio v1, v2 (<emphasis role="bold">native</emphasis> code, with | |
551 libavcodec) | |
552 </simpara></listitem> | |
553 <listitem><simpara> | |
554 Windows Media Audio 9 (WMAv3) (using DMO DLL) | |
555 </simpara></listitem> | |
556 <listitem><simpara> | |
557 AC3 Dolby audio (<emphasis role="bold">native</emphasis> code, with | |
558 MMX/SSE/3DNow! optimization) | |
559 </simpara></listitem> | |
560 <listitem><simpara> | |
561 AC3 passing through soundcard hardware | |
562 </simpara></listitem> | |
563 <listitem><simpara> | |
564 Ogg Vorbis audio codec (<emphasis role="bold">native</emphasis> library) | |
565 </simpara></listitem> | |
566 <listitem><simpara> | |
567 RealAudio: DNET (low bitrate AC3), Cook, Sipro and ATRAC3 | |
568 </simpara></listitem> | |
569 <listitem><simpara> | |
570 QuickTime: Qualcomm and QDesign audio codecs | |
571 </simpara></listitem> | |
572 <listitem><simpara> | |
573 VIVO audio (g723, Vivo Siren) | |
574 </simpara></listitem> | |
575 <listitem><simpara> | |
576 Voxware audio (using DirectShow DLL) | |
577 </simpara></listitem> | |
578 <listitem><simpara> | |
579 alaw and ulaw, various gsm, adpcm and pcm formats and other simple old | |
580 audio codecs | |
581 </simpara></listitem> | |
9802 | 582 <listitem><simpara> |
583 AAC | |
584 </simpara></listitem> | |
9675 | 585 </itemizedlist> |
586 | |
587 | |
588 <sect3 id="swac3"> | |
589 <title>Software AC3 decoding</title> | |
590 | |
591 <para> | |
592 This is the default decoder used for files with AC3 audio. | |
593 </para> | |
594 | |
595 <para> | |
596 The AC3 decoder can create audio output mixes for 2, 4, or 6 speakers. | |
597 When configured for 6 speakers, this decoder provides separate output of | |
598 all the AC3 channels to the sound driver, allowing for full "surround | |
599 sound" experience without the external AC3 decoder required to use the | |
600 hwac3 codec. | |
601 </para> | |
602 | |
603 <para> | |
604 Use the <option>-channels</option> option to select the number of output | |
605 channels. Use <option>-channels 2</option> for a stereo downmix. For a 4 | |
606 channel downmix (Left Front, Right Front, Left Surround and Right Surround | |
607 outputs), use <option>-channels 4</option>. In this case, any center | |
608 channel will be mixed equally to the front channels. <option>-channels | |
609 6</option> will output all the AC3 channels as they are encoded - in the | |
610 order Left, Right, Left Surround, Right Surround, Center and LFE. | |
611 </para> | |
612 | |
613 <para> | |
614 The default number of output channels is 2. | |
615 </para> | |
616 | |
617 <para> | |
618 To use more than 2 output channels, you will need to use OSS, and have a | |
619 sound card that supports the appropriate number of output channels via the | |
620 SNDCTL_DSP_CHANNELS ioctl. An example of a suitable driver is emu10k1 | |
621 (used by Soundblaster Live! cards) from August 2001 or newer (ALSA CVS is | |
622 also supposed to work). | |
623 </para> | |
624 </sect3> | |
625 | |
626 | |
627 <sect3 id="hwac3"> | |
628 <title>Hardware AC3 decoding</title> | |
629 <para> | |
630 You need an AC3 capable sound card, with digital out (SP/DIF). The card's | |
631 driver must properly support the AFMT_AC3 format (C-Media does). Connect | |
632 your AC3 decoder to the SP/DIF output, and use the <option>-ac | |
633 hwac3</option> option. It is experimental but known to work with C-Media | |
634 cards and Soundblaster Live! + ALSA (but not OSS) drivers and DXR3/Hollywood+ | |
635 MPEG decoder cards. | |
636 </para> | |
637 </sect3> | |
638 | |
639 | |
640 <sect3 id="libmad"> | |
641 <title>libmad support</title> | |
642 | |
643 <para> | |
644 <ulink url="http://mad.sourceforge.net">libmad</ulink> is a multiplatform | |
645 MPEG audio decoding library. It does not handle broken files well, and it | |
646 sometimes has problems with seeking. | |
647 </para> | |
648 | |
649 <para> | |
650 To enable support, compile with the <option>--enable-mad</option> configure | |
651 option. | |
652 </para> | |
653 </sect3> | |
654 | |
655 | |
656 <sect3 id="vivo-audio"> | |
657 <title>VIVO audio</title> | |
658 <para> | |
659 The audio codec used in VIVO files depends on whether it is a VIVO/1.0 or | |
660 VIVO/2.0 file. VIVO/1.0 files have <emphasis role="bold">g.723</emphasis> audio, | |
661 and VIVO/2.0 files have <emphasis role="bold">Vivo Siren</emphasis> audio. Both are | |
662 supported. | |
663 </para> | |
664 </sect3> | |
665 | |
666 | |
667 <sect3 id="realaudio"> | |
668 <title>RealAudio</title> | |
669 | |
670 <para> | |
671 <application>MPlayer</application> supports decoding nearly all versions of | |
672 RealAudio: | |
673 </para> | |
674 | |
675 <itemizedlist> | |
676 <listitem><simpara> | |
677 RealAudio DNET - decoding supported by | |
678 <systemitem class="library">liba52</systemitem> | |
679 </simpara></listitem> | |
680 <listitem><simpara> | |
681 RealAudio Cook/Sipro/ATRAC3 - decoding supported by | |
682 <emphasis role="bold">RealPlayer libraries</emphasis> | |
683 </simpara></listitem> | |
684 </itemizedlist> | |
685 | |
686 <para> | |
687 On how to install RealPlayer libraries, see the | |
688 <link linkend="realmedia">RealMedia file format</link> section. | |
689 </para> | |
690 </sect3> | |
691 | |
692 <sect3 id="qdesign"> | |
693 <title>QDesign codecs</title> | |
694 <para> | |
695 QDesign audio streams (fourcc:<emphasis>QDMC, QDM2</emphasis>) are found | |
696 in MOV/QT files. Both versions of this codec can be decoded with QuickTime | |
697 libraries. For installation instructions please see the | |
698 <link linkend="sorenson">Sorenson video codec</link> section. | |
699 </para> | |
700 </sect3> | |
701 | |
702 <sect3 id="qualcomm"> | |
703 <title>Qualcomm codecs</title> | |
704 <para> | |
705 Qualcomm audio streams (fourcc:<emphasis>Qclp</emphasis>) is found | |
706 in MOV/QT files. It can be decoded with QuickTime | |
707 libraries. For installation instructions please see the | |
708 <link linkend="sorenson">Sorenson video codec</link> section. | |
709 </para> | |
710 </sect3> | |
9802 | 711 |
712 <sect3 id="aac"> | |
713 <title>AAC codec</title> | |
714 <para> | |
715 AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4 | |
716 files. An open source decoder called FAAD is available from | |
717 <ulink url="http://www.audiocoding.com"/>. You can download the second | |
718 generation codec FAAD2 at their <ulink url="http://www.audiocoding.com/download.php"> | |
719 download page</ulink>. Unfortunately FAAD2 1.1 does not compile under Linux, so you | |
720 will have to use the CVS version. Here's how: | |
721 <screen> | |
722 cvs -d:pserver:anonymous@cvs.audiocoding.com:/cvsroot/faac login | |
723 cvs -z3 -d:pserver:anonymous@cvs.audiocoding.com:/cvsroot/faac co faad2 | |
724 cd faad2/ | |
725 chmod +x bootstrap | |
726 ./bootstrap | |
10039 | 727 ./configure |
9802 | 728 make |
729 make install | |
730 </screen> | |
731 Binaries are not available from audiocoding.com, but you can (apt-)get Debian | |
732 packages from <ulink url="http://marillat.free.fr">Christian Marillat's homepage</ulink> | |
733 and Mandrake RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink>. | |
734 </para> | |
735 </sect3> | |
736 | |
9675 | 737 </sect2> |
738 | |
739 <!-- ********** --> | |
740 | |
741 <sect2 id="win32-codecs"> | |
742 <title>Win32 codecs importing HOWTO</title> | |
743 | |
744 <!-- TODO: a short paragraph of text would be nice here... --> | |
745 | |
746 <sect3 id="vfw-codecs"> | |
747 <title>VFW codecs</title> | |
748 | |
749 <para> | |
750 VFW (Video for Windows) is the old Video API for Windows. Its codecs have | |
751 the <filename>.DLL</filename> or (rarely) <filename>.DRV</filename> | |
752 extension. If <application>MPlayer</application> fails at playing your AVI | |
753 with this kind of message: | |
754 <screen>UNKNOWN video codec: HFYU (0x55594648)</screen> | |
755 </para> | |
756 | |
757 <para> | |
758 It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = | |
759 HuffYUV codec, DIV3 = DivX Low Motion, etc.). Now that you know this, you | |
760 have to find out which DLL Windows loads in order to play this file. In our | |
761 case, the <filename>system.ini</filename> contains this information in a | |
762 line that reads: | |
763 <programlisting>VIDC.HFYU=huffyuv.dll</programlisting> | |
764 </para> | |
765 | |
766 <para> | |
767 So you need the <filename>huffyuv.dll</filename> file. Note that the audio | |
768 codecs are specified by the MSACM prefix: | |
769 <programlisting>msacm.l3acm=L3codeca.acm</programlisting> | |
770 </para> | |
771 | |
772 <para> | |
773 This is the MP3 codec. Now that you have all the necessary information | |
774 (fourcc, codec file, sample AVI), submit your codec support request by | |
775 mail, and upload these files to the FTP site: | |
776 <systemitem role="url"> | |
777 ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/ | |
778 </systemitem> | |
779 </para> | |
780 | |
781 <note><para>On Windows NT/2000/XP search for this info in the registry, | |
782 e.g. search for "VIDC.HFYU". To find out how to do this, look at | |
783 the old DirectShow method below. | |
784 </para></note> | |
785 </sect3> | |
786 | |
787 | |
788 <sect3 id="dshow-codecs"> | |
789 <title>DirectShow codecs</title> | |
790 | |
791 <para> | |
792 DirectShow is the newer Video API, which is even worse than its predecessor. | |
793 Things are harder with DirectShow, since | |
794 <itemizedlist> | |
795 <listitem><simpara> | |
796 <filename>system.ini</filename> does not contain the needed information, | |
797 instead it is stored in the registry and | |
798 </simpara></listitem> | |
799 <listitem><simpara> | |
800 we need the GUID of the codec. | |
801 </simpara></listitem> | |
802 </itemizedlist> | |
803 </para> | |
804 | |
805 <procedure> | |
806 <title>New Method:</title> | |
807 <para> | |
808 Using <application>Microsoft GraphEdit</application> (fast) | |
809 </para> | |
810 <step><para> | |
811 Get <application>GraphEdit</application> from either DirectX SDK or | |
812 <ulink url="http://doom9.org">doom9</ulink> | |
813 </para></step> | |
814 <step><para> | |
815 Start <command>graphedit.exe</command>. | |
816 </para></step> | |
817 <step><para> | |
818 From the menu select Graph -> Insert Filters. | |
819 </para></step> | |
820 <step><para> | |
821 Expand item <systemitem>DirectShow Filters</systemitem> | |
822 </para></step> | |
823 <step><para> | |
824 Select the right codec name and expand item. | |
825 </para></step> | |
826 <step><para> | |
827 In the entry <systemitem>DisplayName</systemitem> look at the text in | |
828 winged brackets after the backslash and write it down (five dash-delimited | |
829 blocks, the GUID). | |
830 </para></step> | |
831 <step><para> | |
832 The codec binary is the file specified in the <systemitem>Filename</systemitem> | |
833 entry. | |
834 </para></step> | |
835 </procedure> | |
836 | |
837 <note> | |
838 <para> | |
839 If there is no <systemitem>Filename</systemitem> and | |
840 <systemitem>DisplayName</systemitem> contains something like | |
841 <systemitem>device:dmo</systemitem>, then it is a DMO-Codec. | |
842 </para> | |
843 </note> | |
844 | |
845 <procedure> | |
846 <title>Old Method:</title> | |
847 <para> | |
848 Take a deep breath and start searching the registry... | |
849 </para> | |
850 <step><para> | |
851 Start <command>regedit</command>. | |
852 </para></step> | |
853 <step><para> | |
854 Press <keycap>Ctrl</keycap>+<keycap>F</keycap>, disable the first two | |
855 checkboxes, and enable the third. Type in the fourcc of the codec (e.g. | |
856 <userinput>TM20</userinput>). | |
857 </para></step> | |
858 <step><para> | |
859 You should see a field which contains the path and the filename (e.g. | |
860 <filename>C:\WINDOWS\SYSTEM\TM20DEC.AX</filename>). | |
861 </para></step> | |
862 <step><para> | |
863 Now that you have the file, we need the GUID. Try searching again, but | |
864 now search for the codec's name, not the fourcc. Its name can be acquired | |
865 when Media Player is playing the file, by checking | |
866 <guimenu>File</guimenu> -> <guisubmenu>Properties</guisubmenu> -> | |
867 <guimenuitem>Advanced</guimenuitem>. | |
868 If not, you are out of luck. Try guessing (e.g. search for TrueMotion). | |
869 </para></step> | |
870 <step><para> | |
871 If the GUID is found you should see a <guilabel>FriendlyName</guilabel> | |
872 and a <guilabel>CLSID</guilabel> field. Write down the 16 byte CLSID, | |
873 this is the GUID we need. | |
874 </para></step> | |
875 </procedure> | |
876 | |
877 <note> | |
878 <para> | |
879 If searching fails, try enabling all the checkboxes. You may have | |
880 false hits, but you may get lucky... | |
881 </para> | |
882 </note> | |
883 | |
884 <para> | |
885 Now that you have all the necessary information (fourcc, GUID, codec file, | |
886 sample AVI), submit your codec support request by mail, and upload these files | |
887 to the FTP site: | |
888 <systemitem | |
889 role="url">ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/ | |
890 </systemitem> | |
891 </para> | |
892 </sect3> | |
893 </sect2> | |
894 </sect1> |