comparison DOCS/sound.html @ 8950:8fd72eae8886

Small updates for correctness and consistency.

8949:d07ab8e088a9

</DL>


<H5><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H5>

<P>MPlayer fully supports sound up/down-sampling. This filter can be used if you
  have a fixed frequency sound card or if you are stuck with an old sound card
  that is only capable of max 44.1kHz. This filter is automatically enabled if
  it is necessary, but it can also be explicitly enabled on the command line. It
  has three switches:</P>

<DL>
  <DT><CODE>srate &lt;8-192&gt;</CODE></DT>
  <DD>is an integer used for setting the output sample
    frequency in Hz. The valid range for this parameter is 8kHz to 192kHz. If
    the input and output sample frequency are the same or if this parameter is
    omitted the filter is automatically unloaded. A high sample frequency
    normally improves the audio quality, especially when used in combination

    best quality is given by <CODE>2</CODE> but this method also suffers from
    the highest CPU load.</DD>
</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer -af resample=44100:0:1</CODE></P>

<P>would set the output frequency of the resample filter to 44100Hz using exact
  output frequency scaling and linear interpolation.</P>

  channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence.</P>


<H5><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H5>

<P>This filter is a sample format converter. It is automatically enabled when
  needed by the sound card or another filter.</P>

<DL>
  <DT><CODE>bps &lt;number&gt;</CODE></DT>
  <DD>can be <CODE>1</CODE>, <CODE>2</CODE> or <CODE>4</CODE> and denotes the
    number of bytes per sample. This switch is required, leaving it empty

    <CODE>be</CODE> (little or big endian). This switch is required, leaving it
    empty results in a runtime error.</DD>
</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer media.avi -af format=4:float</CODE></P>

<P>would set the output format to 4 bytes per sample floating point
  data.</P>


<H5><A NAME="af_delay">2.3.2.3.4 Delay</A></H5>

<P>This filter delays the sound to the loudspeakers in order to make the sound
  in the different channels arrive at the same time to the listening position.
  It is only useful if you have more than 2 loudspeakers. This filter has a
  variable number of parameters:</P>

<DL>
  <DT><CODE>d1:d2:d3...</CODE></DT>

  by 0ms and the center channel by 7ms.</P>


<H5><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H5>

<P>This filter is a software volume control. Use this filter with caution since
  it can reduce the signal to noise ratio of the sound. In most cases it is best
  to set the level for the PCM sound to max, leave this filter out and control
  the output level to your speakers with the master volume control of the mixer.
  If there is an external amplifier connected to the computer (this is almost
  always the case), the noise level can be minimized by adjusting the master

  utilized.</P>


<H5><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H5>

<P>This filter is a 10 octave band graphic equalizer, implemented using 10 IIR
  band pass filters. This means that it works regardless of what type of audio
  is being played back. The center frequencies for the 10 bands are:</P>

<TABLE BORDER="0" WIDTH="100%">
  <TR><TD>Band No.</TD><TD>Center frequency</TD></TR>

  &nbsp;&nbsp;<CODE>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</CODE></P>

<P>would amplify the sound in the upper and lower frequency region while
  canceling it almost completely around 1kHz.</P>

<H5><A NAME="af_panning">2.3.2.3.7 Panning filter </A></H5>

<P>This filter can be used for mixing the channels arbitrarily. It is basically
  a combination of the volume control and the channels filter. There are two
  major uses for this filter: </P>

<OL>
  <LI>Down-mixing many channels to only a few, stereo to mono for example.</LI>

  example).</P>


<H5><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H5>

<P>This filter adds a sub woofer channel to the audio stream. The audio data
  used for creating the sub-woofer channel is an average of the sound in channel
  0 and channel 1. The resulting sound is then low-pass filtered by a a 4th
  order Butterworth filter with a default cutoff frequency of 60Hz and added to
  a separate channel in the audio stream. Warning: Disable this filter when you
  are playing DVDs with Dolby Digital 5.1 sound, otherwise this filter will

<P>would add a sub-woofer channel with a cutoff frequency of 100Hz to output
  channel 4.</P>

<H5><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H5>

<P>This filter is a decoder for matrix encoded surround sound. Dolby Surround is
  an example of a matrix encoded format. Many files with 2 channel audio
  actually contain matrixed surround sound. To use this feature you need a sound
  card supporting at least 4 channels. This filter has one parameter:</P>

<DL>

</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer -af surround=15 -channels 4 media.avi</CODE></P>

<P>would add a surround sound decoding with 15ms delay for the sound to the rear
  speakers.</P>

8950:8fd72eae8886

</DL>


<H5><A NAME="af_resample">2.3.2.3.1 Up/Down-sampling</A></H5>

<P>MPlayer fully supports sound up/down-sampling through the
  <CODE>resample</CODE> filter. It can be used if you
  have a fixed frequency sound card or if you are stuck with an old sound card
  that is only capable of max 44.1kHz. This filter is automatically enabled if
  it is necessary, but it can also be explicitly enabled on the command line. It
  has three switches:</P>

