ffmpeg | branch: master | Gyan Doshi <ffm...@gyani.pro> | Mon Jan 20 17:42:11 
2020 +0530| [38081acc01a0e62d05cdb474dd3834a2eae36aa7] | committer: Gyan Doshi

doc/filters: clarify resampling and linear mode in loudnorm

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=38081acc01a0e62d05cdb474dd3834a2eae36aa7
---

 doc/filters.texi | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 05739c7c6c..d69987c9f4 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -4223,8 +4223,8 @@ If the specified value is not valid, it is ignored and 
prior one is kept.
 
 EBU R128 loudness normalization. Includes both dynamic and linear 
normalization modes.
 Support for both single pass (livestreams, files) and double pass (files) 
modes.
-This algorithm can target IL, LRA, and maximum true peak. To accurately detect 
true peaks,
-the audio stream will be upsampled to 192 kHz unless the normalization mode is 
linear.
+This algorithm can target IL, LRA, and maximum true peak. In dynamic mode, to 
accurately
+detect true peaks, the audio stream will be upsampled to 192 kHz.
 Use the @code{-ar} option or @code{aresample} filter to explicitly set an 
output sample rate.
 
 The filter accepts the following options:
@@ -4263,10 +4263,13 @@ Set offset gain. Gain is applied before the true-peak 
limiter.
 Range is  -99.0 - +99.0. Default is +0.0.
 
 @item linear
-Normalize linearly if possible.
-measured_I, measured_LRA, measured_TP, and measured_thresh must also
-to be specified in order to use this mode.
-Options are true or false. Default is true.
+Normalize by linearly scaling the source audio.
+@code{measured_I}, @code{measured_LRA}, @code{measured_TP},
+and @code{measured_thresh} must all be specified. Target LRA shouldn't
+be lower than source LRA and the change in integrated loudness shouldn't
+result in a true peak which exceeds the target TP. If any of these
+conditions aren't met, normalization mode will revert to @var{dynamic}.
+Options are @code{true} or @code{false}. Default is @code{true}.
 
 @item dual_mono
 Treat mono input files as "dual-mono". If a mono file is intended for playback

_______________________________________________
ffmpeg-cvslog mailing list
ffmpeg-cvslog@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-cvslog

To unsubscribe, visit link above, or email
ffmpeg-cvslog-requ...@ffmpeg.org with subject "unsubscribe".

Reply via email to