annotate DOCS/xml/en/install.xml @ 30820:dcf876ac1c8a

We have some sort of DVD menu support nowadays.
author diego
date Mon, 08 Mar 2010 19:33:41 +0000
parents 50589ac2c8cc
children 92d75e703bc0
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>
28387
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 28383
diff changeset
29 <emphasis role="bold">POSIX system</emphasis> - You need a POSIX-compatible
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 28383
diff changeset
30 shell and POSIX-compatible system tools like grep, sed, awk, etc. in your
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 28383
diff changeset
31 path.
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 28383
diff changeset
32 </para></listitem>
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 28383
diff changeset
33 <listitem><para>
28383
d65b00f5af0f Move GNU Make entry to the top of the list.
diego
parents: 28382
diff changeset
34 <emphasis role="bold">GNU make</emphasis> 3.81 or later
d65b00f5af0f Move GNU Make entry to the top of the list.
diego
parents: 28382
diff changeset
35 </para></listitem>
d65b00f5af0f Move GNU Make entry to the top of the list.
diego
parents: 28382
diff changeset
36 <listitem><para>
28382
05d2f44a31c5 Update binutils and compiler sections.
diego
parents: 28114
diff changeset
37 <emphasis role="bold">binutils</emphasis> - GNU binutils 2.11 or later
05d2f44a31c5 Update binutils and compiler sections.
diego
parents: 28114
diff changeset
38 is known to work.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
39 </para></listitem>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
40 <listitem><para>
28382
05d2f44a31c5 Update binutils and compiler sections.
diego
parents: 28114
diff changeset
41 <emphasis role="bold">compiler</emphasis> - We mostly use gcc, the
05d2f44a31c5 Update binutils and compiler sections.
diego
parents: 28114
diff changeset
42 recommended versions on x86 are 2.95 and 3.4+. On PowerPC, use 4.x+.
05d2f44a31c5 Update binutils and compiler sections.
diego
parents: 28114
diff changeset
43 icc 10.1+ is also known to work.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
44 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
45 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
46 <emphasis role="bold">Xorg/XFree86</emphasis> - recommended version is
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
47 4.3 or later. Make sure the
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
48 <emphasis role="bold">development packages</emphasis> are installed,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
49 too, otherwise it won't work.
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
50 You don't absolutely need X, some video output drivers work without it.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
51 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
52 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
53 <emphasis role="bold">FreeType</emphasis> - 2.0.9 or later is required
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
54 for the OSD and subtitles
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
55 </para></listitem>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
56 <listitem><para>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
57 <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
58 support. At least 0.9.0rc4 is required.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
59 </para></listitem>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
60 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
61 <emphasis role="bold">libjpeg</emphasis> -
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
62 required for the optional JPEG video output driver
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
63 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
64 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
65 <emphasis role="bold">libpng</emphasis> -
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
66 required for the optional PNG video output driver
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
67 </para></listitem>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
68 <listitem><para>
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
69 <emphasis role="bold">directfb</emphasis> - optional, 0.9.13 or later
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
70 required for the directfb video output driver
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
71 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
72 <listitem><para>
21137
1577958ae629 Miscellaneous updates for the introduction and the requirements section.
diego
parents: 20917
diff changeset
73 <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
74 necessary for encoding MP3 audio with <application>MEncoder</application>.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
75 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
76 <listitem><para>
27814
1bc1d241f635 zlib is used in many places.
diego
parents: 27813
diff changeset
77 <emphasis role="bold">zlib</emphasis> - recommended, many codecs use it.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
78 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
79 <listitem><para>
17461
db3327b8e590 s/LIVE.COM/LIVE555/ + URL update
gpoirier
parents: 17321
diff changeset
80 <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
81 - optional, needed for some RTSP/RTP streams
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
82 </para></listitem>
9675
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">cdparanoia</emphasis> - optional, for CDDA support
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
85 </para></listitem>
9675
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">libxmms</emphasis> - optional, for XMMS input plugin
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
88 support. At least 1.2.7 is required.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
89 </para></listitem>
10132
nicolas
parents: 10000
diff changeset
90 <listitem><para>
24067
b5724eaab360 Reorder installation requirements list, wording/spelling.
diego
parents: 23208
diff changeset
91 <emphasis role="bold">libsmb</emphasis> - optional, for SMB networking support
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
92 </para></listitem>
27813
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
93 <listitem><para>
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
94 <emphasis role="bold"><ulink url="http://www.underbit.com/products/mad/">libmad</ulink></emphasis>
27832
e78a2facbd7a Fix typo noticed by Paul TT.
diego
parents: 27818
diff changeset
95 - optional, for fast integer-only MP3 decoding on FPU-less platforms
27813
67b299fcffd1 Move libmad codec installation section to software requirements.
diego
parents: 27631
diff changeset
96 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
97 </itemizedlist>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
98 </sect1>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
99
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
100
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
101 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
102
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
103
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
104 <sect1 id="features">
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
105 <title>Features</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
106
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
107 <itemizedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
108 <listitem><para>
11483
462b97f8746f move section out of <link> tags
wight
parents: 11461
diff changeset
109 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
110 section before compiling.
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 want to install <application>MEncoder</application> (our great
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
114 all-purpose encoder), see the
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
115 <link linkend="mencoder"><application>MEncoder</application></link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
116 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
117 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
118 If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card,
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
119 and wish to watch/grab and encode movies with
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
120 <application>MPlayer</application>,
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
121 read the <link linkend="tv-input">TV input</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
122 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
123 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
124 If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
125 card, and wish to listen and capture sound with
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
126 <application>MPlayer</application>,
19583
94e4ef4195d3 Fix build after radio commit, patch by Jindrich Makovicka.
diego
parents: 19568
diff changeset
127 read the <link linkend="radio">radio</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
128 </para></listitem>
19568
bd821fd3e244 Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents: 19082
diff changeset
129 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
130 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
131 used. Check the <link linkend="subosd">OSD menu</link> section.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
132 </para></listitem>
9675
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
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
135 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
136 Then build <application>MPlayer</application>:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
137 <screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
138 ./configure
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139 make
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
140 make install
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
141 </screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
142 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
143
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
144 <para>
23143
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
145 At this point, <application>MPlayer</application> is ready to use.
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
146 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
147 directory at (<filename>~/.mplayer/codecs.conf</filename>) left from old
89cee9f0dfa6 Remove outdated and wrong references to codecs.conf.
diego
parents: 21725
diff changeset
148 <application>MPlayer</application> versions. If you find one, remove it.
10403
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
149 </para>
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
150
23c9ebca2e24 Strings attached to codecs.conf explained.
diego
parents: 10277
diff changeset
151 <para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
152 Debian users can build a .deb package for themselves, it's very simple.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
153 Just exec
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154 <screen>fakeroot debian/rules binary</screen>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
155 in <application>MPlayer</application>'s root directory. See
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 10913
diff changeset
156 <link linkend="debian">Debian packaging</link> for detailed instructions.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
157 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
158
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
159 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160 <emphasis role="bold">Always browse the output of</emphasis>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
161 <filename>./configure</filename>, and the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
162 <filename>configure.log</filename> file, they contain information about
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
163 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
164 <filename>config.h</filename> and <filename>config.mak</filename> files.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
165 If you have some libraries installed, but not detected by
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166 <filename>./configure</filename>, then check if you also have the proper
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
167 header files (usually the -dev packages) and their version matches. The
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
168 <filename>configure.log</filename> file usually tells you what is missing.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
169 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
170
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 Though not mandatory, the fonts should be installed in order to gain OSD,
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173 and subtitle functionality. The recommended method is installing a TTF
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
174 font file and telling <application>MPlayer</application> to use it.
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
175 See the <link linkend="subosd">Subtitles and OSD</link> section for details.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
176 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
177 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
178
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
179
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
180 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
181
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
182
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
183 <sect1 id="gui">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
184 <title>What about the GUI?</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
185
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
186 <para>
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
187 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
188 so <systemitem class="library">GTK</systemitem> (and the devel stuff, usually
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
189 called <systemitem class="library">gtk-dev</systemitem>) has to be installed.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
190 You can build it by specifying <option>--enable-gui</option> during
10000
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
191 <filename>./configure</filename>. Then, to turn on GUI mode, you have to
6fbe9b7176d7 sync with HMTL docs
nicolas
parents: 9737
diff changeset
192 execute the <command>gmplayer</command> binary.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
193 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
194
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
195 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
196 As <application>MPlayer</application> doesn't have a skin included, you
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
197 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
198 url="http://www.mplayerhq.hu/dload.html">download page</ulink>.
27631
42b15a81b468 misc fixes for the GUI section
diego
parents: 26958
diff changeset
199 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
200 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
201 class="directory">$HOME/.mplayer/skins</filename>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
202 <application>MPlayer</application> by default looks in these directories
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
203 for a directory named <filename class="directory">default</filename>, but
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
204 you can use the <option>-skin <replaceable>newskin</replaceable></option>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
205 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
206 the skin in the <filename class="directory">*/skins/newskin</filename>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
207 directory.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
208 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
209 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
210
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
211
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
212 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
213
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
214
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
215 <sect1 id="fonts-osd">
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
216 <title>Fonts and OSD</title>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
217
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
218 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
219 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
220 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
221 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
222 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
223 encodings.
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
224 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
225
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
226 <!-- ********** -->
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
227
19822
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
228 <sect2 id="truetype-fonts">
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
229 <title>TrueType fonts</title>
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
230
db95db082c37 Move subtitles and OSD section from the installation to the usage chapter.
diego
parents: 19821
diff changeset
231 <para>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
232 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
233 the <option>-font</option> option to specify a TrueType font file on
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
234 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
235 configuration file (see the manual page for details).
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
236 The second is to create a symlink called <filename>subfont.ttf</filename>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
237 to the font file of your choice. Either
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
238 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
239 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
240 </screen>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
241 for each user individually or a system-wide one:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
242 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
243 ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
244 </screen>
19823
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
245 </para>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
246
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
247 <para>
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
248 If <application>MPlayer</application> was compiled with
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
249 <systemitem class="library">fontconfig</systemitem> support, the above methods
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
250 won't work, instead <option>-font</option> expects a
99dcac9ee2e8 Improve TrueType font installation section.
diego
parents: 19822
diff changeset
251 <systemitem class="library">fontconfig</systemitem> font name
20396
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
252 and defaults to the sans-serif font. Example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
253 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
254 mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
255 </screen>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
256 </para>
12815
3c99b7a8c840 trailing whitespace removed (cosmetics)
diego
parents: 12779
diff changeset
257
20396
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
258 <para>
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
259 To get a list of fonts known to
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
260 <systemitem class="library">fontconfig</systemitem>,
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
261 use <command>fc-list</command>.
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
262 </para>
19821
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
263 </sect2>
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
264
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
265 <!-- ********** -->
19821
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
266
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
267 <sect2 id="bitmap-fonts">
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
268 <title>bitmap fonts</title>
9c79fe0945db Slightly restructure font installation section.
diego
parents: 19819
diff changeset
269
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
270 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
271 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
272 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
273 <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
274 and some sets of fonts
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
275 <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
276 in various encodings.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
277 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
278
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
279 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
280 Uncompress the file you downloaded to
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
281 <filename class="directory">~/.mplayer</filename> or
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
282 <filename class="directory">$PREFIX/share/mplayer</filename>.
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
283 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
284 <filename class="directory">font</filename>, for example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
285 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
286 ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
287 </screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
288 <screen>
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
289 ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
290 </screen>
9737
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
291 </para>
6c343b6f7059 fix (thanks to Dmitry)
nicolas
parents: 9736
diff changeset
292
9736
520f6d60bf75 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
293 <para>
19819
76d294537ff6 TrueType fonts now preferred over bitmap fonts, rewrite the font installation.
diego
parents: 19817
diff changeset
294 Fonts should have an appropriate <filename>font.desc</filename> file
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
295 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
296 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
297 and use the <option>-utf8</option> option or give the subtitles
490b7a74a21b Fix some inconsistencies pointed out by Torinthiel.
diego
parents: 20384
diff changeset
298 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
299 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
300 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
301 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
302
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
303 <!-- ********** -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
304
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
305 <sect2 id="osdmenu">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
306 <title>OSD menu</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
307
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
308 <para>
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
309 <application>MPlayer</application> has a completely user-definable
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
310 OSD Menu interface.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
311 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
312
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
313 <note><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
314 the Preferences menu is currently UNIMPLEMENTED!
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
315 </para></note>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
316
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
317 <orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
318 <title>Installation</title>
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
319 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
320 compile <application>MPlayer</application> by passing the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
321 <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
322 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
323 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
324 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
325 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
326 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
327 copy <filename>etc/menu.conf</filename> to your
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
328 <filename class="directory">.mplayer</filename> directory
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
329 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
330 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
331 copy <filename>etc/input.conf</filename> to your
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
332 <filename class="directory">.mplayer</filename> directory, or to the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
333 system-wide <application>MPlayer</application> config dir (default:
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
334 <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
335 </para></listitem>
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
336 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
337 check and edit <filename>input.conf</filename> to enable menu movement keys
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
338 (it is described there).
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
339 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
340 <listitem><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
341 start <application>MPlayer</application> by the following example:
21689
43f41347aab0 Still some reformatting:
torinthiel
parents: 21521
diff changeset
342 <screen>mplayer -menu <replaceable>file.avi</replaceable></screen>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
343 </para></listitem>
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
344 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
345 push any menu key you defined
21725
e4cd9d683286 Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents: 21690
diff changeset
346 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
347 </orderedlist>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
348 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
349 </sect1>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
350
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
351
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
352 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
353
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
354
27833
37ee8ca274b8 Consistently use dashes to separate words in section IDs.
diego
parents: 27832
diff changeset
355 <sect1 id="codec-installation">
27818
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
356 <title>Codec installation</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 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
359
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
360 <sect2 id="xvid">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
361 <title>Xvid</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
362
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 <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
365 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
366 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
367 default as it offers better speed.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
368 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
369
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
370 <procedure>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
371 <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
372 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
373 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
374 <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
375 and the CVS version.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
376 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
377 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
378 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
379 CVS work with <application>MEncoder</application>:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
380 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
381 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
382 <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
383 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
384 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
385 <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
386 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
387 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
388 <screen>cd xvidcore/build/generic</screen>
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>./bootstrap.sh &amp;&amp; ./configure</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
392 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
393 <command>./configure --help</command>).
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
394 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
395 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
396 <screen>make &amp;&amp; make install</screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
397 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
398 <step><para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
399 Recompile <application>MPlayer</application>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
400 </para></step>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
401 </procedure>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
402 </sect2>
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 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
405
28475
ee46a1af24e4 Use consistent names for codec installation sections.
diego
parents: 28387
diff changeset
406 <sect2 id="x264">
27818
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
407 <title><systemitem class="library">x264</systemitem></title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
408
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
409 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
410 <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
411 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
412 <application>MPlayer</application> sources are updated whenever
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
413 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
414 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
415 <application>MPlayer</application> from Subversion.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
416 </para>
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 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
419 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
420 sources can be gotten with this command:
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
421 <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
422
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
423 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
424 <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
425
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
426 Now rerun <filename>./configure</filename> for
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
427 <application>MPlayer</application> to pick up
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
428 <systemitem class="library">x264</systemitem> support.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
429 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
430 </sect2>
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 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
433
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
434 <sect2 id="aac">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
435 <title>AAC</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
436
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
437 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
438 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
439 <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
440 <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
441 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
442 <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
443 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
444
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
445 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
446 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
447 Debian packages from
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
448 <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
449 Mandrake/Mandriva RPMs from the <ulink url="http://plf.zarb.org">P.L.F</ulink>
28114
a1451877ff0e Update links to RPM packages, now that Livna has merged into RPMFusion.
rathann
parents: 27833
diff changeset
450 and Fedora/CentOS/RHEL RPMs from <ulink url="http://rpmfusion.org/">RPMFusion</ulink>.
27818
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
451 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
452 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
453 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
454 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
455 <screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
456 cd faad2/
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
457 sh bootstrap
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
458 ./configure
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
459 cd libfaad
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
460 make
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
461 make install
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
462 </screen>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
463 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
464 </sect2>
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 <!-- ********** -->
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
467
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
468 <sect2 id="amr">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
469 <title>AMR</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
470
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
471 <para>
29419
50589ac2c8cc Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents: 28475
diff changeset
472 MPlayer can use the OpenCORE AMR libraries through FFmpeg.
50589ac2c8cc Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents: 28475
diff changeset
473 Download the libraries for AMR-NB and AMR-WB from the
50589ac2c8cc Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents: 28475
diff changeset
474 <ulink url="http://sourceforge.net/projects/opencore-amr/">opencore-amr</ulink>
50589ac2c8cc Update documentation for libamr replacement by OpenCORE in FFmpeg.
diego
parents: 28475
diff changeset
475 project and install them according to the instructions on that page.
27818
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
476 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
477 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
478
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
479 <sect2 id="xmms">
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
480 <title>XMMS</title>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
481
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
482 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
483 <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
484 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
485 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
486 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
487 <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
488 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
489
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
490 <para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
491 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
492 <application>MPlayer</application> with
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
493 <filename>./configure --enable-xmms</filename>.
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
494 </para>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
495 </sect2>
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
496
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
497 </sect1>
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
6b0e98eb48e9 Move codec installation instructions from the codecs section to a more
diego
parents: 27816
diff changeset
502
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
503 <sect1 id="rtc">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
504 <title>RTC</title>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
505
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
506 <para>
11540
d480f7e36b74 <application> attack
wight
parents: 11501
diff changeset
507 There are three timing methods in <application>MPlayer</application>.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
508
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
509 <itemizedlist>
21690
dbec99c23472 [cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents: 21689
diff changeset
510 <listitem><para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
511 <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
512 anything. It uses <systemitem>usleep()</systemitem> to tune
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
513 A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
514 tuned even finer.
21690
dbec99c23472 [cosmetics] <simpara> -> <para>, for consistency
torinthiel
parents: 21689
diff changeset
515 </para></listitem>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
516 <listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
517 <para>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
518 <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
519 Clock) for this task, because it has precise 1ms timers.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
520 The <option>-rtc</option> option enables it,
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
521 but a properly set up kernel is required.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
522 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
523 frequency for normal users through the <systemitem class="systemname">/proc
26958
b89c59df8ba6 Run the whole documentation through ispell.
diego
parents: 24067
diff changeset
524 </systemitem> file system. Use one of the following two commands to
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
525 enable RTC for normal users:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
526 <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
527 <screen>sysctl dev/rtc/max-user-freq=1024</screen>
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
528 You can make this setting permanent by adding the latter to
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
529 <filename>/etc/sysctl.conf</filename>.
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
530 </para>
96b83e47c885 Also mention sysctl for adjusting RTC settings.
diego
parents: 19968
diff changeset
531 <para>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
532 You can see the new timer's efficiency in the status line.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
533 The power management functions of some notebook BIOSes with speedstep CPUs
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
534 interact badly with RTC. Audio and video may get out of sync. Plugging the
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
535 external power connector in before you power up your notebook seems to help.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
536 In some hardware combinations (confirmed during usage of non-DMA DVD drive
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
537 on an ALi1541 board) usage of the RTC timer causes skippy playback. It's
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
538 recommended to use the third method in these cases.
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
539 </para>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
540 </listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
541 <listitem><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
542 <emphasis role="bold">The third timer code</emphasis> is turned on with the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
543 <option>-softsleep</option> option. It has the efficiency of the RTC, but it
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
544 doesn't use RTC. On the other hand, it requires more CPU.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 21379
diff changeset
545 </para></listitem>
9675
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 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
548 </sect1>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
549
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 16663
diff changeset
550 </chapter>