synth.cpp.hpp

Go to the documentation of this file.

// synth.cpp.hpp - Implementation of bandlimited audio synthesizer oscillator
//
// This file implements the fl::ISynthOscillator interface and related APIs
// that wrap the low-level stb_hexwave library.
 
#include "fl/audio/synth.h"
#include "fl/stl/cstring.h"
#include "fl/stl/malloc.h"
// IWYU pragma: begin_keep
#include "third_party/stb/hexwave/stb_hexwave.h"
#include "fl/stl/noexcept.h"
// IWYU pragma: end_keep
 
namespace fl {
namespace audio {
 
// Short alias for third_party hexwave namespace to avoid verbose qualification
// without polluting fl:: namespace in unity builds.
namespace hw = third_party::hexwave;
 

// SynthEngineImpl - Implementation of ISynthEngine interface
 
class SynthEngineImpl : public ISynthEngine {
public:
    SynthEngineImpl(i32 width, i32 oversample) FL_NO_EXCEPT;
    ~SynthEngineImpl() FL_NO_EXCEPT override;
 
    // Non-copyable
    SynthEngineImpl(const SynthEngineImpl&) FL_NO_EXCEPT = delete;
    SynthEngineImpl& operator=(const SynthEngineImpl&) FL_NO_EXCEPT = delete;
 
    // ISynthEngine interface
    bool isValid() const FL_NO_EXCEPT override;
    i32 getWidth() const FL_NO_EXCEPT override { return mWidth; }
    i32 getOversample() const FL_NO_EXCEPT override { return mOversample; }
 
    // Internal access for SynthOscillatorImpl (same compilation unit)
    hw::HexWaveEngine* getEngineInternal() const FL_NO_EXCEPT { return mEngine; }
 
private:
    hw::HexWaveEngine* mEngine = nullptr;
    i32 mWidth;
    i32 mOversample;
};

// SynthOscillatorImpl - Implementation of ISynthOscillator interface
 
class SynthOscillatorImpl : public ISynthOscillator {
public:
    SynthOscillatorImpl(fl::shared_ptr<SynthEngineImpl> engine, const SynthParams& params) FL_NO_EXCEPT;
    ~SynthOscillatorImpl() FL_NO_EXCEPT override;
 
    // Non-copyable
    SynthOscillatorImpl(const SynthOscillatorImpl&) FL_NO_EXCEPT = delete;
    SynthOscillatorImpl& operator=(const SynthOscillatorImpl&) FL_NO_EXCEPT = delete;
 
