Added libraries and README

README.md

@@ -0,0 +1,44 @@
+# BSc Music Computing Final Year Project
+Final year project: Beat-detecting Reverse Metronome application (JUCE)
+
+## Build / Download Instructions
+### Build
+ Launch the Projucer file and build the application in your chosen IDE
+### Release
+ Navigate to the Releases page to download binaries of the standalone and/or plugin application
+
+
+## Dependencies
+### BTrack
+
+The beat-tracking processing in this project is performed by BTrack and its related classes. These are included in the repository, and their original source can be found here:
+https://github.com/adamstark/BTrack
+
+### libsamplerate
+
+BTrack requires libsamplerate (aka Simple Rabbit Code) to be present in your Header Search Paths, in order to perform sample rate conversions necessary for the beat-tracking: http://www.mega-nerd.com/SRC/
+
+### Kiss FFT / FFTW
+
+BTrack requires EITHER the Kiss FFT (add flag -DUSE_KISS_FFT) or FFTW (add flag -DUSE_FFTW)  libraryto be present in your Header Search Path, for the purpose of FFT processing.
+Kiss FFT is included in this repository.
+
+- Kiss FFT: https://github.com/mborgerding/kissfft
+
+- FFTW: http://fftw.org/
+
+## Instructions
+
+This application is designed to provide a real-time visual indicator representing the BPM of the incoming audio signal.
+As such, it is aimed at drummers/percussionists/any percussive noisemakers to practice and analyse their timing.
+
+After launching the application as standalone or as a plugin within your DAW of choice:
+1) Check that the application is receiving audio. In standalone version, this can be done by clicking the Options menu and selecting the desired audio input. If running the plugin, check the audio configurations in your DAW.
+2) To initiate the beat-tracker, click "Run Tempo-Tracker and Set Target BPM". The software will begin to calculate the tempo of the incoming audio signal.
+3) After ten seconds, a target tempo will be assumed, and a moving meter will appear which represents the currently deduced BPM value.
+
+- To reset the Target BPM value to the current BPM, click "Reset Target to Current BPM"
+- If the calculated BPM is out of the range of the meter, the visual indicator will turn red
+
+
+

Source/MeterComponent.cpp

@@ -28,6 +28,8 @@ MeterComponent::MeterComponent(BpmometerAudioProcessor& p) : processor(p)
 
     indicatorSlider.setSliderStyle (Slider::SliderStyle::Rotary);
 
+    //turn off mouse response
+    indicatorSlider.setInterceptsMouseClicks (false, false);
 
 altLookAndFeel.setEllipseColour( juce::Colours::mediumpurple );
 
@@ -208,18 +210,18 @@ void MeterComponent::resized()
         indicatorSlider.setBounds(bounds.removeFromBottom(1000));
 
 
-//    auto bounds2 = getLocalBounds();
-//
-//    FlexBox flexbox { FlexBox::Direction::row, FlexBox::Wrap::noWrap, FlexBox::AlignContent::center, FlexBox::AlignItems::center, FlexBox::JustifyContent::center};
-//
-//    flexbox.items.add (FlexItem(200,75, launchLaterButton) );
-//    flexbox.items.add (FlexItem(200,75, launchNowButton) );
-//
-//    flexbox.performLayout(bounds2.removeFromBottom(200) );
+    auto bounds2 = getLocalBounds();
 
-    launchLaterButton.setBounds (50,100,150,75);
+    FlexBox flexbox { FlexBox::Direction::row, FlexBox::Wrap::noWrap, FlexBox::AlignContent::center, FlexBox::AlignItems::center, FlexBox::JustifyContent::center};
+
+    flexbox.items.add (FlexItem(200,75, launchLaterButton) );
+    flexbox.items.add (FlexItem(200,75, launchNowButton) );
+
+    flexbox.performLayout(bounds2.removeFromBottom(350) );
+
+    //launchLaterButton.setBounds (50,100,150,75);
 
-    launchNowButton.setBounds (getWidth()-200, 100, 150,75);
+    //launchNowButton.setBounds (getWidth()-200, 100, 150,75);
 
 
 

Source/MeterComponent.h

