source: swig/aubio.i @ 603fca4

feature/autosinkfeature/cnnfeature/cnn_orgfeature/constantqfeature/crepefeature/crepe_orgfeature/pitchshiftfeature/pydocstringsfeature/timestretchfix/ffmpeg5pitchshiftsamplertimestretchyinfft+
Last change on this file since 603fca4 was 205da86, checked in by Paul Brossier <piem@altern.org>, 20 years ago

moved jack and sndfile to aubioext

  • Property mode set to 100644
File size: 16.1 KB
Line 
1%module aubiowrapper
2
3%{
4        #include "aubio.h"
5        #include "aubioext.h"
6%}
7
8#include "aubio.h"
9#include "aubioext.h"
10
11/* type aliases */
12typedef unsigned int uint_t;
13typedef int sint_t;
14typedef float smpl_t;
15
16/* fvec */
17extern fvec_t * new_fvec(uint_t length, uint_t channels);
18extern void del_fvec(fvec_t *s);
19smpl_t fvec_read_sample(fvec_t *s, uint_t channel, uint_t position);
20void fvec_write_sample(fvec_t *s, smpl_t data, uint_t channel, uint_t position);
21smpl_t * fvec_get_channel(fvec_t *s, uint_t channel);
22void fvec_put_channel(fvec_t *s, smpl_t * data, uint_t channel);
23smpl_t ** fvec_get_data(fvec_t *s);
24
25/* another way, passing -c++ option to swig */
26/*
27class fvec_t{
28public:
29    %extend {
30        fvec_t(uint_t length, uint_t channels){
31            return new_fvec(length, channels);
32        }
33        ~fvec_t() {
34            del_fvec(self);
35        }
36        smpl_t get( uint_t channel, uint_t position) {
37            return fvec_read_sample(self,channel,position);
38        }
39        void set( smpl_t data, uint_t channel, uint_t position) {
40            fvec_write_sample(self, data, channel, position);
41        }
42        #smpl_t * fvec_get_channel(fvec_t *s, uint_t channel);
43        #void fvec_put_channel(fvec_t *s, smpl_t * data, uint_t channel);
44    }
45};
46*/
47
48/* cvec */
49extern cvec_t * new_cvec(uint_t length, uint_t channels);
50extern void del_cvec(cvec_t *s);
51
52
53/* sndfile */
54extern aubio_file_t * new_file_ro (const char * inputfile);
55extern aubio_file_t * new_file_wo(aubio_file_t * existingfile, const char * outputname);
56extern void file_info(aubio_file_t * file);
57extern int file_write(aubio_file_t * file, int frames, fvec_t * write);
58extern int file_read(aubio_file_t * file, int frames, fvec_t * read);
59extern int del_file(aubio_file_t * file);
60extern uint_t aubio_file_channels(aubio_file_t * file);
61extern uint_t aubio_file_samplerate(aubio_file_t * file);
62
63/* fft */
64extern void aubio_fft_getnorm(smpl_t * norm, fft_data_t * spectrum, uint_t size);
65extern void aubio_fft_getphas(smpl_t * phase, fft_data_t * spectrum, uint_t size);
66
67/* filter */
68extern aubio_filter_t * new_aubio_filter(uint_t samplerate, uint_t order);
69extern aubio_filter_t * new_aubio_adsgn_filter(uint_t samplerate);
70extern aubio_filter_t * new_aubio_cdsgn_filter(uint_t samplerate);
71extern void aubio_filter_do(aubio_filter_t * b, fvec_t * in);
72extern void aubio_filter_do_outplace(aubio_filter_t * b, fvec_t * in, fvec_t * out);
73extern void aubio_filter_do_filtfilt(aubio_filter_t * b, fvec_t * in, fvec_t * tmp);
74/*extern int del_aubio_filter(aubio_filter_t * b);*/
75
76/* biquad */
77extern aubio_biquad_t * new_aubio_biquad(lsmp_t b1, lsmp_t b2, lsmp_t b3, lsmp_t a2, lsmp_t a3);
78extern void aubio_biquad_do(aubio_biquad_t * b, fvec_t * in);
79extern void aubio_biquad_do_filtfilt(aubio_biquad_t * b, fvec_t * in, fvec_t * tmp);
80/*extern int del_aubio_biquad(aubio_biquad_t * b);*/
81
82/* hist */
83extern aubio_hist_t * new_aubio_hist(smpl_t flow, smpl_t fhig, uint_t nelems, uint_t channels);
84extern void del_aubio_hist(aubio_hist_t *s);
85extern void aubio_hist_do(aubio_hist_t *s, fvec_t * input);
86extern void aubio_hist_do_notnull(aubio_hist_t *s, fvec_t * input);
87extern void aubio_hist_dyn_notnull (aubio_hist_t *s, fvec_t *input);
88
89/* mathutils */
90typedef enum {
91        rectangle,
92        hamming,
93        hanning,
94        hanningz,
95        blackman,
96        blackman_harris,
97        gaussian,
98        welch,
99        parzen
100} window_type_t;
101
102void window(smpl_t *w, uint_t size, window_type_t wintype);
103smpl_t unwrap2pi (smpl_t phase);
104smpl_t vec_mean(fvec_t *s);
105smpl_t vec_max(fvec_t *s);
106smpl_t vec_min(fvec_t *s);
107uint_t vec_min_elem(fvec_t *s);
108uint_t vec_max_elem(fvec_t *s);
109void vec_shift(fvec_t *s);
110smpl_t vec_sum(fvec_t *s);
111smpl_t vec_local_energy(fvec_t * f);
112smpl_t vec_local_hfc(fvec_t * f);
113smpl_t vec_alpha_norm(fvec_t * DF, smpl_t alpha);
114void vec_dc_removal(fvec_t * mag);
115void vec_alpha_normalise(fvec_t * mag, uint_t alpha);
116void vec_add(fvec_t * mag, smpl_t threshold);
117void vec_adapt_thres(fvec_t * vec, fvec_t * tmp, uint_t post, uint_t pre);
118smpl_t vec_moving_thres(fvec_t * vec, fvec_t * tmp, uint_t post, uint_t pre, uint_t pos);
119smpl_t vec_median(fvec_t * input);
120smpl_t vec_quadint(fvec_t * x,uint_t pos);
121smpl_t quadfrac(smpl_t s0, smpl_t s1, smpl_t s2, smpl_t pf);
122uint_t vec_peakpick(fvec_t * input, uint_t pos);
123smpl_t bintomidi(smpl_t bin, smpl_t samplerate, smpl_t fftsize);
124smpl_t bintofreq(smpl_t bin, smpl_t samplerate, smpl_t fftsize);
125smpl_t freqtomidi(smpl_t freq);
126uint_t aubio_silence_detection(fvec_t * ibuf, smpl_t threshold);
127smpl_t aubio_level_detection(fvec_t * ibuf, smpl_t threshold);
128
129/* scale */
130extern aubio_scale_t * new_aubio_scale(smpl_t flow, smpl_t fhig, smpl_t ilow, smpl_t ihig       );
131extern void aubio_scale_set (aubio_scale_t *s, smpl_t ilow, smpl_t ihig, smpl_t olow, smpl_t ohig);
132extern void aubio_scale_do(aubio_scale_t *s, fvec_t * input);
133extern void del_aubio_scale(aubio_scale_t *s);
134
135/* resampling */
136extern aubio_resampler_t * new_aubio_resampler(float ratio, uint_t type);
137extern uint_t aubio_resampler_process(aubio_resampler_t *s, fvec_t * input,  fvec_t * output);
138extern void del_aubio_resampler(aubio_resampler_t *s);
139
140/* onset detection */
141typedef enum { energy, specdiff, hfc, complexdomain, phase } aubio_onsetdetection_type;
142aubio_onsetdetection_t * new_aubio_onsetdetection(aubio_onsetdetection_type type, uint_t size, uint_t channels);
143void aubio_onsetdetection(aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
144void aubio_onsetdetection_free(aubio_onsetdetection_t *o);
145
146/* should these still be exposed ? */
147void aubio_onsetdetection_energy  (aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
148void aubio_onsetdetection_hfc    (aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
149void aubio_onsetdetection_complex (aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
150void aubio_onsetdetection_phase   (aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
151void aubio_onsetdetection_specdiff(aubio_onsetdetection_t *o, cvec_t * fftgrain, fvec_t * onset);
152
153/* pvoc */
154aubio_pvoc_t * new_aubio_pvoc (uint_t win_s, uint_t hop_s, uint_t channels);
155void del_aubio_pvoc(aubio_pvoc_t *pv);
156void aubio_pvoc_do(aubio_pvoc_t *pv, fvec_t *in, cvec_t * fftgrain);
157void aubio_pvoc_rdo(aubio_pvoc_t *pv, cvec_t * fftgrain, fvec_t *out);
158
159/* pitch detection */
160
161/* pitch mcomb */
162aubio_pitchmcomb_t * new_aubio_pitchmcomb(uint_t size, uint_t channels);
163smpl_t aubio_pitchmcomb_detect(aubio_pitchmcomb_t * p, cvec_t * fftgrain);
164uint_t aubio_pitch_cands(aubio_pitchmcomb_t * p, cvec_t * fftgrain, smpl_t * cands);
165
166/* pitch yin */
167void aubio_pitchyin_diff(fvec_t *input, fvec_t *yin);
168void aubio_pitchyin_getcum(fvec_t *yin);
169uint_t aubio_pitchyin_getpitch(fvec_t *yin);
170
171/* peakpicker */
172aubio_pickpeak_t * new_aubio_peakpicker(smpl_t threshold);
173uint_t aubio_peakpick_pimrt(fvec_t * DF, aubio_pickpeak_t * p);
174uint_t aubio_peakpick_pimrt_wt( fvec_t* DF, aubio_pickpeak_t* p, smpl_t* peakval );
175void del_aubio_peakpicker(aubio_pickpeak_t * p);
176
177/* transient/steady state separation */
178aubio_tss_t * new_aubio_tss(smpl_t thrs, smpl_t alfa, smpl_t beta,
179    uint_t size, uint_t overlap,uint_t channels);
180void del_aubio_tss(aubio_tss_t *s);
181void aubio_tss_do(aubio_tss_t *s, cvec_t * input, cvec_t * trans, cvec_t * stead);
182
183
184/* jack */
185#ifdef JACK_SUPPORT
186extern aubio_jack_t * new_aubio_jack (uint_t inchannels, uint_t outchannels, aubio_process_func_t callback);
187typedef int (*aubio_process_func_t)(smpl_t **input, smpl_t **output, int nframes);
188extern uint_t aubio_jack_activate(aubio_jack_t *jack_setup);
189extern void aubio_jack_close(aubio_jack_t *jack_setup);
190#endif
191
192/* midi */
193enum aubio_midi_event_type {
194  /* channel messages */
195  NOTE_OFF = 0x80,
196  NOTE_ON = 0x90,
197  KEY_PRESSURE = 0xa0,
198  CONTROL_CHANGE = 0xb0,
199  PROGRAM_CHANGE = 0xc0,
200  CHANNEL_PRESSURE = 0xd0,
201  PITCH_BEND = 0xe0,
202  /* system exclusive */
203  MIDI_SYSEX = 0xf0,
204  /* system common - never in midi files */
205  MIDI_TIME_CODE = 0xf1,
206  MIDI_SONG_POSITION = 0xf2,
207  MIDI_SONG_SELECT = 0xf3,
208  MIDI_TUNE_REQUEST = 0xf6,
209  MIDI_EOX = 0xf7,
210  /* system real-time - never in midi files */
211  MIDI_SYNC = 0xf8,
212  MIDI_TICK = 0xf9,
213  MIDI_START = 0xfa,
214  MIDI_CONTINUE = 0xfb,
215  MIDI_STOP = 0xfc,
216  MIDI_ACTIVE_SENSING = 0xfe,
217  MIDI_SYSTEM_RESET = 0xff,
218  /* meta event - for midi files only */
219  MIDI_META_EVENT = 0xff
220};
221
222enum aubio_midi_control_change {
223  BANK_SELECT_MSB = 0x00,
224  MODULATION_MSB = 0x01,
225  BREATH_MSB = 0x02,
226  FOOT_MSB = 0x04,
227  PORTAMENTO_TIME_MSB = 0x05,
228  DATA_ENTRY_MSB = 0x06,
229  VOLUME_MSB = 0x07,
230  BALANCE_MSB = 0x08,
231  PAN_MSB = 0x0A,
232  EXPRESSION_MSB = 0x0B,
233  EFFECTS1_MSB = 0x0C,
234  EFFECTS2_MSB = 0x0D,
235  GPC1_MSB = 0x10, /* general purpose controller */
236  GPC2_MSB = 0x11,
237  GPC3_MSB = 0x12,
238  GPC4_MSB = 0x13,
239  BANK_SELECT_LSB = 0x20,
240  MODULATION_WHEEL_LSB = 0x21,
241  BREATH_LSB = 0x22,
242  FOOT_LSB = 0x24,
243  PORTAMENTO_TIME_LSB = 0x25,
244  DATA_ENTRY_LSB = 0x26,
245  VOLUME_LSB = 0x27,
246  BALANCE_LSB = 0x28,
247  PAN_LSB = 0x2A,
248  EXPRESSION_LSB = 0x2B,
249  EFFECTS1_LSB = 0x2C,
250  EFFECTS2_LSB = 0x2D,
251  GPC1_LSB = 0x30,
252  GPC2_LSB = 0x31,
253  GPC3_LSB = 0x32,
254  GPC4_LSB = 0x33,
255  SUSTAIN_SWITCH = 0x40,
256  PORTAMENTO_SWITCH = 0x41,
257  SOSTENUTO_SWITCH = 0x42,
258  SOFT_PEDAL_SWITCH = 0x43,
259  LEGATO_SWITCH = 0x45,
260  HOLD2_SWITCH = 0x45,
261  SOUND_CTRL1 = 0x46,
262  SOUND_CTRL2 = 0x47,
263  SOUND_CTRL3 = 0x48,
264  SOUND_CTRL4 = 0x49,
265  SOUND_CTRL5 = 0x4A,
266  SOUND_CTRL6 = 0x4B,
267  SOUND_CTRL7 = 0x4C,
268  SOUND_CTRL8 = 0x4D,
269  SOUND_CTRL9 = 0x4E,
270  SOUND_CTRL10 = 0x4F,
271  GPC5 = 0x50,
272  GPC6 = 0x51,
273  GPC7 = 0x52,
274  GPC8 = 0x53,
275  PORTAMENTO_CTRL = 0x54,
276  EFFECTS_DEPTH1 = 0x5B,
277  EFFECTS_DEPTH2 = 0x5C,
278  EFFECTS_DEPTH3 = 0x5D,
279  EFFECTS_DEPTH4 = 0x5E,
280  EFFECTS_DEPTH5 = 0x5F,
281  DATA_ENTRY_INCR = 0x60,
282  DATA_ENTRY_DECR = 0x61,
283  NRPN_LSB = 0x62,
284  NRPN_MSB = 0x63,
285  RPN_LSB = 0x64,
286  RPN_MSB = 0x65,
287  ALL_SOUND_OFF = 0x78,
288  ALL_CTRL_OFF = 0x79,
289  LOCAL_CONTROL = 0x7A,
290  ALL_NOTES_OFF = 0x7B,
291  OMNI_OFF = 0x7C,
292  OMNI_ON = 0x7D,
293  POLY_OFF = 0x7E,
294  POLY_ON = 0x7F
295};
296
297enum midi_meta_event {
298  MIDI_COPYRIGHT = 0x02,
299  MIDI_TRACK_NAME = 0x03,
300  MIDI_INST_NAME = 0x04,
301  MIDI_LYRIC = 0x05,
302  MIDI_MARKER = 0x06,
303  MIDI_CUE_POINT = 0x07,
304  MIDI_EOT = 0x2f,
305  MIDI_SET_TEMPO = 0x51,
306  MIDI_SMPTE_OFFSET = 0x54,
307  MIDI_TIME_SIGNATURE = 0x58,
308  MIDI_KEY_SIGNATURE = 0x59,
309  MIDI_SEQUENCER_EVENT = 0x7f
310};
311
312enum aubio_player_status
313{
314  AUBIO_MIDI_PLAYER_READY,
315  AUBIO_MIDI_PLAYER_PLAYING,
316  AUBIO_MIDI_PLAYER_DONE
317};
318
319enum aubio_driver_status
320{
321  AUBIO_MIDI_READY,
322  AUBIO_MIDI_LISTENING,
323  AUBIO_MIDI_DONE
324};
325
326/* midi event */
327aubio_midi_event_t* new_aubio_midi_event(void);
328int del_aubio_midi_event(aubio_midi_event_t* event);
329int aubio_midi_event_set_type(aubio_midi_event_t* evt, int type);
330int aubio_midi_event_get_type(aubio_midi_event_t* evt);
331int aubio_midi_event_set_channel(aubio_midi_event_t* evt, int chan);
332int aubio_midi_event_get_channel(aubio_midi_event_t* evt);
333int aubio_midi_event_get_key(aubio_midi_event_t* evt);
334int aubio_midi_event_set_key(aubio_midi_event_t* evt, int key);
335int aubio_midi_event_get_velocity(aubio_midi_event_t* evt);
336int aubio_midi_event_set_velocity(aubio_midi_event_t* evt, int vel);
337int aubio_midi_event_get_control(aubio_midi_event_t* evt);
338int aubio_midi_event_set_control(aubio_midi_event_t* evt, int ctrl);
339int aubio_midi_event_get_value(aubio_midi_event_t* evt);
340int aubio_midi_event_set_value(aubio_midi_event_t* evt, int val);
341int aubio_midi_event_get_program(aubio_midi_event_t* evt);
342int aubio_midi_event_set_program(aubio_midi_event_t* evt, int val);
343int aubio_midi_event_get_pitch(aubio_midi_event_t* evt);
344int aubio_midi_event_set_pitch(aubio_midi_event_t* evt, int val);
345int aubio_midi_event_length(unsigned char status);
346
347/* midi track */
348aubio_track_t* new_aubio_track(int num);
349int del_aubio_track(aubio_track_t* track);
350int aubio_track_set_name(aubio_track_t* track, char* name);
351char* aubio_track_get_name(aubio_track_t* track);
352int aubio_track_add_event(aubio_track_t* track, aubio_midi_event_t* evt);
353aubio_midi_event_t* aubio_track_first_event(aubio_track_t* track);
354aubio_midi_event_t* aubio_track_next_event(aubio_track_t* track);
355int aubio_track_get_duration(aubio_track_t* track);
356int aubio_track_reset(aubio_track_t* track);
357int aubio_track_count_events(aubio_track_t* track, int* on, int* off);
358
359/* midi player */
360aubio_midi_player_t* new_aubio_midi_player(void);
361sint_t del_aubio_midi_player(aubio_midi_player_t* player);
362sint_t aubio_midi_player_reset(aubio_midi_player_t* player);
363sint_t aubio_midi_player_add_track(aubio_midi_player_t* player, aubio_track_t* track);
364sint_t aubio_midi_player_count_tracks(aubio_midi_player_t* player);
365aubio_track_t* aubio_midi_player_get_track(aubio_midi_player_t* player, sint_t i);
366sint_t aubio_midi_player_add(aubio_midi_player_t* player, char* midifile);
367sint_t aubio_midi_player_load(aubio_midi_player_t* player, char *filename);
368sint_t aubio_midi_player_callback(void* data, uint_t msec);
369sint_t aubio_midi_player_play(aubio_midi_player_t* player);
370sint_t aubio_midi_player_play_offline(aubio_midi_player_t* player);
371sint_t aubio_midi_player_stop(aubio_midi_player_t* player);
372sint_t aubio_midi_player_set_loop(aubio_midi_player_t* player, sint_t loop);
373sint_t aubio_midi_player_set_midi_tempo(aubio_midi_player_t* player, sint_t tempo);
374sint_t aubio_midi_player_set_bpm(aubio_midi_player_t* player, sint_t bpm);
375sint_t aubio_midi_player_join(aubio_midi_player_t* player);
376sint_t aubio_track_send_events(aubio_track_t* track,
377/*  aubio_synth_t* synth, */
378                           aubio_midi_player_t* player,
379                           uint_t ticks);
380sint_t aubio_midi_send_event(aubio_midi_player_t* player, aubio_midi_event_t* event);
381
382/* midi parser */
383aubio_midi_parser_t* new_aubio_midi_parser(void);
384int del_aubio_midi_parser(aubio_midi_parser_t* parser);
385aubio_midi_event_t* aubio_midi_parser_parse(aubio_midi_parser_t* parser, unsigned char c);
386
387/* midi file */
388aubio_midi_file_t* new_aubio_midi_file(char* filename);
389void del_aubio_midi_file(aubio_midi_file_t* mf);
390int aubio_midi_file_read_mthd(aubio_midi_file_t* midifile);
391int aubio_midi_file_load_tracks(aubio_midi_file_t* midifile, aubio_midi_player_t* player);
392int aubio_midi_file_read_track(aubio_midi_file_t* mf, aubio_midi_player_t* player, int num);
393int aubio_midi_file_read_event(aubio_midi_file_t* mf, aubio_track_t* track);
394int aubio_midi_file_read_varlen(aubio_midi_file_t* mf);
395int aubio_midi_file_getc(aubio_midi_file_t* mf);
396int aubio_midi_file_push(aubio_midi_file_t* mf, int c);
397int aubio_midi_file_read(aubio_midi_file_t* mf, void* buf, int len);
398int aubio_midi_file_skip(aubio_midi_file_t* mf, int len);
399int aubio_midi_file_read_tracklen(aubio_midi_file_t* mf);
400int aubio_midi_file_eot(aubio_midi_file_t* mf);
401int aubio_midi_file_get_division(aubio_midi_file_t* midifile);
402
403
404/* midi driver */
405aubio_midi_driver_t* new_aubio_midi_driver(char * name,
406        handle_midi_event_func_t handler, void* event_handler_data);
407typedef int* (handle_midi_event_func_t) (void* data, aubio_midi_event_t* event);
408void del_aubio_midi_driver(aubio_midi_driver_t* driver);
409void aubio_midi_driver_settings(aubio_settings_t* settings);
410
411/* timer */
412/*
413extern aubio_timer_t* new_aubio_timer(int msec, int * callback,
414                        void* data, int new_thread, int auto_destroy);
415extern int aubio_timer_join(aubio_timer_t* timer);
416extern int aubio_timer_stop(aubio_timer_t* timer);
417extern int delete_aubio_timer(aubio_timer_t* timer);
418extern void * aubio_timer_start(void * data);
419extern void aubio_time_config(void);
420*/
421
422/* list */
423/*
424extern struct aubio_list_t* new_aubio_list(void);
425extern void del_aubio_list(struct aubio_list_t *list);
426extern void del_aubio_list1(struct aubio_list_t *list);
427#extern struct aubio_list_t* aubio_list_sort(struct aubio_list_t *list, aubio_compare_func_t compare_func);
428extern struct aubio_list_t* aubio_list_append(struct aubio_list_t *list, void* data);
429extern struct aubio_list_t* aubio_list_prepend(struct aubio_list_t *list, void* data);
430extern struct aubio_list_t* aubio_list_remove(struct aubio_list_t *list, void* data);
431extern struct aubio_list_t* aubio_list_remove_link(struct aubio_list_t *list, struct aubio_list_t *llink);
432extern struct aubio_list_t* aubio_list_nth(struct aubio_list_t *list, int n);
433extern struct aubio_list_t* aubio_list_last(struct aubio_list_t *list);
434extern struct aubio_list_t* aubio_list_insert_at(struct aubio_list_t *list, int n, void* data);
435*/
Note: See TracBrowser for help on using the repository browser.