Mercurial > mplayer.hg
annotate DOCS/xml/en/install.xml @ 29419:50589ac2c8cc
Update documentation for libamr replacement by OpenCORE in FFmpeg.
author | diego |
---|---|
date | Thu, 30 Jul 2009 20:10:16 +0000 |
parents | ee46a1af24e4 |
children | 92d75e703bc0 |
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> | |
28387 | 29 <emphasis role="bold">POSIX system</emphasis> - You need a POSIX-compatible |
30 shell and POSIX-compatible system tools like grep, sed, awk, etc. in your | |
31 path. | |
32 </para></listitem> | |
33 <listitem><para> | |
28383 | 34 <emphasis role="bold">GNU make</emphasis> 3.81 or later |
35 </para></listitem> | |
36 <listitem><para> | |
28382 | 37 <emphasis role="bold">binutils</emphasis> - GNU binutils 2.11 or later |
38 is known to work. | |
9675 | 39 </para></listitem> |
40 <listitem><para> | |
28382 | 41 <emphasis role="bold">compiler</emphasis> - We mostly use gcc, the |
42 recommended versions on x86 are 2.95 and 3.4+. On PowerPC, use 4.x+. | |
43 icc 10.1+ is also known to work. | |
21521 | 44 </para></listitem> |
9675 | 45 <listitem><para> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
46 <emphasis role="bold">Xorg/XFree86</emphasis> - recommended version is |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
47 4.3 or later. Make sure the |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
48 <emphasis role="bold">development packages</emphasis> are installed, |
9675 | 49 too, otherwise it won't work. |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
50 You don't absolutely need X, some video output drivers work without it. |
21521 | 51 </para></listitem> |
9675 | 52 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
53 <emphasis role="bold">FreeType</emphasis> - 2.0.9 or later is required |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
54 for the OSD and subtitles |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
55 </para></listitem> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
56 <listitem><para> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
57 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
58 support. At least 0.9.0rc4 is required. |
21521 | 59 </para></listitem> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
60 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
61 <emphasis role="bold">libjpeg</emphasis> - |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
62 required for the optional JPEG video output driver |
21521 | 63 </para></listitem> |
9675 | 64 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
65 <emphasis role="bold">libpng</emphasis> - |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
66 required for the optional PNG video output driver |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
67 </para></listitem> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
68 <listitem><para> |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
69 <emphasis role="bold">directfb</emphasis> - optional, 0.9.13 or later |
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
70 required for the directfb video output driver |
21521 | 71 </para></listitem> |
9675 | 72 <listitem><para> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
73 <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
|
74 necessary for encoding MP3 audio with <application>MEncoder</application>. |
21521 | 75 </para></listitem> |
9675 | 76 <listitem><para> |
27814 | 77 <emphasis role="bold">zlib</emphasis> - recommended, many codecs use it. |
21521 | 78 </para></listitem> |
9675 | 79 <listitem><para> |
17461 | 80 <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
|
81 - optional, needed for some RTSP/RTP streams |
21521 | 82 </para></listitem> |
9675 | 83 <listitem><para> |
84 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support | |
21521 | 85 </para></listitem> |
9675 | 86 <listitem><para> |
87 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin | |
88 support. At least 1.2.7 is required. | |
21521 | 89 </para></listitem> |
10132 | 90 <listitem><para> |
24067
b5724eaab360
Reorder installation requirements list, wording/spelling.
diego
parents:
23208
diff
changeset
|
91 <emphasis role="bold">libsmb</emphasis> - optional, for SMB networking support |
21521 | 92 </para></listitem> |
27813
67b299fcffd1
Move libmad codec installation section to software requirements.
diego
parents:
27631
diff
changeset
|
93 <listitem><para> |
67b299fcffd1
Move libmad codec installation section to software requirements.
diego
parents:
27631
diff
changeset
|
94 <emphasis role="bold"><ulink url="http://www.underbit.com/products/mad/">libmad</ulink></emphasis> |
27832 | 95 - 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
|
96 </para></listitem> |
9675 | 97 </itemizedlist> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
98 </sect1> |
9675 | 99 |
100 | |
21521 | 101 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
102 | |
103 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
104 <sect1 id="features"> |
9675 | 105 <title>Features</title> |
106 | |
107 <itemizedlist> | |
108 <listitem><para> | |
11483 | 109 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link> |
110 section before compiling. | |
21521 | 111 </para></listitem> |
9675 | 112 <listitem><para> |
113 If you want to install <application>MEncoder</application> (our great | |
11540 | 114 all-purpose encoder), see the |
115 <link linkend="mencoder"><application>MEncoder</application></link> section. | |
21521 | 116 </para></listitem> |
9675 | 117 <listitem><para> |
118 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card, | |
21521 | 119 and wish to watch/grab and encode movies with |
120 <application>MPlayer</application>, | |
9675 | 121 read the <link linkend="tv-input">TV input</link> section. |
21521 | 122 </para></listitem> |
9675 | 123 <listitem><para> |
21521 | 124 If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis> |
125 card, and wish to listen and capture sound with | |
126 <application>MPlayer</application>, | |
19583
94e4ef4195d3
Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents:
19568
diff
changeset
|
127 read the <link linkend="radio">radio</link> section. |
21521 | 128 </para></listitem> |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
19082
diff
changeset
|
129 <listitem><para> |
9675 | 130 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be |
131 used. Check the <link linkend="subosd">OSD menu</link> section. | |
21521 | 132 </para></listitem> |
9675 | 133 </itemizedlist> |
134 | |
135 <para> | |
136 Then build <application>MPlayer</application>: | |
137 <screen> | |
138 ./configure | |
139 make | |
21521 | 140 make install |
141 </screen> | |
9675 | 142 </para> |
143 | |
144 <para> | |
23143
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
145 At this point, <application>MPlayer</application> is ready to use. |
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
146 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
|
147 directory at (<filename>~/.mplayer/codecs.conf</filename>) left from old |
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
21725
diff
changeset
|
148 <application>MPlayer</application> versions. If you find one, remove it. |
10403 | 149 </para> |
150 | |
151 <para> | |
9675 | 152 Debian users can build a .deb package for themselves, it's very simple. |
153 Just exec | |
154 <screen>fakeroot debian/rules binary</screen> | |
155 in <application>MPlayer</application>'s root directory. See | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
10913
diff
changeset
|
156 <link linkend="debian">Debian packaging</link> for detailed instructions. |
9675 | 157 </para> |
158 | |
159 <para> | |
160 <emphasis role="bold">Always browse the output of</emphasis> | |
161 <filename>./configure</filename>, and the | |
162 <filename>configure.log</filename> file, they contain information about | |
163 what will be built, and what will not. You may also want to view | |
164 <filename>config.h</filename> and <filename>config.mak</filename> files. | |
165 If you have some libraries installed, but not detected by | |
166 <filename>./configure</filename>, then check if you also have the proper | |
167 header files (usually the -dev packages) and their version matches. The | |
168 <filename>configure.log</filename> file usually tells you what is missing. | |
169 </para> | |
170 | |
171 <para> | |
172 Though not mandatory, the fonts should be installed in order to gain OSD, | |
173 and subtitle functionality. The recommended method is installing a TTF | |
11540 | 174 font file and telling <application>MPlayer</application> to use it. |
175 See the <link linkend="subosd">Subtitles and OSD</link> section for details. | |
9675 | 176 </para> |
177 </sect1> | |
178 | |
21521 | 179 |
180 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
181 | |
9675 | 182 |
183 <sect1 id="gui"> | |
184 <title>What about the GUI?</title> | |
185 | |
186 <para> | |
27631 | 187 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are), |
188 so <systemitem class="library">GTK</systemitem> (and the devel stuff, usually | |
189 called <systemitem class="library">gtk-dev</systemitem>) has to be installed. | |
9675 | 190 You can build it by specifying <option>--enable-gui</option> during |
10000 | 191 <filename>./configure</filename>. Then, to turn on GUI mode, you have to |
192 execute the <command>gmplayer</command> binary. | |
9675 | 193 </para> |
194 | |
195 <para> | |
196 As <application>MPlayer</application> doesn't have a skin included, you | |
27631 | 197 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
|
198 url="http://www.mplayerhq.hu/dload.html">download page</ulink>. |
27631 | 199 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
|
200 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
|
201 class="directory">$HOME/.mplayer/skins</filename>. |
9675 | 202 <application>MPlayer</application> by default looks in these directories |
203 for a directory named <filename class="directory">default</filename>, but | |
204 you can use the <option>-skin <replaceable>newskin</replaceable></option> | |
205 option, or the <literal>skin=newskin</literal> config file directive to use | |
27631 | 206 the skin in the <filename class="directory">*/skins/newskin</filename> |
9675 | 207 directory. |
208 </para> | |
209 </sect1> | |
210 | |
21521 | 211 |
212 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
213 | |
9675 | 214 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
215 <sect1 id="fonts-osd"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
216 <title>Fonts and OSD</title> |
9675 | 217 |
218 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
219 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
|
220 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
|
221 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
|
222 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
|
223 encodings. |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
224 </para> |
9675 | 225 |
21521 | 226 <!-- ********** --> |
19823 | 227 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
228 <sect2 id="truetype-fonts"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
229 <title>TrueType fonts</title> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
230 |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
231 <para> |
19823 | 232 There are two ways to get TrueType fonts to work. The first is to pass |
233 the <option>-font</option> option to specify a TrueType font file on | |
234 the command line. This option will be a good candidate to put in your | |
235 configuration file (see the manual page for details). | |
236 The second is to create a symlink called <filename>subfont.ttf</filename> | |
237 to the font file of your choice. Either | |
21689 | 238 <screen> |
239 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf | |
240 </screen> | |
19823 | 241 for each user individually or a system-wide one: |
21689 | 242 <screen> |
243 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf | |
244 </screen> | |
19823 | 245 </para> |
246 | |
247 <para> | |
248 If <application>MPlayer</application> was compiled with | |
249 <systemitem class="library">fontconfig</systemitem> support, the above methods | |
250 won't work, instead <option>-font</option> expects a | |
251 <systemitem class="library">fontconfig</systemitem> font name | |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
252 and defaults to the sans-serif font. Example: |
21689 | 253 <screen> |
254 mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable> | |
255 </screen> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
256 </para> |
12815 | 257 |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
258 <para> |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
259 To get a list of fonts known to |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
260 <systemitem class="library">fontconfig</systemitem>, |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
261 use <command>fc-list</command>. |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
262 </para> |
19821 | 263 </sect2> |
264 | |
21521 | 265 <!-- ********** --> |
19821 | 266 |
267 <sect2 id="bitmap-fonts"> | |
268 <title>bitmap fonts</title> | |
269 | |
9675 | 270 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
271 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
|
272 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
|
273 <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
|
274 and some sets of fonts |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
275 <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
|
276 in various encodings. |
9675 | 277 </para> |
278 | |
279 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
280 Uncompress the file you downloaded to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
281 <filename class="directory">~/.mplayer</filename> or |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
282 <filename class="directory">$PREFIX/share/mplayer</filename>. |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
283 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
|
284 <filename class="directory">font</filename>, for example: |
21689 | 285 <screen> |
286 ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font | |
287 </screen> | |
288 <screen> | |
289 ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font | |
290 </screen> | |
9737 | 291 </para> |
292 | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
293 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
294 Fonts should have an appropriate <filename>font.desc</filename> file |
26958 | 295 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
|
296 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
|
297 and use the <option>-utf8</option> option or give the subtitles |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
298 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
|
299 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
|
300 </para> |
9675 | 301 </sect2> |
302 | |
21521 | 303 <!-- ********** --> |
9675 | 304 |
305 <sect2 id="osdmenu"> | |
306 <title>OSD menu</title> | |
307 | |
308 <para> | |
26958 | 309 <application>MPlayer</application> has a completely user-definable |
21521 | 310 OSD Menu interface. |
9675 | 311 </para> |
312 | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
313 <note><para> |
9675 | 314 the Preferences menu is currently UNIMPLEMENTED! |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
315 </para></note> |
9675 | 316 |
317 <orderedlist> | |
318 <title>Installation</title> | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
319 <listitem><para> |
21521 | 320 compile <application>MPlayer</application> by passing the |
321 <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
|
322 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
323 <listitem><para> |
9675 | 324 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
|
325 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
326 <listitem><para> |
9675 | 327 copy <filename>etc/menu.conf</filename> to your |
328 <filename class="directory">.mplayer</filename> directory | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
329 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
330 <listitem><para> |
9675 | 331 copy <filename>etc/input.conf</filename> to your |
21521 | 332 <filename class="directory">.mplayer</filename> directory, or to the |
333 system-wide <application>MPlayer</application> config dir (default: | |
9675 | 334 <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
|
335 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
336 <listitem><para> |
9675 | 337 check and edit <filename>input.conf</filename> to enable menu movement keys |
338 (it is described there). | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
339 </para></listitem> |
9675 | 340 <listitem><para> |
341 start <application>MPlayer</application> by the following example: | |
21689 | 342 <screen>mplayer -menu <replaceable>file.avi</replaceable></screen> |
9675 | 343 </para></listitem> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
344 <listitem><para> |
9675 | 345 push any menu key you defined |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21690
diff
changeset
|
346 </para></listitem> |
9675 | 347 </orderedlist> |
348 </sect2> | |
349 </sect1> | |
350 | |
21521 | 351 |
352 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
353 | |
9675 | 354 |
27833
37ee8ca274b8
Consistently use dashes to separate words in section IDs.
diego
parents:
27832
diff
changeset
|
355 <sect1 id="codec-installation"> |
27818
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
356 <title>Codec installation</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 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
359 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
360 <sect2 id="xvid"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
361 <title>Xvid</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
362 |
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 <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
|
365 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
|
366 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
|
367 default as it offers better speed. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
368 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
369 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
370 <procedure> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
371 <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
|
372 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
373 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
|
374 <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
|
375 and the CVS version. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
376 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
|
377 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
|
378 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
|
379 CVS work with <application>MEncoder</application>: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
380 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
381 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
382 <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
|
383 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
384 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
385 <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
|
386 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
387 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
388 <screen>cd xvidcore/build/generic</screen> |
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>./bootstrap.sh && ./configure</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
392 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
|
393 <command>./configure --help</command>). |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
394 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
395 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
396 <screen>make && make install</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
397 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
398 <step><para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
399 Recompile <application>MPlayer</application>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
400 </para></step> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
401 </procedure> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
402 </sect2> |
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 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
405 |
28475
ee46a1af24e4
Use consistent names for codec installation sections.
diego
parents:
28387
diff
changeset
|
406 <sect2 id="x264"> |
27818
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
407 <title><systemitem class="library">x264</systemitem></title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
408 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
409 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
410 <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
|
411 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
|
412 <application>MPlayer</application> sources are updated whenever |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
413 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
|
414 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
|
415 <application>MPlayer</application> from Subversion. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
416 </para> |
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 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
419 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
|
420 sources can be gotten with this command: |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
421 <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
|
422 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
423 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
|
424 <screen>./configure && make && make install</screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
425 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
426 Now rerun <filename>./configure</filename> for |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
427 <application>MPlayer</application> to pick up |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
428 <systemitem class="library">x264</systemitem> support. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
429 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
430 </sect2> |
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 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
433 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
434 <sect2 id="aac"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
435 <title>AAC</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
436 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
437 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
438 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
|
439 <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
|
440 <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
|
441 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
|
442 <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
|
443 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
444 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
445 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
446 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
|
447 Debian packages from |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
448 <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
|
449 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink> |
28114
a1451877ff0e
Update links to RPM packages, now that Livna has merged into RPMFusion.
rathann
parents:
27833
diff
changeset
|
450 and Fedora/CentOS/RHEL RPMs from <ulink url="http://rpmfusion.org/">RPMFusion</ulink>. |
27818
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
451 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
452 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
453 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
|
454 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
|
455 <screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
456 cd faad2/ |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
457 sh bootstrap |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
458 ./configure |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
459 cd libfaad |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
460 make |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
461 make install |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
462 </screen> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
463 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
464 </sect2> |
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 <!-- ********** --> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
467 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
468 <sect2 id="amr"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
469 <title>AMR</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
470 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
471 <para> |
29419
50589ac2c8cc
Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents:
28475
diff
changeset
|
472 MPlayer can use the OpenCORE AMR libraries through FFmpeg. |
50589ac2c8cc
Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents:
28475
diff
changeset
|
473 Download the libraries for AMR-NB and AMR-WB from the |
50589ac2c8cc
Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents:
28475
diff
changeset
|
474 <ulink url="http://sourceforge.net/projects/opencore-amr/">opencore-amr</ulink> |
50589ac2c8cc
Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents:
28475
diff
changeset
|
475 project and install them according to the instructions on that page. |
27818
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
476 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
477 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
478 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
479 <sect2 id="xmms"> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
480 <title>XMMS</title> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
481 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
482 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
483 <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
|
484 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
|
485 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
|
486 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
|
487 <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
|
488 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
489 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
490 <para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
491 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
|
492 <application>MPlayer</application> with |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
493 <filename>./configure --enable-xmms</filename>. |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
494 </para> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
495 </sect2> |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
496 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
497 </sect1> |
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 |
6b0e98eb48e9
Move codec installation instructions from the codecs section to a more
diego
parents:
27816
diff
changeset
|
502 |
9675 | 503 <sect1 id="rtc"> |
504 <title>RTC</title> | |
21521 | 505 |
9675 | 506 <para> |
11540 | 507 There are three timing methods in <application>MPlayer</application>. |
9675 | 508 |
509 <itemizedlist> | |
21690
dbec99c23472
[cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents:
21689
diff
changeset
|
510 <listitem><para> |
21521 | 511 <emphasis role="bold">To use the old method</emphasis>, you don't have to do |
9675 | 512 anything. It uses <systemitem>usleep()</systemitem> to tune |
513 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be | |
514 tuned even finer. | |
21690
dbec99c23472
[cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents:
21689
diff
changeset
|
515 </para></listitem> |
21521 | 516 <listitem> |
517 <para> | |
518 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime | |
519 Clock) for this task, because it has precise 1ms timers. | |
520 The <option>-rtc</option> option enables it, | |
521 but a properly set up kernel is required. | |
9675 | 522 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC |
11668 | 523 frequency for normal users through the <systemitem class="systemname">/proc |
26958 | 524 </systemitem> file system. Use one of the following two commands to |
9675 | 525 enable RTC for normal users: |
526 <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> | |
19969 | 527 <screen>sysctl dev/rtc/max-user-freq=1024</screen> |
528 You can make this setting permanent by adding the latter to | |
529 <filename>/etc/sysctl.conf</filename>. | |
530 </para> | |
531 <para> | |
21521 | 532 You can see the new timer's efficiency in the status line. |
533 The power management functions of some notebook BIOSes with speedstep CPUs | |
534 interact badly with RTC. Audio and video may get out of sync. Plugging the | |
535 external power connector in before you power up your notebook seems to help. | |
536 In some hardware combinations (confirmed during usage of non-DMA DVD drive | |
537 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's | |
538 recommended to use the third method in these cases. | |
539 </para> | |
540 </listitem> | |
541 <listitem><para> | |
9675 | 542 <emphasis role="bold">The third timer code</emphasis> is turned on with the |
543 <option>-softsleep</option> option. It has the efficiency of the RTC, but it | |
544 doesn't use RTC. On the other hand, it requires more CPU. | |
21521 | 545 </para></listitem> |
9675 | 546 </itemizedlist> |
547 </para> | |
548 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
549 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
550 </chapter> |