mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 05:40:42 +01:00
0cbb58e046
This is a reland of 87a7b82520
Original change's description:
> Refactoring of the noise suppressor and adding true multichannel support
>
> This CL adds proper multichannel support to the noise suppressor.
> To accomplish that in a safe way, a full refactoring of the noise
> suppressor code has been done.
>
> Due to floating point precision, the changes made are not entirely
> bitexact. They are, however, very close to being bitexact.
>
> As a safety measure, the former noise suppressor code is preserved
> and a kill-switch is added to allow revering to the legacy noise
> suppressor in case issues arise.
>
> Bug: webrtc:10895, b/143344262
> Change-Id: I0b071011b23265ac12e6d4b3956499d122286657
> Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/158407
> Commit-Queue: Per Åhgren <peah@webrtc.org>
> Reviewed-by: Gustaf Ullberg <gustaf@webrtc.org>
> Cr-Commit-Position: refs/heads/master@{#29646}
Bug: webrtc:10895, b/143344262
Change-Id: I236f1e67bb0baa4e30908a4cf7a8a7bb55fbced3
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/158747
Reviewed-by: Gustaf Ullberg <gustaf@webrtc.org>
Commit-Queue: Per Åhgren <peah@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#29663}
112 lines
3.4 KiB
C
112 lines
3.4 KiB
C
/*
|
|
* Copyright (c) 2012 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_LEGACY_NS_NOISE_SUPPRESSION_X_H_
|
|
#define MODULES_AUDIO_PROCESSING_LEGACY_NS_NOISE_SUPPRESSION_X_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
typedef struct NsxHandleT NsxHandle;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* This function creates an instance of the fixed point Noise Suppression.
|
|
*/
|
|
NsxHandle* WebRtcNsx_Create(void);
|
|
|
|
/*
|
|
* This function frees the dynamic memory of a specified Noise Suppression
|
|
* instance.
|
|
*
|
|
* Input:
|
|
* - nsxInst : Pointer to NS instance that should be freed
|
|
*/
|
|
void WebRtcNsx_Free(NsxHandle* nsxInst);
|
|
|
|
/*
|
|
* This function initializes a NS instance
|
|
*
|
|
* Input:
|
|
* - nsxInst : Instance that should be initialized
|
|
* - fs : sampling frequency
|
|
*
|
|
* Output:
|
|
* - nsxInst : Initialized instance
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNsx_Init(NsxHandle* nsxInst, uint32_t fs);
|
|
|
|
/*
|
|
* This changes the aggressiveness of the noise suppression method.
|
|
*
|
|
* Input:
|
|
* - nsxInst : Instance that should be initialized
|
|
* - mode : 0: Mild, 1: Medium , 2: Aggressive
|
|
*
|
|
* Output:
|
|
* - nsxInst : Initialized instance
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNsx_set_policy(NsxHandle* nsxInst, int mode);
|
|
|
|
/*
|
|
* This functions does noise suppression for the inserted speech frame. The
|
|
* input and output signals should always be 10ms (80 or 160 samples).
|
|
*
|
|
* Input
|
|
* - nsxInst : NSx instance. Needs to be initiated before call.
|
|
* - speechFrame : Pointer to speech frame buffer for each band
|
|
* - num_bands : Number of bands
|
|
*
|
|
* Output:
|
|
* - nsxInst : Updated NSx instance
|
|
* - outFrame : Pointer to output frame for each band
|
|
*/
|
|
void WebRtcNsx_Process(NsxHandle* nsxInst,
|
|
const int16_t* const* speechFrame,
|
|
int num_bands,
|
|
int16_t* const* outFrame);
|
|
|
|
/* Returns a pointer to the noise estimate per frequency bin. The number of
|
|
* frequency bins can be provided using WebRtcNsx_num_freq().
|
|
*
|
|
* Input
|
|
* - nsxInst : NSx instance. Needs to be initiated before call.
|
|
* - q_noise : Q value of the noise estimate, which is the number of
|
|
* bits that it needs to be right-shifted to be
|
|
* normalized.
|
|
*
|
|
* Return value : Pointer to the noise estimate per frequency bin.
|
|
* Returns NULL if the input is a NULL pointer or an
|
|
* uninitialized instance.
|
|
*/
|
|
const uint32_t* WebRtcNsx_noise_estimate(const NsxHandle* nsxInst,
|
|
int* q_noise);
|
|
|
|
/* Returns the number of frequency bins, which is the length of the noise
|
|
* estimate for example.
|
|
*
|
|
* Return value : Number of frequency bins.
|
|
*/
|
|
size_t WebRtcNsx_num_freq(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_LEGACY_NS_NOISE_SUPPRESSION_X_H_
|