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