refresh and charset settings

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6041 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
nell 2002-05-10 11:17:41 +00:00
parent a07a3f976d
commit 6f6ba55b51
14 changed files with 3897 additions and 2597 deletions

View File

@ -1,4 +1,3 @@
Kilka s³ów o obs³udze karty Siemens-DVB. autor: A'rpi
========================================

View File

@ -1,5 +1,5 @@
<HTML>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
<META http-equiv="content-type" content="text/html; charset=iso-8859-2">
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>

View File

@ -1,17 +1,27 @@
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
</HEAD>
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<FONT CLASS="text">
<P><B><A NAME=4.1>4.1. CD-ROM drives</A></B></P>
<P>Playing standard Video CDs:</P>
<P>
mplayer -vcd <I>trackno</I> [device]<BR><BR>
mplayer -vcd <I>trackno</I> [-cdrom-device device]<BR><BR>
Examples:<BR>
mplayer -vcd 1<BR>
mplayer -fs -vcd 2 /dev/hdc<BR>
mplayer -fs -vcd 2 -cdrom-device /dev/hdc<BR>
</P>
<P>
@ -64,79 +74,61 @@ CDROM.</P>
<P><B><A NAME=4.2>4.2. DVD playback</A></B></P>
<P>Yes, the real DVD support has been arrived. You don't need to play VOB files
manually from disk thinking of the purpose of a file in the video_ts
directory, you don't need worry it it's an encrypted disk or not (in old
<B>MPlayer</B> you had to put '-dvdauth /dev/dvd' into the command line in case
of encrypted discs), and you don't need even mount your disk to be able to
play :)</P>
<P>IMPORTANT NOTE: please _DO_NOT_ require further features for DVD playback.
This is the first version of some real DVD support inside <B>MPlayer</B> and
we're busy with hunting bugs and implementing basic DVD player features.</P>
<P><B>MPlayer</B> uses <CODE>libdvdread</CODE> and <CODE>libdvdcss</CODE> for
DVD decryption and playing. These two libraries are contained in the
<CODE>libmpdvdkit/</CODE> subdirectory in the <B>MPlayer</B> tree, you
don't have to install them separately. We opt for this solution because
we had to fix a libdvdread bug, and apply a patch which adds
<B>cracked CSS keys caching support</B> for libdvdcss (results in large
speed increase before playing). These cracked keys are stored in
<CODE>$HOME/.mplayer/DVDKeys</CODE> directory.</P>
<P><B>MPlayer</B> uses libdvdread which has got built in support for IFO
parsing, reading navi blocks and doing authentication/descrambling. libdvdread
uses libdvdcss to the latter tasks. So you will need libdvdcss and libdvdread
downloaded, compiled and installed BEFORE you run ./configure script of
<B>MPlayer</B> which will autodetect libdvdread for you in this way.</P>
<P>Support for <CODE>dvdnav</CODE> is being added (not usable now).</P>
<UL>
<LI><P><B>Download source of libdvdread and libdvdcss.</B></P>
<P><I>You can download them from
<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A>
(click 'download' in the menu at the left, and you can find libdvdcss and
libdvdread in a table).</I></P>
<LI><P><B>Old-style DVD support - <I>OPTIONAL</I></B></P>
<P><B><I>IMPORTANT !</I></B><BR>
For
<UL>
<LI>libdvdread 0.8 - you'll need <B>libcss</B> instead of libdvdcss</LI>
<LI>libdvdread 0.9 - you'll need <B>libdvdcss 0.0.3</B> ! Don't use newer
versions, they won't work!</LI>
<LI>For example <B><U>never</U></B> use libdvdcss <B>1.0</B>, it will be unusably slow!</LI>
</UL>
</P>
</LI>
<LI><P><B>Compile and install libdvdcss THEN libdvdread.</B></P>
<P><I>Read documentation of these packages to do this step easily.</I></P></LI>
<LI><P><B>Recompile MPlayer.</B></P>
<P><I>Run <CODE>./configure</CODE>. If you install libdvdread correctly, ./configure
says something similar:<BR><CODE>Checking for DVDread support ... yes</CODE><BR>
(Of course you can put your favourite configure options into the command
line when you run ./configure). That's it! Say: <CODE>make</CODE>, then <CODE>make install</CODE>.</I></P></LI>
</UL>
<P><I>Useful if you want to play encoded VOB's from hard disk. Compile and
install <B>libcss</B> 0.0.1 (not newer) (if <B>MPlayer</B> can't detect
it, use the <CODE>-csslib /path/to/libcss.so</CODE> option).</P></LI>
<P>Of course after installing libdvdcss and libdvdread you don't need recompile
them at each time when you want to recompile <B>MPlayer</B> (from a new CVS version
for example) since the needed packages have already been installed on your
machine.</P>
<LI><P><B>Compile MPlayer.</B></P>
<P>Run <CODE>./configure</CODE>. If you didn't delete
<CODE>libmpdvdkit</CODE> subdirectory from MPlayer tree, ./configure should
say the following:</P>
<P><CODE>Checking for DVD support (libmpdvdkit) ... yes</CODE></P>
<P>(of course you can put your favourite configure options into the command
line when you run ./configure)</P>
<P><B>MPlayer</B> can use <CODE>libdvdread</CODE> and <CODE>libdvdcss</CODE>
libraries installed system-wide, but this solution is NOT RECOMMENDED, as
can result in bugs, library incompatibilities, and slower speed.</P>
<P>Either way, say: <CODE>make</CODE>, then <CODE>make install</CODE>.</P>
<P><B>Using MPlayer to play DVDs:</B></P>
<TABLE BORDER=0 WIDTH=100%>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-dvd &lt;title_id&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Enables DVD support and selects title.</TD><TR>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-chapter &lt;chapter_id&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Selects DVD chapter (default: play from chapter 1)</TD><TR>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-dvdangle &lt;angle_id&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Selects camera angle (default: 1)</TD><TR>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-alang &lt;country code&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD VALIGN=top><FONT CLASS="text">-dvd &lt;title_id&gt;&nbsp;</TD>
<TD><FONT CLASS="text">Enables DVD support and selects title.</TD><TR>
<TD VALIGN=top><FONT CLASS="text">-chapter &lt;chapter_id&gt;&nbsp;</TD>
<TD><FONT CLASS="text">Selects DVD chapter(s) to play (default: play from chapter 1).
Example : <CODE>-chapter 5-10</CODE> or <CODE>-chapter -9</CODE></TD><TR>
<TD VALIGN=top><FONT CLASS="text">-dvdangle &lt;angle_id&gt;&nbsp;</TD>
<TD><FONT CLASS="text">Selects camera angle (default: 1)</TD><TR>
<TD VALIGN=top><FONT CLASS="text">-alang &lt;country code&gt;&nbsp;</TD>
<TD><FONT CLASS="text">
The <CODE>country code</CODE> tells <B>MPlayer</B> which audio language(s) to prefer.
For the list of available languages, add <CODE>-v</CODE> option after
your DVD options, and browse the output.<BR>
For example :<BR>
&nbsp;&nbsp;<CODE>-alang hu,en</CODE> - first tries to find hungarian
audio, and if not found, decode english audio.</TD></TR>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-slang &lt;country code&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD VALIGN=top><FONT CLASS="text">-slang &lt;country code&gt;&nbsp;</TD>
<TD><FONT CLASS="text">
Turns on DVD subtitles. The <CODE>country code</CODE> tells <B>MPlayer</B>
which language(s) to prefer.
For the list of available languages, add <CODE>-v</CODE> option after
@ -144,101 +136,100 @@ machine.</P>
For example :<BR>
&nbsp;&nbsp;<CODE>-slang hu,en</CODE> - first tries to display hungarian
subtitles, and if not found, display english subtitles.</TD></TR>
<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-sid &lt;subtitle_id&gt;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD VALIGN=top><FONT CLASS="text">-sid &lt;subtitle_id&gt;&nbsp;</TD>
<TD><FONT CLASS="text">
Displays a subtitle channel with the given <CODE>id</CODE> (values can be
0-31). Useful for example with badly mastered DVDs where country code
selects the wrong channel.
selects the wrong channel.</TD></TR>
<TD VALIGN=top><FONT CLASS="text">-csslib &lt;path/filename&gt;</TD>
<TD><FONT CLASS="text">
(old-style DVD option) This option is used to override the default location
of <CODE>libcss.so</CODE>
</TD></TR>
<TD VALIGN=top><FONT CLASS="text">-dvdauth &lt;DVD device&gt;&nbsp;</TD>
<TD><FONT CLASS="text">
(old-style DVD option) Turns on DVD authentication using the given device.
</TD></TR>
<TD VALIGN=top><FONT CLASS="text">-dvdkey &lt;CSS key&gt;</TD>
<TD><FONT CLASS="text">
(old-style DVD option) When decoding from non-DVD, this option gives the
CSS key needed to crack the DVD (the key is printed when authenticating
with DVD).
</TD></TR>
</TABLE>
<P>Default device is <CODE>/dev/dvd</CODE>, you can change it in config.h
(compile time option), or you can specify it as a filename for <B>MPlayer</B>:
(compile time option), or you can specify it using the -dvd-device option :
</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 1 /dev/dvd</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 1 -sid 5 /dev/dvd</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 2 -chapter 5 -dvdangle 2</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 1 -dvd-device /dev/dvd</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 1 -slang en -dvd-device /dev/dvd</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 1 -slang en -dvd-device /dev/dvd -chapter 20-25</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvd 2 -alang sp -chapter 5 -dvdangle 2</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvdauth /dev/dvd /mnt/cd/video_ts/vts_03_1.vob</CODE></P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>mplayer -dvdkey C005D4A16D vts_03_1.vob</CODE></P>
<P><B><A NAME=4.3>4.3. DVD playback FAQ</A></B></P>
<TABLE BORDER=0 ALIGN=left WIDTH=100%>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
Playing a DVD, I encountered this error :<BR>
<CODE>mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion nfo_length /
sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.</CODE>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2.
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2 and
libmpdvdkit, use the later.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
Can I compile libdvdread and libdvdcss for example on my sweet Sparc/Solaris?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
Who knows ... Please test it and send feedback. But it's said that it
should work. Please refer documentation of libdvdread and its homepage
as well. We're not authors of libdvdread.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
What about subtitles? Can MPlayer display them?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
Yes! See above in the DVD chapter.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
I've got no sound / bad sound (Spanish audio and other ugly things).
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<B>MPlayer</B> currently does not use all of information of IFO blocks from DVD.
You can adjust the right DVD audio stream with: '-aid 128' command line
option, where 128 is the stream id of requested audio stream. You can
experience with numbers of 128,129,... and so on. Of course this problem
will be solved in the future.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
There is some strange effect (interlace like thing) especially when fast
moving objects are shown in the movie.
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
Known problem, we try to fix it later (when we switch to libvo2).
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
How can I set the region code of my DVD-Drive ? I don't have windows!
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
Use the 'regionset' tool:
<A HREF="http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz">http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz</A>
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
So MPlayer can play DVDs? Then it must use DeCSS! You are under arrest
under the XYZ#$ paragraph of the--
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
Get back asshole, there is no DeCSS code in <B>MPlayer</B>. <B>MPlayer</B> uses libdvdread
by linking against it, and libdvdread uses libdvdcss by dynamic loading it.<BR>
<B>UPDATE</B> : DeCSS is free.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
Do I need to be (setuid) root/setuid fibmap_mplayer to be able to play DVD?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
No, you don't. This is the past :) However of course you must have got
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
No, you don't. Only for old-style DVD support. However of course you must have
the proper rights to the DVD device driver entry (in /dev).
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
How can I ... (insert some expectable DVD player feature here)?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
The current implementation is the first implementation of some real DVD
player functionality. First, we would like to target existing bugs and
basic features before implementing new features.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
Where can I get libdvdread and libdvdcss packages from?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
From the site of Ogle:
<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A>.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
Is it possible to play/encode only selected chapters ?
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
Yes, see the <CODE>-chapter</CODE> option.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT CLASS="text">
My DVD playing is sluggish !
</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT CLASS="text">
Use the <CODE>-cache</CODE> option (see the manpage!). If it still doesn't
work, try enabling DMA for the DVD drive.
</TD><TR><TD COLSPAN=3>&nbsp;</TD><TR>
</TABLE>
</BODY>

View File

