<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
- documentation of libsamplerate for an explanation for the
- different src- methods. The method <opt>trivial</opt> is the most basic
- algorithm implemented. If you're tight on CPU consider using
- this. On the other hand it has the worst quality of them
- all. The Speex resamplers take an integer quality setting in the
- range 0..9 (bad...good). They 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
- resmampler 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 available resamplers. Defaults to
- <opt>speex-float-3</opt>. The <opt>--resample-method</opt>
- command line option takes precedence. Note that some modules
- overwrite or allow overwriting of the resampler to use.</p>
+ 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
+ you're tight on CPU consider using this. On the other hand it has
+ the worst quality of them all. The Speex resamplers take an
+ integer quality setting in the range 0..10 (bad...good). They
+ 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
+ available resamplers. Defaults to <opt>speex-float-3</opt>. The
+ <opt>--resample-method</opt> command line option takes precedence.
+ Note that some modules overwrite or allow overwriting of the
+ resampler to use.</p>
</option>
<option>
</option>
<option>
- <p><opt>use-pid-file=</opt> Create a PID file in
- <file>/tmp/pulse-$USER/pid</file>. Of this is enabled you may
+ <p><opt>use-pid-file=</opt> Create a PID file in the runtime directory
+ (<file>$HOME/.pulse/*-runtime/pid</file>). If this is enabled you may
use commands like <opt>--kill</opt> or <opt>--check</opt>. If
you are planning to start more than one PulseAudio process per
user, you better disable this option since it effectively
disables multiple instances. Takes a boolean argument, defaults
- to <opt>yes</opt>. The <opt>--no-cpu-limit</opt> command line
+ to <opt>yes</opt>. The <opt>--use-pid-file</opt> command line
option takes precedence.</p>
</option>
</section>
+ <section name="Default Sync Volume Settings">
+
+ <p>With the flat volume feature enabled, the sink HW volume is set
+ to the same level as the highest volume input stream. Any other streams
+ (with lower volumes) have the appropriate adjustment applied in SW to
+ bring them to the correct overall level. Sadly hadware mixer changes
+ cannot be timed accurately and thus this change of volumes can somtimes
+ cause the resulting output sound to be momentarily too loud or too soft.
+ So to ensure SW and HW volumes are applied concurrently without any
+ glitches, their application needs to be synchronized. The sink
+ implementation needs to support synchronized volumes. The following
+ parameters can be used to refine the process.</p>
+
+ <option>
+ <p><opt>enable-sync-volume=</opt> Enable sync volume for the sinks that
+ support it. This feature is enabled by default.</p>
+ </option>
+ <option>
+ <p><opt>sync-volume-safety-margin-usec=</opt> The amount of time (in
+ usec) by which the HW volume increases are delayed and HW volume
+ decreases are advanced. Defaults to 8000 usec.</p>
+ </option>
+ <option>
+ <p><opt>sync-volume-extra-delay-usec=</opt> The amount of time (in usec)
+ by which HW volume changes are delayed. Negative values are also allowed.
+ Defaults to 0.</p>
+ </option>
+
+ </section>
+
<section name="Authors">
<p>The PulseAudio Developers <@PACKAGE_BUGREPORT@>; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
</section>