mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 14:20:45 +01:00

The extra saturation margin is a setting for the SaturationProtector in GainController2. The higher it is, the less gain GC2 will apply. In this CL we pipe the setting up to audio_processing.h. Now the setting can be set at a high level. Also in this CL add a few (missing, they should have been there already) tests for the GC2 and GC2 with saturation margin. Bug: webrtc:7494 Change-Id: I1b61f1662e6c6a8817fd5b0e845339694bf8d50d Reviewed-on: https://webrtc-review.googlesource.com/c/109001 Reviewed-by: Sam Zackrisson <saza@webrtc.org> Commit-Queue: Alex Loiko <aleloi@webrtc.org> Cr-Commit-Position: refs/heads/master@{#25470}
71 lines
2 KiB
C++
71 lines
2 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 <array>
|
|
|
|
#include "modules/audio_processing/agc2/agc2_common.h"
|
|
#include "modules/audio_processing/agc2/vad_with_level.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class ApmDataDumper;
|
|
|
|
class SaturationProtector {
|
|
public:
|
|
explicit SaturationProtector(ApmDataDumper* apm_data_dumper);
|
|
|
|
SaturationProtector(ApmDataDumper* apm_data_dumper,
|
|
float extra_saturation_margin_db);
|
|
|
|
// Update and return margin estimate. This method should be called
|
|
// whenever a frame is reliably classified as 'speech'.
|
|
//
|
|
// Returned value is in DB scale.
|
|
void UpdateMargin(const VadWithLevel::LevelAndProbability& vad_data,
|
|
float last_speech_level_estimate_dbfs);
|
|
|
|
// Returns latest computed margin. Used in cases when speech is not
|
|
// detected.
|
|
float LastMargin() const;
|
|
|
|
// Resets the internal memory.
|
|
void Reset();
|
|
|
|
void DebugDumpEstimate() const;
|
|
|
|
private:
|
|
// Computes a delayed envelope of peaks.
|
|
class PeakEnveloper {
|
|
public:
|
|
PeakEnveloper();
|
|
void Process(float frame_peak_dbfs);
|
|
|
|
float Query() const;
|
|
|
|
private:
|
|
size_t speech_time_in_estimate_ms_ = 0;
|
|
float current_superframe_peak_dbfs_ = -90.f;
|
|
size_t elements_in_buffer_ = 0;
|
|
std::array<float, kPeakEnveloperBufferSize> peak_delay_buffer_ = {};
|
|
};
|
|
|
|
ApmDataDumper* apm_data_dumper_;
|
|
|
|
float last_margin_;
|
|
PeakEnveloper peak_enveloper_;
|
|
const float extra_saturation_margin_db_;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AGC2_SATURATION_PROTECTOR_H_
|