Update of /cvsroot/mplayer/main/DOCS In directory mail:/var/tmp.root/cvs-serv20801 Modified Files: codecs.html documentation.html encoding.html sound.html users_against_developers.html video.html Log Message: Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some small additions. * 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 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. Index: codecs.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/codecs.html,v retrieving revision 1.80 retrieving revision 1.81 diff -u -r1.80 -r1.81 --- codecs.html 23 Aug 2002 10:50:19 -0000 1.80 +++ codecs.html 27 Aug 2002 18:06:07 -0000 1.81 @@ -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> Index: documentation.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v retrieving revision 1.296 retrieving revision 1.297 diff -u -r1.296 -r1.297 --- documentation.html 27 Aug 2002 01:31:57 -0000 1.296 +++ documentation.html 27 Aug 2002 18:06:07 -0000 1.297 @@ -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</A></LI> + <LI><A HREF="users_against_developers.html#nvidia">nVidia</A></LI> + <LI><A HREF="users_against_developers.html#barr">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 @@ -533,7 +534,7 @@ installation instructions and more information.</LI> </UL> -<H4>VIDEO CARDS</H4> +<H4>Video Cards</H4> <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> @@ -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,8 +769,9 @@ 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 +<H4>VobSub subtitles</H4> + +<P>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 @@ -778,18 +780,25 @@ <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> +<H4>Other subtitles</H4> + +<P>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> +<H4>Adjusting subtitle timing and placement:</H4> + +<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 +812,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 +845,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 +970,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 +1331,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 +1355,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 +1372,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 +1412,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 +1434,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 +1446,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 +1455,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> Index: encoding.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/encoding.html,v retrieving revision 1.62 retrieving revision 1.63 diff -u -r1.62 -r1.63 --- encoding.html 21 Aug 2002 22:58:19 -0000 1.62 +++ encoding.html 27 Aug 2002 18:06:07 -0000 1.63 @@ -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 - 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. - 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. - 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> +<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, <B>MEncoder</B> + prints the recommended bitrate values for 650Mb, 700Mb, and 800Mb + destination 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 <B>MEncoder</B> printed at the end of + the 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 <B>MEncoder</B> 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!</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> +Explanation of the process: -<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> Index: sound.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/sound.html,v retrieving revision 1.51 retrieving revision 1.52 diff -u -r1.51 -r1.52 --- sound.html 23 Aug 2002 10:50:19 -0000 1.51 +++ sound.html 27 Aug 2002 18:06:07 -0000 1.52 @@ -119,20 +119,21 @@ <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> -</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> Index: users_against_developers.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/users_against_developers.html,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- users_against_developers.html 27 Aug 2002 08:12:58 -0000 1.31 +++ users_against_developers.html 27 Aug 2002 18:06:07 -0000 1.32 @@ -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,14 +10,14 @@ <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> mailing list. Number one is the topic of the</P> -<H2><A NAME="gcc">GCC 2.96 series</A></H2> +<H2><A NAME="gcc">GCC 2.96</A></H2> <P><B>The background:</B> The GCC <B>2.95</B> series is an official GNU release and version 2.95.3 of GCC is the most bug-free in that series. @@ -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,10 +94,10 @@ <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> +<H2><A NAME="binary">Binary distribution</A></H2> <P>This was the second big problem but has been solved as of version 0.90-pre1. <B>MPlayer</B> previously contained source from the OpenDivX project, Index: video.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/video.html,v retrieving revision 1.94 retrieving revision 1.95 diff -u -r1.94 -r1.95 --- video.html 23 Aug 2002 10:50:19 -0000 1.94 +++ video.html 27 Aug 2002 18:06:07 -0000 1.95 @@ -40,7 +40,7 @@ <CODE>01:00.0 VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE> <CODE>Memory at d8000000 (32-bit, prefetchable)</CODE> </P></LI> - <LI>from mga_vid kernel driver messages (use dmesg): + <LI>from mga_vid kernel driver messages (use <CODE>dmesg</CODE): <P><CODE>mga_mem_base = d8000000</CODE></P></LI> </UL> @@ -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 <CODE>dmesg</CODE> + command. If it's bad, use the <CODE>mga_ram_size</CODE> option + (<CODE>rmmod mga_vid</CODE> 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>, <CODE>configure</CODE> 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>