audiooutput.h

Go to the documentation of this file.

#ifndef AUDIOOUTPUT
#define AUDIOOUTPUT
 
#include <chrono>
using namespace std::chrono_literals;
#include <utility>
 
// Qt headers
#include <QCoreApplication>
#include <QString>
#include <QVector>
 
// MythTV headers
#include "libmythtv/audio/audiooutputsettings.h"
#include "libmythtv/audio/audiosettings.h"
#include "libmythtv/audio/visualization.h"
#include "libmythtv/audio/volumebase.h"
#include "libmythbase/compat.h"
#include "libmythbase/mythchrono.h"
#include "libmythbase/mythevent.h"
#include "libmythbase/mythobservable.h"
 
#include "libmythtv/mythtvexp.h"
 
// forward declaration
struct AVCodecContext;
struct AVPacket;
struct AVFrame;
 
class MTV_PUBLIC AudioOutput : public VolumeBase, public MythObservable
{
    Q_DECLARE_TR_FUNCTIONS(AudioOutput);
 
 public:
    class AudioDeviceConfig
    {
      public:
        QString             m_name;
        QString             m_desc;
        AudioOutputSettings m_settings;
        AudioDeviceConfig(void) :
            m_settings(AudioOutputSettings(true)) { };
        AudioDeviceConfig(QString name,
                          QString desc) :
            m_name(std::move(name)), m_desc(std::move(desc)),
            m_settings(AudioOutputSettings(true)) { };
        AudioDeviceConfig(const AudioDeviceConfig &) = default;
        AudioDeviceConfig(AudioDeviceConfig &&) = default;
        AudioDeviceConfig &operator= (const AudioDeviceConfig &) = default;
        AudioDeviceConfig &operator= (AudioDeviceConfig &&) = default;
    };
 
    class Event;
 
    using ADCVect = QVector<AudioDeviceConfig>;
 
    static void Cleanup(void);
    static ADCVect* GetOutputList(void);
    static AudioDeviceConfig* GetAudioDeviceConfig(
        QString &name, const QString &desc, bool willsuspendpa = false);
 
    // opens one of the concrete subclasses
    static AudioOutput *OpenAudio(
        const QString &main_device, const QString &passthru_device,
        AudioFormat format, int channels, AVCodecID codec, int samplerate,
        AudioOutputSource source, bool set_initial_vol, bool passthru,
        int upmixer_startup = 0, AudioOutputSettings *custom = nullptr);
    static AudioOutput *OpenAudio(AudioSettings &settings,
                                  bool willsuspendpa = true);
    static AudioOutput *OpenAudio(
        const QString &main_device,
        const QString &passthru_device = QString(),
        bool willsuspendpa = true);
 
    AudioOutput() = default;
    ~AudioOutput() override;
 
    // reconfigure sound out for new params
    virtual void Reconfigure(const AudioSettings &settings) = 0;
    bool isConfigured() const { return m_isConfigured; };
 
    virtual void SetStretchFactor(float factor);
    virtual float GetStretchFactor(void) const { return 1.0F; }
    virtual int GetChannels(void) const { return 2; }
    virtual AudioFormat GetFormat(void) const { return FORMAT_S16; };
    virtual int GetBytesPerFrame(void) const { return 4; };
 
    virtual AudioOutputSettings* GetOutputSettingsCleaned(bool digital = true);
    virtual AudioOutputSettings* GetOutputSettingsUsers(bool digital = true);
    virtual bool CanPassthrough(int samplerate, int channels,
                                AVCodecID codec, int profile) const;
    virtual bool CanDownmix(void) const { return false; };
 
    // dsprate is in 100 * samples/second
    virtual void SetEffDsp(int dsprate) = 0;
 
    virtual void Reset(void) = 0;
 
    virtual bool AddFrames(void *buffer, int frames,
                           std::chrono::milliseconds timecode) = 0;
 
    virtual bool AddData(void *buffer, int len,
                         std::chrono::milliseconds timecode, int frames) = 0;
 
    virtual bool NeedDecodingBeforePassthrough(void) const { return true; };
 
    virtual std::chrono::milliseconds LengthLastData(void) const { return -1ms; };
 
    virtual void SetTimecode(std::chrono::milliseconds timecode) = 0;
    virtual bool IsPaused(void) const = 0;
    virtual void Pause(bool paused) = 0;
    virtual void PauseUntilBuffered(void) = 0;
 