@ -1,217 +1,225 @@
<HTML><HEAD>
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
<TITLE>mplayer - codec status table</TITLE>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-2" />
</HEAD>
<BODY BGCOLOR=#FFFFFF text="#000000" link="#666666" vlink="#666666" alink="#666666" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
<table width=750 border="0">
<tr>
<td align="right">
<p>&nbsp;</p>
<p><b><font face="Verdana, Arial, Helvetica, sans-serif" size="2">Status of codecs support</font></b></p>
<p><b><FONT CLASS="text">Stan obs³ugi kodeków</font></b></p>
</td>
</tr>
<td>
<p><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><a href="#vc">Video codecs</a><br><a href="#ac">Audio codecs</a><br></font></p>
<p><FONT CLASS="text"><a href="#vc">Kodeki video</a><br><a href="#ac">Kodeki audio</a><br></font></p>
</td>
</tr>
<tr>
<td align="center">
<b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="vc">Video codecs:</a></font></b><br><br>
<b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="vc">Kodeki video</a></font></b><br><br>
<table width="100%" border="1" cellspacing="0" cellpadding="5" bordercolor=#DDDDDD>
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Built-in native codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Wbudowane w³asne kodeki</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">out</font></b></td>
<td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">wyj¶cie</font></b></td>
<td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">komentarze</font></b></td>
</tr>
<!-- %0 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%Y</b></font></td>
<td align=center colspan=2><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%F</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center><FONT CLASS="text"><b>%Y</b></font></td>
<td align=center colspan=2><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Fully functional Win32 VfW/DShow codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>W pe³ni funkcjonalne kodeki Win32 VfW/DShow</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">out</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">wyj¶cie</font></b></td>
<td align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">DShow</font></b></td>
<td align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td>
<td align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">komentarze</font></b></td>
</tr>
<!-- %1 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%Y</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%D</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%F</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center><FONT CLASS="text"><b>%Y</b></font></td>
<td align=center><FONT CLASS="text"><b>%D</b></font></td>
<td align=center><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Codecs with problems</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Problematyczne kodeki</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %2 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%F</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet working codecs:</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Kodeki jeszcze nie dzia³aj±ce</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %3 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%F</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not tested codecs:</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Kodeki jeszcze nie testowane</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %4 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%F</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
</table>
<br><b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="ac">Audio codecs:</a></font></b><br><br>
<br><b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="ac">Kodeki audio</a></font></b><br><br>
<table width="100%" border="1" cellspacing="0" cellpadding="5" bordercolor=#DDDDDD>
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Built-in native codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Wbudowane w³asne kodeki</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td align=center colspan=3><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td align=center colspan=3><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">komentarze</font></b></td>
</tr>
<!-- %5 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%f</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Fully functional Win32 ACM/DShow codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>W pe³ni funkcjonalne kodeki Win32 ACM/DShow</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">DShow</font></b></td>
<td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td>
<td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">komentarze</font></b></td>
</tr>
<!-- %6 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%D</b></font></td>
<td align=center colspan=2><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%f</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center><FONT CLASS="text"><b>%D</b></font></td>
<td align=center colspan=2><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Codecs with problems</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>kodeki problematyczne</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %7 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%f</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet working codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Kodeki jeszcze nei dzia³aj±ce</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %8 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%f</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->
<tr>
<td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet tested codecs</b></font></td>
<td colspan=6 bgcolor=#CCCCCC><FONT CLASS="text"><b>Kodeki jeszcze nie testowane</b></font></td>
</tr>
<tr>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td>
<td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">nazwa kodeka</font></b></td>
<td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td>
<td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">plik</font></b></td>
<td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td>
</tr>
<!-- %9 -->
<tr>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td>
<td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td>
<td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td>
<td align=center><FONT CLASS="text"><b>%i</b></font></td>
<td align=center><FONT CLASS="text"><b>%f</b></font></td>
<td align=center><FONT CLASS="text"><b>%d</b></font></td>
<td align=center colspan=3><FONT CLASS="text"><b>%c</b></font></td>
</tr>
<!-- %. -->

View File

@ -1,5 +1,9 @@
<HTML>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
<HEAD>
<META http-equiv="content-type" content="text/html; charset=iso-8859-2" />
</HEAD>
<BODY BGCOLOR=WHITE>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>

View File

