mplayer.hg: DOCS/sound.html annotate

annotate DOCS/sound.html @ 9082:792417cde97a

Some updates and rewordings as well as a much better table design by Nilmoni Deb, Daniel Carter and Philip Jägenstedt.

author	diego
date	Sat, 25 Jan 2003 01:22:26 +0000
parents	1d75a7ecf3b8
children	42667fd91d4a

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

Mercurial > mplayer.hg

annotate DOCS/sound.html @ 9082:792417cde97a