diff xtract/libxtract.h @ 98:ca40a0dc29d6

Removed fftw_plan from xtraction functions. Created new init function xtract_init_fft() for creating plans, which have global scope. Updated examples to reflect the change. New configure option: --with-fft_optimisation (0 = FFTW_ESTIMATE, 1 = FFTW_MEASURE, 2 = FFTW_PATIENT).

--- a/xtract/libxtract.h	Thu Oct 04 14:29:30 2007 +0000
+++ b/xtract/libxtract.h	Sat Oct 06 16:36:00 2007 +0000
@@ -261,7 +261,7 @@
  *                                                                          
  * \param N: the number of elements to be processed          
  *                                                                          
- * \param *argv: an abitrary number of additional arguments, used to pass additional parameters to the function being called
+ * \param *argv: an abitrary number of additional arguments, used to pass additional parameters to the function being called. All arguments are compulsary!
  *                                                                          
  * \param *result: a pointer to the first element in the result                              
  *                                                                          
@@ -326,6 +326,17 @@
  */
 int xtract_init_bark(int N, float sr, int *band_limits);
 
+/** \brief An initialisation function for functions using FFT
+ *
+ * This function initialises global data structures used by functions requiring FFT functionality. It can be called multiple times with different feature names. Calling it more than once with the same feature name is not a valid operation and will result in a memory leak.
+ *
+ * \param N: the size of the FFT
+ * \param feature_name: the name of the feature the FFT is being used for, 
+ * e.g. XTRACT_DCT
+ *
+ */
+int xtract_init_fft(int N, int feature_name);
+
 /* \brief A function to build an array of function descriptors */
 void *xtract_make_descriptors();