@ -1,7 +1,16 @@
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
</HEAD>
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<FONT CLASS="text">
<P><B><A NAME=2.4>2.4. Encoding with MEncoder</A></B></P>
@ -9,22 +18,23 @@
<P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder,
designed to encode MPlayer-playable movies
(<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET</B>) to other MPlayer-playable formats (see
below). Currently it's in beta stage, and encodes only to <B>DivX4</B> (1 or 2
passes) video, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has stream
copying abilities. In the future, there will be cropping, resizing filters, and
other interesting stuff.</P>
(<B>AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET</B>) to other MPlayer-playable
formats (see below). It can encode with various codecs, like <B>DivX4</B> (1 or
2 passes), libavcodec, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has
stream copying and video resizing abilities.</P>
<P><B><A NAME=2.4.2>2.4.2. Compiling</B></P>
<P>
<UL>
<LI><B>OPTIONAL</B> - read <B>MPlayer</B>'s compilation instructions, it contains info about
how to install <I>libdvdread</I> for <B>DVD</B> support, etc.</LI>
<LI><B>OPTIONAL</B> - download the newest <B>DivX4linux</B> libs
<LI><B>OPTIONAL</B> - read <B>MPlayer</B>'s compilation instruction.</LI>
<LI><B>OPTIONAL (LINUX ONLY)</B> - download the newest <B>DivX4linux</B> libs
from <A HREF="http://avifile.sourceforge.net/download.htm">avifile.sourceforge.net</A>,
and have them PROPERLY installed. This is needed for DivX4 (1/2 pass)
encoding. And since this is mandatory (now), MEncoder is Linux-only.</LI>
and have them PROPERLY installed. You need them if you want DivX4
(1/2 pass) encoding.</LI>
<LI><B>OPTIONAL</B> - <A HREF="codecs.html#2.2.1.9">download and install
<B>XViD</B></A>. Very useful on non-Linux boxes, and/or when you need
faster encoding than DivX4, with approximately the same quality.</LI>
<LI><B>OPTIONAL</B> - for libavcodec support, install libavcodec as
described in the <A HREF="codecs.html#2.2.1.2">libavcodec section</A>.</LI>
<LI><B>OPTIONAL</B> - download and compile <B>libmp3lame</B> (from lame 3.89beta or lame CVS).<BR>
@ -39,9 +49,9 @@ other interesting stuff.</P>
panic if it's <B>400</B> or so, you shouldn't heard any audible
quality decrease. Oh, and if your compiler doesn't even run <CODE>make test</CODE> ...
Well, delete that <B>GCC 2.96</B>.</LI>
<LI>use <CODE>./configure</CODE> with optional parameters as usual
(use <CODE>--enable-tv</CODE> to include V4L tuner grabbing code), and
type : <CODE>make mencoder</CODE> , then <CODE>make install</CODE>.</LI>
<LI><B>OPTIONAL</B> - <CODE>libjpeg</CODE> and <CODE>libpng</CODE> -
as described in the <A HREF="documentation.html#1.3">Installation</A>
section</LI>
</UL>
</P>
@ -53,31 +63,37 @@ other interesting stuff.</P>
<P>
<UL>
<LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B></LI>
<LI>encoding from <B>V4L compatible TV tuners</B></LI>
<LI>encoding to all the codecs of ffmpeg's
<A HREF=codecs.html#2.2.1.2>libavcodec</A></LI>
<LI>video encoding from <B>V4L compatible TV tuners</B></LI>
<LI>encoding/multiplexing to interleaved AVI files with proper index</LI>
<LI>1 or 2 pass <B>DivX4</B> video</LI>
<LI><B>VBR</B> MP3 audio</LI>
<LI>creating files from external audio stream</LI>
<LI>1, 2 or 3 pass <B>DivX4</B> video</LI>
<LI><B>VBR</B> MP3 audio - <B>IMPORTANT NOTE</B> : VBR MP3 audio doesn't
always play nicely on windows players! On the other hand, currently
<B>MEncoder</B>'s CBR encoding is totally broken on win32 players :)</LI>
<LI>PCM audio</LI>
<LI>stream copying (CBR audio only)</LI>
<LI>stream copying</LI>
<LI>input A/V synchronizing (PTS-based, can be disabled with -mc 0 option)</LI>
<LI>FPS correction with <CODE>-ofps</CODE> option (useful when encoding
29.97fps VOB to 24fps AVI)</LI>
<LI>movie rescaling</LI>
<LI>using our very powerful plugin system (crop, expand, flip, postprocess,
rotate, scale, rgb/yuv conversion)</LI>
<LI>can encode DVD/VOBsub <B>AND</B> text subtitles into the output file</LI>
</UL>
</P>
<P><B><I>Planned features</I></B> :
<UL>
<LI>using audio from separate file (AC3, MP3, OGG)</LI>
<LI>VBR audio stream copy</LI>
<LI>even wider variety of available en/decoding formats/codecs
(creating VOB files with DivX4/Indeo5/VIVO streams :)</LI>
<LI>audio encoding from v4l (DONE for FreeBSD ?)</LI>
</UL>
</P>
<P><B><A NAME=2.4.3.1>2.4.3.1. Encoding 2-pass DivX4</B></P>
<P><B><A NAME=2.4.3.1>2.4.3.1. Encoding 2 or 3-pass DivX4</B></P>
<P>The name comes from the fact that this method encodes the file <I>twice</I>.
<P><U><B>2-pass encoding :</B></U> the name comes from the fact that this method encodes the file <I>twice</I>.
The first encoding (dubbed <I>pass</I>) creates some temporary files (*.log) with a
size of few megabytes, do not delete them yet (you can delete the AVI). In the second pass, the
2-pass output file is created, using the bitrate data from the temporary files. The resulting
@ -86,9 +102,88 @@ 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>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file, which
can come from a previous 3-pass encoding (it interferes with current one)<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100
-o movie.avi -pass 1<BR>
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
<P><U><B>3-pass encoding :</B></U> this is an extension of 2-pass encoding,
where the audio encoding takes place in a separate pass. This method enables
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>
<P>
<TABLE>
<TR>
<TD><FONT CLASS="text">
<CODE>rm frameno.avi</CODE></TD>
<TD><FONT CLASS="text">
<B>remove conflicting temporary file</B></TD>
</TR>
<TR>
<TD><FONT CLASS="text">
<CODE>mencoder &lt;file/DVD&gt; -ovc frameno -o
frameno.avi</CODE></TD>
<TD><FONT CLASS="text">
<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><FONT CLASS="text">
<CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 1
-divx4opts br=&lt;bitrate&gt;</CODE></TD>
<TD><FONT CLASS="text">
<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><FONT CLASS="text">
<CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 2
-divx4opts br=&lt;bitrate&gt;</CODE></TD>
<TD><FONT CLASS="text">
<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>
</P>
<P><B>Example for 3-pass encoding :</B></P>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file,
which can come from a previous 3-pass encoding (it interferes with current
one)<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc frameno
-o frameno.avi<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
-divx4opts br=1100 -oac copy -o movie.avi -pass 1<BR>
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
-divx4opts br=1100 -oac copy -o movie.avi -pass 2</CODE>
</P>
<P><U><B>2 or 3-pass encoding using internal libavcodec controler</B></U> :
Optionally you can use libavcodec's internal 2 or 3-pass mode, it may gives you
better final rate accuracy than using the external, DivX4-inspired 2-pass rate
controler with libavcodec.<BR>
<UL>
<B>2-pass encoding</B> :<BR>
<CODE>rm -f lavc_stats.txt<BR>
mencoder -dvd 2 -ovc lavc -lacvopts vpass=1 (audio-options) -o movie.avi<BR>
mencoder -dvd 2 -ovc lavc -lacvopts vpass=2 (audio-options) -o movie.avi</CODE><BR>
<BR>
<B>3-pass encoding</B> :<BR>
<CODE>rm -f frameno.avi lavc_stats.txt<BR>
mencoder -dvd 2 -ovc frameno (audio-options) -o frameno.avi<BR>
mencoder -dvd 2 -ovc lavc -lacvopts vpass=1 -oac copy -o movie.avi<BR>
mencoder -dvd 2 -ovc lavc -lacvopts vpass=2 -oac copy -o movie.avi</CODE><BR>
</UL>
</P>
<P><B><A NAME=2.4.3.2>2.4.3.2. Rescaling movies</B></P>
@ -101,16 +196,14 @@ commands are needed :<BR>
AVI (DivX) files, you have be aware that AVI headers don't store this
value. Thus, the only solution is rescaling.</P>
<P><B>MEncoder can scale input images if they come in YV12 format (for example:
ffdivx, odivx drivers, or mpeg1/2). The output size is specified with the
<CODE>-x</CODE>, and <CODE>-y</CODE> options. Furthermore, there are 3
rescaling filters in <B>MEncoder</B>, <I>0
: fast bilinear</I>, <I>1 : bilinear</I>, <I>2 : bicubic</I> (best quality).
They can be specified with the <CODE>-sws</CODE> option. If not specified,
<B>MEncoder</B> will use 0 : fast bilinear.</P>
<P>The scaling process is handled by the <I>'scale'</I> video filter:
<CODE>-vop scale=X:Y</CODE>. Its quality can be set with the
<CODE>-sws</CODE> option. If it's not specified, <B>MEncoder</B> will use 0 :
fast bilinear.</P>
<P>Usage :<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder sample-svcd.mpg -divx4opts br=1300 -vop scale=640:480 -sws 2 -o output.avi</CODE></P>
<P>Rescaling is very simple :<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder sample-svcd.mpg -divx4opts br=1300 -x 640 -y 480 -sws 2 -o output.avi</CODE></P>
<P><B><A NAME=2.4.3.3>2.4.3.3. Stream copying</B></P>
@ -126,24 +219,29 @@ commands are needed :<BR>
example when only the audio stream has to be encoded (like, uncompressed PCM
to MP3).</LI>
<LI><B>Audio stream</B> (option <CODE>-oac copy</CODE>) : straightforward.</LI>
<LI><B>Audio stream</B> (option <CODE>-oac copy</CODE>) : straightforward.
It is possible to take an external audio file (MP3, AC3, Vorbis) and mux it
into the output stream. Use the <CODE>-audiofile &lt;filename&gt;</CODE>
option for this.</LI>
</UL>
</P>
<P><B><A NAME=2.4.3.4>2.4.3.4. Fixing AVIs with broken index</B></P>
<P><B><A NAME=2.4.3.4>2.4.3.4. Fixing AVIs with broken index or interleaving</B></P>
<P>Easiest thing. We simply copy the video and audio streams, and
<B>MEncoder</B> generates the index. Of course this cannot fix possible bugs in
the video and/or audio streams.</P>
the video and/or audio streams. It also fixes files with broken interleaving,
thus the <CODE>-ni</CODE> option won't be needed for them anymore.</P>
<P>Command : <CODE>mencoder input.avi -ovc copy -oac copy -o output.avi</CODE></P>
<P>Command : <CODE>mencoder -idx input.avi -ovc copy -oac copy -o output.avi</CODE></P>
<P><B><A NAME=2.4.3.5>2.4.3.5. Encoding with the <I>libavcodec</I> codec family</B></P>
<P>libavcodec provides simple encoding to a lot of interesting video and audio
formats (currently its audio codecs are unsupported). You can encode to the
following codecs :</P>
<P><A HREF="codecs.html#2.2.1.2">libavcodec</A> provides simple encoding to a
lot of interesting video and audio formats (currently its audio codecs are
unsupported). You can encode to the following codecs :</P>
<P>
<UL>
@ -152,6 +250,7 @@ following codecs :</P>
<LI>h263p - H263 Plus</LI>
<LI>mpeg4 - DivX4</LI>
<LI>msmpeg4 - the old DivX</LI>
<LI>msmpeg4v2 - Micro$oft MPEG4 V2 (DivX alias MP43 predecessor)</LI>
<LI>rv10 - an old RealVideo codec</LI>
<LI>mpeg1video - MPEG1 video :)</LI>
</UL>
@ -160,48 +259,95 @@ following codecs :</P>
<P>The first column contains the codec names that should be passed after the
<CODE>vcodec</CODE> config, like : <CODE>-lavcopts vcodec=msmpeg4</CODE></P>
<P>An example, with MJPEG compression :<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg</CODE></P>
<P><B><A NAME=2.4.3.6>2.4.3.6. Encoding from multiple input image files (JPEGs or PNGs)</B></P>
<P><B>MEncoder</B> is capable of creating movies from one or more JPEG or PNG
files. With simple framecopy it can create MJPEG (Motion JPEG) or MPNG
(Motion PNG) files.</P>
<P><B><I>Explanation of the process</I></B></P>
<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>
<P><B><I>Examples</I></B></P>
<P>The explanation of the <CODE>-mf</CODE> option can be found below in the
global <A HREF=#2.4.5>Options</A> section and in the manpage.</P>
<P><I>Creating a DivX4 file from all the JPEG files in the current dir :</I><BR>
&nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc divx4 -o
output.avi</CODE></P>
<P><I>Creating a DivX4 file from some JPEG files in the current dir :</I><BR>
&nbsp;&nbsp;<CODE>mencoder frame001.jpg,frame002.jpg -mf on:w=800:h=600:fps=25 -ovc divx4 -o
output.avi</CODE></P>
<P><I>Creating a Motion JPEG (MJPEG) file from all the JPEG files in the current dir :</I><BR>
&nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc copy
-o output.avi</CODE></P>
<P><I>Creating an uncompressed file from all the PNG files in the current dir :</I><BR>
&nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc raw -o
output.avi</CODE></P>
<P><I>Creating a Motion PNG (MPNG) file from all the PNG files in the current dir :</I><BR>
&nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc copy
-o output.avi</CODE></P>
<P><B><A NAME=2.4.4>2.4.4. Syntax</B></P>
<P>&nbsp;&nbsp;<CODE>mencoder [options] [input file] [options] ...</P>
<P><B><A NAME=2.4.5>2.4.5. Available options</B></P>
<P>NOTE : for all available options, <B>read the manpage !</B></P>
<TABLE BORDER=0>
<P>
As <B>MEncoder</B> is built on the same codebase as <B>MPlayer</B>, there
are many <B>MPlayer</B> options that have function in <B>MEncoder</B> too!
See, you can use <CODE>-sid</CODE> to rip a DVD with subtitles, or
<CODE>-noidx</CODE> to disregard buggy index of input AVI. <B>Be smart!</B>
</P>
<TABLE BORDER=1>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-ss</I> time</TD>
<TD><FONT CLASS="text">
start encoding from the given time (can start only from keyframes !)
</TD>
</TR>
<TR>
<TD><FONT CLASS="text">
<I>-endpos</I> time</TD>
<TD><FONT CLASS="text">
stop encoding at the given time. See the manpage for examples !
</TD>
</TR>
<TR>
<TD><FONT CLASS="text">
<I>-o</I> filename</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
specify output filename
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<I>-x</I> width in pixels</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
rescale output video to given pixels width
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<I>-y</I> height in pixels</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
rescale output video to given pixels height
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-sws</I> 0-2</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
type of scaling method<BR>
&nbsp;&nbsp;0 - fast bilinear<BR>
&nbsp;&nbsp;1 - bilinear<BR>
@ -209,24 +355,22 @@ following codecs :</P>
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-ovc</I> codecname</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
&nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
&nbsp;&nbsp;<B>rawrgb</B> - ?<BR>
&nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
&nbsp;&nbsp;<B>divx4</B> - encode to DivX4<BR>
&nbsp;&nbsp;<B>lavc</B> - encode with a codec from libavcodec<BR>
&nbsp;&nbsp;<B>vfw</B> - encode with a Windows DLL<BR>
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-oac</I> codecname</TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
&nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
&nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
@ -235,50 +379,58 @@ following codecs :</P>
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-mf</I> multifile options</TD>
<TD><FONT CLASS="text">
Used when encoding from multiple JPEG files. Its sub-options are:<BR>
&nbsp;&nbsp;<B>on</B> - turns on multifile support<BR>
&nbsp;&nbsp;<B>w</B>=&lt;value&gt; - width of the output file<BR>
&nbsp;&nbsp;<B>h</B>=&lt;value&gt; - height of the output file<BR>
&nbsp;&nbsp;<B>fps</B>=&lt;value&gt; - fps of the output file<BR>
&nbsp;&nbsp;<B>type</B>=&lt;value&gt; - type of input files (available types : <CODE>jpeg</CODE>, <CODE>png</CODE>)<BR>
</TD>
</TR>
<TR>
<TD><FONT CLASS="text">
<I>-divx4opts</I></TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
If encoding to DivX4, you can specify its parameters here, like:<BR>
&nbsp;&nbsp;<CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR>
Common options: <B>(for full list, check the manpage!)</B><BR>
&nbsp;&nbsp;<B>help</B> - get help<BR>
&nbsp;&nbsp;<B>br</B>=XXX - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
&nbsp;&nbsp;<B>q</B>=XXXX - quality (1-fastest, 5-best - default 5)<BR>
&nbsp;&nbsp;<B>key</B>=XXXX - keyframe interval<BR>
&nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
&nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (1-fastest, 5-best - default 5)<BR>
&nbsp;&nbsp;<B>key</B>=&lt;value&gt; - keyframe interval<BR>
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-lavcopts</I></TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
If encoding with libavcodec, you can specify its parameters here, like:<BR>
&nbsp;&nbsp;<CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
Common options: <B>(for full list, check the manpage!)</B><BR>
&nbsp;&nbsp;<B>help</B> - get help<BR>
&nbsp;&nbsp;<B>vcodec</B>=XXX - select videocodec (for the full list, see the libavcodec section above)<BR>
&nbsp;&nbsp;<B>vbitrate</B>=XXX - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
&nbsp;&nbsp;<B>vcodec</B>=&lt;value&gt; - select videocodec (for the full list, see the libavcodec section above)<BR>
&nbsp;&nbsp;<B>vbitrate</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
&nbsp;&nbsp;<B>vhq</B> - high quality<BR>
&nbsp;&nbsp;<B>keyint</B>=XXX - keyframe interval<BR>
&nbsp;&nbsp;<B>keyint</B>=&lt;value&gt; - keyframe interval<BR>
</TD>
</TR>
<TR>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
<I>-lameopts</I></TD>
<TD>&nbsp;&nbsp;</TD>
<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<TD><FONT CLASS="text">
If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR>
&nbsp;&nbsp;<CODE>-lameopts q=3</CODE><BR>
&nbsp;&nbsp;<CODE>-lameopts br=192:cbr</CODE><BR>
Common options: <B>(for full list, check the manpage!)</B><BR>
&nbsp;&nbsp;<B>help</B> - get help<BR>
&nbsp;&nbsp;<B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR>
&nbsp;&nbsp;<B>br</B>=XXX - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
&nbsp;&nbsp;<B>q</B>=XXXX - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
&nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
&nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
&nbsp;&nbsp;<B>vbr</B>=&lt;value&gt; - VBR sub-mode (3-ABR, best quality/speed) (this is for <B>VBR</B> only!)<BR>
</TD>
</TR>
</TABLE>
@ -294,7 +446,7 @@ following codecs :</P>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg -ffourcc mjpg</CODE></P>
<P>Encoding from DVD, title 2, with rescaling :<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -x 640 -y 480 -sws 2 -o title2.avi</CODE></P>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -vop scale=640:480 -sws 2 -o title2.avi</CODE></P>
<P>Encoding from HTTP :<BR>
<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder http://mplayer.hq/example.avi -o example.avi</CODE></P>

File diff suppressed because it is too large Load Diff

View File

