mplayer.hg: DOCS/sound.html annotate

annotate DOCS/sound.html @ 8950:8fd72eae8886

Small updates for correctness and consistency.

author	diego
date	Mon, 13 Jan 2003 23:45:14 +0000
parents	5b73c925436e
children	ebc368360ea2

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>
f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	25 <DD>SDL driver (supports <B>ESD</B>, <B>ARTS</B> etc)</DD>
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
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	46 <P>Fact is, Linux sound card drivers have compatibility problems. The cause
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	47 is that MPlayer uses a feature that well coded audio drivers implement to
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	48 maintain audio/video sync. Regrettably, some driver authors do not care about
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	49 this function, it is not needed for playing MP3s or for sound effects.</P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	50
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	51 <P>Other media players like aviplay or xine possibly work out-of-the-box with
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	52 these drivers because they use "simple" methods with internal timing. A note:
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	53 time showed their methods aren't AS efficient as MPlayer's.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	54
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	55 <P>With a correctly written audio driver MPlayer will never create audio related
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	56 A/V desynchronisation, unless your file is badly broken. Some options to work
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	57 around these problems are described in the man page).</P>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	58
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	59 <P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	60 option, it should sort out your problems. See the man page for detailed
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	61 information.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	62
1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	63 <P>Some notes:</P>
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	64
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	65 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	66 <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	67 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	68 ordinary, try <CODE>-ao sdl</CODE> (NOTE: You need to have SDL libraries
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	69 and header files installed). The SDL audio driver helps in a lot of cases
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	70 and also supports ESD and ARTS. (ESD is the sound daemon
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	71 from GNOME, ARTS is from KDE.)</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	72 <LI>If you have ALSA version 0.5, then you almost always have to use
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	73 <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	74 will <B>crash MPlayer</B> with a message like this:<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	75 <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	76 </UL>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	77
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	78 <P>On <B>Solaris</B>, use the SUN audio driver with the
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6907 diff changeset	79 <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	80
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	81
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	82 <H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	83
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	84 <TABLE BORDER="0" WIDTH="100%">
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	85 <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	86 <TR><TD></TD><TD>Driver:</TD><TD> from the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	87 <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">gkernel project</A></TD></TR>
3190 9c9a9b5f0a9e VIA 8c2qwerqwer driver added gabucino parents: 2999 diff changeset	88
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	89 <TR><TD COLSPAN=3><B>Aureal Vortex 2</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	90 <TR><TD>    </TD><TD>OSS:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	91 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	92 <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	93 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	94 <TR><TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD></TR>
8751 f117a4150786 We now have -ao esd. diego parents: 8750 diff changeset	95 <TR><TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">Pontscho's page</A>
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	96 (<I>buffer size increased to 32k</I>)</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	97
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	98 <TR><TD COLSPAN=3><B>GUS PnP</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	99 <TR><TD></TD><TD>OSS:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	100 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	101 <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	102 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	103
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	104 <TR><TD COLSPAN=3><B>SB Live!</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	105 <TR><TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	106 <TR><TD></TD><TD>ALSA:</TD><TD>Both OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	107 <TR><TD></TD><TD>Max kHz:</TD><TD>192</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	108
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	109 <TR><TD COLSPAN=3><B>SB AWE 64</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	110 <TR><TD></TD><TD>OSS:</TD><TD>max 44kHz</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	111 <TR><TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	112 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1892 70dbd25c128c jo sok ilyen ize. gabucino parents: 1704 diff changeset	113
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	114 <TR><TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	115 <TR><TD></TD><TD>OSS:</TD><TD>not OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	116 <TR><TD></TD><TD>ALSA:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	117 <TR><TD></TD><TD>Max kHz:</TD><TD>44</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	118
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	119 <TR><TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	120 <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	121 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	122 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	123
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	124 <TR><TD COLSPAN=3><B>ESS 688</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	125 <TR><TD></TD><TD>OSS:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	126 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	127 <TR><TD></TD><TD>Max kHz:</TD><TD>48</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	128
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	129 <TR><TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	130 <TR><TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	131 <TR><TD></TD><TD>ALSA:</TD><TD>OK (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	132 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	133
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	134 <TR><TD COLSPAN=3><B>Yamaha cards (ymf)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	135 <TR><TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	136 <TR><TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	137 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	138
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	139 <TR><TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	140 <TR><TD></TD><TD>OSS:</TD><TD>?</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	141 <TR><TD></TD><TD>OSS/Pro:</TD><TD>OK</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	142 <TR><TD></TD><TD>ALSA:</TD><TD>?</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	143 <TR><TD></TD><TD>Max kHz:</TD><TD>?</TD></TR>
3438 963b39283f48 fixes, and some new stuff. sorry forgot :) gabucino parents: 3276 diff changeset	144
6975 d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	145 <TR><TD COLSPAN=3><B>PC Speaker or DAC</B></TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	146 <TR><TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	147 <TR><TD></TD><TD>ALSA:</TD><TD>no driver</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	148 <TR><TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD></TR>
d2cdfb831265 Sanitize a HTML table, <TR> are at the proper place and get closed. diego parents: 6974 diff changeset	149 <TR><TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD></TR>
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	150 </TABLE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	151
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	152 <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	153
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	154 <P>If the sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g.
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	155 <CODE>hdparm -u1 /dev/cdrom</CODE> (<CODE>man hdparm</CODE>). This is
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	156 generally beneficial and described in more detail in the
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	157 <A HREF="cd-dvd.html#drives">CD-ROM section</A>.</P>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	158
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	159 <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	160 and your sound card(s) worked together.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	161
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	162
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	163 <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	164
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	165 <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	166 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	167 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	168 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	169 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	170 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	171 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	172 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	173 they appear in the comma separated list.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	174
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	175 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	176   <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	177
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	178 <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	179 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	180
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	181 <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	182 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	183 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	184 filters in combination with filter specific switches:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	185
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	186 <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	187 -srate 11025 media.avi</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	188
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	189 <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	190 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	191
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	192 <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	193 <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	194
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	195 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	196 <DT><CODE>force</CODE><DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	197 <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	198 speed/accuracy optimizations they use:
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	199 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	200 <DT><CODE>0</CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	201 <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	202 speed.</DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	203 <DT><CODE>1</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	204 <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	205 speed.<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	206 <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	207 and the sound quality may drop.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	208 <DT><CODE>2</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	209 <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	210 <DT><CODE>3</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	211 <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	212 <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	213 setting.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	214 <DT><CODE>4</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	215 <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	216 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	217 <DT><CODE>5</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	218 <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	219 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	220 <DT><CODE>6</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	221 <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	222 floating point processing when possible.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	223 <DT><CODE>7</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	224 <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	225 floating point processing when possible.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	226 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	227 </DD>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	228
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	229 <DT><CODE>list</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	230 <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	231 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	232
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	233 <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	234
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	235 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	236 <DT><CODE>-v</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	237 <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	238 status messages.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	239 <DT><CODE>-channels</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	240 <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	241 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	242 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	243 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	244 default routing for the channels filter.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	245 <DT><CODE>-srate</CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	246 <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	247 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	248 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	249 to compensate for the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	250 <DT><CODE>-format</CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	251 <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	252 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	253 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	254 rectify the difference.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	255 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	256
8750 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 <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	259
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	260 <P>MPlayer fully supports sound up/down-sampling through the
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	261 <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	262 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	263 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	264 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	265 has three switches:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	266
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	267 <DL>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	268 <DT><CODE>srate <8000-192000></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	269 <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	270 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	271 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	272 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	273 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	274 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	275
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	276 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	277 <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	278 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	279 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	280 default.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	281
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	282 <DT><CODE>type <0-2></CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	283 <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	284 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	285 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	286 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	287 <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	288 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	289 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	290 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	291 the highest CPU load.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	292 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	293
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	294 <P>Example:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	295   <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	296
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	297 <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	298 output frequency scaling and linear interpolation.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	299
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	300
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	301 <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	302
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	303 <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	304 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	305 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	306 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	307 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	308
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	309 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	310 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	311 <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	312 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	313 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	314
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	315 <DT><CODE>nr <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	316 <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	317 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	318 omitted the default routing is used.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	319
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	320 <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	321 <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	322 where each channel should be routed.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	323 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	324
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	325 <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	326 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	327 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	328 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	329 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	330 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	331
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	332 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	333   <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	334
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	335 <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	336 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	337 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	338 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	339
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	340 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	341   <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	342
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	343 <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	344 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	345
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	346
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	347 <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	348
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	349 <P>The <CODE>format</CODE> filter converts between different sample formats. It
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	350 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	351
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	352 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	353 <DT><CODE>bps <number></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	354 <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	355 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	356 results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	357
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	358 <DT><CODE>f <format></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	359 <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	360 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	361 <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	362 <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	363 <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	364 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	365 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	366
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	367 <P>Example:<BR>
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	368   <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	369
8772 605f2c290b20 small fix nicolas parents: 8757 diff changeset	370 <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	371 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	372
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	373
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	374 <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	375
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	376 <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	377 the sound from the different channels arrives at the listening position
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	378 simultaneously.
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	379 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	380 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	381
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	382 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	383 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	384 <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	385 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	386 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	387 </DL>
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 <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	390
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	391 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	392 <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	393 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	394 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	395 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	396 <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	397 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	398 <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	399 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	400 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	401
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	402 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	403   <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	404
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	405 <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	406 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	407
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 <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	410
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	411 <P>Software volume control is implemented by the <CODE>volume</CODE> audio
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	412 filter. Use this filter with caution since
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	413 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	414 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	415 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	416 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	417 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	418 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	419 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	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>v <-200 - +60></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	423 <DD>is a floating point number between <CODE>-200</CODE> and <CODE>+60</CODE>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	424 which represents the volume level in dB. The default level is -10dB.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	425
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	426 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	427 <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	428 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	429 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	430 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	431 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	432
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	433 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	434   <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	435
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	436 <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	437 high.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	438
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	439 <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	440 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	441 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	442 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	443
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	444
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	445 <H5><A NAME="af_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	446
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	447 <P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	448 equalizer, implemented using 10 IIR
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	449 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	450 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	451
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	452 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	453 <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	454 <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	455 <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	456 <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	457 <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	458 <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	459 <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	460 <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	461 <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	462 <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	463 <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	464 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	465
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	466 <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	467 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	468 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	469 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	470 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	471 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	472
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	473 <P>This filter has 10 parameters:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	474
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	475 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	476 <DT><CODE>g1:g2:g3...g10</CODE></DT>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	477 <DD>are floating point numbers between <CODE>-12<CODE> and <CODE>+12</CODE>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	478 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	479 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	480
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	481 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	482   <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	483
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	484 <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	485 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	486
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	487
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	488 <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	489
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	490 <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	491 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	492 major uses for this filter: </P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	493
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	494 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	495 <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	496 <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	497 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	498
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	499 <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	500 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	501 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	502
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	503 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	504 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	505 <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	506 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	507 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	508
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	509 <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	510 <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	511 <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	512 output channel i.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	513 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	514
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	515 <P>Example 1:<BR>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	516   <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	517
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	518 <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	519
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	520 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	521   <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	522
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	523 <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	524 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	525 example).</P>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	526
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	527
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	528 <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	529
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	530 <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	531 The audio data
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	532 used for creating the sub-woofer channel is an average of the sound in channel
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	533 0 and channel 1. The resulting sound is then low-pass filtered by a a 4th
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	534 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	535 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	536 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	537 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	538
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	539 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	540 <DT><CODE>fc <20-300></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	541 <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	542 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	543 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	544 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	545 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	546
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	547 <DT><CODE>ch <0-5></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	548 <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	549 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	550 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	551 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	552 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	553 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	554
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	555 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	556   <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	557
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	558 <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	559 channel 4.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	560
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	561 <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	562
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	563 <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	564 filter. Dolby Surround is
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	565 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	566 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	567 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	568
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	569 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	570 <DT><CODE>d <0-1000></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	571 <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	572 <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	573 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	574 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	575 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	576 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	577 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	578 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	579
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	580 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	581   <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	582
8950 8fd72eae8886 Small updates for correctness and consistency. diego parents: 8891 diff changeset	583 <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	584 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	585
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	586
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	587
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	588
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	589 <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	590 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	591
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	592 <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	593
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	594 <P>MPlayer has support for audio plugins. Audio plugins can be used for
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	595 changing the properties of the audio data before the sound reaches the sound
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	596 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	597 <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	598 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	599 should be executed. Example:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	600
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	601 <P>  <CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	602
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	603 <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	604 plugin.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	605
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	606 <P>The plugins can also have switches that change their behavior. These
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	607 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	608 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	609 to use plugins in combination with plugin specific switches:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	610
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	611 <P>  <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	612 list=resample,format:fout=44100:format=0x8</CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	613
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	614 <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	615 output format of the format plugin to AFMT_U8.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	616
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	617 <P>Currently audio plugins can not be used in MEncoder.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	618
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	619
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	620 <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	621
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	622 <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	623 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	624 stuck with an old sound card that is only capable of max 44.1kHz.
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	625 Whether is usage of this plugin is necessary or not, is <B>autodetected</B>.
8260 352b654c7787 updates gabucino parents: 8177 diff changeset	626 This plugin has one switch:
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	627 <CODE>fout</CODE> which is used for setting the desired output sample
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	628 frequency. It defaults to 48kHz, and is given in
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	629 <Hz>.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	630
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	631 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	632   <CODE>mplayer media.avi -aop list=resample:fout=<required
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	633 frequency in Hz, like 44100></CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	634
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	635 <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	636 Scaling up will cause the audio and video streams to be played in slow motion
913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	637 in addition to audio distortion.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	638
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	639
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	640 <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	641
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	642 <P>MPlayer has an audio plugin that can decode matrix encoded
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	643 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	644 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	645 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	646
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	647 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	648   <CODE>mplayer media.avi -aop list=surround</CODE></P>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	649
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	650
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	651 <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	652
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	653 <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	654 this plugin can
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	655 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	656 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	657 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	658 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	659 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	660
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	661 <P>Usage:<BR>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	662   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	663 list=format:format=<required output format></CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	664
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	665
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	666 <H5><A NAME="delay">2.3.2.4.4 Delay</A></H5>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	667
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	668 <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	669 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	670 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	671 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	672
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	673
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	674 <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	675
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	676 <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	677 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	678 used if one wants to change the output volume of MPlayer
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	679 without changing the PCM volume setting in the mixer. It has one
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	680 switch <CODE>volume</CODE> that is used for setting the initial
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	681 sound level. The initial sound level can be set to values between 0
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	682 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	683 plugin with caution since it can reduce the signal to noise ratio of
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	684 the sound. In most cases it is best to set the level for the PCM
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	685 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	686 your speakers with the master volume control of the mixer. If there is an
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	687 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	688 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	689 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	690 in the background is gone.</P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	691
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	692 <P>Usage:<BR>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	693   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	694 list=volume:volume=<0-255></CODE></P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	695
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	696 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	697 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	698 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	699 low. Be aware that this feature creates distortion and should be
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	700 considered a last resort.</P>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	701
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	702 <P>Usage:<BR>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	703   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	704 list=volume:softclip</CODE></P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	705
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	706
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	707 <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	708
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	709 <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	710 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	711 effect to playback.</P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	712
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	713 <P>Usage:<BR>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	714   <CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	715   <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	716
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	717 <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	718 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	719 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	720 -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	721
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	722
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	723 <H5><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H5>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	724
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	725 <P>This plugin maximizes the volume without distorting the sound.</P>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	726
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	727 <P>Usage:<BR>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	728   <CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	729
5721 b53597b930b1 more deciliters gabucino parents: 5123 diff changeset	730
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	731 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	732 </HTML>

Mercurial > mplayer.hg

annotate DOCS/sound.html @ 8950:8fd72eae8886