mplayer.hg: DOCS/sound.html annotate

annotate DOCS/sound.html @ 9166:c8771ae299fb

use MASTER instead of PCM

author	gabucino
date	Wed, 29 Jan 2003 22:20:36 +0000
parents	68efb63884b2
children	eeca9a1043cd

rev	line source
6403 c0f189e49ee4 Background color now set by CSS, added doctype and default character set, diego parents: 6393 diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	2 <HTML>
4982 6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4928 diff changeset	3
6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4928 diff changeset	4 <HEAD>
6882 f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux. diego parents: 6583 diff changeset	5 <TITLE>Sound - MPlayer - The Movie Player for Linux</TITLE>
6391 4e5c236ade69 small updates gabucino parents: 6353 diff changeset	6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
6403 c0f189e49ee4 Background color now set by CSS, added doctype and default character set, diego parents: 6393 diff changeset	7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4982 6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4928 diff changeset	8 </HEAD>
6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4928 diff changeset	9
6403 c0f189e49ee4 Background color now set by CSS, added doctype and default character set, diego parents: 6393 diff changeset	10 <BODY>
1704 a2e1432f7ac3 Arial font gabucino parents: 1686 diff changeset	11
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	12
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	13 <H3><A NAME="audio">2.3.2 Audio output devices</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	14
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	15 <H4><A NAME="sync">2.3.2.1 Audio/Video synchronisation</A></H4>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	16
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	17 <P>MPlayer's audio interface is called <I>libao2</I>. It currently
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	18 contains these drivers:</P>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	19
8751 f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	20 <DL>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	21 <DT>oss</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	22 <DD>OSS (ioctl) driver (supports hardware AC3 passthrough)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	23
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	24 <DT>sdl</DT>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	25 <DD>SDL driver (supports sound daemons like <B>ESD</B> and <B>ARTS</B>)</DD>
8751 f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	26
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	27 <DT>nas</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	28 <DD>NAS (Network Audio System) driver</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	29
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	30 <DT>alsa5</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	31 <DD>native ALSA 0.5 driver</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	32
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	33 <DT>alsa9</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	34 <DD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	35
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	36 <DT>sun</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	37 <DD>SUN audio driver (<CODE>/dev/audio</CODE>) for BSD and Solaris8 users</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	38
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	39 <DT>arts</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	40 <DD>native ARTS driver (mostly for KDE users)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	41
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	42 <DT>esd</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	43 <DD>native ESD driver (mostly for GNOME users)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	44 </DL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	45
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	46 <P>Linux sound card drivers have compatibility problems. This is because MPlayer
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	47 relies on an in-built feature of <EM>properly</EM> coded sound drivers that
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	48 enable them to maintain correct audio/video sync. Regrettably, some driver
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	49 authors don't take the care to code this feature since it is not needed for
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	50 playing MP3s or sound effects. </P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	51
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	52 <P>Other media players like <A HREF="http://avifile.sourceforge.net">aviplay</A>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	53 or <A HREF="http://xine.sourceforge.net">xine</A> possibly work
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	54 out-of-the-box with these drivers because they use "simple" methods with
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	55 internal timing. Measuring showed that their methods are not as efficient
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	56 as MPlayer's. </P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	57
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	58 <P>Using MPlayer with a properly written audio driver will never result
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	59 in A/V desyncs related to the audio, except only with very badly created
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	60 files (check the man page for workarounds).</P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	61
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	62 <P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	63 option, it should sort out your problems. See the man page for detailed
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	64 information.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	65
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	66 <P>Some notes:</P>
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	67
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	68 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	69 <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	70 default). If you experience glitches, halts or anything out of the
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	71 ordinary, try <CODE>-ao sdl</CODE> (NOTE: You need to have SDL libraries
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	72 and header files installed). The SDL audio driver helps in a lot of cases
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	73 and also supports ESD (GNOME) and ARTS (KDE).</LI>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	74 <LI>If you have ALSA version 0.5, then you almost always have to use
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	75 <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	76 will <B>crash MPlayer</B> with a message like this:<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	77 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	78 <LI>On Solaris, use the SUN audio driver with the <CODE>-ao sun</CODE> option,
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	79 otherwise neither video nor audio will work.</LI>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	80 <LI>If the sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	81 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	82 generally beneficial and described in more detail in the
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	83 <A HREF="cd-dvd.html#drives">CD-ROM section</A>.</LI>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	84 </UL>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	85
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	86
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	87 <H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	88
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	89 <P>On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.</P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	90
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	91 <P>Linux sound drivers are primarily provided by the free version of OSS. These
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	92 drivers have been superceded by <A HREF="http://www.alsa-project.org">ALSA</A>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	93 (Advanced Linux Sound Architecture) in the 2.5 development series. If your
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	94 distribution does not already use ALSA you may wish to try their drivers if
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	95 you experience sound problems. ALSA drivers are generally superior to OSS in
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	96 compatibility, performance and features. But some sound cards are only
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	97 supported by the commercial OSS drivers from
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	98 <A HREF="http://www.opensound.com/">4Front Technologies</A>. They also support
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	99 several non-Linux systems.</P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	100
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	101 <TABLE BORDER="1" WIDTH="100%">
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	102
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	103 <TR>
9153 68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	104 <TH ROWSPAN="2"><B>SOUND CARD</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	105 <TH COLSPAN="4"><B>DRIVER</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	106 <TH ROWSPAN="2"><B>Max kHz</B></TH>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	107 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	108
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	109 <TR>
9153 68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	110 <TH><B>OSS/Free</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	111 <TH><B>ALSA</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	112 <TH><B>OSS/Pro</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	113 <TH><B>other</B></TH>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	114 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	115
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	116 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	117 <TD><B>VIA onboard (686/A/B, 8233, 8235)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	118 <TD><A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">via82cxxx_audio</A></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	119 <TD>snd-via82xx</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	120 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	121 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	122 <TD>4-48 kHz or 48 kHz only, depending on the chipset</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	123 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	124
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	125 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	126 <TD><B>Aureal Vortex 2</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	127 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	128 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	129 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	130 <TD><A HREF="http://aureal.sourceforge.net">Linux Aureal Drivers</A><BR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	131 <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">buffer size increased to 32k</A></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	132 <TD>48</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	133 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	134
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	135 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	136 <TD><B>GUS PnP</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	137 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	138 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	139 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	140 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	141 <TD>48</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	142 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	143
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	144 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	145 <TD><B>SB Live!</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	146 <TD>Analog OK, SP/DIF not working</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	147 <TD>Both OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	148 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	149 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	150 <TD>192</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	151 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	152
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	153 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	154 <TD><B>SB AWE 64</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	155 <TD>max 44kHz</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	156 <TD>48kHz sounds bad</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	157 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	158 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	159 <TD>48</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	160 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	161
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	162 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	163 <TD><B>Gravis UltraSound ACE</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	164 <TD>not OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	165 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	166 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	167 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	168 <TD>44</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	169 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	170
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	171 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	172 <TD><B>Gravis UltraSound MAX</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	173 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	174 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	175 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	176 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	177 <TD>48</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	178 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	179
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	180 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	181 <TD><B>ESS 688</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	182 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	183 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	184 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	185 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	186 <TD>48</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	187 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	188
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	189 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	190 <TD><B>C-Media cards (which ones?)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	191 <TD>not OK (hissing) (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	192 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	193 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	194 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	195 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	196 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	197
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	198 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	199 <TD><B>Yamaha cards (ymf)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	200 <TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	201 <TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	202 <CODE>-ao sdl</CODE> (!) (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	203 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	204 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	205 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	206 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	207
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	208 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	209 <TD><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	210 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	211 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	212 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	213 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	214 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	215 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	216
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	217 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	218 <TD><B>PC Speaker or DAC</B></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	219 <TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	220 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	221 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	222 <TD><A HREF="http://www.geocities.com/stssppnn/pcsp.html">Linux PC speaker OSS driver</a></TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	223 <TD>The driver emulates 44.1, maybe more.</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	224 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	225
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	226 </TABLE>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	227
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	228 <P>Feedback to this document is welcome. Please tell us how MPlayer
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	229 and your sound card(s) worked together.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	230
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	231
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	232 <H4><A NAME="af">2.3.2.3 Audio filters</A></H4>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	233
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	234 <P>The old audio plugins have been superseded by a new audio filter layer. Audio
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	235 filters are used for changing the properties of the audio data before the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	236 sound reaches the sound card. The activation and deactivation of the filters
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	237 is normally automated but can be overridden. The filters are activated when
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	238 the properties of the audio data differ from those required by the sound card
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	239 and deactivated if unnecessary. The <CODE>-af filter1,filter2,...</CODE>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	240 option is used to override the automatic activation of filters or to insert
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	241 filters that are not automatically inserted. The filters will be executed as
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	242 they appear in the comma separated list.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	243
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	244 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	245   <CODE>mplayer -af resample,pan movie.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	246
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	247 <P>would run the sound through the resampling filter followed by the pan filter.
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	248 Observe that the list must not contain any spaces, else it will fail.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	249
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	250 <P>The filters often have options that change their behavior. These options
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	251 are explained in detail in the sections below. A filter will execute using
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	252 default settings if its options are omitted. Here is an example of how to use
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	253 filters in combination with filter specific options:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	254
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	255 <P>  <CODE>mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	256 -srate 11025 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	257
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	258 <P>would set the output frequency of the resample filter to 11025Hz and downmix
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	259 the audio to 1 channel using the pan filter.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	260
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	261 <P>The overall execution of the filter layer is controlled using the
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	262 <CODE>-af-adv</CODE> option. This option has two suboptions:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	263
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	264 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	265 <DT><CODE>force</CODE><DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	266 <DD>is a Bit field that controls how the filters are inserted and what
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	267 speed/accuracy optimizations they use:
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	268 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	269 <DT><CODE>0</CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	270 <DD>Use automatic insertion of filters and optimize according to CPU
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	271 speed.</DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	272 <DT><CODE>1</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	273 <DD>Use automatic insertion of filters and optimize for the highest
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	274 speed.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	275 <EM>Warning:</EM> Some features in the audio filters may silently fail,
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	276 and the sound quality may drop.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	277 <DT><CODE>2</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	278 <DD>Use automatic insertion of filters and optimize for quality.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	279 <DT><CODE>3</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	280 <DD>Use no automatic insertion of filters and no optimization.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	281 <I>Warning:</I> It may be possible to crash MPlayer using this
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	282 setting.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	283 <DT><CODE>4</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	284 <DD>Use automatic insertion of filters according to 0 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	285 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	286 <DT><CODE>5</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	287 <DD>Use automatic insertion of filters according to 1 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	288 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	289 <DT><CODE>6</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	290 <DD>Use automatic insertion of filters according to 2 above, but use
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	291 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	292 <DT><CODE>7</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	293 <DD>Use no automatic insertion of filters according to 3 above, and use
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	294 floating point processing when possible.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	295 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	296 </DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	297
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	298 <DT><CODE>list</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	299 <DD>is an alias for the -af option.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	300 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	301
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	302 <P>The filter layer is also affected by the following generic options:
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	303
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	304 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	305 <DT><CODE>-v</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	306 <DD>Increases the verbosity level and makes most filters print out extra
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	307 status messages.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	308 <DT><CODE>-channels</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	309 <DD>This option sets the number of output channels you would like your
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	310 sound card to use.
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	311 It also affects the number of channels that are being decoded from the
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	312 media. If the media contains less channels than requested the channels
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	313 filter (see below) will automatically be inserted. The routing will be the
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	314 default routing for the channels filter.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	315 <DT><CODE>-srate</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	316 <DD>This option selects the sample rate you would like your sound card to
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	317 use (of course the cards have limits on this). If the sample
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	318 frequency of your sound card is different from that of the current media,
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	319 the resample filter (see below) will be inserted into the audio filter layer
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	320 to compensate for the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	321 <DT><CODE>-format</CODE><DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	322 <DD>This option sets the sample format between the audio filter layer and the sound
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	323 card. If the requested sample format of your sound card is different from
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	324 that of the current media, a format filter (see below) will be inserted to
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	325 rectify the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	326 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	327
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	328
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	329 <H5><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	330
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	331 <P>MPlayer fully supports sound up/down-sampling through the
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	332 <CODE>resample</CODE> filter. It can be used if you
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	333 have a fixed frequency sound card or if you are stuck with an old sound card
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	334 that is only capable of max 44.1kHz. This filter is automatically enabled if
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	335 it is necessary, but it can also be explicitly enabled on the command line. It
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	336 has three options:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	337
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	338 <DL>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	339 <DT><CODE>srate <8000-192000></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	340 <DD>is an integer used for setting the output sample
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	341 frequency in Hz. The valid range for this parameter is 8kHz to 192kHz. If
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	342 the input and output sample frequency are the same or if this parameter is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	343 omitted the filter is automatically unloaded. A high sample frequency
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	344 normally improves the audio quality, especially when used in combination
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	345 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	346
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	347 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	348 <DD>is an optional binary parameter that allows the output frequency to differ
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	349 slightly from the frequency given by <CODE>srate</CODE>. This option can be
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	350 used if the startup of the playback is extremely slow. It is enabled by
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	351 default.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	352
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	353 <DT><CODE>type <0-2></CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	354 <DD>is an optional integer between <CODE>0</CODE> and <CODE>2</CODE> that
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	355 selects which resampling method to use. Here <CODE>0</CODE> represents
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	356 linear interpolation as resampling method, <CODE>1</CODE> represents
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	357 resampling using a poly-phase filter-bank and integer processing and
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	358 <CODE>2</CODE> represents resampling using a poly-phase filter-bank and
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	359 floating point processing. Linear interpolation is extremely fast, but
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	360 suffers from poor sound quality especially when used for up-sampling. The
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	361 best quality is given by <CODE>2</CODE> but this method also suffers from
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	362 the highest CPU load.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	363 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	364
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	365 <P>Example:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	366   <CODE>mplayer -af resample=44100:0:0</CODE></P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	367
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	368 <P>would set the output frequency of the resample filter to 44100Hz using exact
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	369 output frequency scaling and linear interpolation.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	370
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	371
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	372 <H5><A NAME="af_channels">2.3.2.3.2 Changing the number of channels</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	373
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	374 <P>The <CODE>channels</CODE> filter can be used for adding and removing
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	375 channels, it can also be used for routing or copying channels. It is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	376 automatically enabled when the output from the audio filter layer differs from
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	377 the input layer or when it is requested by another filter. This filter unloads
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	378 itself if not needed. The number of options is dynamic:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	379
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	380 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	381 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	382 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> that is used for
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	383 setting the number of output channels. This option is required, leaving it
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	384 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	385
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	386 <DT><CODE>nr <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	387 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> that is used for
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	388 specifying the number of routes. This parameter is optional. If it is
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	389 omitted the default routing is used.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	390
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	391 <DT><CODE>from1:to1:from2:to2:from3:to3...</CODE></DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	392 <DD>are pairs of numbers between <CODE>0</CODE> and <CODE>5</CODE> that define
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	393 where each channel should be routed.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	394 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	395
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	396 <P>If only <CODE>nch</CODE> is given the default routing is used, it works as
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	397 follows: If the number of output channels is bigger than the number of input
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	398 channels empty channels are inserted (except mixing from mono to stereo, then
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	399 the mono channel is repeated in both of the output channels). If the number of
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	400 output channels is smaller than the number of input channels the exceeding
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	401 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	402
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	403 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	404   <CODE>mplayer -af channels=4:4:0:1:1:0:2:2:3:3 media.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	405
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	406 <P>would change the number of channels to 4 and set up 4 routes that swap
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	407 channel 0 and channel 1 and leave channel 2 and 3 intact. Observe that if
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	408 media containing two channels was played back, channels 2 and 3 would contain
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	409 silence but 0 and 1 would still be swapped.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	410
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	411 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	412   <CODE>mplayer -af channels=6:4:0:0:0:1:0:2:0:3 media.avi </CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	413
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	414 <P>would change the number of channels to 6 and set up 4 routes that copy
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	415 channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	416
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	417
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	418 <H5><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	419
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	420 <P>The <CODE>format</CODE> filter converts between different sample formats. It
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	421 is automatically enabled when needed by the sound card or another filter.</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	422
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	423 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	424 <DT><CODE>bps <number></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	425 <DD>can be <CODE>1</CODE>, <CODE>2</CODE> or <CODE>4</CODE> and denotes the
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	426 number of bytes per sample. This option is required, leaving it empty
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	427 results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	428
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	429 <DT><CODE>f <format></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	430 <DD>is a text string describing the sample format. The string is a
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	431 concatenated mix of: <CODE>alaw</CODE>, <CODE>mulaw</CODE> or
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	432 <CODE>imaadpcm</CODE>, <CODE>float</CODE> or <CODE>int</CODE>,
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	433 <CODE>unsigned</CODE> or <CODE>signed</CODE>, <CODE>le</CODE> or
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	434 <CODE>be</CODE> (little or big endian). This option is required, leaving it
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	435 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	436 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	437
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	438 <P>Example:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	439   <CODE>mplayer -af format=4:float media.avi</CODE></P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	440
8772 605f2c290b20 small fix nicolas parents: 8757 diff changeset	441 <P>would set the output format to 4 bytes per sample floating point
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	442 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	443
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	444
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	445 <H5><A NAME="af_delay">2.3.2.3.4 Delay</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	446
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	447 <P>The <CODE>delay</CODE> filter delays the sound to the loudspeakers such that
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	448 the sound from the different channels arrives at the listening position
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	449 simultaneously.
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	450 It is only useful if you have more than 2 loudspeakers. This filter has a
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	451 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	452
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	453 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	454 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	455 <DD>are floating point numbers representing the delays in ms that should be
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	456 imposed on the different channels. The minimum delay is 0ms and the maximum
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	457 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	458 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	459
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	460 <P>To calculate the required delay for the different channels do as follows:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	461
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	462 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	463 <LI>Measure the distance to the loudspeakers in meters in relation to your
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	464 listening position, giving you the distances s1 to s5 (for a 5.1 system).
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	465 There is no point in compensating for the sub-woofer (you will not hear the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	466 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	467 <LI>Subtract the distances s1 to s5 from the maximum distance i.e.<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	468 s[i] = max(s) - s[i]; i = 1...5</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	469 <LI>Calculated the required delays in ms as<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	470 d[i] = 1000*s[i]/342; i = 1...5 </LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	471 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	472
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	473 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	474   <CODE>mplayer -af delay=10.5:10.5:0:0:7:0 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	475
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	476 <P>would delay front left and right by 10.5ms, the two rear channels and the sub
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	477 by 0ms and the center channel by 7ms.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	478
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	479
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	480 <H5><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	481
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	482 <P>Software volume control is implemented by the <CODE>volume</CODE> audio
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	483 filter. Use this filter with caution since
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	484 it can reduce the signal to noise ratio of the sound. In most cases it is best
9166 c8771ae299fb use MASTER instead of PCM gabucino parents: 9153 diff changeset	485 to set the level for the MASTER sound to max, leave this filter out and control
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	486 the output level to your speakers with the master volume control of the mixer.
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	487 If there is an external amplifier connected to the computer (this is almost
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	488 always the case), the noise level can be minimized by adjusting the master
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	489 level and the volume knob on the amplifier until the hissing noise in the
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	490 background is gone. This filter has two options:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	491
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	492 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	493 <DT><CODE>v <-200 - +60></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	494 <DD>is a floating point number between <CODE>-200</CODE> and <CODE>+60</CODE>
9043 1d75a7ecf3b8 Changing initial volume level to 0dB after loud intensive complaints anders parents: 9005 diff changeset	495 which represents the volume level in dB. The default level is 0dB.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	496
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	497 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	498 <DD>is a binary control that turns soft clipping on and off. Soft-clipping can
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	499 make the sound more smooth if very high volume levels are used. Enable this
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	500 option if the dynamic range of the loudspeakers is very low. Be aware that
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	501 this feature creates distortion and should be considered a last resort.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	502 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	503
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	504 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	505   <CODE>mplayer -af volume=10.1:0 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	506
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	507 <P>would amplify the sound by 10.1dB and hard-clip if the sound level is too
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	508 high.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	509
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	510 <P>This filter has a second feature: It measures the overall maximum sound level
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	511 and prints out that level when MPlayer exits. This volume estimate can be used
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	512 for setting the sound level in MEncoder such that the maximum dynamic range is
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	513 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	514
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	515
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	516 <H5><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H5>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	517
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	518 <P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	519 equalizer, implemented using 10 IIR
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	520 band pass filters. This means that it works regardless of what type of audio
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	521 is being played back. The center frequencies for the 10 bands are:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	522
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	523 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	524 <TR><TD>Band No.</TD><TD>Center frequency</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	525 <TR><TD>0</TD><TD>31.25 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	526 <TR><TD>1</TD><TD>62.50 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	527 <TR><TD>2</TD><TD>125.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	528 <TR><TD>3</TD><TD>250.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	529 <TR><TD>4</TD><TD>500.0 Hz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	530 <TR><TD>5</TD><TD>1.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	531 <TR><TD>6</TD><TD>2.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	532 <TR><TD>7</TD><TD>4.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	533 <TR><TD>8</TD><TD>8.000 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	534 <TR><TD>9</TD><TD>16.00 kHz</TD></TR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	535 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	536
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	537 <P>If the sample rate of the sound being played back is lower than the center
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	538 frequency for a frequency band, then that band will be disabled. A known bug
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	539 with this filter is that the characteristics for the uppermost band are not
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	540 completely symmetric if the sample rate is close to the center frequency of
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	541 that band. This problem can be worked around by up-sampling the sound using
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	542 the resample filter before it reaches this filter. </P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	543
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	544 <P>This filter has 10 parameters:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	545
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	546 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	547 <DT><CODE>g1:g2:g3...g10</CODE></DT>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	548 <DD>are floating point numbers between <CODE>-12</CODE> and <CODE>+12</CODE>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	549 representing the gain in dB for each frequency band.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	550 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	551
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	552 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	553   <CODE>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	554
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	555 <P>would amplify the sound in the upper and lower frequency region while
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	556 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	557
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	558
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	559 <H5><A NAME="af_panning">2.3.2.3.7 Panning filter</A></H5>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	560
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	561 <P>Use the <CODE>pan</CODE> filter to mix channels arbitrarily. It is basically
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	562 a combination of the volume control and the channels filter. There are two
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	563 major uses for this filter:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	564
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	565 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	566 <LI>Down-mixing many channels to only a few, stereo to mono for example.</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	567 <LI>Varying the "width" of the center speaker in a surround sound system.</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	568 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	569
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	570 <P>This filter is hard to use, and will require some tinkering before the
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	571 desired result is obtained. The number of options for this filter depends on
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	572 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	573
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	574 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	575 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	576 <DD>is an integer between <CODE>1</CODE> and <CODE>6</CODE> and is used for
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	577 setting the number of output channels. This option is required, leaving it
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	578 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	579
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	580 <DT><CODE>l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...</CODE></DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	581 <DD>are floating point values between <CODE>0</CODE> and <CODE>1</CODE>.
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	582 <CODE>l[i][j]</CODE> determines how much of input channel j is mixed into
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	583 output channel i.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	584 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	585
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	586 <P>Example 1:<BR>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	587   <CODE>mplayer -af pan=1:0.5:0.5 -channels 1 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	588
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	589 <P>would down-mix from stereo to mono.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	590
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	591 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	592   <CODE>mplayer -af pan=3:1:0:1:0.5:0.5 -channels 3 media.avi</CODE></P>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	593
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	594 <P>would give 3 channel output leaving channels 0 and 1 intact, and mix channels
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	595 0 and 1 into output channel 2 (which could be sent to a sub-woofer for
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	596 example).</P>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	597
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	598
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	599 <H5><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H5>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	600
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	601 <P>The <CODE>sub</CODE> filter adds a sub woofer channel to the audio stream.
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	602 The audio data
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	603 used for creating the sub-woofer channel is an average of the sound in channel
9005 ebc368360ea2 typo gabucino parents: 8950 diff changeset	604 0 and channel 1. The resulting sound is then low-pass filtered by a 4th
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	605 order Butterworth filter with a default cutoff frequency of 60Hz and added to
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	606 a separate channel in the audio stream. Warning: Disable this filter when you
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	607 are playing DVDs with Dolby Digital 5.1 sound, otherwise this filter will
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	608 disrupt the sound to the sub-woofer. This filter has two parameters:</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	609
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	610 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	611 <DT><CODE>fc <20-300></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	612 <DD>is an optional floating point number used for setting the cutoff frequency
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	613 for the filter in Hz. The valid range is 20Hz to 300Hz. For the best result
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	614 try setting the cutoff frequency as low as possible. This will improve the
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	615 stereo or surround sound experience. The default cutoff frequency is
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	616 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	617
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	618 <DT><CODE>ch <0-5></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	619 <DD>is an optional integer between <CODE>0</CODE> and <CODE>5</CODE> which
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	620 determines the channel number in which to insert the sub-channel audio.
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	621 The default is channel number <CODE>5</CODE>. Observe that the number of
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	622 channels will automatically be increased to <CODE>ch</CODE> if
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	623 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	624 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	625
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	626 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	627   <CODE>mplayer -af sub=100:4 -channels 5 media.avi</CODE></P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	628
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	629 <P>would add a sub-woofer channel with a cutoff frequency of 100Hz to output
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	630 channel 4.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	631
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	632 <H5><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H5>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	633
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	634 <P>Matrix encoded surround sound can be decoded by the <CODE>surround</CODE>
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	635 filter. Dolby Surround is
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	636 an example of a matrix encoded format. Many files with 2 channel audio
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	637 actually contain matrixed surround sound. To use this feature you need a sound
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	638 card supporting at least 4 channels. This filter has one parameter:</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	639
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	640 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	641 <DT><CODE>d <0-1000></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	642 <DD>is an optional floating point number between <CODE>0</CODE> and
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	643 <CODE>1000</CODE> used for setting the delay time in ms for the rear
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	644 speakers. This delay should be set as follows: if d1 is the distance from
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	645 the listening position to the front speakers and d2 is the distance from
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	646 the listening position to the rear speakers, then the delay <CODE>d</CODE>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	647 should be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	648 The default value for <CODE>d</CODE> is 20ms.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	649 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	650
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	651 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	652   <CODE>mplayer -af surround=15 -channels 4 media.avi</CODE></P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	653
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	654 <P>would add surround sound decoding with 15ms delay for the sound to the rear
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	655 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	656
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	657
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	658 <H4><A NAME="plugins">2.3.2.4 Audio plugins (deprecated)</A></H4>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	659
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	660 <H2><STRONG>Note: Audio plugins have been deprecated by audio filters and will be
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	661 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	662
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	663 <P>MPlayer has support for audio plugins. Audio plugins can be used to
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	664 change the properties of the audio data before it reaches the sound
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	665 card. They are enabled using the <CODE>-aop</CODE> option which takes a
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	666 <CODE>list=plugin1,plugin2,...</CODE> argument. The <CODE>list</CODE> argument
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	667 is required and determines which plugins should be used and in which order they
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	668 should be executed. Example:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	669
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	670 <P>  <CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	671
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	672 <P>would run the sound through the resampling plugin followed by the format
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	673 plugin.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	674
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	675 <P>The plugins can also have options that change their behavior. These
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	676 options are explained in detail in the sections below. A plugin will execute
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	677 using default settings if its options are omitted. Here is an example of how
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	678 to use plugins in combination with plugin specific options:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	679
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	680 <P>  <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	681 list=resample,format:fout=44100:format=0x8</CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	682
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	683 <P>would set the output frequency of the resample plugin to 44100Hz and the
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	684 output format of the format plugin to AFMT_U8.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	685
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	686 <P>Currently audio plugins cannot be used in MEncoder.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	687
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	688
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	689 <H5><A NAME="resample">2.3.2.4.1 Up/Downsampling</A></H5>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	690
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	691 <P>MPlayer fully supports up/downsampling of the sound. This plugin can
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	692 be used if you have a fixed frequency sound card or if you are
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	693 stuck with an old sound card that is only capable of max 44.1kHz.
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	694 MPlayer <EM>autodetects</EM> whether or not usage of this plugin is necessary.
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	695 This plugin has one option, <CODE>fout</CODE>, which is used for setting the
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	696 desired output sample frequency. The value is given in Hz, and defaults to
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	697 48kHz.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	698
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	699 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	700   <CODE>mplayer media.avi -aop list=resample:fout=<required
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	701 frequency in Hz, like 44100></CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	702
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	703 <P>Note that the output frequency should not be scaled up from the default value.
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	704 Scaling up will cause the audio and video streams to be played in slow motion
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	705 and cause audio distortion.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	706
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	707
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	708 <H5><A NAME="surround_decoding">2.3.2.4.2 Surround Sound decoding</A></H5>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	709
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	710 <P>MPlayer has an audio plugin that can decode matrix encoded
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	711 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	712 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	713 To use this feature you need a sound card supporting at least 4 channels.</P>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	714
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	715 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	716   <CODE>mplayer media.avi -aop list=surround</CODE></P>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	717
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	718
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	719 <H5><A NAME="format">2.3.2.3.3 Sample format converter</A></H5>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	720
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	721 <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type,
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	722 this plugin can
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	723 be used to change the format to one which your sound card can understand. It
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	724 has one option, <CODE>format</CODE>, which can be set to one of the numbers
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	725 found in <CODE>libao2/afmt.h</CODE>. This plugin is hardly ever needed and is
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	726 intended for advanced users. Keep in mind that this plugin only changes the
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	727 sample format and not the sample frequency or the number of channels.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	728
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	729 <P>Usage:<BR>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	730   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	731 list=format:format=<required output format></CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	732
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	733
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	734 <H5><A NAME="delay">2.3.2.4.4 Delay</A></H5>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	735
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	736 <P>This plugin delays the sound and is intended as an example of how to develop
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	737 new plugins. It can not be used for anything useful from a users perspective
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	738 and is mentioned here for the sake of completeness only. Do not use this
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	739 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	740
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	741 <P>If you have a file with a consistent A/V sync fault, use the <CODE>+/-</CODE>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	742 keys to adjust timings on-the-fly instead. Usage of the OSD is recommended
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	743 to make this easier.</P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	744
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	745
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	746 <H5><A NAME="volume">2.3.2.4.5 Software volume control</A></H5>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	747
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	748 <P>This plugin is a software replacement for the volume control, and
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	749 can be used on machines with a broken mixer device. It can also be
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	750 used if one wants to change the output volume of MPlayer
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	751 without changing the PCM volume setting in the mixer. It has one
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	752 option <CODE>volume</CODE> that is used for setting the initial
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	753 sound level. The initial sound level can be set to values between 0
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	754 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	755 plugin with caution since it can reduce the signal to noise ratio of
9166 c8771ae299fb use MASTER instead of PCM gabucino parents: 9153 diff changeset	756 the sound. In most cases it is best to set the level for the MASTER
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	757 sound to max, leave this plugin out and control the output level to
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	758 your speakers with the master volume control of the mixer. If there is an
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	759 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	760 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	761 level and the volume knob on the amplifier until the hissing noise
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	762 in the background is gone.</P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	763
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	764 <P>Usage:<BR>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	765   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	766 list=volume:volume=<0-255></CODE></P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	767
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	768 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	769 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	770 high or if the dynamic range of the loudspeakers is very
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	771 low. Be aware that this feature creates distortion and should be
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	772 considered a last resort.</P>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	773
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	774 <P>Usage:<BR>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	775   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	776 list=volume:softclip</CODE></P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	777
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	778
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	779 <H5><A NAME="extrastereo">2.3.2.4.6 Extrastereo</A></H5>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	780
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	781 <P>This plugin (linearly) increases the difference between left and right
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	782 channels (like the XMMS extrastereo plugin) which gives some sort of "live"
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	783 effect to playback.</P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	784
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	785 <P>Usage:<BR>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	786   <CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	787   <CODE>mplayer media.avi -aop list=extrastereo:mul=3.45</CODE></P>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	788
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	789 <P>The default coefficient (<CODE>mul</CODE>) is a float number that defaults
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	790 to 2.5. If you set it to 0.0, you will have mono sound (average of both
6272 360c3b1dd1d7 -1.0 swaps channels with the extrastereo plugin. diego parents: 5765 diff changeset	791 channels). If you set it to 1.0, sound will be unchanged, if you set it to
360c3b1dd1d7 -1.0 swaps channels with the extrastereo plugin. diego parents: 5765 diff changeset	792 -1.0, left and right channels will be swapped.</P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	793
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	794
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	795 <H5><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H5>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	796
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	797 <P>This plugin maximizes the volume without distorting the sound.</P>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	798
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	799 <P>Usage:<BR>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	800   <CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	801
5721 b53597b930b1 more deciliters gabucino parents: 5123 diff changeset	802
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	803 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	804 </HTML>

Mercurial > mplayer.hg

annotate DOCS/sound.html @ 9166:c8771ae299fb