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
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
Copyright (C) 2004-2010 by Predrag Viceic
viceic@net2000.ch
This program 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 2 of the License, or
(at your option) any later version.
This program 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 this program; if not, write to the
Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
----------------------------------------------------------------------------------------------
INSTALLATION:
*In order to generate makefiles and compile you should execute
qmake freecycle.pro
make
in the freecycle dir.
* FOR CONDITIONAL COMPILES PLEASE EDIT src/cond.pri
The easiest way to compile Freecycle (which is a Qt3 app) in an environment which contains both qt3 and qt4 (OpenSuSE 10.2 comes to mind as an example..) you should:
* export PATH=/usr/lib/qt3/bin/:$PATH
* export QTDIR=/usr/lib/qt3/
* make clean
* rm src/Makefile
* rm Makefile
* qmake
* make
----------------------------------------------------------------------------------------------
MANUAL:
The manual is available as download at the savannah repository. It's a result of the effort of one person, Mat (@podulator.com), who is the most fervent alpha tester and idea contributor of this project.
----------------------------------------------------------------------------------------------
COMMAND LINE SWITCHES
--ueber : Launches Freecycle with UeberStyle (not actively maintained)
----------------------------------------------------------------------------------------------
KNOWN BUGS:
* Many, but works pretty well with small waves (~30 sec)
* >1 LASPA audio outputs can not be routed to the same audio channel
* if timestretch segfaults, try unlocking all locked beatlines.
* don't timestretch if you don't have to.
----------------------------------------------------------------------------------------------
ISSUES:
Mandrake10 users which experience compile problems with ueberstyle.cpp should either:
a) activate QMotifStyle support in their qt install
or
b) disable Ueberstyle in Freecycle by removing it in main.cpp and src.pro
----------------------------------------------------------------------------------------------
FAQ:
Q: Could You tell me what is this popup menu with this kind of time signatures
for? How to use it.
A: When the sound signal gets analysed, the bpm computation starts based on
beatline positions. If there are at least 4 locked beatlines, only the locked
beatlines serve as the basis for the bpm computation, If there are less than
4 beatlines locked, the unlocked (green) beatlines are used. The value
obtained is then multiplied by the values in the combo. That gives you the
possibilitiy to change the detected 75BPM to i.e. 150 BPM. The computed value
is then used for:
a) Time stretching
b) measure marker computation (the bar between two loop points, when dragged)
c) bpm lines computation (activated by the clock icon and at least one locked
beatline)
c) midi file generation
Q: I would like to know what is the purpose of the clock button and why and
when it becomes "active"
A: This icon gets enabled when there is at least one locked beatline. It draws
what I call the bpmlines, i.e. the measures based on the BPM and synchronised
with the first locked beatline.
Q: I guess that the time stretch amount is in percent, but why is the initial
value 30 and not 100?
A: it is the BPM and not the percent.
Q: Does the beatlines and loop markers affect the bpm?
A: Beatlines are the basis for the BPM computation. Loop markers doesn't
affect the BPM.
Q: How does the "time signature" pop up menu affect the bpm?
A:The detected bpm value is multiplied by the value in the combo.
i.e. 150BPM x 1/2 =75BPM
Q: Is it possible to stretch one beat in a whole loop?
A: For now, time stretching works on the whole sound file.
Q: What are the different analisys methods best for?
A: Well that's a short question with a huge answer. :)
The first (default) algorithm (time domain) detects beats by comparing the
instant energy (nb of samples configured as instant energy buffer size in
Configuration->Configure Amplitude Domain) with the average energy (nb of
samples configured as avergage energy buffer size in Configuration->Configure
Amplitude Domain). If the difference exceeds some treshold computed internaly
and based on the variance of the signal, then the beatline is put at that
position (well it's a little bit more complicated because Freecycle then does
zero-crossing, but you should have got the point..)
The second algorithm (frequency domain) does the same thing but the signal is
splitted in multiple bands and the algorithms compare the instant energy of
each frequency band with the average energy of that band. That gives you the
positibility to beatmatch the signal with continuous amplitude but varying
frequency (flute playing legato notes). Configuration->Configure FFT->
Beatmatching FFT gives you the parameters for this algorithm. Window is
equivalent to the [instant energy buffer size]. Average energy is hardcoded
as 44032 frames.
If you want to know more about the above two algorithms please read the
following [http://www.yov408.com/beat/BeatDetectionAlgorithms.pdf] as it
served as the basis for these two algorithms.
The aubio algorithms are well known among DSP experts, which I'm not. Please
search on the web if you want some precisions about those. Feel free to post
your findings on freecycle-users :)
Q: What is the fft configuration and configure amplitude domain menus for and
how to set it for the best (depending on cpu and memory) program performance?
A: Generaly speaking slower->better and faster->less precise. Experiment! The
default values are ok on a 2Ghz CPU and 1Gb RAM. But this depends on the
size of your soundfile, so if you keep those relatively small it should be ok
even on less recent computers.
You can see the effect of fft configuration parameters in the spectrogram view
(View->Spectrum). Spectrogram FFT parameters are used for drawing the
spectrum. If you link those parameters to the Beatmnatching FFT, you cans see
what the Frequency domain analysis algorithm "sees".
----------------------------------------------------------------------------------------------
Enjoy,
Predrag Viceic
In case of cat ..
export PATH=/usr/lib/qt3/bin/:$PATH
export QTDIR=/usr/lib/qt3/
make clean
rm src/Makefile
rm Makefile
qmake
make
|
