mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 13:50:40 +01:00
5da581b564
Instead of using two different headroom parameters, namely `kHeadroomDbfs` and `kSaturationProtectorExtraHeadroomDb`, only use the former that now also accounts for the deleted one - i.e., it equals the sum of the two headrooms. In this way, tuning AGC2 will be easier. This CL does *not* change the behavior of the AGC2 adaptive digital controller - bitexactness verified with audioproc_f on a collection of AEC dumps and Wav files (42 recordings in total). The unit tests changes in agc2/saturation_protector_unittest.cc are required since `extra_headroom_db` is removed and the changes in agc2/adaptive_digital_gain_applier_unittest.cc are required because `AdaptiveDigitalGainApplier` depends on `kHeadroomDbfs` which has been updated as stated above. Bug: webrtc:7494 Change-Id: I0a2a710bbede0caa53938090a004d185fdefaeb9 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/232905 Reviewed-by: Per Åhgren <peah@webrtc.org> Commit-Queue: Alessio Bazzica <alessiob@webrtc.org> Cr-Commit-Position: refs/heads/main@{#35109}
46 lines
1.5 KiB
C++
46 lines
1.5 KiB
C++
/*
|
|
* Copyright (c) 2018 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef MODULES_AUDIO_PROCESSING_AGC2_SATURATION_PROTECTOR_H_
|
|
#define MODULES_AUDIO_PROCESSING_AGC2_SATURATION_PROTECTOR_H_
|
|
|
|
#include <memory>
|
|
|
|
namespace webrtc {
|
|
class ApmDataDumper;
|
|
|
|
// Saturation protector. Analyzes peak levels and recommends a headroom to
|
|
// reduce the chances of clipping.
|
|
class SaturationProtector {
|
|
public:
|
|
virtual ~SaturationProtector() = default;
|
|
|
|
// Returns the recommended headroom in dB.
|
|
virtual float HeadroomDb() = 0;
|
|
|
|
// Analyzes the peak level of a 10 ms frame along with its speech probability
|
|
// and the current speech level estimate to update the recommended headroom.
|
|
virtual void Analyze(float speech_probability,
|
|
float peak_dbfs,
|
|
float speech_level_dbfs) = 0;
|
|
|
|
// Resets the internal state.
|
|
virtual void Reset() = 0;
|
|
};
|
|
|
|
// Creates a saturation protector that starts at `initial_headroom_db`.
|
|
std::unique_ptr<SaturationProtector> CreateSaturationProtector(
|
|
float initial_headroom_db,
|
|
int adjacent_speech_frames_threshold,
|
|
ApmDataDumper* apm_data_dumper);
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AGC2_SATURATION_PROTECTOR_H_
|