annotate DOCS/xml/en/install.xml @ 19817:5bb6d8becb5b

Remove mpsub section, the format is documented in DOCS/tech.
author diego
date Wed, 13 Sep 2006 13:09:04 +0000
parents 9c5722ae5029
children 76d294537ff6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
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
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
4 <title>Installation</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
5
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
6 <para>
11311
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
7 A quick installation guide can be found in the <filename>README</filename>
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
8 file. Please read it first and then come back here for the rest of the gory
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
9 details.
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
10 </para>
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
11
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
12 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
13 In this section I'll try to guide you through the compiling and configuring
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
14 process of <application>MPlayer</application>. It's not easy, but it won't
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
15 necessarily be hard. If you experience a different behavior than what I
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
16 explain, please search through this documentation and you'll find your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
17 answers. If you see links, please follow them and read carefully what they
9677
142c42fa0986 sync with HTML
nicolas
parents: 9675
diff changeset
18 contain. It will take some time, but it IS worth it.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
19 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
20
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
21 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
22 You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
23 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
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
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
26 <title>Software requirements</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
27
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
28 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
29 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
30 <emphasis role="bold">binutils</emphasis> - suggested version is <emphasis role="bold">2.11.x</emphasis>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
31 This program is responsible for generating MMX/ 3DNow!/etc instructions,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
32 thus very important.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
33 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
34 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
35 <emphasis role="bold">gcc</emphasis> - suggested versions are: <emphasis role="bold">2.95.3</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
36 (maybe <emphasis role="bold">2.95.4</emphasis>) and <emphasis role="bold">3.2+</emphasis>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
37 <emphasis role="bold">Never</emphasis> use 2.96 or 3.0.x! They generate faulty code for
10132
nicolas
parents: 10000
diff changeset
38 <application>MPlayer</application>. If you decide to change gcc from
nicolas
parents: 10000
diff changeset
39 2.96, then don't decide in favor of 3.x just because it's newer! Early
nicolas
parents: 10000
diff changeset
40 releases of 3.x were even more buggy than 2.96. So downgrade to 2.95.x
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
41 (downgrade <systemitem class="library">libstdc++</systemitem> too, other
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
42 programs may need it) or don't up/downgrade at all (but in this case, be
10132
nicolas
parents: 10000
diff changeset
43 prepared for runtime problems). If you vote for 3.x, try to use the
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
44 latest version, early releases had various bugs, so be sure you use at
19735
15dc064c4d96 Remove reference to gcc-296 section, it's very outdated now.
diego
parents: 19734
diff changeset
45 least 3.1, it's tested and working.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
46 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
47 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
48 <emphasis role="bold">XFree86</emphasis> - suggested version is <emphasis role="bold">always the
10132
nicolas
parents: 10000
diff changeset
49 newest</emphasis> (4.3). Normally, everyone wants this, as starting
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
50 with XFree86 4.0.2, it contains the <link linkend="xv">XVideo</link>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
51 extension (somewhere referred to as <emphasis role="bold">Xv</emphasis>)
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
52 which is needed to enable the hardware YUV acceleration (fast image display)
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
53 on cards that support it.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
54 Make sure its <emphasis role="bold">development package</emphasis> is installed,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
55 too, otherwise it won't work.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
56 For some video cards you don't need XFree86. See list below.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
57 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
58 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
59 <emphasis role="bold">make</emphasis> - suggested version is
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
60 <emphasis role="bold">always the newest</emphasis> (at least 3.79.x). This
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
61 usually isn't important.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
62 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
63 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
64 <emphasis role="bold">SDL</emphasis> - it's not mandatory, but can help in
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
65 some cases (bad audio, video cards that lag strangely with the xv driver).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
66 Always use the newest (beginning from 1.2.x).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
67 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
68 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
69 <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
70 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
71 and <application>MEncoder</application> if
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
72 you plan to work with jpeg files.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
73 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
74 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
75 <emphasis role="bold">libpng</emphasis> - recommended and default (M)PNG decoder. Required for GUI.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
76 Useful for both <application>MPlayer</application> and
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
77 <application>MEncoder</application>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
78 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
79 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
80 <emphasis role="bold">lame</emphasis> - recommended, needed for encoding MP3 audio with
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
81 <application>MEncoder</application>, suggested version is
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
82 <emphasis>always the newest</emphasis> (at least 3.90).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
83 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
84 <listitem><para>
11324
9fceaedbd5a6 Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents: 11311
diff changeset
85 <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
86 MOV header and PNG support.
9fceaedbd5a6 Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents: 11311
diff changeset
87 </para></listitem>
9fceaedbd5a6 Missing <application> tags added, patch by Maciej Paszta <paszczi@go2.pl>.
diego
parents: 11311
diff changeset
88 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
89 <emphasis role="bold">libogg</emphasis> - optional, needed for playing OGG file format.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
90 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
91 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
92 <emphasis role="bold">libvorbis</emphasis> - optional, needed for playing OGG Vorbis audio.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
93 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
94 <listitem><para>
17461
db3327b8e590 s/LIVE.COM/LIVE555/ + URL update
gpoirier
parents: 17321
diff changeset
95 <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
96 - optional, needed for playing RTSP/RTP streams.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
97 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
98 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
99 <emphasis role="bold">directfb</emphasis> - optional, from
14048
8e4b54cea5cc We now only support directfb >= 0.9.13.
diego
parents: 14024
diff changeset
100 <ulink url="http://www.directfb.org"/>. At least 0.9.13 is required.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
101 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
102 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
103 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
104 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
105 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
106 <emphasis role="bold">libfreetype</emphasis> - optional, for TTF fonts
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
107 support. At least 2.0.9 is required.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
108 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
109 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
110 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
111 support. At least 1.2.7 is required.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
112 </para></listitem>
10132
nicolas
parents: 10000
diff changeset
113 <listitem><para>
nicolas
parents: 10000
diff changeset
114 <emphasis role="bold">libsmb</emphasis> - optional, for Samba support.
nicolas
parents: 10000
diff changeset
115 </para></listitem>
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12615
diff changeset
116 <listitem><para>
14310
f067fbec08e5 Document minimum required ALSA version.
diego
parents: 14121
diff changeset
117 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output
f067fbec08e5 Document minimum required ALSA version.
diego
parents: 14121
diff changeset
118 support. At least 0.9.0rc4 is required.
f067fbec08e5 Document minimum required ALSA version.
diego
parents: 14121
diff changeset
119 </para></listitem>
f067fbec08e5 Document minimum required ALSA version.
diego
parents: 14121
diff changeset
120 <listitem><para>
12662
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12615
diff changeset
121 <emphasis role="bold">bio2jack</emphasis> - optional, for JACK audio output
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
122 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
123 <ulink url="http://bio2jack.sf.net/">http://bio2jack.sf.net</ulink>. Since it
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
124 doesn't have install option you have to manually put the file
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
125 <filename>libbio2jack.a</filename> somewhere in your library path
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
126 (e.g. <filename>/usr/local/lib</filename>) or use the
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
127 <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
128 <filename>./configure</filename> where that file is.
05d46af5e2bf JACK audio support through bio2jack by Kamil Strzelecki <esack@o2.pl>
alex
parents: 12615
diff changeset
129 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
130 </itemizedlist>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
131 </sect1>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
132
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
133
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
134 <sect1 id="video-cards">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
135 <title>Video cards</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
136
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
137 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
138 There are generally two kind of video cards. One kind (the newer cards) has
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139 <emphasis role="bold">hardware scaling and YUV acceleration</emphasis> support,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
140 the other cards don't.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
141 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
142
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
143
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
144 <sect2 id="yuv-cards">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
145 <title>YUV cards</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
146
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
147 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
148 They can display and scale (zoom) the picture to any size that fits in
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
149 their memory, with <emphasis role="bold">small CPU usage</emphasis> (even when
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
150 zooming), thus fullscreen is nice and very fast.
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
151
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
152 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
153 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154 <emphasis role="bold">Matrox G200/G400/G450/G550 cards</emphasis>: although a
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
155 <link linkend="vidix">Vidix driver</link> is provided, it is recommended to
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
156 use the mga_vid module instead, for it works much better.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
157 Please see the <link linkend="mga_vid">mga_vid</link> section about its
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
158 installation and usage. It is important to do these steps
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
159 <emphasis>before</emphasis> compiling <application>MPlayer</application>,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160 otherwise no mga_vid support will be built. Also check out the
11394
4e8081a50351 small fix by Maciej Paszta <paszczi@go2.pl>
diego
parents: 11324
diff changeset
161 <link linkend="tvout-mga-g400">Matrox TV-out</link> section.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
162 <emphasis role="bold"> If you don't use Linux</emphasis>, your only
9683
nicolas
parents: 9677
diff changeset
163 possibility is the VIDIX driver: read the <link linkend="vidix">VIDIX</link> section.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
164 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
165 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166 <emphasis role="bold">3Dfx Voodoo3/Banshee cards</emphasis>: please see
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
167 <link linkend="tdfxfb">tdfxfb</link> section in order to gain big speedup.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
168 It is important to do these steps <emphasis role="bold">before</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
169 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
170 built.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
171 If you use X, use at least <emphasis role="bold">4.2.0</emphasis>, as 3dfx Xv
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
172 driver was broken in 4.1.0, and earlier releases.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
174 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
175 <emphasis role="bold">ATI cards</emphasis>: <link linkend="vidix">VIDIX</link>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
176 driver is provided for the following cards:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
177 <emphasis role="bold">Radeon, Rage128, Mach64</emphasis> (Rage XL/Mobility, Xpert98).
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
178 Also see the <link linkend="tvout-ati">ATI cards</link> section of the TV-out documentation,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
179 to know if you card's TV-out is supported under Linux/<application>MPlayer</application>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
180 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
181 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
182 <emphasis role="bold">S3 cards</emphasis>: the Savage and Virge/DX chips have
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
183 hardware acceleration. Use as new XFree86 version as possible, older drivers are
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
184 buggy. Savage chips have problems with YV12 display, see <link linkend="s3">S3 Xv</link>
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
185 section for details. Older, Trio cards have no, or slow hardware support.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
186 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
187 <listitem><para>
9683
nicolas
parents: 9677
diff changeset
188 <emphasis role="bold">nVidia cards</emphasis>: may or may not be good choice for video playing.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
189 If you do not have a GeForce2 (or newer) card, it's not likely to work without bugs.
9683
nicolas
parents: 9677
diff changeset
190 <emphasis role="bold">the built-in nVidia driver in XFree86 does not support
nicolas
parents: 9677
diff changeset
191 hardware YUV acceleration on all nVidia cards.</emphasis> You have
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
192 to download nVidia's closed-source drivers from <ulink url="http://nvidia.com">nVidia.com</ulink>.
11461
25d13a2b1911 Link added by Maciej Paszta <paszczi@go2.pl>.
diego
parents: 11394
diff changeset
193 See the <link linkend="nvidia">nVidia Xv driver</link> section for details. Please also check
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
194 the <link linkend="tvout-nvidia">nVidia TV-out</link> section if you wish to
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
195 use a TV.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
196 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
197 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
198 <emphasis role="bold">3DLabs GLINT R3 and Permedia3</emphasis>: a VIDIX driver
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
199 is provided (pm3_vid). Please see the <link linkend="vidix">VIDIX</link> section
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
200 for details.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
201 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
202 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
203 <emphasis role="bold">Other cards</emphasis>: none of the above?
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
204 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
205 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
206 Try if the XFree86 driver (and your card) supports hardware
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
207 acceleration. See the <link linkend="xv">Xv</link> section for details.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
208 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
209 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
210 If it doesn't, then your card's video features aren't supported under
9683
nicolas
parents: 9677
diff changeset
211 your operating system :( If hardware scaling works under Windows, it
nicolas
parents: 9677
diff changeset
212 doesn't mean it will work under Linux or other operating system, it depends on
nicolas
parents: 9677
diff changeset
213 the drivers. Most manufacturers neither make Linux drivers nor release
nicolas
parents: 9677
diff changeset
214 specifications of their chips - so you are unlucky if using their cards.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
215 See <xref linkend="non-yuv-cards"/>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
216 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
217 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
218 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
219 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
220 </para>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
221 </sect2>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
222
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
223
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
224 <sect2 id="non-yuv-cards" xreflabel="Non-YUV cards">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
225 <title>Non-YUV cards</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
226
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
227 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
228 Fullscreen playing can be achieved by either enabling <emphasis role="bold">
9683
nicolas
parents: 9677
diff changeset
229 software scaling</emphasis> (use the <option>-zoom</option> or <option>-vf</option> option,
11501
8f43eb278413 Small fix by Maciej Paszta.
rathann
parents: 11488
diff changeset
230 but I warn you: this is slow), or switching to a smaller video mode, for example
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
231 352x288. If you don't have YUV acceleration, this latter method is recommended.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
232 Video mode switching can be enabled by using the <option>-vm</option> option and
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
233 it works with the following drivers:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
234 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
235 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
236 <emphasis role="bold">using</emphasis> XFree86: see details in <link linkend="dga">DGA driver</link> and
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
237 <link linkend="x11">X11 driver</link> sections. DGA is recommended! Also
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
238 try DGA via SDL, sometimes it's better.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
239 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
240 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
241 <emphasis role="bold">not using</emphasis> XFree86: try the drivers in the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
242 following order:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
243 <link linkend="vesa">vesa</link>,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
244 <link linkend="fbdev">fbdev</link>,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
245 <link linkend="svgalib">svgalib</link>,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
246 <link linkend="aalib">aalib</link>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
247 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
248 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
249 </para>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
250 </sect2>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
251
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
252 <!-- 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
253 <sect2 id="cirrus-logic-cards" xreflabel="Cirrus-Logic cards">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
254 <title>Cirrus-Logic cards</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
255 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
256 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
257 GD 7548: present on-board and tested in Compaq Armada 41xx notebook series.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
258 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
259 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
260 XFree86 3: works in 8/16bpp modes. However, the driver is dramatically slow
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
261 and buggy in 800x600@16bpp. <emphasis role="bold">Recommended: 640x480@16bpp</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
262 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
263 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
264 XFree86 4: the Xserver freezes soon after start unless acceleration is
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
265 disabled, but then the whole thing gets slower than XFree86 3. No XVideo.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
266 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
267 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
268 FBdev: framebuffer can be turned on with the <systemitem>clgenfb</systemitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
269 driver in the kernel, though for me it worked only in 8bpp, thus unusable.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
270 The clgenfb source had to be extended with the 7548 ID before compilation.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
271 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
272 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
273 VESA: the card is only VBE 1.2 capable, so VESA output can't be used. Can't
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
274 be workarounded with UniVBE.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
275 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
276 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
277 SVGAlib: detects an older Cirrus chip. Usable but slow with
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
278 <option>-bpp 8</option>.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
279 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
280 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
281 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
282 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
283 </sect2>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
284 </sect1>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
285
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
286
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
287 <sect1 id="sound-cards">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
288 <title>Sound cards</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
289
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
290 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
291 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
292 <emphasis role="bold">Soundblaster Live!</emphasis>: with this card you can use
9683
nicolas
parents: 9677
diff changeset
293 4 or 6 (<emphasis role="bold">5.1</emphasis>) channels AC3 decoding instead of 2. Read the
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
294 <link linkend="swac3">Software AC3 decoding</link> section. For hardware AC3
9683
nicolas
parents: 9677
diff changeset
295 passthrough you <emphasis role="bold">must</emphasis> use ALSA 0.9 with OSS emulation!
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
296 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
297 <listitem><simpara>
12369
6c19f8e780fc S/PDIF spelling corrected
wight
parents: 11822
diff changeset
298 <emphasis role="bold">C-Media with S/PDIF out</emphasis>: hardware AC3
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
299 passthrough is possible with these cards, see
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
300 <link linkend="hwac3">Hardware AC3 decoding</link> section.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
301 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
302 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
303 Features of <emphasis role="bold">other cards</emphasis> aren't supported by
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
304 <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
305 to read the <link linkend="audio">sound card</link> section!</emphasis>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
306 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
307 </itemizedlist>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
308 </sect1>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
309
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
310
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
311 <sect1 id="features">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
312 <title>Features</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
313
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
314 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
315 <listitem><para>
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
316 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link>
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
317 section before compiling.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
318 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
319 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
320 If you want to install <application>MEncoder</application> (our great
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
321 all-purpose encoder), see the
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
322 <link linkend="mencoder"><application>MEncoder</application></link> section.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
323 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
324 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
325 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
326 and wish to watch/grab and encode movies with <application>MPlayer</application>,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
327 read the <link linkend="tv-input">TV input</link> section.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
328 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
329 <listitem><para>
19583
94e4ef4195d3 Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents: 19568
diff changeset
330 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
331 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
332 read the <link linkend="radio">radio</link> section.
19568
bd821fd3e244 Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents: 19082
diff changeset
333 </para></listitem>
bd821fd3e244 Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents: 19082
diff changeset
334 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
335 There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
336 used. Check the <link linkend="subosd">OSD menu</link> section.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
337 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
338 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
339
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
340 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
341 Then build <application>MPlayer</application>:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
342 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
343 ./configure
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
344 make
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
345 make install</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
346 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
347
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
348 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
349 At this point, <application>MPlayer</application> is ready to use. The
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
350 directory <filename class="directory">$PREFIX/share/mplayer</filename>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
351 contains the <filename>codecs.conf</filename> file, which is used to tell
10132
nicolas
parents: 10000
diff changeset
352 the program all the codecs and their capabilities. This file is needed only
nicolas
parents: 10000
diff changeset
353 when you want to change its properties, as the main binary contains an internal
nicolas
parents: 10000
diff changeset
354 copy of it. Check if you have
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
355 <filename>codecs.conf</filename> in your home directory
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
356 (<filename>~/.mplayer/codecs.conf</filename>) left from old
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
357 <application>MPlayer</application> versions, and remove it.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
358 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
359
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
360 <para>
10403
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
361 Note that if you have a <filename>codecs.conf</filename> in
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
362 <filename>~/.mplayer/</filename>, the builtin and system
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
363 <filename>codecs.conf</filename> will be ignored completely.
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
364 Do not do this unless you want to fiddle with <application>MPlayer</application>
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
365 internals as this can can cause many problems. If you want to change the codecs
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
366 search order, use the <option>-vc</option>, <option>-ac</option>, <option>-vfm</option>,
10403
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
367 or <option>-afm</option> options either on the command line or in your
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
368 config file (see the manual page).
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
369 </para>
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
370
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
371
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
372 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
373 Debian users can build a .deb package for themselves, it's very simple.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
374 Just exec
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
375 <screen>fakeroot debian/rules binary</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
376 in <application>MPlayer</application>'s root directory. See
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 10913
diff changeset
377 <link linkend="debian">Debian packaging</link> for detailed instructions.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
378 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
379
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
380 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
381 <emphasis role="bold">Always browse the output of</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
382 <filename>./configure</filename>, and the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
383 <filename>configure.log</filename> file, they contain information about
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
384 what will be built, and what will not. You may also want to view
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
385 <filename>config.h</filename> and <filename>config.mak</filename> files.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
386 If you have some libraries installed, but not detected by
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
387 <filename>./configure</filename>, then check if you also have the proper
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
388 header files (usually the -dev packages) and their version matches. The
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
389 <filename>configure.log</filename> file usually tells you what is missing.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
390 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
391
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
392 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
393 Though not mandatory, the fonts should be installed in order to gain OSD,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
394 and subtitle functionality. The recommended method is installing a TTF
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
395 font file and telling <application>MPlayer</application> to use it.
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
396 See the <link linkend="subosd">Subtitles and OSD</link> section for details.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
397 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
398
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
399 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
400
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
401 <!-- ********** -->
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
402
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
403 <sect1 id="gui">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
404 <title>What about the GUI?</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
405
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
406 <para>
16663
2965acaa980f CVS now supports GTK 2.0
gpoirier
parents: 16003
diff changeset
407 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are).
2965acaa980f CVS now supports GTK 2.0
gpoirier
parents: 16003
diff changeset
408 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
409 (and their devel stuff, usually called <systemitem class="library">gtk-dev</systemitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
410 and <systemitem class="library">libpng-dev</systemitem>) has to be installed.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
411 You can build it by specifying <option>--enable-gui</option> during
10000
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
412 <filename>./configure</filename>. Then, to turn on GUI mode, you have to
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
413 execute the <command>gmplayer</command> binary.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
414 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
415
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
416 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
417 Currently you can't use the <option>-gui</option> option on the command
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
418 line, due to technical reasons.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
419 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
420
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
421 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
422 As <application>MPlayer</application> doesn't have a skin included, you
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
423 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
424 url="http://www.mplayerhq.hu/dload.html">download page</ulink>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
425 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
426 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
427 class="directory">$HOME/.mplayer/skins</filename>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
428 <application>MPlayer</application> by default looks in these directories
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
429 for a directory named <filename class="directory">default</filename>, but
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
430 you can use the <option>-skin <replaceable>newskin</replaceable></option>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
431 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
432 the skin in <filename class="directory">*/skins/newskin</filename>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
433 directory.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
434 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
435 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
436
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
437 <!-- ********** -->
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
438
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
439 <sect1 id="subosd">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
440 <title>Subtitles and OSD</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
441
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
442 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
443 <application>MPlayer</application> can display subtitles along with movie files.
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
444 Currently the following formats are supported:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
445 <itemizedlist>
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12578
diff changeset
446 <listitem><para>VOBsub</para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
447 <listitem><para>OGM</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
448 <listitem><para>CC (closed caption)</para></listitem>
11687
510bfea8ab6c MicroDVD, not Microdvd
wight
parents: 11668
diff changeset
449 <listitem><para>MicroDVD</para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
450 <listitem><para>SubRip</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
451 <listitem><para>SubViewer</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
452 <listitem><para>Sami</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
453 <listitem><para>VPlayer</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
454 <listitem><para>RT</para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
455 <listitem><para>SSA</para></listitem>
11794
93f616ec5e98 Unknown subtitle format is PJS as pointed out by Salvador Eduardo Tropea.
diego
parents: 11758
diff changeset
456 <listitem><para>PJS (Phoenix Japanimation Society)</para></listitem>
19817
5bb6d8becb5b Remove mpsub section, the format is documented in DOCS/tech.
diego
parents: 19804
diff changeset
457 <listitem><para>MPsub</para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
458 <listitem><para>AQTitle</para></listitem>
10277
157cb3f9245e SuSE RPMs, JACOsub link
diego
parents: 10185
diff changeset
459 <listitem><para><ulink url="http://unicorn.us.com/jacosub/">JACOsub</ulink></para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
460 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
461 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
462
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
463 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
464 <application>MPlayer</application> can dump the previously listed subtitle formats
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
465 (<emphasis role="bold">except the three first</emphasis>) into the following
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
466 destination formats, with the given options:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
467 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
468 <listitem><para>MPsub: <option>-dumpmpsub</option></para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
469 <listitem><para>SubRip: <option>-dumpsrtsub</option></para></listitem>
11687
510bfea8ab6c MicroDVD, not Microdvd
wight
parents: 11668
diff changeset
470 <listitem><para>MicroDVD: <option>-dumpmicrodvdsub</option></para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
471 <listitem><para>JACOsub: <option>-dumpjacosub</option></para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
472 <listitem><para>Sami: <option>-dumpsami</option></para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
473 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
474 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
475
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
476 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
477 <application>MEncoder</application> can dump DVD subtitles into
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12578
diff changeset
478 <link linkend="menc-feat-extractsub">VOBsub</link> format.
10132
nicolas
parents: 10000
diff changeset
479 </para>
nicolas
parents: 10000
diff changeset
480
nicolas
parents: 10000
diff changeset
481 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
482 The command line options differ slightly for the different formats:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
483 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
484
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
485 <formalpara>
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12578
diff changeset
486 <title>VOBsub subtitles</title>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
487 <para>
12615
84e078fd64b4 uniform VOBsub spelling
diego
parents: 12578
diff changeset
488 VOBsub subtitles consist of a big (some megabytes) <filename>.SUB</filename> file,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
489 and optional <filename>.IDX</filename> and/or <filename>.IFO</filename>
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
490 files. If you have files like
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
491 <filename><replaceable>sample.sub</replaceable></filename>,
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
492 <filename><replaceable>sample.ifo</replaceable></filename> (optional),
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
493 <filename><replaceable>sample.idx</replaceable></filename> - you have to pass
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
494 <application>MPlayer</application> the <option>-vobsub sample
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
495 [-vobsubid <replaceable>id</replaceable>]</option> options
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
496 (full path optional). The <option>-vobsubid</option> option is like
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
497 <option>-sid</option> for DVDs, you can choose between subtitle tracks
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
498 (languages) with it. In case that <option>-vobsubid</option> is omitted,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
499 <application>MPLayer</application> will try to use the languages given by the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
500 <option>-slang</option> option and fall back to the <systemitem>langidx</systemitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
501 in the <filename>.IDX</filename> file to set the subtitle language. If it fails,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
502 there will be no subtitles.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
503 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
504 </formalpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
505
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
506 <formalpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
507 <title>Other subtitles</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
508 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
509 The other formats consist of a single text file containing timing,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
510 placement and text information. Usage: If you have a file like
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
511 <filename><replaceable>sample.txt</replaceable></filename>,
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
512 you have to pass the option <option>-sub
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
513 <replaceable>sample.txt</replaceable></option> (full path optional).
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
514 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
515 </formalpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
516
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
517 <variablelist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
518 <title>Adjusting subtitle timing and placement:</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
519 <varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
520 <term><option>-subdelay <replaceable>sec</replaceable></option></term>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
521 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
522 Delays subtitles by <option><replaceable>sec</replaceable></option> seconds.
14467
d03e8e7f9b26 Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents: 14421
diff changeset
523 Can be negative. The value is added to movie's time position counter.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
524 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
525 </varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
526 <varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
527 <term><option>-subfps <replaceable>RATE</replaceable></option></term>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
528 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
529 Specify frame/sec rate of subtitle file (float number).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
530 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
531 </varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
532 <varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
533 <term><option>-subpos <replaceable>0-100</replaceable></option></term>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
534 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
535 Specify the position of subtitles.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
536 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
537 </varlistentry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
538 </variablelist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
539
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
540 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
541 If you experience a growing delay between the movie and the subtitles when
16003
diego
parents: 14655
diff changeset
542 using a MicroDVD subtitle file, most likely the framerate of the movie and
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
543 the subtitle file are different. Please note that the MicroDVD subtitle
14472
644041677057 Format correction in microdvdsub section.
jheryan
parents: 14467
diff changeset
544 format uses absolute frame numbers for its timing, but there is no fps
644041677057 Format correction in microdvdsub section.
jheryan
parents: 14467
diff changeset
545 information in it, and therefore the <option>-subfps</option> option should
644041677057 Format correction in microdvdsub section.
jheryan
parents: 14467
diff changeset
546 be used with this format. If you like to solve this problem permanently,
644041677057 Format correction in microdvdsub section.
jheryan
parents: 14467
diff changeset
547 you have to manually convert the subtitle file framerate.
644041677057 Format correction in microdvdsub section.
jheryan
parents: 14467
diff changeset
548 <application>MPlayer</application> can do this
14467
d03e8e7f9b26 Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents: 14421
diff changeset
549 conversion for you:
d03e8e7f9b26 Bugfix and improve microdvd conversion and bugfix section.
jheryan
parents: 14421
diff changeset
550
14648
069ee5fb161c Remove unnecessary options from the -dumpmicrodvdsub command line and add
diego
parents: 14497
diff changeset
551 <screen>mplayer -dumpmicrodvdsub -fps <replaceable>subtitles_fps</replaceable> -subfps <replaceable>avi_fps</replaceable> -sub <replaceable>subtitle_filename</replaceable> <replaceable>dummy.avi</replaceable></screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
552 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
553
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
554 <para>
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
555 About DVD subtitles, read the <link linkend="dvd">DVD</link> section.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
556 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
557
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
558
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
559 <sect2 id="mpsub-install">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
560 <title>Installing OSD and subtitles</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
561
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
562 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
563 You need an <application>MPlayer</application> font package to be able to use
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
564 OSD/SUB feature. There are many ways to get it:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
565 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
566
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
567 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
568 <listitem><para>
10132
nicolas
parents: 10000
diff changeset
569 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
570 library. Version 2.0.9 or greater is mandatory! Then you have two methods:
10132
nicolas
parents: 10000
diff changeset
571 <itemizedlist>
nicolas
parents: 10000
diff changeset
572 <listitem><para>
11654
8bdbc6a93d74 added <systemitem> tag for fontconfig, some wording
paszczi
parents: 11649
diff changeset
573 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
574 option to specify a TrueType font file on every occasion
10132
nicolas
parents: 10000
diff changeset
575 </para></listitem>
nicolas
parents: 10000
diff changeset
576 <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
577 create a symlink:
11654
8bdbc6a93d74 added <systemitem> tag for fontconfig, some wording
paszczi
parents: 11649
diff changeset
578 <screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen>
10132
nicolas
parents: 10000
diff changeset
579 </para></listitem>
nicolas
parents: 10000
diff changeset
580 </itemizedlist>
11588
bd910f698b8d reorganization of subtitles and osd section, removed repeating lines, patch by me and Torinthiel
paszczi
parents: 11587
diff changeset
581 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
582 <systemitem class="library">fontconfig</systemitem> support, the above methods
11654
8bdbc6a93d74 added <systemitem> tag for fontconfig, some wording
paszczi
parents: 11649
diff changeset
583 won't work, instead the <option>-font</option> expects a
8bdbc6a93d74 added <systemitem> tag for fontconfig, some wording
paszczi
parents: 11649
diff changeset
584 <systemitem class="library">fontconfig</systemitem> font name
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
585 and defaults to the sans-serif font. To get a list of fonts known to
11655
4df4089eded9 and one last fontconfig
wight
parents: 11654
diff changeset
586 <systemitem class="library">fontconfig</systemitem>,
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
587 use <command>fc-list</command>. Example: <option>-font
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
588 <replaceable>'Bitstream Vera Sans'</replaceable></option>
10132
nicolas
parents: 10000
diff changeset
589 </para></listitem>
nicolas
parents: 10000
diff changeset
590 <listitem><para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
591 Download ready-to-use font packages from <application>MPlayer</application>
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
592 site. Note: currently available fonts are limited for ISO 8859-1/2 support,
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
593 but there are some other (including Korean, Russian, ISO 8859-8 etc) fonts at
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
594 contrib/font section of FTP, made by users.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
595 </para><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
596 <!-- FIXME: this para should be before the list -->
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
597 Font should have appropriate <filename>font.desc</filename> file which
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
598 maps unicode font positions to the actual code page of the subtitles
13003
diego
parents: 12815
diff changeset
599 text. Other solution is to have subtitles encoded in UTF-8 encoding and
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
600 use <option>-utf8</option> option or just name the subtitles file
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
601 <filename>&lt;video_name&gt;.utf</filename> and have it in the same dir
13003
diego
parents: 12815
diff changeset
602 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
603 done by using <command>konwert</command> or <command>iconv</command> programs.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
604 </para><para>
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
605
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
606 <table>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
607 <title>Some URLs</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
608 <tgroup cols="2">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
609 <thead>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
610 <row><entry>URL</entry><entry>Comment</entry></row>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
611 </thead>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
612 <tbody>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
613 <row><entry>
9683
nicolas
parents: 9677
diff changeset
614 <ulink url="ftp://ftp.mplayerhq.hu/MPlayer/releases/fonts/"></ulink>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
615 </entry><entry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
616 ISO fonts
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
617 </entry></row>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
618 <row><entry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
619 <ulink url="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/"></ulink>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
620 </entry><entry>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
621 various fonts by users
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
622 </entry></row>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
623 </tbody>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
624 </tgroup>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
625 </table>
10132
nicolas
parents: 10000
diff changeset
626
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
627 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
628 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
629 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
630 If you chose non-TTF fonts, UNZIP the file you downloaded to <filename
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
631 class="directory">~/.mplayer</filename> or <filename
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
632 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
633 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
634 for example:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
635
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
636 <screen>ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font</screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
637
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
638 Now you have to see a timer at the upper left corner of the movie (switch
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
639 it off with the <keycap>o</keycap> key).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
640 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
641
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
642 <para>
9736
520f6d60bf75 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
643 (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
644 read the man page)
9737
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
645 </para>
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
646
9736
520f6d60bf75 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
647 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
648 OSD has 4 states (switch with <keycap>o</keycap>):
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
649
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
650 <orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
651 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
652 volume bar + seek bar (default)
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
653 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
654 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
655 volume bar + seek bar + timer + file position percentage on seeking
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
656 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
657 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
658 volume bar + seek bar + timer + total duration of the media
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
659 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
660 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
661 subtitles only
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
662 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
663 </orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
664
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
665 You can change default behaviour by setting <varname>osdlevel</varname>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
666 variable in config file, or the <option>-osdlevel</option> command line option.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
667
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
668 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
669 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
670
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
671
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
672 <sect2 id="osdmenu">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
673 <title>OSD menu</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
674
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
675 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
676 <application>MPlayer</application> has a completely user definiable OSD Menu interface.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
677 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
678
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
679 <note><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
680 the Preferences menu is currently UNIMPLEMENTED!
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
681 </simpara></note>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
682
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
683 <orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
684 <title>Installation</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
685 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
686 compile <application>MPlayer</application> by passing the <option>--enable-menu</option>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
687 to <filename>./configure</filename>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
688 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
689 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
690 make sure you have an OSD font installed
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
691 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
692 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
693 copy <filename>etc/menu.conf</filename> to your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
694 <filename class="directory">.mplayer</filename> directory
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
695 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
696 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
697 copy <filename>etc/input.conf</filename> to your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
698 <filename class="directory">.mplayer</filename> directory, or to the system-wide
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
699 <application>MPlayer</application> config dir (default:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
700 <filename class="directory">/usr/local/etc/mplayer</filename>)
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
701 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
702 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
703 check and edit <filename>input.conf</filename> to enable menu movement keys
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
704 (it is described there).
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
705 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
706 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
707 start <application>MPlayer</application> by the following example:
11713
a1bc8133084a <replaceable> tags' attack :P
paszczi
parents: 11687
diff changeset
708 <screen>$ mplayer -menu <replaceable>file.avi</replaceable></screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
709 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
710 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
711 push any menu key you defined
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
712 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
713 </orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
714
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
715 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
716 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
717
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
718 <!-- ********** -->
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
719
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
720 <sect1 id="rtc">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
721 <title>RTC</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
722 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
723 There are three timing methods in <application>MPlayer</application>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
724
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
725 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
726 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
727 <emphasis role="bold">To use the old method</emphasis>, you don't have to do
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
728 anything. It uses <systemitem>usleep()</systemitem> to tune
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
729 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
730 tuned even finer.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
731 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
732 <listitem><para>
12779
diego
parents: 12767
diff changeset
733 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime Clock)
19773
194a53413994 RTC is no longer the default timing method.
diego
parents: 19761
diff changeset
734 for this task, because it has precise 1ms timers. The <option>-rtc</option>
194a53413994 RTC is no longer the default timing method.
diego
parents: 19761
diff changeset
735 option enables it, but a properly set up kernel is required.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
736 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC
11668
18326298f607 added <systemitem class=systemname> tag to /proc
paszczi
parents: 11665
diff changeset
737 frequency for normal users through the <systemitem class="systemname">/proc
18326298f607 added <systemitem class=systemname> tag to /proc
paszczi
parents: 11665
diff changeset
738 </systemitem> filesystem. Use this command to
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
739 enable RTC for normal users:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
740 <screen>echo 1024 &gt; /proc/sys/dev/rtc/max-user-freq</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
741 You can see the new timer's efficiency in the status line.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
742 The power management functions of some notebook BIOSes with speedstep CPUs
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
743 interact badly with RTC. Audio and video may get out of sync. Plugging the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
744 external power connector in before you power up your notebook seems to help.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
745 In some hardware combinations (confirmed during usage of non-DMA DVD drive
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
746 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
747 recommended to use the third method in these cases.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
748 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
749 <listitem><simpara>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
750 <emphasis role="bold">The third timer code</emphasis> is turned on with the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
751 <option>-softsleep</option> option. It has the efficiency of the RTC, but it
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
752 doesn't use RTC. On the other hand, it requires more CPU.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
753 </simpara></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
754 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
755 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
756 </sect1>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
757
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
758 </chapter>