From f81b6df7d527bfecbaaec26116b137e7e27a1526 Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Fri, 4 Feb 2005 01:34:35 +0000 Subject: [PATCH] minor comments --- src/libFLAC/stream_encoder.c | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/src/libFLAC/stream_encoder.c b/src/libFLAC/stream_encoder.c index 12638402..33debfc0 100644 --- a/src/libFLAC/stream_encoder.c +++ b/src/libFLAC/stream_encoder.c @@ -2956,7 +2956,14 @@ FLAC__bool set_partitioned_rice_( mean >>= 1; } #else - /* calc rice_parameter ala LOCO-I */ + /* we are basically calculating the size in bits of the + * average residual magnitude in the partition: + * rice_parameter = floor(log2(mean/partition_samples)) + * 'mean' is not a good name for the variable, it is + * actually the sum of magnitudes of all residual values + * in the partition, so the actual mean is + * mean/partition_samples + */ for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1) ; #endif @@ -3162,7 +3169,14 @@ FLAC__bool set_partitioned_rice_with_precompute_( mean >>= 1; } #else - /* calc rice_parameter ala LOCO-I */ + /* we are basically calculating the size in bits of the + * average residual magnitude in the partition: + * rice_parameter = floor(log2(mean/partition_samples)) + * 'mean' is not a good name for the variable, it is + * actually the sum of magnitudes of all residual values + * in the partition, so the actual mean is + * mean/partition_samples + */ for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1) ; #endif