mplayer.hg: DOCS/sound.html annotate

annotate DOCS/sound.html @ 8891:5b73c925436e

Further libaf documentation by Anders with some more updates by me.

author	diego
date	Sat, 11 Jan 2003 14:09:19 +0000
parents	9476ccf6a41d
children	8fd72eae8886

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
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	260 <P>MPlayer fully supports sound up/down-sampling. This filter can be used if you
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	261 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	262 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	263 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	264 has three switches:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	265
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	266 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	267 <DT><CODE>srate <8-192></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	268 <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	269 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	270 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	271 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	272 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	273 with other filters.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	274
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	275 <DT><CODE>sloppy</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	276 <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	277 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	278 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	279 default.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	280
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	281 <DT><CODE>type <0-2></CODE><DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	282 <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	283 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	284 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	285 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	286 <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	287 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	288 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	289 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	290 the highest CPU load.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	291 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	292
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	293 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	294   <CODE>mplayer -af resample=44100:0:1</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	295
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	296 <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	297 output frequency scaling and linear interpolation.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	298
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 <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	301
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	302 <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	303 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	304 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	305 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	306 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	307
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	308 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	309 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	310 <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	311 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	312 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	313
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	314 <DT><CODE>nr <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	315 <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	316 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	317 omitted the default routing is used.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	318
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	319 <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	320 <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	321 where each channel should be routed.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	322 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	323
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	324 <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	325 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	326 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	327 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	328 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	329 channels are truncated.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	330
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	331 <P>Example 1:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	332   <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	333
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	334 <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	335 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	336 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	337 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	338
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	339 <P>Example 2:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	340   <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	341
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	342 <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	343 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	344
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 <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	347
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	348 <P>This filter is a sample format converter. It is automatically enabled when
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	349 needed by the sound card or another filter.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	350
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	351 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	352 <DT><CODE>bps <number></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	353 <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	354 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	355 results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	356
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	357 <DT><CODE>f <format></CODE></DT>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	358 <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	359 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	360 <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	361 <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	362 <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	363 empty results in a runtime error.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	364 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	365
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	366 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	367   <CODE>mplayer media.avi -af format=4:float</CODE></P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	368
8772 605f2c290b20 small fix nicolas parents: 8757 diff changeset	369 <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	370 data.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	371
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	372
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	373 <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	374
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	375 <P>This filter delays the sound to the loudspeakers in order to make the sound
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	376 in the different channels arrive at the same time to the listening position.
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	377 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	378 variable number of parameters:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	379
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	380 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	381 <DT><CODE>d1:d2:d3...</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	382 <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	383 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	384 is 1000ms.</DD>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	385 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	386
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	387 <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	388
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	389 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	390 <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	391 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	392 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	393 difference anyway).</LI>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	394 <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	395 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	396 <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	397 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	398 </OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	399
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	400 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	401   <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	402
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	403 <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	404 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	405
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	406
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	407 <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	408
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	409 <P>This filter is a software volume control. Use this filter with caution since
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	410 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	411 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	412 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	413 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	414 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	415 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	416 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	417
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	418 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	419 <DT><CODE>v <-200 - +60></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	420 <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	421 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	422
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	423 <DT><CODE>c</CODE></DT>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	424 <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	425 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	426 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	427 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	428 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	429
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	430 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	431   <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	432
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	433 <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	434 high.</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>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	437 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	438 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	439 utilized.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	440
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	441
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	442 <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	443
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	444 <P>This filter is a 10 octave band graphic equalizer, implemented using 10 IIR
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	445 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	446 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	447
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	448 <TABLE BORDER="0" WIDTH="100%">
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	449 <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	450 <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	451 <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	452 <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	453 <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	454 <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	455 <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	456 <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	457 <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	458 <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	459 <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	460 </TABLE>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	461
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	462 <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	463 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	464 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	465 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	466 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	467 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	468
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	469 <P>This filter has 10 parameters:</P>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	470
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	471 <DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	472 <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	473 <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	474 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	475 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	476
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	477 <P>Example:<BR>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	478   <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	479
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	480 <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	481 canceling it almost completely around 1kHz.</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	482
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	483 <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	484
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	485 <P>This filter can be used for mixing the channels arbitrarily. It is basically
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	486 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	487 major uses for this filter: </P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	488
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	489 <OL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	490 <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	491 <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	492 </OL>
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 <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	495 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	496 the number of output channels:</P>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	497
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	498 <DL>
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	499 <DT><CODE>nch <1-6></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	500 <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	501 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	502 empty results in a runtime error.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	503
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	504 <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	505 <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	506 <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	507 output channel i.</DD>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	508 </DL>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	509
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	510 <P>Example 1:<BR>
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	511   <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	512
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	513 <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	514
8849 9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	515 <P>Example 2:<BR>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	516   <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	517
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	518 <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	519 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	520 example).</P>
9476ccf6a41d another pan example by Anders diego parents: 8772 diff changeset	521
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	522
8891 5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	523 <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	524
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	525 <P>This filter adds a sub woofer channel to the audio stream. The audio data
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	526 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	527 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	528 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	529 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	530 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	531 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	532
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	533 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	534 <DT><CODE>fc <20-300></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	535 <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	536 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	537 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	538 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	539 60Hz.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	540
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	541 <DT><CODE>ch <0-5></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	542 <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	543 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	544 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	545 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	546 necessary.</DD>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	547 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	548
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	549 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	550   <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	551
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	552 <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	553 channel 4.</P>
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 <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	556
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	557 <P>This filter is a decoder for matrix encoded surround sound. Dolby Surround is
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	558 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	559 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	560 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	561
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	562 <DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	563 <DT><CODE>d <0-1000></CODE></DT>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	564 <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	565 <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	566 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	567 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	568 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	569 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	570 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	571 </DL>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	572
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	573 <P>Example:<BR>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	574   <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	575
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	576 <P>would add a surround sound decoding with 15ms delay for the sound to the rear
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	577 speakers.</P>
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	578
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
5b73c925436e Further libaf documentation by Anders with some more updates by me. diego parents: 8849 diff changeset	581
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	582 <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	583 removed soon.</STRONG></H2>
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	584
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	585 <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	586
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	587 <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	588 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	589 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	590 <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	591 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	592 should be executed. Example:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	593
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	594 <P>  <CODE>mplayer media.avi -aop list=resample,format</CODE></P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	595
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	596 <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	597 plugin.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	598
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	599 <P>The plugins can also have switches that change their behavior. These
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	600 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	601 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	602 to use plugins in combination with plugin specific switches:</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	603
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	604 <P>  <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	605 list=resample,format:fout=44100:format=0x8</CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	606
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	607 <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	608 output format of the format plugin to AFMT_U8.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	609
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	610 <P>Currently audio plugins can not be used in MEncoder.</P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	611
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	612
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	613 <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	614
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	615 <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	616 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	617 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	618 Whether is usage of this plugin is necessary or not, is <B>autodetected</B>.
8260 352b654c7787 updates gabucino parents: 8177 diff changeset	619 This plugin has one switch:
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	620 <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	621 frequency. It defaults to 48kHz, and is given in
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	622 <Hz>.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	623
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	624 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	625   <CODE>mplayer media.avi -aop list=resample:fout=<required
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	626 frequency in Hz, like 44100></CODE></P>
e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	627
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	628 <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	629 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	630 in addition to audio distortion.</P>
3671 e84d8f81a120 'Plugins' subsection in Sound section gabucino parents: 3438 diff changeset	631
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	632
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	633 <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	634
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7453 diff changeset	635 <P>MPlayer has an audio plugin that can decode matrix encoded
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	636 surround sound. Dolby Surround is an example of a matrix encoded format.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	637 Many files with 2 channel audio actually contain matrixed surround sound.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	638 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	639
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	640 <P>Usage:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	641   <CODE>mplayer media.avi -aop list=surround</CODE></P>
3931 ef59dc91aaaf applied Steve's patch gabucino parents: 3857 diff changeset	642
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	643
8177 1f00a3d29b20 some TOC reorder gabucino parents: 7814 diff changeset	644 <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	645
f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	646 <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	647 this plugin can
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	648 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	649 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	650 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	651 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	652 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	653
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	654 <P>Usage:<BR>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	655   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	656 list=format:format=<required output format></CODE></P>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	657
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	658
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	659 <H5><A NAME="delay">2.3.2.4.4 Delay</A></H5>
4508 fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	660
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	661 <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	662 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	663 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	664 plugin unless you are a developer.</P>
fb02f169e8e2 added more audio plugin documentation gabucino parents: 4469 diff changeset	665
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 6998 diff changeset	666
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	667 <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	668
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	669 <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	670 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	671 used if one wants to change the output volume of MPlayer
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	672 without changing the PCM volume setting in the mixer. It has one
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	673 switch <CODE>volume</CODE> that is used for setting the initial
5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	674 sound level. The initial sound level can be set to values between 0
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	675 and 255 and defaults to 101 which equals 0dB amplification. Use this
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	676 plugin with caution since it can reduce the signal to noise ratio of
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	677 the sound. In most cases it is best to set the level for the PCM
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	678 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	679 your speakers with the master volume control of the mixer. If there is an
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	680 external amplifier connected to the computer (this is almost always
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	681 the case), the noise level can be minimized by adjusting the master
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	682 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	683 in the background is gone.</P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	684
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	685 <P>Usage:<BR>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	686   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	687 list=volume:volume=<0-255></CODE></P>
4913 5eb369bc0188 applied Anders' Software Volume Control patch gabucino parents: 4908 diff changeset	688
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	689 <P>This plugin also has compressor or "soft-clipping" capabilities.
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	690 Compression can be used if the dynamic range of the sound is very
922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	691 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	692 low. Be aware that this feature creates distortion and should be
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	693 considered a last resort.</P>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	694
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	695 <P>Usage:<BR>
5099 922258ac9cf2 softclipping (ammegmi?) gabucino parents: 5069 diff changeset	696   <CODE>mplayer media.avi -aop
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	697 list=volume:softclip</CODE></P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	698
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	699
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	700 <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	701
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	702 <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	703 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	704 effect to playback.</P>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	705
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	706 <P>Usage:<BR>
4928 ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	707   <CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	708   <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	709
ecf9f93dd9b6 added documentation for "extrastereo" plugin (patch by pl) gabucino parents: 4913 diff changeset	710 <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	711 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	712 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	713 -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	714
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	715
8750 f6323ff433aa New audio filter documentation by Anders Johannsson with some structural diego parents: 8260 diff changeset	716 <H5><A NAME="normalizer">2.3.2.4.7 Volume normalizer</A></H5>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	717
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	718 <P>This plugin maximizes the volume without distorting the sound.</P>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	719
5765 913cd7f4b8c5 applied Holm^H^H^H^HDiego's (?:) patch gabucino parents: 5721 diff changeset	720 <P>Usage:<BR>
5109 0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	721   <CODE>mplayer media.avi -aop list=volnorm</CODE><BR>
0ac187a189a8 volume normalizer plugin added gabucino parents: 5099 diff changeset	722
5721 b53597b930b1 more deciliters gabucino parents: 5123 diff changeset	723
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	724 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	725 </HTML>

Mercurial > mplayer.hg

annotate DOCS/sound.html @ 8891:5b73c925436e