ACMXVK/audio.hpp

Go to the documentation of this file.

#ifndef ACMXVK_AUDIO_HPP
#define ACMXVK_AUDIO_HPP
 
#include <cstddef>
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
 
namespace acmxvk::audio {
 
    struct AudioMetrics {
        float amplitude = 0.0F;
        float frequency = 0.0F;
        float peak = 0.0F;
        float rms = 0.0F;
        float smooth = 0.0F;
        float low = 0.0F;
        float mid = 0.0F;
        float high = 0.0F;
    };
 
    struct AudioStreamConfig {
        unsigned int channels = 2;
        float sensitivity = 1.0F;
        int input_device = -1;
        int output_device = -1;
        bool pass_through = false;
        float pass_through_gain = 1.0F;
        float recording_gain = 1.0F;
    };
 
    struct AudioRecording {
        std::vector<float> samples;
        unsigned int sample_rate = 0;
 
        [[nodiscard]] bool empty() const { return samples.empty(); }
        [[nodiscard]] double duration_seconds() const {
            return sample_rate == 0
                       ? 0.0
                       : static_cast<double>(samples.size()) /
                             static_cast<double>(sample_rate);
        }
    };
 
    [[nodiscard]] bool write_wav_file(const AudioRecording &recording,
                                      const std::string &filename);
 
    class AudioEngine {
      public:
        static constexpr std::size_t FFT_SIZE = 512;
 
        AudioEngine();
        ~AudioEngine();
 
        AudioEngine(const AudioEngine &) = delete;
        AudioEngine &operator=(const AudioEngine &) = delete;
 
        bool open(const AudioStreamConfig &config);
        void close();
        [[nodiscard]] bool is_open() const;
 
        [[nodiscard]] AudioMetrics metrics() const;
        [[nodiscard]] unsigned int sample_rate() const;
        void set_sensitivity(float sensitivity);
        [[nodiscard]] float sensitivity() const;
        [[nodiscard]] std::vector<float> spectrum() const;
        void process_samples(const float *samples, unsigned int frame_count,
                             unsigned int channels, unsigned int sample_rate);
        bool start_recording();
        [[nodiscard]] AudioRecording stop_recording();
        [[nodiscard]] bool is_recording() const;
        [[nodiscard]] double recording_time() const;
        void reset();
        static constexpr std::uint32_t spectrum_bin_count() {
            return static_cast<std::uint32_t>(FFT_SIZE / 2);
        }
 
        static void list_devices();
 
      private:
        class Impl;
        std::unique_ptr<Impl> impl;
    };
 
} // namespace acmxvk::audio
 
#endif