@ -1,47 +1,36 @@
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
</HEAD>
<BODY BGCOLOR=WHITE>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<FONT CLASS="text">
<P><B><A NAME=2.1>2.1. Supported formats</A></B></P>
<P><B>MPlayer</B> can read/play from the following devices/formats:<BR>
<UL>
<LI> <A HREF="#2.1.1.1">VCD</A> (Video CD) directly from CD-ROM or from CDRwin's .bin image file
<LI> <A HREF="#2.1.1.1">DVD</A>, directly from your DVD disk, using libdvdread for decryption
<LI> <A HREF="#2.1.1.1">MPEG 1/2</A> System Stream (PS/PES/VOB) and Elementary Stream (ES) file
formats
<LI> <A HREF="#2.1.1.2">RIFF AVI</A> file format
<LI> <A HREF="#2.1.1.3">ASF/WMV</A> 1.0 file format
<LI> <A HREF="#2.1.1.4">QT/MOV</A> file format with (un)compressed headers
<LI> <A HREF="#2.1.1.5">VIVO</A> format (.viv files)
<LI> <A HREF="#2.1.1.6">FLI</A> format
<LI> <A HREF="#2.1.1.7">RealMedia</A> format (.rm files)
<LI> <A HREF="#2.1.1.8">NuppelVideo</A> format (.nuv files)
<LI> <A HREF="#2.1.1.9">yuv4mpeg</A> format
<LI> supports <A HREF="documentation.html#3.3">reading from stdin</A>, or network via HTTP
</UL></P>
<P>It is important to clarify a common mistake. When people see a file with a
<B>.AVI</B> extension, they immediately conclude that it is not an MPEG file.
That is not true. At least not entirely. Contrary to popular belief such a file
<B>can</B> contain MPEG1 video.</P>
<P>It's important to clarify a popular mistake. When people see a file with
<B>.AVI</B> extension, they instantly declare that isn't an MPEG file.
That's not true. At least not entirely. If you tell them that such a file
can contain MPEG1 video, they laugh at you. Feel free to kick their dumbass
faces, then tell them to RTFM.</P>
<P>You see, a <B>codec</B> isn't equal to a <B>file format</B>.<BR>
Video <B>codecs</B> are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.<BR>
Video <B>formats</B> are: MPG, AVI, ASF.<BR>
<P>You see, a <B>codec</B> is not the same as a <B>file format</B>.<BR>
Examples of video <B>codecs</B> are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.<BR>
Examples of file <B>formats</B> are: MPG, AVI, ASF.<BR>
</P>
<P>In theory, you can happily put an OpenDivX video and MP3 audio
into a <B>.MPG</B> format file. Though most players won't play it, since
they expect MPEG1 video and MP2 audio (<B>.MPG</B> doesn't have the
necessary fields to describe its video and audio streams, like <B>.AVI</B>
does). Or put MPEG1 video to an .AVI. For example <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> can
create these files.</P>
<P>In theory, you can put an OpenDivX video and MP3 audio
into an <B>MPG</B> format file. However, most players will not play it, since
they expect MPEG1 video and MP2 audio (unlike <B>AVI</B>, <B>MPG</B> does not have the
necessary fields to describe its video and audio streams).
Or you might put MPEG1 video into an AVI file. <A HREF="http://ffmpeg.sourceforge.net">FFmpeg</A>
and <A HREF="encoding.html">MEncoder</A> can create these files.</P>
<P>Audio <B>codecs</B> and <B>formats</B> are basically the same terms.</P>
<P><B><A NAME=2.1.1>2.1.1. Video formats</A></B></P>
@ -49,74 +38,80 @@ create these files.</P>
<P><B><A NAME=2.1.1.1>2.1.1.1. MPEG files</A></B></P>
<P>
<LI>MPG : this is the most <B>basic</B> form of MPEG file formats. Contains
MPEG1 video, and MP2 (MPEG-1 layer 2) audio, or rarely MP1.</LI>
<LI>DAT : this is the very same format as MPG, just different extension. Used
on <B>Video CD</B>s. Due to the nature VCDs are created and Linux is designed,
the DAT files can't be played nor copied from VCDs. You have to use the
<CODE>-vcd</CODE> option to play the VideoCD.</LI>
<LI>VOB : this is the MPEG file format on <B>DVD</B>s. The same as MPG, plus
capability to contain subtitles, or non-MPEG (AC3) audio. Contains encoded MPEG2
video, and usually AC3 audio, but MP2 is allowed too.<BR>
<P>MPEG files come in different guises:</P>
<UL>
<LI>MPG: This is the most <B>basic</B> form of the MPEG file formats. It contains
MPEG1 video, and MP2 (MPEG-1 layer 2) or rarely MP1 audio.</LI>
<LI>DAT: This is the very same format as MPG with a different extension. It is used
on <B>Video CD</B>s. Due to the way VCDs are created and Linux is designed,
the DAT files cannot be played nor copied from VCDs as regular files. You have
to use the <CODE>-vcd</CODE> option to play the Video CD.</LI>
<LI>VOB: This is the MPEG file format on <B>DVD</B>s. It is the same as MPG, plus the
capability to contain subtitles or non-MPEG (AC3) audio. It contains encoded MPEG2
video and usually AC3 audio, but DTS, MP2 and uncompressed LPCM are allowed, too.<BR>
<B>Read the <A HREF="cd-dvd.html#4.2">DVD section</A> !</B></LI>
</P>
</UL>
<P>In MPEG files, series of frames are grouped together, and are independent
from the other groups. What this means is you can cut/join an MPEG file with
standard file-tools (like dd, cut), and it remains completely functional.</P>
<P>Series of frames form independent groups in MPEG files. This means that you
can cut/join an MPEG file with standard file tools (like dd, cut), and it
remains completely functional.</P>
<P>One important feature for MPGs is that they have a field to describe
<P>One important feature of MPGs is that they have a field to describe
the aspect ratio of the video stream within. For example SVCDs have
480x480 resolution video, and in the header that field is set to 4:3, so
it's played at 640x480. AVI files don't have this field, so one has to
rescale it during encoding.</P>
480x480 resolution video, and in the header that field is set to 4:3, so that
it is played at 640x480. AVI files do not have this field, so they have to be
rescaled during encoding or played with the <CODE>-aspect</CODE> option.</P>
<P><B><A NAME=2.1.1.2>2.1.1.2. AVI files</A></B></P>
<P>Designed by Micro$oft, the <B>AVI (Audio Video Interleaved)</B> is a
widespread multipurpose format, currently used mostly for DivX and DivX4
videos. Has many known drawbacks, and inabilities (for example in streaming).
Has support for one video stream, and 99 audio streams. Can be as big as
2Gb. There exists an extension for it to be bigger, called <B>OpenDMS</B>.
M$ currently strongly discourages its use and propagates ASF/WMV. Not if
<P>Designed by Micro$oft, <B>AVI (Audio Video Interleaved)</B> is a
widespread multipurpose format currently used mostly for DivX and DivX4
video. It has many known drawbacks and shortcomings (for example in streaming).
It supports one video stream and 0 to 99 audio streams and can be as big as
2GB. There exists an extension allowing bigger files called <B>OpenDMS</B>.
M$ currently strongly discourages its use and encourages ASF/WMV. Not that
anybody cares.<BR>
<B>NOTE</B> : DV cameras can create two types of AVI format, one is the usual and
<P>There is a hack for AVI files that enhances them to contain Ogg Vorbis audio
stream, but makes them incompatible with standard AVI. <B>MPlayer</B>
supports playing these files, though seeking is currently unimplemented.</P>
<B>NOTE:</B> DV cameras can create two types of AVI formats. One is common and
playable, the other is neither.</P>
<P>There are two kinds of AVI files:
<P>There are two kinds of AVI files:</P>
<UL>
<LI><B>Interleaved</B> : audio and video content is interleaved. This is the
<LI><B>Interleaved:</B> Audio and video content is interleaved. This is the
standard usage. Recommended and mostly used. Some tools create interleaved
AVIs with bad sync. <B>MPlayer</B> detects these as interleaved, and this
climaxes in loss of A/V sync, probably at seeking. These files should be
played as non-interleaved (with the <CODE>-ni</CODE> option).</LI>
<LI><B>Non-interleaved</B> : bad. First come the whole video stream, then the whole
audio stream, thus needs a lot of seeking. It's very bad when playing from
network or CDROM.</LI>
<LI><B>Non-interleaved:</B> First comes the whole video stream, then the whole
audio stream. It thus needs a lot of seeking, making playing from network or
CD-Rom difficult.</LI>
</UL>
</P>
<P>MPlayer supports 2 kind of timing for AVI files:
<P><B>MPlayer</B> supports two kinds of timings for AVI files:</P>
<UL>
<LI><B>bps-based</B> : it is based on bitrate/samplerate of video/audio stream. This
method is used by most players, including avifile and windows media player.
<LI><B>bps-based</B>: It is based on the bitrate/samplerate of the video/audio stream. This
method is used by most players, including <A HREF="http://avifile.sourceforge.net">avifile</A>
and windows media player.
Files with broken headers, and files created with VBR audio but not
VBR-compliant encoder will result in A/V desync with this method (mostly at
seeking).</LI>
<LI><B>interleaving-based</B> : it doesn't use bitrate value of the header, instead
it uses the relative position of interleaved audio and video chunks. Makes
some badly encoded file with VBR audio playable.</LI>
<LI><B>interleaving-based</B>: It does not use the bitrate value of the header, instead
it uses the relative position of interleaved audio and video chunks, making
badly encoded files with VBR audio playable.</LI>
</UL>
</P>
<P>Any audio and video codec is allowed, but note that VBR audio isn't well
supported by most of the players. The file format makes it possible to use VBR
<P>Any audio and video codec is allowed, but note that VBR audio is not well
supported by most players. The file format makes it possible to use VBR
audio, but most players expect CBR audio, thus they fail with VBR. VBR is
unusual, and Microsoft's AVI specs only describe CBR audio. I also note, that
most AVI encoders/multiplexers create bad files if using VBR audio. Only 2
exception (known by me): NaNDub and <A HREF="encoding.html">MEncoder</A>.</P>
uncommon and Microsoft's AVI specs only describe CBR audio. I also noticed that
most AVI encoders/multiplexers create bad files when using VBR audio. There are only
two exceptions (known to me): NaNDub and <A HREF="encoding.html">MEncoder</A>.</P>
<P><B><A NAME=2.1.1.3>2.1.1.3. ASF/WMV files</A></B></P>
@ -124,81 +119,125 @@ exception (known by me): NaNDub and <A HREF="encoding.html">MEncoder</A>.</P>
<P>ASF (active streaming format) comes from Microsoft. They developed two
variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (windows
media player and windows media encoder) and is very secret. v2.0 is published
and patented :). Of course they differ, there is no compatibility at all (it's
and patented :). Of course they differ, there is no compatibility at all (it is
just another legal game). <B>MPlayer</B> supports only v1.0, as nobody has ever seen
v2.0 files :) . Note, that .ASF files nowdays come with the extension .WMA or
v2.0 files :). Note that ASF files nowadays come with the extension .WMA or
.WMV.</P>
<P><B><A NAME=2.1.1.4>2.1.1.4. QuickTime/MOV files</A></B></P>
<P>These are from Macintosh. Usually have extensions of .QT or .MOV . Note
that since the MPEG4 Group chose QuickTime as the recommended file format
for MPEG4, their .MOV files come with .MPG or .MP4 extension (interesting
that in these files the video stream is a real .MPG file. With the
<CODE>-dumpvideo</CODE> option you can even extract it.).</P>
<P>These formats were designed by Apple. They usually have a .QT or .MOV extension. Note
that since the MPEG4 group chose QuickTime as the recommended file format
for MPEG4, their MOV files come with a .MPG or .MP4 extension (Interestingly
the video and audio streams in these files are real MPG and AAC files. With the
<CODE>-dumpvideo</CODE> and <CODE>-dumpaudio</CODE> options you can even extract them!).</P>
<P><B>Codecs</B>: any codecs allowed, both CBR and VBR. Note: most new mov files use
<B>Sorenson</B> video and QDesign Music audio. These formats are completely
secret, and only Apple's quicktime player is able to play these files (on
win/mac only).</P>
<P><B>Codecs</B>: Any codec is allowed, both CBR and VBR. Note: most new QuickTime files use
<B>Sorensen</B> video and QDesign Music audio. These formats have not been
disclosed and will probably remain so in the future, making Apple's QuickTime
player the only player able to play these files (on Windows/Mac OS only).</P>
<P><B><A NAME=2.1.1.5>2.1.1.5. VIV files</A></B></P>
<P><B>MPlayer</B> happily demuxes VIVO file formats. The format's big
disadvantage is that it has no index block, nor fixed packetsize or sync bytes,
<P><B>MPlayer</B> happily demuxes VIVO file formats. The biggest disadvantage of
the format is that it has no index block, nor a fixed packet size or sync bytes
and most files lack even keyframes, so forget seeking!</P>
<P>VIVO/1.0 files' video codec is standard <B>h.263</B> . The VIVO/2.0 files'
video codec is a modified, nonstandard <B>h.263</B> . Audio is the same,
it may be <B>g.723</B> (standard), or <B>Vivo Siren</B> .</P>
<P>The video codec of VIVO/1.0 files is standard <B>h.263</B>. The video codec
of VIVO/2.0 files is a modified, nonstandard <B>h.263v2</B>. The audio is the same,
it may be <B>g.723</B> (standard), or <B>Vivo Siren</B>.</P>
<P>See the <A HREF=codecs.html#2.2.1.4>VIVO video codec</A>
and <A HREF=codecs.html#2.2.2.4>VIVO audio codec</A> sections for installation
<P>See the <A HREF="codecs.html#2.2.1.4">VIVO video codec</A>
and <A HREF="codecs.html#2.2.2.4">VIVO audio codec</A> sections for installation
instructions.</P>
<P><B><A NAME=2.1.1.6>2.1.1.6. FLI files</A></B></P>
<P><B>FLI</B> is a very old fileformat used by Autodesk Animator, but it's
a common fileformat for short animations on the Net. <B>MPlayer</B> demuxes
<P><B>FLI</B> is a very old file format used by Autodesk Animator, but it is
a common file format for short animations on the net. <B>MPlayer</B> demuxes
and decodes FLI movies and is even able to seek within them (useful when
looping with the -loop option). FLI files don't have keyframes, so picture
looping with the <CODE>-loop</CODE> option). FLI files do not have keyframes, so the picture
will be messy for a short time after seeking.</P>
<P><B><A NAME=2.1.1.7>2.1.1.7. RealMedia (RM) files</A></B></P>
<P>Yes, <B>MPlayer</B> can read (demux) RealMedia (.rm) files. Seeking
is under implementation, and RM has keyframes so it will be flawless.
Here are the lists of the supported <A HREF="codecs.html#2.2.1.8">RealVideo</A>
<P>Yes, <B>MPlayer</B> can read (demux) RealMedia (.rm) files. Seeking works
(the format supports keyframes). Here are the lists of the supported
<A HREF="codecs.html#2.2.1.8">RealVideo</A>
and <A HREF="codecs.html#2.2.2.5">RealAudio</A> codecs.
<P><B><A NAME=2.1.1.8>2.1.1.8. NuppelVideo files</A></B></P>
<P><A HREF="http://mars.tuwien.ac.at/~roman/nuppelvideo">NuppelVideo</A>
is a TV grabber tool (AFAIK:). <B>MPlayer</B> can read its <CODE>.nuv</CODE>
is a TV grabber tool (AFAIK:). <B>MPlayer</B> can read its .NUV
files (only NuppelVideo 5.0). Those files can contain uncompressed YV12,
YV12+RTJpeg compressed, YV12 RTJpeg+lzo compressed, and YV12+lzo compressed
frames, <B>MPlayer</B> decodes (and also <B>encodes</B> them with MEncoder to
DivX/etc!) them all. Seeking is under implementation.</P>
frames. <B>MPlayer</B> decodes (and also <B>encodes</B> them with MEncoder to
DivX/etc!) them all. Seeking works.</P>
<P><B><A NAME=2.1.1.9>2.1.1.9. yuv4mpeg files</A></B></P>
<P><A HREF="http://mjpeg.sourceforge.net">yuv4mpeg / yuv4mpeg2</A> is
also a fileformat for TV grabbing, or so :) I know only one thing about it:
we support it.</P>
a file format used by the <A HREF="http://mjpeg.sf.net">mjpegtools programs</A>.
You can grab, produce, filter or encode video in this format using these.
The file format is really a sequence of uncompressed YUV 4:2:0 images.
</P>
<P><B><A NAME=2.1.1.10>2.1.1.10. FILM files</A></B></P>
<P>This format is used on old Sega Saturn CD-Rom games.</P>
<P><B><A NAME=2.1.1.11>2.1.1.11. RoQ files</A></B></P>
<P>RoQ files are multimedia files used in some ID games such as Quake III and
Return to Castle Wolfenstein.</P>
<P><B><A NAME=2.1.1.12>2.1.1.12. OGG files</A></B></P>
<P>This is a new fileformat from Xiphophorus, developed to contain Vorbis
audio. You'll need <CODE>libogg</CODE> and <CODE>libvorbis</CODE> installed
before compiling <B>MPlayer</B> to be able to play it.</P>
<P><B><A NAME=2.1.2>2.1.2. Audio formats</A></B></P>
<P>Currently <B>MPlayer</B> is still a <B>Movie</B> and not a <B>Media</B>
player, thus the pure audio formats (for example MP3, WAV, audio ASF) are
unplayable. Use <A HREF="http://www.xmms.org">xmms</A>, <A HREF="http://www.mpg123.de">mpg123</A>
or whatever.</P>
<P><B>MPlayer</B> is a <B>Movie</B> and not a <B>Media</B> player, although
it can play some audio file formats (they are listed in the sections below).
This is not a recommended usage of <B>MPlayer</B>, you better use
<A HREF="http://www.xmms.org">xmms</A>.</P>
<P><B><A NAME=2.1.2.1>2.1.2.1. MP3 files</A></B></P>
<P>You may have problems playing certain MP3 files that <B>MPlayer</B> will
misdetect as MPEGs and play incorrectly or not at all. This cannot be fixed
without dropping support for certain broken MPEG files and thus will remain
like this for the foreseeable future. The <CODE>-demuxer</CODE> flag described
in the manpage may help you in these cases.</P>
<P><B><A NAME=2.1.2.2>2.1.2.2. WAV files</A></B></P>
<P><B><A NAME=2.1.2.3>2.1.2.3. OGG files (Vorbis)</A></B></P>
<P>Requires properly installed <CODE>libogg</CODE> and
<CODE>libvorbis</CODE>.</P>
<P><B><A NAME=2.1.2.4>2.1.2.4. WMA/ASF files</A></B></P>
<P><B><A NAME=2.1.2.5>2.1.2.5. MP4 files</A></B></P>
</BODY>
</HTML>

