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