From a698cc81126c6958d9d67f02a71277cc7f183454 Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Sun, 1 Dec 2013 18:27:18 +0100 Subject: doc: move documentation from mpd.conf.5 to the user manual --- doc/user.xml | 144 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 143 insertions(+), 1 deletion(-) (limited to 'doc/user.xml') diff --git a/doc/user.xml b/doc/user.xml index 5c810dc70..a74c1ce27 100644 --- a/doc/user.xml +++ b/doc/user.xml @@ -393,7 +393,7 @@ systemctl start mpd.socket a name registered in the PULSE server. - + format @@ -607,6 +607,148 @@ systemctl start mpd.socket + +
+ Audio Format Settings + +
+ Global Audio Format + + + The setting audio_output_format forces + MPD to use one audio format for all outputs. Doing that is + usually not a good idea. The values are the same as in + format in the + audio_output section. + +
+ +
+ Resampler + + + Sometimes, music needs to be resampled before it can be + played; for example, CDs use a sample rate of 44,100 Hz + while many cheap audio chips can only handle 48,000 Hz. + Resampling reduces the quality and consumes a lot of CPU. + There are different options, some of them optimized for high + quality and others for low CPU usage, but you can't have + both at the same time. Often, the resampler is the + component that is responsible for most of MPD's CPU usage. + Since MPD comes with high quality defaults, it may appear + that MPD consumes more CPU than other software. + + + + The following resamplers are available (if enabled at + compile time): + + + + + + libsamplerate + a.k.a. Secret Rabbit Code (SRC). + + + + + + internal: low CPU usage, but very poor quality. This is + the fallback if MPD was compiled without an external + resampler. + + + + + + The setting samplerate_converter controls + how MPD shall resample music. Possible values: + + + + + + + + Value + + + Description + + + + + + + "internal" + + + The internal resampler. Low CPU usage, but very + poor quality. + + + + + + "Best Sinc Interpolator" or + "0" + + + libsamplerate: Band limited sinc interpolation, best + quality, 97dB SNR, 96% BW. + + + + + + "Medium Sinc Interpolator" or + "1" + + + libsamplerate: Band limited sinc interpolation, + medium quality, 97dB SNR, 90% BW. + + + + + + "Fastest Sinc Interpolator" or + "2" + + + libsamplerate: Band limited sinc interpolation, + fastest, 97dB SNR, 80% BW. + + + + + + "ZOH Sinc Interpolator" or + "3" + + + libsamplerate: Zero order hold interpolator, very + fast, very poor quality with audible distortions. + + + + + + "Linear Interpolator" or + "4" + + + libsamplerate: Linear interpolator, very fast, poor + quality. + + + + + +
+
-- cgit v1.2.3