From: Paul Brossier <piem@piem.org>
Date: Sat, 17 Nov 2018 14:02:00 +0000 (+0100)
Subject: [mfcc] add scale documentation
X-Git-Tag: 0.4.8~31^2~6
X-Git-Url: https://git.aubio.org/?a=commitdiff_plain;h=11c899b67262a955fa802b6bc74568375feff82a;p=aubio.git

[mfcc] add scale documentation
---

diff --git a/src/spectral/mfcc.h b/src/spectral/mfcc.h
index 830ba785..5326b26a 100644
--- a/src/spectral/mfcc.h
+++ b/src/spectral/mfcc.h
@@ -94,7 +94,23 @@ uint_t aubio_mfcc_set_power (aubio_mfcc_t *mf, smpl_t power);
  */
 uint_t aubio_mfcc_get_power (aubio_mfcc_t *mf);
 
+/** set scaling parameter
+
+  \param mf mfcc object, as returned by new_aubio_mfcc()
+  \param scale Scaling value to apply.
+
+  Scales the output of the filterbank after taking its logarithm and before
+  computing the DCT. Defaults to `1`.
+
+*/
 uint_t aubio_mfcc_set_scale (aubio_mfcc_t *mf, smpl_t scale);
+
+/** get scaling parameter
+
+  \param mf mfcc object, as returned by new_aubio_mfcc()
+  \return current scaling parameter. Defaults to `1`.
+
+ */
 uint_t aubio_mfcc_get_scale (aubio_mfcc_t *mf);
 
 /** Mel filterbank initialization