audiooutput.h

Go to the documentation of this file.

 
#pragma once
 
#include <config.h>
 
#include "fundamentals.h"
 
namespace Audio {
    class LavGenericAdapter;
 
    enum SampleArrangement {
        Native,
        Big,
        Little
    };
    enum SampleSignedness {
        Signed,
        Unsigned
    };
    struct AudioFormat {
        int bits = 16; 
        int rate = 44100; 
        int channels = 2;
        SampleArrangement arrangement = SampleArrangement::Native;
        SampleSignedness signedness = Signed;
        SampleArrangement realArrangement () const;
        bool isNativeArrangement () const;
        int sampleGroupSize () const {
            assert ((bits & 0x07) == 0);
            return channels * ((bits + 7) / 8);
        };
        static SampleArrangement nativeArrangement (int bits);
    };
 
    class AudioException : public std::exception {
    protected:
        std::string reason;
    public:
        AudioException (const char *why = "") : reason (why) { };
        AudioException (std::string why) : reason (why) { };
        virtual const char *what() const noexcept override  { return reason.c_str(); };
    };
 
 
    class Initializer {
    public:
        Initializer ();
        ~Initializer ();
    };
 
    class Output {
    protected:
        char bytes_per_sample_set; // Bytes/channel * number of channels
    public:
        virtual ~Output () { };
        virtual bool play (void *buffer, unsigned number_of_bytes) = 0;
        inline char bytesPerSample() { return bytes_per_sample_set; };
 
        static bool isValidOutput (const AudioSettings &settings);
        static bool outputCanCrossfade (const AudioSettings &settings);
 
        static Output *getOutput (const AudioSettings &settings,
                                  const AudioFormat &format);
        static void reportLibrariesAndVersions (int verbose);
    };
}