comparison xtract/xtract_scalar.h @ 48:8703c202a247

Added xtract_slope()
author Jamie Bullock <jamie@postlude.co.uk>
date Thu, 21 Dec 2006 12:06:44 +0000
parents c20e91e86f08
children 4e931b464278
comparison
equal deleted inserted replaced
47:c20e91e86f08 48:8703c202a247
168 * \param *argv: a pointer to an array containing a floating point value representing the threshold for rolloff, i.e. the percentile at which the rolloff is determined, expressed in the range 0-1.0, and a float representing the sample rate in Hz 168 * \param *argv: a pointer to an array containing a floating point value representing the threshold for rolloff, i.e. the percentile at which the rolloff is determined, expressed in the range 0-1.0, and a float representing the sample rate in Hz
169 * \param *result: the spectral rolloff in Hz of N values from the array pointed to by *data. This is the point in the spectrum below which argv[0] of the energy is distributed. 169 * \param *result: the spectral rolloff in Hz of N values from the array pointed to by *data. This is the point in the spectrum below which argv[0] of the energy is distributed.
170 */ 170 */
171 int xtract_rolloff(const float *data, const int N, const void *argv, float *result); 171 int xtract_rolloff(const float *data, const int N, const void *argv, float *result);
172 172
173 /* Loudness */
174 /* A set of BARK_BANDS bark coefficients must be passed in, the loudness is calculated approximately according to Moore, Glasberg et al, 1997 */
175
176 /** \brief Extract the 'total loudness' of an input vector using a method described by Moore, Glasberg et al (2005) 173 /** \brief Extract the 'total loudness' of an input vector using a method described by Moore, Glasberg et al (2005)
177 * 174 *
178 * \param *data: a pointer to the first element in an array of floats representing a set of BARK_BANDS bark coefficients 175 * \param *data: a pointer to the first element in an array of floats representing a set of BARK_BANDS bark coefficients
179 * \param N: the number of coefficients to be considered 176 * \param N: the number of coefficients to be considered
180 * \param *argv: a pointer to NULL 177 * \param *argv: a pointer to NULL
267 * \param *argv: a pointer to NULL 264 * \param *argv: a pointer to NULL
268 * \param *result: the Sharpness of N values from the array pointed to by *data 265 * \param *result: the Sharpness of N values from the array pointed to by *data
269 */ 266 */
270 int xtract_sharpness(const float *data, const int N, const void *argv, float *result); 267 int xtract_sharpness(const float *data, const int N, const void *argv, float *result);
271 268
272 /** \brief Extract the Slope of an input vector 269 /** \brief Extract the Slope of an input vector using a method described by Peeters(2003)
273 * 270 *
274 * \param *data: a pointer to the first element in an array of floats representing the magnitude spectrum of an audio vector
275 * \param *data: a pointer to the first element in an array of floats representing the magnitude coefficients from the magnitude spectrum of an audio vector, (e.g. the second half of the array pointed to by *result from xtract_magnitude_spectrum(). 271 * \param *data: a pointer to the first element in an array of floats representing the magnitude coefficients from the magnitude spectrum of an audio vector, (e.g. the second half of the array pointed to by *result from xtract_magnitude_spectrum().
276 * \param N: the number of elements to be considered 272 * \param N: the number of elements to be considered
277 * \param *argv: a pointer to NULL 273 * \param *argv: a pointer to NULL
278 * \param *result: the Slope of N values from the array pointed to by *data 274 * \param *result: the Slope of N values from the array pointed to by *data
279 */ 275 */