QIviAmFmTunerBackendInterface Class
The QIviAmFmTunerBackendInterface defines the interface for backends to the QIviAmFmTuner feature class. More...
Header: | #include <QIviAmFmTunerBackendInterface> |
qmake: | QT += ivimedia |
Inherits: | QIviFeatureInterface |
Public Functions
QIviAmFmTunerBackendInterface(QObject *parent = nullptr) | |
virtual void | seekDown() = 0 |
virtual void | seekUp() = 0 |
virtual void | setBand(QIviAmFmTuner::Band band) = 0 |
virtual void | setFrequency(int frequency) = 0 |
virtual void | startScan() = 0 |
virtual void | stepDown() = 0 |
virtual void | stepUp() = 0 |
virtual void | stopScan() = 0 |
Signals
void | bandChanged(QIviAmFmTuner::Band band) |
void | frequencyChanged(int frequency) |
void | maximumFrequencyChanged(int maximumFrequency) |
void | minimumFrequencyChanged(int minimumFrequency) |
void | scanStatusChanged(bool scanRunning) |
void | stationChanged(const QIviAmFmTunerStation &station) |
void | stepSizeChanged(int stepSize) |
Detailed Description
The QIviAmFmTunerBackendInterface is the interface used by QIviAmFmTuner
The interface is discovered by a QIviAmFmTuner object, which connects to it and sets it up.
<example of a fully featured backend>
Member Function Documentation
QIviAmFmTunerBackendInterface::QIviAmFmTunerBackendInterface(QObject *parent = nullptr)
Constructs a backend interface.
The parent is sent to the QObject constructor.
[signal]
void QIviAmFmTunerBackendInterface::bandChanged(QIviAmFmTuner::Band band)
Emitted when the current band changed. The new value is passed as band.
See also minimumFrequencyChanged(), maximumFrequencyChanged(), and stepSizeChanged().
[signal]
void QIviAmFmTunerBackendInterface::frequencyChanged(int frequency)
Emitted when the current frequency changed. The new value is passed as frequency.
[signal]
void QIviAmFmTunerBackendInterface::maximumFrequencyChanged(int maximumFrequency)
Emitted when the maximum frequency of the current band changed. The new value is passed as maximumFrequency. This is usually caused by a switching the band.
See also bandChanged(), minimumFrequencyChanged(), and stepSizeChanged().
[signal]
void QIviAmFmTunerBackendInterface::minimumFrequencyChanged(int minimumFrequency)
Emitted when the minimum frequency of the current band changed. The new value is passed as minimumFrequency. This is usually caused by a switching the band.
See also bandChanged(), maximumFrequencyChanged(), and stepSizeChanged().
[signal]
void QIviAmFmTunerBackendInterface::scanStatusChanged(bool scanRunning)
Emitted when the status of the station scan has changed. This signal should be emitted as a result of a call to startScan() or stopScan() and informs about the current status using the scanRunning argument.
See also startScan() and stopScan().
[signal]
void QIviAmFmTunerBackendInterface::stationChanged(const QIviAmFmTunerStation &station)
Emitted when the current station changed. The new station is passed as station.
[signal]
void QIviAmFmTunerBackendInterface::stepSizeChanged(int stepSize)
Emitted when the frequency step size of the current band changed. The new value is passed as stepSize. This is usually caused by a switching the band.
See also bandChanged(), minimumFrequencyChanged(), and maximumFrequencyChanged().
[pure virtual]
void QIviAmFmTunerBackendInterface::seekDown()
Seeks the next available Station in downwards direction and tunes it.
If the beginning of the band where hit without finding a station, the search will be continued from the end of the band.
See also frequencyChanged and stationChanged.
[pure virtual]
void QIviAmFmTunerBackendInterface::seekUp()
Seeks the next available Station in upwards direction and tunes it.
If the end of the band where hit without finding a station, the search will be continued from the beginning of the band.
See also frequencyChanged and stationChanged.
[pure virtual]
void QIviAmFmTunerBackendInterface::setBand(QIviAmFmTuner::Band band)
Changes the band to the new value passed as band.
This method is expected to emit a bandChanged() signal when the internal state changes due to this function call
[pure virtual]
void QIviAmFmTunerBackendInterface::setFrequency(int frequency)
Changes the frequency to the new value passed as frequency.
This method is expected to emit a frequencyChanged() signal when the internal state changes due to this function call
[pure virtual]
void QIviAmFmTunerBackendInterface::startScan()
Starts a scan through all available stations. The scan will seek to the next available station and will stay there for some seconds until it seeks to the next station. It is expected that this function will inform about the current state of the backend by emitting the scanStatusChanged() signal.
See also stopScan() and scanStatusChanged().
[pure virtual]
void QIviAmFmTunerBackendInterface::stepDown()
Decreases the frequency by the current bands step size.
See also frequencyChanged and stationChanged.
[pure virtual]
void QIviAmFmTunerBackendInterface::stepUp()
Increases the frequency by the current bands step size.
See also frequencyChanged and stationChanged.
[pure virtual]
void QIviAmFmTunerBackendInterface::stopScan()
Stops the currently active scan. If no scan is active, this method does nothing. It is expected that this function will inform about the current state of the backend by emitting the scanStatusChanged() signal.
See also startScan() and scanStatusChanged().
© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.