doc/filters: drop duplicated description of resampler options in aresample docs

Avoid duplication, and point to the complete description of options.
Also provide a more complete specification of the supported syntax.
This commit is contained in:
Stefano Sabatini 2012-12-26 01:44:47 +01:00
parent cbed2426a0
commit 9e3b6285cb

View File

@ -410,71 +410,19 @@ Pad the end of a audio stream with silence, this can be used together with
@anchor{aresample}
@section aresample
Resample the input audio to the specified parameters. If none are specified
then the filter will automatically convert between its input
and output.
Resample the input audio to the specified parameters, using the
libswresample library. If none are specified then the filter will
automatically convert between its input and output.
This filter is also able to stretch/squeeze the audio data to make it match
the timestamps or to inject silence / cut out audio to make it match the
timestamps, do a combination of both or do neither.
The filter accepts the following named parameters:
@table @option
@item min_comp
Minimum difference between timestamps and audio data (in seconds) to trigger
stretching/squeezing/filling or trimming of the data to make it match the
timestamps. The default is that stretching/squeezing/filling and
trimming is disabled (min_comp = infinite).
@item min_hard_comp
Minimum difference between timestamps and audio data (in seconds) to trigger
adding/dropping samples to make it match the timestamps.
This option effectively is a threshold to select between hard (trim/fill) and
soft (squeeze/stretch) compensation. Note that all compensation is by default
disabled through min_comp.
The default is 0.1 seconds.
@item max_soft_comp
Maximum stretch/squeeze factor.
Default value 0.
@item tsf, internal_sample_fmt
Internal sampling format.
Default is automatic selection
@item clev, center_mix_level
center mix level, for rematrixing
Default is 3.0dB
@item slev, surround_mix_level
surround mix level, for rematrixing
Default is 3.0dB
@item rmvol, rematrix_volume
rematrix volume
Default is 1.0
@item lfe_mix_level
Low frequency effects mix level.
Default is 0
@item matrix_encoding
matrixed stereo encoding
@table @option
@item none
No matrixed stereo encoding
@item dolby
Dolby matrixed stereo encoding
@item dplii
Dolby Pro Logic II matrixed stereo encoding
@end table
Default value is @code{none}.
@end table
The filter accepts the syntax
[@var{sample_rate}:]@var{resampler_options}, where @var{sample_rate}
expresses a sample rate and @var{resampler_options} is a list of
@var{key}=@var{value} pairs, separated by ":". See the
ffmpeg-resampler manual for the complete list of supported options.
For example, to resample the input audio to 44100Hz:
@example