[pulseaudio-discuss] [PATCH 4/4] Added documentation for soxr resampling methods.

[Peter Meerwald]

On Thu, 8 Jan 2015, Andrey Semashev wrote:

extreme nitpicking below

> ---
>  man/pulse-daemon.conf.5.xml.in | 14 +++++++++++---
>  1 file changed, 11 insertions(+), 3 deletions(-)
> 
> diff --git a/man/pulse-daemon.conf.5.xml.in b/man/pulse-daemon.conf.5.xml.in
> index 754312e..e1ee673 100644
> --- a/man/pulse-daemon.conf.5.xml.in
> +++ b/man/pulse-daemon.conf.5.xml.in
> @@ -88,7 +88,8 @@ USA.
>        <opt>src-sinc-medium-quality</opt>, <opt>src-sinc-fastest</opt>,
>        <opt>src-zero-order-hold</opt>, <opt>src-linear</opt>,
>        <opt>trivial</opt>, <opt>speex-float-N</opt>,
> -      <opt>speex-fixed-N</opt>, <opt>ffmpeg</opt>. See the
> +      <opt>speex-fixed-N</opt>, <opt>ffmpeg</opt>, <opt>soxr-mq</opt>,
> +      <opt>soxr-hq</opt>, <opt>soxr-vhq</opt>. See the
>        documentation of libsamplerate and speex for explanations of the
>        different src- and speex- methods, respectively. The method
>        <opt>trivial</opt> is the most basic algorithm implemented. If
> @@ -98,8 +99,15 @@ USA.
>        exist in two flavours: <opt>fixed</opt> and <opt>float</opt>. The former uses fixed point
>        numbers, the latter relies on floating point numbers. On most
>        desktop CPUs the float point resampler is a lot faster, and it
> -      also offers slightly better quality. See the output of
> -      <opt>dump-resample-methods</opt> for a complete list of all
> +      also offers slightly better quality. The soxr- family methods

Soxr-family

> +      are based on libsoxr, a resampler library from SoX sound processing utility.

from the SoX

> +      The mq variant has the best performance of the three. The hq is more expensive
> +      and, according to SoX developers, is considered the best choice for audio of up to 16 bits per sample.
> +      The vhq variant has more precision than hq and is more suitable for larger samples. The Soxr resamplers
> +      generally offer better quality at less CPU compared to other resamplers, such as speex.
> +      The downside is that it can add a significant delay to the output

they can add

> +      (usually, up to around 20 ms, in rare cases more).

usually up to around 20 ms

> +      See the output of <opt>dump-resample-methods</opt> for a complete list of all
>        available resamplers. Defaults to <opt>speex-float-1</opt>. The
>        <opt>--resample-method</opt> command line option takes precedence.
>        Note that some modules overwrite or allow overwriting of the
> -- 
> 2.1.0
> 
> _______________________________________________
> pulseaudio-discuss mailing list
> pulseaudio-discuss at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/pulseaudio-discuss
> 

-- 

Peter Meerwald
+43-664-2444418 (mobile)