@@ -28,7 +28,9 @@ class AltLookAndFeel : public juce::LookAndFeel_V4
     void drawRotarySlider (Graphics& g, int x, int y, int width, int height, float sliderPos,
                       const float rotaryStartAngle, const float rotaryEndAngle, Slider& slider) override
     {
-        auto outline = slider.findColour (Slider::rotarySliderOutlineColourId);
+//        auto outline = slider.findColour (Slider::rotarySliderOutlineColourId);
+
+        auto outline = Colours::lightgrey;
         //auto fill    = slider.findColour (Slider::rotarySliderFillColourId);
 
         auto fill = Colours::lightgrey;
@@ -51,7 +53,7 @@ class AltLookAndFeel : public juce::LookAndFeel_V4
                                      true);
 
         g.setColour (outline);
-        g.strokePath (backgroundArc, PathStrokeType (lineW, PathStrokeType::curved, PathStrokeType::rounded));
+        g.strokePath (backgroundArc, PathStrokeType (lineW, PathStrokeType::curved, PathStrokeType::square));
 
         if (slider.isEnabled())
         {

Source/PluginProcessor.cpp

@@ -23,9 +23,7 @@ BpmometerAudioProcessor::BpmometerAudioProcessor()
                       #endif
                        .withOutput ("Output", AudioChannelSet::stereo(), true)
                      #endif
-                       ),
-mAPVTS(*this, nullptr, "PARAMETERS",
-       createParameterLayout() )
+                       )
 #endif
 {
 }
@@ -36,28 +34,7 @@ BpmometerAudioProcessor::~BpmometerAudioProcessor()
 
 //==============================================================================
 
-AudioProcessorValueTreeState::ParameterLayout BpmometerAudioProcessor::createParameterLayout()
-{
-    //Create parameterlayout gets used as an argument for treeState at the top of this file (scroll up)
-
-
-    // Making a vector of audioParameter unique pointers:
-    std::vector <std::unique_ptr <RangedAudioParameter> > params;
-
-//    auto launchLaterButtonParam = std::make_unique<AudioParameterBool> (LAUNCH_LATER_ID,
-//                                                                  LAUNCH_LATER_NAME,
-//                                                                  false);
-
-    auto launchNowButtonParam = std::make_unique<AudioParameterBool> (LAUNCH_NOW_ID,
-                                                                        LAUNCH_NOW_NAME,
-                                                                        false);
-
-    //params.push_back (std::move (launchLaterButtonParam));
-    params.push_back (std::move (launchNowButtonParam));
-
-    return { params.begin(), params.end() };
-
-}
+
 
 
 //==============================================================================

Source/PluginProcessor.h

@@ -74,9 +74,9 @@ class BpmometerAudioProcessor  : public AudioProcessor
 
     double getTimeGrab();
 
-    AudioProcessorValueTreeState& getAPVTS() {return mAPVTS;};
 
-    void testButton();
+
+    void runStateChanged();
 
 
 
@@ -128,9 +128,9 @@ class BpmometerAudioProcessor  : public AudioProcessor
 
     //=============================
 
-    AudioProcessorValueTreeState mAPVTS;
 
-    AudioProcessorValueTreeState::ParameterLayout createParameterLayout();
+
+
     //==============================================================================
     JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (BpmometerAudioProcessor)
 };

libs/kiss_fft130/COPYING

@@ -0,0 +1,11 @@
+Copyright (c) 2003-2010 Mark Borgerding
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+    * Neither the author nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

libs/kiss_fft130/README

