audio_source.hpp

Go to the documentation of this file.

// This file is part of playd.
// playd is licensed under the MIT licence: see LICENSE.txt.

#ifndef PLAYD_AUDIO_SOURCE_HPP
#define PLAYD_AUDIO_SOURCE_HPP

#include <cstdint>
#include <string>
#include <vector>

#include "../errors.hpp"
#include "sample_formats.hpp"

class AudioSource
{
public:
    enum class DecodeState : std::uint8_t {
        WAITING_FOR_FRAME,
        DECODING,
        END_OF_FILE
    };

    using DecodeVector = std::vector<std::uint8_t>;

    using DecodeResult = std::pair<DecodeState, DecodeVector>;

    AudioSource(const std::string &path);

    virtual ~AudioSource() = default;

    //
    // Methods that must be overridden
    //

    virtual DecodeResult Decode() = 0;

    virtual std::uint8_t ChannelCount() const = 0;

    virtual std::uint32_t SampleRate() const = 0;

    virtual SampleFormat OutputSampleFormat() const = 0;

    virtual std::uint64_t Seek(std::uint64_t position) = 0;

    //
    // Methods provided 'for free'
    //

    virtual size_t BytesPerSample() const;

    virtual const std::string &Path() const;

    virtual std::uint64_t SamplesFromMicros(std::uint64_t micros) const;

    std::uint64_t MicrosFromSamples(std::uint64_t samples) const;

protected:
    std::string path;
};

#endif // PLAYD_AUDIO_SOURCE_HPP