alsa: optionally disable resampling and others

Added mpd.conf options for disabling automatic resamling, sample
format and channel conversion.  This way, users may choose to override
ALSA's automatic resampling, and use libsamplerate instead.

1 files changed, 13 insertions, 0 deletions

diff --git a/doc/mpd.conf.5 b/doc/mpd.conf.5
index 5ede7e744..34c194089 100644
--- a/doc/mpd.conf.5
+++ b/doc/mpd.conf.5
@@ -274,6 +274,19 @@ Setting this allows you to use memory-mapped I/O.  Certain hardware setups may
 benefit from this, but most do not.  Most users do not need to set this.  The
 default is to not use memory-mapped I/O.
 .TP
+.B auto_resample <yes or no>
+Setting this to "no" disables ALSA's software resampling, if the
+hardware does not support a specific sample rate.  This lets MPD do
+the resampling.  "yes" is the default and allows ALSA to resample.
+.TP
+.B auto_channels <yes or no>
+Setting this to "no" disables ALSA's channel conversion, if the
+hardware does not support a specific number of channels.  Default: "yes".
+.TP
+.B auto_format <yes or no>
+Setting this to "no" disables ALSA's sample format conversion, if the
+hardware does not support a specific sample format.  Default: "yes".
+.TP
 .B buffer_time <time in microseconds>
 This sets the length of the hardware sample buffer in microseconds.  Increasing
 it may help to reduce or eliminate skipping on certain setups.  Most users do