Method processSample

src/fl/audio/audio_reactive.cpp.hpp:164–271

}

void Reactive::processSample(const Sample& sample) {
    if (!sample.isValid()) {
        return; // Invalid sample, ignore
    }

    // Extract timestamp from the Sample
    fl::u32 currentTimeMs = sample.timestamp();

    // Phase 1: Signal conditioning pipeline
    Sample processedSample = sample;

    // Step 1: Signal conditioning (DC removal, spike filtering, noise gate)
    if (mConfig.enableSignalConditioning) {
        processedSample = mSignalConditioner.processSample(processedSample);
        if (!processedSample.isValid()) {
            return; // Signal was completely filtered out
        }
    }

    // Step 2: Noise floor tracking (update tracker, but don't modify signal)
    if (mConfig.enableNoiseFloorTracking) {
        float rms = processedSample.rms();
        mNoiseFloorTracker.update(rms);
    }

    // Set conditioned sample on shared Context (clears per-frame FFT cache)
    mContext->setSample(processedSample);

    // Populate silence flag after setSample() resets it — detectors run via
    // updateFromContext() below and will read context->isSilent().
    //
    // Uses an absolute RMS threshold (not the adaptive noise floor). The
    // adaptive floor's first-sample init matches the current level, which
    // causes isAboveFloor() to be stuck at false for any steady signal —
    // wrongly flagging loud constant tones as silent. Absolute RMS is the
    // right primitive for "no signal present": a steady loud tone has
    // large RMS and is not silent regardless of noise-floor adaptation.
    if (mConfig.enableNoiseFloorTracking) {
        constexpr float kSilenceRmsThreshold = 10.0f;
        mContext->setSilent(processedSample.rms() < kSilenceRmsThreshold);
    }

    // Process the conditioned Sample - timing is gated by sample availability
    processFFT(processedSample);

    // Update internal Processor BEFORE populating Data fields,
    // so updateVolumeAndPeak() can source normalized volume.
    ensureAudioProcessor();
    mAudioProcessor->updateFromContext(mContext);

    updateVolumeAndPeak(processedSample);

    // Enhanced processing pipeline
    applySpectralEqualization();
    calculateBandEnergies();

    // Apply pink noise compensation AFTER band energy calculation
    // so that bassEnergy/midEnergy/trebleEnergy reflect actual spectral content