comparison DOCS/documentation.html @ 7942:b582c6fb0053

Unified BSD sections, expanded Cygwin section, small fixes.
author diego
date Mon, 28 Oct 2002 00:44:17 +0000
parents 988498df1996
children 26ddd166422e
comparison
equal deleted inserted replaced
7941:0c8d85e22ff5 7942:b582c6fb0053
66 </LI> 66 </LI>
67 <LI><A HREF="formats.html#audio_formats">2.1.2 Audio formats</A> 67 <LI><A HREF="formats.html#audio_formats">2.1.2 Audio formats</A>
68 <UL> 68 <UL>
69 <LI><A HREF="formats.html#mp3">2.1.2.1 MP3 files</A></LI> 69 <LI><A HREF="formats.html#mp3">2.1.2.1 MP3 files</A></LI>
70 <LI><A HREF="formats.html#wav">2.1.2.2 WAV files</A></LI> 70 <LI><A HREF="formats.html#wav">2.1.2.2 WAV files</A></LI>
71 <LI><A HREF="formats.html#ogg_vorbis">2.1.2.3 OGG files (Vorbis)</A></LI> 71 <LI><A HREF="formats.html#ogg_vorbis">2.1.2.3 OGG/OGM files (Vorbis)</A></LI>
72 <LI><A HREF="formats.html#wma">2.1.2.4 WMA/ASF files</A></LI> 72 <LI><A HREF="formats.html#wma">2.1.2.4 WMA/ASF files</A></LI>
73 <LI><A HREF="formats.html#mp4">2.1.2.5 MP4 files</A></LI> 73 <LI><A HREF="formats.html#mp4">2.1.2.5 MP4 files</A></LI>
74 </UL> 74 </UL>
75 </LI> 75 </LI>
76 </UL> 76 </UL>
240 </UL> 240 </UL>
241 </LI> 241 </LI>
242 <LI><A HREF="#ports">6. Ports</A> 242 <LI><A HREF="#ports">6. Ports</A>
243 <UL> 243 <UL>
244 <LI><A HREF="#debian">6.1 Debian packaging</A></LI> 244 <LI><A HREF="#debian">6.1 Debian packaging</A></LI>
245 <LI><A HREF="#freebsd">6.2 FreeBSD</A></LI> 245 <LI><A HREF="#bsd">6.2 *BSD</A></LI>
246 <UL>
247 <LI><A HREF="#freebsd">6.2.1 FreeBSD</A></LI>
248 <LI><A HREF="#openbsd">6.2.2 OpenBSD</A></LI>
249 </UL>
246 <LI><A HREF="#solaris">6.3 Solaris</A></LI> 250 <LI><A HREF="#solaris">6.3 Solaris</A></LI>
247 <LI><A HREF="#strongarm">6.4 StrongARM</A></LI> 251 <LI><A HREF="#strongarm">6.4 StrongARM</A></LI>
248 <LI><A HREF="#sgi">6.5 Silicon Graphics / Irix</A></LI> 252 <LI><A HREF="#sgi">6.5 Silicon Graphics / Irix</A></LI>
249 <LI><A HREF="#qnx">6.6 QNX</A></LI> 253 <LI><A HREF="#qnx">6.6 QNX</A></LI>
250 <LI><A HREF="#openbsd">6.7 OpenBSD</A></LI> 254 <LI><A HREF="#cygwin">6.7 Cygwin</A></LI>
251 <LI><A HREF="#cygwin">6.8 Cygwin</A></LI>
252 </UL> 255 </UL>
253 </LI> 256 </LI>
254 <LI><A HREF="#mailing_lists">Appendix A - Mailing lists</A></LI> 257 <LI><A HREF="#mailing_lists">Appendix A - Mailing lists</A></LI>
255 <LI><A HREF="bugreports.html">Appendix B - How to report bugs</A> 258 <LI><A HREF="bugreports.html">Appendix B - How to report bugs</A>
256 <UL> 259 <UL>
839 programs.<BR> 842 programs.<BR>
840 Some URLs: 843 Some URLs:
841 <UL> 844 <UL>
842 <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/">ftp://ftp.mplayerhq.hu/MPlayer/releases/</A> - ISO fonts</LI> 845 <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/">ftp://ftp.mplayerhq.hu/MPlayer/releases/</A> - ISO fonts</LI>
843 <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/">ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/</A> - various fonts by users</LI> 846 <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/">ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/</A> - various fonts by users</LI>
844 <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - Korean fonts &amp; RAW plugin</LI> 847 <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer/">http://realtime.ssu.ac.kr/~lethean/mplayer/</A> - Korean fonts &amp; RAW plugin</LI>
845 </UL> 848 </UL>
846 </LI> 849 </LI>
847 <LI>use the font generator tool at TOOLS/subfont-c 850 <LI>use the font generator tool at TOOLS/subfont-c
848 It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg. 851 It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg.
849 (read TOOLS/subfont-c/README for details)</LI> 852 (read TOOLS/subfont-c/README for details)</LI>
1178 everything went fine, MPlayer will print a message like "Setting up 1181 everything went fine, MPlayer will print a message like "Setting up
1179 lirc support..." on startup. If an error occurs it will tell you. If it 1182 lirc support..." on startup. If an error occurs it will tell you. If it
1180 doesn't tell you anything about LIRC there's no support compiled in. That's 1183 doesn't tell you anything about LIRC there's no support compiled in. That's
1181 it :-)</P> 1184 it :-)</P>
1182 1185
1183 <P>The application name for MPlayer is - oh wonder - 'mplayer'. 1186 <P>The application name for MPlayer is - oh wonder - <CODE>mplayer</CODE>.
1184 You can use any mplayer commands and even pass more than one command by 1187 You can use any mplayer commands and even pass more than one command by
1185 separating them with \n. Don't forget to enable the repeat flag in .lircrc 1188 separating them with \n. Don't forget to enable the repeat flag in .lircrc
1186 when it make sense (seek, volume, etc). Here's an excerpt from my 1189 when it make sense (seek, volume, etc). Here's an excerpt from my
1187 .lircrc:</P> 1190 .lircrc:</P>
1188 1191
1287 Unpacking replacement mplayer ... 1290 Unpacking replacement mplayer ...
1288 Setting up mplayer (0.90-1) ... 1291 Setting up mplayer (0.90-1) ...
1289 </PRE> 1292 </PRE>
1290 1293
1291 1294
1292 <H2><A NAME="freebsd">6.2 FreeBSD</A></H2> 1295 <H2><A NAME="bsd">6.2 *BSD</A></H2>
1293 1296
1294 <P>To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), 1297 <P>Mplayer runs on FreeBSD, OpenBSD, NetBSD, BSD/OS and Darwin. To build MPlayer
1295 native BSD make will not work.</P> 1298 you will need GNU make (gmake - native BSD make will not work) and a recent
1296 1299 version of binutils.</P>
1297 <P>To run MPlayer you will need to re-compile the kernel with 1300
1298 "options USER_LDT" (unless you are running -CURRENT, where this is default). 1301 <P>If MPlayer complains about not finding <CODE>/dev/cdrom</CODE> or
1299 If you have a CPU with SSE also use "options CPU_ENABLE_SSE" to use it 1302 <CODE>/dev/dvd</CODE>, create an appropiate symbolic link:<BR>
1300 (FreeBSD-STABLE required, or use kernel patches).</P> 1303 <CODE>ln -s /dev/(your_cdrom_device) /dev/cdrom</CODE>.</P>
1301 1304
1302 <P>If MPlayer complains about "CD-ROM Device '/dev/cdrom' not found!" make a 1305 <P>To use Win32 DLLs with MPlayer you will need to re-compile the kernel with
1303 symbolic link: <CODE>ln -s /dev/(your_cdrom_device) /dev/cdrom</CODE></P> 1306 "<CODE>option USER_LDT</CODE>" (unless you run FreeBSD -CURRENT, where this
1304 1307 is the default).</P>
1305 <P>There's no DVD support for FreeBSD yet.</P> 1308
1309 <H3><A NAME="freebsd">6.2.1 FreeBSD</A></H3>
1310
1311 <P>If your CPU has SSE, recompile your kernel with "options CPU_ENABLE_SSE" to
1312 use it (FreeBSD-STABLE or kernel patches required).</P>
1313
1314 <H3><A NAME="openbsd">6.2.2 OpenBSD</A></H3>
1315
1316 <P>Due to limitations in different versions of gas (relocation vs MMX), you will
1317 need to compile in two steps: First make sure that the non-native as is first
1318 in your <CODE>$PATH</CODE> and do a <CODE>gmake -k</CODE>, then make sure that
1319 the native version is used and do <CODE>gmake</CODE>.</P>
1306 1320
1307 1321
1308 <H2><A NAME="solaris">6.3 Solaris</A></H2> 1322 <H2><A NAME="solaris">6.3 Solaris</A></H2>
1309 1323
1310 <P>MPlayer should work on Solaris 2.6 or newer.</P> 1324 <P>MPlayer should work on Solaris 2.6 or newer.</P>
1424 1438
1425 <P>The <CODE>-vo x11</CODE> output will be even slower than on Linux, since 1439 <P>The <CODE>-vo x11</CODE> output will be even slower than on Linux, since
1426 QNX has only X <I>emulation</I> which is VERY slow. Use SDL.</P> 1440 QNX has only X <I>emulation</I> which is VERY slow. Use SDL.</P>
1427 1441
1428 1442
1429 <H2><A NAME="openbsd">6.7 OpenBSD</A></H2> 1443 <H2><A NAME="cygwin">6.7 Cygwin</A></H2>
1430 1444
1431 <P>To build the package you will need GNU make (gmake, 1445 <P>The Cygwin port is still in its infancy and could use some love,
1432 /usr/ports/devel/gmake), native BSD make will not work, and a recent 1446 <A HREF="tech/patches.txt">patches</A> are always welcome. You should also
1433 binutils (including objcopy).</P> 1447 check out the
1434 1448 <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">mplayer-cygwin</A>
1435 <P>Due to limitations in different versions of gas (relocation vs mmx), you'll 1449 mailing list for help and latest information.</P>
1436 need to compile in two steps: First make sure that the non-native as is first 1450
1437 in PATH and do a '<CODE>gmake -k</CODE>', then make sure that the native 1451 <P>To get native DirectX video (<CODE>-vo directx</CODE>), install
1438 version is used and do '<CODE>gmake</CODE>'.</P> 1452 <A HREF="http://www.videolan.org/vlc/dx7headers.tgz">DirectX 7 header files</A>
1439 1453 and recompile. This, together with <CODE>-ao win32</CODE> should give you best
1440 <P>To use Win32 DLLs with MPlayer you will need to re-compile the 1454 results.</P>
1441 kernel with "<CODE>option USER_LDT</CODE>".</P> 1455
1442
1443 <P>If MPlayer complains about not finding '/dev/cdrom' or
1444 '/dev/dvd' make a symbolic link, e.g. <CODE>ln -s
1445 /dev/rcd0c /dev/dvd</CODE></P>
1446
1447 <P>The not so hardcore hackers amongst us might want to use the ports
1448 version (/usr/ports/x11/mplayer).</P>
1449
1450
1451 <H2><A NAME="cygwin">6.8. Cygwin</A></H2>
1452
1453 <P>You will have to go to the MPlayer directory, and copy or symlink 1456 <P>You will have to go to the MPlayer directory, and copy or symlink
1454 <CODE>etc/cygwin_inttypes.h</CODE> to <CODE>/usr/include/inttypes.h</CODE> to 1457 <CODE>etc/cygwin_inttypes.h</CODE> to <CODE>/usr/include/inttypes.h</CODE> to
1455 make MPlayer compile. Otherwise it will complain about missing 1458 make MPlayer compile. Otherwise it will complain about missing
1456 <CODE>intypes.h</CODE>.</P> 1459 <CODE>intypes.h</CODE>.</P>
1460
1461 <P>Since there is no support for Win32 DLLs under Cygwin and OpenGL and mpdvdkit
1462 do not work/compile, you should disable them in configure with
1463 <CODE>./configure --disable-win32 --disable-gl --disable-mpdvdkit</CODE>.</P>
1464
1465 <P>SDL has also been reported to work after some tweaking:<BR>
1466 There are several changes that need to be made to the <CODE>config.mak</CODE>
1467 file after running <CODE>configure</CODE>. These changes, like any change to
1468 <CODE>config.mak</CODE> after the <CODE>configure</CODE> run are <B>not</B>
1469 supported, so please do <B>not</B> report bugs!</P>
1470
1471 <P>Find the line that reads</P>
1472
1473 <PRE>
1474 SDL_LIB = -L/usr/local/lib -lmingw32 -lSDLmain -lSDL -mwindows -mno-cygwin
1475 </PRE>
1476
1477 <P>and change it to:</P>
1478
1479 <PRE>
1480 SDL_LIB = -L/usr/local/lib -lSDL -mcygwin
1481 </PRE>
1482
1483 <P>and replace</P>
1484
1485 <PRE>
1486 SDL_INC = -I/usr/local/include -I/usr/local/include/SDL -Dmain=SDL_main -I/usr/include/mingw -DWIN32 -Uunix -mno-cygwin
1487 </PRE>
1488
1489 <P>with</P>
1490
1491 <PRE>
1492 SDL_INC = -I/usr/local/include -I/usr/local/include/SDL -Uunix -mcygwin
1493 </PRE>
1457 1494
1458 1495
1459 1496
1460 <H1><A NAME="mailing_lists">Appendix A - Mailing lists</A></H1> 1497 <H1><A NAME="mailing_lists">Appendix A - Mailing lists</A></H1>
1461 1498