    // Wait for all data to finish playing
    virtual void Drain(void) = 0;
 
    virtual std::chrono::milliseconds GetAudiotime(void) = 0;
 
    virtual std::chrono::milliseconds GetAudioBufferedTime(void) { return 0ms; }
 
    virtual void SetSourceBitrate(int /*rate*/ ) { }
 
    virtual void GetBufferStatus(uint &fill, uint &total)
        { fill = total = 0; }
 
    //  Only really used by the AudioOutputNULL object
    virtual void bufferOutputData(bool y) = 0;
    virtual int readOutputData(unsigned char *read_buffer,
                               size_t max_length) = 0;
 
    virtual bool IsUpmixing(void)   { return false; }
    virtual bool ToggleUpmix(void)  { return false; }
    virtual bool CanUpmix(void)     { return false; }
    bool PulseStatus(void) const { return m_pulseWasSuspended; }
 
    virtual bool CanProcess(AudioFormat fmt) { return fmt == FORMAT_S16; }
 
    virtual uint32_t CanProcess(void) { return 1 << FORMAT_S16; }
 
    int DecodeAudio(AVCodecContext *ctx,
                    uint8_t *buffer, int &data_size,
                    const AVPacket *pkt);
    static const int kMaxSizeBuffer = 384000;
 
    bool hasVisual(void) { return !m_visuals.empty(); }
    void addVisual(Visualization *v);
    void removeVisual(Visualization *v);
 
    bool playPinkNoise(char* frames, int channels, int channel, int count, int bits);
 
    virtual bool has_optimized_SIMD() { return false; }
 
  protected:
    void dispatchError(const QString &e);
    void dispatchVisual(uchar *b, unsigned long b_len,
                        std::chrono::milliseconds timecode, int chan, int prec);
    void prepareVisuals();
 
    bool    m_isConfigured      {false};
    bool    m_pulseWasSuspended {false};
    AVFrame *m_frame            {nullptr};
    std::vector<Visualization*> m_visuals;
};
 
class MTV_PUBLIC AudioOutput::Event : public MythEvent
{
  public:
    explicit Event(Type type) : MythEvent(type) {}
    Event(std::chrono::seconds s, unsigned long w, int b, int f, int p, int c) :
        MythEvent(kInfo), m_elaspedSeconds(s), m_writtenBytes(w),
        m_brate(b), m_freq(f), m_prec(p), m_chan(c) {}
    explicit Event(QString e) :
        MythEvent(kError),
        m_errorMsg(std::move(e))
    {
    }
 
    ~Event() override = default;
 
    QString errorMessage() const { return m_errorMsg; }
 
    const std::chrono::seconds &elapsedSeconds() const { return m_elaspedSeconds; }
    const unsigned long &writtenBytes() const { return m_writtenBytes; }
    const int &bitrate() const { return m_brate; }
    const int &frequency() const { return m_freq; }
    const int &precision() const { return m_prec; }
    const int &channels() const { return m_chan; }
 
    MythEvent *clone(void) const override // MythEvent
        { return new Event(*this); }
 
    static const inline QEvent::Type kPlaying    {static_cast<QEvent::Type>(QEvent::registerEventType())};
    static const inline QEvent::Type kBuffering  {static_cast<QEvent::Type>(QEvent::registerEventType())};
    static const inline QEvent::Type kInfo       {static_cast<QEvent::Type>(QEvent::registerEventType())};
    static const inline QEvent::Type kPaused     {static_cast<QEvent::Type>(QEvent::registerEventType())};
    static const inline QEvent::Type kStopped    {static_cast<QEvent::Type>(QEvent::registerEventType())};
    static const inline QEvent::Type kError      {static_cast<QEvent::Type>(QEvent::registerEventType())};
 
  private:
    Event(const Event &o) = default;
 
  // No implicit copying.
  public:
    Event &operator=(const Event &other) = delete;
    Event(Event &&) = delete;
    Event &operator=(Event &&) = delete;
 
  private:
    QString        m_errorMsg;
 
    std::chrono::seconds m_elaspedSeconds {0s};
    unsigned long  m_writtenBytes    {0};
    int            m_brate           {0};
    int            m_freq            {0};
    int            m_prec            {0};
    int            m_chan            {0};
};
 
#endif