QIfAmFmTunerBackendInterface Class

The QIfAmFmTunerBackendInterface defines the interface for backends to the QIfAmFmTuner feature class. More...

Header: #include <QIfAmFmTunerBackendInterface>
qmake: QT += ifmedia
Inherits: QIfFeatureInterface

Public Functions

QIfAmFmTunerBackendInterface(QObject *parent = nullptr)
virtual void seekDown() = 0
virtual void seekUp() = 0
virtual void setBand(QIfAmFmTuner::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(QIfAmFmTuner::Band band)
void frequencyChanged(int frequency)
void maximumFrequencyChanged(int maximumFrequency)
void minimumFrequencyChanged(int minimumFrequency)
void scanStatusChanged(bool scanRunning)
void stationChanged(const QIfAmFmTunerStation &station)
void stepSizeChanged(int stepSize)

Detailed Description

The QIfAmFmTunerBackendInterface is the interface used by QIfAmFmTuner

The interface is discovered by a QIfAmFmTuner object, which connects to it and sets it up.

<example of a fully featured backend>

Member Function Documentation

QIfAmFmTunerBackendInterface::QIfAmFmTunerBackendInterface(QObject *parent = nullptr)

Constructs a backend interface.

The parent is sent to the QObject constructor.

[signal] void QIfAmFmTunerBackendInterface::bandChanged(QIfAmFmTuner::Band band)

Emitted when the current band changed. The new value is passed as band.

See also minimumFrequencyChanged(), maximumFrequencyChanged(), and stepSizeChanged().

[signal] void QIfAmFmTunerBackendInterface::frequencyChanged(int frequency)

Emitted when the current frequency changed. The new value is passed as frequency.

[signal] void QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::stationChanged(const QIfAmFmTunerStation &station)

Emitted when the current station changed. The new station is passed as station.

[signal] void QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::setBand(QIfAmFmTuner::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::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 QIfAmFmTunerBackendInterface::stepDown()

Decreases the frequency by the current bands step size.

See also frequencyChanged and stationChanged.

[pure virtual] void QIfAmFmTunerBackendInterface::stepUp()

Increases the frequency by the current bands step size.

See also frequencyChanged and stationChanged.

[pure virtual] void QIfAmFmTunerBackendInterface::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().

© 2021 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.