Rename def_limiter_max_true_peak to def_limiter_default_threshold

code/include/IAMF_decoder.h

@@ -321,6 +321,10 @@ int IAMF_decoder_peak_limiter_enable(IAMF_DecoderHandle handle,
 
 /**
  * @brief     Set peak threshold value of peak limiter.
+ *
+ * The peak limiter is enabled by default with a threshold of -1.0 dBFS. Use
+ * this function to override the default threshold value.
+ *
  * @param     [in] handle : iamf decoder handle.
  * @param     [in] db : peak threshold in dB.
  * @return    @ref IAErrCode.

code/src/iamf_dec/iamf_decoder.c

@@ -765,7 +765,7 @@ IAMF_DecoderHandle IAMF_decoder_open(void) {
     ctx->sampling_rate = def_default_sampling_rate;
     ctx->mix_presentation_id = def_i64_id_none;
     ctx->normalized_loudness_lkfs = def_default_loudness_lkfs;
-    ctx->limiter_threshold_db = def_limiter_max_true_peak;
+    ctx->limiter_threshold_db = def_limiter_default_threshold;
     ctx->enable_limiter = 1;
 
     ctx->head_rotation = def_quaternion_instance(1.0, 0.0, 0.0, 0.0);
@@ -1047,7 +1047,7 @@ int IAMF_decoder_peak_limiter_set_threshold(IAMF_DecoderHandle handle,
 
 float IAMF_decoder_peak_limiter_get_threshold(IAMF_DecoderHandle handle) {
   iamf_decoder_t *self = (iamf_decoder_t *)handle;
-  if (!self) return def_limiter_max_true_peak;
+  if (!self) return def_limiter_default_threshold;
   return self->ctx.limiter_threshold_db;
 }
 

code/src/iamf_dec/iamf_post_processor.c

@@ -29,7 +29,6 @@
 
 #define def_default_speex_resampler_quality 4
 
-#define def_limiter_maximum_true_peak -1.0f
 #define def_limiter_attack_sec 0.001f
 #define def_limiter_release_sec 0.200f
 #define def_limiter_look_ahead_sec 0.005f

code/src/iamf_dec/iamf_private_definitions.h

@@ -39,7 +39,7 @@
 #define def_audio_sample_format_default 0x10
 #define def_default_sampling_rate 48000
 
-#define def_limiter_max_true_peak -1.0f
+#define def_limiter_default_threshold -1.0f
 #define def_default_loudness_lkfs 0.0f
 
 #define def_i32_id_none (-1)