diff options
author | Lars Knoll <lars.knoll@qt.io> | 2021-09-22 15:08:25 +0200 |
---|---|---|
committer | Lars Knoll <lars.knoll@qt.io> | 2021-09-23 08:59:06 +0200 |
commit | 02c7c590839a99d5ee9027757fca50104573c31d (patch) | |
tree | e7c4c8fee195b8855ffe4d569c709be4482fd6d2 | |
parent | 5e536e7fc5f85fa54d3b005125a3fe9bffe753c3 (diff) |
Fix the remaining qdoc warnings
Fix all qdoc warnings inside the Qt Multimedia module.
Change-Id: I4a581aa4f9fa9d96d58279884116ed10ca7bf837
Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io>
(cherry picked from commit baa34e18560d816c82d8779fbb40b1911ee0e164)
Reviewed-by: Lars Knoll <lars.knoll@qt.io>
19 files changed, 101 insertions, 121 deletions
diff --git a/examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc b/examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc index c37c37c1c..c96066687 100644 --- a/examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc +++ b/examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc @@ -49,8 +49,8 @@ The lists are populated using the following methods: \list \li \l{QMediaDevices::audioInputs()} - \li \l{QMediaFormat::supportedAudioCodecs()} - \li \l{QMediaFormat::supportedFileFormats()} + \li \l{QMediaFormat::supportedAudioCodecs} + \li \l{QMediaFormat::supportedFileFormats} \li \l{QAudioDevice::maximumSampleRate()} \li \l{QAudioDevice::minimumSampleRate()} \endlist diff --git a/examples/multimediawidgets/camera/doc/src/camera.qdoc b/examples/multimediawidgets/camera/doc/src/camera.qdoc index fd46f55b8..4db430fc3 100644 --- a/examples/multimediawidgets/camera/doc/src/camera.qdoc +++ b/examples/multimediawidgets/camera/doc/src/camera.qdoc @@ -66,7 +66,7 @@ passing in a \l QCameraDevice. functionality of the Camera class using signals and slots. It also instantiates and initializes the \l {QCamera}, \l {QImageCapture}, and \l {QMediaRecorder} objects mentioned above. The still and video recording visual tabs are enabled -and finally the \l {QCamera::start()}{start()} function of the \l{QCamera} +and finally the \l {QCamera::start}{start()} function of the \l{QCamera} object is called. Now that the camera is ready for user commands it waits for a suitable event. diff --git a/src/multimedia/audio/qaudio.cpp b/src/multimedia/audio/qaudio.cpp index f38ff0628..2898868a9 100644 --- a/src/multimedia/audio/qaudio.cpp +++ b/src/multimedia/audio/qaudio.cpp @@ -80,14 +80,6 @@ QT_BEGIN_NAMESPACE */ /*! - \enum QAudioDevice::Mode - - \value Output Audio output device - \value Input Audio input device - \omitvalue Null -*/ - -/*! \enum QAudio::VolumeScale This enum defines the different audio volume scales. diff --git a/src/multimedia/audio/qaudiodevice.cpp b/src/multimedia/audio/qaudiodevice.cpp index 651db9643..30a738cf2 100644 --- a/src/multimedia/audio/qaudiodevice.cpp +++ b/src/multimedia/audio/qaudiodevice.cpp @@ -324,7 +324,7 @@ QAudioDevice::QAudioDevice(QAudioDevicePrivate *p) {} /*! - \enum QAudioDevice::mode + \enum QAudioDevice::Mode Describes the mode of a QAudioDevice diff --git a/src/multimedia/audio/qaudioinput.cpp b/src/multimedia/audio/qaudioinput.cpp index ead7c3b07..1d0d68f0f 100644 --- a/src/multimedia/audio/qaudioinput.cpp +++ b/src/multimedia/audio/qaudioinput.cpp @@ -159,7 +159,7 @@ void QAudioInput::setMuted(bool muted) } /*! - \qmlproperty QtMultimedia::AudioInput::device + \qmlproperty AudioDevice QtMultimedia::AudioInput::device This property describes the audio device connected to this input. diff --git a/src/multimedia/audio/qaudiooutput.cpp b/src/multimedia/audio/qaudiooutput.cpp index ea3bb28bf..275050a51 100644 --- a/src/multimedia/audio/qaudiooutput.cpp +++ b/src/multimedia/audio/qaudiooutput.cpp @@ -183,7 +183,7 @@ void QAudioOutput::setMuted(bool muted) } /*! - \qmlproperty QtMultimedia::AudioOutput::device + \qmlproperty AudioDevice QtMultimedia::AudioOutput::device This property describes the audio device connected to this output. diff --git a/src/multimedia/camera/qcamera.cpp b/src/multimedia/camera/qcamera.cpp index bccec218d..cfd49b019 100644 --- a/src/multimedia/camera/qcamera.cpp +++ b/src/multimedia/camera/qcamera.cpp @@ -298,7 +298,7 @@ bool QCamera::isAvailable() const Describes whether the camera is currently active. */ -/*! \property bool QCamera::active +/*! \property QCamera::active Describes whether the camera is currently active. */ @@ -353,7 +353,7 @@ QString QCamera::errorString() const return d_func()->errorString; } -/*! \enum QCamera::Features +/*! \enum QCamera::Feature Describes a set of features supported by the camera. The returned value can be a combination of: @@ -365,9 +365,9 @@ QString QCamera::errorString() const \value IsoSensitivity The Camera supports setting a custom \l{isoSensitivity}. \value ManualExposureTime - The Camera supports setting a \l{manual exposure Time}{QCamera::manualExposureTime}. + The Camera supports setting a \l{QCamera::manualExposureTime}{manual exposure Time}. \value CustomFocusPoint - The Camera supports setting a \l{custom focus point}{QCamera::customFocusPoint}. + The Camera supports setting a \l{QCamera::customFocusPoint}{custom focus point}. \value FocusDistance The Camera supports setting the \l{focusDistance} property. */ @@ -376,13 +376,13 @@ QString QCamera::errorString() const \qmlproperty Features QtMultimedia::Camera::supportedFeatures Returns the features supported by this camera. - \sa QCamera::Features + \sa QCamera::Feature */ /*! Returns the features supported by this camera. - \sa QCamera::Features + \sa QCamera::Feature */ QCamera::Features QCamera::supportedFeatures() const { @@ -394,7 +394,7 @@ QCamera::Features QCamera::supportedFeatures() const Starts the camera. - Same as setActive(true). + Same as setting the active property to true. If the camera can't be started for some reason, the errorOccurred() signal is emitted. */ @@ -411,7 +411,7 @@ QCamera::Features QCamera::supportedFeatures() const /*! \qmlmethod void Camera::stop() Stops the camera. - Same as setActive(false). + Same as setting the active property to false. */ /*! \fn void QCamera::stop() @@ -468,8 +468,8 @@ QCameraDevice QCamera::cameraDevice() const /*! Connects the camera object to the physical camera device described by - \a device. Using a default constructed QCameraDevice object as \a device - will connect the camera to the system default camera device. + \a cameraDevice. Using a default constructed QCameraDevice object as + \a cameraDevice will connect the camera to the system default camera device. */ void QCamera::setCameraDevice(const QCameraDevice &cameraDevice) { @@ -562,7 +562,7 @@ void QCamera::setCameraFormat(const QCameraFormat &format) If a certain focus mode is not supported, setting it will have no effect. - \sa isFocusModeSupported() + \sa isFocusModeSupported */ /*! @@ -573,7 +573,7 @@ void QCamera::setCameraFormat(const QCameraFormat &format) Locking the focus is possible by setting the focus mode to \l FocusModeManual. This will keep the current focus and stop any automatic focusing. - \sa QCamera::isFocusModeSupported() + \sa isFocusModeSupported */ QCamera::FocusMode QCamera::focusMode() const { @@ -591,7 +591,7 @@ void QCamera::setFocusMode(QCamera::FocusMode mode) } /*! - \qmlproperty bool Camera::isFocusModeSupported(FocusMode mode) + \qmlmethod bool Camera::isFocusModeSupported(FocusMode mode) Returns true if the focus \a mode is supported by the camera. */ @@ -606,6 +606,11 @@ bool QCamera::isFocusModeSupported(FocusMode mode) const } /*! + \qmlproperty point QtMultimedia::Camera::focusPoint + Returns the point currently used by the auto focus system to focus onto. +*/ + +/*! Returns the point currently used by the auto focus system to focus onto. */ QPointF QCamera::focusPoint() const @@ -730,7 +735,7 @@ float QCamera::minimumZoomFactor() const } /*! - \qmlproperty QCamera::zoomFactor + \qmlproperty real QtMultimedia::Camera::zoomFactor Gets or sets the current zoom factor. Values will be clamped between \l minimumZoomFactor and \l maximumZoomFactor. @@ -808,7 +813,7 @@ void QCamera::zoomTo(float factor, float rate) Gets or sets a certain flash mode if the camera has a flash. - \sa QCamera::FlashMode, Camera::isFlashModeSupported(), Camera::isFlashReady() + \sa QCamera::FlashMode, Camera::isFlashModeSupported, Camera::isFlashReady */ /*! @@ -817,7 +822,7 @@ void QCamera::zoomTo(float factor, float rate) Enables a certain flash mode if the camera has a flash. - \sa QCamera::FlashMode, QCamera::isFlashModeSupported(), QCamera::isFlashReady() + \sa QCamera::FlashMode, QCamera::isFlashModeSupported, QCamera::isFlashReady */ QCamera::FlashMode QCamera::flashMode() const { @@ -833,7 +838,7 @@ void QCamera::setFlashMode(QCamera::FlashMode mode) } /*! - \qmlmethod QtMultimedia::Camera::isFlashModeSupported(FlashMode mode) + \qmlmethod bool QtMultimedia::Camera::isFlashModeSupported(FlashMode mode) Returns true if the flash \a mode is supported. */ @@ -882,7 +887,7 @@ bool QCamera::isFlashReady() const low light conditions. Enabling torch mode will usually override any currently set flash mode. - \sa QCamera::TorchMode, QCamera::isTorchModeSupported(), QCamera::flashMode + \sa QCamera::TorchMode, QCamera::isTorchModeSupported, QCamera::flashMode */ QCamera::TorchMode QCamera::torchMode() const { @@ -923,7 +928,7 @@ bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const \property QCamera::exposureMode \brief The exposure mode being used. - \sa QCamera::isExposureModeSupported() + \sa QCamera::isExposureModeSupported */ QCamera::ExposureMode QCamera::exposureMode() const { @@ -939,7 +944,7 @@ void QCamera::setExposureMode(QCamera::ExposureMode mode) } /*! - \qmlmethod bool QtMultimedia::Camera::isTorchModeSupported(ExposureMode mode) + \qmlmethod bool QtMultimedia::Camera::isExposureModeSupported(ExposureMode mode) Returns true if the exposure \a mode is supported. */ @@ -957,7 +962,7 @@ bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const } /*! - \qmlproperty QCamera::exposureCompensation + \qmlproperty real QCamera::exposureCompensation Gets or sets the exposure compensation in EV units. @@ -993,8 +998,12 @@ void QCamera::setExposureCompensation(float ev) */ /*! - \property int QCamera::manualIsoSensitivity - \brief Describes the ISO sensitivity currently used by the camera. + \property QCamera::isoSensitivity + \brief The sensor ISO sensitivity. + + Describes the ISO sensitivity currently used by the camera. + + \sa setAutoIsoSensitivity(), setManualIsoSensitivity() */ int QCamera::isoSensitivity() const { @@ -1012,7 +1021,7 @@ int QCamera::isoSensitivity() const */ /*! - \property int QCamera::manualIsoSensitivity + \property QCamera::manualIsoSensitivity \brief Describes a manually set ISO sensitivity Setting this property to -1 (the default), implies that the camera @@ -1102,13 +1111,6 @@ float QCamera::maximumExposureTime() const */ /*! - \property QCamera::isoSensitivity - \brief The sensor ISO sensitivity. - - \sa setAutoIsoSensitivity(), setManualIsoSensitivity() -*/ - -/*! Returns the current exposure time in seconds. */ @@ -1119,7 +1121,7 @@ float QCamera::exposureTime() const } /*! - \qmlproperty QtMultimedia::Camera::manualExposureTime + \qmlproperty real QtMultimedia::Camera::manualExposureTime Gets or sets a manual exposure time. @@ -1198,7 +1200,7 @@ void QCamera::setAutoExposureTime() */ /*! - \qmlproperty QtMultimedia::Camera::flashReady + \qmlproperty bool QtMultimedia::Camera::flashReady Indicates if the flash is charged and ready to use. */ @@ -1228,9 +1230,11 @@ void QCamera::setAutoExposureTime() /*! - \qmlproperty QtMultimedia::Camera::whiteBalanceMode + \qmlproperty WhiteBalanceMode QtMultimedia::Camera::whiteBalanceMode Gets or sets the white balance mode being used. + + \sa QCamera::WhiteBalanceMode */ /*! diff --git a/src/multimedia/camera/qcamera.h b/src/multimedia/camera/qcamera.h index 9bbbf453c..f9f107ec3 100644 --- a/src/multimedia/camera/qcamera.h +++ b/src/multimedia/camera/qcamera.h @@ -70,6 +70,7 @@ class Q_MULTIMEDIA_EXPORT QCamera : public QObject Q_PROPERTY(QCameraFormat cameraFormat READ cameraFormat WRITE setCameraFormat NOTIFY cameraFormatChanged) Q_PROPERTY(FocusMode focusMode READ focusMode WRITE setFocusMode) + Q_PROPERTY(QPointF focusPoint READ focusPoint NOTIFY focusPointChanged) Q_PROPERTY(QPointF customFocusPoint READ customFocusPoint WRITE setCustomFocusPoint NOTIFY customFocusPointChanged) Q_PROPERTY(float focusDistance READ focusDistance WRITE setFocusDistance NOTIFY focusDistanceChanged) @@ -268,6 +269,7 @@ Q_SIGNALS: void minimumZoomFactorChanged(float); void maximumZoomFactorChanged(float); void focusDistanceChanged(float); + void focusPointChanged(); void customFocusPointChanged(); void flashReady(bool); diff --git a/src/multimedia/camera/qcameradevice.cpp b/src/multimedia/camera/qcameradevice.cpp index eaab29fa5..b23cb9028 100644 --- a/src/multimedia/camera/qcameradevice.cpp +++ b/src/multimedia/camera/qcameradevice.cpp @@ -73,16 +73,16 @@ QT_BEGIN_NAMESPACE \ingroup multimedia_qml \ingroup multimedia_video_qml - CameraFormat represents a certain video format supported by a camera device. + cameraFormat represents a certain video format supported by a camera device. The format is a combination of a \l{pixel format}{QVideoFrameFormat::PixelFormat}, resolution and a range of frame rates. - CameraFormat objects can be queried from \l CameraDevice to inspect the set of + cameraFormat objects can be queried from \l cameraDevice to inspect the set of supported video formats. - \sa CameraDevice, Camera + \sa cameraDevice, Camera */ /*! @@ -107,6 +107,11 @@ QCameraFormat &QCameraFormat::operator=(const QCameraFormat &other) noexcept = d */ QCameraFormat::~QCameraFormat() = default; +/*! \fn bool QCameraFormat::isNull() const noexcept + + Returns true if this is a default constructed QCameraFormat. +*/ + /*! \qmlproperty enumeration QtMultimedia::CameraFormat::pixelFormat @@ -402,7 +407,7 @@ QCameraDevice::Position QCameraDevice::position() const Returns a list of resolutions that the camera can use to capture still images. - \sa QCameraImageCapture + \sa QImageCapture */ QList<QSize> QCameraDevice::photoResolutions() const { diff --git a/src/multimedia/doc/src/cameraoverview.qdoc b/src/multimedia/doc/src/cameraoverview.qdoc index c5f9048ff..8753d86e0 100644 --- a/src/multimedia/doc/src/cameraoverview.qdoc +++ b/src/multimedia/doc/src/cameraoverview.qdoc @@ -217,7 +217,7 @@ Thus, as the user rotates the device, the preview image will switch between port landscape mode. Once you start recording, the orientation will be locked. To avoid a poor user experience, you should also lock the orientation of the applications user interface while recording. This can be achieved using the -\l{contentOrientation}{QWindow::contentOrientation} property of QWindow. +\l{QWindow::contentOrientation}{contentOrientation} property of QWindow. \section2 Still Images @@ -261,11 +261,12 @@ For camera hardware that supports it, \l QCamera::FocusModeAutoNear allows imaging of things that are close to the sensor. This is useful in applications like bar-code recognition, or business card scanning. -In addition to focus, QCameraFocus allows you to control any available zoom -functionality using \l QCamera::setZoomFactor() or \l QCamera::zoomTo(). The +In addition to focus, QCamera allows you to control any available zoom +functionality using \l{QCamera::setZoomFactor}{setZoomFactor()} or +\l{QCamera::zoomTo}{zoomTo()}. The available zoom range might be limited or entirely fixed to unity (1:1). The -allowed range can be checked with \l QCamera::minimumZoomFactor() and -\l QCamera::minimumZoomFactor(). +allowed range can be checked with \l{QCamera::minimumZoomFactor}{minimumZoomFactor()} +and \l{QCamera::maximumZoomFactor}{maximumZoomFactor()}. \section3 Exposure, Shutter Speed and Flash diff --git a/src/multimedia/doc/src/multimedia-overview.qdoc b/src/multimedia/doc/src/multimedia-overview.qdoc index 84a7c2b69..bebb59ca1 100644 --- a/src/multimedia/doc/src/multimedia-overview.qdoc +++ b/src/multimedia/doc/src/multimedia-overview.qdoc @@ -114,7 +114,7 @@ For some quick recipes, see this table: \row \li Discovering audio and video devices \li \l{Audio Devices Example}{audiodevices} - \li \l{MediaDevices}, \l{AudioDevice}, \l{CameraDevice} + \li \l{MediaDevices}, \l{audioDevice}, \l{cameraDevice} \li QMediaDevices, QAudioDevice, QCameraDevice \row \li Video Playback diff --git a/src/multimedia/platform/qplatformvideosink.cpp b/src/multimedia/platform/qplatformvideosink.cpp index d3e5e24b2..66126745b 100644 --- a/src/multimedia/platform/qplatformvideosink.cpp +++ b/src/multimedia/platform/qplatformvideosink.cpp @@ -43,11 +43,10 @@ QT_BEGIN_NAMESPACE /*! \class QPlatformVideoSink - \obsolete + \internal \inmodule QtMultimedia - \ingroup multimedia_control \brief The QPlatformVideoSink class provides a media control for rendering video to a window. QPlatformVideoSink is one of a number of possible video output controls. diff --git a/src/multimedia/playback/qmediaplayer.cpp b/src/multimedia/playback/qmediaplayer.cpp index fdb486538..31d816e34 100644 --- a/src/multimedia/playback/qmediaplayer.cpp +++ b/src/multimedia/playback/qmediaplayer.cpp @@ -390,7 +390,7 @@ QMediaTimeRange QMediaPlayer::bufferedTimeRange() const */ /*! - \property bool QMediaPlayer::hasAudio + \property QMediaPlayer::hasAudio \brief This property holds whether the media contains audio. */ bool QMediaPlayer::hasAudio() const @@ -410,7 +410,7 @@ bool QMediaPlayer::hasAudio() const */ /*! - \property bool QMediaPlayer::hasVideo + \property QMediaPlayer::hasVideo \brief This property holds whether the media contains video. */ bool QMediaPlayer::hasVideo() const @@ -468,7 +468,7 @@ QMediaPlayer::Error QMediaPlayer::error() const */ /*! - \property string QtMultimedia::MediaPlayer::errorString + \property QMediaPlayer::errorString \brief This property holds a string describing the current error condition in more detail. */ @@ -673,7 +673,7 @@ QAudioOutput *QMediaPlayer::audioOutput() const Each index refers to an audio track. The metadata holds properties describing the individual tracks. For - audio tracks the \l{language}{MediaMetaData::Language} is usually the most + audio tracks the \l{MediaMetaData::Language}{language} is usually the most important property. \sa mediaMetaData @@ -723,7 +723,7 @@ QList<QMediaMetaData> QMediaPlayer::videoTracks() const Each index refers to a subtitle track. The metadata holds properties describing the individual tracks. For - subtitle tracks the \l{language}{MediaMetaData::Language} is usually the most + subtitle tracks the \l{MediaMetaData::Language}{language} is usually the most important property. \sa mediaMetaData @@ -942,9 +942,23 @@ bool QMediaPlayer::isAvailable() const } /*! + \qmlproperty mediaMetaData QtMultimedia::MediaPlayer::metaData + Returns meta data for the current media used by the media player. - Meta data can contain information such as the title of the video or it's creation date. + Meta data can contain information such as the title of the video or its creation date. + + \note The Windows implementation provides metadata only for media located on the local file + system. +*/ + +/*! + Returns meta data for the current media used by the media player. + + Meta data can contain information such as the title of the video or its creation date. + + \note The Windows implementation provides metadata only for media located on the local file + system. */ QMediaMetaData QMediaPlayer::metaData() const { @@ -1219,26 +1233,6 @@ QMediaMetaData QMediaPlayer::metaData() const */ /*! - \property QMediaPlayer::hasAudio - \brief the audio availabilty status for the current media. - - \note As the life time of QMediaPlayer can be longer than the playback of - one QUrl, this property may change over time. -*/ - -/*! - \property QMediaPlayer::hasVideo - \brief the video availability status for the current media. - - If available, the QVideoWidget class can be used to view the video. - - \note As the life time of QMediaPlayer can be longer than the playback of - one QUrl, this property may change over time. - - \sa QVideoWidget, QUrl -*/ - -/*! \qmlproperty bool QtMultimedia::MediaPlayer::seekable This property holds whether the \l position of the media can be changed. diff --git a/src/multimedia/qmediaformat.cpp b/src/multimedia/qmediaformat.cpp index 49e9fda47..aca22205a 100644 --- a/src/multimedia/qmediaformat.cpp +++ b/src/multimedia/qmediaformat.cpp @@ -279,7 +279,7 @@ QT_DEFINE_QESDP_SPECIALIZATION_DTOR(QMediaFormatPrivate); \omitvalue LastAudioCodec */ -/*! \qmlproperty enumeration QMediaFormat::audioCodec +/*! \qmlproperty enumeration QtMultimedia::mediaFormat::audioCodec Describes the audio codec used in multimedia file or stream. It can take one of the following values: @@ -346,7 +346,7 @@ QT_DEFINE_QESDP_SPECIALIZATION_DTOR(QMediaFormatPrivate); \omitvalue LastVideoCodec */ -/*! \qmlproperty QtMultimedia::mediaFormat::videoCodec +/*! \qmlproperty enumeration QtMultimedia::mediaFormat::videoCodec Describes the video codec used in multimedia file or stream. It can take one of the following values: @@ -417,11 +417,6 @@ QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other) noexcept = defa */ // Properties -/*! \qmlproperty QtMultimedia::mediaFormat::fileFormat - - The file (container) format of the media. -*/ - /*! \property QMediaFormat::fileFormat \brief The file (container) format of the media. @@ -429,11 +424,6 @@ QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other) noexcept = defa \sa QMediaFormat::FileFormat */ -/*! \qmlproperty QtMultimedia::mediaFormat::audioCodec - - The audio codec of the media. -*/ - /*! \property QMediaFormat::audioCodec \brief The audio codec of the media. @@ -441,11 +431,6 @@ QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other) noexcept = defa \sa QMediaFormat::AudioCodec */ -/*! \qmlproperty QtMultimedia::mediaFormat::videoCodec - - The video codec of the media. -*/ - /*! \property QMediaFormat::videoCodec \brief The video codec of the media. @@ -669,7 +654,7 @@ QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec) /*! Returns a string based name for \a codec. */ -QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec c) +QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec) { constexpr const char *descriptions[] = { "Invalid", @@ -685,7 +670,7 @@ QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec c) "WMV", "MotionJPEG" }; - return QString::fromUtf8(descriptions[int(c) + 1]); + return QString::fromUtf8(descriptions[int(codec) + 1]); } /*! diff --git a/src/multimedia/qmediametadata.cpp b/src/multimedia/qmediametadata.cpp index 3e9ba578f..5d0edf747 100644 --- a/src/multimedia/qmediametadata.cpp +++ b/src/multimedia/qmediametadata.cpp @@ -216,16 +216,16 @@ QT_BEGIN_NAMESPACE */ /*! - \qmlmethod variant QtMultimedia::mediaMetaData::value(QMediaMetaData::Key key) + \qmlmethod variant QtMultimedia::mediaMetaData::value(Key key) Returns the meta data value for Key \a key, or a null QVariant if no meta-data for the key is available. */ /*! - \fn variant QMediaMetaData::value(QMediaMetaData::Key key) const + \fn QVariant QMediaMetaData::value(QMediaMetaData::Key key) const - Returns the meta data value for Key \a key, or a null QVariant is not + Returns the meta data value for Key \a key, or a null QVariant if no meta data for the key is available. */ diff --git a/src/multimedia/recording/qmediacapturesession.cpp b/src/multimedia/recording/qmediacapturesession.cpp index 18f5d1e9c..55b223d90 100644 --- a/src/multimedia/recording/qmediacapturesession.cpp +++ b/src/multimedia/recording/qmediacapturesession.cpp @@ -146,7 +146,7 @@ public: } \endqml - \sa Camera, MediaDevice, MediaRecorder, ImageCapture, AudioInput, VideoOutput + \sa Camera, MediaDevices, MediaRecorder, ImageCapture, AudioInput, VideoOutput */ /*! @@ -181,8 +181,7 @@ QMediaCaptureSession::~QMediaCaptureSession() /*! \qmlproperty AudioInput QtMultimedia::CaptureSession::audioInput - This property holds the audio input that is being used to capture audio.. - \sa setAudioInput() + This property holds the audio input that is being used to capture audio. */ /*! @@ -194,16 +193,16 @@ QAudioInput *QMediaCaptureSession::audioInput() const } /*! - Sets the audio input device to \a device. If setting it to an empty + Sets the audio input device to \a input. If setting it to an empty QAudioDevice the capture session will use the default input as defined by the operating system. */ -void QMediaCaptureSession::setAudioInput(QAudioInput *device) +void QMediaCaptureSession::setAudioInput(QAudioInput *input) { - if (d_ptr->audioInput == device) + if (d_ptr->audioInput == input) return; - d_ptr->audioInput = device; - d_ptr->captureSession->setAudioInput(device ? device->handle() : nullptr); + d_ptr->audioInput = input; + d_ptr->captureSession->setAudioInput(input ? input->handle() : nullptr); emit audioInputChanged(); } diff --git a/src/multimedia/recording/qmediacapturesession.h b/src/multimedia/recording/qmediacapturesession.h index 5ae152d8e..5941ccaf1 100644 --- a/src/multimedia/recording/qmediacapturesession.h +++ b/src/multimedia/recording/qmediacapturesession.h @@ -69,7 +69,7 @@ public: ~QMediaCaptureSession(); QAudioInput *audioInput() const; - void setAudioInput(QAudioInput *device); + void setAudioInput(QAudioInput *input); QCamera *camera() const; void setCamera(QCamera *camera); diff --git a/src/multimediaquick/qquickimagecapture.cpp b/src/multimediaquick/qquickimagecapture.cpp index 7a9771fb6..87f5b15a8 100644 --- a/src/multimediaquick/qquickimagecapture.cpp +++ b/src/multimediaquick/qquickimagecapture.cpp @@ -145,7 +145,7 @@ QQuickImageCapture::~QQuickImageCapture() = default; capture() returns the capture requestId parameter, used with imageExposed(), imageCaptured(), imageMetadataAvailable() and imageSaved() signals. - \sa ready, preview + \sa readyForCapture, preview */ /*! @@ -183,9 +183,10 @@ void QQuickImageCapture::_q_imageCaptured(int id, const QImage &preview) } /*! - \qmlsignal QtMultimedia::ImageCapture::errorOccurred(requestId, Error, message) + \qmlsignal QtMultimedia::ImageCapture::errorOccurred(requestId, error, message) This signal is emitted when an error occurs during capture with \a requestId. + \a error is an enumeration of type ImageCapture::Error. A descriptive message is available in \a message. */ diff --git a/src/multimediaquick/qquickvideooutput.cpp b/src/multimediaquick/qquickvideooutput.cpp index 6cef7027a..fd0b77205 100644 --- a/src/multimediaquick/qquickvideooutput.cpp +++ b/src/multimediaquick/qquickvideooutput.cpp @@ -267,8 +267,6 @@ void QQuickVideoOutput::_q_updateGeometry() The orientation change will also affect the mapping of coordinates from source to viewport. - - \sa autoOrientation */ int QQuickVideoOutput::orientation() const { |