comparison xtract/xtract_scalar.h @ 205:f6fcf3bec020

Add xtract_midicent() convenience function to convert from frequency to MIDI cent

  * xtract_init_wavelet_f0_state() must be called exactly once prior to calling xtract_wavelet_f0()
  *
  */
 int xtract_wavelet_f0(const double *data, const int N, const void *argv, double *result);
 
+    
+/** \brief Convenience function to convert a frequency in Hertz to a "pitch" value in MIDI cents
+ *
+ * \param *data: not used
+ * \param N: not used
+ * \param *argv: a pointer to a double-precision floating point value representing a frequency in Hertz
+ * \param *result: a pointer to a double-precision floating point value representing a "pitch" in MIDI cents
+ * \return if *argv value causes a *result within the range 0..127, XTRACT_SUCCESS will be returned, otherwise XTRACT_ARGUMENT_ERROR
+ *
+ */
+int xtract_midicent(const double *data, const int N, const void *argv, double *result);
+
+    
 /** \brief Extract the number of non-zero elements in an input vector
  * 
  * \param *data: a pointer to the first element in an array of doubles
  * \param N: the number of elements to be considered
  * \param *argv: not used