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