[MPlayer-dev-eng] [PATCH] Some docs changes from XML
Andras Mohari
mayday at varoshaza.nagyatad.hu
Mon Aug 26 13:48:35 CEST 2002
Hi,
Here's a patch with some changes from the XML version (plus other
related changes):
* Replaced <UL> with <OL> where it made sense (to me :-)).
* Moved "Developer Cries" into the appendix (as Appendix F)
with s/Flame Wars/Developer Cries/ and
s/In medias res/Developer Cries/.
* Renamed "Appendix X" to "Appendix E".
* Put a "Hint" inside <BLOCKQUOTE>.
* Converted sound cards table, 3-pass encoding and mga_vid installation
instructions to lists.
* Converted options tables (video eq, SDL, fbdev, VESA, DXR3, TV input,
DivX4Linux, AAlib) to <DL> lists.
* The "sections" for MPsub and INSTALLING OSD are numbered and displayed
in the TOC now.
* Changed the text inside some <H4> tags.
Hopefully it won't break anything.
What is still missing:
* Tables with heads (mainly the tables displaying keys+actions).
To add heads, we should make those tables bordered and remove
the columns used for indenting. Comments?
* Some more notes could be put inside <BLOCKQUOTE>...?
* Anything else I haven't noticed...
--
Andras Mohari
mayday at mail.nagyatad.hu
-------------- next part --------------
diff -Naur DOCS.old/codecs.html DOCS/codecs.html
--- DOCS.old/codecs.html Fri Aug 23 13:03:03 2002
+++ DOCS/codecs.html Mon Aug 26 13:27:20 2002
@@ -73,15 +73,16 @@
<P>DivX4Linux works in two modes:</P>
-<TABLE BORDER=0>
- <TR><TD> </TD><TD VALIGN=top><CODE>-vc odivx</CODE></TD><TD> </TD>
- <TD>Uses the codec in OpenDivX fashion. In this case it
+<DL>
+ <DT><CODE>-vc odivx</CODE></DT>
+ <DD>Uses the codec in OpenDivX fashion. In this case it
produces YV12 images in its own buffer, and <B>MPlayer</B> does colorspace
- conversion via libvo. (<B>Fast, recommended!</B>)</TD></TR>
- <TR><TD></TD><TD VALIGN=top><CODE>-vc divx4</CODE></TD><TD></TD>
- <TD>Uses the colorspace conversion of the codec.
- In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
-</TABLE>
+ conversion via libvo. (<B>Fast, recommended!</B>)</DD>
+
+ <DT><CODE>-vc divx4</CODE></DT>
+ <DD>Uses the colorspace conversion of the codec.
+ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</DD>
+</DL>
<P>The <CODE>-vc odivx</CODE> method is usually faster, due to the fact that it
transfers image data in YV12 (planar YUV 4:2:0) format, thus requiring much
@@ -142,7 +143,7 @@
<P><B>MPlayer</B> is capable of employing the XAnim codecs for decoding. Follow
the instructions to enable them:</P>
-<UL>
+<OL>
<LI>Download the codecs you wish to use from the
<A HREF="http://xanim.va.pubnix.com">XAnim site</A>. The <B>3ivx</B> codec
is not there, but at the <A HREF="http://www.3ivx.com">3ivx site</A>.</LI>
@@ -153,7 +154,7 @@
the directory of the XAnim codecs.</LI>
<LI>Rename/symlink the files, cutting out the architecture stuff, so they will
have filenames like these: <CODE>vid_cvid.xa, vid_h263.xa, vid_iv50.xa</CODE>.</LI>
-</UL>
+</OL>
<P>XAnim is video codec family number 10, so you may want to use the <CODE>-vfm 10</CODE>
option to tell <B>MPlayer</B> to use them if possible.</P>
@@ -250,9 +251,7 @@
<LI>under development</LI>
</UL>
-<H4>Installation:</H4>
-
-<P>It is currently available only from CVS. Here are the
+<P>XViD is currently available only from CVS. Here are the
download and installation instructions:</P>
<OL>
@@ -284,9 +283,7 @@
<LI>SVQ3 is still not reverse engineered.</LI>
</UL>
-<H4>Installation:</H4>
-
-<P>It's compiled and usable per default.</P>
+<P>The Sorenson decoder is compiled and usable per default.</P>
<H3><A NAME="audio_codecs">2.2.2 Audio codecs</A></H3>
@@ -422,7 +419,7 @@
<P>Take a deep breath and start searching the registry...</P>
-<UL>
+<OL>
<LI>Start <CODE>regedit</CODE>.
<LI>Press <CODE>Ctrl-f</CODE>, disable the first two checkboxes, and enable
the third. Type in the fourcc of the codec (e.g. TM20).
@@ -435,7 +432,7 @@
If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
<LI>If the GUID is found you should see a FriendlyName and a CLSID
field. Write down the 16 byte CLSID, this is the GUID we need.
-</UL>
+</OL>
<P><B>Note:</B> If searching fails, try enabling all the checkboxes. You may have
false hits, but you may get lucky...</P>
diff -Naur DOCS.old/documentation.html DOCS/documentation.html
--- DOCS.old/documentation.html Fri Aug 23 13:05:11 2002
+++ DOCS/documentation.html Mon Aug 26 13:29:43 2002
@@ -35,6 +35,10 @@
<LI><A HREF="#installation">1.2 Installation</A></LI>
<LI><A HREF="#gui">1.3 What about the GUI?</A></LI>
<LI><A HREF="#subtitles_osd">1.4 Subtitles and OSD</A></LI>
+ <UL>
+ <LI><A HREF="#mpsub">1.4.1 MPlayer's own subtitle format (MPsub)</A></LI>
+ <LI><A HREF="#install_osd">1.4.2 Installing OSD and subtitles</A></LI>
+ </UL>
<LI><A HREF="#rtc">1.5 RTC</A></LI>
</UL>
</LI>
@@ -280,17 +284,14 @@
</UL>
</LI>
<LI><A HREF="#known_bugs">Appendix D - Known bugs</A></LI>
- <LI><A HREF="skin-en.html">Appendix X - MPlayer skin format</A></LI>
-</UL>
-
-<HR>
-Developer Cries
-<HR>
-
-<UL>
- <LI><A HREF="users_against_developers.html#gcc">1. GCC 2.96</A></LI>
- <LI><A HREF="users_against_developers.html#nvidia">2. NVidia opinions</A></LI>
- <LI><A HREF="users_against_developers.html#barr">3. About Joe Barr</A></LI>
+ <LI><A HREF="skin-en.html">Appendix E - MPlayer skin format</A></LI>
+ <LI><A HREF="users_against_developers.html">Appendix F - Developer Cries</A></LI>
+ <UL>
+ <LI><A HREF="users_against_developers.html#gcc">GCC 2.96</A></LI>
+ <LI><A HREF="users_against_developers.html#binary">Binary distribution of MPlayer</A></LI>
+ <LI><A HREF="users_against_developers.html#nvidia">NVidia opinions</A></LI>
+ <LI><A HREF="users_against_developers.html#barr">About Joe Barr</A></LI>
+ </UL>
</UL>
<HR>
@@ -422,7 +423,7 @@
<P>You need a fairly recent system. On Linux, 2.4.x kernels are recommended.</P>
-<H4>SOFTWARE REQUIREMENTS</H4>
+<H4>Software requirements:</H4>
<UL>
<LI><B>binutils</B> - suggested version is <B>2.11.x</B> . This program is
@@ -462,7 +463,7 @@
<LI><B>libvorbis</B> - optional, needed for playing OGG Vorbis audio.</LI>
</UL>
-<H4>CODECS</H4>
+<H4>Codecs:</H4>
<UL>
<LI><B>libavcodec</B>: This codec package is capable of decoding
@@ -647,7 +648,7 @@
</UL>
-<H4>SOUND CARDS</H4>
+<H4>Sound cards:</H4>
<UL>
<LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>)
@@ -662,7 +663,7 @@
section</A>!</U></LI>
</UL>
-<H4>FEATURES</H4>
+<H4>Features:</H4>
<UL>
<LI>Decide if you need GUI. If you do, see the <A HREF="#gui">GUI section</A>
@@ -768,28 +769,35 @@
The command line options differ slightly for the different formats:
-<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>,
- <CODE>sample.ifo</CODE>, <CODE>sample.idx</CODE> - you have to pass the
- <CODE>-vobsub sample -vobsubid
- <id></CODE> options (optionally with pathname, of course). The
- <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>
- 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>
-
-<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.</P>
+<DL>
+ <DT>VobSub subtitles</DT>
+ <DD>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>,
+ <CODE>sample.ifo</CODE>, <CODE>sample.idx</CODE> - you have to pass the
+ <CODE>-vobsub sample -vobsubid
+ <id></CODE> options (optionally with pathname, of course). The
+ <CODE>-vobsubid</CODE> option is like <CODE>-sid</CODE> for DVDs, you can
+ choose between subtitle tracks (languages) with it.</DD>
+
+ <DT>Other subtitles</DT>
+ <DD>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).</DD>
+</DL>
+
+<P><B>Adjusting subtitle timing and placement:</B></P>
+<DL>
+ <DT><CODE>-subdelay <sec></CODE></DT>
+ <DD>Delays subtitles by <sec> seconds. Can be negative.</DD>
+
+ <DT><CODE>-subfps <rate></CODE></DT>
+ <DD>Specify frame/sec rate of subtitle file (float number)</DD>
+
+ <DT><CODE>-subpos <0 - 100></CODE></DT>
+ <DD>Specify the position of subtitles.</DD>
+</DL>
<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
@@ -803,6 +811,9 @@
<P>About DVD subtitles, read the <A HREF="cd-dvd.html#dvd">DVD section</A>.</P>
+
+<H3><A NAME="mpsub">1.4.1 MPlayer's own subtitle format (MPsub)</A></H3>
+
<P><B>MPlayer</B> introduces a new subtitle format called <B>MPsub</B>. It was
designed by me (Gabucino). Basically its main feature is being
<I>dynamically</I> time-based (although it has frame-based mode too). Example
@@ -833,7 +844,7 @@
Display</B>. OSD is used to display current time, volume bar, seek bar
etc.</P>
-<H4>INSTALLING OSD and SUB</H4>
+<H3><A NAME="install_osd">1.4.2 Installing OSD and subtitles</A></H3>
<P>You need an <B>MPlayer</B> font package to be able to use OSD/SUB feature.
There are many ways to get it:</P>
@@ -958,105 +969,71 @@
<H3><A NAME="tv_compilation">2.5.1 Compilation</A></H3>
-<UL>
+<OL>
<LI>First, you have to recompile. <CODE>./configure</CODE> will autodetect
kernel headers of v4l stuff and the existence of <CODE>/dev/video*</CODE>
entries. If they exist, TV support will be built (see the output of
<CODE>./configure</CODE>).</LI>
<LI>Make sure your tuner works with another TV software in Linux, for example
xawtv.</LI>
-</UL>
+</OL>
-<P><B>Hint:</B> Are the colors messed up? Then your tuner cannot display
+<BLOCKQUOTE>
+ <B>Hint</B><BR>
+ Are the colors messed up? Then your tuner cannot display
in YV12 colorspace. Try I420 (<CODE>-vc rawi420</CODE>) or YUY2, UYVY, RGB32
(<CODE>-vo sdl</CODE>) colorspaces.
- You can specify these with the <CODE>outfmt=YV12</CODE> option, see below.</P>
+ You can specify these with the <CODE>outfmt=YV12</CODE> option, see below.
+</BLOCKQUOTE>
<H3><A NAME="tv_options">2.5.2 Available options</A></H3>
-<TABLE BORDER=0>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>on</CODE></TD>
- <TD> </TD>
- <TD>Use TV input.</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>noaudio</CODE></TD>
- <TD> </TD>
- <TD>No sound, thanks.</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>driver</CODE></TD>
- <TD></TD>
- <TD> <B>dummy</B> - NULL TV input :) Used for testing only, generates dummy
+<DL>
+ <DT><CODE>on</CODE></DT>
+ <DD>Use TV input.</DD>
+
+ <DT><CODE>noaudio</CODE></DT>
+ <DD>No sound, thanks.</DD>
+
+ <DT><CODE>driver</CODE></DT>
+ <DD><B>dummy</B> - NULL TV input :) Used for testing only, generates dummy
input.<BR>
<B>v4l</B> - Captures images from standard V4L interface (default
- <CODE>/dev/video0</CODE>).</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>device</CODE></TD>
- <TD> </TD>
- <TD>Specify a device other than the default <CODE>/dev/video0</CODE>.</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>input</CODE></TD>
- <TD> </TD>
- <TD>Specify from which input of the TV tuner you wish to grab
+ <CODE>/dev/video0</CODE>).</DD>
+
+ <DT><CODE>device</CODE></DT>
+ <DD>Specify a device other than the default <CODE>/dev/video0</CODE>.</DD>
+
+ <DT><CODE>input</CODE></DT>
+ <DD>Specify from which input of the TV tuner you wish to grab
(e.g. <B>television</B>, <B>s-video</B>, <B>composite</B>, ...)<BR>
- Prints the available ones during init.</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>freq</CODE></TD>
- <TD> </TD>
- <TD>Specify the frequency to set the tuner to (e.g. <B>511.250</B>).</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>outfmt</CODE></TD>
- <TD> </TD>
- <TD>Specify the output format the tuner should use to transport images to us
+ Prints the available ones during init.</DD>
+
+ <DT><CODE>freq</CODE></DT>
+ <DD>Specify the frequency to set the tuner to (e.g. <B>511.250</B>).</DD>
+
+ <DT><CODE>outfmt</CODE></DT>
+ <DD>Specify the output format the tuner should use to transport images to us
(<B>rgb32</B>, <B>rgb24</B>, <B>yv12</B>, <B>uyvy</B>, <B>i420</B> (for i420
you have to pass the <CODE>-vc rawi420</CODE> option, because of a fourcc
- conflict)).</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>width</CODE></TD>
- <TD> </TD>
- <TD>width of the output window in pixels</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>height</CODE></TD>
- <TD> </TD>
- <TD>height of the output window in pixels</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>norm</CODE></TD>
- <TD> </TD>
- <TD>available: PAL, SECAM, NTSC</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>channel</CODE></TD>
- <TD> </TD>
- <TD>Set the tuner to the given channel.</TD>
-</TR>
-<TR>
- <TD> </TD>
- <TD VALIGN="top"><CODE>chanlist</CODE></TD>
- <TD> </TD>
- <TD>available: <CODE>us-bcast, us-cable, europe-west, europe-east, etc</CODE></TD>
-</TR>
-</TABLE>
+ conflict)).</DD>
+
+ <DT><CODE>width</CODE></DT>
+ <DD>width of the output window in pixels</DD>
+
+ <DT><CODE>height</CODE></DT>
+ <DD>height of the output window in pixels</DD>
+
+ <DT><CODE>norm</CODE></DT>
+ <DD>available: PAL, SECAM, NTSC</DD>
+
+ <DT><CODE>channel</CODE></DT>
+ <DD>Set the tuner to the given channel.</DD>
+
+ <DT><CODE>chanlist</CODE></DT>
+ <DD>available: <CODE>us-bcast, us-cable, europe-west, europe-east, etc</CODE></DD>
+</DL>
<H3><A NAME="tv_keyboard">2.5.3 Keyboard control</A></H3>
@@ -1353,7 +1330,7 @@
<H3><A NAME="default_controls">3.2.1 Default controls</A></H3>
-<H4>Keyboard</H4>
+<H4>Keyboard controls from terminal:</H4>
<TABLE BORDER=0>
<TR><TD> </TD><TD><- or -></TD><TD> </TD><TD>seek backward/forward 10 seconds</TD></TR>
@@ -1377,7 +1354,7 @@
<TR><TD></TD><TD>7 or 8</TD><TD></TD><TD>adjust saturation</TD></TR>
</TABLE>
-<H4>GUI</H4>
+<H4>GUI keyboard controls:</H4>
<TABLE BORDER=0>
<TR><TD> </TD><TD>, and .</TD><TD> </TD><TD>previous / next file</TD></TR>
@@ -1394,7 +1371,7 @@
<TR><TD></TD><TD>m</TD><TD></TD><TD>toggle mute</TD></TR>
</TABLE>
-<H4>TV</H4>
+<H4>Keyboard controls for TV input:</H4>
<TABLE BORDER=0>
<TR><TD> </TD><TD>h or l</TD><TD> </TD><TD>select previous/next channel</TD></TR>
@@ -1434,7 +1411,7 @@
<P>You can have a full list by running <CODE>mplayer -input keylist</CODE></P>
-<H4>Keyboard</H4>
+<H4>Keyboard:</H4>
<UL>
<LI>Any printable character</LI>
@@ -1456,9 +1433,7 @@
<LI>DOWN</LI>
</UL>
-<H4>Mouse</H4>
-
-<P>Note: mouse is only supported under X</P>
+<H4>Mouse (only supported under X):</H4>
<UL>
<LI>MOUSE_BTN0 (Left button)</LI>
@@ -1470,9 +1445,7 @@
<LI>MOUSE_BTN9</LI>
</UL>
-<H4>Joystick</H4>
-
-<P>Note: joystick support must be enabled at compile time</P>
+<H4>Joystick (support must be enabled at compile time):</H4>
<UL>
<LI>JOY_RIGHT or JOY_AXIS0_PLUS</LI>
@@ -1481,7 +1454,7 @@
<LI>JOY_DOWN or JOY_AXIS1_PLUS</LI>
<LI>JOY_AXIS2_PLUS</LI>
<LI>JOY_AXIS2_MINUS</LI>
- <LI>....</LI>
+ <LI>...</LI>
<LI>JOY_AXIS9_PLUS</LI>
<LI>JOY_AXIS9_MINUS</LI>
</UL>
diff -Naur DOCS.old/encoding.html DOCS/encoding.html
--- DOCS.old/encoding.html Thu Aug 22 09:00:27 2002
+++ DOCS/encoding.html Mon Aug 26 13:33:32 2002
@@ -114,36 +114,30 @@
estimation of recommended video bitrate in order to fit on a CD. Also, the
audio is encoded only once, unlike in 2-pass mode. The schematics:</P>
-<TABLE>
- <TR>
- <TD><CODE>rm frameno.avi</CODE></TD>
- <TD><B>remove conflicting temporary file</B></TD>
- </TR>
- <TR>
- <TD><CODE>mencoder <file/DVD> -ovc frameno -o
- frameno.avi</CODE></TD>
- <TD><B><U>First pass:</U> an audio-only avi file will be created, containing
- ONLY the requested audio stream. Don't forget <CODE>-lameopts</CODE>, if
- you need to set it. If you were encoding a long movie, MEncoder prints
+<OL>
+ <LI>Remove conflicting temporary file:
+ <P><CODE>rm frameno.avi</CODE></P></LI>
+ <LI>First pass:
+ <P><CODE>mencoder <file/DVD> -ovc frameno -o frameno.avi</CODE></P>
+ <P>An audio-only avi file will be created, containing
+ <B>only</B> the requested audio stream. Don't forget <CODE>-lameopts</CODE>,
+ if you need to set it. If you were encoding a long movie, MEncoder prints
the recommended bitrate values for 650Mb, 700Mb, and 800Mb destination
- sizes, after this pass finishes.</B></TD>
- </TR>
- <TR>
- <TD><CODE>mencoder <file/DVD> -oac copy -pass 1
- -ovc divx4 -divx4opts br=<bitrate></CODE></TD>
- <TD><B><U>Second pass:</U> alias the first pass of DivX4 video encoding.
+ sizes, after this pass finishes.</P></LI>
+ <LI>Second pass:
+ <P><CODE>mencoder <file/DVD> -oac copy -pass 1
+ -ovc divx4 -divx4opts br=<bitrate></CODE></P>
+ <P>Alias the first pass of DivX4 video encoding.
Optionally specify the video bitrate MEncoder printed at the end of the
- previous pass.</B></TD>
- </TR>
- <TR>
- <TD><CODE>mencoder <file/DVD> -oac copy -pass 2
- -ovc divx4 -divx4opts br=<bitrate></CODE></TD>
- <TD><B><U>Third pass:</U> alias the second pass of DivX4 video encoding.
+ previous pass.</P></LI>
+ <LI>Third pass:
+ <P><CODE>mencoder <file/DVD> -oac copy -pass 2
+ -ovc divx4 -divx4opts br=<bitrate></CODE></P>
+ <P>Alias the second pass of DivX4 video encoding.
Optionally specify the video bitrate MEncoder printed at the end of the
previous pass. In this pass, audio from <CODE>frameno.avi</CODE> will be
- inserted into the destination file.. and it's all ready!</B></TD>
- </TR>
-</TABLE>
+ inserted into the destination file.. and it's all ready!</P></LI>
+</OL>
<H4>Example for 3-pass encoding:</H4>
@@ -264,15 +258,17 @@
files. With simple framecopy it can create MJPEG (Motion JPEG) or MPNG
(Motion PNG) files.</P>
-<H4>Explanation of the process</H4>
+<H4>Explanation of the process:</H4>
-<P><B>MEncoder</B> <I>decodes</I> the input image(s) with <CODE>libjpeg</CODE>
- (when decoding PNGs, it will use <B>libpng</B>).</P>
-
-<P><B>MEncoder</B> then feeds the decoded image to the chosen video compressor
- (DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as
- currently it can output only to RGB formats, thus can't be used with codecs
- that require YUV as input, like DivX4 or ffmpeg's msmpeg4.</P>
+<OL>
+ <LI><B>MEncoder</B> <I>decodes</I> the input image(s) with <CODE>libjpeg</CODE>
+ (when decoding PNGs, it will use <B>libpng</B>).</LI>
+
+ <LI><B>MEncoder</B> then feeds the decoded image to the chosen video compressor
+ (DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as
+ currently it can output only to RGB formats, thus can't be used with codecs
+ that require YUV as input, like DivX4 or ffmpeg's msmpeg4.</LI>
+</OL>
<H4>Examples</H4>
diff -Naur DOCS.old/sound.html DOCS/sound.html
--- DOCS.old/sound.html Fri Aug 23 13:06:02 2002
+++ DOCS/sound.html Mon Aug 26 10:09:32 2002
@@ -52,87 +52,110 @@
<H4><A NAME="experiences">2.3.2.1 Sound Card experiences, recommendations</A></H4>
-<TABLE BORDER=0 WIDTH="100%">
- <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR>
- <TR><TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">sourceforge.net</A></TD></TR>
-
- <TR><TD COLSPAN=3><B>Aureal Vortex 2</B></TD></TR>
- <TR><TD> </TD><TD>OSS:</TD><TD>no driver</TD></TR>
- <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
- <TR><TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD></TR>
- <TR><TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">Pontscho's page</A><BR>
- (<I>buffer size increased to 32k</I>)</TD></TR>
-
- <TR><TD COLSPAN=3><B>GUS PnP</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>no driver</TD></TR>
- <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
-
- <TR><TD COLSPAN=3><B>SB Live!</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>Both OK</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>192</TD></TR>
-
- <TR><TD COLSPAN=3><B>SB AWE 64</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>max 44kHz</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
-
- <TR><TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>not OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>44</TD></TR>
-
- <TR><TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
-
- <TR><TD COLSPAN=3><B>ESS 688</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
-
- <TR><TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
-
- <TR><TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
-
- <TR><TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>?</TD></TR>
- <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>?</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
-
- <TR><TD COLSPAN=3><B>PC Speaker or DAC</B></TD></TR>
- <TR><TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD></TR>
- <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
- <TR><TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD></TR>
- <TR><TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD></TR>
-</TABLE>
-
-<UL>
- <LI>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</LI>
- <LI>If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
- <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
- generally beneficial and described more detailed in the <A
- HREF="cd-dvd.html#drives">CD-ROM section</A>.</LI>
- <LI>Sharing your sound card with another application like XMMS is <B>strongly
- discouraged</B>! If the other sound application is using ESD, start
- <B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option to combine both
- sound streams. In fact, the option <CODE>-vo sdl:esd</CODE> could be used
- with ESD even when playing <B>Mplayer</B> alone.</LI>
- <LI>Feedback to this document is welcome. Please tell us how <B>MPlayer</B>
- and your sound card(s) worked together.</LI>
+<P><B>VIA onboard chipset (via82cxxx) 48kHz only</B></P>
+<UL>
+ <LI>Driver: from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">sourceforge.net</A></LI>
+</UL>
+
+<P><B>Aureal Vortex 2</B></P>
+<UL>
+ <LI>OSS: no driver</LI>
+ <LI>OSS/Pro: OK</LI>
+ <LI>ALSA: no driver</LI>
+ <LI>Max kHz: 48</LI>
+ <LI>Driver: <A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></LI>
+ <LI>Driver2: from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">Pontscho's page</A>
+ (<I>buffer size increased to 32k</I>)</LI>
+</UL>
+
+<P><B>GUS PnP</B></P>
+<UL>
+ <LI>OSS: no driver</LI>
+ <LI>OSS/Pro: OK</LI>
+ <LI>ALSA: OK</LI>
+ <LI>Max kHz: 48</LI>
+</UL>
+
+<P><B>SB Live!</B></P>
+<UL>
+ <LI>OSS: Analog OK, SP/DIF not working</LI>
+ <LI>ALSA: Both OK</LI>
+ <LI>Max kHz: 192</LI>
+</UL>
+
+<P><B>SB AWE 64</B></P>
+<UL>
+ <LI>OSS: max 44kHz</LI>
+ <LI>ALSA: 48kHz sounds bad</LI>
+ <LI>Max kHz: 48</LI>
+</UL>
+
+<P><B>Gravis UltraSound ACE</B></P>
+<UL>
+ <LI>OSS: not OK</LI>
+ <LI>ALSA: OK</LI>
+ <LI>Max kHz: 44</LI>
+</UL>
+
+<P><B>Gravis UltraSound MAX</B></P>
+<UL>
+ <LI>OSS: OK</LI>
+ <LI>ALSA: OK (?)</LI>
+ <LI>Max kHz: 48</LI>
</UL>
+
+<P><B>ESS 688</B></P>
+<UL>
+ <LI>OSS: OK</LI>
+ <LI>ALSA: OK (?)</LI>
+ <LI>Max kHz: 48</LI>
+</UL>
+
+<P><B>C-Media cards (which ones?)</B></P>
+<UL>
+ <LI>OSS: not OK (hissing) (?)</LI>
+ <LI>ALSA: OK (?)</LI>
+ <LI>Max kHz: ?</LI>
+</UL>
+
+<P><B>Yamaha cards (*ymf*)</B></P>
+<UL>
+ <LI>OSS: not OK (?) (maybe <CODE>-ao sdl</CODE>)</LI>
+ <LI>ALSA: OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</LI>
+ <LI>Max kHz: ?</LI>
+</UL>
+
+<P><B>Cards with envy24 chips (like Terratec EWS88MT)</B></P>
+<UL>
+ <LI>OSS: ?</LI>
+ <LI>OSS/Pro: OK</LI>
+ <LI>ALSA: ?</LI>
+ <LI>Max kHz: ?</LI>
+</UL>
+
+<P><B>PC Speaker or DAC</B></P>
+<UL>
+ <LI>OSS: OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</LI>
+ <LI>ALSA: no driver</LI>
+ <LI>Max kHz: The driver emulates 44.1, maybe more.</LI>
+ <LI>Driver: <A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></LI>
+</UL>
+
+<P>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</P>
+
+<P>If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
+ <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
+ generally beneficial and described more detailed in the <A
+ HREF="cd-dvd.html#drives">CD-ROM section</A>.</P>
+
+<P>Sharing your sound card with another application like XMMS is <B>strongly
+ discouraged</B>! If the other sound application is using ESD, start
+ <B>MPlayer</B> with the <CODE>-vo sdl:esd</CODE> option to combine both
+ sound streams. In fact, the option <CODE>-vo sdl:esd</CODE> could be used
+ with ESD even when playing <B>Mplayer</B> alone.</P>
+
+<P>Feedback to this document is welcome. Please tell us how <B>MPlayer</B>
+ and your sound card(s) worked together.</P>
<H4><A NAME="plugins">2.3.2.2 Audio plugins</A></H4>
diff -Naur DOCS.old/users_against_developers.html DOCS/users_against_developers.html
--- DOCS.old/users_against_developers.html Fri Aug 23 13:06:02 2002
+++ DOCS/users_against_developers.html Mon Aug 26 10:18:33 2002
@@ -2,7 +2,7 @@
<HTML>
<HEAD>
- <TITLE>Flame Wars - MPlayer - The Movie Player for Linux</TITLE>
+ <TITLE>Developer Cries - MPlayer - The Movie Player for Linux</TITLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
</HEAD>
@@ -10,7 +10,7 @@
<BODY>
-<H1>In medias res</H1>
+<H1>Appendix F - Developer Cries</H1>
<P>There are two major topics which always cause huge dispute and flame on the
<A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
@@ -74,7 +74,7 @@
use 3.1 instead of 2.96. If you do not want to or cannot use the binary
packages, here is how you can compile GCC 3.1 from source:</P>
-<UL>
+<OL>
<LI>Go to the <A HREF="http://gcc.gnu.org/mirrors.html">GCC mirrors page</A>
page and download <CODE>gcc-core-3.1.tar.gz</CODE>. This includes the
complete C compiler and is sufficient for <B>MPlayer</B>. If you also want
@@ -94,7 +94,7 @@
<CODE>make bootstrap</CODE></LI>
<LI>Now you can install GCC (as root) by typing<BR>
<CODE>make install</CODE></LI>
-</UL>
+</OL>
<H2><A NAME="binary">Binary distribution of MPlayer</A></H2>
diff -Naur DOCS.old/video.html DOCS/video.html
--- DOCS.old/video.html Fri Aug 23 13:08:01 2002
+++ DOCS/video.html Mon Aug 26 13:35:16 2002
@@ -462,24 +462,29 @@
<P>SDL video output supports displaying subtitles under the movie, on the (if
present) black bar.</P>
-<P>Here are some notes about SDL out in <B>MPlayer</B>.</P>
+<P><B>There are several command line switches for SDL:</B></P>
+<DL>
+ <DT><CODE>-vo sdl:name</CODE></DT>
+ <DD>specifies sdl video driver to use (i.e.. aalib, dga, x11)</DD>
+
+ <DT><CODE>-ao sdl:name</CODE></DT>
+ <DD>specifies sdl audio driver to use (i.e. dsp, esd, arts)</DD>
+
+ <DT><CODE>-noxv</CODE></DT>
+ <DD>disables XVideo hardware acceleration</DD>
+
+ <DT><CODE>-forcexv</CODE></DT>
+ <DD>tries to force XVideo acceleration</DD>
+</DL>
<TABLE BORDER=0>
- <TR><TD COLSPAN=4><P><B>There are several command line switches for SDL:</B></P></TD></TR>
- <TR><TD> </TD><TD><CODE>-vo sdl:name</CODE></TD><TD> </TD><TD>
- specifies sdl video driver to use (i.e.. aalib, dga, x11)</TD></TR>
- <TR><TD></TD><TD><CODE>-ao sdl:name</CODE></TD><TD></TD><TD>specifies sdl audio driver to use (i.e.. dsp,
- esd, arts)</TD></TR>
- <TR><TD></TD><TD><CODE>-noxv</CODE></TD><TD></TD><TD>disables XVideo hardware acceleration</TD></TR>
- <TR><TD></TD><TD><CODE>-forcexv</CODE></TD><TD></TD><TD>tries to force XVideo acceleration</TD></TR>
-
<TR><TD COLSPAN=4><P><B>SDL Keys:</B></P></TD></TR>
<TR><TD></TD><TD><CODE>F</CODE></TD><TD></TD><TD>toggles fullscreen/windowed mode</TD></TR>
<TR><TD></TD><TD><CODE>C</CODE></TD><TD></TD><TD>cycles available fullscreen modes</TD></TR>
<TR><TD></TD><TD><CODE>W/S</CODE></TD><TD></TD><TD>mappings for * and / (mixer control)</TD></TR>
</TABLE>
-<H4>KNOWN BUGS:</H4>
+<H4>Known bugs:</H4>
<UL>
<LI>Keys pressed under sdl:aalib console driver repeat forever. (use -vo aa!)
@@ -537,15 +542,21 @@
<P>The FBdev output takes some additional parameters above the others:</P>
-<TABLE BORDER=0>
- <TR><TD> </TD><TD><CODE>-fb</CODE></TD><TD> </TD><TD>
- specify the framebuffer device to use (/dev/fb0)</TD></TR>
- <TR><TD></TD><TD><CODE>-fbmode</CODE></TD><TD></TD><TD>mode name to use (according to /etc/fb.modes)</TD></TR>
- <TR><TD></TD><TD><CODE>-fbmodeconfig</CODE></TD><TD></TD><TD> config file of modes (default /etc/fb.modes)</TD></TR>
- <TR><TD></TD><TD><CODE>-monitor_hfreq</CODE></TD><TD></TD><TD ROWSPAN=3>IMPORTANT values, see example.conf</TD></TR>
- <TR><TD></TD><TD><CODE>-monitor_vfreq</CODE></TD><TD></TD></TR>
- <TR><TD></TD><TD><CODE>-monitor_dotclock</CODE></TD><TD></TD></TR>
-</TABLE>
+<DL>
+ <DT><CODE>-fb</CODE></DT>
+ <DD>specify the framebuffer device to use (/dev/fb0)</DD>
+
+ <DT><CODE>-fbmode</CODE></DT>
+ <DD>mode name to use (according to /etc/fb.modes)</DD>
+
+ <DT><CODE>-fbmodeconfig</CODE></DT>
+ <DD>config file of modes (default /etc/fb.modes)</DD>
+
+ <DT><CODE>-monitor_hfreq</CODE></DT>
+ <DT><CODE>-monitor_vfreq</CODE></DT>
+ <DT><CODE>-monitor_dotclock</CODE></DT>
+ <DD><STRONG>Important</STRONG> values, see <CODE>example.conf</CODE></DD>
+</DL>
<P>If you want to change to a specific mode, then use</P>
@@ -580,40 +591,31 @@
<P><B>WARNING</B>: on non-Linux systems, use <A HREF="#vidix">VIDIX</A> for
mga_vid!</P>
-<P>To use it, you first have to compile mga_vid.o:</P>
-
-<P><CODE> cd drivers<BR>
- make</CODE></P>
-
-<P>Then create /dev/mga_vid device:</P>
-
-<P><CODE> mknod /dev/mga_vid c 178 0</CODE></P>
-
-<P>and load the driver with</P>
-
-<P><CODE> insmod mga_vid.o</CODE></P>
-
-<P>You should verify the memory size detection using the 'dmesg' command. If
- it's bad, use the mga_ram_size option (rmmod mga_vid first), specify card's
- memory size in MB:</P>
-
-<P><CODE> insmod mga_vid.o mga_ram_size=16</CODE></P>
-
-<P>To make it load/unload automatically when needed, first insert the following line
- at the end of /etc/modules.conf:</P>
-
-<P><CODE> alias char-major-178 mga_vid</CODE></P>
-
-<P>Then copy the <CODE>mga_vid.o</CODE> module to the appropriate place under
- <CODE>/lib/modules/<kernel version>/somewhere</CODE>.</P>
-
-<P>Then run</P>
-
-<P><CODE> depmod -a</CODE></P>
-
-<P>Now you have to (re)compile <B>MPlayer</B>, ./configure will detect /dev/mga_vid
- and build the 'mga' driver. Using it from <B>MPlayer</B> goes by '-vo mga' if
- you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x.</P>
+<P><B>Installation:</B></P>
+<OL>
+ <LI>To use it, you first have to compile mga_vid.o:
+ <P><CODE>cd drivers<BR>
+ make</CODE></P></LI>
+ <LI>Then create the <CODE>/dev/mga_vid</CODE> device:
+ <P><CODE>mknod /dev/mga_vid c 178 0</CODE></P>
+ <P>and load the driver with</P>
+ <P><CODE>insmod mga_vid.o</CODE></P></LI>
+ <LI>You should verify the memory size detection using the 'dmesg' command. If
+ it's bad, use the mga_ram_size option (rmmod mga_vid first), specify card's
+ memory size in MB:
+ <P><CODE>insmod mga_vid.o mga_ram_size=16</CODE></P></LI>
+ <LI>To make it load/unload automatically when needed, first insert the
+ following line at the end of <CODE>/etc/modules.conf</CODE>:
+ <P><CODE>alias char-major-178 mga_vid</CODE></P>
+ <P>Then copy the <CODE>mga_vid.o</CODE> module to the appropriate place
+ under <CODE>/lib/modules/<kernel version>/somewhere</CODE>.</P>
+ <P>Then run</P>
+ <P><CODE>depmod -a</CODE></P></LI>
+ <LI>Now you have to (re)compile <B>MPlayer</B>, ./configure will detect
+ <CODE>/dev/mga_vid</CODE> and build the 'mga' driver. Using it from
+ <B>MPlayer</B> goes by <CODE>-vo mga</CODE> if you have matroxfb console,
+ or <CODE>-vo xmga</CODE> under XFree86 3.x.x or 4.x.x.</LI>
+</OL>
<P>The mga_vid driver cooperates with Xv.</P>
@@ -674,20 +676,35 @@
<TR><TD></TD><TD><CODE>6</CODE></TD><TD></TD><TD>set dithering mode (none, error distribution, Floyd Steinberg)</TD></TR>
<TR><TD></TD><TD><CODE>7</CODE></TD><TD></TD><TD>invert image</TD></TR>
<TR><TD></TD><TD><CODE>a</CODE></TD><TD></TD><TD>toggles between aa and <B>MPlayer</B> control)</TD></TR>
-
- <TR><TD COLSPAN=4><P><B>The following command line options can be used:</B></P></TD></TR>
- <TR><TD></TD><TD><CODE>-aaosdcolor=V</CODE></TD><TD></TD><TD>change OSD color</TD></TR>
- <TR><TD></TD><TD><CODE>-aasubcolor=V</CODE></TD><TD></TD><TD>change subtitle color</TD></TR>
- <TR><TD COLSPAN=3></TD><TD><P><I>where V can be: (0/normal, 1/dark, 2/bold,
- 3/bold font, 4/reverse, 5/special)</I></P></TD></TR>
- <TR><TD COLSPAN=4><P><B>AAlib itself provides a large sum of options.
- Here are some important:</B></P></TD></TR>
- <TR><TD></TD><TD><CODE>-aadriver</CODE></TD><TD></TD><TD>set recommended aa driver (X11, curses, Linux)</TD></TR>
- <TR><TD></TD><TD><CODE>-aaextended</CODE></TD><TD></TD><TD>use all 256 characters</TD></TR>
- <TR><TD></TD><TD><CODE>-aaeight</CODE></TD><TD></TD><TD>use eight bit ASCII</TD></TR>
- <TR><TD></TD><TD><CODE>-aahelp</CODE></TD><TD></TD><TD>prints out all aalib options</TD></TR>
</TABLE>
+<P><B>The following command line options can be used:</B></P>
+<DL>
+ <DT><CODE>-aaosdcolor=V</CODE></DT>
+ <DD>change OSD color</DD>
+
+ <DT><CODE>-aasubcolor=V</CODE></DT>
+ <DD>change subtitle color
+ <P><I>where V can be: (0/normal, 1/dark, 2/bold, 3/bold font, 4/reverse,
+ 5/special)</I></P></DD>
+</DL>
+
+<P><B>AAlib itself provides a large sum of options.
+ Here are some important:</B></P>
+<DL>
+ <DT><CODE>-aadriver</CODE></DT>
+ <DD>set recommended aa driver (X11, curses, Linux)</DD>
+
+ <DT><CODE>-aaextended</CODE></DT>
+ <DD>use all 256 characters</DD>
+
+ <DT><CODE>-aaeight</CODE></DT>
+ <DD>use eight bit ASCII</DD>
+
+ <DT><CODE>-aahelp</CODE></DT>
+ <DD>prints out all aalib options</DD>
+</DL>
+
<P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X
(using aalib on X), and it's least CPU intensive on standard,
non-framebuffer console. Use SVGATextMode to set up a big textmode,
@@ -759,22 +776,33 @@
<P>Don't use this driver with <B>GCC 2.96</B>! It won't work!</P>
-<TABLE BORDER=0>
- <TR><TD COLSPAN=4><P><B>These switches of command line currently are available for VESA:</B></P></TD></TR>
- <TR><TD> </TD><TD VALIGN="top"><CODE>-vo vesa:opts</CODE></TD><TD></TD>
- <TD>currently recognized: <B>dga</B> to force dga mode and <B>nodga</B> to
+<P><B>Command line options available for VESA:</B></P>
+<DL>
+ <DT><CODE>-vo vesa:opts</CODE></DT>
+ <DD>currently recognized: <B>dga</B> to force dga mode and <B>nodga</B> to
disable dga mode. Note: you may omit these parameters to enable <B>autodetect</B>
of dga mode. (In the future also will specify mode parameters such as refresh
- rate, interlacing, doublescan and so on. Samples: i43, 85, d100)</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-screenw, -screenh, -bpp</CODE></TD><TD></TD><TD>force userdefined mode</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-x, -y</CODE></TD><TD></TD><TD>set userdefined prescaling</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-zoom</CODE></TD><TD></TD><TD>enables userdefined prescaling</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-fs</CODE></TD><TD></TD><TD>scales image to fullscreen</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-fs -zoom</CODE></TD><TD></TD><TD>scales userdefined prescaling to fullscreen</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-double</CODE></TD><TD></TD><TD>enables
- double buffering mode. (Available only in DGA mode). Should be slower of
- single buffering, but has no flickering effects.</TD></TR>
-</TABLE>
+ rate, interlacing, doublescan and so on. Samples: i43, 85, d100)</DD>
+
+ <DT><CODE>-screenw, -screenh, -bpp</CODE></DT>
+ <DD>force userdefined mode</DD>
+
+ <DT><CODE>-x, -y</CODE></DT>
+ <DD>set userdefined prescaling</DD>
+
+ <DT><CODE>-zoom</CODE></DT>
+ <DD>enables userdefined prescaling</DD>
+
+ <DT><CODE>-fs</CODE></DT>
+ <DD>scales image to fullscreen</DD>
+
+ <DT><CODE>-fs -zoom</CODE></DT>
+ <DD>scales userdefined prescaling to fullscreen</DD>
+
+ <DT><CODE>-double</CODE></DT>
+ <DD>enables double buffering mode. (Available only in DGA mode). Should be
+ slower of single buffering, but has no flickering effects.</DD>
+</DL>
<H4>Known problems and workaround:</H4>
@@ -830,8 +858,6 @@
<H4><A NAME="vidix">2.3.1.14 VIDIX</A></H4>
-<H4>WHAT IS VIDIX?</H4>
-
<P>VIDIX is the abbreviation for <B>VID</B>eo <B>I</B>nterface for
*ni<B>X</B>.<BR>
VIDIX was designed and introduced as an interface for fast user-space drivers
@@ -920,27 +946,33 @@
by command line arguments. <B>MPlayer</B> recognizes the
following options:</P>
-<TABLE>
- <TR><TD> </TD><TD VALIGN="top"><CODE>-brightness</CODE></TD><TD> </TD>
- <TD>Adjust <B>BRIGHTNESS</B> of video output. It's not equal to brightness
+<DL>
+ <DT><CODE>-brightness</CODE></DT>
+ <DD>Adjust <B>BRIGHTNESS</B> of video output. It's not equal to brightness
adjusting on monitor panel or on TV. It changes intensity of RGB components of
- video signal from black to white screen.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-contrast</CODE></TD><TD></TD>
- <TD>Adjust <B>CONTRAST</B> of video output. Works in similar manner as
- brightness.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-saturation</CODE></TD>
- <TD></TD><TD>Adjust <B>SATURATION</B> of video output. You can get grayscale
- output with this option.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-hue</CODE></TD>
- <TD></TD><TD>Adjust <B>HUE</B> of video signal. You can get colored negative
- of image with this option.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-red_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>RED</B> component of video signal.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-green_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>GREEN</B> component of video signal.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-blue_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>BLUE</B> component of video signal.</TD></TR>
-</TABLE>
+ video signal from black to white screen.</DD>
+
+ <DT><CODE>-contrast</CODE></DT>
+ <DD>Adjust <B>CONTRAST</B> of video output. Works in similar manner as
+ brightness.</DD>
+
+ <DT><CODE>-saturation</CODE></DT>
+ <DD>Adjust <B>SATURATION</B> of video output. You can get grayscale
+ output with this option.</DD>
+
+ <DT><CODE>-hue</CODE></DT>
+ <DD>Adjust <B>HUE</B> of video signal. You can get colored negative
+ of image with this option.</DD>
+
+ <DT><CODE>-red_intensity</CODE></DT>
+ <DD>Adjust intensity of <B>RED</B> component of video signal.</DD>
+
+ <DT><CODE>-green_intensity</CODE></DT>
+ <DD>Adjust intensity of <B>GREEN</B> component of video signal.</DD>
+
+ <DT><CODE>-blue_intensity</CODE></DT>
+ <DD>Adjust intensity of <B>BLUE</B> component of video signal.</DD>
+</DL>
<P>Each parameter can accept values from <B>-1000</B> to <B>+1000</B>.<BR>
Default value for each parameter is <B>0</B>.</P>
@@ -1104,11 +1136,10 @@
Linux</A> site. Configure should detect your card automatically, compilation
should go without any problems.</P>
-<H4>USAGE</H4>
-
-<TABLE>
- <TR><TD> </TD><TD VALIGN="top"><CODE>-vo dxr3:<noprebuf>:<codec>:<device></CODE></TD><TD> </TD>
- <TD>Where <CODE><noprebuf></CODE> specifies turning off prebuffering.
+<H4>Usage:</H4>
+<DL>
+ <DT><CODE>-vo dxr3:<noprebuf>:<codec>:<device></CODE></DT>
+ <DD>Where <CODE><noprebuf></CODE> specifies turning off prebuffering.
This is done automatically on Athlons. If playback is out of sync try
disabling prebuffering. If noprebuf is left out prebuffering is enabled
(except on Athlons).
@@ -1123,21 +1154,25 @@
<BR>
Any of these options may be left out, but they must be specified in this
order, i.e. <CODE>dxr3:fame</CODE> works, <CODE>dxr3:1</CODE> works, but
- <CODE>dxr3:1:avcodec</CODE> will not.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-ao oss:/dev/em8300_ma-X</CODE></TD>
- <TD></TD><TD>For audio output, where <CODE>X</CODE> is the device number
- (0 if one card).</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-ac hwac3</CODE></TD>
- <TD></TD><TD>For digital instead of analog audio output.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-vc mpegpes</CODE></TD>
- <TD></TD><TD>Force hardware acceleration, only works with MPEG1/2.</TD></TR>
- <TR><TD></TD><TD VALIGN="top"><CODE>-aop list=resample:fout=xxxxx</CODE></TD>
- <TD></TD><TD>If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
+ <CODE>dxr3:1:avcodec</CODE> will not.</DD>
+
+ <DT><CODE>-ao oss:/dev/em8300_ma-X</CODE></DT>
+ <DD>For audio output, where <CODE>X</CODE> is the device number
+ (0 if one card).</DD>
+
+ <DT><CODE>-ac hwac3</CODE></DT>
+ <DD>For digital instead of analog audio output.</DD>
+
+ <DT><CODE>-vc mpegpes</CODE></DT>
+ <DD>Force hardware acceleration, only works with MPEG1/2.</DD>
+
+ <DT><CODE>-aop list=resample:fout=xxxxx</CODE></DT>
+ <DD>If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
depending on which one matches closest. I.e. if the movie uses 22050Hz use
44100Hz as 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000
and so on. This does not work with digital audio output
- (<CODE>-ac hwac3</CODE>).</TD></TR>
-</TABLE>
+ (<CODE>-ac hwac3</CODE>).</DD>
+</DL>
<H4>Overlay</H4>
@@ -1187,7 +1222,7 @@
You have to enable ALL matroxfb-specific feature during compilation (except
MultiHead), and compile them into <B>modules</B>! You'll also need I2C
enabled.
- <UL>
+ <OL>
<LI>
Enter <CODE>TVout/matroxset</CODE> and type <CODE>make</CODE>. Install
<CODE>matroxset</CODE> into somewhere in your PATH.</LI>
@@ -1206,7 +1241,7 @@
the TV (PAL) picture has some weird stripes on it, the script wasn't able to
set the resolution correctly (to 640x512 by default). Use other menu
items randomly and it'll be OK :)</LI>
- </UL>
+ </OL>
<P>Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear,
and turn off screen blanking. Execute the following commands:</P>
More information about the MPlayer-dev-eng
mailing list