Mercurial > mplayer.hg
annotate DOCS/xml/en/codecs.xml @ 19581:4a5a0986fc17
ftp.mplayerhq.hu --> upload.mplayerhq.hu
author | diego |
---|---|
date | Mon, 28 Aug 2006 21:50:26 +0000 |
parents | 8332d5ecf5f1 |
children | 10568f10ac2e |
rev | line source |
---|---|
9675 | 1 <?xml version="1.0" encoding="iso-8859-1"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10869
diff
changeset
|
2 <!-- $Revision$ --> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
3 <chapter id="codecs"> |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
4 <title>Codecs</title> |
9675 | 5 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
6 <sect1 id="video-codecs"> |
9675 | 7 <title>Video codecs</title> |
8 | |
9 <para> | |
15316 | 10 See the <ulink url="../../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> | |
14024 | 22 <emphasis role="bold">MPEG-1</emphasis> (<emphasis role="bold">VCD</emphasis>) and |
23 <emphasis role="bold">MPEG-2</emphasis> (<emphasis role="bold">DVD</emphasis>) video | |
9675 | 24 </simpara></listitem> |
25 <listitem><simpara> | |
26 native decoders for <emphasis role="bold">DivX ;-), OpenDivX (DivX4), | |
14024 | 27 DivX 5 (Pro), 3ivX, M$ MPEG-4</emphasis> v1, v2 and other MPEG-4 variants |
9675 | 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> | |
13111 | 53 VIVO 1.0, 2.0, I263 and other <emphasis role="bold">H.263(+)</emphasis> variants |
9675 | 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, | |
14061 | 74 please read the <link linkend="codec-importing">codec importing HOWTO</link> |
9675 | 75 and help us add support for it. |
76 </para> | |
77 | |
78 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
79 <sect2 id="ffmpeg" xreflabel="FFmpeg/libavcodec"> |
11107 | 80 <title>FFmpeg/libavcodec</title> |
9675 | 81 |
82 <para> | |
13977 | 83 <ulink url="http://ffmpeg.org">FFmpeg</ulink> contains an |
9675 | 84 <emphasis role="bold">open source</emphasis> codec package, which is capable |
11089 | 85 of decoding streams with various audio and video codecs. It also offers an |
86 impressing encoding facility and higher speed than the Win32 codecs or the | |
87 DivX.com DivX4/5 libraries! | |
9675 | 88 </para> |
89 | |
90 <para> | |
14024 | 91 It contains a lot of nice codecs, especially important are the MPEG-4 variants: |
10132 | 92 DivX3, DivX4, DivX5, Windows Media Video 7/8 (WMV1/WMV2). Also a very interesting one |
9675 | 93 is the WMA decoder. |
94 </para> | |
95 | |
96 <para> | |
10132 | 97 The most recent codec deserving credit is the <emphasis role="bold">Sorenson 3</emphasis> |
15329 | 98 (SVQ3) codec. This is the first, completely opensource implementation. It is even |
11089 | 99 faster than the original. Be sure to prefer this instead of the binary codec! |
100 </para> | |
101 | |
102 <para> | |
103 For a complete list of supported codecs please visit the FFmpeg homepage. | |
14113 | 104 Supported <ulink url="http://ffmpeg.org/ffmpeg-doc.html#SEC19">video</ulink> |
105 and <ulink url="http://ffmpeg.org/ffmpeg-doc.html#SEC20">audio</ulink> codecs. | |
10132 | 106 </para> |
107 | |
108 <para> | |
18599 | 109 Both <application>MPlayer</application> releases and |
110 <application>MPlayer</application> from Subversion contain | |
111 <systemitem class="library">libavcodec</systemitem> so you don't have | |
112 to care about making a separate <systemitem class="library">libavcodec</systemitem> checkout. | |
113 Just run <filename>configure</filename> and compile. | |
18601
802ec5d54662
</para> tag was accidently deleted and caused compile error
kraymer
parents:
18599
diff
changeset
|
114 </para> |
9675 | 115 |
116 <para> | |
117 With FFmpeg and my Matrox G400, I can view even the highest resolution DivX | |
11042 | 118 movies without dropped frames on my K6-2 500. |
9675 | 119 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
120 </sect2> |
9675 | 121 |
122 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
123 <sect2 id="xanim"> |
9675 | 124 <title>XAnim codecs</title> |
125 | |
126 <note> | |
127 <para> | |
128 Be advised that the XAnim binary codecs are packaged with a piece of text | |
129 claiming to be a legally binding software license which, besides other | |
130 restrictions, forbids the user to use the codecs in conjunction with any | |
131 program other than <application>XAnim</application>. However, the XAnim | |
132 author has yet to bring legal action against anyone for codec-related issues. | |
133 </para> | |
134 </note> | |
135 | |
136 <formalpara> | |
137 <title>INSTALLATION AND USAGE</title> | |
138 <para> | |
139 <application>MPlayer</application> is capable of employing the XAnim codecs | |
140 for decoding. Follow the instructions to enable them: | |
141 </para> | |
142 </formalpara> | |
143 | |
144 <procedure> | |
145 <step><para> | |
146 Download the codecs you wish to use from the | |
19381 | 147 <ulink url="http://xanim.polter.net/">XAnim site</ulink>. |
9683 | 148 The <emphasis role="bold">3ivx</emphasis> codec is not there, but at the |
9675 | 149 <ulink url="http://www.3ivx.com">3ivx site</ulink>. |
150 </para></step> | |
151 <step><para> | |
9683 | 152 <emphasis role="bold">OR</emphasis> download the codecs pack from our |
153 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/">codecs page</ulink> | |
154 </para></step> | |
155 <step><para> | |
9675 | 156 Use the <option>--with-xanimlibdir</option> option to tell |
157 <filename>configure</filename> where | |
158 to find the XAnim codecs. By default, it looks for them at | |
10229 | 159 <filename class="directory">/usr/local/lib/codecs</filename>, |
9675 | 160 <filename class="directory">/usr/local/lib/xanim/mods</filename>, |
161 <filename class="directory">/usr/lib/xanim/mods</filename> and | |
162 <filename class="directory">/usr/lib/xanim</filename>. | |
163 Alternatively you can set the environment variable | |
164 <envar>XANIM_MOD_DIR</envar> to the directory of the XAnim codecs. | |
165 </para></step> | |
166 <step><para> | |
167 Rename/symlink the files, cutting out the architecture stuff, so they | |
168 will have filenames like these: <filename>vid_cvid.xa</filename>, | |
169 <filename>vid_h263.xa</filename>, <filename>vid_iv50.xa</filename> | |
170 </para></step> | |
171 </procedure> | |
172 | |
173 <para> | |
174 XAnim is video codec family <systemitem>xanim</systemitem>, so you may want | |
175 to use the <option>-vfm xanim</option> option to tell <application>MPlayer</application> | |
176 to use them if possible. | |
177 </para> | |
178 | |
179 <para> | |
180 Tested codecs include: <emphasis role="bold">Indeo 3.2, 4.1, 5.0, CVID, 3ivX, | |
13111 | 181 H.263.</emphasis> |
9675 | 182 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
183 </sect2> |
9675 | 184 |
185 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
186 <sect2 id="vivo-video"> |
9675 | 187 <title>VIVO video</title> |
188 <para> | |
189 <application>MPlayer</application> can play Vivo (1.0 and 2.0) videos. The | |
13111 | 190 most suitable codec for 1.0 files is FFmpeg's H.263 decoder, you can use it |
9675 | 191 with the <option>-vc ffh263</option> option. For 2.0 files, use the |
192 Win32 DLL through the <option>-vc vivo</option> option. If you do not supply | |
193 command line options <application>MPlayer</application> selects the best codec | |
194 automatically. | |
195 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
196 </sect2> |
9675 | 197 |
198 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
199 <sect2 id="mpeg12"> |
14024 | 200 <title>MPEG-1/2 video</title> |
9675 | 201 <para> |
14024 | 202 MPEG-1 and MPEG-2 are decoded by the multiplatform native <systemitem |
9675 | 203 class="library">libmpeg2</systemitem> library, whose source code is |
14024 | 204 included in <application>MPlayer</application>. We handle buggy MPEG-1/2 |
9675 | 205 video files by catching <systemitem>Signal 11</systemitem> |
206 (<systemitem>segmentation fault</systemitem>), and quickly | |
207 reinitializing the codec, continuing exactly from where the failure | |
208 occurred. This recovery technique has no measurable speed penalty. | |
209 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
210 </sect2> |
9675 | 211 |
212 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
213 <sect2 id="avicodecs"> |
12759
111a9feec18c
NSV added to formats, cinepak etc codec updates by Roberto Togni.
diego
parents:
12695
diff
changeset
|
214 <title>MS Video1, Cinepak CVID, and other older codecs</title> |
9675 | 215 <para> |
12832 | 216 <application>MPlayer</application> is able to play most of the older codecs |
217 used in AVI and MOV files. | |
12759
111a9feec18c
NSV added to formats, cinepak etc codec updates by Roberto Togni.
diego
parents:
12695
diff
changeset
|
218 In the past they were decoded with binary Win32 codecs, but now we have |
111a9feec18c
NSV added to formats, cinepak etc codec updates by Roberto Togni.
diego
parents:
12695
diff
changeset
|
219 <emphasis role="bold">native codecs</emphasis> for most of them using |
111a9feec18c
NSV added to formats, cinepak etc codec updates by Roberto Togni.
diego
parents:
12695
diff
changeset
|
220 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>. |
9675 | 221 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
222 </sect2> |
9675 | 223 |
224 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
225 <sect2 id="realvideo"> |
9675 | 226 <title>RealVideo</title> |
227 | |
228 <para> | |
229 <application>MPlayer</application> supports decoding all versions of | |
230 RealVideo: | |
231 | |
232 <itemizedlist> | |
233 <listitem><simpara> | |
11555 | 234 RealVideo 1.0, 2.0 (fourcc RV10, RV20) - en/decoding supported by |
9675 | 235 <systemitem class="library">libavcodec</systemitem> |
236 </simpara></listitem> | |
237 <listitem><simpara> | |
11555 | 238 RealVideo 3.0, 4.0 (fourcc RV30, RV40) - decoding supported by |
9675 | 239 <emphasis role="bold">RealPlayer libraries</emphasis> |
240 </simpara></listitem> | |
241 </itemizedlist> | |
242 </para> | |
243 | |
244 <para> | |
12648
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
245 Download Real codecs from |
12832 | 246 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/">http://www.mplayerhq.hu/MPlayer/releases/codecs/</ulink> |
12648
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
247 and extract them to the |
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
248 <filename class="directory">/usr/local/lib/codecs</filename> directory. |
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
249 If you want to store them in a different location, pass the |
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
250 <option>--with-reallibdir</option> option to <command>configure</command>. |
9675 | 251 </para> |
252 | |
253 <note><para> | |
254 <application>RealPlayer</application> libraries currently | |
255 <emphasis role="bold">only work with Linux, FreeBSD, NetBSD and Cygwin on the x86, | |
12648
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
256 Alpha and PowerPC (Linux/Alpha and Linux/PowerPC have been tested) platforms and with Mac OS X</emphasis>. |
9675 | 257 </para></note> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
258 </sect2> |
9675 | 259 |
260 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
261 <sect2 id="xvid"> |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
262 <title>XviD</title> |
9675 | 263 |
264 <para> | |
15710 | 265 <ulink url="http://www.xvid.org">XviD</ulink> is a free software MPEG-4 ASP |
15871 | 266 compliant video codec, which features two pass encoding and full MPEG-4 ASP |
15709 | 267 support, making it a lot more efficient than the well-known DivX codec. |
268 It yields very good video quality and good performance due to CPU | |
269 optimizations for most modern processors. | |
270 </para> | |
271 <para> | |
272 It began as a forked development of the OpenDivX codec. | |
273 This happened when ProjectMayo changed OpenDivX to closed source | |
9675 | 274 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
|
275 then started XviD. So both projects have the same origin. |
9675 | 276 </para> |
277 | |
278 <procedure> | |
15709 | 279 <title>Installing <systemitem class="library">XviD</systemitem></title> |
9675 | 280 <para> |
15709 | 281 Like most open source software, it is available in two flavors: |
282 <ulink url="http://www.xvid.org/downloads.html">official releases</ulink> | |
283 and the CVS version. | |
284 The CVS version is usually stable enough to use, as most of the time it | |
285 features fixes for bugs that exist in releases. | |
286 Here is what to do to make <systemitem class="library">XviD</systemitem> | |
287 CVS work with <application>MEncoder</application> (you need at least | |
16067
f9ffda85aeee
the the auto* tools should be inside an <application></application> tag
gpoirier
parents:
15915
diff
changeset
|
288 <application>autoconf</application> 2.50, |
f9ffda85aeee
the the auto* tools should be inside an <application></application> tag
gpoirier
parents:
15915
diff
changeset
|
289 <application>automake</application> and <application>libtool</application>): |
9675 | 290 </para> |
291 <step><para> | |
292 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen> | |
293 </para></step> | |
294 <step><para> | |
295 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen> | |
296 </para></step> | |
297 <step><para> | |
298 <screen>cd xvidcore/build/generic</screen> | |
299 </para></step> | |
300 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
301 <screen>./bootstrap.sh</screen> |
9675 | 302 </para></step> |
303 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
304 <screen>./configure</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
305 You may have to add some options (examine the output of |
13223
4d3536e69177
- <screen> -> <command>, improves readibility and sense.
wight
parents:
13222
diff
changeset
|
306 <command>./configure --help</command>). |
9675 | 307 </para></step> |
308 <step><para> | |
9720
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
309 <screen>make && make install</screen> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
310 </para></step> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
311 <step><para> |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
312 If you specified <option>--enable-divxcompat</option>, |
5cd40fe6ba7e
Updated XviD CVS instructions by Dmitry Baryshkov <lumag@qnc.ru>.
diego
parents:
9683
diff
changeset
|
313 copy <filename>../../src/divx4.h</filename> to |
9675 | 314 <filename class="directory">/usr/local/include/</filename>. |
315 </para></step> | |
316 <step><para> | |
317 Recompile <application>MPlayer</application> with | |
12000 | 318 <option>--with-xvidlibdir=<replaceable>/path/to/</replaceable>libxvidcore.a</option> |
319 <option>--with-xvidincdir=<replaceable>/path/to/</replaceable>xvid.h</option> | |
9675 | 320 </para></step> |
321 </procedure> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
322 </sect2> |
9675 | 323 |
324 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
325 <sect2 id="sorenson"> |
9675 | 326 <title>Sorenson</title> |
327 | |
328 <para> | |
329 Sorenson is a video codec developed by Sorenson Media and licensed to Apple who | |
330 distribute it with their <application>QuickTime Player</application>. We are | |
331 currently able to decode all version of Sorenson video files with the following | |
10132 | 332 decoders: |
9675 | 333 </para> |
334 | |
335 <itemizedlist> | |
336 <listitem><simpara> | |
10430 | 337 Sorenson Video v1 (fourcc <emphasis>SVQ1</emphasis>) - decoding supported |
338 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
|
339 (<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>) |
9675 | 340 </simpara></listitem> |
341 <listitem><simpara> | |
10430 | 342 Sorenson Video v3 (fourcc <emphasis>SVQ3</emphasis>) - decoding supported by |
343 <emphasis role="bold">native codec</emphasis> | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11758
diff
changeset
|
344 (<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>) |
9675 | 345 </simpara></listitem> |
346 </itemizedlist> | |
347 | |
348 <procedure> | |
9837 | 349 <title>COMPILING MPLAYER WITH QUICKTIME LIBRARIES SUPPORT</title> |
13223
4d3536e69177
- <screen> -> <command>, improves readibility and sense.
wight
parents:
13222
diff
changeset
|
350 <note><para>Currently only 32-bit Intel platforms are supported.</para></note> |
18599 | 351 <step><para>download <application>MPlayer</application> Subversion</para></step> |
9675 | 352 <step><para>download QuickTime DLL pack from |
353 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/> | |
354 </para></step> | |
355 <step><para>extract QuickTime DLL pack to your Win32 codecs directory | |
10188 | 356 (default: <filename class="directory">/usr/local/lib/codecs/</filename>) |
9675 | 357 </para></step> |
11540 | 358 <step><para>compile <application>MPlayer</application></para></step> |
9675 | 359 </procedure> |
360 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
361 </sect2> |
15326 | 362 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
363 <sect2 id="codec-x264"> |
15326 | 364 <title>x264</title> |
365 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
366 <sect3 id="codec-x264-whatis"> |
15326 | 367 <title>What is x264?</title> |
368 <para> | |
369 <systemitem class="library">x264</systemitem> is a library for | |
370 creating H.264 video streams. | |
371 It is not 100% complete, but currently it has at least some kind | |
372 of support for most of the H.264 features which impact quality. | |
373 There are also many advanced features in the H.264 specification | |
374 which have nothing to do with video quality per se; many of these | |
375 are not yet implemented in | |
376 <systemitem class="library">x264</systemitem>. | |
377 </para> | |
378 | |
379 <itemizedlist> | |
380 <title>Encoder features</title> | |
381 <listitem><para>CAVLC/CABAC</para></listitem> | |
382 <listitem><para>Multi-references</para></listitem> | |
17273 | 383 <listitem><para>Intra: all macroblock types (16x16, 8x8, and 4x4 with |
15326 | 384 all predictions)</para></listitem> |
385 <listitem><para>Inter P: all partitions (from 16x16 down to | |
386 4x4)</para></listitem> | |
387 <listitem><para>Inter B: partitions from 16x16 down to 8x8 | |
388 (including SKIP/DIRECT)</para></listitem> | |
389 <listitem><para>Ratecontrol: constant quantizer, constant bitrate, | |
17273 | 390 single or multipass ABR, optional VBV</para></listitem> |
15326 | 391 <listitem><para>Scene cut detection</para></listitem> |
392 <listitem><para>Adaptive B-frame placement</para></listitem> | |
393 <listitem><para>B-frames as references / arbitrary frame | |
394 order</para></listitem> | |
17273 | 395 <listitem><para>8x8 and 4x4 adaptive spatial transform</para></listitem> |
396 <listitem><para>Lossless mode</para></listitem> | |
397 <listitem><para>Custom quantization matrices</para></listitem> | |
398 <listitem><para>Parallel encoding of multiple slices</para></listitem> | |
15326 | 399 </itemizedlist> |
400 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
401 </sect3> |
15326 | 402 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
403 <sect3 id="codec-h264-whatis"> |
15326 | 404 <title>What is H.264?</title> |
405 <para> | |
406 H.264 is one name for a new digital video codec jointly developed | |
407 by the ITU and MPEG. | |
408 It can also be correctly referred to by the cumbersome names of | |
409 "ISO/IEC 14496-10" or "MPEG-4 Part 10". | |
410 More frequently, it is referred to as "MPEG-4 AVC" or just "AVC". | |
411 </para> | |
412 <para> | |
413 Whatever you call it, H.264 may be worth trying because it can | |
414 typically match the quality of MPEG-4 ASP with 5%-30% less | |
415 bitrate. | |
416 Actual results will depend on both the source material and the | |
417 encoder. | |
15370 | 418 The gains from using H.264 do not come for free: Decoding H.264 |
15326 | 419 streams seems to have steep CPU and memory requirements. |
15915 | 420 For instance, on a 1733 MHz Athlon, a DVD-resolution 1500kbps H.264 |
421 video requires around 35% CPU to decode. | |
422 By comparison, decoding a DVD-resolution 1500kbps MPEG-4 ASP stream | |
423 requires around 10% CPU. | |
15326 | 424 This means that decoding high-definition streams is almost out of |
425 the question for most users. | |
426 It also means that even a decent DVD rip may sometimes stutter on | |
427 processors slower than 2.0 GHz or so. | |
428 </para> | |
429 <para> | |
430 At least with <systemitem class="library">x264</systemitem>, | |
431 encoding requirements are not much worse than what you are used to | |
15370 | 432 with MPEG-4 ASP. |
15326 | 433 For instance, on a 1733 MHz Athlon a typical DVD encode would run |
434 at 5-15fps. | |
435 </para> | |
436 <para> | |
437 This document is not intended to explain the details of H.264, | |
438 but if you are interested in a brief overview, you may want to read | |
439 <ulink url="http://www.cdt.luth.se/~peppar/kurs/smd151/spie04-h264OverviewPaper.pdf">The H.264/AVC Advanced Video Coding Standard: Overview and Introduction to the Fidelity Range Extensions</ulink>. | |
440 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
441 </sect3> |
15326 | 442 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
443 <sect3 id="codec-x264-playback"> |
15326 | 444 <title>How can I play H.264 videos with <application>MPlayer</application>?</title> |
445 <para> | |
446 <application>MPlayer</application> uses | |
447 <systemitem class="library">libavcodec</systemitem>'s H.264 | |
448 decoder. | |
449 <systemitem class="library">libavcodec</systemitem> has had at | |
450 least minimally usable H.264 decoding since around July 2004, | |
451 however major changes and improvements have been implemented since | |
452 that time, both in terms of more functionalities supported and in | |
453 terms of improved CPU usage. | |
18599 | 454 Just to be certain, it is always a good idea to use a recent Subversion |
15326 | 455 checkout. |
456 </para> | |
457 <para> | |
458 If you want a quick and easy way to know whether there have been | |
459 recent changes to <systemitem class="library">libavcodec</systemitem>'s | |
460 H.264 decoding, you might keep an eye on | |
18599 | 461 <ulink url="http://svn.mplayerhq.hu/ffmpeg/trunk/libavcodec/h264.c?view=log">FFmpeg Subversion repository's web interface</ulink>. |
15326 | 462 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
463 </sect3> |
15326 | 464 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
465 <sect3 id="codec-x264-encode"> |
15326 | 466 <title>How can I encode videos using <application>MEncoder</application> and <systemitem class="library">x264</systemitem>?</title> |
467 <para> | |
468 If you have the subversion client installed, the latest x264 | |
469 sources can be gotten with this command: | |
470 <screen> | |
16068 | 471 svn co svn://svn.videolan.org/x264/trunk x264<!-- |
472 --></screen> | |
15326 | 473 <application>MPlayer</application> sources are updated whenever |
474 an <systemitem class="library">x264</systemitem> API change | |
18599 | 475 occurs, so it is always suggested to use |
476 <application>MPlayer</application> from Subversion as well. | |
15326 | 477 Perhaps this situation will change when and if an |
478 <systemitem class="library">x264</systemitem> "release" occurs. | |
479 Meanwhile, <systemitem class="library">x264</systemitem> should | |
480 be considered very unstable, in the sense that its programming | |
481 interface is subject to change. | |
482 </para> | |
483 <para> | |
484 <systemitem class="library">x264</systemitem> is built and | |
485 installed in the standard way: | |
486 <screen> | |
16068 | 487 ./configure && make && sudo make install<!-- |
488 --></screen> | |
15326 | 489 This installs libx264.a in /usr/local/lib and x264.h is placed in |
490 /usr/local/include. | |
491 | |
492 With the <systemitem class="library">x264</systemitem> library | |
493 and header placed in the standard locations, building | |
494 <application>MPlayer</application> with | |
495 <systemitem class="library">x264</systemitem> support is easy. | |
496 Just run the standard: | |
497 <screen>./configure && make && sudo make install</screen> | |
498 The configure script will autodetect that you have satisfied the | |
499 requirements for <systemitem class="library">x264</systemitem>. | |
500 </para> | |
501 </sect3> | |
9675 | 502 </sect2> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
503 </sect1> |
9675 | 504 |
505 <!-- ********** --> | |
506 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
507 <sect1 id="audio-codecs"> |
9675 | 508 <title>Audio codecs</title> |
509 | |
510 <itemizedlist> | |
511 <title>The most important audio codecs above all:</title> | |
512 <listitem><simpara> | |
11342 | 513 MPEG layer 1/2/3 (MP1/2/3) audio (<emphasis role="bold">native</emphasis> |
9675 | 514 code, with MMX/SSE/3DNow! optimization) |
515 </simpara></listitem> | |
516 <listitem><simpara> | |
13222 | 517 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
|
518 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>) |
9675 | 519 </simpara></listitem> |
520 <listitem><simpara> | |
521 Windows Media Audio 9 (WMAv3) (using DMO DLL) | |
522 </simpara></listitem> | |
523 <listitem><simpara> | |
524 AC3 Dolby audio (<emphasis role="bold">native</emphasis> code, with | |
525 MMX/SSE/3DNow! optimization) | |
526 </simpara></listitem> | |
527 <listitem><simpara> | |
13532 | 528 AC3 passing through sound card hardware |
9675 | 529 </simpara></listitem> |
530 <listitem><simpara> | |
11342 | 531 AAC |
532 </simpara></listitem> | |
533 <listitem><simpara> | |
9675 | 534 Ogg Vorbis audio codec (<emphasis role="bold">native</emphasis> library) |
535 </simpara></listitem> | |
536 <listitem><simpara> | |
537 RealAudio: DNET (low bitrate AC3), Cook, Sipro and ATRAC3 | |
538 </simpara></listitem> | |
539 <listitem><simpara> | |
540 QuickTime: Qualcomm and QDesign audio codecs | |
541 </simpara></listitem> | |
542 <listitem><simpara> | |
543 VIVO audio (g723, Vivo Siren) | |
544 </simpara></listitem> | |
545 <listitem><simpara> | |
546 Voxware audio (using DirectShow DLL) | |
547 </simpara></listitem> | |
548 <listitem><simpara> | |
549 alaw and ulaw, various gsm, adpcm and pcm formats and other simple old | |
550 audio codecs | |
551 </simpara></listitem> | |
18060
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
552 <listitem><simpara> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
553 Adaptive Multi-Rate (AMR) speech codecs |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
554 </simpara></listitem> |
9675 | 555 </itemizedlist> |
556 | |
557 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
558 <sect2 id="swac3"> |
9675 | 559 <title>Software AC3 decoding</title> |
560 | |
561 <para> | |
562 This is the default decoder used for files with AC3 audio. | |
563 </para> | |
564 | |
565 <para> | |
566 The AC3 decoder can create audio output mixes for 2, 4, or 6 speakers. | |
567 When configured for 6 speakers, this decoder provides separate output of | |
568 all the AC3 channels to the sound driver, allowing for full "surround | |
569 sound" experience without the external AC3 decoder required to use the | |
570 hwac3 codec. | |
571 </para> | |
572 | |
573 <para> | |
574 Use the <option>-channels</option> option to select the number of output | |
575 channels. Use <option>-channels 2</option> for a stereo downmix. For a 4 | |
576 channel downmix (Left Front, Right Front, Left Surround and Right Surround | |
577 outputs), use <option>-channels 4</option>. In this case, any center | |
578 channel will be mixed equally to the front channels. <option>-channels | |
579 6</option> will output all the AC3 channels as they are encoded - in the | |
580 order Left, Right, Left Surround, Right Surround, Center and LFE. | |
581 </para> | |
582 | |
583 <para> | |
584 The default number of output channels is 2. | |
585 </para> | |
586 | |
587 <para> | |
588 To use more than 2 output channels, you will need to use OSS, and have a | |
589 sound card that supports the appropriate number of output channels via the | |
590 SNDCTL_DSP_CHANNELS ioctl. An example of a suitable driver is emu10k1 | |
591 (used by Soundblaster Live! cards) from August 2001 or newer (ALSA CVS is | |
592 also supposed to work). | |
593 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
594 </sect2> |
9675 | 595 |
596 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
597 <sect2 id="hwac3"> |
9675 | 598 <title>Hardware AC3 decoding</title> |
599 <para> | |
12369 | 600 You need an AC3 capable sound card, with digital out (S/PDIF). The card's |
9675 | 601 driver must properly support the AFMT_AC3 format (C-Media does). Connect |
12369 | 602 your AC3 decoder to the S/PDIF output, and use the <option>-ac |
9675 | 603 hwac3</option> option. It is experimental but known to work with C-Media |
604 cards and Soundblaster Live! + ALSA (but not OSS) drivers and DXR3/Hollywood+ | |
605 MPEG decoder cards. | |
606 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
607 </sect2> |
9675 | 608 |
609 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
610 <sect2 id="libmad"> |
9675 | 611 <title>libmad support</title> |
612 | |
613 <para> | |
13977 | 614 <ulink url="http://www.underbit.com/products/mad/">libmad</ulink> is a multiplatform, |
11342 | 615 integer (internally 24bit PCM) only |
9675 | 616 MPEG audio decoding library. It does not handle broken files well, and it |
11342 | 617 sometimes has problems with seeking, but it may perform better on FPU-less |
11343 | 618 (such as <link linkend="arm">ARM</link>) platform than mp3lib. |
9675 | 619 </para> |
620 | |
621 <para> | |
622 To enable support, compile with the <option>--enable-mad</option> configure | |
623 option. | |
624 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
625 </sect2> |
9675 | 626 |
17432 | 627 <sect2 id="hwmpa"> |
628 <title>Hardware MPEG audio codec</title> | |
629 | |
630 <para> | |
631 This codec (selected by -ac hwmpa) passes through MPEG audio packets | |
632 to hardware decoders, such as the ones found in full-featured DVB cards | |
633 and DXR2 adapters. | |
634 Don't use it in combination with any other audio output device | |
635 (such as OSS and ALSA) that isn't able to decode it (you will hear | |
636 only white noise). | |
637 </para> | |
638 </sect2> | |
639 | |
9675 | 640 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
641 <sect2 id="vivo-audio"> |
9675 | 642 <title>VIVO audio</title> |
643 <para> | |
644 The audio codec used in VIVO files depends on whether it is a VIVO/1.0 or | |
645 VIVO/2.0 file. VIVO/1.0 files have <emphasis role="bold">g.723</emphasis> audio, | |
646 and VIVO/2.0 files have <emphasis role="bold">Vivo Siren</emphasis> audio. Both are | |
647 supported. | |
648 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
649 </sect2> |
9675 | 650 |
651 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
652 <sect2 id="realaudio"> |
9675 | 653 <title>RealAudio</title> |
654 | |
655 <para> | |
656 <application>MPlayer</application> supports decoding nearly all versions of | |
657 RealAudio: | |
658 </para> | |
659 | |
660 <itemizedlist> | |
661 <listitem><simpara> | |
662 RealAudio DNET - decoding supported by | |
663 <systemitem class="library">liba52</systemitem> | |
664 </simpara></listitem> | |
665 <listitem><simpara> | |
666 RealAudio Cook/Sipro/ATRAC3 - decoding supported by | |
667 <emphasis role="bold">RealPlayer libraries</emphasis> | |
668 </simpara></listitem> | |
669 </itemizedlist> | |
670 | |
671 <para> | |
12695 | 672 Instructions on how to install the RealPlayer libraries are in the |
12648
c12639f67b24
Real codecs and Mac OS X, don't recommend installing Real player.
diego
parents:
12457
diff
changeset
|
673 <link linkend="realvideo">RealVideo</link> section. |
9675 | 674 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
675 </sect2> |
9675 | 676 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
677 <sect2 id="qdesign"> |
9675 | 678 <title>QDesign codecs</title> |
679 <para> | |
680 QDesign audio streams (fourcc:<emphasis>QDMC, QDM2</emphasis>) are found | |
681 in MOV/QT files. Both versions of this codec can be decoded with QuickTime | |
682 libraries. For installation instructions please see the | |
683 <link linkend="sorenson">Sorenson video codec</link> section. | |
684 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
685 </sect2> |
9675 | 686 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
687 <sect2 id="qualcomm"> |
9675 | 688 <title>Qualcomm codecs</title> |
689 <para> | |
690 Qualcomm audio streams (fourcc:<emphasis>Qclp</emphasis>) is found | |
691 in MOV/QT files. It can be decoded with QuickTime | |
692 libraries. For installation instructions please see the | |
693 <link linkend="sorenson">Sorenson video codec</link> section. | |
694 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
695 </sect2> |
9802 | 696 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
697 <sect2 id="aac"> |
9802 | 698 <title>AAC codec</title> |
699 <para> | |
700 AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4 | |
701 files. An open source decoder called FAAD is available from | |
10766 | 702 <ulink url="http://www.audiocoding.com"/>. |
14658 | 703 <application>MPlayer</application> includes a CVS snapshot of libfaad 2.1 |
704 beta, so you do not need to get it separately. | |
9802 | 705 </para> |
11031 | 706 |
707 <para> | |
708 If you use gcc 3.2 which fails to compile our internal FAAD or want to use | |
709 the external library for some other reason, download the library from the | |
14113 | 710 <ulink url="http://www.audiocoding.com/modules/mydownloads/">download page</ulink> |
13687 | 711 and pass <option>--enable-external-faad</option> to <filename>configure</filename>. |
11031 | 712 You do not need all of faad2 to decode AAC files, libfaad is enough. Build |
713 it like this: | |
714 <screen> | |
715 cd faad2/ | |
14700 | 716 sh bootstrap |
11031 | 717 ./configure |
718 cd libfaad | |
719 make | |
720 make install | |
721 </screen> | |
722 Binaries are not available from audiocoding.com, but you can (apt-)get Debian | |
18820 | 723 packages from <ulink url="http://www.debian-multimedia.org/">Christian Marillat's homepage</ulink>, |
15894 | 724 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink> and RedHat RPMs |
12882 | 725 from <ulink url="http://greysector.rangers.eu.org/">Grey Sector</ulink>. |
11031 | 726 </para> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
727 </sect2> |
9802 | 728 |
18060
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
729 <sect2 id="amr"> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
730 <title>AMR codecs</title> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
731 <para> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
732 Adaptive Multi-Rate speech codec is used in third generation (3G) mobile |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
733 phones. |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
734 Reference implementation is available from |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
735 <ulink url="http://www.3gpp.org">The 3rd Generation Partnership Project</ulink> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
736 (free for private use). |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
737 </para> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
738 <para> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
739 To enable support, download the sources for |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
740 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-6/26_series/26104-610.zip">AMR-NB</ulink> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
741 and |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
742 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-6/26_series/26204-600.zip">AMR-WB</ulink> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
743 codecs, put them in the directory where you unpacked the |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
744 <application>MPlayer</application> source and run the following commands: |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
745 <screen> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
746 unzip 26104-610.zip |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
747 unzip 26104-610_ANSI_C_source_code.zip |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
748 mv c-code libavcodec/amr_float |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
749 unzip 26204-600.zip |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
750 unzip 26204-600_ANSI-C_source_code.zip |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
751 mv c-code libavcodec/amrwb_float |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
752 </screen> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
753 After that, follow the usual <application>MPlayer</application> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
754 <link linkend="features">build procedure</link>. |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
755 </para> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
756 </sect2> |
cbc29633fbee
AMR codecs support info, patch by Rathann, with slight alteration by me.
gpoirier
parents:
17432
diff
changeset
|
757 |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
758 </sect1> |
9675 | 759 |
760 <!-- ********** --> | |
761 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
762 <sect1 id="codec-importing"> |
9675 | 763 <title>Win32 codecs importing HOWTO</title> |
764 | |
765 <!-- TODO: a short paragraph of text would be nice here... --> | |
766 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
767 <sect2 id="vfw-codecs"> |
9675 | 768 <title>VFW codecs</title> |
769 | |
770 <para> | |
771 VFW (Video for Windows) is the old Video API for Windows. Its codecs have | |
772 the <filename>.DLL</filename> or (rarely) <filename>.DRV</filename> | |
773 extension. If <application>MPlayer</application> fails at playing your AVI | |
774 with this kind of message: | |
775 <screen>UNKNOWN video codec: HFYU (0x55594648)</screen> | |
776 </para> | |
777 | |
778 <para> | |
779 It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = | |
780 HuffYUV codec, DIV3 = DivX Low Motion, etc.). Now that you know this, you | |
781 have to find out which DLL Windows loads in order to play this file. In our | |
782 case, the <filename>system.ini</filename> contains this information in a | |
783 line that reads: | |
784 <programlisting>VIDC.HFYU=huffyuv.dll</programlisting> | |
785 </para> | |
786 | |
787 <para> | |
788 So you need the <filename>huffyuv.dll</filename> file. Note that the audio | |
789 codecs are specified by the MSACM prefix: | |
790 <programlisting>msacm.l3acm=L3codeca.acm</programlisting> | |
791 </para> | |
792 | |
793 <para> | |
794 This is the MP3 codec. Now that you have all the necessary information | |
795 (fourcc, codec file, sample AVI), submit your codec support request by | |
796 mail, and upload these files to the FTP site: | |
797 <systemitem role="url"> | |
19581 | 798 ftp://upload.mplayerhq.hu/MPlayer/incoming/[codecname]/ |
9675 | 799 </systemitem> |
800 </para> | |
801 | |
802 <note><para>On Windows NT/2000/XP search for this info in the registry, | |
803 e.g. search for "VIDC.HFYU". To find out how to do this, look at | |
804 the old DirectShow method below. | |
805 </para></note> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
806 </sect2> |
9675 | 807 |
808 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
809 <sect2 id="dshow-codecs"> |
9675 | 810 <title>DirectShow codecs</title> |
811 | |
812 <para> | |
813 DirectShow is the newer Video API, which is even worse than its predecessor. | |
814 Things are harder with DirectShow, since | |
815 <itemizedlist> | |
816 <listitem><simpara> | |
817 <filename>system.ini</filename> does not contain the needed information, | |
818 instead it is stored in the registry and | |
819 </simpara></listitem> | |
820 <listitem><simpara> | |
821 we need the GUID of the codec. | |
822 </simpara></listitem> | |
823 </itemizedlist> | |
824 </para> | |
825 | |
826 <procedure> | |
827 <title>New Method:</title> | |
828 <para> | |
829 Using <application>Microsoft GraphEdit</application> (fast) | |
830 </para> | |
831 <step><para> | |
832 Get <application>GraphEdit</application> from either DirectX SDK or | |
13927 | 833 <ulink url="http://doom9.net">doom9</ulink> |
9675 | 834 </para></step> |
835 <step><para> | |
836 Start <command>graphedit.exe</command>. | |
837 </para></step> | |
838 <step><para> | |
839 From the menu select Graph -> Insert Filters. | |
840 </para></step> | |
841 <step><para> | |
842 Expand item <systemitem>DirectShow Filters</systemitem> | |
843 </para></step> | |
844 <step><para> | |
845 Select the right codec name and expand item. | |
846 </para></step> | |
847 <step><para> | |
848 In the entry <systemitem>DisplayName</systemitem> look at the text in | |
849 winged brackets after the backslash and write it down (five dash-delimited | |
850 blocks, the GUID). | |
851 </para></step> | |
852 <step><para> | |
853 The codec binary is the file specified in the <systemitem>Filename</systemitem> | |
854 entry. | |
855 </para></step> | |
856 </procedure> | |
857 | |
858 <note> | |
859 <para> | |
860 If there is no <systemitem>Filename</systemitem> and | |
861 <systemitem>DisplayName</systemitem> contains something like | |
862 <systemitem>device:dmo</systemitem>, then it is a DMO-Codec. | |
863 </para> | |
864 </note> | |
865 | |
866 <procedure> | |
867 <title>Old Method:</title> | |
868 <para> | |
869 Take a deep breath and start searching the registry... | |
870 </para> | |
871 <step><para> | |
872 Start <command>regedit</command>. | |
873 </para></step> | |
874 <step><para> | |
875 Press <keycap>Ctrl</keycap>+<keycap>F</keycap>, disable the first two | |
876 checkboxes, and enable the third. Type in the fourcc of the codec (e.g. | |
877 <userinput>TM20</userinput>). | |
878 </para></step> | |
879 <step><para> | |
880 You should see a field which contains the path and the filename (e.g. | |
881 <filename>C:\WINDOWS\SYSTEM\TM20DEC.AX</filename>). | |
882 </para></step> | |
883 <step><para> | |
884 Now that you have the file, we need the GUID. Try searching again, but | |
885 now search for the codec's name, not the fourcc. Its name can be acquired | |
886 when Media Player is playing the file, by checking | |
887 <guimenu>File</guimenu> -> <guisubmenu>Properties</guisubmenu> -> | |
888 <guimenuitem>Advanced</guimenuitem>. | |
889 If not, you are out of luck. Try guessing (e.g. search for TrueMotion). | |
890 </para></step> | |
891 <step><para> | |
892 If the GUID is found you should see a <guilabel>FriendlyName</guilabel> | |
893 and a <guilabel>CLSID</guilabel> field. Write down the 16 byte CLSID, | |
894 this is the GUID we need. | |
895 </para></step> | |
896 </procedure> | |
897 | |
898 <note> | |
899 <para> | |
900 If searching fails, try enabling all the checkboxes. You may have | |
901 false hits, but you may get lucky... | |
902 </para> | |
903 </note> | |
904 | |
905 <para> | |
906 Now that you have all the necessary information (fourcc, GUID, codec file, | |
907 sample AVI), submit your codec support request by mail, and upload these files | |
908 to the FTP site: | |
909 <systemitem | |
19581 | 910 role="url">ftp://upload.mplayerhq.hu/MPlayer/incoming/[codecname]/ |
9675 | 911 </systemitem> |
912 </para> | |
14004
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
913 |
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
914 <para> |
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
915 If you want to add a codec yourself, read |
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
916 <ulink url="http://www.mplayerhq.hu/MPlayer/DOCS/tech/codecs.conf.txt">DOCS/tech/codecs.conf.txt</ulink>. |
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
917 </para> |
3d698ac7ec9a
Explain what you need to read to add a codec yourself, patch by
diego
parents:
13977
diff
changeset
|
918 |
9675 | 919 </sect2> |
920 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
921 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17273
diff
changeset
|
922 </chapter> |