annotate DOCS/xml/en/install.xml @ 10277:157cb3f9245e

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