v4l2util.h

Go to the documentation of this file.

#ifndef _V4L2_util_h_
#define _V4L2_util_h_

#ifdef USING_V4L2
#include "videodev2.h" // our copy
#endif

#include "tv.h"
#include "mythtvexp.h"

#include <QStringList>
#include "driveroption.h"

struct DriverOption;

class MTV_PUBLIC V4L2util
{
  public:
    V4L2util(void);
    explicit V4L2util(const QString& dev_name);
    V4L2util(const QString& dev_name, const QString& vbi_dev_name);
    ~V4L2util(void);

    bool Open(const QString& device_name, const QString& vbi_device_name = "");
    void Close(void);
    int  FD(void) const { return m_fd; }

    bool operator!(void) const { return m_fd < 0; }
    bool IsOpen(void) const    { return m_fd >= 0; }

    bool GetOptions(DriverOption::Options& options);
    int  GetOptionValue(DriverOption::category_t cat, const QString& desc);
    bool GetFormats(QStringList& formats);
    bool GetVideoStandard(QString& name) const;
    int  GetSignalStrength(void) const;
    bool GetResolution(int& width, int& height) const;

    bool HasTuner(void) const;
    bool HasAudioSupport(void) const;
    bool HasStreaming(void) const;
    bool HasSlicedVBI(void) const;
    bool IsEncoder(void) const;
    bool UserAdjustableResolution(void) const;

    QString DriverName(void)  const { return m_driver_name; }
    QString CardName(void)    const { return m_card_name; }
    QString ProfileName(void) const { return "V4L2:" + m_driver_name; }

    int  GetStreamType(void) const;
    bool SetStreamType(int value);
    // Video controls
    bool SetVideoAspect(int value);
    bool SetVideoBitrateMode(int value);
    bool SetVideoBitrate(int value);
    bool SetVideoBitratePeak(int value);
    bool SetResolution(uint32_t width, uint32_t height);
    // Audio controls
    bool SetAudioInput(int value);
    bool SetAudioCodec(int value);
    bool SetVolume(int volume);
    bool SetLanguageMode(int mode);
    bool SetAudioSamplingRate(int value);
    bool SetAudioBitrateL2(int value);

    // Actions
    bool StartEncoding(void);
    bool StopEncoding(void);
    bool PauseEncoding(void);
    bool ResumeEncoding(void);

    static QString StreamTypeDesc(int value);

  protected:
    // VBI
    bool OpenVBI(const QString& vbi_dev_name);
    bool SetSlicedVBI(const VBIMode::vbimode_t& vbimode);

    int  GetExtControl(int request, const QString& ctrl_desc = "") const;
    bool SetExtControl(int request, int value, const QString& ctrl_desc,
                       const QString& value_desc);
    bool SetEncoderState(int mode, const QString& desc);
    void SetDefaultOptions(DriverOption::Options& options);

    static void    bitmask_toString(QString& result, uint32_t flags,
                                uint32_t mask, const QString& desc);
    static QString ctrlflags_toString(uint32_t flags);
    static QString queryctrl_toString(int type);

    void log_qctrl(struct v4l2_queryctrl& queryctrl, DriverOption& drv_opt,
                   QString& msg);
    bool log_control(struct v4l2_queryctrl& qctrl, DriverOption& drv_opt,
                     QString& msg);
    void log_controls(bool show_menus);

  private:
    int      m_fd;
    int      m_vbi_fd;
    DriverOption::Options m_options;
    QString  m_device_name;
    QString  m_driver_name;
    QString  m_card_name;
    int      m_version;
    uint32_t m_capabilities;
    bool     m_have_query_ext_ctrl;
};

#endif