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