# HG changeset patch # User gabucino # Date 995795245 0 # Node ID c9b83337ffa7d9b5046d6a2dc625957ae9407d77 # Parent 0a6f678ca5f0300a7fd652d12577fee6a04db292 dvdfaq added (not yet formatted) diff -r 0a6f678ca5f0 -r c9b83337ffa7 DOCS/documentation.html --- a/DOCS/documentation.html Sun Jul 22 09:46:54 2001 +0000 +++ b/DOCS/documentation.html Sun Jul 22 09:47:25 2001 +0000 @@ -125,7 +125,7 @@ 1.1. Overview - MPlayer is a movie player for LINUX. It plays most MPEG, AVI and ASF files, + MPlayer is a movie player for LINUX. It plays most MPEG, AVI and ASF files, supported by many native and Win32 DLL codecs. You can watch VCD, DVD and even DivX movies too. The another big feature of mplayer is the wide range of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, @@ -166,19 +166,19 @@ Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse. It's great, optimized very fast C code with perfect image quality and 100% MPEG standard conformance. - - MPlayer v0.3-v0.9: + - MPlayer v0.3-v0.9: It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI player 'avip' based on avifile's Win32 DLL loader. - - MPlayer v0.10: + - MPlayer v0.10: The MPEG and AVI player in a single binary! - - MPlayer v0.11: + - MPlayer v0.11: Some new developers joined and from 0.11 the mplayer project is a team-work! Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding. - - MPlayer v0.17 "The IdegCounter" + - MPlayer v0.17 "The IdegCounter" The release version of the 0.11pre after 4 months of heavy development! Try it, and be amazed! Thousands of new features added... and of course old code was improved too, bugs removed etc. - - MPlayer 0.18 "The BugCounter" + - MPlayer 0.18 "The BugCounter" 2 months since 0.17 and here's a new release.. Completed ASF support, more subtitle formats, introduced libao (similar to libvo but to audio), even more stable than ever, and so on. It's a MUST ! @@ -186,7 +186,7 @@ 1.3. Installation - If you plan to use MPlayer on x86 architecture, you possibly want to use + If you plan to use MPlayer on x86 architecture, you possibly want to use Win32 codecs. Download and unzip w32codecs.zip to /usr/lib/win32 . Note: the avifile project has similar codecs package, but it differs from our, so if you want to use all supported codecs, then use @@ -194,10 +194,10 @@ If you own a Matrox G200/G400/G450 card, then please see the 2.2.1.6 section in order to gain big speedup. It is important to do these steps - _before_ compiling MPlayer, otherwise no Matrox-specific support will be + _before_ compiling MPlayer, otherwise no Matrox-specific support will be built. - Then build MPlayer: + Then build MPlayer: ./configure @@ -239,7 +239,7 @@ 2.1.1. Supported input formats - MPlayer can read/play from the following devices/formats: + MPlayer can read/play from the following devices/formats: - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file - DVD, directly from your DVD disk, using optional libcss for decryption - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file @@ -278,7 +278,7 @@ This section contains information about the DivX/OpenDivX codecs of ProjectMayo. Their first available alpha version was the OpenDivX 4.0 - alpha 47 and 48. Support for this was/is included in MPlayer, and built by + alpha 47 and 48. Support for this was/is included in MPlayer, and built by default. We even used its postprocessing code to optionally enhance visual quality of MPEG1/2 movies. @@ -304,7 +304,7 @@ cp decore.h /usr/local/include/ - At the moment MPlayer doesn't contain autodetection for the codec, so you'll + At the moment MPlayer doesn't contain autodetection for the codec, so you'll have to edit config.h and config.mak manually. But first run ./configure . Change #undef NEW_DECORE to #define NEW_DECORE in config.h Change #define MPEG12_POSTPROC to #undef MPEG12_POSTPROC in config.h @@ -314,7 +314,7 @@ DECORE_LIBS=-L/usr/local/lib -ldivxdecore - Continue compiling MPlayer as usual. + Continue compiling MPlayer as usual. Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX @@ -326,7 +326,7 @@ -vc odivx : using divx4 codec as a new version of OpenDivX. in this case it produces YV12 image in its own buffer, - and MPlayer (libvo) does colorspace conversion. + and MPlayer (libvo) does colorspace conversion. -vc divx4 : using divx4 codec's colorspace conversion. in this mode, you can use YUY2/UYVY too. @@ -349,7 +349,7 @@ 2.1.2.2. ffmpeg's DivX/libavcodec Beginning with version 0.4.2 , ffmpeg contains an opensource DivX codec, - which is compatible with the traditional DivX. MPlayer supports this codec, + which is compatible with the traditional DivX. MPlayer supports this codec, and this makes it possible to watch DivX movies on non-x86 platforms! To get it compile, you'll need nasm, bison, and flex, above the other devel tools. No manual hacking is needed to build it, ./configure detects @@ -370,7 +370,7 @@ VfW (Video for Windows) is the old Video API for Windows. Its codecs have the .DLL or (rarely) .DRV extension. - If MPlayer fails with your AVI: + If MPlayer fails with your AVI: UNKNOWN video codec: HFYU (0x55594648) @@ -395,7 +395,7 @@ This is the MP3 codec. So, now we have all the info needed (fourcc, codec file, sample AVI), submit your codec support request in mail, and upload these files to the FTP: - ftp://thot.banki.hu/MPlayer/incoming// + ftp://mplayerhq.hu/MPlayer/incoming// 2.1.4.2. DirectShow codecs @@ -428,7 +428,7 @@ So, now we have all the info needed (fourcc, GUID, codec file, sample AVI), submit your codec support request in mail, and upload these files to the FTP: - ftp://thot.banki.hu/MPlayer/incoming// + ftp://mplayerhq.hu/MPlayer/incoming// 2.2. Video & Audio output devices @@ -520,9 +520,9 @@ It must support YUY2 packed, and YV12 planar pixel formats to be - usable with MPlayer. - - - And finally, check if MPlayer was compiled with 'xv' support. + usable with MPlayer. + + - And finally, check if MPlayer was compiled with 'xv' support. ./configure prints this. @@ -592,7 +592,7 @@ driver that controls this chip. So it does not work on every system ... -2.2.1.2.3. Installing DGA support for MPlayer +2.2.1.2.3. Installing DGA support for MPlayer First make sure X loads the DGA extension, see in /var/log/XFree86.0.log : @@ -601,7 +601,7 @@ See, XFree86 4.0.x or greater is VERY RECOMMENDED! - MPlayer's DGA driver is autodetected on ./configure, or you can force it + MPlayer's DGA driver is autodetected on ./configure, or you can force it with --enable-dga. If the driver couldn't switch to a smaller resolution, experiment with @@ -609,7 +609,7 @@ the movie fits in. There is no converter right now.. :( Become ROOT. DGA needs root access to be able to write directly video memory. - If you want to run it as user, then install MPlayer SUID root: + If you want to run it as user, then install MPlayer SUID root: chown root /usr/local/bin/mplayer @@ -648,12 +648,12 @@ See appendix A for some sample modeline definitions. - 2.2.1.2.5. DGA & MPlayer - - DGA is used in two places with MPlayer: The SDL driver can be made to make + 2.2.1.2.5. DGA & MPlayer + + DGA is used in two places with MPlayer: The SDL driver can be made to make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above said is true for both; in the following sections I'll explain - how the DGA driver for MPlayer works. + how the DGA driver for MPlayer works. 2.2.1.2.6. Features of the DGA driver @@ -779,7 +779,7 @@ 2.2.1.3. SDL - Here are some notes about SDL out in MPlayer. + Here are some notes about SDL out in MPlayer. There are several commandline switches for SDL: @@ -808,7 +808,7 @@ SLOOOW now, unless you have a real fast CPU (and/or MTRR?). :( Of course you'll have to install svgalib and its development package in - order for MPlayer build its SVGAlib driver (autodetected, but can be + order for MPlayer build its SVGAlib driver (autodetected, but can be forced), and don't forget to edit /etc/vga/libvga.config to suit your card & monitor. @@ -827,7 +827,7 @@ NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer, - and don't ask for it, since it's not an MPlayer limitation. + and don't ask for it, since it's not an MPlayer limitation. 2.2.1.6. Matrox framebuffer (mga_vid) @@ -877,13 +877,13 @@ depmod -a - Now you have to (re)compile MPlayer, ./configure will detect /dev/mga_vid - and build the 'mga' driver. Using it from MPlayer goes by '-vo mga' if + Now you have to (re)compile MPlayer, ./configure will detect /dev/mga_vid + and build the 'mga' driver. Using it from MPlayer goes by '-vo mga' if you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x . Note: '-vo xmga' works under XFree86 4.x.x, but it conflicts with the Xv driver, so avoid using both. If you messed up Xv with mga, try running - MPlayer with '-vo mga' . It should fix Xv. + MPlayer with '-vo mga' . It should fix Xv. 2.2.1.7. SiS 6326 framebuffer (sis_vid) @@ -899,13 +899,13 @@ 3dfx has native YUV+scaler support, using /dev/3dfx (tdfx.o driver?) The /dev/3dfx kernel driver exists only for 2.2.x kernels, for use with - Glide 2.x Linux ports. It's not tested with MPlayer, and so no more + Glide 2.x Linux ports. It's not tested with MPlayer, and so no more supported. Volunteers needed to test it and bring the code up-to-date. 2.2.1.9. OpenGL output - MPlayer support displaying movies using OpenGL. Unfortunately, not all + MPlayer support displaying movies using OpenGL. Unfortunately, not all drivers support this ability. For example the Utah-GLX drivers (for XFree86 3.3.6) have it, with all cards. See http://utah-glx.sourceforge.net for details about how to install it. @@ -957,15 +957,15 @@ an (almost) arbitrary remote control and control your linux box with it! More about it at www.lirc.org. - If you have installed the lirc-package, you can compile MPlayer with LIRC + If you have installed the lirc-package, you can compile MPlayer with LIRC support using ./configure --enable-lirc - If everything went fine, MPlayer will print a message like + If everything went fine, MPlayer will print a message like LIRC init was successful. on startup. If an error occurs it will tell you. If it doens't tell you anything about LIRC there's no support compiled in. That's it :-) - The application name for MPlayer is - oh wonder - mplayer_lirc. + The application name for MPlayer is - oh wonder - mplayer_lirc. It understands the following commands: PAUSE - pause playing. Any other keystroke will continue replay. @@ -1003,15 +1003,15 @@ 3.3. Streaming from network or pipes - MPlayer can play media from network, by using the HTTP protocol, and even + MPlayer can play media from network, by using the HTTP protocol, and even beta ASF streaming (FROM network) is available. - Configuring it is simple, just recompile MPlayer with + Configuring it is simple, just recompile MPlayer with ./configure --enable-streaming - MPlayer can read from stdin (NOT named pipes). This can be for example + MPlayer can read from stdin (NOT named pipes). This can be for example used to play from FTP : @@ -1145,10 +1145,10 @@ This means current DVD functions are mainly for developers and not for users! First, you must compile and install libcss on your system. - Second, you have to recompile MPlayer with libcss support. There is + Second, you have to recompile MPlayer with libcss support. There is autodetection of libcss, but if it fails, see below : - Call ./configure script of MPlayer with these options: + Call ./configure script of MPlayer with these options: ./configure --enable-css --with-csslibdir=/usr/local/lib --with-cssincdir=/usr/local/include @@ -1165,16 +1165,16 @@ where, - '-dvdauth /dev/dvd' tells MPlayer the device name of your DVD drive. + '-dvdauth /dev/dvd' tells MPlayer the device name of your DVD drive. it's used in disc authentication process the filename is simply a VOB file path on the disc Note that according to my experiences, disc authentication requires root - privileges so you must run MPlayer as root! (see section 'Problems'). + privileges so you must run MPlayer as root! (see section 'Problems'). NOTE about the sound: - It seems that MPlayer sometimes fails to find the first audio stream. + It seems that MPlayer sometimes fails to find the first audio stream. You can specify it with the '-aid 128' option, for example. Please experience with 128,129 and similar values. See section 'Problems'. @@ -1202,7 +1202,7 @@ * disc authentication (the FIBMAP ioctl) requires root privilegies. this is strange since OMS can do it as user too. - * sound. I'm using my only DVD disc (The Matrix) to test MPlayer. + * sound. I'm using my only DVD disc (The Matrix) to test MPlayer. some VOB file have English sound, some have Spanish and some have no sound at all. IT SEEMS that if I give '-aid 128' everything works with English sound ... @@ -1286,7 +1286,7 @@ 6. FAQ section (TODO) -Yes, this is the MPlayer FAQ. +Yes, this is the MPlayer FAQ. ============================= About: @@ -1312,7 +1312,7 @@ "-L/usr/local/lib " after "X_LIBS=" Now type make. You're done! Q: It doesn't compile, and it misses uint64_t inttypes.h and similar things... -A: copy DOCS/inttypes.h to MPlayer directory (cp DOCS/inttypes.h .) +A: copy DOCS/inttypes.h to MPlayer directory (cp DOCS/inttypes.h .) try again... if fail, contact us Q: I have Pentium III but ./configure doesn't detect SSE @@ -1367,12 +1367,12 @@ A: Download & install w32codec.zip from *our* FTP (avifile's codec package has different DLL set) -Q: ...... works with avifile/aviplay while doesn't with MPlayer -A: MPlayer != avifile +Q: ...... works with avifile/aviplay while doesn't with MPlayer +A: MPlayer != avifile The only common thing between these players is the Win32 DLL loader. The codecs (dll) sets, syncronization, demultiplexing etc is totaly different and shouldn't be compared. - If something works with aviplay it doesn't mean that MPlayer should do + If something works with aviplay it doesn't mean that MPlayer should do it and vice versa. Q: Indeo 3.x/4.x movies are viewed upside-down!!!? @@ -1382,26 +1382,26 @@ Q: Indeo 3.x,4.x video doesn't work at 32bpp resolutions (16,24 bpp are ok) A: It's a known bug (really it's a bug/limitation of the DLL codec) -Q: I've got 'MPlayer interrupted by signal 11' in module audio_setup or +Q: I've got 'MPlayer interrupted by signal 11' in module audio_setup or decode_audio. A: This is highly unlikely, since the mp3lib rewrite. Contact us, it may be a bug. Possibly it's a damaged file, try with -afm 4 . -Q: Are there rpm/deb/... packages of MPlayer? +Q: Are there rpm/deb/... packages of MPlayer? A: You can make a .deb package for yourself, check DOCS/DEBIAN . It's _STRONGLY_ discouraged to use precompiled packages - of MPlayer, since it (currently) _highly_ depends on compile-time + of MPlayer, since it (currently) _highly_ depends on compile-time options and optimizations! - Precompiled packages are COMPLETELY unsupported by the MPlayer team! - -Q: Are there any mailing lists on MPlayer? + Precompiled packages are COMPLETELY unsupported by the MPlayer team! + +Q: Are there any mailing lists on MPlayer? A: Yes! See README on how to subscribe them! Q: I've found a nasty bug when I tried to play my favourite video!! Who should I inform? A: See DOCS/BUGREPORTS -Q: During 'make', MPlayer complains about X11 libraries. I don't understand, +Q: During 'make', MPlayer complains about X11 libraries. I don't understand, I DO have X installed!? A: ...but you don't have the X development package installed. Or not correctly. It's called XFree86-devel* under RedHat, and xlib6g-dev* under @@ -1474,7 +1474,7 @@ Q: LIRC doesn't work, because ... A: Are you sure you use "mplayer_lirc" instead of "mplayer" ? -Q: MPlayer exits with something error when using l3codeca.acm +Q: MPlayer exits with something error when using l3codeca.acm A: Check 'ldd /usr/local/bin/mplayer' output. If it contains libc.so.6 => /lib/libc.so.6 (0x4???????) where "?" is any number then it's ok, the error is not here. If it is: @@ -1484,16 +1484,16 @@ forces loading libraries to very low addresses. Because l3codeca.acm is a non-relocatable DLL, it must be loaded to 0x00400000, we can't change this. You should use non-patched kernel, - or use MPlayer's -afm 1 option to disable using l3codeca.acm. + or use MPlayer's -afm 1 option to disable using l3codeca.acm. Q: My computer plays M$ DivX AVIs with resolutions ~ 640x300 and stereo mp3 sound too slow. When I use -nosound switch, everything is ok (but quiet). A: Those files probably have 48Khz audio, and your soundcard/driver can't play - it correctly. Audio downsampling isn't implemented in MPlayer (yet). - -Q: MPlayer dies with "MPlayer interrupted by signal 4 in module: decode_video". -A: Try running MPlayer on the machine you compiled on. Or recompile. Don't - use MPlayer on different CPU than it was compiled on. + it correctly. Audio downsampling isn't implemented in MPlayer (yet). + +Q: MPlayer dies with "MPlayer interrupted by signal 4 in module: decode_video". +A: Try running MPlayer on the machine you compiled on. Or recompile. Don't + use MPlayer on different CPU than it was compiled on. Q: I have problems with and fullscreen xv/xmga/sdl/x11 modes.. @@ -1526,8 +1526,8 @@ Q: What's the problem with gcc 2.96 ? A: gcc 2.96 is RedHat's UNOFFICIAL (it can be found only on RedHat sites, or RedHat distributions) and BUGGY gcc release. gcc 2.96 is TOTALLY - unsupported by MPlayer, because it simply SKIPS MMX codes, it just does not - compile it. Important: this is NOT an MPlayer-specific problem, numerous + unsupported by MPlayer, because it simply SKIPS MMX codes, it just does not + compile it. Important: this is NOT an MPlayer-specific problem, numerous other projects (DRI, avifile, etc..) have problems with this shit too. ** DO NOT USE gcc 2.96 !!! ** @@ -1556,6 +1556,51 @@ has a C compiler. Kinda great stuff, isn't it? + 6.10. DVD FAQ + +Q: I have some problem not mentioned here ... +A: Read file 'DVD' as well. + +Q: How can I actually watch DVD with MPlayer? +A: Ehh. Go on reading this file as well as 'DVD' (hint: you must have libcss) + +Q: So MPlayer can play DVDs? Then it must use DeCSS! You are under arrest + under the XYZ#$ paragraph of the-- +A: Get back asshole, there is no DeCSS code in MPlayer. It links to libcss. + +Q: Seems to work but no sound. +A: Use '-aid 128' (or try: 128,129,...) command line switch + +Q: I have got Spanish audio instead of English (or similar problems) +A: See the last question/answer. + +Q: MPlayer complains about FIBMAP or something. +A: Try to run MPlayer as root. + +Q: some strange effect (interlace like thing) especially when fast moving + objects are shown in the movie +A: known problem, we try to fix it later + +Q: DVD support in MPlayer is a piece of shit! +A: You're probably right :) However please contact us if you can improve it! + +Q: Where can I get libcss package from? +A: Maybe from the source of OMS (www.linuxvideo.org). + +Q: How can I ... (insert some expectable DVD player feature here) +A: The current implementation is only for viewing VOB files from DVD. + Nothing more, like subtitles, menus and so on. + +Q: How can I set the region code of my DVD-Drive ? I don't have windows! +A: Use the 'regionset' tool : + http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz + +Q: MPlayer complains about some renamed option? +A: For future development, old '-dvd' option was replaced by '-dvdauth'. + Option '-dvd' *WILL* do the 'full disk movie' mplaying mode. + But until that, '-dvd' does nothing only prints error message. + + 7. Misc OS'es @@ -1593,10 +1638,10 @@ To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), native BSD make will not work. - To run MPlayer you will need to re-compile the kernel with + To run MPlayer you will need to re-compile the kernel with "options USER_LDT" (unless you are running -CURRENT, where this is default). - If MPlayer complains about "CD-ROM Device '/dev/cdrom' not found!" make a + If MPlayer complains about "CD-ROM Device '/dev/cdrom' not found!" make a symbolic link : ln -s /dev/ /dev/cdrom There's no DVD support for FreeBSD yet. @@ -1682,7 +1727,7 @@ NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors! ===== Read DOCS/BUGREPORTS and subscribe to mplayer-users mailing lists. -========================== The MPlayer project: =============================== +========================== The MPlayer project: =============================== Árpád Gereöffy (A'rpi/ESP-team): - player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...) @@ -1720,7 +1765,7 @@ - second webpage design&gfx - webpage maintainer - testing, codecs quality & speed comparsions -- IRC channel #MPlayer operator +- IRC channel #MPlayer operator - experimental MINIX port Szabolcs Berecz (Szabi): @@ -1786,12 +1831,12 @@ - prelimenary support for .RT subtitle format Jürgen Keil and Marcus Comstedt: -- patched MPlayer to work on Solaris 8 x86 +- patched MPlayer to work on Solaris 8 x86 - configure fixes - SUN audio driver in libao2 Vladimir Kushnir: -- patched MPlayer to work on FreeBSD x86 +- patched MPlayer to work on FreeBSD x86 Bertrand BAUDET: - network streaming support @@ -1850,17 +1895,17 @@ Appendix B - Mailing lists -There are some public mailing lists on MPlayer. Subscribing can be achieved on +There are some public mailing lists on MPlayer. Subscribing can be achieved on the following addresses: -- MPlayer core/hungarian developers list: +- MPlayer core/hungarian developers list: http://mp.dev.hu/mailman/listinfo/mplayer-devel I dunno, it is the FLAME list in hungarian language :) Also some talking about mplayer core team internals, like mplayer party, sponsors etc can be here. -- MPlayer developers list: +- MPlayer developers list: http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng This list is about mplayer development! Talking about interface/API changes, @@ -1868,14 +1913,14 @@ Do NOT send bugreports, user questions, feature requests here! This list should be kept low-traffic. -- MPlayer users list: +- MPlayer users list: http://lists.sourceforge.net/lists/listinfo/mplayer-users - send bugreports here (after reading DOCS/BUGS, BUGREPORTS) - send feature requests here (after reading DOCS/TODO) - send user questions here (after reading DOCS/README, INSTALL, FAQ etc) -- MPlayer & Matrox G200/G400/G450 users: +- MPlayer & Matrox G200/G400/G450 users: http://lists.sourceforge.net/lists/listinfo/mplayer-matrox Send matrox-related questions here, @@ -1890,14 +1935,14 @@ (IRIX, Solaris-SPARC, Alpha, Commodore64, Sharp Calculator, Teapot etc...) -- MPlayer announce: +- MPlayer announce: http://lists.sourceforge.net/lists/listinfo/mplayer-announce Very low traffic list :) And it's read-only. I'll post something shit there if a new release is done. -- MPlayer CVS-log: +- MPlayer CVS-log: http://mp.dev.hu/mailman/listinfo/mplayer-cvslog Send only questions about CVS changes here. @@ -1990,7 +2035,7 @@ 4. If the problem is specific to one or a few files, then please upload that file to: - ftp://thot.banki.hu/MPlayer/incoming/ + ftp://mplayerhq.hu/MPlayer/incoming/ Usually first 1-5 MB of the file is enough to reproduce the problem, but first you should try it: dd if=yourfile of=smallfile bs=1k count=1024 @@ -2023,7 +2068,7 @@ Then simply execute following command line: gdb mplayer --core=core -batch --command=command_file >mplayer.bug -5.b.: run MPlayer in gdb: +5.b.: run MPlayer in gdb: [at root/user shell prompt:] # gdb mplayer [at gdb prompt:]