12cd443752
Internally, it already worked on floats. This patch just changes the signature of a bunch of functions so that floats can be passed directly from the new and improved AudioBuffer without converting the data to int and back again first. (The reference data to the ApmTest.Process test had to be modified slightly; this is because the noise suppressor comes immediately after the echo canceller, which also works on floats. If I truncate to integers between the two steps, ApmTest.Process doesn't complain, but of course that's exactly the sort of thing the float conversion is supposed to let us avoid...) BUG= R=aluebs@webrtc.org, bjornv@webrtc.org, tina.legrand@webrtc.org Review URL: https://webrtc-codereview.appspot.com/13519004 git-svn-id: http://webrtc.googlecode.com/svn/trunk@6385 4adac7df-926f-26a2-2b94-8c16560cd09d
124 lines
3.5 KiB
C
124 lines
3.5 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 WEBRTC_MODULES_AUDIO_PROCESSING_NS_INCLUDE_NOISE_SUPPRESSION_H_
|
|
#define WEBRTC_MODULES_AUDIO_PROCESSING_NS_INCLUDE_NOISE_SUPPRESSION_H_
|
|
|
|
#include "webrtc/typedefs.h"
|
|
|
|
typedef struct NsHandleT NsHandle;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* This function creates an instance to the noise suppression structure
|
|
*
|
|
* Input:
|
|
* - NS_inst : Pointer to noise suppression instance that should be
|
|
* created
|
|
*
|
|
* Output:
|
|
* - NS_inst : Pointer to created noise suppression instance
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNs_Create(NsHandle** NS_inst);
|
|
|
|
|
|
/*
|
|
* This function frees the dynamic memory of a specified noise suppression
|
|
* instance.
|
|
*
|
|
* Input:
|
|
* - NS_inst : Pointer to NS instance that should be freed
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNs_Free(NsHandle* NS_inst);
|
|
|
|
|
|
/*
|
|
* This function initializes a NS instance and has to be called before any other
|
|
* processing is made.
|
|
*
|
|
* Input:
|
|
* - NS_inst : Instance that should be initialized
|
|
* - fs : sampling frequency
|
|
*
|
|
* Output:
|
|
* - NS_inst : Initialized instance
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNs_Init(NsHandle* NS_inst, uint32_t fs);
|
|
|
|
/*
|
|
* This changes the aggressiveness of the noise suppression method.
|
|
*
|
|
* Input:
|
|
* - NS_inst : Noise suppression instance.
|
|
* - mode : 0: Mild, 1: Medium , 2: Aggressive
|
|
*
|
|
* Output:
|
|
* - NS_inst : Updated instance.
|
|
*
|
|
* Return value : 0 - Ok
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNs_set_policy(NsHandle* NS_inst, 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
|
|
* - NS_inst : Noise suppression instance.
|
|
* - spframe : Pointer to speech frame buffer for L band
|
|
* - spframe_H : Pointer to speech frame buffer for H band
|
|
* - fs : sampling frequency
|
|
*
|
|
* Output:
|
|
* - NS_inst : Updated NS instance
|
|
* - outframe : Pointer to output frame for L band
|
|
* - outframe_H : Pointer to output frame for H band
|
|
*
|
|
* Return value : 0 - OK
|
|
* -1 - Error
|
|
*/
|
|
int WebRtcNs_Process(NsHandle* NS_inst,
|
|
float* spframe,
|
|
float* spframe_H,
|
|
float* outframe,
|
|
float* outframe_H);
|
|
|
|
/* Returns the internally used prior speech probability of the current frame.
|
|
* There is a frequency bin based one as well, with which this should not be
|
|
* confused.
|
|
*
|
|
* Input
|
|
* - handle : Noise suppression instance.
|
|
*
|
|
* Return value : Prior speech probability in interval [0.0, 1.0].
|
|
* -1 - NULL pointer or uninitialized instance.
|
|
*/
|
|
float WebRtcNs_prior_speech_probability(NsHandle* handle);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // WEBRTC_MODULES_AUDIO_PROCESSING_NS_INCLUDE_NOISE_SUPPRESSION_H_
|