annotate DOCS/xml/en/install.xml @ 27818:6b0e98eb48e9

Move codec installation instructions from the codecs section to a more sensible place in the installation section.
author diego
date Thu, 30 Oct 2008 09:06:34 +0000
parents e05a9299b946
children e78a2facbd7a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
20535
c0687e92d463 convert DOCS/xml/en and help_mp-en.h to UTF-8
kraymer
parents: 20396
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
10913
49b1a67e7381 Add revision keyword to english xml files, to ease translation synchronization
lumag
parents: 10403
diff changeset
2 <!-- $Revision$ -->
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
3 <chapter id="install">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
4 <title>Installation</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
5
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
6 <para>
11311
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
7 A quick installation guide can be found in the <filename>README</filename>
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
8 file. Please read it first and then come back here for the rest of the gory
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
9 details.
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
10 </para>
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
11
92b8eae72aca Mention README.
diego
parents: 11271
diff changeset
12 <para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
13 In this section you will be guided through the compilation and configuration
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
14 process of <application>MPlayer</application>. It's not easy, but it won't
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
15 necessarily be hard. If you experience a behavior different from this
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
16 description, please search through this documentation and you'll find your
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
17 answers.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
18 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
19
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
20
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
21 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
22
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
23
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
24 <sect1 id="softreq">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
25 <title>Software requirements</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
26
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
27 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
28 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
29 <emphasis role="bold">binutils</emphasis> - recommended version is
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
30 <emphasis role="bold">2.11.x</emphasis>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
31 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
32 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
33 <emphasis role="bold">gcc</emphasis> - recommended versions are 2.95
20850
fa032dca75f8 Recommend gcc 3.4+.
diego
parents: 20818
diff changeset
34 and 3.4+. 2.96 and 3.0.x are known to generate faulty code, 3.1 and
20854
44102c48069a Restore PowerPC gcc note that I mistakenly removed.
diego
parents: 20850
diff changeset
35 3.2 also had problems, 3.3 some minor ones. On PowerPC, use 4.x.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
36 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
37 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
38 <emphasis role="bold">Xorg/XFree86</emphasis> - recommended version is
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
39 4.3 or later. Make sure the
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
40 <emphasis role="bold">development packages</emphasis> are installed,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
41 too, otherwise it won't work.
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
42 You don't absolutely need X, some video output drivers work without it.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
43 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
44 <listitem><para>
27816
e05a9299b946 We now require GNU make 3.81.
diego
parents: 27814
diff changeset
45 <emphasis role="bold">GNU make</emphasis> 3.81
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
46 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
47 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
48 <emphasis role="bold">FreeType</emphasis> - 2.0.9 or later is required
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
49 for the OSD and subtitles
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
50 </para></listitem>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
51 <listitem><para>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
52 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
53 support. At least 0.9.0rc4 is required.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
54 </para></listitem>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
55 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
56 <emphasis role="bold">libjpeg</emphasis> -
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
57 required for the optional JPEG video output driver
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
58 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
59 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
60 <emphasis role="bold">libpng</emphasis> -
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
61 required for the optional PNG video output driver
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
62 </para></listitem>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
63 <listitem><para>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
64 <emphasis role="bold">directfb</emphasis> - optional, 0.9.13 or later
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
65 required for the directfb video output driver
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
66 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
67 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
68 <emphasis role="bold">lame</emphasis> - 3.90 or later is recommended,
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
69 necessary for encoding MP3 audio with <application>MEncoder</application>.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
70 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
71 <listitem><para>
27814
1bc1d241f635 zlib is used in many places.
diego
parents: 27813
diff changeset
72 <emphasis role="bold">zlib</emphasis> - recommended, many codecs use it.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
73 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
74 <listitem><para>
17461
db3327b8e590 s/LIVE.COM/LIVE555/ + URL update
gpoirier
parents: 17321
diff changeset
75 <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
76 - optional, needed for some RTSP/RTP streams
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
77 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
78 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
79 <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
80 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
81 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
82 <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
83 support. At least 1.2.7 is required.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
84 </para></listitem>
10132
nicolas
parents: 10000
diff changeset
85 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
86 <emphasis role="bold">libsmb</emphasis> - optional, for SMB networking support
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
87 </para></listitem>
27813
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
88 <listitem><para>
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
89 <emphasis role="bold"><ulink url="http://www.underbit.com/products/mad/">libmad</ulink></emphasis>
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
90 - optional, for for fast integer-only MP3 decoding on FPU-less platforms
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
91 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
92 </itemizedlist>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
93 </sect1>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
94
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
95
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
96 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
97
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
98
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
99 <sect1 id="features">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
100 <title>Features</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
101
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
102 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
103 <listitem><para>
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
104 Decide if you need GUI. If you do, see the <link linkend="gui">GUI</link>
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
105 section before compiling.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
106 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
107 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
108 If you want to install <application>MEncoder</application> (our great
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
109 all-purpose encoder), see the
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
110 <link linkend="mencoder"><application>MEncoder</application></link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
111 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
112 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
113 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card,
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
114 and wish to watch/grab and encode movies with
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
115 <application>MPlayer</application>,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
116 read the <link linkend="tv-input">TV input</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
117 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
118 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
119 If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
120 card, and wish to listen and capture sound with
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
121 <application>MPlayer</application>,
19583
94e4ef4195d3 Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents: 19568
diff changeset
122 read the <link linkend="radio">radio</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
123 </para></listitem>
19568
bd821fd3e244 Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents: 19082
diff changeset
124 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
125 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
126 used. Check the <link linkend="subosd">OSD menu</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
127 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
128 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
129
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
130 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
131 Then build <application>MPlayer</application>:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
132 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
133 ./configure
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
134 make
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
135 make install
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
136 </screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
137 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
138
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139 <para>
23143
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
140 At this point, <application>MPlayer</application> is ready to use.
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
141 Check if you have a <filename>codecs.conf</filename> file in your home
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
142 directory at (<filename>~/.mplayer/codecs.conf</filename>) left from old
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
143 <application>MPlayer</application> versions. If you find one, remove it.
10403
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
144 </para>
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
145
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
146 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
147 Debian users can build a .deb package for themselves, it's very simple.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
148 Just exec
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
149 <screen>fakeroot debian/rules binary</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
150 in <application>MPlayer</application>'s root directory. See
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 10913
diff changeset
151 <link linkend="debian">Debian packaging</link> for detailed instructions.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
152 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
153
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
155 <emphasis role="bold">Always browse the output of</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
156 <filename>./configure</filename>, and the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
157 <filename>configure.log</filename> file, they contain information about
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
158 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
159 <filename>config.h</filename> and <filename>config.mak</filename> files.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160 If you have some libraries installed, but not detected by
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
161 <filename>./configure</filename>, then check if you also have the proper
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
162 header files (usually the -dev packages) and their version matches. The
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
163 <filename>configure.log</filename> file usually tells you what is missing.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
164 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
165
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
167 Though not mandatory, the fonts should be installed in order to gain OSD,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
168 and subtitle functionality. The recommended method is installing a TTF
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
169 font file and telling <application>MPlayer</application> to use it.
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
170 See the <link linkend="subosd">Subtitles and OSD</link> section for details.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
171 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
172 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
174
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
175 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
176
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
177
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
178 <sect1 id="gui">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
179 <title>What about the GUI?</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
180
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
181 <para>
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
182 The GUI needs GTK 1.2.x or GTK 2.0 (it isn't fully GTK, but the panels are),
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
183 so <systemitem class="library">GTK</systemitem> (and the devel stuff, usually
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
184 called <systemitem class="library">gtk-dev</systemitem>) has to be installed.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
185 You can build it by specifying <option>--enable-gui</option> during
10000
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
186 <filename>./configure</filename>. Then, to turn on GUI mode, you have to
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
187 execute the <command>gmplayer</command> binary.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
188 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
189
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
190 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
191 As <application>MPlayer</application> doesn't have a skin included, you
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
192 have to download one if you want to use the GUI. See the <ulink
17706
83c1acef76d5 New website structure, the /homepage subdirectory is gone.
diego
parents: 17461
diff changeset
193 url="http://www.mplayerhq.hu/dload.html">download page</ulink>.
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
194 It should be extracted to the usual system-wide directory (<filename
17974
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
195 class="directory">$PREFIX/share/mplayer/skins</filename>), or to <filename
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
196 class="directory">$HOME/.mplayer/skins</filename>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
197 <application>MPlayer</application> by default looks in these directories
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
198 for a directory named <filename class="directory">default</filename>, but
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
199 you can use the <option>-skin <replaceable>newskin</replaceable></option>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
200 option, or the <literal>skin=newskin</literal> config file directive to use
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
201 the skin in the <filename class="directory">*/skins/newskin</filename>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
202 directory.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
203 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
204 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
205
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
206
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
207 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
208
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
209
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
210 <sect1 id="fonts-osd">
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
211 <title>Fonts and OSD</title>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
212
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
213 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
214 You need to tell <application>MPlayer</application> which font to use to
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
215 enjoy OSD and subtitles. Any TrueType font or special bitmap fonts will
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
216 work. However, TrueType fonts are recommended as they look far better,
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
217 can be properly scaled to the movie size and cope better with different
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
218 encodings.
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
219 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
220
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
221 <!-- ********** -->
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
222
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
223 <sect2 id="truetype-fonts">
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
224 <title>TrueType fonts</title>
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
225
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
226 <para>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
227 There are two ways to get TrueType fonts to work. The first is to pass
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
228 the <option>-font</option> option to specify a TrueType font file on
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
229 the command line. This option will be a good candidate to put in your
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
230 configuration file (see the manual page for details).
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
231 The second is to create a symlink called <filename>subfont.ttf</filename>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
232 to the font file of your choice. Either
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
233 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
234 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
235 </screen>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
236 for each user individually or a system-wide one:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
237 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
238 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
239 </screen>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
240 </para>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
241
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
242 <para>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
243 If <application>MPlayer</application> was compiled with
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
244 <systemitem class="library">fontconfig</systemitem> support, the above methods
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
245 won't work, instead <option>-font</option> expects a
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
246 <systemitem class="library">fontconfig</systemitem> font name
20396
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
247 and defaults to the sans-serif font. Example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
248 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
249 mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
250 </screen>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
251 </para>
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
252
20396
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
253 <para>
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
254 To get a list of fonts known to
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
255 <systemitem class="library">fontconfig</systemitem>,
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
256 use <command>fc-list</command>.
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
257 </para>
19821
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
258 </sect2>
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
259
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
260 <!-- ********** -->
19821
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
261
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
262 <sect2 id="bitmap-fonts">
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
263 <title>bitmap fonts</title>
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
264
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
265 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
266 If for some reason you wish or need to employ bitmap fonts, download a set
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
267 from our homepage. You can choose between various
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
268 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/fonts/">ISO fonts</ulink>
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
269 and some sets of fonts
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
270 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/fonts/">contributed by users</ulink>
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
271 in various encodings.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
272 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
273
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
274 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
275 Uncompress the file you downloaded to
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
276 <filename class="directory">~/.mplayer</filename> or
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
277 <filename class="directory">$PREFIX/share/mplayer</filename>.
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
278 Then rename or symlink one of the extracted directories to
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
279 <filename class="directory">font</filename>, for example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
280 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
281 ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
282 </screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
283 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
284 ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
285 </screen>
9737
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
286 </para>
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
287
9736
520f6d60bf75 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
288 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
289 Fonts should have an appropriate <filename>font.desc</filename> file
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
290 which maps Unicode font positions to the actual code page of the
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
291 subtitle text. Another solution is to have UTF-8-encoded subtitles
20396
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
292 and use the <option>-utf8</option> option or give the subtitles
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
293 file the same name as your video file with a <filename>.utf</filename>
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
294 extension and have it in the same directory as the video file.
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
295 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
296 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
297
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
298 <!-- ********** -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
299
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
300 <sect2 id="osdmenu">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
301 <title>OSD menu</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
302
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
303 <para>
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
304 <application>MPlayer</application> has a completely user-definable
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
305 OSD Menu interface.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
306 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
307
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
308 <note><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
309 the Preferences menu is currently UNIMPLEMENTED!
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
310 </para></note>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
311
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
312 <orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
313 <title>Installation</title>
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
314 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
315 compile <application>MPlayer</application> by passing the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
316 <option>--enable-menu</option> to <filename>./configure</filename>
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
317 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
318 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
319 make sure you have an OSD font installed
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
320 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
321 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
322 copy <filename>etc/menu.conf</filename> to your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
323 <filename class="directory">.mplayer</filename> directory
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
324 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
325 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
326 copy <filename>etc/input.conf</filename> to your
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
327 <filename class="directory">.mplayer</filename> directory, or to the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
328 system-wide <application>MPlayer</application> config dir (default:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
329 <filename class="directory">/usr/local/etc/mplayer</filename>)
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
330 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
331 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
332 check and edit <filename>input.conf</filename> to enable menu movement keys
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
333 (it is described there).
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
334 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
335 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
336 start <application>MPlayer</application> by the following example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
337 <screen>mplayer -menu <replaceable>file.avi</replaceable></screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
338 </para></listitem>
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
339 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
340 push any menu key you defined
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
341 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
342 </orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
343 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
344 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
345
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
346
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
347 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
348
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
349
27818
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
350 <sect1 id="codec_installation">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
351 <title>Codec installation</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
352
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
353 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
354
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
355 <sect2 id="xvid">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
356 <title>Xvid</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
357
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
358 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
359 <ulink url="http://www.xvid.org">Xvid</ulink> is a free software MPEG-4 ASP
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
360 compliant video codec. Note that Xvid is not necessary to decode Xvid-encoded
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
361 video. <systemitem class="library">libavcodec</systemitem> is used by
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
362 default as it offers better speed.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
363 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
364
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
365 <procedure>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
366 <title>Installing <systemitem class="library">Xvid</systemitem></title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
367 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
368 Like most open source software, it is available in two flavors:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
369 <ulink url="http://www.xvid.org/downloads.html">official releases</ulink>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
370 and the CVS version.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
371 The CVS version is usually stable enough to use, as most of the time it
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
372 features fixes for bugs that exist in releases.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
373 Here is what to do to make <systemitem class="library">Xvid</systemitem>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
374 CVS work with <application>MEncoder</application>:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
375 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
376 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
377 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
378 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
379 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
380 <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
381 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
382 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
383 <screen>cd xvidcore/build/generic</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
384 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
385 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
386 <screen>./bootstrap.sh &amp;&amp; ./configure</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
387 You may have to add some options (examine the output of
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
388 <command>./configure --help</command>).
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
389 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
390 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
391 <screen>make &amp;&amp; make install</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
392 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
393 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
394 Recompile <application>MPlayer</application>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
395 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
396 </procedure>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
397 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
398
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
399 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
400
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
401 <sect2 id="codec-x264">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
402 <title><systemitem class="library">x264</systemitem></title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
403
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
404 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
405 <ulink url="http://developers.videolan.org/x264.html"><systemitem class="library">x264</systemitem></ulink>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
406 is a library for creating H.264 video.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
407 <application>MPlayer</application> sources are updated whenever
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
408 an <systemitem class="library">x264</systemitem> API change
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
409 occurs, so it is always suggested to use
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
410 <application>MPlayer</application> from Subversion.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
411 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
412
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
413 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
414 If you have a GIT client installed, the latest x264
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
415 sources can be gotten with this command:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
416 <screen>git clone git://git.videolan.org/x264.git</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
417
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
418 Then build and install in the standard way:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
419 <screen>./configure &amp;&amp; make &amp;&amp; make install</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
420
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
421 Now rerun <filename>./configure</filename> for
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
422 <application>MPlayer</application> to pick up
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
423 <systemitem class="library">x264</systemitem> support.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
424 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
425 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
426
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
427 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
428
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
429 <sect2 id="aac">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
430 <title>AAC</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
431
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
432 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
433 An open source AAC decoder called FAAD2 is available from
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
434 <ulink url="http://www.audiocoding.com/downloads.html"/>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
435 <application>MPlayer</application> includes a copy of it in its source tree.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
436 If you want to use the external library instead, install it and pass
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
437 <option>--enable-faad-external</option> to <filename>./configure</filename>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
438 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
439
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
440 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
441 FAAD2 binaries are not available from audiocoding.com, but you can (apt-)get
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
442 Debian packages from
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
443 <ulink url="http://www.debian-multimedia.org/">Christian Marillat</ulink>,
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
444 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
445 and Fedora RPMs from <ulink url="http://rpm.livna.org/">Livna</ulink>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
446 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
447 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
448 If you choose to build from source, you do not need all of FAAD2 to decode
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
449 AAC files, libfaad is enough. Build it like this:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
450 <screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
451 cd faad2/
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
452 sh bootstrap
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
453 ./configure
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
454 cd libfaad
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
455 make
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
456 make install
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
457 </screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
458 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
459 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
460
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
461 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
462
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
463 <sect2 id="amr">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
464 <title>AMR</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
465
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
466 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
467 Adaptive Multi-Rate speech codec is used in third generation (3G) mobile
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
468 phones.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
469 Reference implementation is available from
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
470 <ulink url="http://www.3gpp.org">The 3rd Generation Partnership Project</ulink>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
471 (free for private use).
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
472 To enable support, download and install support libraries for
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
473 <ulink url="http://www.penguin.cz/~utx/amr">AMR-NB and AMR-WB</ulink>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
474 following the instructions on that page. Recompile MPlayer afterwards.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
475 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
476 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
477
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
478 <sect2 id="xmms">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
479 <title>XMMS</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
480
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
481 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
482 <application>MPlayer</application> can use <application>XMMS</application> input
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
483 plugins to play many file formats. There are plugins for SNES game tunes, SID
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
484 tunes (from Commodore 64), many Amiga formats, .xm, .it, VQF, Musepack, Bonk,
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
485 shorten and many others. You can find them at the
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
486 <ulink url="http://www.xmms.org/plugins.php?category=input">XMMS input plugin page</ulink>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
487 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
488
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
489 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
490 For this feature you need to have <application>XMMS</application> and compile
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
491 <application>MPlayer</application> with
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
492 <filename>./configure --enable-xmms</filename>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
493 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
494 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
495
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
496 </sect1>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
497
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
498
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
499 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
500
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
501
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
502 <sect1 id="rtc">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
503 <title>RTC</title>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
504
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
505 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
506 There are three timing methods in <application>MPlayer</application>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
507
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
508 <itemizedlist>
21690
dbec99c23472 [cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents: 21689
diff changeset
509 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
510 <emphasis role="bold">To use the old method</emphasis>, you don't have to do
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
511 anything. It uses <systemitem>usleep()</systemitem> to tune
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
512 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
513 tuned even finer.
21690
dbec99c23472 [cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents: 21689
diff changeset
514 </para></listitem>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
515 <listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
516 <para>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
517 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
518 Clock) for this task, because it has precise 1ms timers.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
519 The <option>-rtc</option> option enables it,
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
520 but a properly set up kernel is required.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
521 If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC
11668
18326298f607 added <systemitem class=systemname> tag to /proc
paszczi
parents: 11665
diff changeset
522 frequency for normal users through the <systemitem class="systemname">/proc
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
523 </systemitem> file system. Use one of the following two commands to
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
524 enable RTC for normal users:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
525 <screen>echo 1024 &gt; /proc/sys/dev/rtc/max-user-freq</screen>
19969
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
526 <screen>sysctl dev/rtc/max-user-freq=1024</screen>
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
527 You can make this setting permanent by adding the latter to
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
528 <filename>/etc/sysctl.conf</filename>.
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
529 </para>
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
530 <para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
531 You can see the new timer's efficiency in the status line.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
532 The power management functions of some notebook BIOSes with speedstep CPUs
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
533 interact badly with RTC. Audio and video may get out of sync. Plugging the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
534 external power connector in before you power up your notebook seems to help.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
535 In some hardware combinations (confirmed during usage of non-DMA DVD drive
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
536 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
537 recommended to use the third method in these cases.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
538 </para>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
539 </listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
540 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
541 <emphasis role="bold">The third timer code</emphasis> is turned on with the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
542 <option>-softsleep</option> option. It has the efficiency of the RTC, but it
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
543 doesn't use RTC. On the other hand, it requires more CPU.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
544 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
545 </itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
546 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
547 </sect1>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
548
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
549 </chapter>