energy_analyzer.h

Go to the documentation of this file.

#pragma once
 
#include "fl/audio/audio_detector.h"
#include "fl/math/filter/filter.h"
#include "fl/stl/function.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
namespace audio {
namespace detector {
 
class EnergyAnalyzer : public Detector {
public:
    EnergyAnalyzer() FL_NO_EXCEPT;
    ~EnergyAnalyzer() FL_NO_EXCEPT override;
 
    void update(shared_ptr<Context> context) FL_NO_EXCEPT override;
    void fireCallbacks() FL_NO_EXCEPT override;
    bool needsFFT() const FL_NO_EXCEPT override { return false; }  // Uses RMS from Sample
    const char* getName() const FL_NO_EXCEPT override { return "EnergyAnalyzer"; }
    void reset() FL_NO_EXCEPT override;
 
    // Callbacks (multiple listeners supported)
    function_list<void(float rms)> onEnergy;
    function_list<void(float peak)> onPeak;
    function_list<void(float avgEnergy)> onAverageEnergy;
    function_list<void(float normalizedRms)> onNormalizedEnergy;  // 0-1 range
 
    // State access
    float getRMS() const FL_NO_EXCEPT { return mCurrentRMS; }
    float getPeak() const FL_NO_EXCEPT { return mPeak; }
    float getAverageEnergy() const FL_NO_EXCEPT { return mAverageEnergy; }
    float getMinEnergy() const FL_NO_EXCEPT { return mMinEnergy; }
    float getMaxEnergy() const FL_NO_EXCEPT { return mMaxEnergy; }
    float getNormalizedRMS() const FL_NO_EXCEPT { return mNormalizedRMS; }  // 0-1 range
 
    // Configuration
    void setPeakDecay(float decay) FL_NO_EXCEPT { mPeakDecay = decay; }
    void setHistorySize(int size) FL_NO_EXCEPT;
 
private:
    float mCurrentRMS;
    float mPeak;
    float mAverageEnergy;
    float mMinEnergy;
    float mMaxEnergy;
    float mNormalizedRMS = 0.0f;
 
    // Adaptive range tracking for normalization (instant attack, slow 2s decay)
    AttackDecayFilter<float> mRunningMaxFilter{0.001f, 2.0f, 1.0f};
 
    // Peak tracking
    float mPeakDecay;
    u32 mLastPeakTime;
    static constexpr u32 PEAK_HOLD_MS = 50;
 
    // History for average calculation (O(1) running sum)
    MovingAverage<float, 0> mEnergyAvg{43};
 
    void updatePeak(float energy, u32 timestamp) FL_NO_EXCEPT;
    void updateAverage(float energy) FL_NO_EXCEPT;
};
 
} // namespace detector
} // namespace audio
} // namespace fl