Mercurial > mplayer.hg
annotate DOCS/xml/en/install.xml @ 17321:7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
sections no longer nest as deeply. This has the added benefit of
removing a few sections that only consisted of the section title.
author | diego |
---|---|
date | Thu, 05 Jan 2006 23:32:18 +0000 |
parents | 2965acaa980f |
children | db3327b8e590 |
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> | |
30 <emphasis role="bold">binutils</emphasis> - suggested version is <emphasis role="bold">2.11.x</emphasis>. | |
31 This program is responsible for generating MMX/ 3DNow!/etc instructions, | |
32 thus very important. | |
33 </para></listitem> | |
34 <listitem><para> | |
35 <emphasis role="bold">gcc</emphasis> - suggested versions are: <emphasis role="bold">2.95.3</emphasis> | |
36 (maybe <emphasis role="bold">2.95.4</emphasis>) and <emphasis role="bold">3.2+</emphasis>. | |
37 <emphasis role="bold">Never</emphasis> use 2.96 or 3.0.x! They generate faulty code for | |
10132 | 38 <application>MPlayer</application>. If you decide to change gcc from |
39 2.96, then don't decide in favor of 3.x just because it's newer! Early | |
40 releases of 3.x were even more buggy than 2.96. So downgrade to 2.95.x | |
9675 | 41 (downgrade <systemitem class="library">libstdc++</systemitem> too, other |
42 programs may need it) or don't up/downgrade at all (but in this case, be | |
10132 | 43 prepared for runtime problems). If you vote for 3.x, try to use the |
9675 | 44 latest version, early releases had various bugs, so be sure you use at |
45 least 3.1, it's tested and working. For detailed information about gcc 2.96's | |
46 bugs (that are still NOT fixed, they have been WORKED AROUND in | |
47 <application>MPlayer</application>!),see the <link linkend="gcc-296">gcc 2.96</link> | |
48 section and the <xref linkend="faq"/>. | |
49 </para></listitem> | |
50 <listitem><para> | |
51 <emphasis role="bold">XFree86</emphasis> - suggested version is <emphasis role="bold">always the | |
10132 | 52 newest</emphasis> (4.3). Normally, everyone wants this, as starting |
9675 | 53 with XFree86 4.0.2, it contains the <link linkend="xv">XVideo</link> |
54 extension (somewhere referred to as <emphasis role="bold">Xv</emphasis>) | |
55 which is needed to enable the hardware YUV acceleration (fast image display) | |
56 on cards that support it. | |
57 Make sure its <emphasis role="bold">development package</emphasis> is installed, | |
58 too, otherwise it won't work. | |
59 For some video cards you don't need XFree86. See list below. | |
60 </para></listitem> | |
61 <listitem><para> | |
62 <emphasis role="bold">make</emphasis> - suggested version is | |
63 <emphasis role="bold">always the newest</emphasis> (at least 3.79.x). This | |
64 usually isn't important. | |
65 </para></listitem> | |
66 <listitem><para> | |
67 <emphasis role="bold">SDL</emphasis> - it's not mandatory, but can help in | |
68 some cases (bad audio, video cards that lag strangely with the xv driver). | |
69 Always use the newest (beginning from 1.2.x). | |
70 </para></listitem> | |
71 <listitem><para> | |
72 <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
|
73 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
|
74 and <application>MEncoder</application> if |
9675 | 75 you plan to work with jpeg files. |
76 </para></listitem> | |
77 <listitem><para> | |
78 <emphasis role="bold">libpng</emphasis> - recommended and default (M)PNG decoder. Required for GUI. | |
79 Useful for both <application>MPlayer</application> and | |
80 <application>MEncoder</application>. | |
81 </para></listitem> | |
82 <listitem><para> | |
83 <emphasis role="bold">lame</emphasis> - recommended, needed for encoding MP3 audio with | |
84 <application>MEncoder</application>, suggested version is | |
85 <emphasis>always the newest</emphasis> (at least 3.90). | |
86 </para></listitem> | |
87 <listitem><para> | |
11324
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
88 <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
|
89 MOV header and PNG support. |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
90 </para></listitem> |
9fceaedbd5a6
Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents:
11311
diff
changeset
|
91 <listitem><para> |
9675 | 92 <emphasis role="bold">libogg</emphasis> - optional, needed for playing OGG file format. |
93 </para></listitem> | |
94 <listitem><para> | |
95 <emphasis role="bold">libvorbis</emphasis> - optional, needed for playing OGG Vorbis audio. | |
96 </para></listitem> | |
97 <listitem><para> | |
98 <emphasis role="bold"><ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink></emphasis> | |
99 - optional, needed for playing RTSP/RTP streams. | |
100 </para></listitem> | |
101 <listitem><para> | |
102 <emphasis role="bold">directfb</emphasis> - optional, from | |
14048 | 103 <ulink url="http://www.directfb.org"/>. At least 0.9.13 is required. |
9675 | 104 </para></listitem> |
105 <listitem><para> | |
106 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support | |
107 </para></listitem> | |
108 <listitem><para> | |
109 <emphasis role="bold">libfreetype</emphasis> - optional, for TTF fonts | |
110 support. At least 2.0.9 is required. | |
111 </para></listitem> | |
112 <listitem><para> | |
113 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin | |
114 support. At least 1.2.7 is required. | |
115 </para></listitem> | |
10132 | 116 <listitem><para> |
117 <emphasis role="bold">libsmb</emphasis> - optional, for Samba support. | |
118 </para></listitem> | |
12662
05d46af5e2bf
JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents:
12615
diff
changeset
|
119 <listitem><para> |
14310 | 120 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output |
121 support. At least 0.9.0rc4 is required. | |
122 </para></listitem> | |
123 <listitem><para> | |
12662
05d46af5e2bf
JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents:
12615
diff
changeset
|
124 <emphasis role="bold">bio2jack</emphasis> - optional, for JACK audio output |
12815 | 125 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
|
126 <ulink url="http://bio2jack.sf.net/">http://bio2jack.sf.net</ulink>. Since it |
12815 | 127 doesn't have install option you have to manually put the file |
128 <filename>libbio2jack.a</filename> somewhere in your library path | |
129 (e.g. <filename>/usr/local/lib</filename>) or use the | |
130 <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
|
131 <filename>./configure</filename> where that file is. |
05d46af5e2bf
JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents:
12615
diff
changeset
|
132 </para></listitem> |
9675 | 133 </itemizedlist> |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
134 </sect1> |
9675 | 135 |
136 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
137 <sect1 id="installation_codecs"> |
9675 | 138 <title>Codecs</title> |
139 | |
140 <itemizedlist> | |
141 <listitem><para> | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
142 <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis>: |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
143 This codec package is capable |
13111 | 144 of decoding H.263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1/WMV2/SVQ1/SVQ3 encoded video |
9675 | 145 streams and WMA (Windows Media Audio) v1/v2 audio streams, on multiple |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
146 platforms. It is also known to be the fastest for this task. See |
11488 | 147 <link linkend="ffmpeg">FFmpeg</link> section for details. Features: |
9675 | 148 <itemizedlist> |
149 <listitem><simpara> | |
150 gain decoding of videos mentioned above, on non-x86 machines | |
151 </simpara></listitem> | |
152 <listitem><simpara> | |
153 encoding with most of the mentioned codecs | |
154 </simpara></listitem> | |
155 <listitem><simpara> | |
156 this codec is the <emphasis role="bold">fastest codec available</emphasis> for | |
14024 | 157 DivX/3/4/5 and other MPEG-4 types. Recommended! |
9675 | 158 </simpara></listitem> |
159 </itemizedlist> | |
160 </para></listitem> | |
161 <listitem><para> | |
162 <emphasis role="bold">Win32 codecs</emphasis>: If you plan to use | |
163 <application>MPlayer</application> on x86 architecture, you will possibly need | |
14497
c8c617d48814
Codec packages now have different names, try to be less confusing about it.
diego
parents:
14472
diff
changeset
|
164 them. Download a codec package from our |
c8c617d48814
Codec packages now have different names, try to be less confusing about it.
diego
parents:
14472
diff
changeset
|
165 <ulink url="http://www.mplayerhq.hu/homepage/design7/codecs.html">codecs page</ulink> |
c8c617d48814
Codec packages now have different names, try to be less confusing about it.
diego
parents:
14472
diff
changeset
|
166 and put the codecs in <filename class="directory">/usr/local/lib/codecs</filename> |
9675 | 167 <emphasis role="bold">BEFORE</emphasis> compiling <application>MPlayer</application>, |
168 otherwise no Win32 support will be compiled! | |
169 <note><para>The avifile project has similar codecs package, but it | |
170 differs from ours, so if you want to use all supported codecs, then use | |
171 our package (do not worry, avifile works with it without problems).</para> | |
172 </note> | |
173 Features: | |
174 <itemizedlist> | |
175 <listitem><simpara> | |
176 you need this if you want to play or encode for example movies recorded | |
177 with various hardware compressors, like tuner cards, digital cameras | |
178 (example: DV, ATI VCR, MJPEG) | |
179 </simpara></listitem> | |
180 <listitem><simpara> | |
10132 | 181 needed if you want to play <emphasis role="bold">WMV9/WMA9 movies</emphasis>. |
9675 | 182 </simpara></listitem> |
183 <listitem><simpara> | |
184 Not needed for old ASF's with MP41 or MP42 video (though VoxWare audio is | |
185 frequent for these files - it's done by the Win32 codec), or WMV7. Also not | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
186 needed for WMA (Windows Media Audio), |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
187 <systemitem class="library">libavcodec</systemitem> has open source decoder |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
188 for that. |
9675 | 189 </simpara></listitem> |
190 </itemizedlist> | |
191 </para></listitem> | |
192 <listitem><para> | |
193 <emphasis role="bold">QuickTime codecs</emphasis>: on x86 platforms these | |
10132 | 194 codecs can be used to decode RPZA, and other QuickTime video, |
9675 | 195 and QDesign audio streams. Installation instructions can be found in the |
196 <link linkend="sorenson">Sorenson video codec</link> section. | |
197 </para></listitem> | |
198 <listitem><para> | |
199 <emphasis role="bold">DivX4/DivX5</emphasis>: information about this codec is | |
11483 | 200 available in the <link linkend="divx4-5">DivX4/DivX5</link> section. You possibly |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
201 don't want this codec as |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
202 <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis> |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
203 (see above) is much faster and has better quality than this, for both decoding |
9675 | 204 and encoding. Features: |
205 <itemizedlist> | |
206 <listitem><simpara> | |
14421 | 207 one pass or two pass encoding with |
11540 | 208 <link linkend="mencoder"><application>MEncoder</application></link> |
9675 | 209 </simpara></listitem> |
210 <listitem><simpara> | |
211 can play old <emphasis role="bold">DivX3</emphasis> movies much faster than | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
212 the Win32 DLL but slower than |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11794
diff
changeset
|
213 <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis>! |
9675 | 214 </simpara></listitem> |
215 <listitem><simpara> | |
216 it's closed-source, and only a x86 version is available. | |
217 </simpara></listitem> | |
218 </itemizedlist> | |
219 </para></listitem> | |
220 <listitem><para> | |
221 <emphasis role="bold">XviD</emphasis>: Open source encoding alternative to | |
11758 | 222 DivX4Linux. Features: |
9675 | 223 <itemizedlist> |
224 <listitem><simpara> | |
14421 | 225 one pass or two pass encoding with |
11540 | 226 <link linkend="mencoder"><application>MEncoder</application></link> |
9675 | 227 </simpara></listitem> |
228 <listitem><simpara> | |
229 it's open-source, so it's multiplatform. | |
230 </simpara></listitem> | |
231 <listitem><simpara> | |
11758 | 232 it's about 2 times faster than divX4 when encoding - about the same |
9675 | 233 quality |
234 </simpara></listitem> | |
235 </itemizedlist> | |
236 </para></listitem> | |
237 <listitem><para> | |
238 The <emphasis role="bold"><link linkend="xanim">XAnim codecs</link></emphasis> | |
239 are the best (full screen, hardware YUV zoom) for decoding | |
240 <emphasis role="bold">3ivx</emphasis> and Indeo 3/4/5 movies, and some old | |
241 formats. And they are multiplatform, so this is the only way to play Indeo on | |
242 non-x86 platforms (well, apart from using XAnim:). But for example Cinepak movies | |
243 are best played with <application>MPlayer</application>'s own Cinepak decoder! | |
244 </para></listitem> | |
245 <listitem><para> | |
246 For <emphasis role="bold">Ogg Vorbis</emphasis> audio decoding you need to | |
14121 | 247 install <systemitem class="library">libvorbis</systemitem> properly. |
248 You can get binary packages and source code from the | |
249 <ulink url="http://www.vorbis.com/download.psp">Ogg Vorbis site</ulink>. | |
9675 | 250 </para></listitem> |
251 <listitem><para> | |
252 <application>MPlayer</application> can use the libraries of RealPlayer 8 | |
12561 | 253 or RealONE to play files with |
254 <emphasis role="bold">RealVideo 3.0 and 4.0</emphasis> | |
255 video, and Sipro/Cook audio. See the | |
256 <link linkend="realmedia">RealMedia file format</link> | |
9675 | 257 section for installation instructions and more information. |
258 </para></listitem> | |
259 </itemizedlist> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
260 </sect1> |
9675 | 261 |
262 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
263 <sect1 id="video-cards"> |
9675 | 264 <title>Video cards</title> |
265 | |
266 <para> | |
267 There are generally two kind of video cards. One kind (the newer cards) has | |
268 <emphasis role="bold">hardware scaling and YUV acceleration</emphasis> support, | |
269 the other cards don't. | |
270 </para> | |
271 | |
272 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
273 <sect2 id="yuv-cards"> |
9675 | 274 <title>YUV cards</title> |
275 | |
276 <para> | |
277 They can display and scale (zoom) the picture to any size that fits in | |
278 their memory, with <emphasis role="bold">small CPU usage</emphasis> (even when | |
279 zooming), thus fullscreen is nice and very fast. | |
12815 | 280 |
9675 | 281 <itemizedlist> |
282 <listitem><para> | |
283 <emphasis role="bold">Matrox G200/G400/G450/G550 cards</emphasis>: although a | |
284 <link linkend="vidix">Vidix driver</link> is provided, it is recommended to | |
285 use the mga_vid module instead, for it works much better. | |
286 Please see the <link linkend="mga_vid">mga_vid</link> section about its | |
287 installation and usage. It is important to do these steps | |
288 <emphasis>before</emphasis> compiling <application>MPlayer</application>, | |
289 otherwise no mga_vid support will be built. Also check out the | |
11394 | 290 <link linkend="tvout-mga-g400">Matrox TV-out</link> section. |
9675 | 291 <emphasis role="bold"> If you don't use Linux</emphasis>, your only |
9683 | 292 possibility is the VIDIX driver: read the <link linkend="vidix">VIDIX</link> section. |
9675 | 293 </para></listitem> |
294 <listitem><para> | |
295 <emphasis role="bold">3Dfx Voodoo3/Banshee cards</emphasis>: please see | |
296 <link linkend="tdfxfb">tdfxfb</link> section in order to gain big speedup. | |
297 It is important to do these steps <emphasis role="bold">before</emphasis> | |
298 compiling <application>MPlayer</application>, otherwise no 3Dfx support will be | |
11483 | 299 built. Also see the <link linkend="tvout-voodoo">3dfx TV-out</link> section. |
9675 | 300 If you use X, use at least <emphasis role="bold">4.2.0</emphasis>, as 3dfx Xv |
301 driver was broken in 4.1.0, and earlier releases. | |
302 </para></listitem> | |
303 <listitem><para> | |
304 <emphasis role="bold">ATI cards</emphasis>: <link linkend="vidix">VIDIX</link> | |
305 driver is provided for the following cards: | |
306 <emphasis role="bold">Radeon, Rage128, Mach64</emphasis> (Rage XL/Mobility, Xpert98). | |
11483 | 307 Also see the <link linkend="tvout-ati">ATI cards</link> section of the TV-out documentation, |
9675 | 308 to know if you card's TV-out is supported under Linux/<application>MPlayer</application>. |
309 </para></listitem> | |
310 <listitem><para> | |
311 <emphasis role="bold">S3 cards</emphasis>: the Savage and Virge/DX chips have | |
312 hardware acceleration. Use as new XFree86 version as possible, older drivers are | |
11483 | 313 buggy. Savage chips have problems with YV12 display, see <link linkend="s3">S3 Xv</link> |
314 section for details. Older, Trio cards have no, or slow hardware support. | |
9675 | 315 </para></listitem> |
316 <listitem><para> | |
9683 | 317 <emphasis role="bold">nVidia cards</emphasis>: may or may not be good choice for video playing. |
9675 | 318 If you do not have a GeForce2 (or newer) card, it's not likely to work without bugs. |
9683 | 319 <emphasis role="bold">the built-in nVidia driver in XFree86 does not support |
320 hardware YUV acceleration on all nVidia cards.</emphasis> You have | |
12815 | 321 to download nVidia's closed-source drivers from <ulink url="http://nvidia.com">nVidia.com</ulink>. |
11461 | 322 See the <link linkend="nvidia">nVidia Xv driver</link> section for details. Please also check |
11483 | 323 the <link linkend="tvout-nvidia">nVidia TV-out</link> section if you wish to |
9675 | 324 use a TV. |
325 </para></listitem> | |
326 <listitem><para> | |
327 <emphasis role="bold">3DLabs GLINT R3 and Permedia3</emphasis>: a VIDIX driver | |
328 is provided (pm3_vid). Please see the <link linkend="vidix">VIDIX</link> section | |
329 for details. | |
330 </para></listitem> | |
331 <listitem><para> | |
332 <emphasis role="bold">Other cards</emphasis>: none of the above? | |
333 <itemizedlist> | |
334 <listitem><simpara> | |
335 Try if the XFree86 driver (and your card) supports hardware | |
11483 | 336 acceleration. See the <link linkend="xv">Xv</link> section for details. |
9675 | 337 </simpara></listitem> |
338 <listitem><simpara> | |
339 If it doesn't, then your card's video features aren't supported under | |
9683 | 340 your operating system :( If hardware scaling works under Windows, it |
341 doesn't mean it will work under Linux or other operating system, it depends on | |
342 the drivers. Most manufacturers neither make Linux drivers nor release | |
343 specifications of their chips - so you are unlucky if using their cards. | |
9675 | 344 See <xref linkend="non-yuv-cards"/>. |
345 </simpara></listitem> | |
346 </itemizedlist> | |
347 </para></listitem> | |
348 </itemizedlist> | |
349 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
350 </sect2> |
9675 | 351 |
352 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
353 <sect2 id="non-yuv-cards" xreflabel="Non-YUV cards"> |
9675 | 354 <title>Non-YUV cards</title> |
355 | |
356 <para> | |
357 Fullscreen playing can be achieved by either enabling <emphasis role="bold"> | |
9683 | 358 software scaling</emphasis> (use the <option>-zoom</option> or <option>-vf</option> option, |
11501 | 359 but I warn you: this is slow), or switching to a smaller video mode, for example |
9675 | 360 352x288. If you don't have YUV acceleration, this latter method is recommended. |
361 Video mode switching can be enabled by using the <option>-vm</option> option and | |
362 it works with the following drivers: | |
363 <itemizedlist> | |
364 <listitem><simpara> | |
365 <emphasis role="bold">using</emphasis> XFree86: see details in <link linkend="dga">DGA driver</link> and | |
366 <link linkend="x11">X11 driver</link> sections. DGA is recommended! Also | |
367 try DGA via SDL, sometimes it's better. | |
368 </simpara></listitem> | |
369 <listitem><simpara> | |
370 <emphasis role="bold">not using</emphasis> XFree86: try the drivers in the | |
371 following order: | |
372 <link linkend="vesa">vesa</link>, | |
373 <link linkend="fbdev">fbdev</link>, | |
374 <link linkend="svgalib">svgalib</link>, | |
375 <link linkend="aalib">aalib</link>. | |
376 </simpara></listitem> | |
377 </itemizedlist> | |
378 </para> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
379 </sect2> |
9675 | 380 |
381 <!-- 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
|
382 <sect2 id="cirrus-logic-cards" xreflabel="Cirrus-Logic cards"> |
9675 | 383 <title>Cirrus-Logic cards</title> |
384 <itemizedlist> | |
385 <listitem><para> | |
386 GD 7548: present on-board and tested in Compaq Armada 41xx notebook series. | |
387 <itemizedlist> | |
388 <listitem><simpara> | |
389 XFree86 3: works in 8/16bpp modes. However, the driver is dramatically slow | |
390 and buggy in 800x600@16bpp. <emphasis role="bold">Recommended: 640x480@16bpp</emphasis> | |
391 </simpara></listitem> | |
392 <listitem><simpara> | |
393 XFree86 4: the Xserver freezes soon after start unless acceleration is | |
394 disabled, but then the whole thing gets slower than XFree86 3. No XVideo. | |
395 </simpara></listitem> | |
396 <listitem><simpara> | |
397 FBdev: framebuffer can be turned on with the <systemitem>clgenfb</systemitem> | |
398 driver in the kernel, though for me it worked only in 8bpp, thus unusable. | |
399 The clgenfb source had to be extended with the 7548 ID before compilation. | |
400 </simpara></listitem> | |
401 <listitem><simpara> | |
402 VESA: the card is only VBE 1.2 capable, so VESA output can't be used. Can't | |
403 be workarounded with UniVBE. | |
404 </simpara></listitem> | |
405 <listitem><simpara> | |
406 SVGAlib: detects an older Cirrus chip. Usable but slow with | |
407 <option>-bpp 8</option>. | |
408 </simpara></listitem> | |
409 </itemizedlist> | |
410 </para></listitem> | |
411 </itemizedlist> | |
412 </sect2> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
413 </sect1> |
9675 | 414 |
415 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
416 <sect1 id="sound-cards"> |
9675 | 417 <title>Sound cards</title> |
418 | |
419 <itemizedlist> | |
420 <listitem><simpara> | |
421 <emphasis role="bold">Soundblaster Live!</emphasis>: with this card you can use | |
9683 | 422 4 or 6 (<emphasis role="bold">5.1</emphasis>) channels AC3 decoding instead of 2. Read the |
9675 | 423 <link linkend="swac3">Software AC3 decoding</link> section. For hardware AC3 |
9683 | 424 passthrough you <emphasis role="bold">must</emphasis> use ALSA 0.9 with OSS emulation! |
9675 | 425 </simpara></listitem> |
426 <listitem><simpara> | |
12369 | 427 <emphasis role="bold">C-Media with S/PDIF out</emphasis>: hardware AC3 |
9675 | 428 passthrough is possible with these cards, see |
429 <link linkend="hwac3">Hardware AC3 decoding</link> section. | |
430 </simpara></listitem> | |
431 <listitem><simpara> | |
432 Features of <emphasis role="bold">other cards</emphasis> aren't supported by | |
433 <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
|
434 to read the <link linkend="audio">sound card</link> section!</emphasis> |
9675 | 435 </simpara></listitem> |
436 </itemizedlist> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
437 </sect1> |
9675 | 438 |
439 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
440 <sect1 id="features"> |
9675 | 441 <title>Features</title> |
442 | |
443 <itemizedlist> | |
444 <listitem><para> | |
11483 | 445 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link> |
446 section before compiling. | |
9675 | 447 </para></listitem> |
448 <listitem><para> | |
449 If you want to install <application>MEncoder</application> (our great | |
11540 | 450 all-purpose encoder), see the |
451 <link linkend="mencoder"><application>MEncoder</application></link> section. | |
9675 | 452 </para></listitem> |
453 <listitem><para> | |
454 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card, | |
455 and wish to watch/grab and encode movies with <application>MPlayer</application>, | |
456 read the <link linkend="tv-input">TV input</link> section. | |
457 </para></listitem> | |
458 <listitem><para> | |
459 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be | |
460 used. Check the <link linkend="subosd">OSD menu</link> section. | |
461 </para></listitem> | |
462 </itemizedlist> | |
463 | |
464 <para> | |
465 Then build <application>MPlayer</application>: | |
466 <screen> | |
467 ./configure | |
468 make | |
469 make install</screen> | |
470 </para> | |
471 | |
472 <para> | |
473 At this point, <application>MPlayer</application> is ready to use. The | |
474 directory <filename class="directory">$PREFIX/share/mplayer</filename> | |
475 contains the <filename>codecs.conf</filename> file, which is used to tell | |
10132 | 476 the program all the codecs and their capabilities. This file is needed only |
477 when you want to change its properties, as the main binary contains an internal | |
478 copy of it. Check if you have | |
9675 | 479 <filename>codecs.conf</filename> in your home directory |
480 (<filename>~/.mplayer/codecs.conf</filename>) left from old | |
481 <application>MPlayer</application> versions, and remove it. | |
482 </para> | |
483 | |
484 <para> | |
10403 | 485 Note that if you have a <filename>codecs.conf</filename> in |
486 <filename>~/.mplayer/</filename>, the builtin and system | |
487 <filename>codecs.conf</filename> will be ignored completely. | |
11540 | 488 Do not do this unless you want to fiddle with <application>MPlayer</application> |
489 internals as this can can cause many problems. If you want to change the codecs | |
490 search order, use the <option>-vc</option>, <option>-ac</option>, <option>-vfm</option>, | |
10403 | 491 or <option>-afm</option> options either on the command line or in your |
492 config file (see the manual page). | |
493 </para> | |
494 | |
495 | |
496 <para> | |
9675 | 497 Debian users can build a .deb package for themselves, it's very simple. |
498 Just exec | |
499 <screen>fakeroot debian/rules binary</screen> | |
500 in <application>MPlayer</application>'s root directory. See | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
10913
diff
changeset
|
501 <link linkend="debian">Debian packaging</link> for detailed instructions. |
9675 | 502 </para> |
503 | |
504 <para> | |
505 <emphasis role="bold">Always browse the output of</emphasis> | |
506 <filename>./configure</filename>, and the | |
507 <filename>configure.log</filename> file, they contain information about | |
508 what will be built, and what will not. You may also want to view | |
509 <filename>config.h</filename> and <filename>config.mak</filename> files. | |
510 If you have some libraries installed, but not detected by | |
511 <filename>./configure</filename>, then check if you also have the proper | |
512 header files (usually the -dev packages) and their version matches. The | |
513 <filename>configure.log</filename> file usually tells you what is missing. | |
514 </para> | |
515 | |
516 <para> | |
517 Though not mandatory, the fonts should be installed in order to gain OSD, | |
518 and subtitle functionality. The recommended method is installing a TTF | |
11540 | 519 font file and telling <application>MPlayer</application> to use it. |
520 See the <link linkend="subosd">Subtitles and OSD</link> section for details. | |
9675 | 521 </para> |
522 | |
523 </sect1> | |
524 | |
525 <!-- ********** --> | |
526 | |
527 <sect1 id="gui"> | |
528 <title>What about the GUI?</title> | |
529 | |
530 <para> | |
16663 | 531 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are). |
532 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
|
533 (and their devel stuff, usually called <systemitem class="library">gtk-dev</systemitem> |
9675 | 534 and <systemitem class="library">libpng-dev</systemitem>) has to be installed. |
535 You can build it by specifying <option>--enable-gui</option> during | |
10000 | 536 <filename>./configure</filename>. Then, to turn on GUI mode, you have to |
537 execute the <command>gmplayer</command> binary. | |
9675 | 538 </para> |
539 | |
540 <para> | |
541 Currently you can't use the <option>-gui</option> option on the command | |
542 line, due to technical reasons. | |
543 </para> | |
544 | |
545 <para> | |
546 As <application>MPlayer</application> doesn't have a skin included, you | |
547 have to download them if you want to use the GUI. See the <ulink | |
548 url="http://www.mplayerhq.hu/homepage/dload.html">download page</ulink>. | |
549 They should be extracted to the usual system-wide directory (<filename | |
550 class="directory">$PREFIX/share/mplayer/Skin</filename>), or to <filename | |
551 class="directory">$HOME/.mplayer/Skin</filename>. | |
552 <application>MPlayer</application> by default looks in these directories | |
553 for a directory named <filename class="directory">default</filename>, but | |
554 you can use the <option>-skin <replaceable>newskin</replaceable></option> | |
555 option, or the <literal>skin=newskin</literal> config file directive to use | |
556 the skin in <filename class="directory">*/Skin/newskin</filename> | |
557 directory. | |
558 </para> | |
559 </sect1> | |
560 | |
561 <!-- ********** --> | |
562 | |
563 <sect1 id="subosd"> | |
564 <title>Subtitles and OSD</title> | |
565 | |
566 <para> | |
11540 | 567 <application>MPlayer</application> can display subtitles along with movie files. |
568 Currently the following formats are supported: | |
9675 | 569 <itemizedlist> |
12615 | 570 <listitem><para>VOBsub</para></listitem> |
9675 | 571 <listitem><para>OGM</para></listitem> |
572 <listitem><para>CC (closed caption)</para></listitem> | |
11687 | 573 <listitem><para>MicroDVD</para></listitem> |
9675 | 574 <listitem><para>SubRip</para></listitem> |
575 <listitem><para>SubViewer</para></listitem> | |
576 <listitem><para>Sami</para></listitem> | |
577 <listitem><para>VPlayer</para></listitem> | |
578 <listitem><para>RT</para></listitem> | |
579 <listitem><para>SSA</para></listitem> | |
11794
93f616ec5e98
Unknown subtitle format is PJS as pointed out by Salvador Eduardo Tropea.
diego
parents:
11758
diff
changeset
|
580 <listitem><para>PJS (Phoenix Japanimation Society)</para></listitem> |
9675 | 581 <listitem><para><link linkend="mpsub">MPsub</link></para></listitem> |
582 <listitem><para>AQTitle</para></listitem> | |
10277 | 583 <listitem><para><ulink url="http://unicorn.us.com/jacosub/">JACOsub</ulink></para></listitem> |
9675 | 584 </itemizedlist> |
585 </para> | |
586 | |
587 <para> | |
11540 | 588 <application>MPlayer</application> can dump the previously listed subtitle formats |
9675 | 589 (<emphasis role="bold">except the three first</emphasis>) into the following |
590 destination formats, with the given options: | |
591 <itemizedlist> | |
592 <listitem><para>MPsub: <option>-dumpmpsub</option></para></listitem> | |
593 <listitem><para>SubRip: <option>-dumpsrtsub</option></para></listitem> | |
11687 | 594 <listitem><para>MicroDVD: <option>-dumpmicrodvdsub</option></para></listitem> |
9675 | 595 <listitem><para>JACOsub: <option>-dumpjacosub</option></para></listitem> |
596 <listitem><para>Sami: <option>-dumpsami</option></para></listitem> | |
597 </itemizedlist> | |
598 </para> | |
599 | |
600 <para> | |
11540 | 601 <application>MEncoder</application> can dump DVD subtitles into |
12615 | 602 <link linkend="menc-feat-extractsub">VOBsub</link> format. |
10132 | 603 </para> |
604 | |
605 <para> | |
9675 | 606 The command line options differ slightly for the different formats: |
607 </para> | |
608 | |
609 <formalpara> | |
12615 | 610 <title>VOBsub subtitles</title> |
9675 | 611 <para> |
12615 | 612 VOBsub subtitles consist of a big (some megabytes) <filename>.SUB</filename> file, |
9675 | 613 and optional <filename>.IDX</filename> and/or <filename>.IFO</filename> |
11713 | 614 files. If you have files like |
615 <filename><replaceable>sample.sub</replaceable></filename>, | |
616 <filename><replaceable>sample.ifo</replaceable></filename> (optional), | |
617 <filename><replaceable>sample.idx</replaceable></filename> - you have to pass | |
618 <application>MPlayer</application> the <option>-vobsub sample | |
619 [-vobsubid <replaceable>id</replaceable>]</option> options | |
9675 | 620 (full path optional). The <option>-vobsubid</option> option is like |
621 <option>-sid</option> for DVDs, you can choose between subtitle tracks | |
622 (languages) with it. In case that <option>-vobsubid</option> is omitted, | |
623 <application>MPLayer</application> will try to use the languages given by the | |
624 <option>-slang</option> option and fall back to the <systemitem>langidx</systemitem> | |
625 in the <filename>.IDX</filename> file to set the subtitle language. If it fails, | |
626 there will be no subtitles. | |
627 </para> | |
628 </formalpara> | |
629 | |
630 <formalpara> | |
631 <title>Other subtitles</title> | |
632 <para> | |
633 The other formats consist of a single text file containing timing, | |
634 placement and text information. Usage: If you have a file like | |
11713 | 635 <filename><replaceable>sample.txt</replaceable></filename>, |
636 you have to pass the option <option>-sub | |
637 <replaceable>sample.txt</replaceable></option> (full path optional). | |
9675 | 638 </para> |
639 </formalpara> | |
640 | |
641 <variablelist> | |
642 <title>Adjusting subtitle timing and placement:</title> | |
643 <varlistentry> | |
644 <term><option>-subdelay <replaceable>sec</replaceable></option></term> | |
645 <listitem><simpara> | |
646 Delays subtitles by <option><replaceable>sec</replaceable></option> seconds. | |
14467
d03e8e7f9b26
Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents:
14421
diff
changeset
|
647 Can be negative. The value is added to movie's time position counter. |
9675 | 648 </simpara></listitem> |
649 </varlistentry> | |
650 <varlistentry> | |
651 <term><option>-subfps <replaceable>RATE</replaceable></option></term> | |
652 <listitem><simpara> | |
653 Specify frame/sec rate of subtitle file (float number). | |
654 </simpara></listitem> | |
655 </varlistentry> | |
656 <varlistentry> | |
657 <term><option>-subpos <replaceable>0-100</replaceable></option></term> | |
658 <listitem><simpara> | |
659 Specify the position of subtitles. | |
660 </simpara></listitem> | |
661 </varlistentry> | |
662 </variablelist> | |
663 | |
664 <para> | |
665 If you experience a growing delay between the movie and the subtitles when | |
16003 | 666 using a MicroDVD subtitle file, most likely the framerate of the movie and |
9675 | 667 the subtitle file are different. Please note that the MicroDVD subtitle |
14472 | 668 format uses absolute frame numbers for its timing, but there is no fps |
669 information in it, and therefore the <option>-subfps</option> option should | |
670 be used with this format. If you like to solve this problem permanently, | |
671 you have to manually convert the subtitle file framerate. | |
672 <application>MPlayer</application> can do this | |
14467
d03e8e7f9b26
Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents:
14421
diff
changeset
|
673 conversion for you: |
d03e8e7f9b26
Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents:
14421
diff
changeset
|
674 |
14648
069ee5fb161c
Remove unnecessary options from the -dumpmicrodvdsub command line and add
diego
parents:
14497
diff
changeset
|
675 <screen>mplayer -dumpmicrodvdsub -fps <replaceable>subtitles_fps</replaceable> -subfps <replaceable>avi_fps</replaceable> -sub <replaceable>subtitle_filename</replaceable> <replaceable>dummy.avi</replaceable></screen> |
9675 | 676 </para> |
677 | |
678 <para> | |
11483 | 679 About DVD subtitles, read the <link linkend="dvd">DVD</link> section. |
9675 | 680 </para> |
681 | |
682 | |
683 <sect2 id="mpsub"> | |
12578 | 684 <title><application>MPlayer</application>'s own subtitle format (MPsub)</title> |
9675 | 685 |
686 <para> | |
687 <application>MPlayer</application> introduces a new subtitle format called | |
688 <emphasis role="bold">MPsub</emphasis>. It was designed by Gabucino. Basically | |
689 its main feature is being <emphasis>dynamically</emphasis> time-based (although | |
690 it has frame-based mode too). Example (from <ulink | |
691 url="../../tech/mpsub.sub">DOCS/tech/mpsub.sub</ulink>): | |
692 <programlisting> | |
10132 | 693 FORMAT=TIME |
9675 | 694 # first number : wait this much after previous subtitle disappeared |
695 # second number : display the current subtitle for this many seconds | |
696 | |
697 15 3 | |
698 A long long, time ago... | |
699 | |
700 0 3 | |
701 in a galaxy far away... | |
702 | |
703 0 3 | |
704 Naboo was under an attack.<!-- | |
705 --></programlisting> | |
706 </para> | |
707 | |
708 <para> | |
709 So you see, the main goal was to <emphasis role="bold">make subtitle | |
710 editing/timing/joining/cutting easy</emphasis>. And, if you - say - get an | |
711 SSA subtitle but it's badly timed/delayed to your version of the movie, you | |
712 simply do a | |
11713 | 713 <screen>mplayer <replaceable>dummy.avi</replaceable> -sub source.ssa -dumpmpsub</screen> |
9675 | 714 A <filename>dump.mpsub</filename> file will be created in the |
715 current directory, which will contain the source subtitle's text, but in | |
716 <emphasis role="bold">MPsub</emphasis> format. Then you can freely add/subtract | |
717 seconds to/from the subtitle. | |
718 </para> | |
719 | |
720 <para> | |
721 Subtitles are displayed with a technique called <emphasis role="bold">'OSD', | |
14655 | 722 On Screen Display</emphasis>. OSD is used to display current time, volume bar, |
9675 | 723 seek bar etc. |
724 </para> | |
725 </sect2> | |
726 | |
727 | |
728 <sect2 id="mpsub-install"> | |
729 <title>Installing OSD and subtitles</title> | |
730 | |
731 <para> | |
11540 | 732 You need an <application>MPlayer</application> font package to be able to use |
733 OSD/SUB feature. There are many ways to get it: | |
9675 | 734 </para> |
735 | |
736 <itemizedlist> | |
737 <listitem><para> | |
11588
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
738 Use the font generator tool at <filename |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
739 class="directory">TOOLS/subfont-c</filename>. It's a complete tool to |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
740 convert from TTF/Type1/etc font to mplayer font pkg (read |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
741 <filename>TOOLS/subfont-c/README</filename> for details). |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
742 </para></listitem> |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
743 <listitem><para> |
11649
52798caae526
added <application> tag for GIMP, added 2 <replaceable> tags to font secion, made it more general
paszczi
parents:
11612
diff
changeset
|
744 Use the font generator <application>GIMP</application> plugin at <filename |
11588
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
745 class="directory">TOOLS/subfont-GIMP</filename> (note: you must have HSI |
14121 | 746 RAW plugin too, see <ulink url="http://realtime.ssu.ac.kr/~lethean/index.php?pagename=MplayerKoreanFonts" />). |
12815 | 747 </para></listitem> |
11588
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
748 <listitem><para> |
10132 | 749 using a TrueType (TTF) font, by the means of the <systemitem class="library">freetype</systemitem> |
11588
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
750 library. Version 2.0.9 or greater is mandatory! Then you have two methods: |
10132 | 751 <itemizedlist> |
752 <listitem><para> | |
11654
8bdbc6a93d74
added <systemitem> tag for fontconfig, some wording
paszczi
parents:
11649
diff
changeset
|
753 use the <option>-font <replaceable>/path/to/sample_font.ttf</replaceable></option> |
11649
52798caae526
added <application> tag for GIMP, added 2 <replaceable> tags to font secion, made it more general
paszczi
parents:
11612
diff
changeset
|
754 option to specify a TrueType font file on every occasion |
10132 | 755 </para></listitem> |
756 <listitem><para> | |
11649
52798caae526
added <application> tag for GIMP, added 2 <replaceable> tags to font secion, made it more general
paszczi
parents:
11612
diff
changeset
|
757 create a symlink: |
11654
8bdbc6a93d74
added <systemitem> tag for fontconfig, some wording
paszczi
parents:
11649
diff
changeset
|
758 <screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen> |
10132 | 759 </para></listitem> |
760 </itemizedlist> | |
11588
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
761 If <application>MPlayer</application> was compiled with |
bd910f698b8d
reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents:
11587
diff
changeset
|
762 <systemitem class="library">fontconfig</systemitem> support, the above methods |
11654
8bdbc6a93d74
added <systemitem> tag for fontconfig, some wording
paszczi
parents:
11649
diff
changeset
|
763 won't work, instead the <option>-font</option> expects a |
8bdbc6a93d74
added <systemitem> tag for fontconfig, some wording
paszczi
parents:
11649
diff
changeset
|
764 <systemitem class="library">fontconfig</systemitem> font name |
12815 | 765 and defaults to the sans-serif font. To get a list of fonts known to |
11655 | 766 <systemitem class="library">fontconfig</systemitem>, |
11713 | 767 use <command>fc-list</command>. Example: <option>-font |
768 <replaceable>'Bitstream Vera Sans'</replaceable></option> | |
10132 | 769 </para></listitem> |
770 <listitem><para> | |
11540 | 771 Download ready-to-use font packages from <application>MPlayer</application> |
772 site. Note: currently available fonts are limited for ISO 8859-1/2 support, | |
773 but there are some other (including Korean, Russian, ISO 8859-8 etc) fonts at | |
774 contrib/font section of FTP, made by users. | |
9675 | 775 </para><para> |
776 <!-- FIXME: this para should be before the list --> | |
777 Font should have appropriate <filename>font.desc</filename> file which | |
778 maps unicode font positions to the actual code page of the subtitles | |
13003 | 779 text. Other solution is to have subtitles encoded in UTF-8 encoding and |
9675 | 780 use <option>-utf8</option> option or just name the subtitles file |
781 <filename><video_name>.utf</filename> and have it in the same dir | |
13003 | 782 as the video file. Recoding from different codepages to UTF-8 could be |
11665
2fc354c3d651
removed FIXME line 759, brackets with RedHat and Debian (iconv and konwert aren't distro-specific
paszczi
parents:
11659
diff
changeset
|
783 done by using <command>konwert</command> or <command>iconv</command> programs. |
9675 | 784 </para><para> |
12815 | 785 |
9675 | 786 <table> |
787 <title>Some URLs</title> | |
788 <tgroup cols="2"> | |
789 <thead> | |
790 <row><entry>URL</entry><entry>Comment</entry></row> | |
791 </thead> | |
792 <tbody> | |
793 <row><entry> | |
9683 | 794 <ulink url="ftp://ftp.mplayerhq.hu/MPlayer/releases/fonts/"></ulink> |
9675 | 795 </entry><entry> |
796 ISO fonts | |
797 </entry></row> | |
798 <row><entry> | |
799 <ulink url="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/"></ulink> | |
800 </entry><entry> | |
801 various fonts by users | |
802 </entry></row> | |
803 <row><entry> | |
14121 | 804 <ulink url="http://realtime.ssu.ac.kr/~lethean/index.php?pagename=MplayerKoreanFonts"></ulink> |
9675 | 805 </entry><entry> |
806 Korean fonts and RAW plugin | |
807 </entry></row> | |
808 </tbody> | |
809 </tgroup> | |
810 </table> | |
10132 | 811 |
9675 | 812 </para></listitem> |
813 </itemizedlist> | |
814 <para> | |
815 If you chose non-TTF fonts, UNZIP the file you downloaded to <filename | |
816 class="directory">~/.mplayer</filename> or <filename | |
817 class="directory">$PREFIX/share/mplayer</filename>. Then rename or symlink | |
11659
47a889dd9592
changed <filename> tag to <filename class=directory> - font is a directory
paszczi
parents:
11655
diff
changeset
|
818 one of the extracted directories to <filename class="directory">font</filename>, |
47a889dd9592
changed <filename> tag to <filename class=directory> - font is a directory
paszczi
parents:
11655
diff
changeset
|
819 for example: |
9675 | 820 |
11713 | 821 <screen>ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font</screen> |
9675 | 822 |
823 Now you have to see a timer at the upper left corner of the movie (switch | |
824 it off with the <keycap>o</keycap> key). | |
825 </para> | |
826 | |
827 <para> | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
828 (subtitles are <emphasis>always enabled</emphasis>, for disabling them please |
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
829 read the man page) |
9737 | 830 </para> |
831 | |
9736
520f6d60bf75
fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents:
9683
diff
changeset
|
832 <para> |
9675 | 833 OSD has 4 states (switch with <keycap>o</keycap>): |
834 | |
835 <orderedlist> | |
836 <listitem><simpara> | |
837 volume bar + seek bar (default) | |
838 </simpara></listitem> | |
839 <listitem><simpara> | |
840 volume bar + seek bar + timer + file position percentage on seeking | |
841 </simpara></listitem> | |
842 <listitem><simpara> | |
843 volume bar + seek bar + timer + total duration of the media | |
844 </simpara></listitem> | |
845 <listitem><simpara> | |
846 subtitles only | |
847 </simpara></listitem> | |
848 </orderedlist> | |
849 | |
850 You can change default behaviour by setting <varname>osdlevel</varname> | |
851 variable in config file, or the <option>-osdlevel</option> command line option. | |
852 | |
853 </para> | |
854 </sect2> | |
855 | |
856 | |
857 <sect2 id="osdmenu"> | |
858 <title>OSD menu</title> | |
859 | |
860 <para> | |
11540 | 861 <application>MPlayer</application> has a completely user definiable OSD Menu interface. |
9675 | 862 </para> |
863 | |
864 <note><simpara> | |
865 the Preferences menu is currently UNIMPLEMENTED! | |
866 </simpara></note> | |
867 | |
868 <orderedlist> | |
869 <title>Installation</title> | |
870 <listitem><simpara> | |
871 compile <application>MPlayer</application> by passing the <option>--enable-menu</option> | |
872 to <filename>./configure</filename> | |
873 </simpara></listitem> | |
874 <listitem><simpara> | |
875 make sure you have an OSD font installed | |
876 </simpara></listitem> | |
877 <listitem><simpara> | |
878 copy <filename>etc/menu.conf</filename> to your | |
879 <filename class="directory">.mplayer</filename> directory | |
880 </simpara></listitem> | |
881 <listitem><simpara> | |
882 copy <filename>etc/input.conf</filename> to your | |
883 <filename class="directory">.mplayer</filename> directory, or to the system-wide | |
884 <application>MPlayer</application> config dir (default: | |
885 <filename class="directory">/usr/local/etc/mplayer</filename>) | |
886 </simpara></listitem> | |
887 <listitem><simpara> | |
888 check and edit <filename>input.conf</filename> to enable menu movement keys | |
889 (it is described there). | |
890 </simpara></listitem> | |
891 <listitem><para> | |
892 start <application>MPlayer</application> by the following example: | |
11713 | 893 <screen>$ mplayer -menu <replaceable>file.avi</replaceable></screen> |
9675 | 894 </para></listitem> |
895 <listitem><simpara> | |
896 push any menu key you defined | |
897 </simpara></listitem> | |
898 </orderedlist> | |
899 | |
900 </sect2> | |
901 </sect1> | |
902 | |
903 <!-- ********** --> | |
904 | |
905 <sect1 id="rtc"> | |
906 <title>RTC</title> | |
907 <para> | |
11540 | 908 There are three timing methods in <application>MPlayer</application>. |
9675 | 909 |
910 <itemizedlist> | |
911 <listitem><simpara> | |
912 <emphasis role="bold">To use the old method</emphasis>, you don't have to do | |
913 anything. It uses <systemitem>usleep()</systemitem> to tune | |
914 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be | |
915 tuned even finer. | |
916 </simpara></listitem> | |
917 <listitem><para> | |
12779 | 918 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime Clock) |
9675 | 919 for this task, because it has precise 1ms timers. It is automagically enabled |
920 when available, but requires root privileges, a <emphasis>setuid root</emphasis> | |
921 <application>MPlayer</application> binary or a properly set up kernel. | |
922 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC | |
11668 | 923 frequency for normal users through the <systemitem class="systemname">/proc |
924 </systemitem> filesystem. Use this command to | |
9675 | 925 enable RTC for normal users: |
926 <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> | |
927 If you do not have such a new kernel, you can also change one line in | |
928 <filename>drivers/char/rtc.c</filename> and recompile your kernel. | |
929 Find the section that reads | |
930 <programlisting> | |
931 * We don't really want Joe User enabling more | |
932 * than 64Hz of interrupts on a multi-user machine. | |
933 */ | |
934 if ((rtc_freq > 64) && (!capable(CAP_SYS_RESOURCE))) | |
935 </programlisting> | |
936 and change the 64 to 1024. You should really know what you are doing, though. | |
937 You can see the new timer's efficiency in the status line. | |
938 The power management functions of some notebook BIOSes with speedstep CPUs | |
939 interact badly with RTC. Audio and video may get out of sync. Plugging the | |
940 external power connector in before you power up your notebook seems to help. | |
941 You can always turn off RTC support with the <option>-nortc</option> option. | |
942 In some hardware combinations (confirmed during usage of non-DMA DVD drive | |
943 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's | |
944 recommended to use the third method in these cases. | |
945 </para></listitem> | |
946 <listitem><simpara> | |
947 <emphasis role="bold">The third timer code</emphasis> is turned on with the | |
948 <option>-softsleep</option> option. It has the efficiency of the RTC, but it | |
949 doesn't use RTC. On the other hand, it requires more CPU. | |
950 </simpara></listitem> | |
951 </itemizedlist> | |
952 <note><para><emphasis role="bold">NEVER install a setuid root | |
953 <application>MPlayer</application> binary on a multiuser system!</emphasis> | |
954 It's a clear way for everyone to become root. | |
955 </para></note> | |
956 </para> | |
957 </sect1> | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
958 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
16663
diff
changeset
|
959 </chapter> |