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