Surface the noise estimate of the NS to be used by other components

webrtc/modules/audio_processing/ns/noise_suppression.h

 /*
  *  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.
  */
 
@@ skipping 91 matching lines @@
  * 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);
 
+/* Returns a pointer to the noise estimate per frequency bin. The number of
+ * frequency bins can be get using WebRtcNs_num_freq().
+ *
+ * Input
+ *      - handle        : Noise suppression instance.
+ *
+ * Return value         : Pointer to the noise estimate per frequency bin.
+ *                        NULL pointer - NULL pointer or uninitialized instance.

[hlundin-webrtc, 2016/02/08 10:12:32]

"NULL pointer - NULL pointer"?
Suggest: "Returns NULL if the input is a NULL pointer or an uninitialized
instance.

[aluebs-webrtc, 2016/02/09 00:01:43]

Done.

+ */
+const float* WebRtcNs_noise_estimate(NsHandle* handle);
+
+/* Returns the number of frequency bins, which is the length of the noise
+ * estimate for example.
+ *
+ * Return value         : Number of frequency bins.
+ */
+size_t WebRtcNs_num_freq();
+
 #ifdef __cplusplus
 }
 #endif
 
 #endif  // WEBRTC_MODULES_AUDIO_PROCESSING_NS_NOISE_SUPPRESSION_H_