Mercurial > mplayer.hg
annotate DOCS/xml/en/install.xml @ 21018:51575db8d5c0
fix wrong 60000/10001 fraction
author | kraymer |
---|---|
date | Sat, 18 Nov 2006 17:25:25 +0000 |
parents | ed701011923f |
children | 1577958ae629 |
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> | |
9675 | 13 In this section I'll try to guide you through the compiling and configuring |
14 process of <application>MPlayer</application>. It's not easy, but it won't | |
15 necessarily be hard. If you experience a different behavior than what I | |
16 explain, please search through this documentation and you'll find your | |
17 answers. If you see links, please follow them and read carefully what they | |
9677 | 18 contain. It will take some time, but it IS worth it. |
9675 | 19 </para> |
20 | |
21 <para> | |
22 You need a fairly recent system. On Linux, 2.4.x kernels are recommended. | |
23 </para> | |
24 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
25 <sect1 id="softreq"> |
9675 | 26 <title>Software requirements</title> |
27 | |
28 <itemizedlist> | |
29 <listitem><para> | |
19968 | 30 <emphasis role="bold">binutils</emphasis> - Recommended version is <emphasis role="bold">2.11.x</emphasis>. |
9675 | 31 This program is responsible for generating MMX/ 3DNow!/etc instructions, |
32 thus very important. | |
33 </para></listitem> | |
34 <listitem><para> | |
19968 | 35 <emphasis role="bold">gcc</emphasis> - Recommended versions are 2.95 |
20850 | 36 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
|
37 3.2 also had problems, 3.3 some minor ones. On PowerPC, use 4.x. |
9675 | 38 </para></listitem> |
39 <listitem><para> | |
19968 | 40 <emphasis role="bold">XFree86</emphasis> - Recommended version is <emphasis role="bold">always the |
10132 | 41 newest</emphasis> (4.3). Normally, everyone wants this, as starting |
9675 | 42 with XFree86 4.0.2, it contains the <link linkend="xv">XVideo</link> |
43 extension (somewhere referred to as <emphasis role="bold">Xv</emphasis>) | |
44 which is needed to enable the hardware YUV acceleration (fast image display) | |
45 on cards that support it. | |
46 Make sure its <emphasis role="bold">development package</emphasis> is installed, | |
47 too, otherwise it won't work. | |
48 For some video cards you don't need XFree86. See list below. | |
49 </para></listitem> | |
50 <listitem><para> | |
19968 | 51 <emphasis role="bold">make</emphasis> - Recommended version is |
9675 | 52 <emphasis role="bold">always the newest</emphasis> (at least 3.79.x). This |
53 usually isn't important. | |
54 </para></listitem> | |
55 <listitem><para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
56 <emphasis role="bold">FreeType</emphasis> 2.0.9 or later is required |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
57 to have a font for the OSD and subtitles. |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
58 </para></listitem> |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
59 <listitem><para> |
9675 | 60 <emphasis role="bold">SDL</emphasis> - it's not mandatory, but can help in |
61 some cases (bad audio, video cards that lag strangely with the xv driver). | |
62 Always use the newest (beginning from 1.2.x). | |
63 </para></listitem> | |
64 <listitem><para> | |
65 <emphasis role="bold">libjpeg</emphasis> - optional JPEG decoder, used by the <option>-mf</option> | |
11324
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
66 option and some QT MOV files. Useful for both <application>MPlayer</application> |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
67 and <application>MEncoder</application> if |
9675 | 68 you plan to work with jpeg files. |
69 </para></listitem> | |
70 <listitem><para> | |
71 <emphasis role="bold">libpng</emphasis> - recommended and default (M)PNG decoder. Required for GUI. | |
72 Useful for both <application>MPlayer</application> and | |
73 <application>MEncoder</application>. | |
74 </para></listitem> | |
75 <listitem><para> | |
76 <emphasis role="bold">lame</emphasis> - recommended, needed for encoding MP3 audio with | |
19968 | 77 <application>MEncoder</application>, recommended version is |
9675 | 78 <emphasis>always the newest</emphasis> (at least 3.90). |
79 </para></listitem> | |
80 <listitem><para> | |
11324
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
81 <emphasis role="bold">zlib</emphasis> - recommended, necessary for compressed |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
82 MOV header and PNG support. |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
83 </para></listitem> |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
84 <listitem><para> |
9675 | 85 <emphasis role="bold">libogg</emphasis> - optional, needed for playing OGG file format. |
86 </para></listitem> | |
87 <listitem><para> | |
17461 | 88 <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis> |
9675 | 89 - optional, needed for playing RTSP/RTP streams. |
90 </para></listitem> | |
91 <listitem><para> | |
92 <emphasis role="bold">directfb</emphasis> - optional, from | |
14048 | 93 <ulink url="http://www.directfb.org"/>. At least 0.9.13 is required. |
9675 | 94 </para></listitem> |
95 <listitem><para> | |
96 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support | |
97 </para></listitem> | |
98 <listitem><para> | |
99 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin | |
100 support. At least 1.2.7 is required. | |
101 </para></listitem> | |
10132 | 102 <listitem><para> |
20917
ed701011923f
libvorbis is not necessary for Vorbis playback, small wording improvement.
diego
parents:
20854
diff
changeset
|
103 <emphasis role="bold">libsmb</emphasis> - optional, for smb networking support |
10132 | 104 </para></listitem> |
12662
05d46af5e2bf
JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents:
12615
diff
changeset
|
105 <listitem><para> |
14310 | 106 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output |
107 support. At least 0.9.0rc4 is required. | |
108 </para></listitem> | |
9675 | 109 </itemizedlist> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
110 </sect1> |
9675 | 111 |
112 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
113 <sect1 id="video-cards"> |
9675 | 114 <title>Video cards</title> |
115 | |
116 <para> | |
117 There are generally two kind of video cards. One kind (the newer cards) has | |
118 <emphasis role="bold">hardware scaling and YUV acceleration</emphasis> support, | |
119 the other cards don't. | |
120 </para> | |
121 | |
122 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
123 <sect2 id="yuv-cards"> |
9675 | 124 <title>YUV cards</title> |
125 | |
126 <para> | |
127 They can display and scale (zoom) the picture to any size that fits in | |
128 their memory, with <emphasis role="bold">small CPU usage</emphasis> (even when | |
129 zooming), thus fullscreen is nice and very fast. | |
12815 | 130 |
9675 | 131 <itemizedlist> |
132 <listitem><para> | |
133 <emphasis role="bold">Matrox G200/G400/G450/G550 cards</emphasis>: although a | |
134 <link linkend="vidix">Vidix driver</link> is provided, it is recommended to | |
135 use the mga_vid module instead, for it works much better. | |
136 Please see the <link linkend="mga_vid">mga_vid</link> section about its | |
137 installation and usage. It is important to do these steps | |
138 <emphasis>before</emphasis> compiling <application>MPlayer</application>, | |
139 otherwise no mga_vid support will be built. Also check out the | |
11394 | 140 <link linkend="tvout-mga-g400">Matrox TV-out</link> section. |
9675 | 141 <emphasis role="bold"> If you don't use Linux</emphasis>, your only |
9683 | 142 possibility is the VIDIX driver: read the <link linkend="vidix">VIDIX</link> section. |
9675 | 143 </para></listitem> |
144 <listitem><para> | |
145 <emphasis role="bold">3Dfx Voodoo3/Banshee cards</emphasis>: please see | |
146 <link linkend="tdfxfb">tdfxfb</link> section in order to gain big speedup. | |
147 It is important to do these steps <emphasis role="bold">before</emphasis> | |
148 compiling <application>MPlayer</application>, otherwise no 3Dfx support will be | |
19734
c7f185b2639b
Remove tvout-voodoo section that only consists of one broken link.
diego
parents:
19730
diff
changeset
|
149 built. |
9675 | 150 If you use X, use at least <emphasis role="bold">4.2.0</emphasis>, as 3dfx Xv |
151 driver was broken in 4.1.0, and earlier releases. | |
152 </para></listitem> | |
153 <listitem><para> | |
154 <emphasis role="bold">ATI cards</emphasis>: <link linkend="vidix">VIDIX</link> | |
155 driver is provided for the following cards: | |
156 <emphasis role="bold">Radeon, Rage128, Mach64</emphasis> (Rage XL/Mobility, Xpert98). | |
11483 | 157 Also see the <link linkend="tvout-ati">ATI cards</link> section of the TV-out documentation, |
9675 | 158 to know if you card's TV-out is supported under Linux/<application>MPlayer</application>. |
159 </para></listitem> | |
160 <listitem><para> | |
161 <emphasis role="bold">S3 cards</emphasis>: the Savage and Virge/DX chips have | |
162 hardware acceleration. Use as new XFree86 version as possible, older drivers are | |
11483 | 163 buggy. Savage chips have problems with YV12 display, see <link linkend="s3">S3 Xv</link> |
164 section for details. Older, Trio cards have no, or slow hardware support. | |
9675 | 165 </para></listitem> |
166 <listitem><para> | |
9683 | 167 <emphasis role="bold">nVidia cards</emphasis>: may or may not be good choice for video playing. |
9675 | 168 If you do not have a GeForce2 (or newer) card, it's not likely to work without bugs. |
9683 | 169 <emphasis role="bold">the built-in nVidia driver in XFree86 does not support |
170 hardware YUV acceleration on all nVidia cards.</emphasis> You have | |
12815 | 171 to download nVidia's closed-source drivers from <ulink url="http://nvidia.com">nVidia.com</ulink>. |
11461 | 172 See the <link linkend="nvidia">nVidia Xv driver</link> section for details. Please also check |
11483 | 173 the <link linkend="tvout-nvidia">nVidia TV-out</link> section if you wish to |
9675 | 174 use a TV. |
175 </para></listitem> | |
176 <listitem><para> | |
177 <emphasis role="bold">3DLabs GLINT R3 and Permedia3</emphasis>: a VIDIX driver | |
178 is provided (pm3_vid). Please see the <link linkend="vidix">VIDIX</link> section | |
179 for details. | |
180 </para></listitem> | |
181 <listitem><para> | |
182 <emphasis role="bold">Other cards</emphasis>: none of the above? | |
183 <itemizedlist> | |
184 <listitem><simpara> | |
185 Try if the XFree86 driver (and your card) supports hardware | |
11483 | 186 acceleration. See the <link linkend="xv">Xv</link> section for details. |
9675 | 187 </simpara></listitem> |
188 <listitem><simpara> | |
189 If it doesn't, then your card's video features aren't supported under | |
9683 | 190 your operating system :( If hardware scaling works under Windows, it |
191 doesn't mean it will work under Linux or other operating system, it depends on | |
192 the drivers. Most manufacturers neither make Linux drivers nor release | |
193 specifications of their chips - so you are unlucky if using their cards. | |
9675 | 194 See <xref linkend="non-yuv-cards"/>. |
195 </simpara></listitem> | |
196 </itemizedlist> | |
197 </para></listitem> | |
198 </itemizedlist> | |
199 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
200 </sect2> |
9675 | 201 |
202 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
203 <sect2 id="non-yuv-cards" xreflabel="Non-YUV cards"> |
9675 | 204 <title>Non-YUV cards</title> |
205 | |
206 <para> | |
207 Fullscreen playing can be achieved by either enabling <emphasis role="bold"> | |
9683 | 208 software scaling</emphasis> (use the <option>-zoom</option> or <option>-vf</option> option, |
11501 | 209 but I warn you: this is slow), or switching to a smaller video mode, for example |
9675 | 210 352x288. If you don't have YUV acceleration, this latter method is recommended. |
211 Video mode switching can be enabled by using the <option>-vm</option> option and | |
212 it works with the following drivers: | |
213 <itemizedlist> | |
214 <listitem><simpara> | |
215 <emphasis role="bold">using</emphasis> XFree86: see details in <link linkend="dga">DGA driver</link> and | |
216 <link linkend="x11">X11 driver</link> sections. DGA is recommended! Also | |
217 try DGA via SDL, sometimes it's better. | |
218 </simpara></listitem> | |
219 <listitem><simpara> | |
220 <emphasis role="bold">not using</emphasis> XFree86: try the drivers in the | |
221 following order: | |
222 <link linkend="vesa">vesa</link>, | |
223 <link linkend="fbdev">fbdev</link>, | |
224 <link linkend="svgalib">svgalib</link>, | |
225 <link linkend="aalib">aalib</link>. | |
226 </simpara></listitem> | |
227 </itemizedlist> | |
228 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
229 </sect2> |
9675 | 230 |
231 <!-- FIXME: find a more logical organization for this section --> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
232 <sect2 id="cirrus-logic-cards" xreflabel="Cirrus-Logic cards"> |
9675 | 233 <title>Cirrus-Logic cards</title> |
234 <itemizedlist> | |
235 <listitem><para> | |
236 GD 7548: present on-board and tested in Compaq Armada 41xx notebook series. | |
237 <itemizedlist> | |
238 <listitem><simpara> | |
239 XFree86 3: works in 8/16bpp modes. However, the driver is dramatically slow | |
240 and buggy in 800x600@16bpp. <emphasis role="bold">Recommended: 640x480@16bpp</emphasis> | |
241 </simpara></listitem> | |
242 <listitem><simpara> | |
243 XFree86 4: the Xserver freezes soon after start unless acceleration is | |
244 disabled, but then the whole thing gets slower than XFree86 3. No XVideo. | |
245 </simpara></listitem> | |
246 <listitem><simpara> | |
247 FBdev: framebuffer can be turned on with the <systemitem>clgenfb</systemitem> | |
248 driver in the kernel, though for me it worked only in 8bpp, thus unusable. | |
249 The clgenfb source had to be extended with the 7548 ID before compilation. | |
250 </simpara></listitem> | |
251 <listitem><simpara> | |
252 VESA: the card is only VBE 1.2 capable, so VESA output can't be used. Can't | |
253 be workarounded with UniVBE. | |
254 </simpara></listitem> | |
255 <listitem><simpara> | |
256 SVGAlib: detects an older Cirrus chip. Usable but slow with | |
257 <option>-bpp 8</option>. | |
258 </simpara></listitem> | |
259 </itemizedlist> | |
260 </para></listitem> | |
261 </itemizedlist> | |
262 </sect2> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
263 </sect1> |
9675 | 264 |
265 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
266 <sect1 id="sound-cards"> |
9675 | 267 <title>Sound cards</title> |
268 | |
269 <itemizedlist> | |
270 <listitem><simpara> | |
271 <emphasis role="bold">Soundblaster Live!</emphasis>: with this card you can use | |
9683 | 272 4 or 6 (<emphasis role="bold">5.1</emphasis>) channels AC3 decoding instead of 2. Read the |
9675 | 273 <link linkend="swac3">Software AC3 decoding</link> section. For hardware AC3 |
9683 | 274 passthrough you <emphasis role="bold">must</emphasis> use ALSA 0.9 with OSS emulation! |
9675 | 275 </simpara></listitem> |
276 <listitem><simpara> | |
12369 | 277 <emphasis role="bold">C-Media with S/PDIF out</emphasis>: hardware AC3 |
9675 | 278 passthrough is possible with these cards, see |
279 <link linkend="hwac3">Hardware AC3 decoding</link> section. | |
280 </simpara></listitem> | |
281 <listitem><simpara> | |
282 Features of <emphasis role="bold">other cards</emphasis> aren't supported by | |
283 <application>MPlayer</application>. <emphasis role="bold">It's very recommended | |
13912
c66b1514ce5b
Remove pointless devices section, make video and audio top level sections.
diego
parents:
13111
diff
changeset
|
284 to read the <link linkend="audio">sound card</link> section!</emphasis> |
9675 | 285 </simpara></listitem> |
286 </itemizedlist> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
287 </sect1> |
9675 | 288 |
289 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
290 <sect1 id="features"> |
9675 | 291 <title>Features</title> |
292 | |
293 <itemizedlist> | |
294 <listitem><para> | |
11483 | 295 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link> |
296 section before compiling. | |
9675 | 297 </para></listitem> |
298 <listitem><para> | |
299 If you want to install <application>MEncoder</application> (our great | |
11540 | 300 all-purpose encoder), see the |
301 <link linkend="mencoder"><application>MEncoder</application></link> section. | |
9675 | 302 </para></listitem> |
303 <listitem><para> | |
304 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card, | |
305 and wish to watch/grab and encode movies with <application>MPlayer</application>, | |
306 read the <link linkend="tv-input">TV input</link> section. | |
307 </para></listitem> | |
308 <listitem><para> | |
19583
94e4ef4195d3
Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents:
19568
diff
changeset
|
309 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
|
310 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
|
311 read the <link linkend="radio">radio</link> section. |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
19082
diff
changeset
|
312 </para></listitem> |
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
19082
diff
changeset
|
313 <listitem><para> |
9675 | 314 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be |
315 used. Check the <link linkend="subosd">OSD menu</link> section. | |
316 </para></listitem> | |
317 </itemizedlist> | |
318 | |
319 <para> | |
320 Then build <application>MPlayer</application>: | |
321 <screen> | |
322 ./configure | |
323 make | |
324 make install</screen> | |
325 </para> | |
326 | |
327 <para> | |
328 At this point, <application>MPlayer</application> is ready to use. The | |
329 directory <filename class="directory">$PREFIX/share/mplayer</filename> | |
330 contains the <filename>codecs.conf</filename> file, which is used to tell | |
10132 | 331 the program all the codecs and their capabilities. This file is needed only |
332 when you want to change its properties, as the main binary contains an internal | |
333 copy of it. Check if you have | |
9675 | 334 <filename>codecs.conf</filename> in your home directory |
335 (<filename>~/.mplayer/codecs.conf</filename>) left from old | |
336 <application>MPlayer</application> versions, and remove it. | |
337 </para> | |
338 | |
339 <para> | |
10403 | 340 Note that if you have a <filename>codecs.conf</filename> in |
341 <filename>~/.mplayer/</filename>, the builtin and system | |
342 <filename>codecs.conf</filename> will be ignored completely. | |
11540 | 343 Do not do this unless you want to fiddle with <application>MPlayer</application> |
344 internals as this can can cause many problems. If you want to change the codecs | |
345 search order, use the <option>-vc</option>, <option>-ac</option>, <option>-vfm</option>, | |
10403 | 346 or <option>-afm</option> options either on the command line or in your |
347 config file (see the manual page). | |
348 </para> | |
349 | |
350 | |
351 <para> | |
9675 | 352 Debian users can build a .deb package for themselves, it's very simple. |
353 Just exec | |
354 <screen>fakeroot debian/rules binary</screen> | |
355 in <application>MPlayer</application>'s root directory. See | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
10913
diff
changeset
|
356 <link linkend="debian">Debian packaging</link> for detailed instructions. |
9675 | 357 </para> |
358 | |
359 <para> | |
360 <emphasis role="bold">Always browse the output of</emphasis> | |
361 <filename>./configure</filename>, and the | |
362 <filename>configure.log</filename> file, they contain information about | |
363 what will be built, and what will not. You may also want to view | |
364 <filename>config.h</filename> and <filename>config.mak</filename> files. | |
365 If you have some libraries installed, but not detected by | |
366 <filename>./configure</filename>, then check if you also have the proper | |
367 header files (usually the -dev packages) and their version matches. The | |
368 <filename>configure.log</filename> file usually tells you what is missing. | |
369 </para> | |
370 | |
371 <para> | |
372 Though not mandatory, the fonts should be installed in order to gain OSD, | |
373 and subtitle functionality. The recommended method is installing a TTF | |
11540 | 374 font file and telling <application>MPlayer</application> to use it. |
375 See the <link linkend="subosd">Subtitles and OSD</link> section for details. | |
9675 | 376 </para> |
377 | |
378 </sect1> | |
379 | |
380 <!-- ********** --> | |
381 | |
382 <sect1 id="gui"> | |
383 <title>What about the GUI?</title> | |
384 | |
385 <para> | |
16663 | 386 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are). |
387 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
|
388 (and their devel stuff, usually called <systemitem class="library">gtk-dev</systemitem> |
9675 | 389 and <systemitem class="library">libpng-dev</systemitem>) has to be installed. |
390 You can build it by specifying <option>--enable-gui</option> during | |
10000 | 391 <filename>./configure</filename>. Then, to turn on GUI mode, you have to |
392 execute the <command>gmplayer</command> binary. | |
9675 | 393 </para> |
394 | |
395 <para> | |
396 As <application>MPlayer</application> doesn't have a skin included, you | |
397 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
|
398 url="http://www.mplayerhq.hu/dload.html">download page</ulink>. |
9675 | 399 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
|
400 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
|
401 class="directory">$HOME/.mplayer/skins</filename>. |
9675 | 402 <application>MPlayer</application> by default looks in these directories |
403 for a directory named <filename class="directory">default</filename>, but | |
404 you can use the <option>-skin <replaceable>newskin</replaceable></option> | |
405 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
|
406 the skin in <filename class="directory">*/skins/newskin</filename> |
9675 | 407 directory. |
408 </para> | |
409 </sect1> | |
410 | |
411 <!-- ********** --> | |
412 | |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
413 <sect1 id="fonts-osd"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
414 <title>Fonts and OSD</title> |
9675 | 415 |
416 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
417 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
|
418 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
|
419 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
|
420 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
|
421 encodings. |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
422 </para> |
9675 | 423 |
19823 | 424 |
19822
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
425 <sect2 id="truetype-fonts"> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
426 <title>TrueType fonts</title> |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
427 |
db95db082c37
Move subtitles and OSD section from the installation to the usage chapter.
diego
parents:
19821
diff
changeset
|
428 <para> |
19823 | 429 There are two ways to get TrueType fonts to work. The first is to pass |
430 the <option>-font</option> option to specify a TrueType font file on | |
431 the command line. This option will be a good candidate to put in your | |
432 configuration file (see the manual page for details). | |
433 The second is to create a symlink called <filename>subfont.ttf</filename> | |
434 to the font file of your choice. Either | |
435 <screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen> | |
436 for each user individually or a system-wide one: | |
437 <screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf</screen> | |
438 </para> | |
439 | |
440 <para> | |
441 If <application>MPlayer</application> was compiled with | |
442 <systemitem class="library">fontconfig</systemitem> support, the above methods | |
443 won't work, instead <option>-font</option> expects a | |
444 <systemitem class="library">fontconfig</systemitem> font name | |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
445 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
|
446 |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
447 <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
|
448 </para> |
12815 | 449 |
20396
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
450 <para> |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
451 To get a list of fonts known to |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
452 <systemitem class="library">fontconfig</systemitem>, |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
453 use <command>fc-list</command>. |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
454 </para> |
19821 | 455 </sect2> |
456 | |
457 | |
458 <sect2 id="bitmap-fonts"> | |
459 <title>bitmap fonts</title> | |
460 | |
9675 | 461 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
462 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
|
463 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
|
464 <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
|
465 and some sets of fonts |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
466 <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
|
467 in various encodings. |
9675 | 468 </para> |
469 | |
470 <para> | |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
471 Uncompress the file you downloaded to |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
472 <filename class="directory">~/.mplayer</filename> or |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
473 <filename class="directory">$PREFIX/share/mplayer</filename>. |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
474 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
|
475 <filename class="directory">font</filename>, for example: |
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
476 <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
|
477 <screen>ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font</screen> |
9737 | 478 </para> |
479 | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
480 <para> |
19819
76d294537ff6
TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents:
19817
diff
changeset
|
481 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
|
482 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
|
483 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
|
484 and use the <option>-utf8</option> option or give the subtitles |
490b7a74a21b
Fix some inconsistencies pointed out by Torinthiel.
diego
parents:
20384
diff
changeset
|
485 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
|
486 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
|
487 </para> |
9675 | 488 |
489 </sect2> | |
490 | |
491 | |
492 <sect2 id="osdmenu"> | |
493 <title>OSD menu</title> | |
494 | |
495 <para> | |
11540 | 496 <application>MPlayer</application> has a completely user definiable OSD Menu interface. |
9675 | 497 </para> |
498 | |
499 <note><simpara> | |
500 the Preferences menu is currently UNIMPLEMENTED! | |
501 </simpara></note> | |
502 | |
503 <orderedlist> | |
504 <title>Installation</title> | |
505 <listitem><simpara> | |
506 compile <application>MPlayer</application> by passing the <option>--enable-menu</option> | |
507 to <filename>./configure</filename> | |
508 </simpara></listitem> | |
509 <listitem><simpara> | |
510 make sure you have an OSD font installed | |
511 </simpara></listitem> | |
512 <listitem><simpara> | |
513 copy <filename>etc/menu.conf</filename> to your | |
514 <filename class="directory">.mplayer</filename> directory | |
515 </simpara></listitem> | |
516 <listitem><simpara> | |
517 copy <filename>etc/input.conf</filename> to your | |
518 <filename class="directory">.mplayer</filename> directory, or to the system-wide | |
519 <application>MPlayer</application> config dir (default: | |
520 <filename class="directory">/usr/local/etc/mplayer</filename>) | |
521 </simpara></listitem> | |
522 <listitem><simpara> | |
523 check and edit <filename>input.conf</filename> to enable menu movement keys | |
524 (it is described there). | |
525 </simpara></listitem> | |
526 <listitem><para> | |
527 start <application>MPlayer</application> by the following example: | |
11713 | 528 <screen>$ mplayer -menu <replaceable>file.avi</replaceable></screen> |
9675 | 529 </para></listitem> |
530 <listitem><simpara> | |
531 push any menu key you defined | |
532 </simpara></listitem> | |
533 </orderedlist> | |
534 | |
535 </sect2> | |
536 </sect1> | |
537 | |
538 <!-- ********** --> | |
539 | |
540 <sect1 id="rtc"> | |
541 <title>RTC</title> | |
542 <para> | |
11540 | 543 There are three timing methods in <application>MPlayer</application>. |
9675 | 544 |
545 <itemizedlist> | |
546 <listitem><simpara> | |
547 <emphasis role="bold">To use the old method</emphasis>, you don't have to do | |
548 anything. It uses <systemitem>usleep()</systemitem> to tune | |
549 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be | |
550 tuned even finer. | |
551 </simpara></listitem> | |
552 <listitem><para> | |
12779 | 553 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime Clock) |
19773 | 554 for this task, because it has precise 1ms timers. The <option>-rtc</option> |
555 option enables it, but a properly set up kernel is required. | |
9675 | 556 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC |
11668 | 557 frequency for normal users through the <systemitem class="systemname">/proc |
19969 | 558 </systemitem> filesystem. Use one of the following two commands to |
9675 | 559 enable RTC for normal users: |
560 <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> | |
19969 | 561 <screen>sysctl dev/rtc/max-user-freq=1024</screen> |
562 You can make this setting permanent by adding the latter to | |
563 <filename>/etc/sysctl.conf</filename>. | |
564 </para> | |
565 <para> | |
9675 | 566 You can see the new timer's efficiency in the status line. |
567 The power management functions of some notebook BIOSes with speedstep CPUs | |
568 interact badly with RTC. Audio and video may get out of sync. Plugging the | |
569 external power connector in before you power up your notebook seems to help. | |
570 In some hardware combinations (confirmed during usage of non-DMA DVD drive | |
571 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's | |
572 recommended to use the third method in these cases. | |
573 </para></listitem> | |
574 <listitem><simpara> | |
575 <emphasis role="bold">The third timer code</emphasis> is turned on with the | |
576 <option>-softsleep</option> option. It has the efficiency of the RTC, but it | |
577 doesn't use RTC. On the other hand, it requires more CPU. | |
578 </simpara></listitem> | |
579 </itemizedlist> | |
580 </para> | |
581 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
582 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
583 </chapter> |