VibrosonicsAPI.h

Go to the documentation of this file.

#ifndef VIBROSONICS_API_H
#define VIBROSONICS_API_H
 
// standard library includes
#include <cmath>
 
// external dependencies
#include <Arduino.h>
#include <AudioLab.h>
#include <AudioPrism.h>
#include <Fast4ier.h>
#include <complex>
#include <cstdint>
 
// internal
#include "Grain.h"
#include "Wave.h"
 
constexpr int WINDOW_SIZE_BY_2 = WINDOW_SIZE >> 1;
 
constexpr float FREQ_RES = float(SAMPLE_RATE) / WINDOW_SIZE;
 
constexpr float FREQ_WIDTH = 1.0 / FREQ_RES;
 
const int NUM_WINDOWS = 8;
 
class VibrosonicsAPI {
public:
    // ---- Setup ------------------------------------------------------------------
 
    void init();
 
    // --- FFT Input & Storage -----------------------------------------------------
 
    // we will need more processAudioInput functionality to handle stereo input
 
    void processAudioInput(float output[]);
 
    void computeHammingWindow();
 
    void dcRemoval();
 
    void fftWindowing();
 
    void complexToMagnitude();
 
    void noiseFloor(float data[], int dataLength, float threshold);
 
    void noiseFloorCFAR(float data[], int dataLength, int numRefs,
        int numGuards, float bias);
 
    // --- AudioLab Interactions ---------------------------------------------------
 
    void assignWave(float freq, float amp, int channel);
 
    void assignWaves(float* freqs, float* amps, int dataLength, int channel);
 
    // --- Wave Manipulation -------------------------------------------------------
 
    float getMean(float* data, int dataLength);
 
    float getMean(complex* data, int dataLength);
 
    void mapAmplitudes(float* ampData, int dataLength,
        float minAmpSum = 10000, float smoothFactor = 0.05);
 
    void mapFrequenciesLinear(float* freqData, int dataLength);
 
    void mapFrequenciesExponential(float* freqData, int dataLength, float exp);
 
    // --- Grains -----------------------------------------------------------------
 
    void updateGrains();
 
    Grain* createGrainArray(int numGrains, uint8_t channel, WaveType waveType);
 
    Grain* createDynamicGrain(uint8_t channel, WaveType waveType, FreqEnv freqEnv, AmpEnv ampEnv);
 
    void triggerGrains(Grain* grains, int numGrains, FreqEnv freqEnv, AmpEnv ampEnv);
 
    FreqEnv createFreqEnv(float attackFreq, float decayFreq, float sustainFreq, float releaseFreq);
 
    AmpEnv createAmpEnv(float attackAmp, int attackDuration, float decayAmp, int decayDuration, float sustainAmp, int sustainDuration, float releaseAmp, int releaseDuration, float curve);
 
    void setGrainFreqEnv(Grain* grains, int numGrains, FreqEnv freqEnv);
 
    void setGrainAmpEnv(Grain* grains, int numGrains, AmpEnv ampEnv);
private:
    // Fast Fourier Transform uses complex numbers
    float   vReal[WINDOW_SIZE];   
    float   hamming[WINDOW_SIZE]; 
    complex vData[WINDOW_SIZE];
 
    // --- AudioLab Library --------------------------------------------------------
 
    int* audioLabInputBuffer = AudioLab.getInputBuffer();
 
    GrainList grainList;
};
 
#endif // VIBROSONICS_API_H