RepoMirrors/ffmpeg
1
0
Fork 0
mirror of https://git.ffmpeg.org/ffmpeg.git synced 2024-12-11 09:35:22 +00:00
Code Issues Projects Releases Wiki Activity

doc/filters: update silenceremove documentation

Browse Source
This commit is contained in:
Paul B Mahol 2018-10-15 18:10:16 +02:00
parent 936376f3f7
commit e1e6a31216
1 changed files with 29 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/filters.texi
View File

@ -4343,6 +4343,19 @@ you may wish to increase the value to account for background noise.
Can be specified in dB (in case "dB" is appended to the specified value) Can be specified in dB (in case "dB" is appended to the specified value)
or amplitude ratio. Default value is @code{0}. or amplitude ratio. Default value is @code{0}.
@item start_silence
Specify max duration of silence at beginning that will be kept after
trimming. Default is 0, which is equal to trimming all samples detected
as silence.
@item start_mode
Specify mode of detection of silence end in start of multi-channel audio.
Can be @var{any} or @var{all}. Default is @var{any}.
With @var{any}, any sample that is detected as non-silence will cause
stopped trimming of silence.
With @var{all}, only if all channels are detected as non-silence will cause
stopped trimming of silence.
@item stop_periods @item stop_periods
Set the count for trimming silence from the end of audio. Set the count for trimming silence from the end of audio.
To remove silence from the middle of a file, specify a @var{stop_periods} To remove silence from the middle of a file, specify a @var{stop_periods}
@ -4364,11 +4377,18 @@ the end of audio.
Can be specified in dB (in case "dB" is appended to the specified value) Can be specified in dB (in case "dB" is appended to the specified value)
or amplitude ratio. Default value is @code{0}. or amplitude ratio. Default value is @code{0}.
@item leave_silence @item stop_silence
This indicates that @var{stop_duration} length of audio should be left intact Specify max duration of silence at end that will be kept after
at the beginning of each period of silence. trimming. Default is 0, which is equal to trimming all samples detected
For example, if you want to remove long pauses between words but do not want as silence.
to remove the pauses completely. Default value is @code{0}.
@item stop_mode
Specify mode of detection of silence start in end of multi-channel audio.
Can be @var{any} or @var{all}. Default is @var{any}.
With @var{any}, any sample that is detected as non-silence will cause
stopped trimming of silence.
With @var{all}, only if all channels are detected as non-silence will cause
stopped trimming of silence.
@item detection @item detection
Set how is silence detected. Can be @code{rms} or @code{peak}. Second is faster Set how is silence detected. Can be @code{rms} or @code{peak}. Second is faster
@ -4376,7 +4396,8 @@ and works better with digital silence which is exactly 0.
Default value is @code{rms}. Default value is @code{rms}.
@item window @item window
Set ratio used to calculate size of window for detecting silence. Set duration in number of seconds used to calculate size of window in number
of samples for detecting silence.
Default value is @code{0.02}. Allowed range is from @code{0} to @code{10}. Default value is @code{0.02}. Allowed range is from @code{0} to @code{10}.
@end table @end table
@ -4388,14 +4409,14 @@ The following example shows how this filter can be used to start a recording
that does not contain the delay at the start which usually occurs between that does not contain the delay at the start which usually occurs between
pressing the record button and the start of the performance: pressing the record button and the start of the performance:
@example @example
silenceremove=1:5:0.02 silenceremove=start_periods=1:start_duration=5:start_threshold=0.02
@end example @end example
@item @item
Trim all silence encountered from beginning to end where there is more than 1 Trim all silence encountered from beginning to end where there is more than 1
second of silence in audio: second of silence in audio:
@example @example
silenceremove=0:0:0:-1:1:-90dB silenceremove=stop_periods=-1:stop_duration=1:stop_threshold=-90dB
@end example @end example
@end itemize @end itemize