diff options
author | Michael Goddard <michael.goddard@nokia.com> | 2012-06-25 10:53:26 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-06-29 02:47:41 +0200 |
commit | b0809c027c9fe2e49d37dff45aa4f03b0a4e0743 (patch) | |
tree | d647951ecb69c9b39f004198d76fbc4972174549 /src/multimedia | |
parent | bba28afe559837321a2083b3ce046ab774a7ef6b (diff) |
Rename availabilityError to availability.
It's perhaps clearer in the usual case.
Change-Id: Id3cef82ac83f8c9b538b3315281664ce1c6a2b96
Reviewed-by: Ling Hu <ling.hu@nokia.com>
Diffstat (limited to 'src/multimedia')
-rw-r--r-- | src/multimedia/camera/qcamera.cpp | 6 | ||||
-rw-r--r-- | src/multimedia/camera/qcamera.h | 2 | ||||
-rw-r--r-- | src/multimedia/camera/qcameraimagecapture.cpp | 8 | ||||
-rw-r--r-- | src/multimedia/camera/qcameraimagecapture.h | 2 | ||||
-rw-r--r-- | src/multimedia/controls/qmediaavailabilitycontrol.cpp | 4 | ||||
-rw-r--r-- | src/multimedia/controls/qmediaavailabilitycontrol.h | 4 | ||||
-rw-r--r-- | src/multimedia/playback/qmediaplayer.cpp | 8 | ||||
-rw-r--r-- | src/multimedia/playback/qmediaplayer.h | 2 | ||||
-rw-r--r-- | src/multimedia/qmediaobject.cpp | 27 | ||||
-rw-r--r-- | src/multimedia/qmediaobject.h | 4 | ||||
-rw-r--r-- | src/multimedia/qtmedianamespace.cpp | 4 | ||||
-rw-r--r-- | src/multimedia/qtmedianamespace.h | 10 | ||||
-rw-r--r-- | src/multimedia/radio/qradiodata.cpp | 12 | ||||
-rw-r--r-- | src/multimedia/radio/qradiodata.h | 2 | ||||
-rw-r--r-- | src/multimedia/radio/qradiotuner.cpp | 6 | ||||
-rw-r--r-- | src/multimedia/radio/qradiotuner.h | 2 | ||||
-rw-r--r-- | src/multimedia/recording/qmediarecorder.cpp | 28 | ||||
-rw-r--r-- | src/multimedia/recording/qmediarecorder.h | 6 | ||||
-rw-r--r-- | src/multimedia/recording/qmediarecorder_p.h | 2 |
19 files changed, 72 insertions, 67 deletions
diff --git a/src/multimedia/camera/qcamera.cpp b/src/multimedia/camera/qcamera.cpp index 063e28093..3d081d909 100644 --- a/src/multimedia/camera/qcamera.cpp +++ b/src/multimedia/camera/qcamera.cpp @@ -412,11 +412,11 @@ QCamera::~QCamera() /*! Returns the availability state of the camera service. */ -QtMultimedia::AvailabilityError QCamera::availabilityError() const +QtMultimedia::AvailabilityStatus QCamera::availability() const { Q_D(const QCamera); if (d->control == NULL) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; if (d->deviceControl && d->deviceControl->deviceCount() == 0) return QtMultimedia::ResourceError; @@ -424,7 +424,7 @@ QtMultimedia::AvailabilityError QCamera::availabilityError() const if (d->error != QCamera::NoError) return QtMultimedia::ResourceError; - return QMediaObject::availabilityError(); + return QMediaObject::availability(); } diff --git a/src/multimedia/camera/qcamera.h b/src/multimedia/camera/qcamera.h index 851521d4e..7fc52269e 100644 --- a/src/multimedia/camera/qcamera.h +++ b/src/multimedia/camera/qcamera.h @@ -152,7 +152,7 @@ public: static QList<QByteArray> availableDevices(); static QString deviceDescription(const QByteArray &device); - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; State state() const; Status status() const; diff --git a/src/multimedia/camera/qcameraimagecapture.cpp b/src/multimedia/camera/qcameraimagecapture.cpp index 4b86fb301..4bf247294 100644 --- a/src/multimedia/camera/qcameraimagecapture.cpp +++ b/src/multimedia/camera/qcameraimagecapture.cpp @@ -312,14 +312,14 @@ bool QCameraImageCapture::isAvailable() const } /*! - Returns the availability error code. + Returns the availability of this functionality. */ -QtMultimedia::AvailabilityError QCameraImageCapture::availabilityError() const +QtMultimedia::AvailabilityStatus QCameraImageCapture::availability() const { if (d_func()->control != NULL) - return QtMultimedia::NoError; + return QtMultimedia::Available; else - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; } /*! diff --git a/src/multimedia/camera/qcameraimagecapture.h b/src/multimedia/camera/qcameraimagecapture.h index f050d5206..1d1fa2e9c 100644 --- a/src/multimedia/camera/qcameraimagecapture.h +++ b/src/multimedia/camera/qcameraimagecapture.h @@ -97,7 +97,7 @@ public: ~QCameraImageCapture(); bool isAvailable() const; - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; QMediaObject *mediaObject() const; diff --git a/src/multimedia/controls/qmediaavailabilitycontrol.cpp b/src/multimedia/controls/qmediaavailabilitycontrol.cpp index 1610b0872..8c86ee755 100644 --- a/src/multimedia/controls/qmediaavailabilitycontrol.cpp +++ b/src/multimedia/controls/qmediaavailabilitycontrol.cpp @@ -90,7 +90,7 @@ QMediaAvailabilityControl::~QMediaAvailabilityControl() /*! - \fn QtMultimedia::AvailabilityError QMediaAvailabilityControl::availability() const + \fn QtMultimedia::AvailabilityStatus QMediaAvailabilityControl::availability() const Returns the current availability of this instance of the media service. If the availability changes at run time (for example, some other media @@ -100,7 +100,7 @@ QMediaAvailabilityControl::~QMediaAvailabilityControl() /*! - \fn void QMediaAvailabilityControl::availabilityChanged(QtMultimedia::AvailabilityError availability) + \fn void QMediaAvailabilityControl::availabilityChanged(QtMultimedia::AvailabilityStatus availability) Signal emitted when the current \a availability value changed. */ diff --git a/src/multimedia/controls/qmediaavailabilitycontrol.h b/src/multimedia/controls/qmediaavailabilitycontrol.h index 16f46f0f0..7117d2a2f 100644 --- a/src/multimedia/controls/qmediaavailabilitycontrol.h +++ b/src/multimedia/controls/qmediaavailabilitycontrol.h @@ -62,10 +62,10 @@ class Q_MULTIMEDIA_EXPORT QMediaAvailabilityControl : public QMediaControl public: ~QMediaAvailabilityControl(); - virtual QtMultimedia::AvailabilityError availability() const = 0; + virtual QtMultimedia::AvailabilityStatus availability() const = 0; signals: - void availabilityChanged(QtMultimedia::AvailabilityError availability); + void availabilityChanged(QtMultimedia::AvailabilityStatus availability); protected: QMediaAvailabilityControl(QObject* parent = 0); diff --git a/src/multimedia/playback/qmediaplayer.cpp b/src/multimedia/playback/qmediaplayer.cpp index 067893ef1..2d4247997 100644 --- a/src/multimedia/playback/qmediaplayer.cpp +++ b/src/multimedia/playback/qmediaplayer.cpp @@ -84,7 +84,7 @@ QT_BEGIN_NAMESPACE \list \li Accessing the currently playing media's metadata (\l {QMediaObject::metaData()} and \l {QtMultimedia::MetaData}{predefined meta-data keys}) - \li Checking to see if the media playback service is currently available (\l {QMediaObject::availabilityError()}) + \li Checking to see if the media playback service is currently available (\l {QMediaObject::availability()}) \endlist \sa QMediaObject, QMediaService, QVideoWidget, QMediaPlaylist @@ -1013,14 +1013,14 @@ void QMediaPlayer::setVideoOutput(QAbstractVideoSurface *surface) } /*! \reimp */ -QtMultimedia::AvailabilityError QMediaPlayer::availabilityError() const +QtMultimedia::AvailabilityStatus QMediaPlayer::availability() const { Q_D(const QMediaPlayer); if (!d->control) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; - return QMediaObject::availabilityError(); + return QMediaObject::availability(); } diff --git a/src/multimedia/playback/qmediaplayer.h b/src/multimedia/playback/qmediaplayer.h index b6d154bc2..f8004713f 100644 --- a/src/multimedia/playback/qmediaplayer.h +++ b/src/multimedia/playback/qmediaplayer.h @@ -161,7 +161,7 @@ public: QNetworkConfiguration currentNetworkConfiguration() const; - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; public Q_SLOTS: void play(); diff --git a/src/multimedia/qmediaobject.cpp b/src/multimedia/qmediaobject.cpp index e9a620bb8..e0da94e5b 100644 --- a/src/multimedia/qmediaobject.cpp +++ b/src/multimedia/qmediaobject.cpp @@ -71,8 +71,8 @@ void QMediaObjectPrivate::_q_availabilityChanged() // Really this should not always emit, but // we can't really tell from here (isAvailable // may not have changed, or the mediaobject's overridden - // availabilityError() may not have changed). - q->availabilityErrorChanged(q->availabilityError()); + // availability() may not have changed). + q->availabilityChanged(q->availability()); q->availabilityChanged(q->isAvailable()); } @@ -113,18 +113,23 @@ QMediaObject::~QMediaObject() } /*! - Returns the service availability error state. + Returns the availability of the functionality offered by this object. + + In some cases the functionality may not be available (for example, if + the current operating system or platform does not provide the required + functionality), or it may be temporarily unavailable (for example, + audio playback during a phone call or similar). */ -QtMultimedia::AvailabilityError QMediaObject::availabilityError() const +QtMultimedia::AvailabilityStatus QMediaObject::availability() const { if (d_func()->service == 0) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; if (d_func()->availabilityControl) return d_func()->availabilityControl->availability(); - return QtMultimedia::NoError; + return QtMultimedia::Available; } /*! @@ -133,7 +138,7 @@ QtMultimedia::AvailabilityError QMediaObject::availabilityError() const bool QMediaObject::isAvailable() const { - return availabilityError() == QtMultimedia::NoError; + return availability() == QtMultimedia::Available; } /*! @@ -403,7 +408,7 @@ void QMediaObject::setupControls() d->availabilityControl = d->service->requestControl<QMediaAvailabilityControl*>(); if (d->availabilityControl) { connect(d->availabilityControl, - SIGNAL(availabilityChanged(QtMultimedia::AvailabilityError)), + SIGNAL(availabilityChanged(QtMultimedia::AvailabilityStatus)), SLOT(_q_availabilityChanged())); } } @@ -412,13 +417,13 @@ void QMediaObject::setupControls() /*! \fn QMediaObject::availabilityChanged(bool available) - Signal emitted when the availability state has changed to \a available + Signal emitted when the availability state has changed to \a available. */ /*! - \fn QMediaObject::availabilityErrorChanged(QtMultimedia::AvailabilityError error) + \fn QMediaObject::availabilityChanged(QtMultimedia::AvailabilityStatus availability) - Signal emitted when the availability error has changed to \a error + Signal emitted when the availability of the service has changed to \a availabilty */ diff --git a/src/multimedia/qmediaobject.h b/src/multimedia/qmediaobject.h index 3c67dd69f..e2b35177c 100644 --- a/src/multimedia/qmediaobject.h +++ b/src/multimedia/qmediaobject.h @@ -67,7 +67,7 @@ public: ~QMediaObject(); virtual bool isAvailable() const; - virtual QtMultimedia::AvailabilityError availabilityError() const; + virtual QtMultimedia::AvailabilityStatus availability() const; virtual QMediaService* service() const; @@ -90,7 +90,7 @@ Q_SIGNALS: void metaDataChanged(const QString &key, const QVariant &value); void availabilityChanged(bool available); - void availabilityErrorChanged(QtMultimedia::AvailabilityError error); + void availabilityChanged(QtMultimedia::AvailabilityStatus availability); protected: QMediaObject(QObject *parent, QMediaService *service); diff --git a/src/multimedia/qtmedianamespace.cpp b/src/multimedia/qtmedianamespace.cpp index 2c4afdf18..94c2dbf0c 100644 --- a/src/multimedia/qtmedianamespace.cpp +++ b/src/multimedia/qtmedianamespace.cpp @@ -49,7 +49,7 @@ namespace public: QMultimediaNamespacePrivateRegisterMetaTypes() { - qRegisterMetaType<QtMultimedia::AvailabilityError>(); + qRegisterMetaType<QtMultimedia::AvailabilityStatus>(); qRegisterMetaType<QtMultimedia::SupportEstimate>(); qRegisterMetaType<QtMultimedia::EncodingMode>(); qRegisterMetaType<QtMultimedia::EncodingQuality>(); @@ -400,7 +400,7 @@ Q_DEFINE_METADATA(ThumbnailImage); */ /*! - \enum QtMultimedia::AvailabilityError + \enum QtMultimedia::AvailabilityStatus Enumerates Service status errors. diff --git a/src/multimedia/qtmedianamespace.h b/src/multimedia/qtmedianamespace.h index 2f0f423b3..5e6bb3ff5 100644 --- a/src/multimedia/qtmedianamespace.h +++ b/src/multimedia/qtmedianamespace.h @@ -314,11 +314,11 @@ namespace QtMultimedia TwoPassEncoding }; - enum AvailabilityError + enum AvailabilityStatus { - NoError, - ServiceMissingError, - BusyError, + Available, + ServiceMissing, + Busy, ResourceError }; @@ -328,7 +328,7 @@ namespace QtMultimedia QT_END_NAMESPACE -Q_DECLARE_METATYPE(QtMultimedia::AvailabilityError) +Q_DECLARE_METATYPE(QtMultimedia::AvailabilityStatus) Q_DECLARE_METATYPE(QtMultimedia::SupportEstimate) Q_DECLARE_METATYPE(QtMultimedia::EncodingMode) Q_DECLARE_METATYPE(QtMultimedia::EncodingQuality) diff --git a/src/multimedia/radio/qradiodata.cpp b/src/multimedia/radio/qradiodata.cpp index 1aa39647d..a2f396420 100644 --- a/src/multimedia/radio/qradiodata.cpp +++ b/src/multimedia/radio/qradiodata.cpp @@ -227,18 +227,18 @@ bool QRadioData::setMediaObject(QMediaObject *mediaObject) /*! Returns the availability of the radio data service. - A long as there is a media service which provides control, then the - \l{QtMultimedia::AvailabilityError}{availability error} will be that - of the \l{QRadioTuner::availabilityError()}{radio tuner}. + A long as there is a media service which provides radio functionality, then the + \l{QtMultimedia::AvailabilityStatus}{availability} will be that + of the \l{QRadioTuner::availability()}{radio tuner}. */ -QtMultimedia::AvailabilityError QRadioData::availabilityError() const +QtMultimedia::AvailabilityStatus QRadioData::availability() const { Q_D(const QRadioData); if (d->control == 0) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; - return d->mediaObject->availabilityError(); + return d->mediaObject->availability(); } /*! diff --git a/src/multimedia/radio/qradiodata.h b/src/multimedia/radio/qradiodata.h index 6e282f3ee..5d409f8dd 100644 --- a/src/multimedia/radio/qradiodata.h +++ b/src/multimedia/radio/qradiodata.h @@ -91,7 +91,7 @@ public: QRadioData(QMediaObject *mediaObject, QObject *parent = 0); ~QRadioData(); - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; QMediaObject *mediaObject() const; diff --git a/src/multimedia/radio/qradiotuner.cpp b/src/multimedia/radio/qradiotuner.cpp index f5dad4473..722419aa9 100644 --- a/src/multimedia/radio/qradiotuner.cpp +++ b/src/multimedia/radio/qradiotuner.cpp @@ -159,15 +159,15 @@ QRadioTuner::~QRadioTuner() /*! Returns the availability of the radio tuner. */ -QtMultimedia::AvailabilityError QRadioTuner::availabilityError() const +QtMultimedia::AvailabilityStatus QRadioTuner::availability() const { if (d_func()->control == 0) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; if (!d_func()->control->isAntennaConnected()) return QtMultimedia::ResourceError; - return QMediaObject::availabilityError(); + return QMediaObject::availability(); } /*! diff --git a/src/multimedia/radio/qradiotuner.h b/src/multimedia/radio/qradiotuner.h index 8f11321cf..dbec6d849 100644 --- a/src/multimedia/radio/qradiotuner.h +++ b/src/multimedia/radio/qradiotuner.h @@ -87,7 +87,7 @@ public: QRadioTuner(QObject *parent = 0); ~QRadioTuner(); - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; State state() const; diff --git a/src/multimedia/recording/qmediarecorder.cpp b/src/multimedia/recording/qmediarecorder.cpp index 08df4f968..12279c4bd 100644 --- a/src/multimedia/recording/qmediarecorder.cpp +++ b/src/multimedia/recording/qmediarecorder.cpp @@ -185,7 +185,7 @@ void QMediaRecorderPrivate::_q_applySettings() } } -void QMediaRecorderPrivate::_q_availabilityChanged(QtMultimedia::AvailabilityError error) +void QMediaRecorderPrivate::_q_availabilityChanged(QtMultimedia::AvailabilityStatus availability) { Q_Q(QMediaRecorder); Q_UNUSED(error); @@ -193,8 +193,8 @@ void QMediaRecorderPrivate::_q_availabilityChanged(QtMultimedia::AvailabilityErr // Really this should not always emit, but // we can't really tell from here (isAvailable // may not have changed, or the mediaobject's overridden - // availabilityError() may not have changed). - q->availabilityErrorChanged(q->availabilityError()); + // availability() may not have changed). + q->availabilityChanged(q->availability()); q->availabilityChanged(q->isAvailable()); } @@ -323,8 +323,8 @@ bool QMediaRecorder::setMediaObject(QMediaObject *object) service->releaseControl(d->metaDataControl); } if (d->availabilityControl) { - disconnect(d->availabilityControl, SIGNAL(availabilityChanged(QtMultimedia::AvailabilityError)), - this, SLOT(_q_availabilityChanged(QtMultimedia::AvailabilityError))); + disconnect(d->availabilityControl, SIGNAL(availabilityChanged(QtMultimedia::AvailabilityStatus)), + this, SLOT(_q_availabilityChanged(QtMultimedia::AvailabilityStatus))); service->releaseControl(d->availabilityControl); } } @@ -375,8 +375,8 @@ bool QMediaRecorder::setMediaObject(QMediaObject *object) d->availabilityControl = service->requestControl<QMediaAvailabilityControl*>(); if (d->availabilityControl) { - connect(d->availabilityControl, SIGNAL(availabilityChanged(QtMultimedia::AvailabilityError)), - this, SLOT(_q_availabilityChanged(QtMultimedia::AvailabilityError))); + connect(d->availabilityControl, SIGNAL(availabilityChanged(QtMultimedia::AvailabilityStatus)), + this, SLOT(_q_availabilityChanged(QtMultimedia::AvailabilityStatus))); } connect(d->control, SIGNAL(stateChanged(QMediaRecorder::State)), @@ -442,23 +442,23 @@ bool QMediaRecorder::setMediaObject(QMediaObject *object) */ bool QMediaRecorder::isAvailable() const { - return availabilityError() == QtMultimedia::NoError; + return availability() == QtMultimedia::Available; } /*! - Returns the availability error code. + Returns the availability of this functionality. - \sa availabilityErrorChanged() + \sa availabilityChanged() */ -QtMultimedia::AvailabilityError QMediaRecorder::availabilityError() const +QtMultimedia::AvailabilityStatus QMediaRecorder::availability() const { if (d_func()->control == NULL) - return QtMultimedia::ServiceMissingError; + return QtMultimedia::ServiceMissing; if (d_func()->availabilityControl) return d_func()->availabilityControl->availability(); - return QtMultimedia::NoError; + return QtMultimedia::Available; } QUrl QMediaRecorder::outputLocation() const @@ -960,7 +960,7 @@ void QMediaRecorder::stop() */ /*! - \fn QMediaRecorder::availabilityErrorChanged(QtMultimedia::AvailabilityError availability) + \fn QMediaRecorder::availabilityChanged(QtMultimedia::AvailabilityStatus availability) Signals that the service availability has changed to \a availability. */ diff --git a/src/multimedia/recording/qmediarecorder.h b/src/multimedia/recording/qmediarecorder.h index 3f8c4a5ef..3363811ad 100644 --- a/src/multimedia/recording/qmediarecorder.h +++ b/src/multimedia/recording/qmediarecorder.h @@ -117,7 +117,7 @@ public: QMediaObject *mediaObject() const; bool isAvailable() const; - QtMultimedia::AvailabilityError availabilityError() const; + QtMultimedia::AvailabilityStatus availability() const; QUrl outputLocation() const; bool setOutputLocation(const QUrl &location); @@ -192,7 +192,7 @@ Q_SIGNALS: void metaDataChanged(const QString &key, const QVariant &value); void availabilityChanged(bool available); - void availabilityErrorChanged(QtMultimedia::AvailabilityError error); + void availabilityChanged(QtMultimedia::AvailabilityStatus availability); protected: QMediaRecorder(QMediaRecorderPrivate &dd, QMediaObject *mediaObject, QObject *parent = 0); @@ -209,7 +209,7 @@ private: Q_PRIVATE_SLOT(d_func(), void _q_updateActualLocation(const QUrl &)) Q_PRIVATE_SLOT(d_func(), void _q_updateNotifyInterval(int)) Q_PRIVATE_SLOT(d_func(), void _q_applySettings()) - Q_PRIVATE_SLOT(d_func(), void _q_availabilityChanged(QtMultimedia::AvailabilityError)) + Q_PRIVATE_SLOT(d_func(), void _q_availabilityChanged(QtMultimedia::AvailabilityStatus)) }; QT_END_NAMESPACE diff --git a/src/multimedia/recording/qmediarecorder_p.h b/src/multimedia/recording/qmediarecorder_p.h index 56922c4b8..744afe647 100644 --- a/src/multimedia/recording/qmediarecorder_p.h +++ b/src/multimedia/recording/qmediarecorder_p.h @@ -92,7 +92,7 @@ public: void _q_notify(); void _q_updateNotifyInterval(int ms); void _q_applySettings(); - void _q_availabilityChanged(QtMultimedia::AvailabilityError error); + void _q_availabilityChanged(QtMultimedia::AvailabilityStatus availability); QMediaRecorder *q_ptr; }; |