andrew@0: /*
andrew@0: 	 Copyright (C) 2003 Paul Brossier
andrew@0: 
andrew@0: 	 This program is free software; you can redistribute it and/or modify
andrew@0: 	 it under the terms of the GNU General Public License as published by
andrew@0: 	 the Free Software Foundation; either version 2 of the License, or
andrew@0: 	 (at your option) any later version.
andrew@0: 
andrew@0: 	 This program is distributed in the hope that it will be useful,
andrew@0: 	 but WITHOUT ANY WARRANTY; without even the implied warranty of
andrew@0: 	 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
andrew@0: 	 GNU General Public License for more details.
andrew@0: 
andrew@0: 	 You should have received a copy of the GNU General Public License
andrew@0: 	 along with this program; if not, write to the Free Software
andrew@0: 	 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
andrew@0: 
andrew@0: */
andrew@0: 
andrew@0: /** \file
andrew@0: 
andrew@0:   Pitch detection using multiple-comb filter
andrew@0: 
andrew@0:   This fundamental frequency estimation algorithm implements spectral
andrew@0:   flattening, multi-comb filtering and peak histogramming. 
andrew@0: 
andrew@0:   This method was designed by Juan P. Bello and described in:
andrew@0: 
andrew@0:   Juan-Pablo Bello. ``Towards the Automated Analysis of Simple Polyphonic
andrew@0:   Music''.  PhD thesis, Centre for Digital Music, Queen Mary University of
andrew@0:   London, London, UK, 2003.
andrew@0: 
andrew@0: */
andrew@0: 
andrew@0: #ifndef PITCHMCOMB_H
andrew@0: #define PITCHMCOMB_H
andrew@0: 
andrew@0: #ifdef __cplusplus
andrew@0: extern "C" {
andrew@0: #endif
andrew@0: 
andrew@0: /** pitch detection object */
andrew@0: typedef struct _aubio_pitchmcomb_t aubio_pitchmcomb_t;
andrew@0: 
andrew@0: /** execute pitch detection on an input spectral frame
andrew@0:  
andrew@0:   \param p pitch detection object as returned by new_aubio_pitchmcomb
andrew@0:   \param fftgrain input signal spectrum as computed by aubio_pvoc_do 
andrew@0:  
andrew@0: */
andrew@0: smpl_t aubio_pitchmcomb_detect(aubio_pitchmcomb_t * p, cvec_t * fftgrain);
andrew@0: /** select the best candidates */
andrew@0: ba_uint_t aubio_pitch_cands(aubio_pitchmcomb_t * p, cvec_t * fftgrain, smpl_t * cands);
andrew@0: /** creation of the pitch detection object
andrew@0:  
andrew@0:   \param bufsize size of the input buffer to analyse 
andrew@0:   \param hopsize step size between two consecutive analysis instant 
andrew@0:   \param channels number of channels to analyse
andrew@0:   \param samplerate sampling rate of the signal 
andrew@0:  
andrew@0: */
andrew@0: aubio_pitchmcomb_t * new_aubio_pitchmcomb(ba_uint_t bufsize, ba_uint_t hopsize, ba_uint_t channels, ba_uint_t samplerate);
andrew@0: /** deletion of the pitch detection object
andrew@0:  
andrew@0:   \param p pitch detection object as returned by new_aubio_pitchfcomb
andrew@0:  
andrew@0: */
andrew@0: void del_aubio_pitchmcomb(aubio_pitchmcomb_t *p);
andrew@0: 
andrew@0: #ifdef __cplusplus
andrew@0: }
andrew@0: #endif
andrew@0: 
andrew@0: #endif/*PITCHMCOMB_H*/