View File

@ -1,5 +1,9 @@
<HTML>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
<HEAD>
<META http-equiv="content-type" content="text/html; charset=iso-8859-2">
</HEAD>
<BODY BGCOLOR=WHITE>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -1,143 +1,292 @@
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
</HEAD>
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<FONT CLASS="text">
<P><B><A NAME=2.3.2>2.3.2. Audio output devices</A></P></B>
<P><B><A NAME=2.3.2>2.3.2. Audio output devices</A></B></P>
<P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently
contains these drivers :</P>
contains these drivers:</P>
<TABLE BORDER=0>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD>
<TR><TD COLSPAN=4><P><B><FONT CLASS="text">General:</B></P></TD></TR>
<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>oss</TD><TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS (ioctl) driver</TD></TR>
<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>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>nas</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>NAS (Network Audio System) driver</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.5 driver</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa9</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.9 driver (works, but has problems -> use OSS)</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sun</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SUN audio driver (/dev/audio) for BSD and Solaris8 users</TD></TR>
<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top><FONT CLASS="text">oss</TD><TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">OSS (ioctl) driver</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT CLASS="text">sdl</TD><TD></TD><TD><FONT CLASS="text">SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT CLASS="text">nas</TD><TD></TD><TD><FONT CLASS="text">NAS (Network Audio System) driver</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT CLASS="text">alsa5</TD><TD></TD><TD><FONT CLASS="text">native ALSA 0.5 driver</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT CLASS="text">alsa9</TD><TD></TD><TD><FONT CLASS="text">native ALSA 0.9 driver (works, but has problems -> use OSS)</TD></TR>
<TR><TD></TD><TD VALIGN=top><FONT CLASS="text">sun</TD><TD></TD><TD><FONT CLASS="text">SUN audio driver (/dev/audio) for BSD and Solaris8 users</TD></TR>
</TABLE>
<P>The fact is, Linux soundcard drivers are usually bad, and always as
incompatible as they can be. It MAY take a while to find your optimal settings.</P>
<P><UL>
<LI>if you have OSS as driver, first try with <I>-ao oss</I> (this is the default).
If you experience glitches, halts or anything out of the ordinary, have a
look at <I>-ao sdl</I> (NOTE: of course you'll have to have a new SDL library and its
devel pair installed). It helps in a lot of cases (it also supports ESD, ARTS, and
up/downsampling. /esd is GNOME's, arts is KDE's sound daemon/).</LI>
<LI>if you have ALSA version 0.5, then you ALMOST always have to use <I>-ao alsa5</I> ,
since 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with
<P>Fact is, Linux sound card drivers have compatibility problems.
It <B>may</B> take a while to find your optimal settings.</P>
<UL>
<LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the default).
If you experience glitches, halts or anything out of the ordinary, try
<CODE>-ao sdl</CODE> (NOTE: you need to have SDL libraries and header files
installed). The SDL audio driver helps in a lot of cases and also supports ESD,
ARTS, and up/downsampling. (ESD is the sound daemon from GNOME, ARTS is from KDE.)</LI>
<LI>If you have ALSA version 0.5, then you almost always have to use <CODE>-ao alsa5</CODE> ,
since ALSA 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with
a message like this:<BR>
<UL>
<CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></UL>
</LI>
<LI>if you have ALSA version 0.9, use <I>-ao oss</I> or <I>-ao sdl</I> as you
wish. You can also use <I>-ao alsa9</I> as it works now, however it has many
problems (losing sync, disappearing audio, etc).</LI>
</UL></P>
<CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
<LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE> and
<CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It works, but
there are problems like lost sync and disappearing audio.</LI>
</UL>
<P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the
<I>-ao sun</I> option, otherwise you'll have no video, nor audio playing.</P>
<CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P>
<P><B><A NAME=2.3.2.1>2.3.2.1. Soundcard experiences, recommendations</A></B></P>
<P><B><A NAME=2.3.2.1>2.3.2.1. Sound Card experiences, recommendations</A></B></P>
<P><TABLE BORDER=0 WIDTH=100%>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>VIA onboard chipset (via82cxxx) 48Khz only</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">here</A></TD><TR>
<TABLE BORDER=0 WIDTH="100%">
<TR><TD COLSPAN=3><B><FONT CLASS="text">VIA onboard chipset (via82cxxx) 48kHz only</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">Driver:</TD><TD><FONT CLASS="text"> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">here</A></TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Aureal Vortex 2</B></TD><TR>
<TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD>48</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver2:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
<TD COLSPAN=3><B><FONT CLASS="text">Aureal Vortex 2</B></TD><TR>
<TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">no driver</TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS/Pro:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">no driver</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD>48</TD><TR>
<TD></TD><TD><FONT CLASS="text">Driver:</TD><TD><FONT CLASS="text"><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR>
<TD></TD><TD><FONT CLASS="text">Driver2:</TD><TD><FONT CLASS="text"> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
(<I>buffer size increased to 32k</I>)</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>GUS PnP</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">GUS PnP</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">no driver</TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS/Pro:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">48</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB Live!</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>(?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">SB Live!</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">Analog OK, SP/DIF not working</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">Both OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">192</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB AWE 64</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>max 44kHz</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48kHz sounds shit</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">SB AWE 64</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">max 44kHz</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">48kHz sounds bad</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">48</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound ACE</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>max 44Khz. <I>not OK</I></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">Gravis UltraSound ACE</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">not OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">44</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound MAX</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">Gravis UltraSound MAX</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK (?)</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">48</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ESS 688</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">ESS 688</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK (?)</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">48</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>C-Media cards (which ones?)</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (hissing) (?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">C-Media cards (which ones?)</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">not OK (hissing) (?)</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK (?)</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">?</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Yamaha cards (*ymf*)</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (?) (maybe -ao sdl)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <I>-ao sdl</I> (!) (?)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">Yamaha cards (*ymf*)</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">?</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR>
<TD COLSPAN=3><B><FONT CLASS="text">Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">?</TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS/Pro:</TD><TD><FONT CLASS="text">OK</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">?</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">?</TD><TR>
<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PC Speaker or DAC</B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (<I>use the SDL driver : -ao sdl</I>)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>the driver emulates 44.1 maybe more</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD><TR>
</TABLE></P>
<TD COLSPAN=3><B><FONT CLASS="text">PC Speaker or DAC</B></TD><TR>
<TD></TD><TD><FONT CLASS="text">OSS:</TD><TD><FONT CLASS="text">OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD><TR>
<TD></TD><TD><FONT CLASS="text">ALSA:</TD><TD><FONT CLASS="text">no driver</TD><TR>
<TD></TD><TD><FONT CLASS="text">Max kHz:</TD><TD><FONT CLASS="text">The driver emulates 44.1, maybe more.</TD><TR>
<TD></TD><TD><FONT CLASS="text">Driver:</TD><TD><FONT CLASS="text"><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD>
</TABLE>
<P><UL>
<LI>on Linux, use at least kernel 2.4 if possible, 2.2 isn't tested
<LI>if sound clicks when playing from CD-ROM, turn on IRQ unmasking !
for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!)
This is recommended anyways... (for XMMS, etc...)
Read section <A HREF="cd-dvd.html#4.1">4.1</A>.
<LI>don't use your soundcard by other application ( for ex. XMMS ) !
if you use ESD, start MPlayer with the '-vo sdl:esd' option !
<LI>Please tell us how MPlayer and your soundcard(s) worked together!
</UL></P>
<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#4.1">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><B><A NAME=2.3.2.2>2.3.2.2. Audio plugins</B></P>
<P><B><A NAME=2.3.2.2>2.3.2.2. Audio plugins</A></B></P>
<P><B><A NAME=2.3.2.2.1>2.3.2.2.1. Up/Downsampling</B></P>
<P><B>MPlayer</B> has support for audio plugins. Audio plugins can be used for
changing the properties of the audio data before the sound reaches the sound
card. They are enabled using the <CODE>-aop</CODE> switch which takes a
<CODE>list=plugin1,plugin2,...</CODE> argument. The <CODE>list</CODE> argument
is required and determines which plugins should be used and in which order they
should be executed. Example:
</P>
<P><B>MPlayer</B> fully supports up/downsampling of audio stream.
It is not autodetected, so you have to specify it explicitly even when
for example you have a max 44.1Khz capable soundcard, and the audio
is 48Khz. Also, this functionality is currently unimplemented in
<B>MEncoder</B>.</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
<P>Usage :<BR>
<P>would run the sound through the resampling plugin followed by the format
plugin.
</P>
<P>The plugins can also have switches that change their behavior. These
switches are explained in detail in the sections below. A plugin will execute
using default settings if its switches are omitted. Here is an example of how
to use plugins in combination with plugin specific switches:
</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=resample,format:fout=44100:format=0x8</CODE>
</P>
<P>would set the output frequency of the resample plugin to 44100Hz and the
output format of the format plugin to AFMT_U8.
</P>
<P>Currently audio plugins can not be used in <B>MEncoder</B>.</P>
<P><B><A NAME=2.3.2.2.1>2.3.2.2.1. Up/Downsampling</A></B></P>
<P><B>MPlayer</B> fully supports up/downsampling of the sound. This plugin can
be used if you have a fixed frequency sound card or if you are
stuck with an old sound card that is only capable of max 44.1kHz.
Limitations in your hardware are not auto detected, so you have to specify
the sample frequency explicitly. This plugin has one switch:
<CODE>fout</CODE> which is used for setting the desired output sample
frequency. It defaults to 48kHz, and is given in
&lt;Hz&gt;.
</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
frequency in Hz, like 44100&gt;</CODE></P>
<P>Note that the output frequency should not be scaled up from the default value.
Scaling up will cause the audio and video streams to be played in slow motion
in addition to audio distortion.</P>
<P><B><A NAME=2.3.2.2.2>2.3.2.2.2. Surround Sound decoding</A></B></P>
<P><B>MPlayer</B> has an audio plugin that can decode matrix encoded
surround sound. Dolby Surround is an example of a matrix encoded format.
Many files with 2 channel audio actually contain matrixed surround sound.
To use this feature you need a sound card supporting at least 4 channels.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
<P><B><A NAME=2.3.2.2.3>2.3.2.2.3. Sample format converter</A></B></P>
<P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type,
this plugin can
be used to change the format to one which your sound card can understand. It
has one switch, <CODE>format</CODE>, which can be set to one of the numbers
found in <CODE>libao2/afmt.h</CODE>. This plugin is hardly ever needed and is
intended for advanced users. Keep in mind that this plugin only changes the
sample format and not the sample frequency or the number of channels.
</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=format:format=&lt;required output format&gt;</CODE>
</P>
<P><B><A NAME=2.3.2.2.4>2.3.2.2.4. Delay</A></B></P>
<P>This plugin delays the sound and is intended as an example of how to develop
new plugins. It can not be used for anything useful from a users perspective
and is mentioned here for the sake of completeness only. Do not use this
plugin unless you are a developer.</P>
<P><B><A NAME=2.3.2.2.5>2.3.2.2.5. Software volume control</A></B></P>
<P>This plugin is a software replacement for the volume control, and
can be used on machines with a broken mixer device. It can also be
used if one wants to change the output volume of <B>MPlayer</B>
without changing the PCM volume setting in the mixer. It has one
switch <CODE>volume</CODE> that is used for setting the initial
sound level. The initial sound level can be set to values between 0
and 255 and defaults to 101 which equals 0dB amplification. Use this
plugin with caution since it can reduce the signal to noise ratio of
the sound. In most cases it is best to set the level for the PCM
sound to max, leave this plugin out and control the output level to
your speakers with the master volume control of the mixer. If there is an
external amplifier connected to the computer (this is almost always
the case), the noise level can be minimized by adjusting the master
level and the volume knob on the amplifier until the hissing noise
in the background is gone.
</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=volume:volume=&lt;0-255&gt;</CODE>
</P>
<P>This plugin also has compressor or "soft-clipping" capabilities.
Compression can be used if the dynamic range of the sound is very
high or if the dynamic range of the loudspeakers is very
low. Be aware that this feature creates distortion and should be
considered a last resort.
</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
list=volume:softclip</CODE>
</P>
<P><B><A NAME=2.3.2.2.6>2.3.2.2.6. Extrastereo</A></B></P>
<P>This plugin (linearly) increases the difference between left and right
channels (like the XMMS extrastereo plugin) which gives some sort of "live"
effect to playback.
</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=extrastereo:mul=3.45</CODE></P>
<P>The default coefficient (<CODE>mul</CODE>) is a float number that defaults
to 2.5. If you set it to 0.0, you will have mono sound (average of both
channels). If you set it to 1.0, sound will be unchanged.</P>
<P><B><A NAME=2.3.2.2.7>2.3.2.2.7. Volume normalizer</A></B></P>
<P>This plugin maximizes the volume without distorting the sound.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
<P><B><A NAME=2.3.2.2.8>2.3.2.2.8. Surround</A></B></P>
<P>Someone should document something, sometime.</P>
</BODY>
</HTML>

