mplayer.hg: DOCS/en/sound.html annotate

annotate DOCS/en/sound.html @ 10770:7a2f6392fcf0

nit

author	diego
date	Mon, 01 Sep 2003 01:18:58 +0000
parents	f096d8578c3d
children	6111db8a76b5

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>
9506 6c6ea2b4cfdb default.css path fixed (it needs to be moved on CVS server!!) gabucino parents: 9382 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
10151 f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	39 <DT>macosx</DT>
f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	40 <DD>native MacOSX driver</DD>
f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	41
f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	42 <DT>win32</DT>
f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	43 <DD>native Win32 driver</DD>
f096d8578c3d ao_win32 and ao_macosx gabucino parents: 9506 diff changeset	44
8751 f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	45 <DT>arts</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	46 <DD>native ARTS driver (mostly for KDE users)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	47
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	48 <DT>esd</DT>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	49 <DD>native ESD driver (mostly for GNOME users)</DD>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	50 </DL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: 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>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	53 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	54 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	55 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	56 playing MP3s or sound effects. </P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	57
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	58 <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	59 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	60 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	61 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	62 as MPlayer's. </P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	63
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	64 <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	65 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	66 files (check the man page for workarounds).</P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	67
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	68 <P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	69 option, it should sort out your problems. See the man page for detailed
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	70 information.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	71
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	72 <P>Some notes:</P>
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	73
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	74 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	75 <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	76 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	77 ordinary, try <CODE>-ao sdl</CODE> (NOTE: You need to have SDL libraries
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	78 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	79 and also supports ESD (GNOME) and ARTS (KDE).</LI>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	80 <LI>If you have ALSA version 0.5, then you almost always have to use
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	81 <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	82 will <B>crash MPlayer</B> with a message like this:<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	83 <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	84 <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	85 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	86 <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	87 <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	88 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	89 <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	90 </UL>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	91
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	92
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	93 <H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	94
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	95 <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	96
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	97 <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	98 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	99 (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	100 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	101 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	102 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	103 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	104 <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	105 several non-Linux systems.</P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	106
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	107 <TABLE BORDER="1" WIDTH="100%">
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 ROWSPAN="2"><B>SOUND CARD</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	111 <TH COLSPAN="4"><B>DRIVER</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	112 <TH ROWSPAN="2"><B>Max kHz</B></TH>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	113 <TH ROWSPAN="2"><B>Max Channels</B></TH>
9282 513e02e2e553 fixing others' 10/100liters gabucino parents: 9229 diff changeset	114 <TH ROWSPAN="2"><B>Max Opens<FONT SIZE="-2"><A HREF=#note1>[1]</A></FONT></B></TH>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	115 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	116
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	117 <TR>
9153 68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	118 <TH><B>OSS/Free</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	119 <TH><B>ALSA</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	120 <TH><B>OSS/Pro</B></TH>
68efb63884b2 Table headers make for nicer tables and better semantic markup. diego parents: 9138 diff changeset	121 <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	122 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	123
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	124 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	125 <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	126 <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	127 <TD>snd-via82xx</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	128 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	129 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	130 <TD>4-48 kHz or 48 kHz only, depending on the chipset</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	131 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	132 <TD> </TD>
9082 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>Aureal Vortex 2</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>none</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><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	141 <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	142 <TD>48</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	143 <TD>4.1</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	144 <TD>5+</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	145 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	146
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	147 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	148 <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	149 <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	150 <TD>Both OK</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	151 <TD>Both OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	152 <TD><A HREF="http://opensource.creative.com">Creative's OSS driver (SP/DIF support)</A></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	153 <TD>192</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	154 <TD>4.0/5.1</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	155 <TD>32</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	156 </TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	157
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	158 <TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	159 <TD><B>SB 128 PCI (es1371)</B></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	160 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	161 <TD>?</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	162 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	163 <TD> </TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	164 <TD>48</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	165 <TD>stereo</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	166 <TD>2</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	167 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	168
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 <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	171 <TD>max 44kHz</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	172 <TD>48kHz sounds bad</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	173 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	174 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	175 <TD>48</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	176 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	177 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	178 </TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	179
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	180 <TR>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	181 <TD><B>GUS PnP</B></TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	182 <TD>none</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	183 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	184 <TD>OK</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	185 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	186 <TD>48</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	187 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	188 <TD> </TD>
9082 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
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	191 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	192 <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	193 <TD>not OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	194 <TD>OK</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 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	197 <TD>44</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	198 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	199 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	200 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	201
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	202 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	203 <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	204 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	205 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	206 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	207 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	208 <TD>48</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	209 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	210 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	211 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	212
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	213 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	214 <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	215 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	216 <TD>OK (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	217 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	218 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	219 <TD>48</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	220 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	221 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	222 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	223
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 <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	226 <TD>not OK (hissing) (?)</TD>
9302 e23939b2ac30 sync gabucino parents: 9288 diff changeset	227 <TD>OK</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	228 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	229 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	230 <TD>?</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	231 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	232 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	233 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	234
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	235 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	236 <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	237 <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	238 <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	239 <CODE>-ao sdl</CODE> (!) (?)</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	240 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	241 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	242 <TD>?</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	243 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	244 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	245 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	246
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	247 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	248 <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	249 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	250 <TD>?</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	251 <TD>OK</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	252 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	253 <TD>?</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	254 <TD> </TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	255 <TD> </TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	256 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	257
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	258 <TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	259 <TD><B>PC Speaker or DAC</B></TD>
9282 513e02e2e553 fixing others' 10/100liters gabucino parents: 9229 diff changeset	260 <TD>OK</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	261 <TD>none</TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	262 <TD> </TD>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	263 <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	264 <TD>The driver emulates 44.1, maybe more.</TD>
9229 334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	265 <TD>mono</TD>
334a2d73e612 extended teh soundcard table by max channels and max opens (concurrent arpi parents: 9206 diff changeset	266 <TD>1</TD>
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	267 </TR>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	268
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	269 </TABLE>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	270
9282 513e02e2e553 fixing others' 10/100liters gabucino parents: 9229 diff changeset	271 <P><A NAME="note1"><B>[1]</B></A>: the number of applications that are able to use the
513e02e2e553 fixing others' 10/100liters gabucino parents: 9229 diff changeset	272 device <I>at the same time</I>.</P>
513e02e2e553 fixing others' 10/100liters gabucino parents: 9229 diff changeset	273
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	274 <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	275 and your sound card(s) worked together.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	276
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	277
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	278 <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	279
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	280 <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	281 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	282 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	283 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	284 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	285 and deactivated if unnecessary. The <CODE>-af filter1,filter2,...</CODE>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	286 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	287 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	288 they appear in the comma separated list.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	289
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	290 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	291   <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	292
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	293 <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	294 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	295
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	296 <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	297 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	298 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	299 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	300
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	301 <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	302 -srate 11025 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	303
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	304 <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	305 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	306
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	307 <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	308 <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	309
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	310 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	311 <DT><CODE>force</CODE><DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	312 <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	313 speed/accuracy optimizations they use:
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	314 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	315 <DT><CODE>0</CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	316 <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	317 speed.</DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	318 <DT><CODE>1</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	319 <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	320 speed.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	321 <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	322 and the sound quality may drop.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	323 <DT><CODE>2</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	324 <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	325 <DT><CODE>3</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	326 <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	327 <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	328 setting.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	329 <DT><CODE>4</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	330 <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	331 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	332 <DT><CODE>5</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	333 <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	334 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	335 <DT><CODE>6</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	336 <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	337 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	338 <DT><CODE>7</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	339 <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	340 floating point processing when possible.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	341 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	342 </DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	343
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	344 <DT><CODE>list</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	345 <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	346 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	347
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	348 <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	349
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	350 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	351 <DT><CODE>-v</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	352 <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	353 status messages.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	354 <DT><CODE>-channels</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	355 <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	356 sound card to use.
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	357 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	358 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	359 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	360 default routing for the channels filter.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	361 <DT><CODE>-srate</CODE></DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	362 <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	363 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	364 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	365 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	366 to compensate for the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	367 <DT><CODE>-format</CODE><DT>
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	368 <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	369 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	370 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	371 rectify the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	372 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	373
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	374
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	375 <H4><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	376
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	377 <P>MPlayer fully supports sound up/down-sampling through the
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	378 <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	379 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	380 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	381 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	382 has three options:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	383
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	384 <DL>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	385 <DT><CODE>srate <8000-192000></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	386 <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	387 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	388 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	389 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	390 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	391 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	392
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	393 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	394 <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	395 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	396 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	397 default.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	398
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	399 <DT><CODE>type <0-2></CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	400 <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	401 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	402 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	403 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	404 <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	405 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	406 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	407 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	408 the highest CPU load.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	409 </DL>
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:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	412   <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	413
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	414 <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	415 output frequency scaling and linear interpolation.</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
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	418 <H4><A NAME="af_channels">2.3.2.3.2 Changing the number of channels</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	419
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	420 <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	421 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	422 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	423 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	424 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	425
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	426 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	427 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	428 <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	429 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	430 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	431
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	432 <DT><CODE>nr <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	433 <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	434 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	435 omitted the default routing is used.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	436
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	437 <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	438 <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	439 where each channel should be routed.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	440 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	441
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	442 <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	443 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	444 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	445 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	446 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	447 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	448
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	449 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	450   <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	451
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	452 <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	453 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	454 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	455 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	456
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	457 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	458   <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	459
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	460 <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	461 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	462
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	463
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	464 <H4><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	465
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	466 <P>The <CODE>format</CODE> filter converts between different sample formats. It
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	467 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	468
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	469 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	470 <DT><CODE>bps <number></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	471 <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	472 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	473 results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	474
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	475 <DT><CODE>f <format></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	476 <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	477 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	478 <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	479 <CODE>unsigned</CODE> or <CODE>signed</CODE>, <CODE>le</CODE> or
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	480 <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	481 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	482 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	483
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	484 <P>Example:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	485   <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	486
8772 605f2c290b20 small fix nicolas parents: 8757 diff changeset	487 <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	488 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	489
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	490
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	491 <H4><A NAME="af_delay">2.3.2.3.4 Delay</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	492
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	493 <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	494 the sound from the different channels arrives at the listening position
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	495 simultaneously.
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	496 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	497 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	498
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	499 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	500 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	501 <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	502 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	503 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	504 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	505
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	506 <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	507
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	508 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	509 <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	510 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	511 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	512 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	513 <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	514 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	515 <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	516 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	517 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	518
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	519 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	520   <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	521
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	522 <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	523 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	524
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	525
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	526 <H4><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	527
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	528 <P>Software volume control is implemented by the <CODE>volume</CODE> audio
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	529 filter. Use this filter with caution since
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	530 it can reduce the signal to noise ratio of the sound. In most cases it is best
9173 eeca9a1043cd fixing af_volume vs PCM vs MASTER issue gabucino parents: 9166 diff changeset	531 to set the level for the PCM 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	532 the output level to your speakers with the master volume control of the mixer.
9206 4faa694027f4 typos diego parents: 9173 diff changeset	533 In case your sound card has a digital PCM mixer instead of an analog one, and
4faa694027f4 typos diego parents: 9173 diff changeset	534 you hear distortion, use the MASTER mixer instead.
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	535 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	536 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	537 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	538 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	539
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	540 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	541 <DT><CODE>v <-200 - +60></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	542 <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	543 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	544
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	545 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	546 <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	547 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	548 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	549 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	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 volume=10.1:0 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 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	556 high.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	557
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	558 <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	559 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	560 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	561 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	562
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	563
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	564 <H4><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	565
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	566 <P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	567 equalizer, implemented using 10 IIR
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	568 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	569 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	570
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	571 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	572 <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	573 <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	574 <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	575 <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	576 <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	577 <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	578 <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	579 <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	580 <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	581 <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	582 <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	583 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	584
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	585 <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	586 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	587 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	588 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	589 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	590 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	591
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	592 <P>This filter has 10 parameters:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	593
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	594 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	595 <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	596 <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	597 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	598 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	599
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	600 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	601   <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	602
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	603 <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	604 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	605
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	606
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	607 <H4><A NAME="af_panning">2.3.2.3.7 Panning filter</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	608
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	609 <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	610 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	611 major uses for this filter:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	612
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	613 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	614 <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	615 <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	616 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	617
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	618 <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	619 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	620 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	621
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	622 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	623 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	624 <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	625 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	626 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	627
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	628 <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	629 <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	630 <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	631 output channel i.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	632 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	633
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	634 <P>Example 1:<BR>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	635   <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	636
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	637 <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	638
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	639 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	640   <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	641
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	642 <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	643 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	644 example).</P>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	645
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	646
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	647 <H4><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H4>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	648
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	649 <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	650 The audio data
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	651 used for creating the sub-woofer channel is an average of the sound in channel
9005 ebc368360ea2 typo gabucino parents: 8950 diff changeset	652 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	653 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	654 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	655 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	656 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	657
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	658 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	659 <DT><CODE>fc <20-300></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	660 <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	661 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	662 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	663 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	664 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	665
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	666 <DT><CODE>ch <0-5></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	667 <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	668 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	669 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	670 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	671 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	672 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	673
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	674 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	675   <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	676
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	677 <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	678 channel 4.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	679
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	680 <H4><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H4>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	681
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	682 <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	683 filter. Dolby Surround is
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	684 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	685 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	686 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	687
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	688 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	689 <DT><CODE>d <0-1000></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	690 <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	691 <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	692 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	693 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	694 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	695 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	696 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	697 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	698
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	699 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	700   <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	701
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	702 <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	703 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	704
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	705
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	706 <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	707
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	708 <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	709 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	710
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	711 <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	712 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	713 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	714 <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	715 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	716 should be executed. Example:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	717
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	718 <P>  <CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	719
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	720 <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	721 plugin.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	722
9138 42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	723 <P>The plugins can also have options that change their behavior. These
42667fd91d4a changing "switch" -> "option" (unwritten DOCS rule) gabucino parents: 9082 diff changeset	724 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	725 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	726 to use plugins in combination with plugin specific options:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	727
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	728 <P>  <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	729 list=resample,format:fout=44100:format=0x8</CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	730
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	731 <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	732 output format of the format plugin to AFMT_U8.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	733
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	734 <P>Currently audio plugins cannot be used in MEncoder.</P>
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
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	737 <H4><A NAME="resample">2.3.2.4.1 Up/Downsampling</A></H4>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	738
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	739 <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	740 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	741 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	742 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	743 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	744 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	745 48kHz.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	746
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	747 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	748   <CODE>mplayer media.avi -aop list=resample:fout=<required
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	749 frequency in Hz, like 44100></CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	750
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	751 <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	752 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	753 and cause audio distortion.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	754
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	755
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	756 <H4><A NAME="surround_decoding">2.3.2.4.2 Surround Sound decoding</A></H4>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	757
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	758 <P>MPlayer has an audio plugin that can decode matrix encoded
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	759 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	760 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	761 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	762
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	763 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	764   <CODE>mplayer media.avi -aop list=surround</CODE></P>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	765
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	766
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	767 <H4><A NAME="format">2.3.2.3.3 Sample format converter</A></H4>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	768
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	769 <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	770 this plugin can
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	771 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	772 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	773 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	774 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	775 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	776
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	777 <P>Usage:<BR>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	778   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	779 list=format:format=<required output format></CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	780
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	781
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	782 <H4><A NAME="delay">2.3.2.4.4 Delay</A></H4>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	783
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	784 <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	785 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	786 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	787 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	788
9082 792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	789 <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	790 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	791 to make this easier.</P>
792417cde97a Some updates and rewordings as well as a much better table design by diego parents: 9043 diff changeset	792
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	793
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	794 <H4><A NAME="volume">2.3.2.4.5 Software volume control</A></H4>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	795
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	796 <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	797 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	798 used if one wants to change the output volume of MPlayer
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	799 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	800 option <CODE>volume</CODE> that is used for setting the initial
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	801 sound level. The initial sound level can be set to values between 0
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	802 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	803 plugin with caution since it can reduce the signal to noise ratio of
9173 eeca9a1043cd fixing af_volume vs PCM vs MASTER issue gabucino parents: 9166 diff changeset	804 the sound. In most cases it is best to set the level for the PCM
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	805 sound to max, leave this plugin out and control the output level to
9173 eeca9a1043cd fixing af_volume vs PCM vs MASTER issue gabucino parents: 9166 diff changeset	806 your speakers with the MASTER volume control of the mixer.
9206 4faa694027f4 typos diego parents: 9173 diff changeset	807 In case your sound card has a digital PCM mixer instead of an analog one, and
4faa694027f4 typos diego parents: 9173 diff changeset	808 you hear distortion, use the MASTER mixer instead.
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	809 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	810 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	811 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	812 in the background is gone.</P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	813
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	814 <P>Usage:<BR>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	815   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	816 list=volume:volume=<0-255></CODE></P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	817
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	818 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	819 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	820 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	821 low. Be aware that this feature creates distortion and should be
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	822 considered a last resort.</P>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	823
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	824 <P>Usage:<BR>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	825   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	826 list=volume:softclip</CODE></P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	827
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	828
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	829 <H4><A NAME="extrastereo">2.3.2.4.6 Extrastereo</A></H4>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	830
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	831 <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	832 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	833 effect to playback.</P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	834
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	835 <P>Usage:<BR>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	836   <CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	837   <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	838
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	839 <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	840 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	841 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	842 -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	843
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	844
9288 69872fa8b0e3 fixing al3x's 10l's gabucino parents: 9282 diff changeset	845 <H4><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H4>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	846
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	847 <P>This plugin maximizes the volume without distorting the sound.</P>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	848
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	849 <P>Usage:<BR>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	850   <CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	851
5721 b53597b930b1 more deciliters gabucino parents: 5123 diff changeset	852
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	853 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	854 </HTML>

Mercurial > mplayer.hg

annotate DOCS/en/sound.html @ 10770:7a2f6392fcf0