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>
 
// standard libraries
#include <complex>
#include <cstdint>
 
// internal
#include "Grain.h"
#include "Wave.h"
 
constexpr uint16_t WINDOW_SIZE_OVERLAP = WINDOW_SIZE << WINDOW_OVERLAP;
constexpr int WINDOW_SIZE_BY_2 = WINDOW_SIZE_OVERLAP >> 1;
 
constexpr float FREQ_RES = (float)SAMPLE_RATE / (float)WINDOW_SIZE_OVERLAP;
 
constexpr float FREQ_WIDTH = 1.0 / FREQ_RES;
 
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();
 
    float getMean(float* data, int dataLength);
 
    float getMean(complex* data, int dataLength);
 
    void noiseFloor(float* data, float threshold);
 
    void noiseFloorCFAR(float* data, 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);
 
    bool isAudioLabReady();
 
    // --- Wave Manipulation -------------------------------------------------------
 
    void mapAmplitudes(float* ampData, int dataLength, float minAmpSum = 10000,
        float smoothFactor = 0.05);
 
    float mapFrequencyByOctaves(float inFreq, float maxFreq);
 
    float mapFrequencyMIDI(float inFreq, float minFreq, float maxFreq);
 
    // --- Grains -----------------------------------------------------------------
 
    void updateGrains();
 
    Grain* createGrainArray(int numGrains, uint8_t channel, WaveType waveType);
 
    Grain* createDynamicGrain(uint8_t channel, WaveType waveType, FreqEnv freqEnv, AmpEnv ampEnv, DurEnv durEnv);
 
    void triggerGrains(Grain* grains, int numGrains, FreqEnv freqEnv, AmpEnv ampEnv, DurEnv durEnv);
 
    FreqEnv createFreqEnv(float attackFreq, float decayFreq, float sustainFreq, float releaseFreq);
 
    AmpEnv createAmpEnv(float attackAmp, float decayAmp, float sustainAmp, float releaseAmp);
 
    DurEnv createDurEnv(int attackDuration, int decayDuration, int sustainDuration, int releaseDuration, float curve);
 
    void setGrainFreqEnv(Grain* grains, int numGrains, FreqEnv freqEnv);
 
    void setGrainAmpEnv(Grain* grains, int numGrains, AmpEnv ampEnv);
 
    void setGrainDurEnv(Grain* grains, int numGrains, DurEnv durEnv);
 
    void pause() { AudioLab.pauseSampling(); }
 
    void resume() { AudioLab.resumeSampling(); }
 
private:
    // Fast Fourier Transform uses complex numbers
    float   vReal[WINDOW_SIZE_BY_2];   
    float   hamming[WINDOW_SIZE_OVERLAP]; 
    complex vData[WINDOW_SIZE_OVERLAP];
    uint16_t rollingInputBuffer[WINDOW_SIZE_OVERLAP]; 
    
    // --- AudioLab Library --------------------------------------------------------
 
    GrainList grainList;
};
 
#endif // VIBROSONICS_API_H