Mercurial > mplayer.hg
annotate DOCS/xml/en/ports.xml @ 28384:452c6b9ffaad
Remove remarks about GNU Make being required on some systems.
GNU Make 3.81 or later is required everywhere.
author | diego |
---|---|
date | Sun, 01 Feb 2009 11:15:18 +0000 |
parents | a1451877ff0e |
children | 838215551d62 |
rev | line source |
---|---|
20535 | 1 <?xml version="1.0" encoding="utf-8"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10909
diff
changeset
|
2 <!-- $Revision$ --> |
9675 | 3 <chapter id="ports" xreflabel="Ports"> |
4 <title>Ports</title> | |
5 | |
6 <sect1 id="linux"> | |
7 <title>Linux</title> | |
21521 | 8 |
9675 | 9 <para> |
10 The main development platform is Linux on x86, although | |
11 <application>MPlayer</application> works on many other Linux ports. | |
11540 | 12 Binary packages of <application>MPlayer</application> are available from several |
21521 | 13 sources. |
14 However, <emphasis role="bold">none of these packages are supported</emphasis>. | |
9675 | 15 Report problems to the authors, not to us. |
16 </para> | |
17 | |
21521 | 18 <!-- ********** --> |
19 | |
9675 | 20 <sect2 id="debian"> |
21 <title>Debian packaging</title> | |
21521 | 22 |
9675 | 23 <para> |
11540 | 24 To build a Debian package, run the following command in the |
25 <application>MPlayer</application> source directory: | |
13939
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
26 |
9675 | 27 <screen>fakeroot debian/rules binary</screen> |
13939
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
28 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
29 If you want to pass custom options to configure, you can set up the |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
30 <envar>DEB_BUILD_OPTIONS</envar> environment variable. For instance, |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
31 if you want GUI and OSD menu support you would use: |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
32 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
33 <screen>DEB_BUILD_OPTIONS="--enable-gui --enable-menu" fakeroot debian/rules binary</screen> |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
34 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
35 You can also pass some variables to the Makefile. For example, if you want |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
36 to compile with gcc 3.4 even if it's not the default compiler: |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
37 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
38 <screen>CC=gcc-3.4 DEB_BUILD_OPTIONS="--enable-gui" fakeroot debian/rules binary</screen> |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
39 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
40 To clean up the source tree run the following command: |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
41 |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
42 <screen>fakeroot debian/rules clean</screen> |
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
43 |
9675 | 44 As root you can then install the <filename>.deb</filename> package as usual: |
13939
25db6ab99ff3
More detailed Debian package building instructions, based on a patch by
diego
parents:
13892
diff
changeset
|
45 |
9675 | 46 <screen>dpkg -i ../mplayer_<replaceable>version</replaceable>.deb</screen> |
47 </para> | |
48 | |
49 <para> | |
13813 | 50 Christian Marillat has been making unofficial Debian packages of |
11540 | 51 <application>MPlayer</application>, <application>MEncoder</application> and |
19814 | 52 our binary codec packages for a while, you can (apt-)get them from |
18820 | 53 <ulink url="http://www.debian-multimedia.org/">his homepage</ulink>. |
9675 | 54 </para> |
55 </sect2> | |
56 | |
21521 | 57 <!-- ********** --> |
58 | |
9675 | 59 <sect2 id="rpm"> |
60 <title>RPM packaging</title> | |
21521 | 61 |
9675 | 62 <para> |
21608
d64b282f8e2f
RedHat RPMs are long gone. Greysector repository is going away, and I've
rathann
parents:
21596
diff
changeset
|
63 Dominik Mierzejewski maintains the official RPM packages of |
28114
a1451877ff0e
Update links to RPM packages, now that Livna has merged into RPMFusion.
rathann
parents:
26958
diff
changeset
|
64 <application>MPlayer</application> for Fedora and CentOS/RHEL. They are available |
a1451877ff0e
Update links to RPM packages, now that Livna has merged into RPMFusion.
rathann
parents:
26958
diff
changeset
|
65 from <ulink url="http://rpmfusion.org/">RPMFusion repository</ulink>. |
9675 | 66 </para> |
67 | |
68 <para> | |
21521 | 69 Mandrake/Mandriva RPM packages are available from the |
70 <ulink url="http://plf.zarb.org/">P.L.F.</ulink>. | |
26958 | 71 SUSE used to include a crippled version of <application>MPlayer</application> |
11540 | 72 in their distribution. They have removed it in their latest releases. You can |
73 get working RPMs from | |
74 <ulink url="http://packman.links2linux.de/?action=128">links2linux.de</ulink>. | |
9675 | 75 </para> |
76 </sect2> | |
77 | |
21521 | 78 <!-- ********** --> |
79 | |
9675 | 80 <sect2 id="arm"> |
81 <title>ARM</title> | |
21521 | 82 |
9675 | 83 <para> |
21521 | 84 <application>MPlayer</application> works on Linux PDAs with ARM CPU e.g. Sharp |
85 Zaurus, Compaq Ipaq. The easiest way to obtain | |
86 <application>MPlayer</application> is to get it from one of the | |
87 <ulink url="http://www.openzaurus.org">OpenZaurus</ulink> package feeds. | |
88 If you want to compile it yourself, you should look at the | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
89 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">mplayer</ulink> |
9675 | 90 and the |
91 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/libavcodec?nav=index.html|src/.|src/packages">libavcodec</ulink> | |
92 directory in the OpenZaurus distribution buildroot. These always have the latest | |
20403 | 93 Makefile and patches used for building a SVN <application>MPlayer</application>. |
9675 | 94 If you need a GUI frontend, you can use xmms-embedded. |
95 </para> | |
96 </sect2> | |
97 </sect1> | |
98 | |
21521 | 99 |
100 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
101 | |
102 | |
9675 | 103 <sect1 id="bsd"> |
104 <title>*BSD</title> | |
21521 | 105 |
9675 | 106 <para> |
17294 | 107 <application>MPlayer</application> runs on all known BSD flavors. |
108 There are ports/pkgsrc/fink/etc versions of <application>MPlayer</application> | |
9675 | 109 available that are probably easier to use than our raw sources. |
110 </para> | |
111 | |
112 <para> | |
21521 | 113 If <application>MPlayer</application> complains about not finding |
114 <filename>/dev/cdrom</filename> or <filename>/dev/dvd</filename>, | |
115 create an appropriate symbolic link: | |
10958 | 116 <screen>ln -s /dev/<replaceable>your_cdrom_device</replaceable> /dev/cdrom</screen> |
9675 | 117 </para> |
118 | |
119 <para> | |
11540 | 120 To use Win32 DLLs with <application>MPlayer</application> you will need to |
21596 | 121 re-compile the kernel with "<envar>option USER_LDT</envar>" |
11540 | 122 (unless you run FreeBSD-CURRENT, |
9675 | 123 where this is the default). |
124 </para> | |
125 | |
21521 | 126 <!-- ********** --> |
9675 | 127 |
128 <sect2 id="freebsd"> | |
129 <title>FreeBSD</title> | |
21521 | 130 |
9675 | 131 <para> |
132 If your CPU has SSE, recompile your kernel with | |
21596 | 133 "<envar>options CPU_ENABLE_SSE</envar>" (FreeBSD-STABLE or kernel |
9675 | 134 patches required). |
135 </para> | |
136 </sect2> | |
137 | |
21521 | 138 <!-- ********** --> |
139 | |
9675 | 140 <sect2 id="openbsd"> |
141 <title>OpenBSD</title> | |
21521 | 142 |
9675 | 143 <para> |
144 Due to limitations in different versions of gas (relocation vs MMX), you | |
145 will need to compile in two steps: First make sure that the non-native as | |
146 is first in your <envar>$PATH</envar> and do a <command>gmake -k</command>, then | |
147 make sure that the native version is used and do <command>gmake</command>. | |
148 </para> | |
21521 | 149 |
13281
d9b7fabd9739
OpenBSD clarification by Bj«Órn Sandell <biorn @ dce . chalmers . se>
diego
parents:
13222
diff
changeset
|
150 <para> |
d9b7fabd9739
OpenBSD clarification by Bj«Órn Sandell <biorn @ dce . chalmers . se>
diego
parents:
13222
diff
changeset
|
151 As of OpenBSD 3.4 the hack above is no longer needed. |
d9b7fabd9739
OpenBSD clarification by Bj«Órn Sandell <biorn @ dce . chalmers . se>
diego
parents:
13222
diff
changeset
|
152 </para> |
9675 | 153 </sect2> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
154 |
21521 | 155 <!-- ********** --> |
156 | |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
157 <sect2 id="darwin"> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
158 <title>Darwin</title> |
21521 | 159 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
160 <para> |
11348 | 161 See the <link linkend="macos">Mac OS</link> section. |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
162 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
163 </sect2> |
9675 | 164 </sect1> |
165 | |
21521 | 166 |
167 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
168 | |
169 | |
17294 | 170 <sect1 id="unix"> |
171 <title>Commercial Unix</title> | |
172 | |
173 <para> | |
174 <application>MPlayer</application> has been ported to a number of commercial | |
175 Unix variants. Since the development environments on these systems tend to be | |
176 different from those found on free Unixes, you may have to make some manual | |
177 adjustments to make the build work. | |
178 </para> | |
179 | |
21521 | 180 <!-- ********** --> |
181 | |
17294 | 182 <sect2 id="solaris"> |
183 <title>Solaris</title> | |
21521 | 184 |
9675 | 185 <para> |
186 <application>MPlayer</application> should work on Solaris 2.6 or newer. | |
14632 | 187 Use the SUN audio driver with the <option>-ao sun</option> option for sound. |
9675 | 188 </para> |
189 | |
190 <para> | |
21521 | 191 On <emphasis role="bold">UltraSPARCs</emphasis>, |
192 <application>MPlayer</application> takes advantage of their | |
193 <emphasis role="bold">VIS</emphasis> extensions | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
194 (equivalent to MMX), currently only in |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
195 <systemitem class="library">libmpeg2</systemitem>, |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
196 <systemitem class="library">libvo</systemitem> |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
197 and <systemitem class="library">libavcodec</systemitem>, but not in |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
198 <systemitem class="library">mp3lib</systemitem>. You can watch a VOB file |
9675 | 199 on a 400MHz CPU. You'll need |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
200 <ulink url="http://www.sun.com/sparc/vis/mediaLib.html"><systemitem class="library">mLib</systemitem></ulink> |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11802
diff
changeset
|
201 installed. |
9675 | 202 </para> |
203 | |
18672 | 204 <para><emphasis role="bold">Caveat:</emphasis></para> |
205 <itemizedlist> | |
21521 | 206 <listitem><para> |
207 <emphasis role="bold">mediaLib</emphasis> is | |
208 <emphasis role="bold">currently disabled</emphasis> by default in | |
209 <application>MPlayer</application> because of brokenness. SPARC users | |
210 who build MPlayer with mediaLib support have reported a thick, | |
211 green-tint on video encoded and decoded with libavcodec. You may enable | |
212 it if you wish with: | |
213 <screen>./configure --enable-mlib</screen> | |
214 You do this at your own risk. x86 users should | |
215 <emphasis role="bold">never</emphasis> use mediaLib, as this will | |
216 result in very poor MPlayer performance. | |
18672 | 217 </para></listitem> |
218 </itemizedlist> | |
219 | |
9675 | 220 <para> |
221 On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter if | |
222 GNU C/C++ compiler is configured with or without the GNU assembler. | |
223 </para> | |
224 | |
225 <para> | |
226 On Solaris x86, you need the GNU assembler and the GNU C/C++ compiler, | |
12552 | 227 configured to use the GNU assembler! The <application>MPlayer</application> |
228 code on the x86 platform makes heavy use of MMX, SSE and 3DNOW! instructions | |
21521 | 229 that cannot be compiled using Sun's assembler |
230 <filename>/usr/ccs/bin/as</filename>. | |
9675 | 231 </para> |
232 | |
12552 | 233 <para> |
21521 | 234 The <filename>configure</filename> script tries to find out, which assembler |
21596 | 235 program is used by your "gcc" command (in case the autodetection |
21521 | 236 fails, use the |
237 <option>--as=<replaceable>/wherever/you/have/installed/gnu-as</replaceable></option> | |
9675 | 238 option to tell the <filename>configure</filename> script where it can find GNU |
239 "as" on your system). | |
240 </para> | |
241 | |
18672 | 242 <para>Solutions to common problems:</para> |
243 <itemizedlist> | |
244 <listitem><para> | |
21521 | 245 Error message from <filename>configure</filename> on a Solaris x86 system |
246 using GCC without GNU assembler: | |
247 <screen> | |
248 % configure | |
249 ... | |
250 Checking assembler (/usr/ccs/bin/as) ... , failed | |
251 Please upgrade(downgrade) binutils to 2.10.1...<!-- | |
252 --></screen> | |
253 (Solution: Install and use a gcc configured with | |
254 <option>--with-as=gas</option>) | |
9675 | 255 </para> |
256 | |
257 <para> | |
21521 | 258 Typical error you get when building with a GNU C compiler that does not |
259 use GNU as: | |
9675 | 260 <screen> |
21521 | 261 % gmake |
262 ... | |
263 gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math | |
264 -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c | |
265 Assembler: mplayer.c | |
266 "(stdin)", line 3567 : Illegal mnemonic | |
267 "(stdin)", line 3567 : Syntax error | |
268 ... more "Illegal mnemonic" and "Syntax error" errors ... | |
9675 | 269 </screen> |
270 </para> | |
18672 | 271 </listitem> |
9675 | 272 |
21521 | 273 <listitem><para> |
274 <application>MPlayer</application> may segfault when decoding | |
275 and encoding video that uses the win32codecs: | |
276 <screen> | |
18672 | 277 ... |
278 Trying to force audio codec driver family acm... | |
279 Opening audio decoder: [acm] Win32/ACM decoders | |
280 sysi86(SI86DSCR): Invalid argument | |
281 Couldn't install fs segment, expect segfault | |
282 | |
283 | |
284 MPlayer interrupted by signal 11 in module: init_audio_codec | |
21521 | 285 ...<!-- |
286 --></screen> | |
287 This is because of a change to sysi86() in Solaris 10 and pre-Solaris | |
288 Nevada b31 releases. This has been fixed in Solaris Nevada b32; | |
289 however, Sun has yet to backport the fix to Solaris 10. The MPlayer | |
290 Project has made Sun aware of the problem and a patch is currently in | |
291 progress for Solaris 10. More information about this bug can be found | |
292 at: | |
293 <ulink url="http://bugs.opensolaris.org/bugdatabase/view_bug.do?bug_id=6308413"/>. | |
294 </para></listitem> | |
18672 | 295 |
296 <listitem><para> | |
21521 | 297 Due to bugs in Solaris 8, |
298 you may not be able to play DVD discs larger than 4 GB: | |
9675 | 299 </para> |
300 | |
301 <itemizedlist> | |
302 <listitem><para> | |
21521 | 303 The sd(7D) driver on Solaris 8 x86 has a bug when accessing a disk block >4GB |
304 on a device using a logical blocksize != DEV_BSIZE | |
305 (i.e. CD-ROM and DVD media). | |
306 Due to a 32Bit int overflow, a disk address modulo 4GB is accessed | |
307 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22516"/>). | |
308 This problem does not exist in the SPARC version of Solaris 8. | |
9675 | 309 </para></listitem> |
310 | |
311 <listitem><para> | |
26958 | 312 A similar bug is present in the hsfs(7FS) file system code (AKA ISO9660), |
21521 | 313 hsfs may not not support partitions/disks larger than 4GB, all data is |
314 accessed modulo 4GB | |
315 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22592"/>). | |
316 The hsfs problem can be fixed by installing | |
26958 | 317 patch 109764-04 (SPARC) / 109765-04 (x86). |
9675 | 318 </para></listitem> |
319 </itemizedlist> | |
18672 | 320 </listitem> |
321 </itemizedlist> | |
17294 | 322 </sect2> |
9675 | 323 |
21521 | 324 <!-- ********** --> |
325 | |
17294 | 326 <sect2 id="irix"> |
327 <title>IRIX</title> | |
21521 | 328 |
9675 | 329 <para> |
330 You can either try to install the GNU install program, and (if you did | |
331 not put it in your global path) then point to the location with: | |
21521 | 332 <screen> |
333 ./configure --with-install=<replaceable>/path/and/name/of/install</replaceable> | |
334 </screen> | |
9675 | 335 </para> |
336 | |
337 <para> | |
338 Or you can use the default install delivered with IRIX 6.5 in which case | |
339 you will have to edit the <filename>Makefile</filename> by hand a little bit. | |
23143
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
22481
diff
changeset
|
340 Change the line: |
9675 | 341 <programlisting> |
21521 | 342 $(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1 |
9675 | 343 </programlisting> |
344 to: | |
345 <programlisting> | |
21521 | 346 $(INSTALL) -m 644 mplayer.1 $(MANDIR)/man1/ |
9675 | 347 </programlisting> |
348 and then go on with building and installing. | |
349 </para> | |
17294 | 350 </sect2> |
9675 | 351 |
21521 | 352 <!-- ********** --> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
353 |
17294 | 354 <sect2 id="hp-ux"> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
355 <title>HP-UX</title> |
21521 | 356 |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
357 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
358 Joe Page hosts a detailed HP-UX <application>MPlayer</application> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
359 <ulink url="http://users.rcn.com/joepage/mplayer_on_hpux11.htm">HOWTO</ulink> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
360 by Martin Gansser on his homepage. With these instructions the build should |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
361 work out of the box. The following information is taken from this HOWTO. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
362 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
363 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
364 <para> |
28384
452c6b9ffaad
Remove remarks about GNU Make being required on some systems.
diego
parents:
28114
diff
changeset
|
365 You need GCC 3.4.0 or later and SDL 1.2.7 or later. |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
366 HP cc will not produce a working program, prior GCC versions are buggy. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
367 For OpenGL functionality you need to install Mesa and the gl and gl2 video |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
368 output drivers should work, speed may be very bad, depending on the CPU speed, |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
369 though. A good replacement for the rather poor native HP-UX sound system is |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
370 GNU esound. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
371 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
372 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
373 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
374 Create the DVD device |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
375 scan the SCSI bus with: |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
376 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
377 <screen> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
378 # ioscan -fn |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
379 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
380 Class I H/W Path Driver S/W State H/W Type Description |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
381 ... |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
382 ext_bus 1 8/16/5 c720 CLAIMED INTERFACE Built-in SCSI |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
383 target 3 8/16/5.2 tgt CLAIMED DEVICE |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
384 disk 4 8/16/5.<emphasis role="bold">2</emphasis>.<emphasis role="bold">0</emphasis> sdisk CLAIMED DEVICE <emphasis role="bold">PIONEER DVD-ROM DVD-305</emphasis> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
385 /dev/dsk/c1t2d0 <emphasis role="bold">/dev/rdsk/c1t2d0</emphasis> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
386 target 4 8/16/5.7 tgt CLAIMED DEVICE |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
387 ctl <emphasis role="bold">1</emphasis> 8/16/5.7.0 sctl CLAIMED DEVICE Initiator |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
388 /dev/rscsi/c1t7d0 /dev/rscsi/c1t7l0 /dev/scsi/c1t7l0 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
389 ... |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
390 </screen> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
391 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
392 The screen output shows a Pioneer DVD-ROM at SCSI address 2. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
393 The card instance for hardware path 8/16 is 1. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
394 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
395 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
396 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
397 Create a link from the raw device to the DVD device. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
398 <screen> |
21521 | 399 ln -s /dev/rdsk/c<replaceable><SCSI bus instance></replaceable>t<replaceable><SCSI target ID></replaceable>d<replaceable><LUN></replaceable> /dev/<replaceable><device></replaceable> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
400 </screen> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
401 Example: |
21521 | 402 <screen>ln -s /dev/rdsk/c1t2d0 /dev/dvd</screen> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
403 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
404 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
405 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
406 Below are solutions for some common problems: |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
407 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
408 <itemizedlist> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
409 <listitem> |
21521 | 410 <para> |
411 Crash at Start with the following error message: | |
412 <screen> | |
413 /usr/lib/dld.sl: Unresolved symbol: finite (code) from /usr/local/lib/gcc-lib/hppa2.0n-hp-hpux11.00/3.2/../../../libGL.sl<!-- | |
414 --></screen> | |
415 </para> | |
416 <para> | |
417 This means that the function <systemitem>.finite().</systemitem> is not | |
418 available in the standard HP-UX math library. | |
419 Instead there is <systemitem>.isfinite().</systemitem>. | |
420 Solution: Use the latest Mesa depot file. | |
421 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
422 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
423 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
424 <listitem> |
21521 | 425 <para> |
426 Crash at playback with the following error message: | |
427 <screen> | |
428 /usr/lib/dld.sl: Unresolved symbol: sem_init (code) from /usr/local/lib/libSDL-1.2.sl.0<!-- | |
429 --></screen> | |
430 </para> | |
431 <para> | |
432 Solution: Use the extralibdir option of configure | |
433 <option>--with-extralibdir="/usr/lib -lrt"</option> | |
434 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
435 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
436 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
437 <listitem> |
21521 | 438 <para> |
439 MPlayer segfaults with a message like this: | |
440 <screen> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
441 Pid 10166 received a SIGSEGV for stack growth failure. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
442 Possible causes: insufficient memory or swap space, or stack size exceeded maxssiz. |
21521 | 443 Segmentation fault<!-- |
444 --></screen> | |
445 </para> | |
446 <para> | |
447 Solution: | |
448 The HP-UX kernel has a default stack size of 8MB(?) per process.(11.0 and | |
449 newer 10.20 patches let you increase <systemitem>maxssiz</systemitem> up to | |
450 350MB for 32-bit programs). You need to extend | |
451 <systemitem>maxssiz</systemitem> and recompile the kernel (and reboot). | |
452 You can use SAM to do this. | |
453 (While at it, check out the <systemitem>maxdsiz</systemitem> parameter for | |
454 the maximum amount of data a program can use. | |
455 It depends on your applications, if the default of 64MB is enough or not.) | |
456 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
457 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
458 </itemizedlist> |
21521 | 459 </para> |
460 </sect2> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
461 |
21521 | 462 <!-- ********** --> |
17442 | 463 |
464 <sect2 id="aix"> | |
465 <title>AIX</title> | |
21521 | 466 |
17442 | 467 <para> |
468 <application>MPlayer</application> builds successfully on AIX 5.1, | |
469 5.2, and 5.3, using GCC 3.3 or greater. Building | |
470 <application>MPlayer</application> on AIX 4.3.3 and below is | |
471 untested. It is highly recommended that you build | |
472 <application>MPlayer</application> using GCC 3.4 or greater, | |
473 or if you are building on POWER5, GCC 4.0 is required. | |
474 </para> | |
475 | |
476 <para> | |
477 CPU detection is still a work in progress. | |
478 The following architectures have been tested: | |
479 </para> | |
480 | |
481 <itemizedlist> | |
21521 | 482 <listitem><para>604e</para></listitem> |
483 <listitem><para>POWER3</para></listitem> | |
484 <listitem><para>POWER4</para></listitem> | |
17442 | 485 </itemizedlist> |
486 | |
487 <para> | |
488 The following architectures are untested, but should still work: | |
21521 | 489 <itemizedlist> |
490 <listitem><para>POWER</para></listitem> | |
491 <listitem><para>POWER2</para></listitem> | |
492 <listitem><para>POWER5</para></listitem> | |
493 </itemizedlist> | |
17442 | 494 </para> |
495 | |
496 <para> | |
497 Sound via the Ultimedia Services is not supported, as Ultimedia was | |
498 dropped in AIX 5.1; therefore, the only option is to use the AIX Open | |
21521 | 499 Sound System (OSS) drivers from 4Front Technologies at |
500 <ulink url="http://www.opensound.com/aix.html">http://www.opensound.com/aix.html</ulink>. | |
18672 | 501 4Front Technologies freely provides OSS drivers for AIX 5.1 for |
502 non-commercial use; however, there are currently no sound output | |
503 drivers for AIX 5.2 or 5.3. This means <emphasis role="bold">AIX 5.2 | |
504 and 5.3 are not capable of MPlayer audio output, presently.</emphasis> | |
17442 | 505 </para> |
506 | |
18672 | 507 <para>Solutions to common problems:</para> |
508 | |
509 <itemizedlist> | |
510 <listitem> | |
511 <para> | |
21521 | 512 If you encounter this error message from <filename>./configure</filename>: |
513 <screen> | |
18672 | 514 $ ./configure |
515 ... | |
516 Checking for iconv program ... no | |
517 No working iconv program found, use | |
518 --charset=US-ASCII to continue anyway. | |
21521 | 519 Messages in the GTK-2 interface will be broken then.<!-- |
520 --></screen> | |
521 This is because AIX uses non-standard character set names; therefore, | |
522 converting MPlayer output to another character set is currently not | |
523 supported. The solution is to use: | |
524 <screen>$ ./configure --charset=noconv</screen> | |
525 </para> | |
18672 | 526 </listitem> |
527 </itemizedlist> | |
17442 | 528 </sect2> |
9675 | 529 </sect1> |
530 | |
21521 | 531 |
532 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
533 | |
534 | |
10561 | 535 <sect1 id="windows"> |
536 <title>Windows</title> | |
537 | |
21521 | 538 <para> |
539 Yes, <application>MPlayer</application> runs on Windows under | |
540 <ulink url="http://www.cygwin.com/"><application>Cygwin</application></ulink> | |
541 and | |
542 <ulink url="http://www.mingw.org/"><application>MinGW</application></ulink>. | |
543 It does not have an official GUI yet, but the command line version | |
544 is completely functional. You should check out the | |
545 <ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">MPlayer-cygwin</ulink> | |
546 mailing list for help and latest information. | |
547 Official Windows binaries can be found on the | |
548 <ulink url="http://www.mplayerhq.hu/design7/dload.html">download page</ulink>. | |
549 Installer packages and simple GUI frontends are available from external | |
550 sources, we have collected then in the Windows section of our | |
551 <ulink url="http://www.mplayerhq.hu/design7/projects.html#windows">projects page</ulink>. | |
15458
9df34c9d1747
Explain how to drop movies on desktop shortcuts, other updates.
diego
parents:
15136
diff
changeset
|
552 </para> |
9df34c9d1747
Explain how to drop movies on desktop shortcuts, other updates.
diego
parents:
15136
diff
changeset
|
553 |
21521 | 554 <para> |
555 If you wish to avoid using the command line, a simple trick is | |
556 to put a shortcut on your desktop that contains something like the | |
557 following in the execute section: | |
558 <screen><replaceable>c:\path\to\</replaceable>mplayer.exe %1</screen> | |
559 This will make <application>MPlayer</application> play any movie that is | |
560 dropped on the shortcut. Add <option>-fs</option> for fullscreen mode. | |
15458
9df34c9d1747
Explain how to drop movies on desktop shortcuts, other updates.
diego
parents:
15136
diff
changeset
|
561 </para> |
10561 | 562 |
21521 | 563 <para> |
564 Best results are achieved with the native DirectX video output driver | |
565 (<option>-vo directx</option>). Alternatives are OpenGL and SDL, but OpenGL | |
566 performance varies greatly between systems and SDL is known to | |
567 distort video or crash on some systems. If the image is | |
568 distorted, try turning off hardware acceleration with | |
569 <option>-vo directx:noaccel</option>. Download | |
25742 | 570 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/win32/dx7headers.tgz">DirectX 7 header files</ulink> |
21521 | 571 to compile the DirectX video output driver. Furthermore you need to have |
572 DirectX 7 or later installed for the DirectX video output driver to work. | |
573 </para> | |
12418
80266d26d80c
winvidix documented, alternative ways of specifying -dvd-device.
diego
parents:
12325
diff
changeset
|
574 |
21521 | 575 <para> |
576 <link linkend="vidix">VIDIX</link> now works under Windows as | |
577 <option>-vo winvidix</option>, although it is still experimental | |
578 and needs a bit of manual setup. Download | |
579 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/dhahelper.sys">dhahelper.sys</ulink> or | |
580 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/withmtrr/dhahelper.sys">dhahelper.sys (with MTRR support)</ulink> | |
23253 | 581 and copy it to the <filename class="directory">vidix/dhahelperwin</filename> |
21521 | 582 directory in your <application>MPlayer</application> source tree. |
26904
b4a743e6d17d
Add install-dhahelperwin target to simplify dhahelper installation on Windows.
diego
parents:
26899
diff
changeset
|
583 Open a console and type |
b4a743e6d17d
Add install-dhahelperwin target to simplify dhahelper installation on Windows.
diego
parents:
26899
diff
changeset
|
584 <screen>make install-dhahelperwin</screen> |
25743 | 585 as Administrator. After that you will have to reboot. |
21521 | 586 </para> |
12418
80266d26d80c
winvidix documented, alternative ways of specifying -dvd-device.
diego
parents:
12325
diff
changeset
|
587 |
21521 | 588 <para> |
589 For best results <application>MPlayer</application> should use a | |
590 colorspace that your video card supports in hardware. Unfortunately many | |
591 Windows graphics drivers wrongly report some colorspaces as supported in | |
592 hardware. To find out which, try | |
593 <screen> | |
594 mplayer -benchmark -nosound -frames 100 -vf format=<replaceable>colorspace</replaceable> <replaceable>movie</replaceable> | |
595 </screen> | |
596 where <replaceable>colorspace</replaceable> can be any colorspace | |
597 printed by the <option>-vf format=fmt=help</option> option. If you | |
598 find a colorspace your card handles particularly bad | |
599 <option>-vf noformat=<replaceable>colorspace</replaceable></option> | |
600 will keep it from being used. Add this to your config file to permanently | |
601 keep it from being used. | |
602 </para> | |
12325
9e5ebd0c97d0
Hint about testing different colorspaces and putting codes in ./, based on
diego
parents:
12014
diff
changeset
|
603 |
14533
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
604 <para>There are special codec packages for Windows available on our |
19803
a8367d5b416b
link fix: The codecs page was merged into the download page.
diego
parents:
19709
diff
changeset
|
605 <ulink url="http://www.mplayerhq.hu/design7/dload.html">download page</ulink> |
14533
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
606 to allow playing formats for which there is no native support yet. |
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
607 Put the codecs somewhere in your path or pass |
20545 | 608 <option>--codecsdir=<replaceable>c:/path/to/your/codecs</replaceable></option> |
14533
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
609 (alternatively |
20545 | 610 <option>--codecsdir=<replaceable>/path/to/your/codecs</replaceable></option> |
14533
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
611 only on <application>Cygwin</application>) to <filename>configure</filename>. |
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
612 We have had some reports that Real DLLs need to be writable by the user |
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
613 running <application>MPlayer</application>, but only on some systems (NT4). |
21521 | 614 Try making them writable if you have problems. |
615 </para> | |
12439
33916977a36e
Cygwin and MinGW now behave similarly with regard to VCD/DVD playback.
diego
parents:
12418
diff
changeset
|
616 |
21521 | 617 <para> |
618 You can play VCDs by playing the <filename>.DAT</filename> or | |
619 <filename>.MPG</filename> files that Windows exposes on VCDs. It works like | |
620 this (adjust for the drive letter of your CD-ROM): | |
621 <screen>mplayer <replaceable>d:/mpegav/avseq01.dat</replaceable></screen> | |
25095
b97d8dedb68b
vcd://<n> now works for MinGW32 too, hence the updated doc
zuxy
parents:
25091
diff
changeset
|
622 Alternatively, you can play a VCD track directly by using: |
b97d8dedb68b
vcd://<n> now works for MinGW32 too, hence the updated doc
zuxy
parents:
25091
diff
changeset
|
623 <screen>mplayer vcd://<replaceable><track></replaceable> -cdrom-device <replaceable>d:</replaceable> |
b97d8dedb68b
vcd://<n> now works for MinGW32 too, hence the updated doc
zuxy
parents:
25091
diff
changeset
|
624 </screen> |
21521 | 625 DVDs also work, adjust <option>-dvd-device</option> for the drive letter |
626 of your DVD-ROM: | |
627 <screen> | |
25091 | 628 mplayer dvd://<replaceable><title></replaceable> -dvd-device <replaceable>d:</replaceable> |
21521 | 629 </screen> |
630 The <application>Cygwin</application>/<application>MinGW</application> | |
631 console is rather slow. Redirecting output or using the | |
632 <option>-quiet</option> option has been reported to improve performance on | |
633 some systems. Direct rendering (<option>-dr</option>) may also help. | |
634 If playback is jerky, try | |
635 <option>-autosync 100</option>. If some of these options help you, you | |
636 may want to put them in your config file. | |
637 </para> | |
10561 | 638 |
17158 | 639 <note> |
21521 | 640 <para> |
641 If you have a Pentium 4 and are experiencing a crash using the | |
642 RealPlayer codecs, you may need to disable hyperthreading support. | |
17158 | 643 </para> |
644 </note> | |
645 | |
21521 | 646 <!-- ********** --> |
17158 | 647 |
10561 | 648 <sect2 id="cygwin"> |
11540 | 649 <title><application>Cygwin</application></title> |
10561 | 650 |
21521 | 651 <para> |
652 You need to run <application>Cygwin</application> 1.5.0 or later in | |
653 order to compile <application>MPlayer</application>. | |
654 </para> | |
10561 | 655 |
21521 | 656 <para> |
657 DirectX header files need to be extracted to | |
658 <filename class="directory">/usr/include/</filename> or | |
659 <filename class="directory">/usr/local/include/</filename>. | |
660 </para> | |
10561 | 661 |
21521 | 662 <para> |
663 Instructions and files for making SDL run under | |
664 <application>Cygwin</application> can be found on the | |
665 <ulink url="http://www.libsdl.org/extras/win32/cygwin/">libsdl site</ulink>. | |
666 </para> | |
10561 | 667 </sect2> |
668 | |
21521 | 669 <!-- ********** --> |
10561 | 670 |
671 <sect2 id="mingw"> | |
11540 | 672 <title><application>MinGW</application></title> |
10561 | 673 |
21521 | 674 <para> |
675 Installing a version of <application>MinGW</application> that could | |
676 compile <application>MPlayer</application> used to be quite tricky, but it | |
677 works out of the box now. Just install <application>MinGW</application> | |
678 3.1.0 or later and MSYS 1.0.9 or later and tell the MSYS postinstall that | |
679 <application>MinGW</application> is installed. | |
680 </para> | |
9675 | 681 |
21521 | 682 <para> |
683 Extract DirectX header files to | |
684 <filename class="directory">/mingw/include/</filename>. | |
685 </para> | |
10191 | 686 |
21521 | 687 <para> |
688 MOV compressed header support requires | |
689 <ulink url="http://www.gzip.org/zlib/">zlib</ulink>, | |
690 which <application>MinGW</application> does not provide by default. | |
691 Configure it with <option>--prefix=/mingw</option> and install | |
692 it before compiling <application>MPlayer</application>. | |
693 </para> | |
12496
8f4574d094a5
MinGW comes without zlib (necessary for compressed MOV headers).
diego
parents:
12439
diff
changeset
|
694 |
21521 | 695 <para> |
696 Complete instructions for building <application>MPlayer</application> | |
697 and necessary libraries can be found in the | |
25742 | 698 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/win32/MPlayer-MinGW-Howto.txt">MPlayer MinGW HOWTO</ulink>. |
21521 | 699 </para> |
10561 | 700 </sect2> |
21521 | 701 </sect1> |
10561 | 702 |
703 | |
21521 | 704 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
705 | |
9675 | 706 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
707 <sect1 id="macos"> |
11348 | 708 <title>Mac OS</title> |
18839 | 709 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
710 <para> |
17272 | 711 <application>MPlayer</application> does not work on Mac OS versions before |
712 10, but should compile out-of-the-box on Mac OS X 10.2 and up. | |
713 The preferred compiler is the Apple version of | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
714 GCC 3.x or later. |
18839 | 715 You can get the basic compilation environment by installing Apple's |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
716 <ulink url="http://developer.apple.com/tools/download/">Xcode</ulink>. |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
717 If you have Mac OS X 10.3.9 or later and QuickTime 7 |
18839 | 718 you can use the <option>macosx</option> video output driver. |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
719 </para> |
18839 | 720 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
721 <para> |
18839 | 722 Unfortunately, this basic environment will not allow you to take advantage |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
723 of all the nice features of <application>MPlayer</application>. |
18839 | 724 For instance, in order to have OSD support compiled in, you will |
725 need to have <systemitem class="library">fontconfig</systemitem> | |
726 and <systemitem class="library">freetype</systemitem> libraries | |
727 installed on your machine. Contrary to other Unixes such as most | |
728 Linux and BSD variants, OS X does not have a package system | |
729 that comes with the system. | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
730 </para> |
18839 | 731 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
732 <para> |
18839 | 733 There are at least two to choose from: |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
734 <ulink url="http://fink.sourceforge.net/">Fink</ulink> and |
20401 | 735 <ulink url="http://www.macports.org/">MacPorts</ulink>. |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
736 Both of them provide about the same service (i.e. a lot of packages to |
18839 | 737 choose from, dependency resolution, the ability to simply add/update/remove |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
738 packages, etc...). |
18839 | 739 Fink offers both precompiled binary packages or building everything from |
20401 | 740 source, whereas MacPorts only offers building from source. |
741 The author of this guide chose MacPorts for the simple fact that its basic | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
742 setup was more lightweight. |
20401 | 743 Later examples will be based on MacPorts. |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
744 </para> |
18839 | 745 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
746 <para> |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
747 For instance, to compile <application>MPlayer</application> with OSD support: |
26958 | 748 <screen>sudo port install pkg-config</screen> |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
749 This will install <application>pkg-config</application>, which is a system for |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
750 managing library compile/link flags. |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
751 <application>MPlayer</application>'s <systemitem>configure</systemitem> script |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
752 uses it to properly detect libraries. |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
753 Then you can install <application>fontconfig</application> in a |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
754 similar way: |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
755 <screen>sudo port install fontconfig</screen> |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
756 Then you can proceed with launching <application>MPlayer</application>'s |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
757 <systemitem>configure</systemitem> script (note the |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
758 <systemitem>PKG_CONFIG_PATH</systemitem> and <systemitem>PATH</systemitem> |
18839 | 759 environment variables so that <systemitem>configure</systemitem> finds the |
20401 | 760 libraries installed with MacPorts): |
21521 | 761 <screen> |
762 PKG_CONFIG_PATH=/opt/local/lib/pkgconfig/ PATH=$PATH:/opt/local/bin/ ./configure | |
763 </screen> | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
764 </para> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
765 |
21521 | 766 <!-- ********** --> |
767 | |
17294 | 768 <sect2 id="osx_gui"> |
769 <title>MPlayer OS X GUI</title> | |
21521 | 770 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
771 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
772 You can get a native GUI for <application>MPlayer</application> together with |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
773 precompiled <application>MPlayer</application> binaries for Mac OS X from the |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
774 <ulink url="http://mplayerosx.sf.net/">MPlayerOSX</ulink> project, but be |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
775 warned: that project is not active anymore. |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
776 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
777 |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
778 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
779 Fortunately, <application>MPlayerOSX</application> has been taken over |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
780 by a member of the <application>MPlayer</application> team. |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
781 Preview releases are available from our |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
782 <ulink url="http://mplayerhq.hu/dload.html">download page</ulink> |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
783 and an official release should arrive soon. |
16317 | 784 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
785 |
16317 | 786 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
787 In order to build <application>MPlayerOSX</application> from source |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
788 yourself, you need the <systemitem>mplayerosx</systemitem>, the |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
789 <systemitem>main</systemitem> and a copy of the |
20403 | 790 <systemitem>main</systemitem> SVN module named |
16317 | 791 <systemitem>main_noaltivec</systemitem>. |
792 <systemitem>mplayerosx</systemitem> is the GUI frontend, | |
793 <systemitem>main</systemitem> is MPlayer and | |
794 <systemitem>main_noaltivec</systemitem> is MPlayer built without AltiVec | |
795 support. | |
796 </para> | |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
797 |
16317 | 798 <para> |
19099 | 799 To check out SVN modules use: |
16317 | 800 <screen> |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
801 svn checkout svn://svn.mplayerhq.hu/mplayerosx/trunk/ mplayerosx |
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
802 svn checkout svn://svn.mplayerhq.hu/mplayer/trunk/ main |
16317 | 803 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
804 </para> |
16317 | 805 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
806 <para> |
16317 | 807 In order to build <application>MPlayerOSX</application> you will need to |
808 set up something like this: | |
809 <screen> | |
810 MPlayer_source_directory | |
811 | | |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
812 |--->main (MPlayer Subversion source) |
16317 | 813 | |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
814 |--->main_noaltivec (MPlayer Subversion source configured with --disable-altivec) |
16317 | 815 | |
21521 | 816 \--->mplayerosx (MPlayer OS X Subversion source) |
16317 | 817 </screen> |
818 You first need to build main and main_noaltivec. | |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
819 </para> |
16317 | 820 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
821 <para> |
22481 | 822 To begin with, in order to ensure maximum backwards compatibility, set an |
823 environment variable: | |
16317 | 824 <screen>export MACOSX_DEPLOYMENT_TARGET=10.3</screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
825 </para> |
16317 | 826 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
827 <para> |
16317 | 828 Then, configure: |
829 </para> | |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
830 |
16317 | 831 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
832 If you configure for a G4 or later CPU with AltiVec support, do as follows: |
16317 | 833 <screen> |
22481 | 834 ./configure --disable-gl --disable-x11 |
16317 | 835 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
836 If you configure for a G3-powered machine without AltiVec, use: |
16317 | 837 <screen> |
22481 | 838 ./configure --disable-gl --disable-x11 --disable-altivec |
16317 | 839 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
840 You may need to edit <filename>config.mak</filename> and change |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
841 <systemitem>-mcpu</systemitem> and <systemitem>-mtune</systemitem> |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
842 from <systemitem>74XX</systemitem> to <systemitem>G3</systemitem>. |
16317 | 843 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
844 |
16317 | 845 <para> |
846 Continue with | |
21521 | 847 <screen>make</screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
848 then go to the mplayerosx directory and type |
21521 | 849 <screen>make dist</screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
850 This will create a compressed <systemitem>.dmg</systemitem> archive |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
851 with the ready to use binary. |
16317 | 852 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
853 |
16317 | 854 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
855 You can also use the <application>Xcode</application> 2.1 project; |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
856 the old project for <application>Xcode</application> 1.x does |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
857 not work anymore. |
11341 | 858 </para> |
17307 | 859 </sect2> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
860 </sect1> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
861 |
21521 | 862 |
863 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
864 | |
865 | |
17294 | 866 <sect1 id="exotic_platforms"> |
867 <title>Exotic Platforms</title> | |
868 | |
869 <para> | |
870 <application>MPlayer</application> runs on a number of exotic platforms, | |
871 but most of the platform-specific changes from those systems have not been | |
872 merged back into the main source tree. | |
873 For build instructions you should refer to the system-specific documentation. | |
874 </para> | |
875 | |
21521 | 876 <!-- ********** --> |
877 | |
17294 | 878 <sect2 id="qnx"> |
879 <title>QNX</title> | |
21521 | 880 |
17294 | 881 <para> |
882 You'll need to download and install SDL for QNX. Then run | |
17496 | 883 <application>MPlayer</application> with <option>-vo sdl:driver=photon</option> |
17294 | 884 and <option>-ao sdl:nto</option> options, it should be fast. |
885 </para> | |
886 | |
887 <para> | |
888 The <option>-vo x11</option> output will be even slower than on Linux, | |
889 since QNX has only X <emphasis>emulation</emphasis> which is very slow. | |
890 </para> | |
891 </sect2> | |
892 | |
21521 | 893 <!-- ********** --> |
894 | |
17294 | 895 <sect2 id="amiga"> |
11607 | 896 <title>Amiga/MorphOS (GeekGadgets)</title> |
897 <para> | |
21521 | 898 The people over at |
899 <ulink url="http://www.amigasoft.net">www.amigasoft.net</ulink> | |
16121 | 900 make current <application>MPlayer</application> and |
901 <application>MEncoder</application> packages. | |
902 </para> | |
903 | |
904 <para> | |
11607 | 905 Nicholas Det at Genesi has done a big and powerful port of <application>MPlayer |
906 </application> for MorphOS. Sadly it's based on the 0.90 series. | |
907 </para> | |
908 | |
909 <para> | |
910 Get if from <ulink url="http://www.morphzone.org/">MorphZone</ulink>: | |
11621 | 911 <itemizedlist> |
912 <listitem><para> | |
21521 | 913 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=90"> |
914 <application>MPlayer</application> 0.91 binary</ulink> | |
11621 | 915 </para></listitem> |
916 <listitem><para> | |
21521 | 917 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=91"> |
918 <application>MPlayer</application> 0.91 source</ulink> | |
11621 | 919 </para></listitem> |
920 <listitem><para> | |
21521 | 921 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=92"> |
922 <application>MEncoder</application> 1.0pre3 binary</ulink> | |
11621 | 923 </para></listitem> |
924 </itemizedlist> | |
11607 | 925 </para> |
17294 | 926 </sect2> |
11607 | 927 </sect1> |
928 | |
9675 | 929 </chapter> |