audio.h

Go to the documentation of this file.

#ifndef NNGN_AUDIO_AUDIO_H
#define NNGN_AUDIO_AUDIO_H
 
#include <cstddef>
#include <memory>
#include <span>
#include <string_view>
#include <vector>
 
#include "math/math.h"
#include "math/vec3.h"
#include "utils/def.h"
 
namespace nngn {
 
class Audio {
public:
    enum class source : std::size_t {};
    // Utility
    static constexpr float db(float x) { return std::pow(10.0f, x / 20.0f); }
    // Audio generation
    static void gain(std::span<float> s, float g);
    static void over(std::span<float> s, float m, float mix);
    static void fade(std::span<float> s, float g0, float g1);
    static void exp_fade(
        std::span<float> s, std::size_t ep, float g0, float g1, float exp);
    static void env(
        std::span<float> s,
        std::size_t a, std::size_t d, float st, std::size_t r);
    static void mix(std::span<float> dst, std::span<const float> src);
    static void normalize(std::span<i16> dst, std::span<const float> src);
    // Constructors, destructors
    NNGN_MOVE_ONLY(Audio)
    Audio(void) = default;
    ~Audio(void);
    // Initialization, accessors
    bool init(Math *m, std::size_t rate);
    std::size_t rate(void) const { return this->m_rate; }
    std::size_t n_sources(void) const;
    // I/O
    bool read_wav(std::string_view path, std::vector<std::byte> *v) const;
    bool write_wav(FILE *f, std::span<const std::byte> s) const;
    void gen_wav_header(
        std::span<std::byte> dst, std::span<const std::byte> src) const;
    std::vector<std::byte> gen_wav(std::span<const float> s) const;
    // Audio generation
    void trem(std::span<float> s, float a, float freq, float mix) const;
    void gen_sine(std::span<float> s, float freq) const;
    void gen_sine_fm(
        std::span<float> s, float freq,
        float lfo_a, float lfo_freq, float lfo_d) const;
    void gen_square(std::span<float> s, float freq) const;
    void gen_saw(std::span<float> s, float freq) const;
    void gen_noise(std::span<float> s) const;
    // Sources
    bool set_pos(vec3 p);
    source add_source(void);
    source add_source(std::span<const std::byte> v);
    bool remove_source(source s);
    vec3 source_pos(source s) const;
    std::size_t source_sample_pos(source s) const;
    bool set_source_data(
        source s, std::size_t channels, std::size_t bit_depth,
        std::span<const std::byte> v);
    bool set_source_pos(source s, vec3 p);
    bool set_source_sample_pos(source s, std::size_t p);
    bool set_source_loop(source s, bool l);
    bool set_source_gain(source s, float g);
    bool play(source s) const;
    bool stop(source s) const;
private:
    bool init_openal(void);
    std::unique_ptr<void, void(*)(void*)> data = {nullptr, [](auto){}};
    Math *math = nullptr;
    std::size_t m_rate = 0;
};
 
}
 
#endif