annotate DOCS/xml/en/codecs.xml @ 21721:6be31bc59a0e

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