@@ -0,0 +1,134 @@
+KISS FFT - A mixed-radix Fast Fourier Transform based up on the principle, 
+"Keep It Simple, Stupid."
+
+    There are many great fft libraries already around.  Kiss FFT is not trying
+to be better than any of them.  It only attempts to be a reasonably efficient, 
+moderately useful FFT that can use fixed or floating data types and can be 
+incorporated into someone's C program in a few minutes with trivial licensing.
+
+USAGE:
+
+    The basic usage for 1-d complex FFT is:
+
+        #include "kiss_fft.h"
+
+        kiss_fft_cfg cfg = kiss_fft_alloc( nfft ,is_inverse_fft ,0,0 );
+
+        while ...
+
+            ... // put kth sample in cx_in[k].r and cx_in[k].i
+
+            kiss_fft( cfg , cx_in , cx_out );
+
+            ... // transformed. DC is in cx_out[0].r and cx_out[0].i 
+
+        free(cfg);
+
+    Note: frequency-domain data is stored from dc up to 2pi.
+    so cx_out[0] is the dc bin of the FFT
+    and cx_out[nfft/2] is the Nyquist bin (if exists)
+
+    Declarations are in "kiss_fft.h", along with a brief description of the 
+functions you'll need to use. 
+
+Code definitions for 1d complex FFTs are in kiss_fft.c.
+
+You can do other cool stuff with the extras you'll find in tools/
+
+    * multi-dimensional FFTs 
+    * real-optimized FFTs  (returns the positive half-spectrum: (nfft/2+1) complex frequency bins)
+    * fast convolution FIR filtering (not available for fixed point)
+    * spectrum image creation
+
+The core fft and most tools/ code can be compiled to use float, double,
+ Q15 short or Q31 samples. The default is float.
+
+
+BACKGROUND:
+
+    I started coding this because I couldn't find a fixed point FFT that didn't 
+use assembly code.  I started with floating point numbers so I could get the 
+theory straight before working on fixed point issues.  In the end, I had a 
+little bit of code that could be recompiled easily to do ffts with short, float
+or double (other types should be easy too).  
+
+    Once I got my FFT working, I was curious about the speed compared to
+a well respected and highly optimized fft library.  I don't want to criticize 
+this great library, so let's call it FFT_BRANDX.
+During this process, I learned:
+
+    1. FFT_BRANDX has more than 100K lines of code. The core of kiss_fft is about 500 lines (cpx 1-d).
+    2. It took me an embarrassingly long time to get FFT_BRANDX working.
+    3. A simple program using FFT_BRANDX is 522KB. A similar program using kiss_fft is 18KB (without optimizing for size).
+    4. FFT_BRANDX is roughly twice as fast as KISS FFT in default mode.
+
+    It is wonderful that free, highly optimized libraries like FFT_BRANDX exist.
+But such libraries carry a huge burden of complexity necessary to extract every 
+last bit of performance.
+
+    Sometimes simpler is better, even if it's not better.
+
+FREQUENTLY ASKED QUESTIONS:
+	Q: Can I use kissfft in a project with a ___ license?
+	A: Yes.  See LICENSE below.
+
+	Q: Why don't I get the output I expect?
+	A: The two most common causes of this are 
+		1) scaling : is there a constant multiplier between what you got and what you want?
+		2) mixed build environment -- all code must be compiled with same preprocessor 
+		definitions for FIXED_POINT and kiss_fft_scalar
+
+	Q: Will you write/debug my code for me?
+	A: Probably not unless you pay me.  I am happy to answer pointed and topical questions, but 
+	I may refer you to a book, a forum, or some other resource.
+
+
+PERFORMANCE:
+    (on Athlon XP 2100+, with gcc 2.96, float data type)
+
+    Kiss performed 10000 1024-pt cpx ffts in .63 s of cpu time.
+    For comparison, it took md5sum twice as long to process the same amount of data.
+
+    Transforming 5 minutes of CD quality audio takes less than a second (nfft=1024). 
+
+DO NOT:
+    ... use Kiss if you need the Fastest Fourier Transform in the World
+    ... ask me to add features that will bloat the code
+
+UNDER THE HOOD:
+
+    Kiss FFT uses a time decimation, mixed-radix, out-of-place FFT. If you give it an input buffer  
+    and output buffer that are the same, a temporary buffer will be created to hold the data.
+
+    No static data is used.  The core routines of kiss_fft are thread-safe (but not all of the tools directory).
+
+    No scaling is done for the floating point version (for speed).  
+    Scaling is done both ways for the fixed-point version (for overflow prevention).
+
+    Optimized butterflies are used for factors 2,3,4, and 5. 
+
+    The real (i.e. not complex) optimization code only works for even length ffts.  It does two half-length
+    FFTs in parallel (packed into real&imag), and then combines them via twiddling.  The result is 
+    nfft/2+1 complex frequency bins from DC to Nyquist.  If you don't know what this means, search the web.
+
+    The fast convolution filtering uses the overlap-scrap method, slightly 
+    modified to put the scrap at the tail.
+
+LICENSE:
+    Revised BSD License, see COPYING for verbiage. 
+    Basically, "free to use&change, give credit where due, no guarantees"
+    Note this license is compatible with GPL at one end of the spectrum and closed, commercial software at 
+    the other end.  See http://www.fsf.org/licensing/licenses
+
+    A commercial license is available which removes the requirement for attribution.  Contact me for details.
+
+
+TODO:
+    *) Add real optimization for odd length FFTs 
+    *) Document/revisit the input/output fft scaling
+    *) Make doc describing the overlap (tail) scrap fast convolution filtering in kiss_fastfir.c
+    *) Test all the ./tools/ code with fixed point (kiss_fastfir.c doesn't work, maybe others)
+
+AUTHOR:
+    Mark Borgerding
+    [email protected]