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