<DL>
  <DT><CODE>srate &lt;8000-192000&gt;</CODE></DT>
  <DD>is an integer used for setting the output sample
    frequency in Hz. The valid range for this parameter is 8kHz to 192kHz. If
    the input and output sample frequency are the same or if this parameter is
    omitted the filter is automatically unloaded. A high sample frequency
    normally improves the audio quality, especially when used in combination

    best quality is given by <CODE>2</CODE> but this method also suffers from
    the highest CPU load.</DD>
</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer -af resample=44100:0:0</CODE></P>

<P>would set the output frequency of the resample filter to 44100Hz using exact
  output frequency scaling and linear interpolation.</P>

  channel 0 to channels 0 to 3. Channel 4 and 5 will contain silence.</P>


<H5><A NAME="af_format">2.3.2.3.3 Sample format converter</A></H5>

<P>The <CODE>format</CODE> filter converts between different sample formats. It
  is automatically enabled when needed by the sound card or another filter.</P>

<DL>
  <DT><CODE>bps &lt;number&gt;</CODE></DT>
  <DD>can be <CODE>1</CODE>, <CODE>2</CODE> or <CODE>4</CODE> and denotes the
    number of bytes per sample. This switch is required, leaving it empty

    <CODE>be</CODE> (little or big endian). This switch is required, leaving it
    empty results in a runtime error.</DD>
</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer -af format=4:float media.avi</CODE></P>

<P>would set the output format to 4 bytes per sample floating point
  data.</P>


<H5><A NAME="af_delay">2.3.2.3.4 Delay</A></H5>

<P>The <CODE>delay</CODE> filter delays the sound to the loudspeakers such that
  the sound from the different channels arrives at the listening position
  simultaneously.
  It is only useful if you have more than 2 loudspeakers. This filter has a
  variable number of parameters:</P>

<DL>
  <DT><CODE>d1:d2:d3...</CODE></DT>

  by 0ms and the center channel by 7ms.</P>


<H5><A NAME="af_volume">2.3.2.3.5 Software volume control</A></H5>

<P>Software volume control is implemented by the <CODE>volume</CODE> audio
  filter. Use this filter with caution since
  it can reduce the signal to noise ratio of the sound. In most cases it is best
  to set the level for the PCM sound to max, leave this filter out and control
  the output level to your speakers with the master volume control of the mixer.
  If there is an external amplifier connected to the computer (this is almost
  always the case), the noise level can be minimized by adjusting the master

  utilized.</P>


<H5><A NAME="af_equalizer">2.3.2.3.6 Equalizer</A></H5>

<P>The <CODE>equalizer</CODE> filter represents a 10 octave band graphic
  equalizer, implemented using 10 IIR
  band pass filters. This means that it works regardless of what type of audio
  is being played back. The center frequencies for the 10 bands are:</P>

<TABLE BORDER="0" WIDTH="100%">
  <TR><TD>Band No.</TD><TD>Center frequency</TD></TR>

  &nbsp;&nbsp;<CODE>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi</CODE></P>

<P>would amplify the sound in the upper and lower frequency region while
  canceling it almost completely around 1kHz.</P>


<H5><A NAME="af_panning">2.3.2.3.7 Panning filter </A></H5>

<P>Use the <CODE>pan</CODE> filter to mix channels arbitrarily. It is basically
  a combination of the volume control and the channels filter. There are two
  major uses for this filter: </P>

<OL>
  <LI>Down-mixing many channels to only a few, stereo to mono for example.</LI>

  example).</P>


<H5><A NAME="af_sub">2.3.2.3.8 Sub-woofer</A></H5>

<P>The <CODE>sub</CODE> filter adds a sub woofer channel to the audio stream.
  The audio data
  used for creating the sub-woofer channel is an average of the sound in channel
  0 and channel 1. The resulting sound is then low-pass filtered by a a 4th
  order Butterworth filter with a default cutoff frequency of 60Hz and added to
  a separate channel in the audio stream. Warning: Disable this filter when you
  are playing DVDs with Dolby Digital 5.1 sound, otherwise this filter will

<P>would add a sub-woofer channel with a cutoff frequency of 100Hz to output
  channel 4.</P>

<H5><A NAME="af_surround">2.3.2.3.9 Surround-sound decoder</A></H5>

<P>Matrix encoded surround sound can be decoded by the <CODE>surround</CODE>
  filter. Dolby Surround is
  an example of a matrix encoded format. Many files with 2 channel audio
  actually contain matrixed surround sound. To use this feature you need a sound
  card supporting at least 4 channels. This filter has one parameter:</P>

<DL>

</DL>

<P>Example:<BR>
  &nbsp;&nbsp;<CODE>mplayer -af surround=15 -channels 4 media.avi</CODE></P>

<P>would add surround sound decoding with 15ms delay for the sound to the rear
  speakers.</P>