Mercurial > mplayer.hg
annotate DOCS/xml/en/ports.xml @ 28172:0bb8cfb41f84
Remove audio output section, it provides little to no useful information.
author | diego |
---|---|
date | Sat, 27 Dec 2008 21:44:33 +0000 |
parents | a1451877ff0e |
children | 452c6b9ffaad |
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> | |
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> | |
26958 | 328 A similar bug is present in the hsfs(7FS) file system code (AKA ISO9660), |
21521 | 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 | |
26958 | 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. | |
23143
89cee9f0dfa6
Remove outdated and wrong references to codecs.conf.
diego
parents:
22481
diff
changeset
|
356 Change the line: |
9675 | 357 <programlisting> |
21521 | 358 $(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1 |
9675 | 359 </programlisting> |
360 to: | |
361 <programlisting> | |
21521 | 362 $(INSTALL) -m 644 mplayer.1 $(MANDIR)/man1/ |
9675 | 363 </programlisting> |
364 and then go on with building and installing. | |
365 </para> | |
17294 | 366 </sect2> |
9675 | 367 |
21521 | 368 <!-- ********** --> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
369 |
17294 | 370 <sect2 id="hp-ux"> |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
371 <title>HP-UX</title> |
21521 | 372 |
14114
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 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
|
375 <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
|
376 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
|
377 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
|
378 </para> |
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 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
381 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
|
382 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
|
383 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
|
384 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
|
385 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
|
386 GNU esound. |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
387 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
388 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
389 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
390 Create the DVD device |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
391 scan the SCSI bus with: |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
392 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
393 <screen> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
394 # ioscan -fn |
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 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
|
397 ... |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
398 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
|
399 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
|
400 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
|
401 /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
|
402 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
|
403 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
|
404 /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
|
405 ... |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
406 </screen> |
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 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
|
409 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
|
410 </para> |
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 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
413 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
|
414 <screen> |
21521 | 415 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
|
416 </screen> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
417 Example: |
21521 | 418 <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
|
419 </para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
420 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
421 <para> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
422 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
|
423 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
424 <itemizedlist> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
425 <listitem> |
21521 | 426 <para> |
427 Crash at Start with the following error message: | |
428 <screen> | |
429 /usr/lib/dld.sl: Unresolved symbol: finite (code) from /usr/local/lib/gcc-lib/hppa2.0n-hp-hpux11.00/3.2/../../../libGL.sl<!-- | |
430 --></screen> | |
431 </para> | |
432 <para> | |
433 This means that the function <systemitem>.finite().</systemitem> is not | |
434 available in the standard HP-UX math library. | |
435 Instead there is <systemitem>.isfinite().</systemitem>. | |
436 Solution: Use the latest Mesa depot file. | |
437 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
438 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
439 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
440 <listitem> |
21521 | 441 <para> |
442 Crash at playback with the following error message: | |
443 <screen> | |
444 /usr/lib/dld.sl: Unresolved symbol: sem_init (code) from /usr/local/lib/libSDL-1.2.sl.0<!-- | |
445 --></screen> | |
446 </para> | |
447 <para> | |
448 Solution: Use the extralibdir option of configure | |
449 <option>--with-extralibdir="/usr/lib -lrt"</option> | |
450 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
451 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
452 |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
453 <listitem> |
21521 | 454 <para> |
455 MPlayer segfaults with a message like this: | |
456 <screen> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
457 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
|
458 Possible causes: insufficient memory or swap space, or stack size exceeded maxssiz. |
21521 | 459 Segmentation fault<!-- |
460 --></screen> | |
461 </para> | |
462 <para> | |
463 Solution: | |
464 The HP-UX kernel has a default stack size of 8MB(?) per process.(11.0 and | |
465 newer 10.20 patches let you increase <systemitem>maxssiz</systemitem> up to | |
466 350MB for 32-bit programs). You need to extend | |
467 <systemitem>maxssiz</systemitem> and recompile the kernel (and reboot). | |
468 You can use SAM to do this. | |
469 (While at it, check out the <systemitem>maxdsiz</systemitem> parameter for | |
470 the maximum amount of data a program can use. | |
471 It depends on your applications, if the default of 64MB is enough or not.) | |
472 </para> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
473 </listitem> |
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
474 </itemizedlist> |
21521 | 475 </para> |
476 </sect2> | |
14114
072c69e79c23
More detailed HP-UX instructions, mostly taken from Martin Gansser's HOWTO.
diego
parents:
14044
diff
changeset
|
477 |
21521 | 478 <!-- ********** --> |
17442 | 479 |
480 <sect2 id="aix"> | |
481 <title>AIX</title> | |
21521 | 482 |
17442 | 483 <para> |
484 <application>MPlayer</application> builds successfully on AIX 5.1, | |
485 5.2, and 5.3, using GCC 3.3 or greater. Building | |
486 <application>MPlayer</application> on AIX 4.3.3 and below is | |
487 untested. It is highly recommended that you build | |
488 <application>MPlayer</application> using GCC 3.4 or greater, | |
489 or if you are building on POWER5, GCC 4.0 is required. | |
490 </para> | |
491 | |
492 <para> | |
493 Ensure that you are using GNU make | |
494 (<filename>/opt/freeware/bin/gmake</filename>) to build | |
495 <application>MPlayer</application>, as you will encounter problems if | |
496 you use <filename>/usr/ccs/bin/make</filename>. | |
497 </para> | |
498 | |
499 <para> | |
500 CPU detection is still a work in progress. | |
501 The following architectures have been tested: | |
502 </para> | |
503 | |
504 <itemizedlist> | |
21521 | 505 <listitem><para>604e</para></listitem> |
506 <listitem><para>POWER3</para></listitem> | |
507 <listitem><para>POWER4</para></listitem> | |
17442 | 508 </itemizedlist> |
509 | |
510 <para> | |
511 The following architectures are untested, but should still work: | |
21521 | 512 <itemizedlist> |
513 <listitem><para>POWER</para></listitem> | |
514 <listitem><para>POWER2</para></listitem> | |
515 <listitem><para>POWER5</para></listitem> | |
516 </itemizedlist> | |
17442 | 517 </para> |
518 | |
519 <para> | |
520 Sound via the Ultimedia Services is not supported, as Ultimedia was | |
521 dropped in AIX 5.1; therefore, the only option is to use the AIX Open | |
21521 | 522 Sound System (OSS) drivers from 4Front Technologies at |
523 <ulink url="http://www.opensound.com/aix.html">http://www.opensound.com/aix.html</ulink>. | |
18672 | 524 4Front Technologies freely provides OSS drivers for AIX 5.1 for |
525 non-commercial use; however, there are currently no sound output | |
526 drivers for AIX 5.2 or 5.3. This means <emphasis role="bold">AIX 5.2 | |
527 and 5.3 are not capable of MPlayer audio output, presently.</emphasis> | |
17442 | 528 </para> |
529 | |
18672 | 530 <para>Solutions to common problems:</para> |
531 | |
532 <itemizedlist> | |
533 <listitem> | |
534 <para> | |
21521 | 535 If you encounter this error message from <filename>./configure</filename>: |
536 <screen> | |
18672 | 537 $ ./configure |
538 ... | |
539 Checking for iconv program ... no | |
540 No working iconv program found, use | |
541 --charset=US-ASCII to continue anyway. | |
21521 | 542 Messages in the GTK-2 interface will be broken then.<!-- |
543 --></screen> | |
544 This is because AIX uses non-standard character set names; therefore, | |
545 converting MPlayer output to another character set is currently not | |
546 supported. The solution is to use: | |
547 <screen>$ ./configure --charset=noconv</screen> | |
548 </para> | |
18672 | 549 </listitem> |
550 </itemizedlist> | |
17442 | 551 </sect2> |
9675 | 552 </sect1> |
553 | |
21521 | 554 |
555 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
556 | |
557 | |
10561 | 558 <sect1 id="windows"> |
559 <title>Windows</title> | |
560 | |
21521 | 561 <para> |
562 Yes, <application>MPlayer</application> runs on Windows under | |
563 <ulink url="http://www.cygwin.com/"><application>Cygwin</application></ulink> | |
564 and | |
565 <ulink url="http://www.mingw.org/"><application>MinGW</application></ulink>. | |
566 It does not have an official GUI yet, but the command line version | |
567 is completely functional. You should check out the | |
568 <ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">MPlayer-cygwin</ulink> | |
569 mailing list for help and latest information. | |
570 Official Windows binaries can be found on the | |
571 <ulink url="http://www.mplayerhq.hu/design7/dload.html">download page</ulink>. | |
572 Installer packages and simple GUI frontends are available from external | |
573 sources, we have collected then in the Windows section of our | |
574 <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
|
575 </para> |
9df34c9d1747
Explain how to drop movies on desktop shortcuts, other updates.
diego
parents:
15136
diff
changeset
|
576 |
21521 | 577 <para> |
578 If you wish to avoid using the command line, a simple trick is | |
579 to put a shortcut on your desktop that contains something like the | |
580 following in the execute section: | |
581 <screen><replaceable>c:\path\to\</replaceable>mplayer.exe %1</screen> | |
582 This will make <application>MPlayer</application> play any movie that is | |
583 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
|
584 </para> |
10561 | 585 |
21521 | 586 <para> |
587 Best results are achieved with the native DirectX video output driver | |
588 (<option>-vo directx</option>). Alternatives are OpenGL and SDL, but OpenGL | |
589 performance varies greatly between systems and SDL is known to | |
590 distort video or crash on some systems. If the image is | |
591 distorted, try turning off hardware acceleration with | |
592 <option>-vo directx:noaccel</option>. Download | |
25742 | 593 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/win32/dx7headers.tgz">DirectX 7 header files</ulink> |
21521 | 594 to compile the DirectX video output driver. Furthermore you need to have |
595 DirectX 7 or later installed for the DirectX video output driver to work. | |
596 </para> | |
12418
80266d26d80c
winvidix documented, alternative ways of specifying -dvd-device.
diego
parents:
12325
diff
changeset
|
597 |
21521 | 598 <para> |
599 <link linkend="vidix">VIDIX</link> now works under Windows as | |
600 <option>-vo winvidix</option>, although it is still experimental | |
601 and needs a bit of manual setup. Download | |
602 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/dhahelper.sys">dhahelper.sys</ulink> or | |
603 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32/dhahelperwin/withmtrr/dhahelper.sys">dhahelper.sys (with MTRR support)</ulink> | |
23253 | 604 and copy it to the <filename class="directory">vidix/dhahelperwin</filename> |
21521 | 605 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
|
606 Open a console and type |
b4a743e6d17d
Add install-dhahelperwin target to simplify dhahelper installation on Windows.
diego
parents:
26899
diff
changeset
|
607 <screen>make install-dhahelperwin</screen> |
25743 | 608 as Administrator. After that you will have to reboot. |
21521 | 609 </para> |
12418
80266d26d80c
winvidix documented, alternative ways of specifying -dvd-device.
diego
parents:
12325
diff
changeset
|
610 |
21521 | 611 <para> |
612 For best results <application>MPlayer</application> should use a | |
613 colorspace that your video card supports in hardware. Unfortunately many | |
614 Windows graphics drivers wrongly report some colorspaces as supported in | |
615 hardware. To find out which, try | |
616 <screen> | |
617 mplayer -benchmark -nosound -frames 100 -vf format=<replaceable>colorspace</replaceable> <replaceable>movie</replaceable> | |
618 </screen> | |
619 where <replaceable>colorspace</replaceable> can be any colorspace | |
620 printed by the <option>-vf format=fmt=help</option> option. If you | |
621 find a colorspace your card handles particularly bad | |
622 <option>-vf noformat=<replaceable>colorspace</replaceable></option> | |
623 will keep it from being used. Add this to your config file to permanently | |
624 keep it from being used. | |
625 </para> | |
12325
9e5ebd0c97d0
Hint about testing different colorspaces and putting codes in ./, based on
diego
parents:
12014
diff
changeset
|
626 |
14533
d5b27912e97a
Binary codecs and Windows section overhauled to reflect recent changes.
diego
parents:
14136
diff
changeset
|
627 <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
|
628 <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
|
629 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
|
630 Put the codecs somewhere in your path or pass |
20545 | 631 <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
|
632 (alternatively |
20545 | 633 <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
|
634 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
|
635 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
|
636 running <application>MPlayer</application>, but only on some systems (NT4). |
21521 | 637 Try making them writable if you have problems. |
638 </para> | |
12439
33916977a36e
Cygwin and MinGW now behave similarly with regard to VCD/DVD playback.
diego
parents:
12418
diff
changeset
|
639 |
21521 | 640 <para> |
641 You can play VCDs by playing the <filename>.DAT</filename> or | |
642 <filename>.MPG</filename> files that Windows exposes on VCDs. It works like | |
643 this (adjust for the drive letter of your CD-ROM): | |
644 <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
|
645 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
|
646 <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
|
647 </screen> |
21521 | 648 DVDs also work, adjust <option>-dvd-device</option> for the drive letter |
649 of your DVD-ROM: | |
650 <screen> | |
25091 | 651 mplayer dvd://<replaceable><title></replaceable> -dvd-device <replaceable>d:</replaceable> |
21521 | 652 </screen> |
653 The <application>Cygwin</application>/<application>MinGW</application> | |
654 console is rather slow. Redirecting output or using the | |
655 <option>-quiet</option> option has been reported to improve performance on | |
656 some systems. Direct rendering (<option>-dr</option>) may also help. | |
657 If playback is jerky, try | |
658 <option>-autosync 100</option>. If some of these options help you, you | |
659 may want to put them in your config file. | |
660 </para> | |
10561 | 661 |
17158 | 662 <note> |
21521 | 663 <para> |
664 If you have a Pentium 4 and are experiencing a crash using the | |
665 RealPlayer codecs, you may need to disable hyperthreading support. | |
17158 | 666 </para> |
667 </note> | |
668 | |
21521 | 669 <!-- ********** --> |
17158 | 670 |
10561 | 671 <sect2 id="cygwin"> |
11540 | 672 <title><application>Cygwin</application></title> |
10561 | 673 |
21521 | 674 <para> |
675 You need to run <application>Cygwin</application> 1.5.0 or later in | |
676 order to compile <application>MPlayer</application>. | |
677 </para> | |
10561 | 678 |
21521 | 679 <para> |
680 DirectX header files need to be extracted to | |
681 <filename class="directory">/usr/include/</filename> or | |
682 <filename class="directory">/usr/local/include/</filename>. | |
683 </para> | |
10561 | 684 |
21521 | 685 <para> |
686 Instructions and files for making SDL run under | |
687 <application>Cygwin</application> can be found on the | |
688 <ulink url="http://www.libsdl.org/extras/win32/cygwin/">libsdl site</ulink>. | |
689 </para> | |
10561 | 690 </sect2> |
691 | |
21521 | 692 <!-- ********** --> |
10561 | 693 |
694 <sect2 id="mingw"> | |
11540 | 695 <title><application>MinGW</application></title> |
10561 | 696 |
21521 | 697 <para> |
698 Installing a version of <application>MinGW</application> that could | |
699 compile <application>MPlayer</application> used to be quite tricky, but it | |
700 works out of the box now. Just install <application>MinGW</application> | |
701 3.1.0 or later and MSYS 1.0.9 or later and tell the MSYS postinstall that | |
702 <application>MinGW</application> is installed. | |
703 </para> | |
9675 | 704 |
21521 | 705 <para> |
706 Extract DirectX header files to | |
707 <filename class="directory">/mingw/include/</filename>. | |
708 </para> | |
10191 | 709 |
21521 | 710 <para> |
711 MOV compressed header support requires | |
712 <ulink url="http://www.gzip.org/zlib/">zlib</ulink>, | |
713 which <application>MinGW</application> does not provide by default. | |
714 Configure it with <option>--prefix=/mingw</option> and install | |
715 it before compiling <application>MPlayer</application>. | |
716 </para> | |
12496
8f4574d094a5
MinGW comes without zlib (necessary for compressed MOV headers).
diego
parents:
12439
diff
changeset
|
717 |
21521 | 718 <para> |
719 Complete instructions for building <application>MPlayer</application> | |
720 and necessary libraries can be found in the | |
25742 | 721 <ulink url="http://www.mplayerhq.hu/MPlayer/contrib/win32/MPlayer-MinGW-Howto.txt">MPlayer MinGW HOWTO</ulink>. |
21521 | 722 </para> |
10561 | 723 </sect2> |
21521 | 724 </sect1> |
10561 | 725 |
726 | |
21521 | 727 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> |
728 | |
9675 | 729 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
730 <sect1 id="macos"> |
11348 | 731 <title>Mac OS</title> |
18839 | 732 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
733 <para> |
17272 | 734 <application>MPlayer</application> does not work on Mac OS versions before |
735 10, but should compile out-of-the-box on Mac OS X 10.2 and up. | |
736 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
|
737 GCC 3.x or later. |
18839 | 738 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
|
739 <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
|
740 If you have Mac OS X 10.3.9 or later and QuickTime 7 |
18839 | 741 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
|
742 </para> |
18839 | 743 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
744 <para> |
18839 | 745 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
|
746 of all the nice features of <application>MPlayer</application>. |
18839 | 747 For instance, in order to have OSD support compiled in, you will |
748 need to have <systemitem class="library">fontconfig</systemitem> | |
749 and <systemitem class="library">freetype</systemitem> libraries | |
750 installed on your machine. Contrary to other Unixes such as most | |
751 Linux and BSD variants, OS X does not have a package system | |
752 that comes with the system. | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
753 </para> |
18839 | 754 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
755 <para> |
18839 | 756 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
|
757 <ulink url="http://fink.sourceforge.net/">Fink</ulink> and |
20401 | 758 <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
|
759 Both of them provide about the same service (i.e. a lot of packages to |
18839 | 760 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
|
761 packages, etc...). |
18839 | 762 Fink offers both precompiled binary packages or building everything from |
20401 | 763 source, whereas MacPorts only offers building from source. |
764 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
|
765 setup was more lightweight. |
20401 | 766 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
|
767 </para> |
18839 | 768 |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
769 <para> |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
770 For instance, to compile <application>MPlayer</application> with OSD support: |
26958 | 771 <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
|
772 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
|
773 managing library compile/link flags. |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
774 <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
|
775 uses it to properly detect libraries. |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
776 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
|
777 similar way: |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
778 <screen>sudo port install fontconfig</screen> |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
779 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
|
780 <systemitem>configure</systemitem> script (note the |
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
781 <systemitem>PKG_CONFIG_PATH</systemitem> and <systemitem>PATH</systemitem> |
18839 | 782 environment variables so that <systemitem>configure</systemitem> finds the |
20401 | 783 libraries installed with MacPorts): |
21521 | 784 <screen> |
785 PKG_CONFIG_PATH=/opt/local/lib/pkgconfig/ PATH=$PATH:/opt/local/bin/ ./configure | |
786 </screen> | |
18838
cf45632eaef6
More information on how to compile MPlayer on OSX with extra features
gpoirier
parents:
18820
diff
changeset
|
787 </para> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
788 |
21521 | 789 <!-- ********** --> |
790 | |
17294 | 791 <sect2 id="osx_gui"> |
792 <title>MPlayer OS X GUI</title> | |
21521 | 793 |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
794 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
795 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
|
796 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
|
797 <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
|
798 warned: that project is not active anymore. |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
799 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
800 |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
801 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
802 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
|
803 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
|
804 Preview releases are available from our |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
805 <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
|
806 and an official release should arrive soon. |
16317 | 807 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
808 |
16317 | 809 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
810 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
|
811 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
|
812 <systemitem>main</systemitem> and a copy of the |
20403 | 813 <systemitem>main</systemitem> SVN module named |
16317 | 814 <systemitem>main_noaltivec</systemitem>. |
815 <systemitem>mplayerosx</systemitem> is the GUI frontend, | |
816 <systemitem>main</systemitem> is MPlayer and | |
817 <systemitem>main_noaltivec</systemitem> is MPlayer built without AltiVec | |
818 support. | |
819 </para> | |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
820 |
16317 | 821 <para> |
19099 | 822 To check out SVN modules use: |
16317 | 823 <screen> |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
824 svn checkout svn://svn.mplayerhq.hu/mplayerosx/trunk/ mplayerosx |
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
825 svn checkout svn://svn.mplayerhq.hu/mplayer/trunk/ main |
16317 | 826 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
827 </para> |
16317 | 828 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
829 <para> |
16317 | 830 In order to build <application>MPlayerOSX</application> you will need to |
831 set up something like this: | |
832 <screen> | |
833 MPlayer_source_directory | |
834 | | |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
835 |--->main (MPlayer Subversion source) |
16317 | 836 | |
18918
58b4379d19b0
Update MPlayerOSX checkout commandlines with subversion commandline
gpoirier
parents:
18839
diff
changeset
|
837 |--->main_noaltivec (MPlayer Subversion source configured with --disable-altivec) |
16317 | 838 | |
21521 | 839 \--->mplayerosx (MPlayer OS X Subversion source) |
16317 | 840 </screen> |
841 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
|
842 </para> |
16317 | 843 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
844 <para> |
22481 | 845 To begin with, in order to ensure maximum backwards compatibility, set an |
846 environment variable: | |
16317 | 847 <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
|
848 </para> |
16317 | 849 |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
850 <para> |
16317 | 851 Then, configure: |
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 If you configure for a G4 or later CPU with AltiVec support, do as follows: |
16317 | 856 <screen> |
22481 | 857 ./configure --disable-gl --disable-x11 |
16317 | 858 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
859 If you configure for a G3-powered machine without AltiVec, use: |
16317 | 860 <screen> |
22481 | 861 ./configure --disable-gl --disable-x11 --disable-altivec |
16317 | 862 </screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
863 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
|
864 <systemitem>-mcpu</systemitem> and <systemitem>-mtune</systemitem> |
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
865 from <systemitem>74XX</systemitem> to <systemitem>G3</systemitem>. |
16317 | 866 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
867 |
16317 | 868 <para> |
869 Continue with | |
21521 | 870 <screen>make</screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
871 then go to the mplayerosx directory and type |
21521 | 872 <screen>make dist</screen> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
873 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
|
874 with the ready to use binary. |
16317 | 875 </para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
876 |
16317 | 877 <para> |
16439
abac160060a8
Mac OS X section reviewed for wording/spelling/grammar and content.
diego
parents:
16317
diff
changeset
|
878 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
|
879 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
|
880 not work anymore. |
11341 | 881 </para> |
17307 | 882 </sect2> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
883 </sect1> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
884 |
21521 | 885 |
886 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> | |
887 | |
888 | |
17294 | 889 <sect1 id="exotic_platforms"> |
890 <title>Exotic Platforms</title> | |
891 | |
892 <para> | |
893 <application>MPlayer</application> runs on a number of exotic platforms, | |
894 but most of the platform-specific changes from those systems have not been | |
895 merged back into the main source tree. | |
896 For build instructions you should refer to the system-specific documentation. | |
897 </para> | |
898 | |
21521 | 899 <!-- ********** --> |
900 | |
17294 | 901 <sect2 id="qnx"> |
902 <title>QNX</title> | |
21521 | 903 |
17294 | 904 <para> |
905 You'll need to download and install SDL for QNX. Then run | |
17496 | 906 <application>MPlayer</application> with <option>-vo sdl:driver=photon</option> |
17294 | 907 and <option>-ao sdl:nto</option> options, it should be fast. |
908 </para> | |
909 | |
910 <para> | |
911 The <option>-vo x11</option> output will be even slower than on Linux, | |
912 since QNX has only X <emphasis>emulation</emphasis> which is very slow. | |
913 </para> | |
914 </sect2> | |
915 | |
21521 | 916 <!-- ********** --> |
917 | |
17294 | 918 <sect2 id="amiga"> |
11607 | 919 <title>Amiga/MorphOS (GeekGadgets)</title> |
920 <para> | |
21521 | 921 The people over at |
922 <ulink url="http://www.amigasoft.net">www.amigasoft.net</ulink> | |
16121 | 923 make current <application>MPlayer</application> and |
924 <application>MEncoder</application> packages. | |
925 </para> | |
926 | |
927 <para> | |
11607 | 928 Nicholas Det at Genesi has done a big and powerful port of <application>MPlayer |
929 </application> for MorphOS. Sadly it's based on the 0.90 series. | |
930 </para> | |
931 | |
932 <para> | |
933 Get if from <ulink url="http://www.morphzone.org/">MorphZone</ulink>: | |
11621 | 934 <itemizedlist> |
935 <listitem><para> | |
21521 | 936 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=90"> |
937 <application>MPlayer</application> 0.91 binary</ulink> | |
11621 | 938 </para></listitem> |
939 <listitem><para> | |
21521 | 940 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=91"> |
941 <application>MPlayer</application> 0.91 source</ulink> | |
11621 | 942 </para></listitem> |
943 <listitem><para> | |
21521 | 944 <ulink url="http://www.morphzone.org/modules/mydownloads/singlefile.php?lid=92"> |
945 <application>MEncoder</application> 1.0pre3 binary</ulink> | |
11621 | 946 </para></listitem> |
947 </itemizedlist> | |
11607 | 948 </para> |
17294 | 949 </sect2> |
11607 | 950 </sect1> |
951 | |
9675 | 952 </chapter> |