    // ISynthOscillator interface
    void generateSamples(float* output, i32 numSamples, float freq) FL_NO_EXCEPT override;
    void generateSamples(fl::span<float> output, float freq) FL_NO_EXCEPT override;
    void setShape(SynthShape shape) FL_NO_EXCEPT override;
    void setParams(const SynthParams& params) FL_NO_EXCEPT override;
    SynthParams getParams() const FL_NO_EXCEPT override;
    void reset() FL_NO_EXCEPT override;
    ISynthEnginePtr getEngine() const FL_NO_EXCEPT override { return mEngine; }
 
private:
    fl::shared_ptr<SynthEngineImpl> mEngine;  // Shared pointer to engine (keeps it alive)
    hw::HexWave* mHexWave = nullptr;  // Typed pointer to HexWave structure
    SynthParams mCurrentParams;
};
 
// SynthParams implementation
SynthParams SynthParams::fromShape(SynthShape shape) FL_NO_EXCEPT {
    switch (shape) {
        case SynthShape::Sawtooth:
            return SynthParams(1, 0.0f, 0.0f, 0.0f);
        case SynthShape::Square:
            return SynthParams(1, 0.0f, 1.0f, 0.0f);
        case SynthShape::Triangle:
            return SynthParams(1, 0.5f, 0.0f, 0.0f);
        case SynthShape::AlternatingSaw:
            return SynthParams(0, 0.0f, 0.0f, 0.0f);
        case SynthShape::Custom:
        default:
            return SynthParams();  // Default to sawtooth
    }
}

// ISynthEngine static factory method
 
ISynthEnginePtr ISynthEngine::create(i32 width, i32 oversample) FL_NO_EXCEPT {
    return fl::make_shared<SynthEngineImpl>(width, oversample);
}

// SynthEngineImpl implementation
 
SynthEngineImpl::SynthEngineImpl(i32 width, i32 oversample)
    FL_NO_EXCEPT : mWidth(width), mOversample(oversample) {
    // Clamp width to valid range
    if (mWidth < 4) mWidth = 4;
    if (mWidth > FL_STB_HEXWAVE_MAX_BLEP_LENGTH) mWidth = FL_STB_HEXWAVE_MAX_BLEP_LENGTH;
 
    // Clamp oversample to minimum
    if (mOversample < 2) mOversample = 2;
 
    mEngine = hw::hexwave_engine_create(mWidth, mOversample, nullptr);
}
 
SynthEngineImpl::~SynthEngineImpl() FL_NO_EXCEPT {
    if (mEngine) {
        hw::hexwave_engine_destroy(mEngine);
        mEngine = nullptr;
    }
}
 
bool SynthEngineImpl::isValid() const FL_NO_EXCEPT {
    return mEngine != nullptr;
}

// ISynthOscillator static factory methods
 
ISynthOscillatorPtr ISynthOscillator::create(ISynthEnginePtr engine, SynthShape shape) FL_NO_EXCEPT {
    return create(engine, SynthParams::fromShape(shape));
}
 
ISynthOscillatorPtr ISynthOscillator::create(ISynthEnginePtr engine, const SynthParams& params) FL_NO_EXCEPT {
    if (!engine || !engine->isValid()) {
        return nullptr;
    }
    // Safe downcast - we control the factory, so we know the concrete type
    auto engineImpl = fl::static_pointer_cast<SynthEngineImpl>(engine);
    return fl::make_shared<SynthOscillatorImpl>(engineImpl, params);
}

// SynthOscillatorImpl implementation
 
SynthOscillatorImpl::SynthOscillatorImpl(fl::shared_ptr<SynthEngineImpl> engine, const SynthParams& params)
    FL_NO_EXCEPT : mEngine(engine), mCurrentParams(params) {
    // Allocate HexWave structure
    mHexWave = static_cast<hw::HexWave*>(fl::malloc(sizeof(hw::HexWave)));
    fl::memset(mHexWave, 0, sizeof(hw::HexWave));
 
    // Initialize the oscillator with the engine
    hw::hexwave_create(
        mHexWave,
        engine->getEngineInternal(),
        params.reflect,
        params.peakTime,
        params.halfHeight,
        params.zeroWait
    );
}
 
SynthOscillatorImpl::~SynthOscillatorImpl() FL_NO_EXCEPT {
    if (mHexWave) {
        fl::free(mHexWave);
        mHexWave = nullptr;
    }
}
 
void SynthOscillatorImpl::generateSamples(float* output, i32 numSamples, float freq) FL_NO_EXCEPT {
    if (mHexWave && output && numSamples > 0) {
        hw::hexwave_generate_samples(output, numSamples, mHexWave, freq);
    }
}
 
void SynthOscillatorImpl::generateSamples(fl::span<float> output, float freq) FL_NO_EXCEPT {
    generateSamples(output.data(), static_cast<i32>(output.size()), freq);
}
 
void SynthOscillatorImpl::setShape(SynthShape shape) FL_NO_EXCEPT {
    setParams(SynthParams::fromShape(shape));
}
 
void SynthOscillatorImpl::setParams(const SynthParams& params) FL_NO_EXCEPT {
    if (mHexWave) {
        mCurrentParams = params;
        hw::hexwave_change(
            mHexWave,
            params.reflect,
            params.peakTime,
            params.halfHeight,
            params.zeroWait
        );
    }
}
 
SynthParams SynthOscillatorImpl::getParams() const FL_NO_EXCEPT {
    return mCurrentParams;
}
 
void SynthOscillatorImpl::reset() FL_NO_EXCEPT {
    if (mHexWave && mEngine) {
        // Re-create the oscillator with current parameters
        hw::hexwave_create(
            mHexWave,
            mEngine->getEngineInternal(),
            mCurrentParams.reflect,
            mCurrentParams.peakTime,
            mCurrentParams.halfHeight,
            mCurrentParams.zeroWait
        );
    }
}
 
} // namespace audio
} // namespace fl