diff options
author | diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2002-08-11 18:27:38 +0000 |
---|---|---|
committer | diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2002-08-11 18:27:38 +0000 |
commit | 58bba52aca7a03ff4a5ff81bac8be19e7811dd8b (patch) | |
tree | 30e9db6fd126d09c9f67148c8bb3a152c270c240 /DOCS/documentation.html | |
parent | 6287343f35cafb5778b2796a496a0d0fe1106529 (diff) | |
download | mpv-58bba52aca7a03ff4a5ff81bac8be19e7811dd8b.tar.bz2 mpv-58bba52aca7a03ff4a5ff81bac8be19e7811dd8b.tar.xz |
Another big batch of cosmetics *only*.
2 character indentation everywhere, 2 blank lines before new sections.
The docs should now have a nice and uniform look.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6975 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS/documentation.html')
-rw-r--r-- | DOCS/documentation.html | 1742 |
1 files changed, 832 insertions, 910 deletions
diff --git a/DOCS/documentation.html b/DOCS/documentation.html index 23a549492e..32b25fa1bf 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -9,14 +9,15 @@ <BODY> -<CENTER><B>MPlayer - Movie Player for LINUX (C) 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)</B><BR> -<BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A><BR><BR> -[ English ] -<A HREF="Hungarian/documentation.html">[ Hungarian ]</A> -<A HREF="German/documentation.html">[ German ]</A> -<A HREF="French/documentation.html">[ French ]</A> -<A HREF="Polish/documentation.html">[ Polish ]</A> -<A HREF="Italian/documentation.html">[ Italian ]</A> +<CENTER> + <B>MPlayer - Movie Player for LINUX (C) 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)</B><BR> + <BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A><BR><BR> + [ English ] + <A HREF="Hungarian/documentation.html">[ Hungarian ]</A> + <A HREF="German/documentation.html">[ German ]</A> + <A HREF="French/documentation.html">[ French ]</A> + <A HREF="Polish/documentation.html">[ Polish ]</A> + <A HREF="Italian/documentation.html">[ Italian ]</A> </CENTER> <HR> @@ -300,6 +301,8 @@ Developer Cries <HR> + + <P><B><A NAME="reading">0. How to read this documentation</A></B></P> <P>If you are a first-time installer: be sure to read everything from here to @@ -325,98 +328,100 @@ Developer Cries read the words on the OTHER side of the colon."</I></P> + <P><B><A NAME="introduction">1. Introduction</A></B></P> + <P><B><A NAME="overview">1.1 Overview</A></B></P> <P><B>MPlayer</B> is a movie player for LINUX (runs on many other Unices, and -<B>non-x86</B> CPUs, see the <A HREF="#ports">ports section</A>). It plays most -MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg, -FILM, RoQ files, supported by many native, XAnim, RealPlayer, and -Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>, -<B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need -the avifile -library at all!). The another big feature of mplayer is the wide range of -supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, -AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers) -and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon, -Mach64, Permedia3) too! Most -of them supports software or hardware scaling, so you can enjoy movies in -fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG -decoder boards, such as the <B><A HREF="video.html#dvb">DVB</A></B> and -<B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>! And what about the nice big antialiased -shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2 -(Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen -display (OSD)?</P> + <B>non-x86</B> CPUs, see the <A HREF="#ports">ports section</A>). It plays most + MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg, + FILM, RoQ files, supported by many native, XAnim, RealPlayer, and + Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>, + <B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need + the avifile + library at all!). The another big feature of mplayer is the wide range of + supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, + AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers) + and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon, + Mach64, Permedia3) too! Most + of them supports software or hardware scaling, so you can enjoy movies in + fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG + decoder boards, such as the <B><A HREF="video.html#dvb">DVB</A></B> and + <B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>! And what about the nice big antialiased + shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2 + (Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen + display (OSD)?</P> <P><B>MPlayer</B> is under GPL v2 license.</P> <P>The player is rock solid playing damaged MPEG files (useful for some VCDs), -and it plays bad AVI files which are unplayable with the famous -windows media player. Even AVI files without index chunk are playable, and -you can temporarily rebuild their indexes with the <CODE>-idx</CODE> option, or -permanently with <B>MEncoder</B>, thus enabling seeking! -As you see, stability and quality are the most important things, -but the speed is also amazing.</P> + and it plays bad AVI files which are unplayable with the famous + windows media player. Even AVI files without index chunk are playable, and + you can temporarily rebuild their indexes with the <CODE>-idx</CODE> option, or + permanently with <B>MEncoder</B>, thus enabling seeking! + As you see, stability and quality are the most important things, + but the speed is also amazing.</P> <P><B><A NAME="history">1.2 History</A></B></P> <P>This began a year ago... -I (A'rpi) have tried lots of players under linux (mtv,xmps,dvdview,livid/oms,videolan, -xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special -files or with audio/video sync. Most of them is unable to play both MPEG1, -MPEG2 and AVI (DivX) files. Many players have image quality or speed problems -too. So I've decided to write/modify one...</P> + I (A'rpi) have tried lots of players under linux (mtv,xmps,dvdview,livid/oms,videolan, + xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special + files or with audio/video sync. Most of them is unable to play both MPEG1, + MPEG2 and AVI (DivX) files. Many players have image quality or speed problems + too. So I've decided to write/modify one...</P> <UL> -<LI><B>mpg12play v0.1-v0.3:</B> Sep 22-25, 2000<BR> + <LI><B>mpg12play v0.1-v0.3:</B> Sep 22-25, 2000<BR> The first try, hacked together in a half hour! I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3, but there were image quality and speed problems with it.</LI> -<LI><B>mpg12play v0.5-v0.87:</B> Sep 28-Oct 20, 2000<BR> + <LI><B>mpg12play v0.5-v0.87:</B> Sep 28-Oct 20, 2000<BR> Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff, but it was slow and was written in C++ (I hate C++!!!)</LI> -<LI><B>mpg12play v0.9-v0.95pre5:</B> Oct 21-Nov 2, 2000<BR> + <LI><B>mpg12play v0.9-v0.95pre5:</B> Oct 21-Nov 2, 2000<BR> 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.</LI> -<LI><B>MPlayer v0.3-v0.9:</B> Nov 18-Dec 4, 2000<BR> + <LI><B>MPlayer v0.3-v0.9:</B> Nov 18-Dec 4, 2000<BR> It was a pack of two programs: mpg12play v0.95pre6 and my new simple AVI player 'avip' based on avifile's Win32 DLL loader.</LI> -<LI><B>MPlayer v0.10:</B> Jan 1, 2001<BR> + <LI><B>MPlayer v0.10:</B> Jan 1, 2001<BR> The MPEG and AVI player in a single binary!</LI> -<LI><B>MPlayer v0.11pre series:</B><BR> + <LI><B>MPlayer v0.11pre series:</B><BR> 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.</LI> -<LI><B>MPlayer v0.17a "The IdegCounter"</B> Apr 27, 2001<BR> + <LI><B>MPlayer v0.17a "The IdegCounter"</B> Apr 27, 2001<BR> 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.</LI> -<LI><B>MPlayer 0.18 "The BugCounter"</B> Jul 9, 2001<BR> + <LI><B>MPlayer 0.18 "The BugCounter"</B> Jul 9, 2001<BR> 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!</LI> -<LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B> Oct 8, 2001<BR> + <LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B> Oct 8, 2001<BR> Hmm. Release again. Tons of new features, beta GUI version, bugs fixed, new vo and ao drivers, ported to many systems, including opensource DivX codecs and much more. Try it!</LI> -<LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR> + <LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR> MOV/VIVO/RM/FLI/NUV fileformats support, native CRAM, Cinepak, ADPCM codecs, and support for XAnim's binary codecs; DVD subtitles support, first release of MEncoder, TV grabbing, cache, liba52, countless fixes.</LI> -<LI><B>MPlayer 0.90 "?"</B> Aug? ??, 2002<BR> - </LI> + <LI><B>MPlayer 0.90 "?"</B> Aug? ??, 2002</LI> </UL> + <P><B><A NAME="installation">1.3 Installation</A></B></P> <P>In this chapter I'll try to guide you through the compiling and -configuring process of <B>MPlayer</B>. It's not easy, but it won't necessarily -be hard. If you experience a different behavior than what I explain, please -search through this documentation and you'll find your answers. If you -see links, please follow them and read carefully what they contain. It -will take some time, but it DOES worth it.</P> + configuring process of <B>MPlayer</B>. It's not easy, but it won't necessarily + be hard. If you experience a different behavior than what I explain, please + search through this documentation and you'll find your answers. If you + see links, please follow them and read carefully what they contain. It + will take some time, but it DOES worth it.</P> <P>You need a fairly recent system. On Linux, 2.4.x kernels are recommended.</P> @@ -463,154 +468,138 @@ will take some time, but it DOES worth it.</P> <P><B>CODECS</B></P> <UL> -<LI><B>libavcodec</B>: This codec package is capable of decoding - H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1 encoded video streams, on - multiple platforms. It is also known to be the fastest for this task. - Details can be found <A HREF="codecs.html#libavcodec">here</A>. Features:<BR> - <UL> - <LI>gain decoding of videos mentioned above, on non-x86 machines</B></LI> - <LI>encoding with most of the mentioned codecs</LI> - <LI>this codec is the <B>fastest codec available</B> for DivX/3/4/5 and - other MPEG4 types. Recommended!</LI> - </UL> -</LI> - -<LI><B>Win32 codecs</B>: If you plan to use <B>MPlayer</B> on x86 - architecture, you will possibly need them. Download and unzip w32codecs.zip - to /usr/lib/win32 <B>BEFORE</B> compiling <B>MPlayer</B>, otherwise no Win32 - support will be compiled!<BR> - <B>Note</B>: the avifile project has similar codecs package, but it differs - from ours, so if you want to use all supported codecs, then use our package! - However, you can use our codecs package with avifile. Features:<BR> - <UL> - <LI>you need this if you want to play or encode for example movies recorded - with various hardware compressors, like tuner cards, digital cameras (example: DV, ATI VCR, MJPEG)</LI> - <LI>needed if you want to play <B>WMV8 movies</B>. Not needed for old - ASF's with MP41 or MP42 video (though VoxWare audio is frequent for these - files - it's done by the Win32 codec), or WMV7.</LI> - </UL> -</LI> - -<LI><B>DivX4/DivX5</B>: information about this codec is available in the - <A HREF="codecs.html#divx">DivX4/DivX5</A> section. You possibly don't want - this codec as <B>libavcodec</B> (see above) is much faster and has better - quality than this, for both decoding and encoding.<BR> - Features: - <UL> - <LI>1 pass or 2 pass encoding with - <A HREF="encoding.html">MEncoder</A></LI> - <LI>can play old <B>DivX3</B> movies much faster than the Win32 DLL but - slower than <B>libavcodec</B>!</LI> - <LI>it's closed-source, and only an x86 version is available.</LI> - </UL> -</LI> - -<LI><B>XviD</B>: Open source encoding alternative to Divx4Linux<BR> - Features: - <UL> - <LI>1 pass or 2 pass encoding with - <A HREF="encoding.html">MEncoder</A></LI> - <LI>it's open-source, so it's multiplatform.</LI> - <LI>it's about 2 times faster than DivX4 when encoding - about the same - quality</LI> - </UL> -</LI> - -<LI>The <A HREF="codecs.html#xanim">XAnim codecs</A> are the best (full - screen, hardware YUV zoom) for decoding <B>3ivx</B> and Indeo 3/4/5 movies, - and some old formats. And they are multiplatform, so this is the only way to - play Indeo on non-x86 platforms (well, apart from using XAnim:). But for - example Cinepak movies are best played with <B>MPlayer</B>'s own Cinepak - decoder!</LI> - -<LI>For <B>Ogg Vorbis</B> audio decoding you need to install - <CODE>libvorbis</CODE> properly. Use deb/rpm packages if available, or - compile from - <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A> - (this is a nightly updated tarball of Vorbis CVS).</LI> - -<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play - files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See - <A HREF="formats.html#real">RealMedia file format</A> section for - installation instructions and more information!</LI> + <LI><B>libavcodec</B>: This codec package is capable of decoding + H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1 encoded video streams, on + multiple platforms. It is also known to be the fastest for this task. + Details can be found <A HREF="codecs.html#libavcodec">here</A>. Features:<BR> + <UL> + <LI>gain decoding of videos mentioned above, on non-x86 machines</B></LI> + <LI>encoding with most of the mentioned codecs</LI> + <LI>this codec is the <B>fastest codec available</B> for DivX/3/4/5 and + other MPEG4 types. Recommended!</LI> + </UL> + </LI> + <LI><B>Win32 codecs</B>: If you plan to use <B>MPlayer</B> on x86 + architecture, you will possibly need them. Download and unzip w32codecs.zip + to /usr/lib/win32 <B>BEFORE</B> compiling <B>MPlayer</B>, otherwise no Win32 + support will be compiled!<BR> + <B>Note</B>: the avifile project has similar codecs package, but it differs + from ours, so if you want to use all supported codecs, then use our package! + However, you can use our codecs package with avifile. Features:<BR> + <UL> + <LI>you need this if you want to play or encode for example movies recorded + with various hardware compressors, like tuner cards, digital cameras + (example: DV, ATI VCR, MJPEG)</LI> + <LI>needed if you want to play <B>WMV8 movies</B>. Not needed for old + ASF's with MP41 or MP42 video (though VoxWare audio is frequent for these + files - it's done by the Win32 codec), or WMV7.</LI> + </UL> + </LI> + <LI><B>DivX4/DivX5</B>: information about this codec is available in the + <A HREF="codecs.html#divx">DivX4/DivX5</A> section. You possibly don't want + this codec as <B>libavcodec</B> (see above) is much faster and has better + quality than this, for both decoding and encoding.<BR> + Features: + <UL> + <LI>1 pass or 2 pass encoding with + <A HREF="encoding.html">MEncoder</A></LI> + <LI>can play old <B>DivX3</B> movies much faster than the Win32 DLL but + slower than <B>libavcodec</B>!</LI> + <LI>it's closed-source, and only an x86 version is available.</LI> + </UL> + </LI> + <LI><B>XviD</B>: Open source encoding alternative to Divx4Linux<BR> + Features: + <UL> + <LI>1 pass or 2 pass encoding with + <A HREF="encoding.html">MEncoder</A></LI> + <LI>it's open-source, so it's multiplatform.</LI> + <LI>it's about 2 times faster than DivX4 when encoding - about the same + quality</LI> + </UL> + </LI> + <LI>The <A HREF="codecs.html#xanim">XAnim codecs</A> are the best (full + screen, hardware YUV zoom) for decoding <B>3ivx</B> and Indeo 3/4/5 movies, + and some old formats. And they are multiplatform, so this is the only way to + play Indeo on non-x86 platforms (well, apart from using XAnim:). But for + example Cinepak movies are best played with <B>MPlayer</B>'s own Cinepak + decoder!</LI> + <LI>For <B>Ogg Vorbis</B> audio decoding you need to install + <CODE>libvorbis</CODE> properly. Use deb/rpm packages if available, or + compile from + <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A> + (this is a nightly updated tarball of Vorbis CVS).</LI> + <LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play + files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See + <A HREF="formats.html#real">RealMedia file format</A> section for + installation instructions and more information!</LI> </UL> <P><B>VIDEO CARDS</B></P> <P>There are generally two kind of video cards. One kind (the newer cards) has -<B>hardware scaling and YUV acceleration</B> support, the other cards don't.</P> - -<P> -<B>YUV cards</B></P> - -<P> -They can display and scale (zoom) the picture to any size that fits in -their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus -you get a nice and very fast fullscreen playing.</P> - -<UL> -<LI><B>Matrox G200/G400/G450/G550 cards</B>: although a - <A HREF="video.html#vidix">Vidix driver</A> is provided, it is recommended - to use the old mga_vid kernel module instead, for it works much better. - Please see the <A HREF="video.html#mga_vid">mga_vid</A> section about its - installation and usage. It is important to do these steps <I>before</I> - compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also - check out the <A HREF="video.html#tv-out_matrox">Matrox TV-out</A> section. - <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix - driver: read <A HREF="video.html#vidix">VIDIX</A> documentation!</LI> - -<LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the - <A HREF="video.html#tdfxfb">tdfxfb</A> section in order to gain big - speedup. It is important to do these steps <I>before</I> compiling - <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A - HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use at - least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier - releases!</LI> - -<LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is - provided for the following cards: - <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98). - Also see the <A HREF="video.html#tv-out_ati">ATI cards - section</A> of the TV-out documentation, to know if you card's TV-out is - supported under Linux/MPlayer.</LI> - -<LI><B>S3 cards</B>: the Savage and Virge/DX chips have hardware acceleration. - Use as new XFree86 version as possible, older drivers are buggy. Savage chips - have problems with YV12 display, see <A HREF="video.html#xv_s3">S3 Xv - section</A> for details. Older, Trio cards have no, or slow hardware - support.</LI> - -<LI><B>nVidia cards</B>: very bad choice for video playing (nVidia has - <A HREF="users_against_developers.html#nvidia">different opinion</A>!). - nVidia's cards have very cheap and bad quality chips. Moreover, <U>the - built-in nVidia driver in XFree86 doesn't contain support for hardware YUV - acceleration for all nVidia cards!</U> You have to download nVidia's - closed-source drivers from nVidia.com. See details in <A - HREF="video.html#xv_nvidia">nVidia Xv driver</A> section.</LI> - -<LI><B>3DLabs GLINT R3 and Permedia3</B>: a VIDIX driver is provided - (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX - instructions</A>.</LI> - -<LI><B>other cards</B>: none of the above? - <UL> - <LI>Try if the XFree86 driver (and your card) supports hardware - acceleration. See the <A HREF="video.html#xv">Xv section</A> for - details.</LI> - <LI>If it doesn't, then your card's video features aren't supported under - your OS :(<BR> - If it does hardware scaling under Windows, it doesn't mean it will do the - same under Linux or other OS, it depends on the drivers! Most - manufacturers don't make Linux drivers nor release chip specs - so you're - unlucky using their cards. See the next section: - </LI> - </UL> -</LI> - + <B>hardware scaling and YUV acceleration</B> support, the other cards don't.</P> + +<P><B>YUV cards</B></P> + +<P>They can display and scale (zoom) the picture to any size that fits in + their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus + you get a nice and very fast fullscreen playing.</P> + +<UL> + <LI><B>Matrox G200/G400/G450/G550 cards</B>: although a + <A HREF="video.html#vidix">Vidix driver</A> is provided, it is recommended + to use the old mga_vid kernel module instead, for it works much better. + Please see the <A HREF="video.html#mga_vid">mga_vid</A> section about its + installation and usage. It is important to do these steps <I>before</I> + compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also + check out the <A HREF="video.html#tv-out_matrox">Matrox TV-out</A> section. + <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix + driver: read <A HREF="video.html#vidix">VIDIX</A> documentation!</LI> + <LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the + <A HREF="video.html#tdfxfb">tdfxfb</A> section in order to gain big + speedup. It is important to do these steps <I>before</I> compiling + <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A + HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use at + least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier + releases!</LI> + <LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is + provided for the following cards: + <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98). + Also see the <A HREF="video.html#tv-out_ati">ATI cards + section</A> of the TV-out documentation, to know if you card's TV-out is + supported under Linux/MPlayer.</LI> + <LI><B>S3 cards</B>: the Savage and Virge/DX chips have hardware acceleration. + Use as new XFree86 version as possible, older drivers are buggy. Savage chips + have problems with YV12 display, see <A HREF="video.html#xv_s3">S3 Xv + section</A> for details. Older, Trio cards have no, or slow hardware + support.</LI> + <LI><B>nVidia cards</B>: very bad choice for video playing (nVidia has + <A HREF="users_against_developers.html#nvidia">different opinion</A>!). + nVidia's cards have very cheap and bad quality chips. Moreover, <U>the + built-in nVidia driver in XFree86 doesn't contain support for hardware YUV + acceleration for all nVidia cards!</U> You have to download nVidia's + closed-source drivers from nVidia.com. See details in <A + HREF="video.html#xv_nvidia">nVidia Xv driver</A> section.</LI> + <LI><B>3DLabs GLINT R3 and Permedia3</B>: a VIDIX driver is provided + (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX + instructions</A>.</LI> + <LI><B>other cards</B>: none of the above? + <UL> + <LI>Try if the XFree86 driver (and your card) supports hardware + acceleration. See the <A HREF="video.html#xv">Xv section</A> for + details.</LI> + <LI>If it doesn't, then your card's video features aren't supported under + your OS :(<BR> + If it does hardware scaling under Windows, it doesn't mean it will do the + same under Linux or other OS, it depends on the drivers! Most + manufacturers don't make Linux drivers nor release chip specs - so you're + unlucky using their cards. See the next section:</LI> + </UL> + </LI> </UL> -<P> -<B>Non-YUV cards</B></P> +<P><B>Non-YUV cards</B></P> <P>Fullscreen playing can be achieved by either zooming <B>by software</B> (use the option <CODE>-zoom</CODE> or <A HREF="#2.6.11"><CODE>-vop @@ -618,8 +607,7 @@ you get a nice and very fast fullscreen playing.</P> video mode, for example to 352x288. If you don't have YUV acceleration, this latter method is the recommended one. Throughout <B>MPlayer</B>, <U>this behavior can be switched on by using the <CODE>-vm</CODE> option</U> and with - the following drivers: -</P> + the following drivers:</P> <UL> <LI><B>using</B> XFree86: see details in @@ -664,34 +652,28 @@ you get a nice and very fast fullscreen playing.</P> <P><B>SOUND CARDS</B></P> <UL> -<LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>) - channels AC3 decoding instead of 2. Read the - <A HREF="codecs.html#software_ac3">Software AC3 decoding</A> section. - For hardware AC3 passthrough you MUST use ALSA 0.9 oss emulation!</LI> - -<LI><B>C-Media with SP/DIF out</B>: hardware AC3 passthrough is possible - with these cards, see - <A HREF="codecs.html#hardware_ac3">Hardware AC3 decoding</A> section.</LI> - -<LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>. - <U>It's very recommended to read the <A HREF="sound.html">sound card - section</A>!</U></LI> + <LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>) + channels AC3 decoding instead of 2. Read the + <A HREF="codecs.html#software_ac3">Software AC3 decoding</A> section. + For hardware AC3 passthrough you MUST use ALSA 0.9 oss emulation!</LI> + <LI><B>C-Media with SP/DIF out</B>: hardware AC3 passthrough is possible + with these cards, see + <A HREF="codecs.html#hardware_ac3">Hardware AC3 decoding</A> section.</LI> + <LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>. + <U>It's very recommended to read the <A HREF="sound.html">sound card + section</A>!</U></LI> </UL> <P><B>FEATURES</B></P> <UL> -<LI>Decide if you need GUI. If you do, see the <A HREF="#gui">GUI section</A> - before compiling.</LI> - -<LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder), - see the <A HREF="encoding.html">MEncoder section</A>.</LI> - - -<LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab - and encode movies with <B>MPlayer</B>, read the <A HREF="#tv">TV input</A> - section.</LI> - + <LI>Decide if you need GUI. If you do, see the <A HREF="#gui">GUI section</A> + before compiling.</LI> + <LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder), + see the <A HREF="encoding.html">MEncoder section</A>.</LI> + <LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab + and encode movies with <B>MPlayer</B>, read the <A HREF="#tv">TV input</A> + section.</LI> </UL> <P>Then build <B>MPlayer</B>:</P> @@ -762,6 +744,7 @@ you get a nice and very fast fullscreen playing.</P> <CODE>-skin newskin</CODE> option, or the <CODE>skin=newskin</CODE> config file directive to use the skin in <CODE>*/Skin/newskin</CODE> directory.</P> + <P><B><A NAME="subtitles_osd">1.5 Subtitles and OSD</A></B></P> <P> @@ -782,8 +765,7 @@ you get a nice and very fast fullscreen playing.</P> The command line options differ slightly for the different formats: -<P> - <B>VobSub subtitles</B><BR> +<P><B>VobSub subtitles</B><BR> VobSub subtitles consist of a big (some megabytes) .SUB file, and optional .IDX and/or .IFO files.<BR> Usage: if you have files like <CODE>sample.sub</CODE>, @@ -793,22 +775,18 @@ The command line options differ slightly for the different formats: <CODE>-vobsubid</CODE> option is like <CODE>-sid</CODE> for DVDs, you can choose between subtitle tracks (languages) with it.</P> -<P> - <B>Other subtitles</B><BR> +<P><B>Other subtitles</B><BR> The other formats consist of a single text file containing timing, placement and text information.<BR> Usage: if you have a file like <CODE>sample.txt</CODE>, you have to pass the - option <CODE>-sub sample.txt</CODE> (optionally with pathname, of course). -</P> + option <CODE>-sub sample.txt</CODE> (optionally with pathname, of course).</P> -<P> - <B>Adjusting subtitle timing and placement</B><BR> +<P><B>Adjusting subtitle timing and placement</B><BR> <CODE>-subdelay <sec></CODE>: Delays subtitles by <sec> seconds. Can be negative.<BR> <CODE>-subfps <rate></CODE>: Specify frame/sec rate of subtitle file (float number)<BR> - <CODE>-subpos <0 - 100></CODE>: Specify the position of subtitles.<BR> -</P> + <CODE>-subpos <0 - 100></CODE>: Specify the position of subtitles.</P> <P>If you experience a growing delay between the movie and the subtitles when using a MicroDVD subtitle file, most likely the frame rate of the movie and @@ -826,22 +804,19 @@ The command line options differ slightly for the different formats: designed by me (Gabucino). Basically its main feature is being <I>dynamically</I> time-based (although it has frame-based mode too). Example (from - <A HREF="tech/mpsub.sub">DOCS/tech/mpsub.sub</A>): -</P> - -<P><CODE><I> -# first number : wait this much after previous subtitle disappeared<BR> -# second number : display the current subtitle for this many seconds<BR> -<BR> -15 3<BR> -A long long, time ago...<BR> -<BR> -0 3<BR> -in a galaxy far away...<BR> -<BR> -0 3<BR> -Naboo was under an attack.<BR> -</I></CODE></P> + <A HREF="tech/mpsub.sub">DOCS/tech/mpsub.sub</A>):</P> + +<P><CODE><I># first number : wait this much after previous subtitle disappeared<BR> + # second number : display the current subtitle for this many seconds<BR> + <BR> + 15 3<BR> + A long long, time ago...<BR> + <BR> + 0 3<BR> + in a galaxy far away...<BR> + <BR> + 0 3<BR> + Naboo was under an attack.<BR></I></CODE></P> <P>So you see, the main goal was to <B>make subtitle editing/timing/joining/cutting easy</B>. And, if you - say - get an SSA @@ -880,11 +855,9 @@ Naboo was under an attack.<BR> <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - Korean fonts & RAW plugin</LI> </UL> </LI> - <LI>use the font generator tool at TOOLS/subfont-c It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg. (read TOOLS/subfont-c/README for details)</LI> - <LI>use the font generator GIMP plugin at TOOLS/subfont-GIMP (note: you must have HSI RAW plugin too, see URL below)</LI> </UL> @@ -906,9 +879,11 @@ Naboo was under an attack.<BR> <P>You can change default behaviour by setting <CODE>osdlevel=</CODE> variable in config file.</P> + <P><B><A NAME="rtc">1.6 RTC</A></B></P> There are three timing methods in <B>MPlayer</B>. + <UL> <LI><B>To use the old method</B>, you don't have to do anything. It uses <CODE>usleep()</CODE> to tune A/V sync, with +/- 10ms accuracy. However @@ -953,6 +928,7 @@ There are three timing methods in <B>MPlayer</B>. It's a clear way for everyone to become root. + <P><B><A NAME="features">2. Features</A></B></P> @@ -996,7 +972,9 @@ TV tuner</B>.</P> (<CODE>-vo sdl</CODE>) colorspaces. You can specify these with the <CODE>outfmt=YV12</CODE> option, see below.</P> + <P><A NAME="tv_options"><B>2.5.3 Available options</B></A></P> + <TABLE BORDER=0> <TR> <TD> </TD> @@ -1080,31 +1058,29 @@ TV tuner</B>.</P> </TR> </TABLE> + <P><A NAME="tv_keyboard"><B>2.5.4 Keyboard control</B></A></P> <TABLE BORDER=0> -<TR><TD> </TD><TD>h / k</TD><TD> </TD><TD>select previous/next channel</TD></TR> -<TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR> -<TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR> + <TR><TD> </TD><TD>h / k</TD><TD> </TD><TD>select previous/next channel</TD></TR> + <TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR> + <TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR> </TABLE> + <P><A NAME="tv_examples"><B>2.5.5 Examples</B></A></P> -<P> -Dummy output, to AAlib :)<BR> -<CODE> mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR> -<BR> -Input from standard V4L<BR> -<CODE> mplayer -tv on:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE><BR> -</P> +<P>Dummy output, to AAlib :)<BR> + <CODE> mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR> + <BR> + Input from standard V4L<BR> + <CODE> mplayer -tv on:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE><BR></P> -<P> - <B>Note:</B><BR> +<P><B>Note:</B><BR> If you have a TV card with an external audio device and get only a black screen, although input works with xawtv or similar, then try to use the <CODE>-noaudio</CODE> option. For the example above this would be:<BR> - <CODE> mplayer -tv on:noaudio:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE> -</P> + <CODE> mplayer -tv on:noaudio:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE></P> <P><A NAME="filters"><B>2.6 filters</B></A></P> @@ -1130,6 +1106,7 @@ Input from standard V4L<BR> <P>Note that the postprocessing code is now also a part of the layer. It will be explained below.</P> + <P><A NAME="filters_usage"><B>2.6.2 Usage</B></A></P> <P><CODE> mplayer/mencoder -vop filter1,filter2,filter3,...</CODE> @@ -1334,8 +1311,10 @@ Input from standard V4L<BR> <P><CODE> -vop rectangle[=width:height:x:y]</CODE></P> + <P><B><A NAME="usage">3. Usage</A></B></P> + <P><B><A NAME="command_l |