scanmonitor.h

Go to the documentation of this file.

/* -*- Mode: c++ -*-
 * vim: set expandtab tabstop=4 shiftwidth=4:
 *
 * Original Project
 *      MythTV      http://www.mythtv.org
 *
 * Copyright (c) 2004, 2005 John Pullan <john@pullan.org>
 * Copyright (c) 2005 - 2007 Daniel Kristjansson
 *
 * Description:
 *     Collection of classes to provide channel scanning functionallity
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 * Or, point your browser to http://www.gnu.org/copyleft/gpl.html
 *
 */
 
#ifndef SCAN_MONITOR_H
#define SCAN_MONITOR_H
 
// Qt headers
#include <QObject>
#include <QEvent>
 
// MythTV headers
#include "libmythtv/signalmonitorlistener.h"
 
class ChannelScanner;
class SignalMonitorValue;
class QString;
 
class ScanMonitor :
    public QObject,
    public DVBSignalMonitorListener
{
    Q_OBJECT
 
    friend class QObject; // quiet OSX gcc warning
 
  public:
    explicit ScanMonitor(ChannelScanner *cs) : m_channelScanner(cs) { }
    virtual void deleteLater(void);
 
    void customEvent(QEvent *event) override; // QObject
 
    // Values from 1-100 of scan completion
    void ScanPercentComplete(int pct);
    void ScanUpdateStatusText(const QString &status);
    void ScanUpdateStatusTitleText(const QString &status);
    void ScanAppendTextToLog(const QString &status);
    void ScanComplete(void);
    void ScanErrored(const QString &error);
 
    // SignalMonitorListener
    void AllGood(void) override { } // SignalMonitorListener
    void StatusSignalLock(const SignalMonitorValue &val) override; // SignalMonitorListener
    void StatusChannelTuned(const SignalMonitorValue &val) override; // SignalMonitorListener
    void StatusSignalStrength(const SignalMonitorValue &val) override; // SignalMonitorListener
 
    // DVBSignalMonitorListener
    void StatusSignalToNoise(const SignalMonitorValue &val) override; // DVBSignalMonitorListener
    void StatusBitErrorRate(const SignalMonitorValue &/*val*/) override { } // DVBSignalMonitorListener
    void StatusUncorrectedBlocks(const SignalMonitorValue &/*val*/) override { } // DVBSignalMonitorListener
    void StatusRotorPosition(const SignalMonitorValue &val) override; // DVBSignalMonitorListener
 
  private:
    ~ScanMonitor() override = default;
 
    ChannelScanner *m_channelScanner {nullptr};
};
 
class Configurable;
 
class ScannerEvent : public QEvent
{
    friend class QObject; // quiet OSX gcc warning
 
  public:
 
    explicit ScannerEvent(QEvent::Type type) : QEvent(type) { }
 
    QString strValue()              const { return m_str; }
    void    strValue(const QString& str)  { m_str = str; }
 
    int     intValue()       const { return m_intValue; }
    void    intValue(int intvalue) { m_intValue = intvalue; }
 
    bool    boolValue()       const { return m_intValue != 0; }
 
    Configurable *ConfigurableValue() const { return m_cfgPtr; }
    void    ConfigurableValue(Configurable *cfg_ptr)
        { m_cfgPtr = cfg_ptr; }
 
    static const Type kScanComplete;
    static const Type kScanShutdown;
    static const Type kScanErrored;
    static const Type kAppendTextToLog;
    static const Type kSetStatusText;
    static const Type kSetStatusTitleText;
    static const Type kSetPercentComplete;
    static const Type kSetStatusRotorPosition;
    static const Type kSetStatusSignalToNoise;
    static const Type kSetStatusSignalStrength;
    static const Type kSetStatusSignalLock;
    static const Type kSetStatusChannelTuned;
 
  private:
    ~ScannerEvent() override = default;
 
  private:
    QString       m_str;
    int           m_intValue {0};
    Configurable *m_cfgPtr   {nullptr};
};
 
void post_event(QObject *dest, QEvent::Type type, int val);
void post_event(QObject *dest, QEvent::Type type, const QString &val);
void post_event(QObject *dest, QEvent::Type type, int val,
                Configurable *spp);
 
#endif // SCAN_MONITOR_H