diff options
| author | gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2001-11-11 22:30:31 +0000 |
|---|---|---|
| committer | gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2001-11-11 22:30:31 +0000 |
| commit | cf127f5ccc5a248161c2e820897518f80ced8736 (patch) | |
| tree | 8650d71ba38aa68676fea66fe7f6c720b34a23bb /DOCS | |
| parent | 96a935f2255ef6df186b7b13078feddb68172b6e (diff) | |
| download | mpv-cf127f5ccc5a248161c2e820897518f80ced8736.tar.bz2 mpv-cf127f5ccc5a248161c2e820897518f80ced8736.tar.xz | |
many small updates, fixes (some/more to be completed soon)
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@2849 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/codecs.html | 2 | ||||
| -rw-r--r-- | DOCS/documentation.html | 47 | ||||
| -rw-r--r-- | DOCS/encoding.html | 18 | ||||
| -rw-r--r-- | DOCS/faq.html | 15 | ||||
| -rw-r--r-- | DOCS/mencoder.1 | 7 | ||||
| -rw-r--r-- | DOCS/mplayer.1 | 14 | ||||
| -rw-r--r-- | DOCS/video.html | 174 |
7 files changed, 157 insertions, 120 deletions
diff --git a/DOCS/codecs.html b/DOCS/codecs.html index 3ff7cb74cc..1a4815817f 100644 --- a/DOCS/codecs.html +++ b/DOCS/codecs.html @@ -142,7 +142,7 @@ easy to enable them:</P> isn't there, so download it from the <A HREF="http://www.3ivx.com">3ivx site</A>.</LI> <LI>use the <CODE>--with-xanimlibdir</CODE> option to tell configure where - it can find the xanim codecs. By default, it checks them at <CODE>/usr/lib/xanim/mods</CODE> .</LI> + it can find the xanim codecs. By default, it checks them at <CODE>/</CODE> (...) .</LI> </UL> </P> diff --git a/DOCS/documentation.html b/DOCS/documentation.html index 282b8c05fc..9461052766 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -33,11 +33,11 @@ <UL> <LI><A HREF="formats.html#2.1.1">2.1.1 Video</A></LI> <UL> - <LI><A HREF="formats.html#2.1.1.1">2.1.1.1 MPG, VOB, DAT files</A></LI> - <LI><A HREF="formats.html#2.1.1.2">2.1.1.2 AVI files</A></LI> - <LI><A HREF="formats.html#2.1.1.3">2.1.1.3 ASF/WMV files</A></LI> - <LI><A HREF="formats.html#2.1.1.4">2.1.1.4 QT/MOV files</A></LI> - <LI><A HREF="formats.html#2.1.1.5">2.1.1.5 VIV files</A></LI> + <LI><A HREF="formats.html#2.1.1.1">2.1.1.1 MPG, VOB, DAT files</A></LI> + <LI><A HREF="formats.html#2.1.1.2">2.1.1.2 AVI files</A></LI> + <LI><A HREF="formats.html#2.1.1.3">2.1.1.3 ASF/WMV files</A></LI> + <LI><A HREF="formats.html#2.1.1.4">2.1.1.4 QT/MOV files</A></LI> + <LI><A HREF="formats.html#2.1.1.5">2.1.1.5 VIV files</A></LI> </UL> <LI><A HREF="formats.html#2.1.2">2.1.2 Audio</A></LI> </UL> @@ -45,11 +45,11 @@ <UL> <LI><A HREF="codecs.html#2.2.1">2.2.1 Video</A></LI> <UL> - <LI><A HREF="codecs.html#2.2.1.1">2.2.1.1 DivX4</A></LI> - <LI><A HREF="codecs.html#2.2.1.2">2.2.1.2 ffmpeg's DivX/libavcodec</A></LI> - <LI><A HREF="codecs.html#2.2.1.3">2.2.1.3 XAnim codecs</A></LI> - <LI><A HREF="codecs.html#2.2.1.4">2.2.1.4 VIVO video</A></LI> - <LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 MPEG1/2 video</A></LI> + <LI><A HREF="codecs.html#2.2.1.1">2.2.1.1 DivX4</A></LI> + <LI><A HREF="codecs.html#2.2.1.2">2.2.1.2 ffmpeg's DivX/libavcodec</A></LI> + <LI><A HREF="codecs.html#2.2.1.3">2.2.1.3 XAnim codecs</A></LI> + <LI><A HREF="codecs.html#2.2.1.4">2.2.1.4 VIVO video</A></LI> + <LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 MPEG1/2 video</A></LI> </UL> <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A></LI> <UL> @@ -98,6 +98,7 @@ <LI><A HREF="video.html#2.3.1.10">2.3.1.10 OpenGL output</A></LI> <LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - text mode displaying</A></LI> <LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - output to VESA BIOS</A></LI> + <LI><A HREF="video.html#2.3.1.13">2.3.1.13 X11</A></LI> <LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A></LI> <UL> <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox</A></LI> @@ -226,7 +227,7 @@ too. So I've decided to write/modify one...</P> <LI><B>MPlayer 0.18 "The BugCounter"</B><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 ! + even more stable than ever, and so on. It's a MUST ! <LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B><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 @@ -340,7 +341,7 @@ into your config file, <CODE>$HOME/.mplayer/config</CODE> .</P> <P><B><A NAME=1.4>1.4. What about the GUI?</A></B></P> -<P>The GUI is built upon GTK, so gtk (and it's devel stuff) has to be installed. +<P>The GUI needs GTK (it isn't GTK, but the panels are), so gtk (and it's devel stuff) has to be installed. You can build it by specifying <CODE>--enable-gui</CODE> during ./configure . Then, to turn on GUI mode, you either <UL> @@ -511,19 +512,19 @@ Now you have to see a timer at the upper left corner of the movie <TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>m</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle mute</TD><TR> </TABLE></P> - + <P><B><A NAME=3.2>3.2. Control from LIRC</A></B></P> -<P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, +<P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, an (almost) arbitrary remote control and control your linux box with it! More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P> <P>If you have installed the lirc-package, you can compile <B>MPlayer</B> with LIRC support using ./configure --enable-lirc</P> -<P>If everything went fine, <B>MPlayer</B> will print a message like +<P>If everything went fine, <B>MPlayer</B> 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 +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 :-)</P> <P>The application name for <B>MPlayer</B> is - oh wonder - mplayer_lirc. @@ -560,7 +561,7 @@ excerpt from my .lircrc:</P> config = QUIT end</PRE></P> -<P>If you don't like the standard location for the lirc-config file (~/.lircrc) +<P>If you don't like the standard location for the lirc-config file (~/.lircrc) use the -lircconf <filename> switch to specify another file.</P> <P><B><A NAME=3.3>3.3. Streaming from network or pipes</A></B></P> @@ -600,7 +601,7 @@ dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.</P> <P>Here's how it looks like:</P> -<P><PRE> eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb +<P><PRE> eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb Password: (Reading database ... 26946 files and directories currently installed.) Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) @@ -610,15 +611,15 @@ dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.</P> <P><B><A NAME=6.2>6.2. FreeBSD</A></B></P> -<P>To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), +<P>To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), native BSD make will not work.</P> -<P>To run <B>MPlayer</B> you will need to re-compile the kernel with +<P>To run <B>MPlayer</B> you will need to re-compile the kernel with "options USER_LDT" (unless you are running -CURRENT, where this is default). If you have a CPU with SSE also use "options CPU_ENABLE_SSE" to use it (FreeBSD-STABLE required, or use kernel patches).</P> -<P>If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a +<P>If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a symbolic link: <CODE>ln -s /dev/(your_cdrom_device) /dev/cdrom</CODE></P> <P>There's no DVD support for FreeBSD yet.</P> @@ -677,7 +678,7 @@ not use GNU as:</P> <P><PRE> % gmake ... - gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math + gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c Assembler: mplayer.c "(stdin)", line 3567 : Illegal mnemonic @@ -704,7 +705,7 @@ all data is accessed modulo 4GB <P>On Solaris with an UltraSPARC CPU, you can get some extra speed by using the CPU's VIS instructions for certain time consuming operations. - VIS acceleration can be used in MPlayer by calling functions in Sun's + VIS acceleration can be used in MPlayer by calling functions in Sun's <A HREF="http://www.sun.com/sparc/vis/mediaLib.html">mediaLib</A>.</P> <P>VIS accelerated operations from mediaLib are used for mpeg2 video diff --git a/DOCS/encoding.html b/DOCS/encoding.html index b2922c933e..a60c343609 100644 --- a/DOCS/encoding.html +++ b/DOCS/encoding.html @@ -26,8 +26,7 @@ other interesting stuff.</P> is needed for CBR/VBR MP3 audio encoding ability. Note that a single <CODE>lame</CODE> binary isn't sufficient.</LI> <LI>use <CODE>./configure</CODE> with optional parameters as usual, and - type : <CODE>make mencoder</CODE> . You have to install it manually for - now. + type : <CODE>make mencoder</CODE> , then <CODE>make install</CODE> . </UL> </P> @@ -57,6 +56,21 @@ other interesting stuff.</P> </UL> </P> +<P><B><I>Encoding 2-pass DivX4</I></B></P> + +<P>The name comes from the fact that this method encodes the file <I>twice</I>. +The first encoding (dubbed <I>pass</I>) creates a temporary file with a size +of few megabytes. In the second pass, the output file is created, using the +bitrate data from the temporary file. The resulting file will have much +better image quality. If this is the first time you heard about this, you +should consult some guides available on the Net.</P> + +<P>This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two +commands are needed :<BR> +<CODE> mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 +-o movie.avi -pass 1<BR> + mplayer -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P> + <P><B><I>Examples</I></B></P> <P>Using <B>MEncoder</B> is the easiest thing on Earth. See the following :</P> diff --git a/DOCS/faq.html b/DOCS/faq.html index 74cd12699f..692408ed8e 100644 --- a/DOCS/faq.html +++ b/DOCS/faq.html @@ -23,7 +23,7 @@ gcc 2.96 is RedHat's UNOFFICIAL (it can be found only on RedHat/Mandrake sites, RedHat/Mandrake distributions) and BUGGY gcc release. gcc 2.96 is TOTALLY unsupported by <B>MPlayer</B>, because it simply SKIPS MMX/3DNow codes, it just does not compile it. Important: this is NOT an <B>MPlayer</B>-specific problem, -numerous other projects (DRI, avifile, etc..) have problems with this shit +numerous other projects (DRI, avifile, Wine, etc..) have problems with this shit too.<BR> <B><I>DO NOT USE gcc 2.96 !!!</I></B><BR> If you really really want to do so, be sure to use the newest. @@ -186,6 +186,15 @@ problem, you are careless enough to do such things. </TD><TR><TD COLSPAN=3> </TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +MPlayer doesn't seem to find my libcss. What am I doing wrong ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's normal. Since a while, <B>MPlayer</B> doesn't depend on libcss for +DVD playing. You have to install <B>libdvdread</B> and <B>libdvdcss?</B>. +libcss is to be used for example when you want to play encrypted VOB files +from hard disk (not for general users). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> Hmm, strange. When loading the mga_vid.o kernel module, I found this in the logs:<BR> <CODE>Warning: loading mga_vid.o will taint the kernel: no license</CODE> </B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> @@ -402,7 +411,7 @@ sound too slow. When I use -nosound switch, everything is ok (but quiet). </B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> Ok son, your machine is too slow. RTFM or anything. </TD><TR><TD COLSPAN=3> </TD><TR> - + <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> MPlayer dies with "MPlayer interrupted by signal 4 in module: decode_video". </B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> @@ -437,7 +446,7 @@ config file(s). </TD><TR><TD COLSPAN=3> </TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> -After starting mplayer under KDE(1/2) I just get a black screen and nothing +After starting mplayer under KDE(1/2) I just get a black screen and nothing happens, after about one minute the video starts playing. </B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> The KDE arts sound daemon is blocking the sound device, either wait the time diff --git a/DOCS/mencoder.1 b/DOCS/mencoder.1 index 95c3c43fe3..51af92913e 100644 --- a/DOCS/mencoder.1 +++ b/DOCS/mencoder.1 @@ -124,7 +124,7 @@ If encoding to DivX4, you can specify its parameters here, like: Available options: - help get help (TODO!) + help get help br=XXX specify bitrate in kbit <4-16000> or bit <16001-24000000> @@ -148,7 +148,7 @@ If encoding to MP3 with libmp3lame, you can specify its parameters here, like: Available options: - help get help (TODO!) + help get help br=XXX specify bitrate in kbit <0-1024> q=XXX Quality @@ -183,9 +183,6 @@ Outputs to the given filename, instead of the default 'test.avi' . .TP .B \-frames <number> Encode only given number of frames. -.TP -.B \-OTHERS -TODO .IP .SH FILES AND DIRECTORIES .IP diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1 index 5ed380bf55..f26c7fa744 100644 --- a/DOCS/mplayer.1 +++ b/DOCS/mplayer.1 @@ -172,10 +172,12 @@ apply postprocess filter on decoded image. You need a STRONG CPU in order to use this! The supported formats and settings are: - MPEG 1/2 0 (none), 1, 3, 7, 15, 31, 63 - OpenDivX 0 (none), 1, 3, 7, 15, 31, 63 - DivX4 0 (none) - 60 - DivX 0 (none), 1, 2, 3, 4 + MPEG 1/2 0 (none), TODO + OpenDivX 0 (none), TODO + DivX4 0 (none), TODO + DivX 0 (none), TODO + + -pp 0x20000 TODO .TP .B \-autoq\ quality @@ -208,7 +210,7 @@ specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer) (default = 2) .TP .B \-lircconf\ configfile -specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc +specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc .TP .B \-v enable verbose output (more -v means more verbose) @@ -595,7 +597,7 @@ This manpage is written and maintained by .I Gabucino . .LP .SH STANDARD DISCLAIMER -Use only at your own risk! There may be errors and inaccuracies that could +Use only at your own risk! There may be errors and inaccuracies that could be damaging to your system or your eye. Proceed with caution, and although this is highly unlikely, the author doesn't take any responsibility for that! .\" end of file diff --git a/DOCS/video.html b/DOCS/video.html index f1f84b47e7..1bf7bdfcc2 100644 --- a/DOCS/video.html +++ b/DOCS/video.html @@ -9,39 +9,38 @@ <TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD><TR> -<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>x11</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 with optional SHM extension</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>xv</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 using overlays with the Xvideo extension (hardware YUV & scaling)</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>gl</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OpenGL renderer, so far works only with: +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.13>x11</A></TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 with optional SHM extension</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.2>xv</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 using overlays with the Xvideo extension (hardware YUV & scaling)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.10</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OpenGL renderer, so far works only with: <UL><LI>all cards with Utah-GLX <LI>Matrox cards with X/DRI >=4.0.3 <LI>Radeon with X/DRI CVS</UL></TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>dga</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 DGA extension</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>fbdev</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to general framebuffers</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>svga</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to SVGAlib</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sdl</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.3>dga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 DGA extension</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.6>fbdev</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to general framebuffers</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.5>svga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to SVGAlib</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.4>sdl</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> <CODE>1.1.7:</CODE> supports software scaling<BR> <CODE>1.1.8:</CODE> supports Xvideo (hardware scaling/fullscreen)<BR> <CODE>1.2.0:</CODE> supports AAlib (-vo aa is very recommended, see below!)</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ggi</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>similar to SDL</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>aa</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>textmode rendering with AAlib</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><a href="video.html#2.3.1.12">vesa</a></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to VESA BIOS.</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.14-TODO>ggi</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>similar to SDL</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.11>aa</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>textmode rendering with AAlib</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><a href=#2.3.1.12>vesa</a></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Output to VESA BIOS.</TD><TR> <TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Card specific:</B></P></TD><TR> -<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mga</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G200/G400 hardware YUV overlay via the mga_vid device</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>xmga</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G200/G400 overlay (mga_vid) in X11 window<BR> +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.7>mga</A></TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G200/G400 hardware YUV overlay via the mga_vid device</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.7>xmga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G200/G400 overlay (mga_vid) in X11 window<BR> (<I>Xv emulation on X 3.3.x!</I>)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>syncfb</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>3dfx</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Voodoo3/Banshee hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>tdfxfb</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Voodoo3/Banshee hardware YUV support on tdfx framebuffer (works!)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF=#2.3.1.9>tdfxfb</A></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Voodoo3/Banshee hardware YUV support on tdfx framebuffer (works!)</TD><TR> <TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Special:</B></P></TD><TR> <TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>png</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PNG files output (use -z switch to set compression)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>pgm</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PGM files output (for testing purposes or ffmpeg encoding)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>md5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>MD5sum output (for MPEG conformance tests)</TD><TR> -<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>odivx</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OpenDivX AVI File writer (use -br to set encoding bitrate) (<B>WITHOUT SOUND</B>!)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>null</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Null output (for speed tests/benchmarking)</TD><TR> </TABLE> @@ -64,19 +63,19 @@ reg01: base=0xd8000000 (3456MB), size= 128MB: write-combining, count=1<BR> <P>It's right, shows my Matrox G400 with 16Mb memory. I did this from XFree 4.x.x , which sets up MTRR registers automatically.</P> -If nothing worked, you have to do it manually. First, you have to find the base +<P>If nothing worked, you have to do it manually. First, you have to find the base address. You have 3 ways to find it:</P> <P><UL> <LI>from X11 startup messages, for example: <P><CODE>(--) SVGA: PCI: Matrox MGA G400 AGP rev 4, Memory @ 0xd8000000, 0xd4000000<BR> -(--) SVGA: Linear framebuffer at 0xD8000000</CODE></P> +(--) SVGA: Linear framebuffer at 0xD8000000</CODE></P></LI> <LI>from /proc/pci (use lspci -v command): -<P><TABLE> -<TD VALIGN=top><CODE>01:00.0</CODE></TD><TD><CODE>VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE></TD><TR> -<TD></TD><TD><CODE>Memory at d8000000 (32-bit, prefetchable)</CODE></TD><TR> -</TABLE></P></CODE> +<P> +<CODE>01:00.0 VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE> +<CODE>Memory at d8000000 (32-bit, prefetchable)</CODE> +</P> <LI>from mga_vid kernel driver messages (use dmesg): <P><CODE>mga_mem_base = d8000000</CODE></P> </UL></P> @@ -104,7 +103,7 @@ ram (size=0x2000000) just execute:</P> <P>Not all CPUs support MTRRs. For example older K6-2's [around 266Mhz, stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat /proc/cpuinfo</CODE>' -to check it</CODE>').</P> +to check it').</P> <P><B><A NAME=2.3.1.2>2.3.1.2. Xv</A></B></P> @@ -113,7 +112,7 @@ using the XVideo extension. This is what the option '-vo xv' uses. In order to make this work, be sure to check the following:</P> <P><UL> <LI>You have to use XFree86 4.0.2 or newer (former versions don't have XVideo) -<LI>Your card actually supports harware acceleration (modern cards do) +<LI>Your card actually supports hardware acceleration (modern cards do) <LI>X loads the XVideo extension, it's something like this: <P><CODE> (II) Loading extension XVideo</CODE></P> @@ -131,7 +130,7 @@ to this: Adaptor #0: "Savage Streams Engine" number of ports: 1 port base: 43 - operations supported: PutImage + operations supported: PutImage supported visuals: depth 16, visualID 0x22 depth 16, visualID 0x23 @@ -222,27 +221,27 @@ what the DGA video output driver for mplayer can do (and what it can't).</P> <P><B><A NAME=2.3.1.3.2>2.3.1.3.2. What is DGA</A></B></P> <P>DGA is short for Direct Graphics Access and is a means for a program to -bypass the X-Server and directly modifying the framebuffer memory. +bypass the X-Server and directly modifying the framebuffer memory. Technically spoken this happens by mapping the framebuffer memory into the memory range of your process. This is allowed by the kernel only -if you have superuser privileges. You can get these either by logging in +if you have superuser privileges. You can get these either by logging in as root or by setting the suid bit on the mplayer excecutable (NOT recommended!).</P> -<P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was +<P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was introduced with XFree 4.0.1.</P> -<P>DGA1 provides only direct framebuffer access as described above. For -switching the resolution of the video signal you have to rely on the +<P>DGA1 provides only direct framebuffer access as described above. For +switching the resolution of the video signal you have to rely on the XVidMode extension.</P> <P>DGA2 incorporates the features of XVidMode extension and also allows -switching the depth of the display. So you may, although basically -running a 32 bit depth XServer, switch to a depth of 15 bits and vice +switching the depth of the display. So you may, although basically +running a 32 bit depth XServer, switch to a depth of 15 bits and vice versa. </P> <P>However DGA has some drawbacks. It seems it is somewhat dependent on the -graphics chip you use and on the implementation of the XServer's video +graphics chip you use and on the implementation of the XServer's video driver that controls this chip. So it does not work on every system ...</P> @@ -265,7 +264,7 @@ If you want to run it as user, then install <B>MPlayer</B> SUID root:</P> <P><CODE> chown root /usr/local/bin/mplayer<BR> - chmod 750 /usr/local/bin/mplayer<BR> + chmod 750 /usr/local/bin/mplayer<BR> chmod +s /usr/local/bin/mplayer</CODE></P> @@ -292,7 +291,7 @@ XServer only allows switching to resolutions predefined in <CODE>/etc/X11/XF86Config</CODE> (<CODE>/etc/X11/XF86Config-4</CODE> for XFree 4.0.X respectively). Those are defined by so-called modelines and depend on the capabilites of your video hardware. The XServer scans this config file on startup and -disables the modelines not suitable for your hardware. You can find +disables the modelines not suitable for your hardware. You can find out which modes survive with the X11 log file. It can be found at: <CODE>/var/log/XFree86.0.log</CODE>.</P> <P>See appendix A for some sample modeline definitions.</P> @@ -305,84 +304,84 @@ The above said is true for both; in the following sections I'll explain how the DGA driver for <B>MPlayer</B> works.</P> <P><B><A NAME=2.3.1.3.6>2.3.1.3.6. Features of the DGA driver</A></B></P> - + <P>The DGA driver is invoked by specifying -vo dga at the command line. -The default behaviour is to switch to a resolution matching the original -resolution of the video as close as possible. It deliberately ignores the --vm and -fs switches (enabling of video mode switching and fullscreen) - +The default behaviour is to switch to a resolution matching the original +resolution of the video as close as possible. It deliberately ignores the +-vm and -fs switches (enabling of video mode switching and fullscreen) - it always tries to cover as much area of your screen as possible by switching -the video mode, thus refraining to use a single additional cycle of your CPU +the video mode, thus refraining to use a single additional cycle of your CPU to scale the image. If you don't like the mode it chooses you may force it to choose the mode -matching closest the resolution you specify by -x and -y. -By providing the -v option, the DGA driver will print, among a lot of other -things, a list of all resolutions supported by your current XF86-Config +matching closest the resolution you specify by -x and -y. +By providing the -v option, the DGA driver will print, among a lot of other +things, a list of all resolutions supported by your current XF86-Config file. -Having DGA2 you may also force it to use a certain depth by using the -bpp -option. Valid depths are 15, 16, 24 and 32. It depends on your hardware -whether these depths are natively supported or if a (possibly slow) +Having DGA2 you may also force it to use a certain depth by using the -bpp +option. Valid depths are 15, 16, 24 and 32. It depends on your hardware +whether these depths are natively supported or if a (possibly slow) conversion has to be done.</P> - -<P>If you should be lucky enough to have enough offscreen memory left to -put a whole image there, the DGA driver will use doublebuffering, which + +<P>If you should be lucky enough to have enough offscreen memory left to +put a whole image there, the DGA driver will use doublebuffering, which results in much smoother movie replaying. It will tell you whether double- buffering is enabled or not.</P> <P>Doublebuffering means that the next frame of your video is being drawn in some offscreen memory while the current frame is being displayed. When the -next frame is ready, the graphics chip is just told the location in memory +next frame is ready, the graphics chip is just told the location in memory of the new frame and simply fetches the data to be displayed from there. -In the meantime the other buffer in memory will be filled again with new +In the meantime the other buffer in memory will be filled again with new video data.</P> -Doublebuffering may be switched on by using the option -double and may be -disabled with -nodouble. Current default option is to disable -doublebuffering. When using the DGA driver, onscreen display (OSD) only +Doublebuffering may be switched on by using the option -double and may be +disabled with -nodouble. Current default option is to disable +doublebuffering. When using the DGA driver, onscreen display (OSD) only works with doublebuffering enabled. However, enabling doublebuffering may result in a big speed penalty (on my K6-II+ 525 it used an additional 20% of CPU time!) depending on the implementation of DGA for your hardware.</P> - + <P><B><A NAME=2.3.1.3.7>2.3.1.3.7. Speed issues</A></B></P> <P>Generally spoken, DGA framebuffer access should be at least as fast as using the X11 driver with the additional benefit of getting a fullscreen image. -The percentage speed values printed by mplayer have to be interpreted with +The percentage speed values printed by mplayer have to be interpreted with some care, as for example, with the X11 driver they do not include the time -used by the X-Server needed for the actual drawing. Hook a terminal to a -serial line of your box and start top to see what is really going on in your +used by the X-Server needed for the actual drawing. Hook a terminal to a +serial line of your box and start top to see what is really going on in your box ...</P> -<P>Generally spoken, the speedup done by using DGA against 'normal' use of X11 -highly depends on your graphics card and how well the X-Server module for it +<P>Generally spoken, the speedup done by using DGA against 'normal' use of X11 +highly depends on your graphics card and how well the X-Server module for it is optimized.</P> -<P>If you have a slow system, better use 15 or 16bit depth since they require +<P>If you have a slow system, better use 15 or 16bit depth since they require only half the memory bandwidth of a 32 bit display.</P> -<P>Using a depth of 24bit is even a good idea if your card natively just supports +<P>Using a depth of 24bit is even a good idea if your card natively just supports 32 bit depth since it transfers 25% less data compared to the 32/32 mode.</P> - + <P>I've seen some avi files already be replayed on a Pentium MMX 266. AMD K6-2 CPUs might work at 400 MHZ and above.</P> <P><B><A NAME=2.3.1.3.8>2.3.1.3.8. Known bugs</A></B></P> -<P>Well, according to some developpers of XFree, DGA is quite a beast. They +<P>Well, according to some developpers of XFree, DGA is quite a beast. They tell you better not to use it. Its implementation is not always flawless with every chipset driver for XFree out there.</P> <P><UL> <LI>with XFree 4.0.3 and nv.o there is a bug resulting in strange colors -<LI>ATI driver requires to switch mode back more than once after finishing +<LI>ATI driver requires to switch mode back more than once after finishing using of DGA -<LI>some drivers simply fail to switch back to normal resolution (use +< |