Mercurial > mplayer.hg
annotate DOCS/xml/en/install.xml @ 21689:43f41347aab0
Still some reformatting:
- some (hopefully) more sane linebreaks
- remove stray propmt from example
author | torinthiel |
---|---|
date | Thu, 21 Dec 2006 00:08:23 +0000 |
parents | b210a229fbcb |
children | dbec99c23472 |
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> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
45 <emphasis role="bold">make</emphasis> - recommended version is |
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
46 3.79.x or later. To build the XML documentation you need 3.80. |
21521 | 47 </para></listitem> |
9675 | 48 <listitem><para> |
21356 | 49 <emphasis role="bold">FreeType</emphasis> - optional, |
21379 | 50 required to have a font for the OSD and subtitles. At least 2.0.9 is required. |
21521 | 51 </para></listitem> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
52 <listitem><para> |
21379 | 53 <emphasis role="bold">libjpeg</emphasis> - optional JPEG en/decoder, |
54 required for the JPEG video output driver and decoding MJPEG video | |
21521 | 55 </para></listitem> |
9675 | 56 <listitem><para> |
21356 | 57 <emphasis role="bold">libpng</emphasis> - optional (M)PNG en/decoder, |
58 required for the GUI and the PNG video output driver | |
21521 | 59 </para></listitem> |
9675 | 60 <listitem><para> |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
61 <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
|
62 necessary for encoding MP3 audio with <application>MEncoder</application>. |
21521 | 63 </para></listitem> |
9675 | 64 <listitem><para> |
11324
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
65 <emphasis role="bold">zlib</emphasis> - recommended, necessary for compressed |
21137
1577958ae629
Miscellaneous updates for the introduction and the requirements section.
diego
parents:
20917
diff
changeset
|
66 MOV header and PNG support |
21521 | 67 </para></listitem> |
9675 | 68 <listitem><para> |
17461 | 69 <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
|
70 - optional, needed for some RTSP/RTP streams |
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">directfb</emphasis> - optional, use 0.9.13 or later. |
21521 | 74 </para></listitem> |
9675 | 75 <listitem><para> |
76 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support | |
21521 | 77 </para></listitem> |
9675 | 78 <listitem><para> |
79 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin | |
80 support. At least 1.2.7 is required. | |
21521 | 81 </para></listitem> |
10132 | 82 <listitem><para> |
20917
ed701011923f
libvorbis is not necessary for Vorbis playback, small wording improvement.
diego
parents:
20854
diff
changeset
|
83 <emphasis role="bold">libsmb</emphasis> - optional, for smb networking support |
21521 | 84 </para></listitem> |
12662
05d46af5e2bf
JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents:
12615
diff
changeset
|
85 <listitem><para> |
14310 | 86 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output |
87 support. At least 0.9.0rc4 is required. | |
21521 | 88 </para></listitem> |
9675 | 89 </itemizedlist> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
90 </sect1> |
9675 | 91 |
92 | |
21521 | 93 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
94 | |
95 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
96 <sect1 id="features"> |
9675 | 97 <title>Features</title> |
98 | |
99 <itemizedlist> | |
100 <listitem><para> | |
11483 | 101 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link> |
102 section before compiling. | |
21521 | 103 </para></listitem> |
9675 | 104 <listitem><para> |
105 If you want to install <application>MEncoder</application> (our great | |
11540 | 106 all-purpose encoder), see the |
107 <link linkend="mencoder"><application>MEncoder</application></link> section. | |
21521 | 108 </para></listitem> |
9675 | 109 <listitem><para> |
110 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card, | |
21521 | 111 and wish to watch/grab and encode movies with |
112 <application>MPlayer</application>, | |
9675 | 113 read the <link linkend="tv-input">TV input</link> section. |
21521 | 114 </para></listitem> |
9675 | 115 <listitem><para> |
21521 | 116 If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis> |
117 card, and wish to listen and capture sound with | |
118 <application>MPlayer</application>, | |
19583
94e4ef4195d3
Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents:
19568
diff
changeset
|
119 read the <link linkend="radio">radio</link> section. |
21521 | 120 </para></listitem> |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
19082
diff
changeset
|
121 <listitem><para> |
9675 | 122 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be |
123 used. Check the <link linkend="subosd">OSD menu</link> section. | |
21521 | 124 </para></listitem> |
9675 | 125 </itemizedlist> |
126 | |
127 <para> | |
128 Then build <application>MPlayer</application>: | |
129 <screen> | |
130 ./configure | |
131 make | |
21521 | 132 make install |
133 </screen> | |
9675 | 134 </para> |
135 | |
136 <para> | |
137 At this point, <application>MPlayer</application> is ready to use. The | |
138 directory <filename class="directory">$PREFIX/share/mplayer</filename> | |
139 contains the <filename>codecs.conf</filename> file, which is used to tell | |
10132 | 140 the program all the codecs and their capabilities. This file is needed only |
141 when you want to change its properties, as the main binary contains an internal | |
142 copy of it. Check if you have | |
9675 | 143 <filename>codecs.conf</filename> in your home directory |
144 (<filename>~/.mplayer/codecs.conf</filename>) left from old | |
145 <application>MPlayer</application> versions, and remove it. | |
146 </para> | |
147 | |
148 <para> | |
10403 | 149 Note that if you have a <filename>codecs.conf</filename> in |
150 <filename>~/.mplayer/</filename>, the builtin and system | |
151 <filename>codecs.conf</filename> will be ignored completely. | |
11540 | 152 Do not do this unless you want to fiddle with <application>MPlayer</application> |
153 internals as this can can cause many problems. If you want to change the codecs | |
21521 | 154 search order, use the <option>-vc</option>, <option>-ac</option>, |
155 <option>-vfm</option>, or <option>-afm</option> options either on the command | |
156 line or in your config file (see the manual page). | |
10403 | 157 </para> |
158 | |
159 <para> | |
9675 | 160 Debian users can build a .deb package for themselves, it's very simple. |
161 Just exec | |
162 <screen>fakeroot debian/rules binary</screen> | |
163 in <application>MPlayer</application>'s root directory. See | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
10913
diff
changeset
|
164 <link linkend="debian">Debian packaging</link> for detailed instructions. |
9675 | 165 </para> |
166 | |
167 <para> | |
168 <emphasis role="bold">Always browse the output of</emphasis> | |
169 <filename>./configure</filename>, and the | |
170 <filename>configure.log</filename> file, they contain information about | |
171 what will be built, and what will not. You may also want to view | |
172 <filename>config.h</filename> and <filename>config.mak</filename> files. | |
173 If you have some libraries installed, but not detected by | |
174 <filename>./configure</filename>, then check if you also have the proper | |
175 header files (usually the -dev packages) and their version matches. The | |
176 <filename>configure.log</filename> file usually tells you what is missing. | |
177 </para> | |
178 | |
179 <para> | |
180 Though not mandatory, the fonts should be installed in order to gain OSD, | |
181 and subtitle functionality. The recommended method is installing a TTF | |
11540 | 182 font file and telling <application>MPlayer</application> to use it. |
183 See the <link linkend="subosd">Subtitles and OSD</link> section for details. | |
9675 | 184 </para> |
185 </sect1> | |
186 | |
21521 | 187 |
188 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
189 | |
9675 | 190 |
191 <sect1 id="gui"> | |
192 <title>What about the GUI?</title> | |
193 | |
194 <para> | |
16663 | 195 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are). |
21521 | 196 The skins are stored in PNG format, so GTK, |
197 <systemitem class="library">libpng</systemitem> (and their devel stuff, usually | |
198 called <systemitem class="library">gtk-dev</systemitem> | |
9675 | 199 and <systemitem class="library">libpng-dev</systemitem>) has to be installed. |
200 You can build it by specifying <option>--enable-gui</option> during | |
10000 | 201 <filename>./configure</filename>. Then, to turn on GUI mode, you have to |
202 execute the <command>gmplayer</command> binary. | |
9675 | 203 </para> |
204 | |
205 <para> | |
206 As <application>MPlayer</application> doesn't have a skin included, you | |
207 have to download them 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
|
208 url="http://www.mplayerhq.hu/dload.html">download page</ulink>. |
9675 | 209 They 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
|
210 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
|
211 class="directory">$HOME/.mplayer/skins</filename>. |
9675 | 212 <application>MPlayer</application> by default looks in these directories |
213 for a directory named <filename class="directory">default</filename>, but | |
214 you can use the <option>-skin <replaceable>newskin</replaceable></option> | |
215 option, or the <literal>skin=newskin</literal> config file directive to use | |
17974
9a5a62f480e6
Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents:
17706
diff
changeset
|
216 the skin in <filename class="directory">*/skins/newskin</filename> |
9675 | 217 directory. |
218 </para> | |
219 </sect1> | |
220 | |
21521 | 221 |
222 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
223 | |
9675 | 224 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
225 <sect1 id="fonts-osd"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
226 <title>Fonts and OSD</title> |
9675 | 227 |
228 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
229 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
|
230 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
|
231 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
|
232 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
|
233 encodings. |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
234 </para> |
9675 | 235 |
21521 | 236 <!-- ********** --> |
19823 | 237 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
238 <sect2 id="truetype-fonts"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
239 <title>TrueType fonts</title> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
240 |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
241 <para> |
19823 | 242 There are two ways to get TrueType fonts to work. The first is to pass |
243 the <option>-font</option> option to specify a TrueType font file on | |
244 the command line. This option will be a good candidate to put in your | |
245 configuration file (see the manual page for details). | |
246 The second is to create a symlink called <filename>subfont.ttf</filename> | |
247 to the font file of your choice. Either | |
21689 | 248 <screen> |
249 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf | |
250 </screen> | |
19823 | 251 for each user individually or a system-wide one: |
21689 | 252 <screen> |
253 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf | |
254 </screen> | |
19823 | 255 </para> |
256 | |
257 <para> | |
258 If <application>MPlayer</application> was compiled with | |
259 <systemitem class="library">fontconfig</systemitem> support, the above methods | |
260 won't work, instead <option>-font</option> expects a | |
261 <systemitem class="library">fontconfig</systemitem> font name | |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
262 and defaults to the sans-serif font. Example: |
21689 | 263 <screen> |
264 mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable> | |
265 </screen> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
266 </para> |
12815 | 267 |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
268 <para> |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
269 To get a list of fonts known to |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
270 <systemitem class="library">fontconfig</systemitem>, |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
271 use <command>fc-list</command>. |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
272 </para> |
19821 | 273 </sect2> |
274 | |
21521 | 275 <!-- ********** --> |
19821 | 276 |
277 <sect2 id="bitmap-fonts"> | |
278 <title>bitmap fonts</title> | |
279 | |
9675 | 280 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
281 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
|
282 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
|
283 <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
|
284 and some sets of fonts |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
285 <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
|
286 in various encodings. |
9675 | 287 </para> |
288 | |
289 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
290 Uncompress the file you downloaded to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
291 <filename class="directory">~/.mplayer</filename> or |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
292 <filename class="directory">$PREFIX/share/mplayer</filename>. |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
293 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
|
294 <filename class="directory">font</filename>, for example: |
21689 | 295 <screen> |
296 ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font | |
297 </screen> | |
298 <screen> | |
299 ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font | |
300 </screen> | |
9737 | 301 </para> |
302 | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
303 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
304 Fonts should have an appropriate <filename>font.desc</filename> file |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
305 which maps unicode font positions to the actual code page of the |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
306 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
|
307 and use the <option>-utf8</option> option or give the subtitles |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
308 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
|
309 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
|
310 </para> |
9675 | 311 </sect2> |
312 | |
21521 | 313 <!-- ********** --> |
9675 | 314 |
315 <sect2 id="osdmenu"> | |
316 <title>OSD menu</title> | |
317 | |
318 <para> | |
21521 | 319 <application>MPlayer</application> has a completely user definiable |
320 OSD Menu interface. | |
9675 | 321 </para> |
322 | |
323 <note><simpara> | |
324 the Preferences menu is currently UNIMPLEMENTED! | |
325 </simpara></note> | |
326 | |
327 <orderedlist> | |
328 <title>Installation</title> | |
329 <listitem><simpara> | |
21521 | 330 compile <application>MPlayer</application> by passing the |
331 <option>--enable-menu</option> to <filename>./configure</filename> | |
332 </simpara></listitem> | |
9675 | 333 <listitem><simpara> |
334 make sure you have an OSD font installed | |
21521 | 335 </simpara></listitem> |
9675 | 336 <listitem><simpara> |
337 copy <filename>etc/menu.conf</filename> to your | |
338 <filename class="directory">.mplayer</filename> directory | |
21521 | 339 </simpara></listitem> |
9675 | 340 <listitem><simpara> |
341 copy <filename>etc/input.conf</filename> to your | |
21521 | 342 <filename class="directory">.mplayer</filename> directory, or to the |
343 system-wide <application>MPlayer</application> config dir (default: | |
9675 | 344 <filename class="directory">/usr/local/etc/mplayer</filename>) |
21521 | 345 </simpara></listitem> |
9675 | 346 <listitem><simpara> |
347 check and edit <filename>input.conf</filename> to enable menu movement keys | |
348 (it is described there). | |
21521 | 349 </simpara></listitem> |
9675 | 350 <listitem><para> |
351 start <application>MPlayer</application> by the following example: | |
21689 | 352 <screen>mplayer -menu <replaceable>file.avi</replaceable></screen> |
9675 | 353 </para></listitem> |
354 <listitem><simpara> | |
355 push any menu key you defined | |
21521 | 356 </simpara></listitem> |
9675 | 357 </orderedlist> |
358 </sect2> | |
359 </sect1> | |
360 | |
21521 | 361 |
362 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
363 | |
9675 | 364 |
365 <sect1 id="rtc"> | |
366 <title>RTC</title> | |
21521 | 367 |
9675 | 368 <para> |
11540 | 369 There are three timing methods in <application>MPlayer</application>. |
9675 | 370 |
371 <itemizedlist> | |
372 <listitem><simpara> | |
21521 | 373 <emphasis role="bold">To use the old method</emphasis>, you don't have to do |
9675 | 374 anything. It uses <systemitem>usleep()</systemitem> to tune |
375 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be | |
376 tuned even finer. | |
21521 | 377 </simpara></listitem> |
378 <listitem> | |
379 <para> | |
380 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime | |
381 Clock) for this task, because it has precise 1ms timers. | |
382 The <option>-rtc</option> option enables it, | |
383 but a properly set up kernel is required. | |
9675 | 384 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC |
11668 | 385 frequency for normal users through the <systemitem class="systemname">/proc |
19969 | 386 </systemitem> filesystem. Use one of the following two commands to |
9675 | 387 enable RTC for normal users: |
388 <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> | |
19969 | 389 <screen>sysctl dev/rtc/max-user-freq=1024</screen> |
390 You can make this setting permanent by adding the latter to | |
391 <filename>/etc/sysctl.conf</filename>. | |
392 </para> | |
393 <para> | |
21521 | 394 You can see the new timer's efficiency in the status line. |
395 The power management functions of some notebook BIOSes with speedstep CPUs | |
396 interact badly with RTC. Audio and video may get out of sync. Plugging the | |
397 external power connector in before you power up your notebook seems to help. | |
398 In some hardware combinations (confirmed during usage of non-DMA DVD drive | |
399 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's | |
400 recommended to use the third method in these cases. | |
401 </para> | |
402 </listitem> | |
403 <listitem><para> | |
9675 | 404 <emphasis role="bold">The third timer code</emphasis> is turned on with the |
405 <option>-softsleep</option> option. It has the efficiency of the RTC, but it | |
406 doesn't use RTC. On the other hand, it requires more CPU. | |
21521 | 407 </para></listitem> |
9675 | 408 </itemizedlist> |
409 </para> | |
410 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
411 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
412 </chapter> |