View File

@ -1,4 +1,9 @@
<HTML>
<HEAD>
<META http-equiv="content-type" content="text/html; charset=iso-8859-2" />
</HEAD>
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>

View File

@ -1,104 +1,19 @@
<HTML>
<HEAD>
<STYLE>
.text
{font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;}
</STYLE>
</HEAD>
<BODY BGCOLOR=white>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
<FONT CLASS="text">
<P><B><A NAME=2.3.1>2.3.1. Video output devices</A></B></P>
<TABLE BORDER=0>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica,
sans-serif" size=2><A HREF=#2.3.1.13>x11</A></TD><TD>&nbsp;&nbsp;</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>gl</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><A HREF=#2.3.1.10>gl2</A></TD><TD></TD><TD><FONT face="Verdana, Arial,
Helvetica, sans-serif" size=2>OpenGL renderer, multiple textures version</TD><TR>
<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>
&nbsp;&nbsp;<CODE>1.1.7:</CODE> supports software scaling<BR>
&nbsp;&nbsp;<CODE>1.1.8:</CODE> supports Xvideo (hardware scaling/fullscreen)<BR>
&nbsp;&nbsp;<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><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></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif"
size=2>directfb</TD><TD></TD><TD><FONT face="Verdana, Arial,
Helvetica, sans-serif" size=2>Direct Framebuffer Device</TD><TR>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif"
size=2>Card specific:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica,
sans-serif" size=2><A HREF=#2.3.1.7>mga</A></TD><TD>&nbsp;&nbsp;</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><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>&nbsp;&nbsp;</TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica,
sans-serif" size=2>png</TD><TD>&nbsp;&nbsp;</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>null</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif"
size=2>Null output (for speed tests/benchmarking)</TD><TR>
</TABLE>
<P>NOTE: <I>check the following subsections for details and requirements!</I></P>
<P><B><A NAME=2.3.1.1>2.3.1.1. Setting up MTRR</A></B></P>
@ -161,8 +76,12 @@ to check it').</P>
<P><B><A NAME=2.3.1.2>2.3.1.2. Xv</A></B></P>
<P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines
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>
using the XVideo extension. This is what the option '-vo xv' uses. Also,
this is driver supports adjusting brightness/contrast/hue/etc (unless you use
the old, slow DirectShow DivX codec, which supports it everywhere), see the
manpage.</P>
<P>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 hardware acceleration (modern cards do)
@ -215,8 +134,8 @@ usable with <B>MPlayer</B>.</P>
<P>Older 3dfx drivers were known to have problems with XVideo acceleration,
it didn't support either YUY2 or YV12, and so. Verify that you have
XFree86 version 4.1.0 or greater, it works ok. Alternatively, you can use
<A HREF="http://dri.sourceforge.net">DRI</A> cvs.
XFree86 version 4.2.0 or greater, it works ok with YV12 and YUY2. Previous
versions, including 4.1.0 <B>crashes with YV12</B>!
If you experience strange effects using -vo xv, try SDL (it has XVideo too)
and see if it helps. Check the <A HREF="#2.3.1.4">SDL section</A> for details.</P>
@ -227,17 +146,20 @@ section!</P>
<P><B><A NAME=2.3.1.2.2>2.3.1.2.2. S3 cards</A></B></P>
<P>S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3
or greater (in case of image problems, try 16bpp). As for S3 Virge.. sell it.</P>
or greater (in case of image problems, try 16bpp). As for S3 Virge.. there is
xv support, but the card itself is very slow, so you better sell it.</P>
<P><B>NOTE</B>: Savage cards have a slow YV12 image displaying capability (it needs
to do YV12->YUY2 conversion, because the Savage hardware can't display YV12).
So when this documentation says at some point "this has YV12 output use this,
it's faster", it's not sure. Try.</P>
it's faster", it's not sure. Try <A HREF="http://www.mplayerhq.hu/MPlayer/contrib/Savage-driver/savage_drv.o.mmx2.bz2">this
driver</A>, it uses MMX2 for this task and is faster than the native X driver.</P>
<P><B><A NAME=2.3.1.2.3>2.3.1.2.3. nVidia cards</A></B></P>
<P>nVidia isn't a very good choice under Linux.. You'll have to use the
<P>nVidia isn't a very good choice under Linux (according to NVidia, this
is <A HREF="users_against_developers.html#nvidia">not true</A>).. You'll have to use the
binary closed-source nVidia driver, available at nVidia's website. The standard XFree86
driver doesn't support XVideo for these cards, due to nVidia's closed
sources/specifications.</P>
@ -252,28 +174,39 @@ Complain to NVidia.</UL></P>
<P><B><A NAME=2.3.1.2.4>2.3.1.2.4. ATI cards</A></B></P>
<P>
<LI>The GATOS driver (which you should use) has VSYNC enabled by default. It means that decoding speed
(!) is synced to the monitor's refresh rate. If playing seems to be slow, try
disabling VSYNC somehow, or set refresh rate to n*(fps of the movie) Hz.</LI>
<LI>The <A HREF="http://www.linuxvideo.org/gatos">GATOS driver</A> (which you
should use, unless you have Rage128 or Radeon) has VSYNC enabled by default. It
means that decoding speed (!) is synced to the monitor's refresh rate. If
playing seems to be slow, try disabling VSYNC somehow, or set refresh rate to
n*(fps of the movie) Hz.</LI>
<LI>Radeon VE - currently only XFree86 CVS has driver for this card, version
4.1.0 doesn't. And no TV out support. Of course with <B>MPlayer</B> you can
happily get <B>accelerated</B> display, with or without <B>TV output</B>, and
no libraries or X are needed. Read <a href=#2.3.1.12>VESA driver</a> and <A
HREF=#2.3.1.14>Radeon video overlay</A> sections).</LI> </P>
no libraries or X are needed. Read <A HREF=#2.3.1.15>Vidix</A> section.</LI>
</P>
<P><B><A NAME=2.3.1.2.5>2.3.1.2.5. NeoMagic cards</A></B></P>
<P>These cards can be found in many laptops. Unfortunately, the driver in
X 4.2.0 can't do Xv, but we have a modified, Xv-capable driver for you.
<A HREF="http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver/neomagic_drv.o.4.2.0.bz2">Download from here</A>.
Driver provided by Stefan Seyfried.</P>
<P>To allow playback of DVD sized content change your XF86Config like this :</P>
<P>
These cards can be found in many laptops. Under Linux, their peak is only DGA.
Unfortunately, the DGA driver in X 4.1.0 doesn't work, you'll have to wait for
4.2.0, or download a modified driver for 4.0.3 or 4.1.0 from here :
<A HREF="http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver">http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver</A>
(there is also the patch to the driver's source).<BR>
Drivers provided by <A HREF="mailto:tomee@cpi.pl">Tomek Jarzynka</A>.
Section "Device"<BR>
&nbsp; &nbsp; <I>[...]</I><BR>
&nbsp; &nbsp; Driver "neomagic"<BR>
&nbsp; &nbsp; <B>Option "OverlayMem" "829440"</B><BR>
&nbsp; &nbsp; <I>[...]</I><BR>
EndSection
</P>
<P><B><A NAME=2.3.1.2.6>2.3.1.2.6. Trident cards</A></B></P>
<P>If you want to use xv with a trident card, provided that it doesn't
@ -498,24 +431,43 @@ also help. Thanks!</P>
<P><B><A NAME=2.3.1.4>2.3.1.4. SDL</A></B></P>
<P>SDL (Simple Directmedia Layer) is basically an unified video/audio
interface. Programs that use it know only about SDL, and not about what video
or audio driver does SDL actually use. For example a Doom port using SDL can
run on svgalib, aalib, X, fbdev, and others, you only have to specify the
(for example) video driver to use with the SDL_VIDEODRIVER environment
variable. Well, in theory.</P>
<P>With <B>MPlayer</B>, we used its X11 driver's software scaler ability for
cards/drivers that doesn't support XVideo, until we made our own (faster,
nicer) software scaler. Also we used its aalib output, but now we have ours
which is more comfortable. Its DGA mode was better than ours, until
recently. Get it now? :)</P>
<P>It also helps with some buggy drivers/cards if the video is jerky
(not slow system problem), or audio is lagging.</P>
<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><TABLE BORDER=0>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>There are several commandline switches for SDL:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-vo sdl:name</TD><TD>&nbsp;&nbsp;</TD><TD>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specifies sdl video driver to use (ie. aalib, dga, x11)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-ao sdl:name</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specifies sdl audio driver to use (ie. dsp,
<TD COLSPAN=4><P><B><FONT CLASS="text">There are several commandline switches for SDL:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">-vo sdl:name</TD><TD>&nbsp;&nbsp;</TD><TD>
<FONT CLASS="text">specifies sdl video driver to use (ie. aalib, dga, x11)</TD><TR>
<TD></TD><TD><FONT CLASS="text">-ao sdl:name</TD><TD></TD><TD><FONT CLASS="text">specifies sdl audio driver to use (ie. dsp,
esd, arts)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-noxv</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>disables Xvideo hardware acceleration</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-forcexv</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>tries to force Xvideo acceleration</TD><TR>
<TD></TD><TD><FONT CLASS="text">-noxv</TD><TD></TD><TD><FONT CLASS="text">disables Xvideo hardware acceleration</TD><TR>
<TD></TD><TD><FONT CLASS="text">-forcexv</TD><TD></TD><TD><FONT CLASS="text">tries to force Xvideo acceleration</TD><TR>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SDL Keys:</B></P></TD><TR>
<TD COLSPAN=4><P><B><FONT CLASS="text">SDL Keys:</B></P></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>F</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggles fullscreen/windowed mode</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>C</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>cycles available fullscreen modes</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>W/S</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mappings for * and / (mixer control)</TD><TR>
<TD></TD><TD><FONT CLASS="text">F</TD><TD></TD><TD><FONT CLASS="text">toggles fullscreen/windowed mode</TD><TR>
<TD></TD><TD><FONT CLASS="text">C</TD><TD></TD><TD><FONT CLASS="text">cycles available fullscreen modes</TD><TR>
<TD></TD><TD><FONT CLASS="text">W/S</TD><TD></TD><TD><FONT CLASS="text">mappings for * and / (mixer control)</TD><TR>
</TABLE></P>
@ -550,13 +502,13 @@ whatever. And don't forget to register your UniVBE ;))</P>
<P>The FBdev output takes some additional parameters above the others:</P>
<P><TABLE BORDER=0>
<TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fb</TD><TD>&nbsp;&nbsp;</TD><TD>
<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specify the framebuffer device to use (/dev/fd0)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fbmode</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mode name to use (according to /etc/fb.modes)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fbmodeconfig</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> config file of modes (default /etc/fb.modes)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_hfreq</TD><TD></TD><TD ROWSPAN=3><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>IMPORTANT values, see example.conf</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_vfreq</TD><TD></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_dotclock</TD><TD></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">-fb</TD><TD>&nbsp;&nbsp;</TD><TD>
<FONT CLASS="text">specify the framebuffer device to use (/dev/fb0)</TD><TR>
<TD></TD><TD><FONT CLASS="text">-fbmode</TD><TD></TD><TD><FONT CLASS="text">mode name to use (according to /etc/fb.modes)</TD><TR>
<TD></TD><TD><FONT CLASS="text">-fbmodeconfig</TD><TD></TD><TD><FONT CLASS="text"> config file of modes (default /etc/fb.modes)</TD><TR>
<TD></TD><TD><FONT CLASS="text">-monitor_hfreq</TD><TD></TD><TD ROWSPAN=3><FONT CLASS="text">IMPORTANT values, see example.conf</TD><TR>
<TD></TD><TD><FONT CLASS="text">-monitor_vfreq</TD><TD></TD><TR>
<TD></TD><TD><FONT CLASS="text">-monitor_dotclock</TD><TD></TD><TR>
</TABLE></P>
<P>If you want to change to a specific mode, then use</P>
@ -570,9 +522,11 @@ Pay attention to the bpp value, fbdev driver tries to use the current,
or if you specify the -bpp option, then that.</LI>
<LI><B>-zoom</B> option isn't supported (software scaling is slow). -fs option
isn't supported. You can't use 8bpp (or less) modes.</LI>
<LI>you possibly want to turn the cursor off : <CODE>echo -e '\033[?25l'</CODE><BR>
<LI>you possibly want to turn the cursor off : <CODE>echo -e '\033[?25l'</CODE>
or <CODE>setterm -cursor off</CODE><BR>
and the screen saver: <CODE>setterm -blank 0</CODE><BR>
To turn the cursor back on : <CODE>echo -e '\033[?25h'</CODE>
or <CODE>setterm -cursor on</CODE>
</UL></P>
<P>NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
@ -585,6 +539,9 @@ support, the mga_vid kernel driver. It's active developed by me (A'rpi), and
it has hardware VSYNC support with triple buffering. It works on both
framebuffer console and under X.</P>
<P><B>WARNING</B>: on non-Linux systems, use <A HREF=#2.3.1.15>Vidix</A> for
mga_vid !!!</P>
<P>To use it, you first have to compile mga_vid.o:</P>
<P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;cd drivers<BR>
@ -622,6 +579,10 @@ you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x.</P>
<P>The mga_vid driver cooperates with Xv.</P>
<P>The <CODE>/dev/mga_vid</CODE> device file can be read (for example by
<CODE>cat /dev/mga_vid</CODE>) for some info, and written for brightness
change : <CODE>echo "brightness=120" > /dev/mga_vid</CODE></P>
<P><B><A NAME=2.3.1.8>2.3.1.8. SiS 6326 framebuffer (sis_vid)</A></B></P>
@ -657,29 +618,29 @@ Quake, etc. MPlayer contains a very usable driver for it.
If ./configure detects aalib installed, the aalib libvo driver will be built.</P>
<P><TABLE BORDER=0>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>You can use some keys in the AA Window to change rendering options:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>1</TD><TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease contrast</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>2</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>increase contrast</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>3</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease brightness</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>4</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>increase brightness</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>switch fast rendering on/off</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>6</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set dithering mode (none, error distribution, floyd steinberg)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>7</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>invert image</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>a</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggles between aa and mplayer control)</TD><TR>
<TD COLSPAN=4><P><B><FONT CLASS="text">You can use some keys in the AA Window to change rendering options:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">1</TD><TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">decrease contrast</TD><TR>
<TD></TD><TD><FONT CLASS="text">2</TD><TD></TD><TD><FONT CLASS="text">increase contrast</TD><TR>
<TD></TD><TD><FONT CLASS="text">3</TD><TD></TD><TD><FONT CLASS="text">decrease brightness</TD><TR>
<TD></TD><TD><FONT CLASS="text">4</TD><TD></TD><TD><FONT CLASS="text">increase brightness</TD><TR>
<TD></TD><TD><FONT CLASS="text">5</TD><TD></TD><TD><FONT CLASS="text">switch fast rendering on/off</TD><TR>
<TD></TD><TD><FONT CLASS="text">6</TD><TD></TD><TD><FONT CLASS="text">set dithering mode (none, error distribution, floyd steinberg)</TD><TR>
<TD></TD><TD><FONT CLASS="text">7</TD><TD></TD><TD><FONT CLASS="text">invert image</TD><TR>
<TD></TD><TD><FONT CLASS="text">a</TD><TD></TD><TD><FONT CLASS="text">toggles between aa and mplayer control)</TD><TR>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>The following command line options can be used:</B></P></TD><TR>
<TD COLSPAN=4><P><B><FONT CLASS="text">The following command line options can be used:</B></P></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaosdcolor=V</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change osd color</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aasubcolor=V</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change subtitle color</TD><TR>
<TD COLSPAN=3></TD><TD><P><I><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>where V can be: (0/normal, 1/dark, 2/bold, 3/boldfont, 4/reverse, 5/special)</P></TD><TR>
<TD></TD><TD><FONT CLASS="text">-aaosdcolor=V</TD><TD></TD><TD><FONT CLASS="text">change osd color</TD><TR>
<TD></TD><TD><FONT CLASS="text">-aasubcolor=V</TD><TD></TD><TD><FONT CLASS="text">change subtitle color</TD><TR>
<TD COLSPAN=3></TD><TD><P><I><FONT CLASS="text">where V can be: (0/normal, 1/dark, 2/bold, 3/boldfont, 4/reverse, 5/special)</P></TD><TR>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>AAlib itselves provides a large sum of options.
<TD COLSPAN=4><P><B><FONT CLASS="text">AAlib itselves provides a large sum of options.
Here are some important:</P></B></TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aadriver</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set recommended aa driver (X11, curses, linux)</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaextended</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use all 256 characters</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaeight</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use eight bit ascii</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aahelp</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>prints out all aalib options</TD><TR>
<TD></TD><TD><FONT CLASS="text">-aadriver</TD><TD></TD><TD><FONT CLASS="text">set recommended aa driver (X11, curses, linux)</TD><TR>
<TD></TD><TD><FONT CLASS="text">-aaextended</TD><TD></TD><TD><FONT CLASS="text">use all 256 characters</TD><TR>
<TD></TD><TD><FONT CLASS="text">-aaeight</TD><TD></TD><TD><FONT CLASS="text">use eight bit ascii</TD><TR>
<TD></TD><TD><FONT CLASS="text">-aahelp</TD><TD></TD><TD><FONT CLASS="text">prints out all aalib options</TD><TR>
</TABLE></P>
<P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X
@ -756,14 +717,14 @@ in vm86 mode).<BR>
<P>
<TABLE BORDER=0>
<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>These switches of command line currently are available for VESA:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-vo vesa:opts</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>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>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-screenw, -screenh, -bpp</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>force userdefined mode</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-x, -y</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set userdefined prescaling</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-zoom</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>enables userdefined prescaling</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fs</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>scales image to fullscreen</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fs -zoom</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>scales userdefined prescaling to fullscreen</TD><TR>
<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-double</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>enables double buffering mode. (Available only in DGA mode). Should be slower of single buffering, but has no flickering effects.</TD><TR>
<TD COLSPAN=4><P><B><FONT CLASS="text">These switches of command line currently are available for VESA:</B></P></TD><TR>
<TD>&nbsp;&nbsp;</TD><TD><FONT CLASS="text">-vo vesa:opts</TD><TD></TD><TD><FONT CLASS="text">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>
<TD></TD><TD><FONT CLASS="text">-screenw, -screenh, -bpp</TD><TD></TD><TD><FONT CLASS="text">force userdefined mode</TD><TR>
<TD></TD><TD><FONT CLASS="text">-x, -y</TD><TD></TD><TD><FONT CLASS="text">set userdefined prescaling</TD><TR>
<TD></TD><TD><FONT CLASS="text">-zoom</TD><TD></TD><TD><FONT CLASS="text">enables userdefined prescaling</TD><TR>
<TD></TD><TD><FONT CLASS="text">-fs</TD><TD></TD><TD><FONT CLASS="text">scales image to fullscreen</TD><TR>
<TD></TD><TD><FONT CLASS="text">-fs -zoom</TD><TD></TD><TD><FONT CLASS="text">scales userdefined prescaling to fullscreen</TD><TR>
<TD></TD><TD><FONT CLASS="text">-double</TD><TD></TD><TD><FONT CLASS="text">enables double buffering mode. (Available only in DGA mode). Should be slower of single buffering, but has no flickering effects.</TD><TR>
</TABLE>
</P>
@ -815,59 +776,201 @@ video modes.</P>
<P><B><A NAME=2.3.1.14>2.3.1.14. Rage128 (Pro) / Radeon video overlay (radeon_vid)</A></B></P>
<P>
<b>radeon_vid</b> and <B>rage128_vid</B> provides support for the <b>BackEnd Scaler</b> on ATI <b>Radeon</b> and Rage128 (Pro) chipsets.
It was designed and introduced as analog of <a href="video.html#2.3.1.7">mga_vid</a> driver, so you can use it in the same way!<br>
But main goal of this driver usage is <a href="video.html#2.3.1.12">VESA</a> driver.<br>
Simply because VESA enables TV-out on ATI's card but Backend scaler is used after
mode switching. This implementation outputs video stream on both: <b>TV-screen</b> and <b>CRTC</b>
display simultaneously. (It slightly degrades quality of video output but it's
much better than nothing).
Sorry! I couldn't find out any video overlay's related information
on ATI pages. (I planned to implement it through <b>int 10h</b> calls). But it was
very easy to implement this stuff through reading/writing Radeon ports.
<br><b>NOTE</b>: XXX_VID technology is perfectly undocumented and maybe in the
future this stuff will be fully rewritten. This is the first public release of
driver.</P>
<P><B>Installation</B></P>
<P>This section is OBSOLETED ! Use Vidix !</P>
<P><B><A NAME=2.3.1.15>2.3.1.15. VIDIX</A></B></P>
<P><B><I>WHAT IS VIDIX</I></B></P>
<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
providing <b>DGA</b> everywhere where it's possible (<b>unlike X11</b>). I
hope that these drivers will be as portable as X11 (<b>not only on
*nix</b>).<BR>
What is it:
<LI>It's a portable successor of mga_vid technology, but it's located in
user-space.</LI>
<LI>Unlike X11 it provides DGA everywhere it's possible</LI>
<LI>Unlike v4l it provides interface for video playback</LI>
<LI>Unlike linux's drivers it uses mathematics library</LI>
</P>
<P>I can tell you in bold capital letters :<BR>
<b>VIDIX PROVIDES DIRECT GRAPHICS ACCESS TO BES YUV MEMORY.</b>
</P>
<P><i>Well (it's in my todo) - implement DGA to MPEG2 decoder.</i></P>
<P>This interface was designed as an attempt to fit existing video acceleration
interfaces (known as mga_vid, mga_yuv, radeon_vid) into a fixed scheme. It
provides highlevel interface to chips which are known as BES (BackEnd
scalers) or OV (Video Overlays). It doesn't provide lowlevel interface to
things which are known as graphics servers. (I don't want to compete with X11
team in graphics mode switching). I.e. main goal of this interface is to
provide maximal speed of video playback but not putting video signal on
screen of your TV or on tape of your VCR. Although these things are also very
significant - it's perfectly other task. (However I guess that it would be
possible to implement something like mini-X (don't mix it with Minix ;) in
the future, if some number of volunteers will be found.
</P>
<P><B><I>USAGE</I></B></P>
<P>
<LI>You can use standalone video output driver: <CODE>-vo xvidix</CODE><BR>
This driver was developed as X11's front end to VIDIX technology. It
requires XServer and can work only under XServer.</LI>
<LI>You can use VIDIX subdevice which was applied to several video output
drivers, such as:<BR>
<CODE>-vo vesa:vidix</CODE> and <CODE>-vo fbdev:vidix</CODE></LI>
Indeed it doesn't matter which video output driver is used with <b>VIDIX</b>.
</P>
<P><B><I>REQUIREMENTS</I></B></P>
<P>
<LI>video card should be in graphics mode (I write <b>should</b> simply
because I tested it in text mode - it works but has awful output ;) Use
AAlib for that).<BR>
<I>Note: Everyone can try this trick by commenting out mode switching in
vo_vesa driver.</I></LI>
<LI><B>MPlayer</B>'s video output driver should know active video mode and be
able to tell to VIDIX subdevice some video characteristics of server.</LI>
I hope that probably every video output driver of <B>MPlayer</B> will
recognize <CODE>:vidix</CODE> subdevice.
</P>
<P><B><I>USAGE METHODS</I></B></P>
<P>When VIDIX is used as <b>subdevice</b> (<CODE>-vo vesa:vidix</CODE>) then
video mode configuration is performed by video output device
(<b>vo_server</b> in short). Therefore you can pass into command line of
<B>MPlayer</B> the same keys as for vo_server. In addition it understands
<CODE>-double</CODE> key as globally visible parameter. (I recommend using
this key with VIDIX at least for ATI's card).<BR>
As for <CODE>-vo xvidix</CODE> : currently it recognizes the following
options: <CODE>-fs -zoom -x -y -double</CODE>.<BR>
</P>
<P>Also you can specify VIDIX's driver directly as third subargument in command
line :<BR>
<BR>
&nbsp;&nbsp;<code>mplayer -vo xvidix:mga_vid.so -fs -zoom -double
file.avi</code><BR>
or<BR>
&nbsp;&nbsp;<code>mplayer -vo vesa:vidix:radeon_vid.so -fs -zoom -double -bpp
32 file.avi</code><BR>
<BR>
But it's dangerous, and you shouldn't do that. In this case given driver will
be forced and result is unpredictable (it may <b>freeze</b> your
computer). You should do that ONLY if you are absolutely sure it will work,
and <B>MPlayer</B> doesn't do it automatically. Please tell about it to the
developers. The Right Way is to use VIDIX without arguments to enable driver
autodetection.
</P>
<P>
VIDIX is very new technology and it's extremely possible that on your system
(OS=abc CPU=xyz) it won't work. In this case only solution for you it's port
it (mainly libdha). But there is hope that it will work on those systems
where X11 does.
</P>
<P>And the last <b>WARNING</b>: (un)fortunately you <b>MUST</b> have
<b>ROOT</b> privileges to use VIDIX due to direct hardware access. At least
set the <b>suid</b> bit on the <B>MPlayer</B> excecutable.
</P>
<P><B><I>VIDEO EQUALIZER</I></B></P>
<P>
This is a video equalizer implemented especially for Vidix. You can use
it either with <B>1-8</B> keys as described in the manpage, or
by command line arguments. <B>MPlayer</B> recognizes the
following options :
</P>
<P>
&nbsp;&nbsp;<CODE>-brightness</CODE> - 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.<BR>
&nbsp;&nbsp;<CODE>-contrast</CODE> - adjust <B>CONTRAST</B> of video output.
Works in similar manner as brightness.<BR>
&nbsp;&nbsp;<CODE>-saturation</CODE> - adjust <B>SATURATION</B> of video
output. You can get grayscale output with this option.<BR>
&nbsp;&nbsp;<CODE>-hue</CODE> - adjust <B>HUE</B> of video signal. You can
get colored negative of image with this option.<BR>
&nbsp;&nbsp;<CODE>-red_intensity</CODE> - adjust intensity of <B>RED</B>
component of video signal.<BR>
&nbsp;&nbsp;<CODE>-green_intensity</CODE> - adjust intensity of <B>GREEN</B>
component of video signal.<BR>
&nbsp;&nbsp;<CODE>-blue_intensity</CODE> - adjust intensity of <B>BLUE</B>
component of video signal.
</P>
<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>
<P>
<B>Note:</B> Not every driver provides support for each of those parameters.
Currently only <B>radeon_vid.so</B> provides full support for video eqalizing.
Other drivers only partly support these options.
</P>
<P><B>Examples:</B><BR>
<CODE>mplayer -vo vesa:vidix -brightness -300 -contrast 200
filename.avi</CODE><BR>
or<BR>
<CODE>mplayer -vo xvidix -red_intensity -50 -saturation 400 -hue 300
filename.vob</CODE>
</P>
<P><B><A NAME=2.3.1.16>2.3.1.16. Zr</A></B></P>
<P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG
capture/playback cards (tested for DC10+ and Buz, and it should work for the
LML33, the DC10). The driver works by encoding the frame to jpeg and then
sending it to the card. For the jpeg encoding <B>libavcodec</B> is
used, and required.</P>
<P>This driver talks to the kernel driver available at
<A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so
you must get it working first. Then recompile <B>MPlayer</B> with
<CODE>--enable-zr</CODE>.</P>
<P>Some remarks:
<UL>
<LI>
<CODE>cd drivers/radeon<BR>
make<BR>
make install<BR>
make nodes</CODE></LI>
<LI>add one of the following at the end of the <CODE>/etc/modules.conf</CODE> file :<BR>
<CODE>&nbsp;&nbsp;alias char-major-178 radeon_vid</CODE><BR>
<CODE>&nbsp;&nbsp;alias char-major-178 rage128_vid</CODE></LI>
<LI>run <CODE>depmod -a</CODE></LI>
<LI>don't start or stop XawTV on the playback device during playback,
it will crash your computer. It is, however, fine to <B>FIRST</B> start
XawTV, <B>THEN</B> start <B>MPlayer</B>, wait for <B>MPlayer</B> to finish
and <B>THEN</B> stop XawTV.</LI>
<LI>this driver adds <CODE>-zr*</CODE> commandline options. The explanation
of these options can be viewed with <CODE>-zrhelp</CODE>. It is possible to
crop the input frame (cut borders to make it fit or to enhance performace)
and to do other things.</LI>
<LI>the driver takes data in YV12 and YUY2 format, this means that some
codecs won't work. Some old VfW (Video for Windows) codecs, for example,
are incompatible with this driver. The errormessage that you will see is:
<CODE>Sorry, selected video_out device is incompatible with this codec.
</CODE></LI>
<LI>OSD is currently not supported, so you won't see
subtitles.</LI>
</UL>
</P>
<P>
<br><b>Usage:</b><BR>
&nbsp;&nbsp;<CODE>mplayer -vo vesa:lvo:/dev/radeon_vid &lt;your options&gt; filename</CODE>
</P>
<P>More examples (for hardware deinterlacing, etc) can be found
<A HREF="../drivers/radeon/README">here</A>.</P>
<P><B>NOTE</B>: don't use any framebuffers when you plan to use this driver ! Use
it only from textmode console.</P>
<P>
<b>Conclusion:</b> I know there are lot of lacks and bugs. So if you are able
to improve something then simply send me your patches.
</P>
<P><B><A NAME=2.3.1.A>2.3.1.A. TV-out support</A></B></P>
<P><B><A NAME=2.3.1.A.1>2.3.1.A.1. Matrox cards</A></B></P>
<P><B><A NAME=2.3.1.A.1>2.3.1.A.1. Matrox G400 cards</A></B></P>
<P>Under Linux you have 2 methods to get TV out working :</P>
<P>Under Linux you have 2 methods to get G400 TV out working :</P>
<P><B>IMPORTANT:</B> Only Matrox G400DH/G400MAX has TV-out support under Linux, others (G450, G550) has <B>NOT!</B></P>
<P>
<UL>
@ -880,11 +983,14 @@ to improve something then simply send me your patches.
3D engine to zoom, and the YUV framebuffer to display the zoomed
image. If you really want to use X, use the <CODE>-vo x11 -fs -zoom</CODE>
options, but it will be <B>SLOW</B>, and has <B>Macrovision</B> copyprotection
enabled.</LI>
enabled (you can "workaround" Macrovision using
<A HREF="http://avifile.sourceforge.net/mgamacro.pl">this</A> perl
script.</LI>
<LI><B>Framebuffer</B>: using the <B>matroxfb modules</B> in the 2.4 kernels.
2.2 kernels don't have the TVout feature in them, thus unusable for this.
You have to enable ALL matroxfb-specific feature during compilation (except
MultiHead), and compile them into <B>modules</B>!
MultiHead), and compile them into <B>modules</B>! You'll also need I2C
enabled.
<UL>
<LI>
Enter <CODE>TVout/matroxset</CODE> and type <CODE>make</CODE>. Install
@ -911,13 +1017,14 @@ to improve something then simply send me your patches.
and turn off screen blanking. Execute the following commands:</P>
<P>
<CODE>echo -e '\033[?25l'<BR>
<CODE>echo -e '\033[?25l'</CODE> or <CODE>setterm -cursor off<BR>
setterm -blank 0</CODE>
</P>
<P>
You possibly want to put the above into a script, and also clear
the screen.. To turn the cursor back :<BR><CODE>echo -e '\033[?25h'</CODE>
or <CODE>setterm -cursor on</CODE>
</P>
<P>Yeah kewl. Start movie playing with <CODE>mplayer -vo mga -fs -screenw 640
@ -971,8 +1078,8 @@ hackers will be able to disable copy protection on their chips. Therefore
we have no chance to get working TV-out on ATI.</P>
<P>What's status of ATI's tv-out chips under Linux:
<LI><b>ATI Mach64</b> has <i>ImpacTV</i> which is supported by gatos.
<LI><b>ASIC Radeon VIVO</b> has <i>Rage Theatre</i> which is supported by gatos.
<LI><b>ATI Mach64</b> has <i>ImpacTV</i> which is supported by <A HREF="http://gatos.sf.net">gatos</A>.
<LI><b>ASIC Radeon VIVO</b> has <i>Rage Theatre</i> which is supported by <A HREF="http://gatos.sf.net">gatos</A>.
<LI><b>Radeon VE</b> and <b>Rage PRO LT</b> have <i>ImpacTV2+</i> which is not supported under Linux.
But with <B>MPlayer</B> you get <B>full hardware acceleration</B> and <B>TV out</B>
for Radeons !