changeset 34713:e5783b2a88f0

af_stats: document the meaning of the output.
author cigaes
date Wed, 07 Mar 2012 09:20:08 +0000
parents 6e0aeeb6cdc4
children 3fff1b2c4c97
files DOCS/man/en/mplayer.1
diffstat 1 files changed, 11 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/man/en/mplayer.1	Mon Mar 05 18:14:38 2012 +0000
+++ b/DOCS/man/en/mplayer.1	Wed Mar 07 09:20:08 2012 +0000
@@ -6105,7 +6105,17 @@
 Collects and prints statistics about the audio stream, especially the volume.
 These statistics are especially intended to help adjusting the volume while
 avoiding clipping.
-The volumes are printed in dB and compatible with the volume audio filter.
+The volumes are printed in dB and compatible with the volume audio filter,
+they are always rounded towards -0dB.
+.sp 1
+The 'n_samples' field is the total number of samples seen by the filter.
+The 'mean_volume' field is the root mean square.
+The 'max_volume' field is exactly what it says.
+The 'histogram_Xdb fields count how many samples were at -XdB, for X just
+below max_volume.
+.sp 1
+For example, if max_volume is -7dB and histogram_7dB is 19, 'volume=7' will
+not cause clipping and 'volume=8' will cause clipping on exactly 19 samples.
 .
 .
 .