Mercurial > mplayer.hg
annotate DOCS/xml/en/install.xml @ 27832:e78a2facbd7a
Fix typo noticed by Paul TT.
author | diego |
---|---|
date | Thu, 30 Oct 2008 22:40:25 +0000 |
parents | 6b0e98eb48e9 |
children | 37ee8ca274b8 |
rev | line source |
---|---|
20535 | 1 <?xml version="1.0" encoding="utf-8"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10403
diff
changeset
|
2 <!-- $Revision$ --> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
3 <chapter id="install"> |
9675 | 4 <title>Installation</title> |
5 | |
6 <para> | |
11311 | 7 A quick installation guide can be found in the <filename>README</filename> |
8 file. Please read it first and then come back here for the rest of the gory | |
9 details. | |
10 </para> | |
11 | |
12 <para> | |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
13 In this section you will be guided through the compilation and configuration |
9675 | 14 process of <application>MPlayer</application>. It's not easy, but it won't |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
15 necessarily be hard. If you experience a behavior different from this |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
16 description, please search through this documentation and you'll find your |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
17 answers. |
9675 | 18 </para> |
19 | |
21521 | 20 |
21 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
22 | |
23 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
24 <sect1 id="softreq"> |
9675 | 25 <title>Software requirements</title> |
26 | |
27 <itemizedlist> | |
28 <listitem><para> | |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
29 <emphasis role="bold">binutils</emphasis> - recommended version is |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
30 <emphasis role="bold">2.11.x</emphasis>. |
9675 | 31 </para></listitem> |
32 <listitem><para> | |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
33 <emphasis role="bold">gcc</emphasis> - recommended versions are 2.95 |
20850 | 34 and 3.4+. 2.96 and 3.0.x are known to generate faulty code, 3.1 and |
20854
44102c48069a
Restore PowerPC gcc note that I mistakenly removed.
diego
parents:
20850
diff
changeset
|
35 3.2 also had problems, 3.3 some minor ones. On PowerPC, use 4.x. |
21521 | 36 </para></listitem> |
9675 | 37 <listitem><para> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
38 <emphasis role="bold">Xorg/XFree86</emphasis> - recommended version is |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
39 4.3 or later. Make sure the |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
40 <emphasis role="bold">development packages</emphasis> are installed, |
9675 | 41 too, otherwise it won't work. |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
42 You don't absolutely need X, some video output drivers work without it. |
21521 | 43 </para></listitem> |
9675 | 44 <listitem><para> |
27816 | 45 <emphasis role="bold">GNU make</emphasis> 3.81 |
21521 | 46 </para></listitem> |
9675 | 47 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
48 <emphasis role="bold">FreeType</emphasis> - 2.0.9 or later is required |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
49 for the OSD and subtitles |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
50 </para></listitem> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
51 <listitem><para> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
52 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
53 support. At least 0.9.0rc4 is required. |
21521 | 54 </para></listitem> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
55 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
56 <emphasis role="bold">libjpeg</emphasis> - |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
57 required for the optional JPEG video output driver |
21521 | 58 </para></listitem> |
9675 | 59 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
60 <emphasis role="bold">libpng</emphasis> - |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
61 required for the optional PNG video output driver |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
62 </para></listitem> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
63 <listitem><para> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
64 <emphasis role="bold">directfb</emphasis> - optional, 0.9.13 or later |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
65 required for the directfb video output driver |
21521 | 66 </para></listitem> |
9675 | 67 <listitem><para> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
68 <emphasis role="bold">lame</emphasis> - 3.90 or later is recommended, |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
69 necessary for encoding MP3 audio with <application>MEncoder</application>. |
21521 | 70 </para></listitem> |
9675 | 71 <listitem><para> |
27814 | 72 <emphasis role="bold">zlib</emphasis> - recommended, many codecs use it. |
21521 | 73 </para></listitem> |
9675 | 74 <listitem><para> |
17461 | 75 <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
76 - optional, needed for some RTSP/RTP streams |
21521 | 77 </para></listitem> |
9675 | 78 <listitem><para> |
79 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support | |
21521 | 80 </para></listitem> |
9675 | 81 <listitem><para> |
82 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin | |
83 support. At least 1.2.7 is required. | |
21521 | 84 </para></listitem> |
10132 | 85 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
86 <emphasis role="bold">libsmb</emphasis> - optional, for SMB networking support |
21521 | 87 </para></listitem> |
27813
67b299fcffd1
Move libmad codec installation section to software requirements.
diego
parents:
27631
diff
changeset
|
88 <listitem><para> |
67b299fcffd1
Move libmad codec installation section to software requirements.
diego
parents:
27631
diff
changeset
|
89 <emphasis role="bold"><ulink url="http://www.underbit.com/products/mad/">libmad</ulink></emphasis> |
27832 | 90 - optional, for fast integer-only MP3 decoding on FPU-less platforms |
27813
67b299fcffd1
Move libmad codec installation section to software requirements.
diego
parents:
27631
diff
changeset
|
91 </para></listitem> |
9675 | 92 </itemizedlist> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
93 </sect1> |
9675 | 94 |
95 | |
21521 | 96 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
97 | |
98 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
99 <sect1 id="features"> |
9675 | 100 <title>Features</title> |
101 | |
102 <itemizedlist> | |
103 <listitem><para> | |
11483 | 104 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link> |
105 section before compiling. | |
21521 | 106 </para></listitem> |
9675 | 107 <listitem><para> |
108 If you want to install <application>MEncoder</application> (our great | |
11540 | 109 all-purpose encoder), see the |
110 <link linkend="mencoder"><application>MEncoder</application></link> section. | |
21521 | 111 </para></listitem> |
9675 | 112 <listitem><para> |
113 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card, | |
21521 | 114 and wish to watch/grab and encode movies with |
115 <application>MPlayer</application>, | |
9675 | 116 read the <link linkend="tv-input">TV input</link> section. |
21521 | 117 </para></listitem> |
9675 | 118 <listitem><para> |
21521 | 119 If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis> |
120 card, and wish to listen and capture sound with | |
121 <application>MPlayer</application>, | |
19583
94e4ef4195d3
Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents:
19568
diff
changeset
|
122 read the <link linkend="radio">radio</link> section. |
21521 | 123 </para></listitem> |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
19082
diff
changeset
|
124 <listitem><para> |
9675 | 125 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be |
126 used. Check the <link linkend="subosd">OSD menu</link> section. | |
21521 | 127 </para></listitem> |
9675 | 128 </itemizedlist> |
129 | |
130 <para> | |
131 Then build <application>MPlayer</application>: | |
132 <screen> | |
133 ./configure | |
134 make | |
21521 | 135 make install |
136 </screen> | |
9675 | 137 </para> |
138 | |
139 <para> | |
23143
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
140 At this point, <application>MPlayer</application> is ready to use. |
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
141 Check if you have a <filename>codecs.conf</filename> file in your home |
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
142 directory at (<filename>~/.mplayer/codecs.conf</filename>) left from old |
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
143 <application>MPlayer</application> versions. If you find one, remove it. |
10403 | 144 </para> |
145 | |
146 <para> | |
9675 | 147 Debian users can build a .deb package for themselves, it's very simple. |
148 Just exec | |
149 <screen>fakeroot debian/rules binary</screen> | |
150 in <application>MPlayer</application>'s root directory. See | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
10913
diff
changeset
|
151 <link linkend="debian">Debian packaging</link> for detailed instructions. |
9675 | 152 </para> |
153 | |
154 <para> | |
155 <emphasis role="bold">Always browse the output of</emphasis> | |
156 <filename>./configure</filename>, and the | |
157 <filename>configure.log</filename> file, they contain information about | |
158 what will be built, and what will not. You may also want to view | |
159 <filename>config.h</filename> and <filename>config.mak</filename> files. | |
160 If you have some libraries installed, but not detected by | |
161 <filename>./configure</filename>, then check if you also have the proper | |
162 header files (usually the -dev packages) and their version matches. The | |
163 <filename>configure.log</filename> file usually tells you what is missing. | |
164 </para> | |
165 | |
166 <para> | |
167 Though not mandatory, the fonts should be installed in order to gain OSD, | |
168 and subtitle functionality. The recommended method is installing a TTF | |
11540 | 169 font file and telling <application>MPlayer</application> to use it. |
170 See the <link linkend="subosd">Subtitles and OSD</link> section for details. | |
9675 | 171 </para> |
172 </sect1> | |
173 | |
21521 | 174 |
175 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
176 | |
9675 | 177 |
178 <sect1 id="gui"> | |
179 <title>What about the GUI?</title> | |
180 | |
181 <para> | |
27631 | 182 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are), |
183 so <systemitem class="library">GTK</systemitem> (and the devel stuff, usually | |
184 called <systemitem class="library">gtk-dev</systemitem>) has to be installed. | |
9675 | 185 You can build it by specifying <option>--enable-gui</option> during |
10000 | 186 <filename>./configure</filename>. Then, to turn on GUI mode, you have to |
187 execute the <command>gmplayer</command> binary. | |
9675 | 188 </para> |
189 | |
190 <para> | |
191 As <application>MPlayer</application> doesn't have a skin included, you | |
27631 | 192 have to download one if you want to use the GUI. See the <ulink |
17706
83c1acef76d5
New website structure, the /homepage subdirectory is gone.
diego
parents:
17461
diff
changeset
|
193 url="http://www.mplayerhq.hu/dload.html">download page</ulink>. |
27631 | 194 It should be extracted to the usual system-wide directory (<filename |
17974
9a5a62f480e6
Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents:
17706
diff
changeset
|
195 class="directory">$PREFIX/share/mplayer/skins</filename>), or to <filename |
9a5a62f480e6
Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents:
17706
diff
changeset
|
196 class="directory">$HOME/.mplayer/skins</filename>. |
9675 | 197 <application>MPlayer</application> by default looks in these directories |
198 for a directory named <filename class="directory">default</filename>, but | |
199 you can use the <option>-skin <replaceable>newskin</replaceable></option> | |
200 option, or the <literal>skin=newskin</literal> config file directive to use | |
27631 | 201 the skin in the <filename class="directory">*/skins/newskin</filename> |
9675 | 202 directory. |
203 </para> | |
204 </sect1> | |
205 | |
21521 | 206 |
207 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
208 | |
9675 | 209 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
210 <sect1 id="fonts-osd"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
211 <title>Fonts and OSD</title> |
9675 | 212 |
213 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
214 You need to tell <application>MPlayer</application> which font to use to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
215 enjoy OSD and subtitles. Any TrueType font or special bitmap fonts will |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
216 work. However, TrueType fonts are recommended as they look far better, |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
217 can be properly scaled to the movie size and cope better with different |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
218 encodings. |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
219 </para> |
9675 | 220 |
21521 | 221 <!-- ********** --> |
19823 | 222 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
223 <sect2 id="truetype-fonts"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
224 <title>TrueType fonts</title> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
225 |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
226 <para> |
19823 | 227 There are two ways to get TrueType fonts to work. The first is to pass |
228 the <option>-font</option> option to specify a TrueType font file on | |
229 the command line. This option will be a good candidate to put in your | |
230 configuration file (see the manual page for details). | |
231 The second is to create a symlink called <filename>subfont.ttf</filename> | |
232 to the font file of your choice. Either | |
21689 | 233 <screen> |
234 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf | |
235 </screen> | |
19823 | 236 for each user individually or a system-wide one: |
21689 | 237 <screen> |
238 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf | |
239 </screen> | |
19823 | 240 </para> |
241 | |
242 <para> | |
243 If <application>MPlayer</application> was compiled with | |
244 <systemitem class="library">fontconfig</systemitem> support, the above methods | |
245 won't work, instead <option>-font</option> expects a | |
246 <systemitem class="library">fontconfig</systemitem> font name | |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
247 and defaults to the sans-serif font. Example: |
21689 | 248 <screen> |
249 mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable> | |
250 </screen> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
251 </para> |
12815 | 252 |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
253 <para> |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
254 To get a list of fonts known to |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
255 <systemitem class="library">fontconfig</systemitem>, |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
256 use <command>fc-list</command>. |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
257 </para> |
19821 | 258 </sect2> |
259 | |
21521 | 260 <!-- ********** --> |
19821 | 261 |
262 <sect2 id="bitmap-fonts"> | |
263 <title>bitmap fonts</title> | |
264 | |
9675 | 265 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
266 If for some reason you wish or need to employ bitmap fonts, download a set |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
267 from our homepage. You can choose between various |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
268 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/fonts/">ISO fonts</ulink> |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
269 and some sets of fonts |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
270 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/fonts/">contributed by users</ulink> |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
271 in various encodings. |
9675 | 272 </para> |
273 | |
274 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
275 Uncompress the file you downloaded to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
276 <filename class="directory">~/.mplayer</filename> or |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
277 <filename class="directory">$PREFIX/share/mplayer</filename>. |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
278 Then rename or symlink one of the extracted directories to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
279 <filename class="directory">font</filename>, for example: |
21689 | 280 <screen> |
281 ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font | |
282 </screen> | |
283 <screen> | |
284 ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font | |
285 </screen> | |
9737 | 286 </para> |
287 | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
288 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
289 Fonts should have an appropriate <filename>font.desc</filename> file |
26958 | 290 which maps Unicode font positions to the actual code page of the |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
291 subtitle text. Another solution is to have UTF-8-encoded subtitles |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
292 and use the <option>-utf8</option> option or give the subtitles |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
293 file the same name as your video file with a <filename>.utf</filename> |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
294 extension and have it in the same directory as the video file. |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
295 </para> |
9675 | 296 </sect2> |
297 | |
21521 | 298 <!-- ********** --> |
9675 | 299 |
300 <sect2 id="osdmenu"> | |
301 <title>OSD menu</title> | |
302 | |
303 <para> | |
26958 | 304 <application>MPlayer</application> has a completely user-definable |
21521 | 305 OSD Menu interface. |
9675 | 306 </para> |
307 | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
308 <note><para> |
9675 | 309 the Preferences menu is currently UNIMPLEMENTED! |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
310 </para></note> |
9675 | 311 |
312 <orderedlist> | |
313 <title>Installation</title> | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
314 <listitem><para> |
21521 | 315 compile <application>MPlayer</application> by passing the |
316 <option>--enable-menu</option> to <filename>./configure</filename> | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
317 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
318 <listitem><para> |
9675 | 319 make sure you have an OSD font installed |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
320 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
321 <listitem><para> |
9675 | 322 copy <filename>etc/menu.conf</filename> to your |
323 <filename class="directory">.mplayer</filename> directory | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
324 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
325 <listitem><para> |
9675 | 326 copy <filename>etc/input.conf</filename> to your |
21521 | 327 <filename class="directory">.mplayer</filename> directory, or to the |
328 system-wide <application>MPlayer</application> config dir (default: | |
9675 | 329 <filename class="directory">/usr/local/etc/mplayer</filename>) |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
330 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
331 <listitem><para> |
9675 | 332 check and edit <filename>input.conf</filename> to enable menu movement keys |
333 (it is described there). | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
334 </para></listitem> |
9675 | 335 <listitem><para> |
336 start <application>MPlayer</application> by the following example: | |
21689 | 337 <screen>mplayer -menu <replaceable>file.avi</replaceable></screen> |
9675 | 338 </para></listitem> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
339 <listitem><para> |
9675 | 340 push any menu key you defined |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
341 </para></listitem> |
9675 | 342 </orderedlist> |
343 </sect2> | |
344 </sect1> | |
345 | |
21521 | 346 |
347 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
348 | |
9675 | 349 |
27818
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
350 <sect1 id="codec_installation"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
351 <title>Codec installation</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
352 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
353 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
354 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
355 <sect2 id="xvid"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
356 <title>Xvid</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
357 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
358 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
359 <ulink url="http://www.xvid.org">Xvid</ulink> is a free software MPEG-4 ASP |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
360 compliant video codec. Note that Xvid is not necessary to decode Xvid-encoded |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
361 video. <systemitem class="library">libavcodec</systemitem> is used by |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
362 default as it offers better speed. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
363 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
364 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
365 <procedure> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
366 <title>Installing <systemitem class="library">Xvid</systemitem></title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
367 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
368 Like most open source software, it is available in two flavors: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
369 <ulink url="http://www.xvid.org/downloads.html">official releases</ulink> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
370 and the CVS version. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
371 The CVS version is usually stable enough to use, as most of the time it |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
372 features fixes for bugs that exist in releases. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
373 Here is what to do to make <systemitem class="library">Xvid</systemitem> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
374 CVS work with <application>MEncoder</application>: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
375 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
376 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
377 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
378 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
379 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
380 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
381 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
382 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
383 <screen>cd xvidcore/build/generic</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
384 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
385 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
386 <screen>./bootstrap.sh && ./configure</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
387 You may have to add some options (examine the output of |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
388 <command>./configure --help</command>). |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
389 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
390 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
391 <screen>make && make install</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
392 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
393 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
394 Recompile <application>MPlayer</application>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
395 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
396 </procedure> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
397 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
398 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
399 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
400 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
401 <sect2 id="codec-x264"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
402 <title><systemitem class="library">x264</systemitem></title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
403 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
404 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
405 <ulink url="http://developers.videolan.org/x264.html"><systemitem class="library">x264</systemitem></ulink> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
406 is a library for creating H.264 video. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
407 <application>MPlayer</application> sources are updated whenever |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
408 an <systemitem class="library">x264</systemitem> API change |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
409 occurs, so it is always suggested to use |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
410 <application>MPlayer</application> from Subversion. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
411 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
412 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
413 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
414 If you have a GIT client installed, the latest x264 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
415 sources can be gotten with this command: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
416 <screen>git clone git://git.videolan.org/x264.git</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
417 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
418 Then build and install in the standard way: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
419 <screen>./configure && make && make install</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
420 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
421 Now rerun <filename>./configure</filename> for |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
422 <application>MPlayer</application> to pick up |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
423 <systemitem class="library">x264</systemitem> support. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
424 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
425 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
426 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
427 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
428 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
429 <sect2 id="aac"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
430 <title>AAC</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
431 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
432 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
433 An open source AAC decoder called FAAD2 is available from |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
434 <ulink url="http://www.audiocoding.com/downloads.html"/>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
435 <application>MPlayer</application> includes a copy of it in its source tree. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
436 If you want to use the external library instead, install it and pass |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
437 <option>--enable-faad-external</option> to <filename>./configure</filename>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
438 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
439 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
440 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
441 FAAD2 binaries are not available from audiocoding.com, but you can (apt-)get |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
442 Debian packages from |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
443 <ulink url="http://www.debian-multimedia.org/">Christian Marillat</ulink>, |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
444 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
445 and Fedora RPMs from <ulink url="http://rpm.livna.org/">Livna</ulink>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
446 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
447 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
448 If you choose to build from source, you do not need all of FAAD2 to decode |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
449 AAC files, libfaad is enough. Build it like this: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
450 <screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
451 cd faad2/ |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
452 sh bootstrap |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
453 ./configure |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
454 cd libfaad |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
455 make |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
456 make install |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
457 </screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
458 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
459 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
460 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
461 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
462 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
463 <sect2 id="amr"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
464 <title>AMR</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
465 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
466 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
467 Adaptive Multi-Rate speech codec is used in third generation (3G) mobile |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
468 phones. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
469 Reference implementation is available from |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
470 <ulink url="http://www.3gpp.org">The 3rd Generation Partnership Project</ulink> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
471 (free for private use). |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
472 To enable support, download and install support libraries for |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
473 <ulink url="http://www.penguin.cz/~utx/amr">AMR-NB and AMR-WB</ulink> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
474 following the instructions on that page. Recompile MPlayer afterwards. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
475 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
476 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
477 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
478 <sect2 id="xmms"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
479 <title>XMMS</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
480 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
481 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
482 <application>MPlayer</application> can use <application>XMMS</application> input |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
483 plugins to play many file formats. There are plugins for SNES game tunes, SID |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
484 tunes (from Commodore 64), many Amiga formats, .xm, .it, VQF, Musepack, Bonk, |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
485 shorten and many others. You can find them at the |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
486 <ulink url="http://www.xmms.org/plugins.php?category=input">XMMS input plugin page</ulink>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
487 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
488 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
489 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
490 For this feature you need to have <application>XMMS</application> and compile |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
491 <application>MPlayer</application> with |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
492 <filename>./configure --enable-xmms</filename>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
493 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
494 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
495 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
496 </sect1> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
497 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
498 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
499 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
500 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
501 |
9675 | 502 <sect1 id="rtc"> |
503 <title>RTC</title> | |
21521 | 504 |
9675 | 505 <para> |
11540 | 506 There are three timing methods in <application>MPlayer</application>. |
9675 | 507 |
508 <itemizedlist> | |
21690
dbec99c23472
[cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents:
21689
diff
changeset
|
509 <listitem><para> |
21521 | 510 <emphasis role="bold">To use the old method</emphasis>, you don't have to do |
9675 | 511 anything. It uses <systemitem>usleep()</systemitem> to tune |
512 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be | |
513 tuned even finer. | |
21690
dbec99c23472
[cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents:
21689
diff
changeset
|
514 </para></listitem> |
21521 | 515 <listitem> |
516 <para> | |
517 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime | |
518 Clock) for this task, because it has precise 1ms timers. | |
519 The <option>-rtc</option> option enables it, | |
520 but a properly set up kernel is required. | |
9675 | 521 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC |
11668 | 522 frequency for normal users through the <systemitem class="systemname">/proc |
26958 | 523 </systemitem> file system. Use one of the following two commands to |
9675 | 524 enable RTC for normal users: |
525 <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> | |
19969 | 526 <screen>sysctl dev/rtc/max-user-freq=1024</screen> |
527 You can make this setting permanent by adding the latter to | |
528 <filename>/etc/sysctl.conf</filename>. | |
529 </para> | |
530 <para> | |
21521 | 531 You can see the new timer's efficiency in the status line. |
532 The power management functions of some notebook BIOSes with speedstep CPUs | |
533 interact badly with RTC. Audio and video may get out of sync. Plugging the | |
534 external power connector in before you power up your notebook seems to help. | |
535 In some hardware combinations (confirmed during usage of non-DMA DVD drive | |
536 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's | |
537 recommended to use the third method in these cases. | |
538 </para> | |
539 </listitem> | |
540 <listitem><para> | |
9675 | 541 <emphasis role="bold">The third timer code</emphasis> is turned on with the |
542 <option>-softsleep</option> option. It has the efficiency of the RTC, but it | |
543 doesn't use RTC. On the other hand, it requires more CPU. | |
21521 | 544 </para></listitem> |
9675 | 545 </itemizedlist> |
546 </para> | |
547 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
548 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
549 </chapter> |