synth.h

Go to the documentation of this file.

#pragma once

 
#include "fl/stl/stdint.h"
#include "fl/stl/span.h"
#include "fl/stl/shared_ptr.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
namespace audio {
 
// Forward declarations
class ISynthOscillator;
class ISynthEngine;
FASTLED_SHARED_PTR(ISynthOscillator);
FASTLED_SHARED_PTR(ISynthEngine);

enum class SynthShape {
    Sawtooth,        // Classic sawtooth wave (reflect=1, peak=0, half=0, wait=0)
    Square,          // Classic square wave (reflect=1, peak=0, half=1, wait=0)
    Triangle,        // Classic triangle wave (reflect=1, peak=0.5, half=0, wait=0)
    AlternatingSaw,  // Alternating sawtooth (reflect=0, peak=0, half=0, wait=0)
    Custom           // User-defined parameters
};

struct SynthParams {
    i32 reflect = 1;      
    float peakTime = 0.0f;    
    float halfHeight = 0.0f;  
    float zeroWait = 0.0f;    

    SynthParams() FL_NO_EXCEPT = default;

    SynthParams(i32 reflect, float peakTime, float halfHeight, float zeroWait)
        FL_NO_EXCEPT : reflect(reflect), peakTime(peakTime), halfHeight(halfHeight), zeroWait(zeroWait) {}

    static SynthParams fromShape(SynthShape shape) FL_NO_EXCEPT;
};

class ISynthEngine {
public:
    static ISynthEnginePtr create(i32 width = 32, i32 oversample = 16) FL_NO_EXCEPT;
 
    virtual ~ISynthEngine() FL_NO_EXCEPT = default;

    virtual bool isValid() const FL_NO_EXCEPT = 0;

    virtual i32 getWidth() const FL_NO_EXCEPT = 0;

    virtual i32 getOversample() const FL_NO_EXCEPT = 0;
};

class ISynthOscillator {
public:
    static ISynthOscillatorPtr create(ISynthEnginePtr engine, const SynthParams& params) FL_NO_EXCEPT;

    static ISynthOscillatorPtr create(ISynthEnginePtr engine, SynthShape shape = SynthShape::Sawtooth) FL_NO_EXCEPT;
 
    virtual ~ISynthOscillator() FL_NO_EXCEPT = default;

    virtual void generateSamples(float* output, i32 numSamples, float freq) FL_NO_EXCEPT = 0;

    virtual void generateSamples(fl::span<float> output, float freq) FL_NO_EXCEPT = 0;

    virtual void setShape(SynthShape shape) FL_NO_EXCEPT = 0;

    virtual void setParams(const SynthParams& params) FL_NO_EXCEPT = 0;

    virtual SynthParams getParams() const FL_NO_EXCEPT = 0;

    virtual void reset() FL_NO_EXCEPT = 0;

    virtual ISynthEnginePtr getEngine() const FL_NO_EXCEPT = 0;
};
 
} // namespace audio
} // namespace fl