audio_boundary_report.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/audio/audio_probe_snapshot.hpp>
 
#include <cstdint>
#include <optional>
#include <string>
 
namespace pulp::audio {

struct DeviceStatsView {
    bool callback_running = false;
    double sample_rate = 0.0;
    std::uint32_t buffer_size = 0;
    std::uint64_t xruns = 0;
    std::uint64_t cpu_overloads = 0;
};

enum class BoundaryDiagnosis {
    kNoProbeData,            
    kSignalPresent,          
    kProcessorSilent,        
    kStandaloneBoundarySilent,  
    kDeviceProblem,          
};
 
struct BoundaryReport {
    BoundaryDiagnosis diagnosis = BoundaryDiagnosis::kNoProbeData;
    std::string text;
};

struct BoundaryReportInputs {
    std::optional<AudioProbeSnapshot> processor_output;
    std::optional<AudioProbeSnapshot> standalone_boundary;
    std::optional<DeviceStatsView> device;
    float silence_threshold = 3.1622776e-5f;  // ~ -90 dBFS
};

BoundaryReport build_boundary_report(const BoundaryReportInputs& inputs);
 
}  // namespace pulp::audio