1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
/*
Copyright (C) 2003-2013 Paul Brossier <piem@aubio.org>
This file is part of aubio.
aubio is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
aubio is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with aubio. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef AUBIO_WAVETABLE_H
#define AUBIO_WAVETABLE_H
/** \file
Wavetable synthesis.
This file creates a wavetable and plays it at different frequency.
The `_do` function adds the new samples to the input, and write the result as
the output.
\example synth/test-wavetable.c
*/
#ifdef __cplusplus
extern "C" {
#endif
/** wavetable object */
typedef struct _aubio_wavetable_t aubio_wavetable_t;
/** create new wavetable object
\param samplerate the sampling rate of the new wavetable
\param hop_size the block size of the new wavetable
\return the newly created aubio_wavetable_t
*/
aubio_wavetable_t * new_aubio_wavetable(uint_t samplerate, uint_t hop_size);
/** load source in wavetable
\param o wavetable, created by new_aubio_wavetable()
\param uri the uri of the source to load
\return 0 if successful, non-zero otherwise
*/
uint_t aubio_wavetable_load( aubio_wavetable_t * o, const char_t * uri );
/** process wavetable function
\param o wavetable, created by new_aubio_wavetable()
\param input input of the wavetable, to be added to the output
\param output output of the wavetable
This function adds the new samples from the playing wavetable to the output.
If `input` is not NULL and different from `output`, then the samples from `input`
are added to the output.
*/
void aubio_wavetable_do ( aubio_wavetable_t * o, const fvec_t * input, fvec_t * output);
/** process wavetable function, multiple channels
\param o wavetable, created by new_aubio_wavetable()
\param input input of the wavetable, to be added to the output
\param output output of the wavetable
This function adds the new samples from the playing wavetable to the output.
If `input` is not NULL and different from `output`, then the samples from `input`
are added to the output.
*/
void aubio_wavetable_do_multi ( aubio_wavetable_t * o, const fmat_t * input, fmat_t * output);
/** get current playing state
\param o wavetable, created by new_aubio_wavetable()
\return 0 if not playing, 1 if playing
*/
uint_t aubio_wavetable_get_playing ( const aubio_wavetable_t * o );
/** set current playing state
\param o wavetable, created by new_aubio_wavetable()
\param playing 0 for not playing, 1 for playing
\return 0 if successful, 1 otherwise
*/
uint_t aubio_wavetable_set_playing ( aubio_wavetable_t * o, uint_t playing );
/** play sample from start
\param o wavetable, created by new_aubio_wavetable()
\return 0 if successful, 1 otherwise
*/
uint_t aubio_wavetable_play ( aubio_wavetable_t * o );
/** stop wavetable
\param o wavetable, created by new_aubio_wavetable()
\return 0 if successful, 1 otherwise
*/
uint_t aubio_wavetable_stop ( aubio_wavetable_t * o );
/** set wavetable frequency
\param o wavetable, created by new_aubio_wavetable()
\param freq new frequency value for the wavetable
\return 0 if successful, 1 otherwise
*/
uint_t aubio_wavetable_set_freq ( aubio_wavetable_t * o, smpl_t freq );
/** get wavetable frequency
\param o wavetable, created by new_aubio_wavetable()
\return current frequency, in Hz
*/
smpl_t aubio_wavetable_get_freq ( const aubio_wavetable_t * o);
/** set wavetable amplitude
\param o wavetable, created by new_aubio_wavetable()
\param amp new amplitude value for the wavetable
\return 0 if successful, 1 otherwise
*/
uint_t aubio_wavetable_set_amp ( aubio_wavetable_t * o, smpl_t amp );
/** get wavetable amplitude
\param o wavetable, created by new_aubio_wavetable()
\return current amplitude
*/
smpl_t aubio_wavetable_get_amp ( const aubio_wavetable_t * o);
/** destroy aubio_wavetable_t object
\param o wavetable, created by new_aubio_wavetable()
*/
void del_aubio_wavetable( aubio_wavetable_t * o );
#ifdef __cplusplus
}
#endif
#endif /* AUBIO_WAVETABLE_H */
|
