feat(dsp): add core synthesizer oscillators, wavetable and voice engine

2026-09-08 14:55:21 +02:00
parent 6e2859a1f6
commit fc9d16b302
12 changed files with 1473 additions and 0 deletions
@@ -0,0 +1,73 @@
+#pragma once
+
+#include <JuceHeader.h>
+#include "Params.h"
+#include "Wavetable.h"
+
+namespace serum
+{
+
+// ===========================================================================
+// Per-oscillator parameters (snapshot read from the APVTS each block).
+// ===========================================================================
+struct OscParams
+{
+    bool  enabled   = true;
+    int   wave      = 0;
+    float wtPos     = 0.0f;
+    int   warp      = 0;
+    float warpAmt   = 0.0f;
+    int   coarse    = 0;
+    int   fine      = 0;
+    float level     = 1.0f;
+    float pan       = 0.0f;
+    int   unison    = 1;
+    float detune    = 0.0f;
+    float spread    = 0.0f;
+    float phase     = 0.0f;
+    float randPhase = 0.0f;
+};
+
+// ===========================================================================
+// A polyphonic oscillator with wavetable morphing, warp modes and unison
+// (1..16 sub-voices). Per-voice state (phase) lives here; params are read each
+// block from the OscParams snapshot.
+// ===========================================================================
+class Oscillator
+{
+public:
+    Oscillator() = default;
+
+    void prepare (double sampleRate)          { sr = sampleRate; reset(); }
+    void reset();
+
+    // (Re)configure unison sub-voices: phase offsets, detune, pan and gain.
+    void noteOn (double freqHz, const OscParams& p, juce::uint32 seed);
+
+    // Accumulate this oscillator's contribution into outL/outR.
+    void processAdd (const Wavetable& wt, const OscParams& p, double freqHz,
+                     float& outL, float& outR) noexcept;
+
+    int  getActiveUnison() const noexcept { return activeUnison; }
+
+private:
+    struct SubVoice
+    {
+        double phase       = 0.0;
+        double detuneRatio = 1.0;
+        float  pan         = 0.0f;
+        float  level       = 1.0f;
+    };
+
+    std::array<SubVoice, kMaxUnison> voices;
+    int    activeUnison = 1;
+    double sr           = 44100.0;
+    juce::Random rng;
+
+    static constexpr double kTwoPi = 6.28318530717958647692;
+
+    float warpPhase (float phase, const OscParams& p) const noexcept;
+    float warpSample (float sample, const OscParams& p) const noexcept;
+};
+
+} // namespace serum