diff options
68 files changed, 476 insertions, 318 deletions
diff --git a/doc/config/qtmultimedia_doc.pri b/doc/config/qtmultimedia_doc.pri index 92fd45e13..8aab32310 100644 --- a/doc/config/qtmultimedia_doc.pri +++ b/doc/config/qtmultimedia_doc.pri @@ -7,7 +7,15 @@ win32:!win32-g++ { unixstyle = true } -QDOC = $$QT.core.bins/qdoc3 +system(which qdoc) { + QDOC = qdoc +} else { + exists($$QT.core.bins/qdoc3) { + QDOC = $$QT.core.bins/qdoc3 + } else { + warning("No qdoc executable found.") + } +} ONLINE_CONF = $$PWD/qtmultimedia.qdocconf DITA_CONF = $$PWD/qtmultimedia-dita.qdocconf diff --git a/doc/src/audiooverview.qdoc b/doc/src/audiooverview.qdoc index 902e3db99..378447692 100644 --- a/doc/src/audiooverview.qdoc +++ b/doc/src/audiooverview.qdoc @@ -34,7 +34,7 @@ Qt Multimedia offers a range of audio classes, covering both low and high level approaches to audio input, output and processing. In -addition to traditional audio usage, the \l {QtAudioEngine}{Qt AudioEngine} +addition to traditional audio usage, the \l {QtAudioEngine Overview}{Qt AudioEngine} QML classes offers high level 3D positional audio for QML applications. See that documentation for more information. @@ -73,7 +73,7 @@ sounds. These classes allow you to specify a WAV format file which can then be played with low latency when necessary. Both QSoundEffect and the SoundEffect element have essentially the same API. -You can adjust the number of \l {QSoundEffect::setLoops()}{loops} a sound effect is played, as well as +You can adjust the number of \l {QSoundEffect::loops}{loops} a sound effect is played, as well as the \l {QSoundEffect::setVolume()}{volume} (or \l {QSoundEffect::setMuted()}{muting}) of the effect. For older, Qt 4.x based applications \l QSound is also available. Applications @@ -135,36 +135,22 @@ Here's an example of installing a probe during recording: There are both C++ and QML examples available. -C++ Examples: +\section2 C++ Examples -\section2 Record a Sound Source +\annotatedlist audio_examples -\l{audiorecorder}{AudioRecorder} is a demonstration of the discovery of -the supported devices and codecs and the use of recording functions in the -QAudioRecorder class. +\section2 QML Examples -\list - \li \l audiodevices - \li \l audioinput - \li \l audiooutput - \li \l audiorecorder - \li \l spectrum -\endlist - -QML Examples: [TBD] \section1 Reference Documentation -\section2 Audio Classes +\section2 C++ Classes \annotatedlist multimedia_audio \section2 QML Elements -\list - \li \l Audio - \li \l MediaPlayer -\endlist +\annotatedlist multimedia_audio_qml */ diff --git a/doc/src/cameraoverview.qdoc b/doc/src/cameraoverview.qdoc index 9af9daae2..095cca77e 100644 --- a/doc/src/cameraoverview.qdoc +++ b/doc/src/cameraoverview.qdoc @@ -195,7 +195,7 @@ There are a number of settings that affect the amount of light that hits the camera sensor, and hence the quality of the resulting image. The \l QCameraExposure class allows you to adjust these settings. You can use this class to implement some techniques like High Dynamic Range (HDR) photos by locking the exposure -parameters (with \l {QCamera::lock()}), or motion blur by setting slow shutter speeds +parameters (with \l {QCamera::searchAndLock()}), or motion blur by setting slow shutter speeds with small apertures. The main settings for automatic image taking are the \l {QCameraExposure::ExposureMode}{exposure mode} @@ -213,13 +213,14 @@ the hardware may also double as a torch (typically when the flash is LED based, a xenon or other bulb). See also the \l {Torch} QML element for an easy to use API for torch functionality. +\target camera_image_processing \section3 Image processing The QCameraImageProcessing class lets you adjust the image processing -part of the pipeline. This includes the \l {QCameraImageCapture::WhiteBalanceMode}{white balance} -(or color temperature), \l {QCameraImageCapture::contrast()}{contrast}, -\l {QCameraImageCapture::saturation()}{saturation}, \l {QCameraImageCapture::setSharpening()}{sharpening} -and \l {QCameraImageCapture::setDenoisingLevel()}{denoising}. Most cameras support automatic settings +part of the pipeline. This includes the \l {QCameraImageProcessing::WhiteBalanceMode}{white balance} +(or color temperature), \l {QCameraImageProcessing::contrast()}{contrast}, +\l {QCameraImageProcessing::saturation()}{saturation}, \l {QCameraImageProcessing::setSharpeningLevel()}{sharpening} +and \l {QCameraImageProcessing::setDenoisingLevel()}{denoising}. Most cameras support automatic settings for all of these, so you shouldn't need to adjust them unless the user wants a specific setting. If you're taking a series of images (for example, to stitch them together for @@ -240,20 +241,17 @@ autoexposure or white balance cancellation can be done by calling There are both C++ and QML examples available. -C++ Examples: -\list - \li \l Camera -\endlist +\section2 C++ Examples -QML Examples: -\list - \li \l declarative-camera - \li \l qmlvideofx -\endlist +\annotatedlist camera_examples + +\section2 QML Examples + +\annotatedlist camera_examples_qml \section1 Reference Documentation -\section2 Camera Classes +\section2 C++ Classes \annotatedlist multimedia_camera diff --git a/doc/src/changes.qdoc b/doc/src/changes.qdoc index b895f219e..fbb61e85a 100644 --- a/doc/src/changes.qdoc +++ b/doc/src/changes.qdoc @@ -28,24 +28,24 @@ /*! \page changes.html -\title Changes in QtMultimedia -\brief A description of changes in this version of QtMultimedia +\title Changes in Qt Multimedia +\brief A description of changes in this version of Qt Multimedia -The QtMultimedia module in Qt 5 is a combination of the QtMultimedia module -in Qt 4.x and the QtMultimediaKit module of QtMobility. It replaces both -of these modules by combining the code. If you've previously used QtMultimedia +The Qt Multimedia module in Qt 5 is a combination of the Qt Multimedia module +in Qt 4.x and the Qt Multimedia Kit module of Qt Mobility. It replaces both +of these modules by combining the code. If you've previously used Qt Multimedia there are not too many changes required for existing code, but there are some -larger changes required for porting code that used QtMultimediaKit (most notably -the namespace and header file prefix has changed, and the QMake pro file changes -needed to enable QtMultimedia). +larger changes required for porting code that used Qt Multimedia Kit (most notably +the namespace and header file prefix has changed, and the qmake pro file changes +needed to enable Qt Multimedia). One other change of note is that widget related classes (like \l QVideoWidget) -are now in a new library (QtMultimediaWidgets). +are now in a new library (Qt Multimedia Widgets). \section1 New features in 5.0 -There are a number of new features in QtMultimedia 5.0: +There are a number of new features in Qt Multimedia 5.0: \list \li Expanded QML API \li New \l QAudioRecorder class @@ -60,7 +60,7 @@ There are a number of new features in QtMultimedia 5.0: \section1 Removed features -A number of classes or features previously offered in QtMultimedia or QtMultimediaKit have +A number of classes or features previously offered in Qt Multimedia or Qt Multimedia Kit have been removed. \table 70% @@ -75,7 +75,7 @@ been removed. \section1 Changed features -A number of classes previously offered in QtMultimedia or QtMultimediaKit have +A number of classes previously offered in Qt Multimedia or Qt Multimedia Kit have changed in ways that may affect previously written code. There may be other changes (like new features) that will not affect previously written code, and they are documented elsewhere. @@ -85,7 +85,7 @@ they are documented elsewhere. \li Changed feature \li Notes \row - \li QMake .pro file changes + \li qmake .pro file changes \li If you've used QtMultimediaKit in the past, you needed to put \code CONFIG += mobility @@ -102,25 +102,25 @@ they are documented elsewhere. if you need to use the widget classes. \row \li Namespace changes - \li For QtMultimediaKit the majority of the classes were in the + \li For Qt Multimedia Kit the majority of the classes were in the normal Qt namespace (usually nothing, unless built specially). There - was a QtMultimediaKit namespace for several enumerations. This namespace - has now changed to QtMultimedia, so if you've used one of the + was a Qt Multimedia Kit namespace for several enumerations. This namespace + has now changed to Qt Multimedia, so if you've used one of the \c SupportEstimate, \c EncodingQuality, \c EncodingMode or \c AvailabilityError enumerations you'll need to change your code. In fact, running a global - search and replace on QtMultimediaKit (to replace it with QtMultimedia) will + search and replace on \c QtMultimediaKit (to replace it with \c QtMultimedia) will go a long way with porting your code. \row \li Meta-data enumeration changes - \li In QtMultimediaKit the available meta-data keys were in an enumeration - in the QtMultimediaKit namespace. These meta-data keys have been changed - to string literals in the QtMultimedia::MetaData namespace - generally your + \li In Qt Multimedia Kit the available meta-data keys were in an enumeration + in the \c QtMultimediaKit namespace. These meta-data keys have been changed + to string literals in the \c {QtMultimedia::MetaData} namespace - generally your source code will mostly be compatible unless you have created variables or - parameters with the QtMultimedia::MetaData type - you should replace these - with QStrings. + parameters with the \c {QtMultimedia::MetaData} type - you should replace these + with \c QString. \row \li Meta-data method changes - \li In QtMultimediaKit the available meta-data was split between methods to + \li In Qt Multimedia Kit the available meta-data was split between methods to access standard, pre-defined keys, and methods to access extensible free form key meta-data. These have been combined into a single method to access meta-data given a string key, and a list of pre-defined keys. If @@ -128,10 +128,10 @@ they are documented elsewhere. to change your code to combine the standard and extended metadata methods. \row \li Qt Metatype registration - \li In QtMultimedia 5.0 we've tried to make sure that we register any classes + \li In Qt Multimedia 5.0 we've tried to make sure that we register any classes or types that would be useful to use in cross process signals or in QVariants. If you've previously added Q_DECLARE_METATYPE macros for any - QtMultimedia class you will probably need to remove them. + Qt Multimedia class you will probably need to remove them. \row \li Video QML element \li If you've previously used the Video QML element you may be excited @@ -140,7 +140,7 @@ they are documented elsewhere. together for more flexible and advanced use cases. \row \li QSoundEffect - \li The SoundEffect QML element was public and accessible in QtMultimedaKit, + \li The SoundEffect QML element was public and accessible in Qt Multimeda Kit, and now the C++ version is also available. If you managed to use the private class previously, you'll need to update your code. \row diff --git a/doc/src/examples/audiodevices.qdoc b/doc/src/examples/audiodevices.qdoc index 26b73c1f8..1b2885450 100644 --- a/doc/src/examples/audiodevices.qdoc +++ b/doc/src/examples/audiodevices.qdoc @@ -28,7 +28,8 @@ /*! \example audiodevices \title Audio Devices Example - + \ingroup audio_examples + \brief The Audio Devices example shows the application of the audio devices APIs This example shows how to create a simple application to list and test diff --git a/doc/src/examples/audioinput.qdoc b/doc/src/examples/audioinput.qdoc index a71113e82..9a0ec5ee4 100644 --- a/doc/src/examples/audioinput.qdoc +++ b/doc/src/examples/audioinput.qdoc @@ -28,7 +28,8 @@ /*! \example audioinput \title Audio Input Example - + \ingroup audio_examples + \brief The Audio Input Example shows the use of the QAudioInput class. */ diff --git a/doc/src/examples/audiooutput.qdoc b/doc/src/examples/audiooutput.qdoc index b7a3f1fb8..988d489c5 100644 --- a/doc/src/examples/audiooutput.qdoc +++ b/doc/src/examples/audiooutput.qdoc @@ -28,7 +28,8 @@ /*! \example audiooutput \title Audio Output Example - + \ingroup audio_examples + \brief The Audio Output Example show the use of the QAudioOutput API. diff --git a/doc/src/examples/audiorecorder.qdoc b/doc/src/examples/audiorecorder.qdoc index 6565daa89..25fe07973 100644 --- a/doc/src/examples/audiorecorder.qdoc +++ b/doc/src/examples/audiorecorder.qdoc @@ -28,11 +28,11 @@ /*! \example audiorecorder \title Audio Recorder Example + \ingroup audio_examples + \brief The Audio Recorder Example shows how to create a simple audio recorder. - - - This example shows how to create a simple audio recorder using the Qt - Multimedia API. + It demonstrates the discovery of the supported devices and codecs and the use + of recording functions in the QAudioRecorder class. We display a window for the user to select the appropriate audio input, codec, container, and sample rate. Allow a setting of either quality or diff --git a/doc/src/examples/camera.qdoc b/doc/src/examples/camera.qdoc index 4bc172098..bce7747fb 100644 --- a/doc/src/examples/camera.qdoc +++ b/doc/src/examples/camera.qdoc @@ -31,6 +31,7 @@ \example camera \title Camera Example +\ingroup camera_examples \brief The Camera Example shows how to use the API to capture a still image or video. diff --git a/doc/src/examples/declarative-camera.qdoc b/doc/src/examples/declarative-camera.qdoc index 9c6ce7dda..35605801f 100644 --- a/doc/src/examples/declarative-camera.qdoc +++ b/doc/src/examples/declarative-camera.qdoc @@ -28,6 +28,7 @@ /*! \example declarative-camera \title QML Camera Example +\ingroup camera_examples_qml \brief The Camera Example shows how to use the API to capture a still image or video. @@ -43,7 +44,7 @@ Camera elements being mostly found in \e {declarative-camera.qml} and \e {CaptureControls.qml}. In \e {declarative-camera.qml} the Camera element is initialized with an id -of \e {camera }, a photo preview is setup, states are implemented for image +of \e {camera}, a photo preview is setup, states are implemented for image preview or capture and a CaptureControls element is initialized. The initial \e state is \e PhotoCapture. The camera element includes a handler, \e onImageCaptured, for the \l {imageCaptured} signal. The handler sets up the application to process diff --git a/doc/src/examples/player.qdoc b/doc/src/examples/player.qdoc index 067a00a74..b35a74c97 100644 --- a/doc/src/examples/player.qdoc +++ b/doc/src/examples/player.qdoc @@ -28,6 +28,7 @@ /*! \example player \title Media Player Example + \ingroup video_examples This example creates a simple multimedia player. We can play audio and diff --git a/doc/src/examples/qmlvideo.qdoc b/doc/src/examples/qmlvideo.qdoc index 7ac266443..8a7fd6470 100644 --- a/doc/src/examples/qmlvideo.qdoc +++ b/doc/src/examples/qmlvideo.qdoc @@ -28,6 +28,7 @@ /*! \example video/qmlvideo \title QML Video Example +\ingroup video_examples_qml \brief The QML Video Example demonstrates the various manipulations (move; resize; rotate; change aspect ratio) which can be applied to QML \l{VideoOutput} diff --git a/doc/src/examples/qmlvideofx.qdoc b/doc/src/examples/qmlvideofx.qdoc index acfb202d7..80d89d3c9 100644 --- a/doc/src/examples/qmlvideofx.qdoc +++ b/doc/src/examples/qmlvideofx.qdoc @@ -28,10 +28,12 @@ /*! \example video/qmlvideofx \title QML Video Shader Effects Example +\ingroup video_examples_qml +\ingroup camera_examples_qml \brief The QML Video Shader Effects Example shows how the \l {ShaderEffect} -element can be used to apply postprocessing effects, expressed in GLSL, to QML -\l {VideoOutput} items. +element can be used to apply postprocessing effects, expressed in \c GLSL, to video +and camera viewfinder content. \section1 Overview diff --git a/doc/src/examples/spectrum.qdoc b/doc/src/examples/spectrum.qdoc index 65d603d33..504cccefc 100644 --- a/doc/src/examples/spectrum.qdoc +++ b/doc/src/examples/spectrum.qdoc @@ -28,7 +28,8 @@ /*! \example spectrum \title Spectrum Example - + \ingroup audio_examples + \brief The Spectrum Example uses a combination multimedia APIs to process microphone input. */ diff --git a/doc/src/examples/videographicsitem.qdoc b/doc/src/examples/videographicsitem.qdoc new file mode 100644 index 000000000..7bbc01ff0 --- /dev/null +++ b/doc/src/examples/videographicsitem.qdoc @@ -0,0 +1,36 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:FDL$ +** GNU Free Documentation License +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms +** and conditions contained in a signed written agreement between you +** and Nokia. +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! +\example videographicsitem +\title Video Graphics Item Example +\ingroup video_examples + +\brief This example demonstrates how to make a simple video player using the QMediaPlayer +and QVideoGraphicsItem classes in the Graphics View framework. + +*/ diff --git a/doc/src/examples/videowidget.qdoc b/doc/src/examples/videowidget.qdoc new file mode 100644 index 000000000..345fdea2b --- /dev/null +++ b/doc/src/examples/videowidget.qdoc @@ -0,0 +1,36 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:FDL$ +** GNU Free Documentation License +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms +** and conditions contained in a signed written agreement between you +** and Nokia. +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! +\example videowidget +\title Video Widget Example +\ingroup video_examples + +\brief This example demonstrates how to make a simple video player using the QMediaPlayer +and QVideoWidget classes + +*/ diff --git a/doc/src/multimedia.qdoc b/doc/src/multimedia.qdoc index 50c02785e..e8b924d81 100644 --- a/doc/src/multimedia.qdoc +++ b/doc/src/multimedia.qdoc @@ -27,13 +27,13 @@ /*! \page multimediaoverview.html -\title Qt Multimedia +\title Multimedia Overview \brief A set of APIs for working with audio, video, radio and camera devices. \ingroup technology-apis -\section1 Multimedia Overview +\section1 Overview \section2 Features @@ -114,12 +114,12 @@ For some quick recipes for specific tasks, look at the overviews above and consu \li QMediaPlayer, QAbstractVideoSurface, QVideoFrame \row \li Listening to the radio - \li \l radio, \l declarative-radio + \li \l declarative-radio \li \l Radio, \l RadioData \li QRadioTuner, QRadioData \row \li Accessing camera viewfinder - \li \l camera, \l declarative-camera + \li \l {Camera Example}{camera}, \l declarative-camera \li \l Camera, \l VideoOutput \li QCamera, QVideoWidget, QGraphicsVideoItem \row @@ -129,22 +129,21 @@ For some quick recipes for specific tasks, look at the overviews above and consu \li QCamera, QAbstractVideoSurface, QVideoFrame \row \li Capturing photos - \li \l camera, \l declarative-camera + \li \l {Camera Example}{camera}, \l declarative-camera \li \l Camera \li QCamera, QCameraImageCapture \row \li Capturing movies - \li \l camera, \l declarative-camera + \li \l {Camera Example}{camera}, \l declarative-camera \li \l Camera \li QCamera, QMediaRecorder \endtable -\section1 Multimedia Limitations +\section1 Limitations In many cases the Qt Multimedia APIs build upon the multimedia framework of the underlying system. This can mean that support for various codec or containers can vary between machines, -depending on what the end user has installed. See \l {Multimedia Platform Support} for more -information on what frameworks are used and what this can mean. +depending on what the end user has installed. \section1 Advanced Usage @@ -154,8 +153,8 @@ see \l{Multimedia Backend Development}. \section1 Changes from previous versions -If you've previously used QtMultimedia in Qt 4.x, or used QtMultimediaKit in QtMobility, please see -\l {Changes in QtMultimedia} for more information on what has changed, and what you might need to +If you've previously used Qt Multimedia in Qt 4.x, or used Qt Multimedia Kit in Qt Mobility, please see +\l {Changes in Qt Multimedia} for more information on what has changed, and what you might need to change when porting code. \section1 Reference Documentation diff --git a/doc/src/multimediabackend.qdoc b/doc/src/multimediabackend.qdoc index bfa41a54e..fffa12176 100644 --- a/doc/src/multimediabackend.qdoc +++ b/doc/src/multimediabackend.qdoc @@ -28,36 +28,42 @@ /*! +\title Multimedia Backend Development \page multimediabackend.html \brief Information for implementing a new multimedia backend. \ingroup mobility \tableofcontents -\section1 Multimedia Backend Development +\section1 Overview -In some cases the available cross-platform Multimedia APIs or implementations are not sufficient, -or not immediately available on a certain platform. In some cases the multimedia -implementation on a platform might expose certain extra properties or functionality -that other platforms do not, or a finer degree of control might be possible. For these -cases, it is possible to use extended controls directly. +A multimedia backend provides the glue between platform specific libraries, and +Qt Multimedia. In some cases the available cross-platform Multimedia APIs or +implementations are not sufficient, or not immediately available on a certain +platform. Alternatively, the multimedia implementation on a platform might expose +certain extra properties or functionality that other platforms do not, or a finer +degree of control might be possible. For these cases, it is possible to use +extended controls directly. In addition, if you plan to port the Qt Multimedia APIs to a new platform, you do this by implementing certain control and service classes, as detailed below. \section1 Extending the API -For the developer who wishes to extend the functionality of the Multimedia -classes there are several classes of particular importance. The default -classes are QMediaService, QMediaServiceProvider and QMediaControl. +For the developer who wishes to extend the functionality of the Qt Multimedia +classes there are several classes of particular importance. The classes +providing default functionality are QMediaService, QMediaServiceProvider and +QMediaControl. -Basically, the idea is that to use the Multimedia API you would use these -three classes or classes derived from them as follows +to extend the Multimedia API you would use the following three classes or +classes derived from them. \list - \li \l QMediaServiceProvider is used by the top level client class to request a service. The top level class knowing what kind of service it needs. + \li \l QMediaServiceProvider is used by the top level client class to + request a service. The top level class knowing what kind of service it needs. - \li \l QMediaService provides a service and when asked by the top level object, say a component, will return a QMediaControl object. + \li \l QMediaService provides a service and when asked by the top level + object, say a component, will return a QMediaControl object. \li \l QMediaControl allows the control of the service using a known interface. \endlist @@ -71,15 +77,15 @@ MyMediaService, and the MyMediaControl to manipulate the media service. The MyPlayer object calls MyServiceProvider::requestService() to get an instance of MyMediaService. Then the MyPlayer object calls this service object it has just received and calling \l {QMediaService::requestControl()}{requestControl()} -it will receive the control object derived from QMediaControl. Now we have -all the parts necessary for our media application. We have the service +it will receive the control object derived from QMediaControl. + +Now we have all the parts necessary for our media application. We have the service provider, the service it provides and the control used to manipulate the service. Since our MyPlayer object has instances of the service and its control then it would be possible for these to be used by associated classes that could do additional actions, perhaps with their own control since the -parameter to requestControl() is a c-type string, \e {const char *}, for the -interface. - +parameter to requestControl() is a zero-terminated string, \e {const char *}, +for the interface. \section2 Adding a Media Service Provider diff --git a/doc/src/plugins/qml-multimedia.qdoc b/doc/src/plugins/qml-multimedia.qdoc index e0e721ac5..d264c1541 100644 --- a/doc/src/plugins/qml-multimedia.qdoc +++ b/doc/src/plugins/qml-multimedia.qdoc @@ -129,72 +129,26 @@ \li Signal \li Description \row - \li \l{Audio::onStarted}{onStarted} - \li Called when playback has been started. - \row - \li \l{Audio::onResumed}{onResumed} - \li Called when playback is resumed from the paused state. + \li \l{Audio::playing}{playing} + \li Called when playback is started, or when resumed from paused state. \row - \li \l{Audio::onPaused}{onPaused} + \li \l{Audio::paused}{paused} \li Called when playback is paused. \row - \li \l{Audio::onStopped}{onStopped} + \li \l{Audio::stopped}{stopped} \li Called when playback is stopped. \row - \li \l{Audio::onError}{onError} + \li \l{Audio::error}{error} \li Called when the specified error occurs. \endtable \section2 Camera - The \l Camera element in the plugin enables still image capture using - QML. The element has methods for starting and stopping the camera, capturing - the image, camera settings and many signals indicating critical events. - - The follow code is taken from the \l {QML Camera Example}. This snippet - shows the setting up of the \l Camera element - - \qml - - Camera { - id: camera - x : 0 - y : 0 - width : 640 - height : 480 - focus : visible //to receive focus and capture key events - //captureResolution : "640x480" - - flashMode: stillControls.flashMode - whiteBalanceMode: stillControls.whiteBalance - exposureCompensation: stillControls.exposureCompensation - - onImageCaptured : { - photoPreview.source = preview - stillControls.previewAvailable = true - cameraUI.state = "PhotoPreview" - } - } - - \endqml - - Notice that the slot for the \l {Camera::imageCaptured()}{imageCaptured()} - signal is implemented in \e onImageCaptured. However, this code only - changes some state information to allow previewing. - - The capture call itself is part of the implementation of the button - that the user presses to take the image. It uses a call to - \l {Camera::captureImage()}{captureImage()}: - - \qml - - CameraButton { - text: "Capture" - onClicked: camera.captureImage() - } - - \endqml + The \l Camera element enables still image and video capture using + QML. The element has a number of properties that help setting it up. + The details of using the Camera element are described in further details + in the \l {Camera Overview} and in the corresponding reference documentation. \section2 Video @@ -258,31 +212,6 @@ For a complete description of this element, see \l SoundEffect - \section2 Camera - - Adding access to the camera viewfinder, and capturing images is possible by using the \l Camera element. You can adjust capture settings - including white balance, exposure compensation and flash mode, and control zoom. - - \qml - import QtQuick 2.0 - import QtMultimedia 5.0 - - Camera { - focus : visible // to receive focus and capture key events when visible - - flashMode: Camera.FlashRedEyeReduction - whiteBalanceMode: Camera.WhiteBalanceFlash - exposureCompensation: -1.0 - - onImageCaptured : { - photoPreview.source = preview // Show the preview in an Image element - } - - } - \endqml - - For a complete description of this element, see \l Camera, and look at the \l {declarative-camera}{QML Camera Example}. - \section1 Multimedia QML Elements \annotatedlist multimedia_qml diff --git a/doc/src/qtmultimedia5.qdoc b/doc/src/qtmultimedia5.qdoc index bf659397a..d4f7f4f05 100644 --- a/doc/src/qtmultimedia5.qdoc +++ b/doc/src/qtmultimedia5.qdoc @@ -27,8 +27,8 @@ /*! \qmlmodule QtMultimedia 5 -\title QtMultimedia 5.0 -\brief The QML import for QtMultimedia +\title QML import for multimedia +\brief The import for the QML elements in the Qt Multimedia module \section1 Overview diff --git a/doc/src/radiooverview.qdoc b/doc/src/radiooverview.qdoc index 467ebfb88..9b1225913 100644 --- a/doc/src/radiooverview.qdoc +++ b/doc/src/radiooverview.qdoc @@ -78,15 +78,12 @@ current frequency inside the band. \section1 Reference documentation -\section2 Radio C++ Classes +\section2 C++ Classes \annotatedlist multimedia_radio \section2 QML Elements -\list - \li \l Radio - \li \l RadioData -\endlist +\annotatedlist multimedia_radio_qml */ diff --git a/doc/src/snippets/multimedia-snippets/video.cpp b/doc/src/snippets/multimedia-snippets/video.cpp index 007b73558..5ab5ed03a 100644 --- a/doc/src/snippets/multimedia-snippets/video.cpp +++ b/doc/src/snippets/multimedia-snippets/video.cpp @@ -48,10 +48,63 @@ #include "qvideowindowcontrol.h" #include "qgraphicsvideoitem.h" #include "qmediaplaylist.h" +#include "qvideosurfaceformat.h" #include <QFormLayout> #include <QGraphicsView> +//! [Derived Surface] +class MyVideoSurface : public QAbstractVideoSurface +{ + QList<QVideoFrame::PixelFormat> supportedPixelFormats( + QAbstractVideoBuffer::HandleType handleType = QAbstractVideoBuffer::NoHandle) const + { + Q_UNUSED(handleType); + + // Return the formats you will support + return QList<QVideoFrame::PixelFormat>() << QVideoFrame::Format_RGB565; + } + + bool present(const QVideoFrame &frame) + { + Q_UNUSED(frame); + // Handle the frame and do your processing + + return true; + } +}; +//! [Derived Surface] + +//! [Video producer] +class MyVideoProducer : public QObject +{ + Q_OBJECT + Q_PROPERTY(QAbstractVideoSurface *videoSurface WRITE setVideoSurface) + +public: + void setVideoSurface(QAbstractVideoSurface *surface) + { + m_surface = surface; + m_surface->start(m_format); + } + + // ... + +public slots: + void onNewVideoContentReceived(const QVideoFrame &frame) + { + if (m_surface) + m_surface->present(frame); + } + +private: + QAbstractVideoSurface *m_surface; + QVideoSurfaceFormat m_format; +}; + +//! [Video producer] + + class VideoExample : public QObject { Q_OBJECT public: @@ -98,6 +151,12 @@ void VideoExample::VideoWidget() playlist->setCurrentIndex(1); player->play(); //! [Video widget] + + player->stop(); + + //! [Setting surface in player] + player->setVideoOutput(myVideoSurface); + //! [Setting surface in player] } void VideoExample::VideoWidgetControl() diff --git a/doc/src/videooverview.qdoc b/doc/src/videooverview.qdoc index b8a1dd5b9..eecfd1ed8 100644 --- a/doc/src/videooverview.qdoc +++ b/doc/src/videooverview.qdoc @@ -57,7 +57,7 @@ And an example with QGraphicsVideoItem: You can use the \l VideoOutput QML element to render content that is provided by either a \l MediaPlayer element or a \l Camera element. The VideoOutput element is a visual element that can be transformed -or acted upon by shaders (as the \l {qmlvideofx} example shows), while +or acted upon by shaders (as the \l {QML Video Shader Effects Example} shows), while all media decoding and playback control is handled by the MediaPlayer element. @@ -76,7 +76,16 @@ The \l QVideoFrame class encapsulates a video frame and allows the contents to be mapped into system memory for manipulation or processing, while deriving a class from \l QAbstractVideoSurface allows you to receive these frames from \l QMediaPlayer and -\l QCamera. Several of the built in Qt classes offer this functionality +\l QCamera. + +\snippet doc/src/snippets/multimedia-snippets/video.cpp Derived Surface + +and with an instance of this surface, \c myVideoSurface, you can set +the surface as the \l {QMediaPlayer::setVideoOutput()}{video output} for QMediaPlayer. + +\snippet doc/src/snippets/multimedia-snippets/video.cpp Setting surface in player + +Several of the built in Qt classes offer this functionality as well, so if you decode video in your application, you can present it to classes that offer a \l QVideoRendererControl class, and in QML you can set a custom object for the source of the \l VideoOutput element @@ -85,6 +94,12 @@ set it's internal video surface to) or a readable \c mediaObject property with a QMediaObject derived class that implements the \l QVideoRendererControl interface. +The following snippet shows a class that has a writable \c videoSurface property +and receives frames through a public slot \c onNewVideoContentReceived(). These +frames are then presented on the surface set in \c setVideoSurface(). + +\snippet doc/src/snippets/multimedia-snippets/video.cpp Video producer + \section2 Recording video You can use the \l QMediaRecorder class in conjunction with other classes to record video to disk. Primarily this is used with @@ -108,31 +123,22 @@ Here's an example of installing a video probe while recording the camera: There are both C++ and QML examples available. -C++ Examples: -\list - \li \l video - \li \l videographicsitem - \li \l videowidget -\endlist +\section2 C++ Examples + +\annotatedlist video_examples + +\section2 QML Examples -QML Examples: -\list - \li \l qmlvideo - \li \l qmlvideofx -\endlist +\annotatedlist video_examples_qml \section1 Reference Documentation -\section2 Video Classes +\section2 C++ Classes \annotatedlist multimedia_video \section2 QML Elements -\list - \li \l MediaPlayer - \li \l VideoOutput - \li \l Video -\endlist +\annotatedlist multimedia_video_qml */ diff --git a/src/imports/audioengine/qdeclarative_audiosample_p.cpp b/src/imports/audioengine/qdeclarative_audiosample_p.cpp index 423945b18..6a33e86a5 100644 --- a/src/imports/audioengine/qdeclarative_audiosample_p.cpp +++ b/src/imports/audioengine/qdeclarative_audiosample_p.cpp @@ -236,6 +236,13 @@ QSoundBuffer* QDeclarativeAudioSample::soundBuffer() const } /*! + \qmlproperty bool QtAudioEngine1::AudioSample::loaded + + This property holds the load status of the audio sample. +*/ + + +/*! \qmlsignal QtAudioEngine1::AudioSample::onLoadedChanged() This handler is called when \l loaded is changed diff --git a/src/imports/audioengine/qdeclarative_soundinstance_p.cpp b/src/imports/audioengine/qdeclarative_soundinstance_p.cpp index 38cffae72..7b852d95d 100644 --- a/src/imports/audioengine/qdeclarative_soundinstance_p.cpp +++ b/src/imports/audioengine/qdeclarative_soundinstance_p.cpp @@ -459,7 +459,7 @@ void QDeclarativeSoundInstance::setGain(qreal gain) } /*! - \qmlproperty vector3d QtAudioEngine1::SoundInstance::gain + \qmlproperty vector3d QtAudioEngine1::SoundInstance::pitch This property holds the pitch adjustment which will be used to modulate the audio pitch from this SoundInstance. diff --git a/src/imports/multimedia/Video.qml b/src/imports/multimedia/Video.qml index 861d291cc..59932c084 100644 --- a/src/imports/multimedia/Video.qml +++ b/src/imports/multimedia/Video.qml @@ -46,6 +46,7 @@ import QtMultimedia 5.0 \qmlclass Video \inherits Item \ingroup multimedia_qml + \ingroup multimedia_video_qml \brief A convenience element for showing a specified video The \c Video element is a convenience element combining the functionality diff --git a/src/imports/multimedia/qdeclarativeaudio.cpp b/src/imports/multimedia/qdeclarativeaudio.cpp index 4d0593a8d..d9b229b73 100644 --- a/src/imports/multimedia/qdeclarativeaudio.cpp +++ b/src/imports/multimedia/qdeclarativeaudio.cpp @@ -62,6 +62,8 @@ QT_BEGIN_NAMESPACE \inqmlmodule QtMultimedia 5 \ingroup multimedia_qml + \ingroup multimedia_audio_qml + \ingroup multimedia_video_qml This element is part of the \b{QtMultimedia 5.0} module. @@ -121,6 +123,7 @@ QT_BEGIN_NAMESPACE \inqmlmodule QtMultimedia 5 \ingroup multimedia_qml + \ingroup multimedia_audio_qml This element is part of the \b{QtMultimedia 5.0} module. @@ -782,7 +785,7 @@ void QDeclarativeAudio::_q_statusChanged() */ /*! - \qmlsignal QtMultimedia5::Audio::onError(error, errorString) + \qmlsignal QtMultimedia5::Audio::error(error, errorString) This handler is called when an \l {QMediaPlayer::Error}{error} has occurred. The errorString parameter may contain more detailed diff --git a/src/imports/multimedia/qdeclarativecamera.cpp b/src/imports/multimedia/qdeclarativecamera.cpp index 03bfede0b..b540cbaf6 100644 --- a/src/imports/multimedia/qdeclarativecamera.cpp +++ b/src/imports/multimedia/qdeclarativecamera.cpp @@ -143,8 +143,8 @@ void QDeclarativeCamera::_q_availabilityChanged(QtMultimedia::AvailabilityError Basic camera state management, error reporting, and simple zoom properties are available in the Camera element itself. For integration with C++ code, the - \l mediaObject property allows you to access the standard QtMultimedia camera - controls. + \l mediaObject property allows you to + access the standard QtMultimedia camera controls. Many of the camera settings may take some time to apply, and might be limited to certain supported values depending on the hardware. Several camera settings @@ -500,6 +500,11 @@ void QDeclarativeCamera::setDigitalZoom(qreal value) m_camera->focus()->zoomTo(opticalZoom(), value); } +/*! + \qmlproperty variant QtMultimedia5::Camera::mediaObject + + The media object for the Camera element. +*/ /*! \qmlsignal QtMultimedia5::Camera::onError(error, errorString) diff --git a/src/imports/multimedia/qdeclarativecameracapture.cpp b/src/imports/multimedia/qdeclarativecameracapture.cpp index 83dbcf22d..8f7606a19 100644 --- a/src/imports/multimedia/qdeclarativecameracapture.cpp +++ b/src/imports/multimedia/qdeclarativecameracapture.cpp @@ -60,9 +60,8 @@ QT_BEGIN_NAMESPACE are available or saved to disk. You can adjust the resolution of the captured image and where the saved image should go. - This element is a child of a Camera element (as the - \l {Camera::imageCapture}{imageCapture} property) and cannot be created - directly. + This element is a child of a \l Camera element (as the \c imageCapture property) + and cannot be created directly. \qml import QtQuick 2.0 diff --git a/src/imports/multimedia/qdeclarativecameraexposure.cpp b/src/imports/multimedia/qdeclarativecameraexposure.cpp index 6d594f658..41ebd3c3c 100644 --- a/src/imports/multimedia/qdeclarativecameraexposure.cpp +++ b/src/imports/multimedia/qdeclarativecameraexposure.cpp @@ -57,7 +57,7 @@ QT_BEGIN_NAMESPACE like aperture and shutter speed, metering and ISO speed. It should not be constructed separately but provided by the - Camera element's \l {Camera::exposure} {exposure} property. + \l Camera element's \c exposure property. \qml import QtQuick 2.0 diff --git a/src/imports/multimedia/qdeclarativecameraflash.cpp b/src/imports/multimedia/qdeclarativecameraflash.cpp index 8b5e23bd7..1c9a69a02 100644 --- a/src/imports/multimedia/qdeclarativecameraflash.cpp +++ b/src/imports/multimedia/qdeclarativecameraflash.cpp @@ -59,7 +59,7 @@ QT_BEGIN_NAMESPACE \l {Torch}{torch} hardware). It should not be constructed separately but provided by the - Camera element's \l {Camera::flash}{flash} property. + \l Camera element's \c flash property. \qml import QtQuick 2.0 diff --git a/src/imports/multimedia/qdeclarativecamerafocus.cpp b/src/imports/multimedia/qdeclarativecamerafocus.cpp index 4140b22e2..82084d1a8 100644 --- a/src/imports/multimedia/qdeclarativecamerafocus.cpp +++ b/src/imports/multimedia/qdeclarativecamerafocus.cpp @@ -58,7 +58,7 @@ QT_BEGIN_NAMESPACE camera frame that are selected for autofocusing. It is not constructed separately but is provided by the - Camera element's \l {Camera::focus}{focus} property. + \l Camera element's \c focus property. \qml import QtQuick 2.0 @@ -122,8 +122,8 @@ QDeclarativeCamera::FocusMode QDeclarativeCameraFocus::focusMode() const } /*! - \qmlmethod bool QtMultimedia5::CameraFocus::isFocusModeSupported(mode) - \fn QDeclarativeCameraFocus::isFocusPointModeSupported(QDeclarativeCamera::FocusMode mode) + \qmlmethod bool QtMultimedia5::CameraFocus::isFocusModeSupported(mode) const + \fn QDeclarativeCameraFocus::isFocusModeSupported(QDeclarativeCamera::FocusMode mode) const Returns true if the supplied \a mode is a supported focus mode, and false otherwise. @@ -163,8 +163,8 @@ void QDeclarativeCameraFocus::setFocusPointMode(QDeclarativeCamera::FocusPointMo } /*! - \qmlmethod bool QtMultimedia5::CameraFocus::isFocusPointModeSupported(mode) - \fn QDeclarativeCameraFocus::isFocusPointModeSupported(QDeclarativeCamera::FocusPointMode mode) + \qmlmethod bool QtMultimedia5::CameraFocus::isFocusPointModeSupported(mode) const + \fn QDeclarativeCameraFocus::isFocusPointModeSupported(QDeclarativeCamera::FocusPointMode mode) const Returns true if the supplied \a mode is a supported focus point mode, and false otherwise. diff --git a/src/imports/multimedia/qdeclarativecamerafocus_p.h b/src/imports/multimedia/qdeclarativecamerafocus_p.h index 9a9472ba4..b905e6228 100644 --- a/src/imports/multimedia/qdeclarativecamerafocus_p.h +++ b/src/imports/multimedia/qdeclarativecamerafocus_p.h @@ -82,7 +82,7 @@ public: QAbstractListModel *focusZones() const; Q_INVOKABLE bool isFocusModeSupported(QDeclarativeCamera::FocusMode mode) const; - Q_INVOKABLE bool isFocusPointModeSupported(QDeclarativeCamera::FocusPointMode) const; + Q_INVOKABLE bool isFocusPointModeSupported(QDeclarativeCamera::FocusPointMode mode) const; public Q_SLOTS: void setFocusMode(QDeclarativeCamera::FocusMode); diff --git a/src/imports/multimedia/qdeclarativecameraimageprocessing.cpp b/src/imports/multimedia/qdeclarativecameraimageprocessing.cpp index 1b4b071b8..d4c06077a 100644 --- a/src/imports/multimedia/qdeclarativecameraimageprocessing.cpp +++ b/src/imports/multimedia/qdeclarativecameraimageprocessing.cpp @@ -55,8 +55,8 @@ QT_BEGIN_NAMESPACE done by the camera middleware, including white balance adjustments, contrast, saturation, sharpening, and denoising - It is not constructed separately but is provided by the Camera element's - \l {Camera::imageProcessing}{imageProcessing} property. + It is not constructed separately but is provided by the \a Camera element's + \c imageProcessing property. \qml import QtQuick 2.0 diff --git a/src/imports/multimedia/qdeclarativecamerarecorder.cpp b/src/imports/multimedia/qdeclarativecamerarecorder.cpp index 50e98591a..294a499db 100644 --- a/src/imports/multimedia/qdeclarativecamerarecorder.cpp +++ b/src/imports/multimedia/qdeclarativecamerarecorder.cpp @@ -56,9 +56,8 @@ QT_BEGIN_NAMESPACE This element allows recording camera streams to files, and adjusting recording settings and metadata for videos. - This element is a child of a Camera element (as the - \l {Camera::videoRecorder}{videoRecorder} property) and cannot be created - directly. + This element is a child of a \l Camera element (as the \c videoRecorder property) + and cannot be created directly. \qml Camera { @@ -113,7 +112,7 @@ QSize QDeclarativeCameraRecorder::captureResolution() The audio codec to use for recording video. Typically this is something like \c aac or \c amr-wb. - \sa whiteBalanceMode + \sa {QtMultimedia5::CameraImageProcessing::whiteBalanceMode}{whileBalanceMode} */ QString QDeclarativeCameraRecorder::audioCodec() const { diff --git a/src/imports/multimedia/qdeclarativeradio.cpp b/src/imports/multimedia/qdeclarativeradio.cpp index aed3d40a8..1f2a62c3a 100644 --- a/src/imports/multimedia/qdeclarativeradio.cpp +++ b/src/imports/multimedia/qdeclarativeradio.cpp @@ -49,6 +49,7 @@ QT_BEGIN_NAMESPACE \inqmlmodule QtMultimedia 5 \brief The Radio element allows you to access radio functionality from a QML application. \ingroup multimedia_qml + \ingroup multimedia_radio_qml \inherits Item This element is part of the \b{QtMultimedia 5.0} module. diff --git a/src/imports/multimedia/qdeclarativeradiodata.cpp b/src/imports/multimedia/qdeclarativeradiodata.cpp index 8ab5f0827..7936dd6f4 100644 --- a/src/imports/multimedia/qdeclarativeradiodata.cpp +++ b/src/imports/multimedia/qdeclarativeradiodata.cpp @@ -48,6 +48,7 @@ QT_BEGIN_NAMESPACE \inqmlmodule QtMultimedia 5 \brief The RadioData element allows you to access RDS data from a QML application. \ingroup multimedia_qml + \ingroup multimedia_radio_qml \inherits Item This element is part of the \b{QtMultimedia 5.0} module. diff --git a/src/imports/multimedia/qdeclarativevideooutput.cpp b/src/imports/multimedia/qdeclarativevideooutput.cpp index de0740d1f..51fea06ff 100644 --- a/src/imports/multimedia/qdeclarativevideooutput.cpp +++ b/src/imports/multimedia/qdeclarativevideooutput.cpp @@ -122,6 +122,7 @@ private: \brief The VideoOutput element allows you to render video or camera viewfinder. \ingroup multimedia_qml + \ingroup multimedia_video_qml \inqmlmodule QtMultimedia 5 This element is part of the \b{QtMultimedia 5.0} module. diff --git a/src/multimedia/audio/qaudiobuffer.cpp b/src/multimedia/audio/qaudiobuffer.cpp index b8287f235..7161e44d4 100644 --- a/src/multimedia/audio/qaudiobuffer.cpp +++ b/src/multimedia/audio/qaudiobuffer.cpp @@ -194,13 +194,10 @@ QAudioBufferPrivate *QAudioBufferPrivate::clone() /*! \class QAudioBuffer - \brief A class that represents a collection of audio samples. \inmodule QtMultimedia \ingroup multimedia \ingroup multimedia_audio - - The QAudioBuffer class represents a collection of audio samples, - with a specific format and sample rate. + \brief The QAudioBuffer class represents a collection of audio samples with a specific format and sample rate. */ // ^ Mostly useful with probe or decoder diff --git a/src/multimedia/audio/qaudioprobe.cpp b/src/multimedia/audio/qaudioprobe.cpp index d23b0d10e..6dd7d7258 100644 --- a/src/multimedia/audio/qaudioprobe.cpp +++ b/src/multimedia/audio/qaudioprobe.cpp @@ -79,7 +79,7 @@ public: }; /*! - Creates a new QAudioProbe class. After setting the + Creates a new QAudioProbe class with a \a parent. After setting the source to monitor with \l setSource(), the \l audioBufferProbed() signal will be emitted when audio buffers are flowing in the source media object. @@ -157,8 +157,8 @@ bool QAudioProbe::setSource(QMediaObject *source) Returns true on success. - If \a source is zero, this probe will be deactivated - and this function will return true. + If there is no mediaObject associated with \a mediaRecorder, or if it is + zero, this probe will be deactivated and this function wil return true. If the media recorder instance does not support monitoring audio, this function will return false. @@ -194,7 +194,7 @@ bool QAudioProbe::isActive() const /*! \fn QAudioProbe::audioBufferProbed(const QAudioBuffer &buffer) - This signal should be emitted when an audio buffer is processed in the + This signal should be emitted when an audio \a buffer is processed in the media service. */ diff --git a/src/multimedia/audio/qaudiosystemplugin.cpp b/src/multimedia/audio/qaudiosystemplugin.cpp index b99d5654f..a6457f031 100644 --- a/src/multimedia/audio/qaudiosystemplugin.cpp +++ b/src/multimedia/audio/qaudiosystemplugin.cpp @@ -106,11 +106,6 @@ QAudioSystemPlugin::~QAudioSystemPlugin() {} /*! - \fn QStringList QAudioSystemPlugin::keys() const - Returns the list of device identifiers this plugin supports. -*/ - -/*! \fn QList<QByteArray> QAudioSystemPlugin::availableDevices(QAudio::Mode mode) const Returns a list of available audio devices for \a mode */ diff --git a/src/multimedia/audio/qsound.cpp b/src/multimedia/audio/qsound.cpp index dc07c08b4..d9f93dcee 100644 --- a/src/multimedia/audio/qsound.cpp +++ b/src/multimedia/audio/qsound.cpp @@ -80,6 +80,12 @@ \sa QSoundEffect */ +/*! + \enum QSound::Loop + + \value Infinite Can be used as a parameter to \l setLoops() to loop infinitely. +*/ + /*! Plays the sound stored in the file specified by the given \a filename. diff --git a/src/multimedia/audio/qsoundeffect.cpp b/src/multimedia/audio/qsoundeffect.cpp index 6ebbdc8bf..ffaeb3418 100644 --- a/src/multimedia/audio/qsoundeffect.cpp +++ b/src/multimedia/audio/qsoundeffect.cpp @@ -55,6 +55,7 @@ QT_BEGIN_NAMESPACE \inmodule QtMultimedia \ingroup multimedia_qml + \ingroup multimedia_audio_qml \inqmlmodule QtMultimedia 5 This element is part of the \b{QtMultimedia 5.0} module. @@ -75,6 +76,22 @@ QT_BEGIN_NAMESPACE */ /*! + \enum QSoundEffect::Loop + + \value Infinite Used as a parameter to \l loops for infinite looping +*/ + +/*! + \enum QSoundEffect::Status + + \value Null No source has been set or the source is null. + \value Loading The soundeffect is trying to load the source. + \value Ready The source is loaded and ready for play. + \value Error An error occurred during operation, such as failure of loading the source. + +*/ + +/*! \qmlproperty url QtMultimedia5::SoundEffect::source \property QSoundEffect::source @@ -113,20 +130,23 @@ QT_BEGIN_NAMESPACE /*! \qmlproperty bool QtMultimedia5::SoundEffect::playing - \property QSoundEffect::source + \property QSoundEffect::playing This property indicates if the soundeffect is playing or not. */ /*! - \qmlproperty int QtMultimedia5::SoundEffect::status + \qmlproperty enumeration QtMultimedia5::SoundEffect::status This property indicates the following status of the soundeffect. - Null: no source has been set or is null. - Loading: the soundeffect is trying to load the source. - Ready: the source is loaded and ready for play. - Error: some error happened during operation, such as failure of loading the source. + \table + \header \li Value \li Description + \row \li SoundEffect.Null \li No source has been set or the source is null. + \row \li SoundEffect.Loading \li The soundeffect is trying to load the source. + \row \li SoundEffect.Ready \li The source is loaded and ready for play. + \row \li SoundEffect.Error \li An error occurred during operation, such as failure of loading the source. + \endtable */ /*! @@ -208,6 +228,11 @@ QSoundEffect::~QSoundEffect() d->release(); } +/*! + \fn QSoundEffect::supportedMimeTypes() + + Returns a list of the supported mime types for this sound effect. +*/ QStringList QSoundEffect::supportedMimeTypes() { return QSoundEffectPrivate::supportedMimeTypes(); @@ -233,6 +258,18 @@ int QSoundEffect::loopCount() const return d->loopCount(); } +/*! + \qmlproperty int QtMultimedia5::SoundEffect::loopsRemaining + + This property contains the number of loops remaining before the sound effect + stops by itself, or SoundEffect.Infinite if that's what has been set in \l loops. +*/ +/*! + \property QSoundEffect::loopsRemaining + + This property contains the number of loops remaining before the sound effect + stops by itself, or QSoundEffect::Infinite if that's what has been set in \l loops. +*/ int QSoundEffect::loopsRemaining() const { return d->loopsRemaining(); @@ -284,20 +321,32 @@ void QSoundEffect::setMuted(bool muted) d->setMuted(muted); } +/*! + \qmlmethod bool QtMultimedia5::SoundEffect::isLoaded() + \fn QSoundEffect::isLoaded() const + + Returns whether the sound effect has finished loading the \l source. +*/ bool QSoundEffect::isLoaded() const { return d->isLoaded(); } /*! - \qmlmethod QtMultimedia5::SoundEffect::play() + \qmlmethod QtMultimedia5::SoundEffect::play() - Start playback of the sound effect, looping the effect for the number of - times as specified in the loops property. + Start playback of the sound effect, looping the effect for the number of + times as specified in the loops property. - This is the default method for SoundEffect. + This is the default method for SoundEffect. - \snippet doc/src/snippets/multimedia-snippets/soundeffect.qml play sound on click + \snippet doc/src/snippets/multimedia-snippets/soundeffect.qml play sound on click +*/ +/*! + \fn QSoundEffect::play() + + Start playback of the sound effect, looping the effect for the number of + times as specified in the loops property. */ void QSoundEffect::play() { @@ -310,14 +359,6 @@ bool QSoundEffect::isPlaying() const } /*! - \enum QSoundEffect::Status - \value Null This sound effect does not have a source set. - \value Loading The source is being loaded - \value Ready The source has been loaded, and can be played. - \value Error An error occurred while loading the source or during playback. -*/ - -/*! Returns the current status of this sound effect. */ QSoundEffect::Status QSoundEffect::status() const @@ -328,8 +369,10 @@ QSoundEffect::Status QSoundEffect::status() const /*! \qmlmethod QtMultimedia5::SoundEffect::stop() + \fn QSoundEffect::stop() Stop current playback. + Note that if the backend is PulseAudio, due to the limitation of the underlying API, tis stop will only prevent next looping but will not be able to stop current playback immediately. diff --git a/src/multimedia/camera/qcamera.cpp b/src/multimedia/camera/qcamera.cpp index bf9db9245..baecb1a06 100644 --- a/src/multimedia/camera/qcamera.cpp +++ b/src/multimedia/camera/qcamera.cpp @@ -336,7 +336,7 @@ void QCameraPrivate::_q_updateLockStatus(QCamera::LockType type, QCamera::LockSt /*! - Construct a QCamera from service \a provider and \a parent. + Construct a QCamera with a \a parent. */ QCamera::QCamera(QObject *parent): diff --git a/src/multimedia/camera/qcameraexposure.cpp b/src/multimedia/camera/qcameraexposure.cpp index 2a52a5f8d..9e4870c7b 100644 --- a/src/multimedia/camera/qcameraexposure.cpp +++ b/src/multimedia/camera/qcameraexposure.cpp @@ -335,9 +335,9 @@ void QCameraExposure::setMeteringMode(QCameraExposure::MeteringMode mode) } /*! - \property QCameraExposure::spotMeteringPoint + \fn QCameraExposure::spotMeteringPoint() const - When supported, this property is the (normalized) position of the point of the image + When supported, the spot metering point is the (normalized) position of the point of the image where exposure metering will be performed. This is typically used to indicate an "interesting" area of the image that should be exposed properly. @@ -346,13 +346,23 @@ void QCameraExposure::setMeteringMode(QCameraExposure::MeteringMode mode) which is typically the default spot metering point. The spot metering point is only used with spot metering mode. - */ + + \sa setSpotMeteringPoint() +*/ QPointF QCameraExposure::spotMeteringPoint() const { return d_func()->exposureControl ? d_func()->exposureControl->actualValue(QCameraExposureControl::SpotMeteringPoint).toPointF() : QPointF(); } +/*! + \fn QCameraExposure::setSpotMeteringPoint(const QPointF &point) + + Allows setting the spot metering point to \a point. + + \sa spotMeteringPoint() +*/ + void QCameraExposure::setSpotMeteringPoint(const QPointF &point) { if (d_func()->exposureControl) diff --git a/src/multimedia/camera/qcameraimagecapture.cpp b/src/multimedia/camera/qcameraimagecapture.cpp index fd516c0e4..81c178d2d 100644 --- a/src/multimedia/camera/qcameraimagecapture.cpp +++ b/src/multimedia/camera/qcameraimagecapture.cpp @@ -76,6 +76,13 @@ QT_BEGIN_NAMESPACE \sa QCamera */ +/*! + \enum QCameraImageCapture::CaptureDestination + + \value CaptureToFile Capture the image to a file. + \value CaptureToBuffer Capture the image to a buffer for further processing. +*/ + namespace { class MediaRecorderRegisterMetaTypes @@ -441,9 +448,9 @@ QVideoFrame::PixelFormat QCameraImageCapture::bufferFormat() const } /*! - Sets the buffer image capture format to be used. + Sets the buffer image capture \a format to be used. - \sa BufferFormat() supportedBufferFormats() captureDestination() + \sa bufferFormat() supportedBufferFormats() captureDestination() */ void QCameraImageCapture::setBufferFormat(const QVideoFrame::PixelFormat format) { @@ -626,7 +633,8 @@ void QCameraImageCapture::cancelCapture() /*! \fn QCameraImageCapture::imageMetadataAvailable(int id, const QString &key, const QVariant &value) - Signals that a metadata for an image with request \a id is available. + Signals that a metadata for an image with request \a id is available. Also + includes the \a key and \a value of the metadata. This signal is emitted between imageExposed and imageSaved signals. */ diff --git a/src/multimedia/camera/qcameraimagecapture.h b/src/multimedia/camera/qcameraimagecapture.h index 207938d6c..f050d5206 100644 --- a/src/multimedia/camera/qcameraimagecapture.h +++ b/src/multimedia/camera/qcameraimagecapture.h @@ -117,7 +117,7 @@ public: QList<QVideoFrame::PixelFormat> supportedBufferFormats() const; QVideoFrame::PixelFormat bufferFormat() const; - void setBufferFormat(QVideoFrame::PixelFormat format); + void setBufferFormat(const QVideoFrame::PixelFormat format); bool isCaptureDestinationSupported(CaptureDestinations destination) const; CaptureDestinations captureDestination() const; diff --git a/src/multimedia/camera/qcameraimageprocessing.cpp b/src/multimedia/camera/qcameraimageprocessing.cpp index 990795049..4fe31b317 100644 --- a/src/multimedia/camera/qcameraimageprocessing.cpp +++ b/src/multimedia/camera/qcameraimageprocessing.cpp @@ -96,7 +96,7 @@ QT_BEGIN_NAMESPACE In some cases changing these settings may result in a longer delay before an image is ready. - For more information on image processing of camera frames, see \l {Camera Image Processing}. + For more information on image processing of camera frames, see \l {camera_image_processing}{Camera Image Processing}. \sa QCameraImageProcessingControl */ diff --git a/src/multimedia/controls/qaudiodecodercontrol_p.cpp b/src/multimedia/controls/qaudiodecodercontrol_p.cpp index 72ecd10b7..a6c178b17 100644 --- a/src/multimedia/controls/qaudiodecodercontrol_p.cpp +++ b/src/multimedia/controls/qaudiodecodercontrol_p.cpp @@ -215,7 +215,7 @@ QAudioDecoderControl::QAudioDecoderControl(QObject *parent): */ /*! - \fn QAudioDecoderControl::audioFormat() + \fn QAudioDecoderControl::audioFormat() const Returns the current audio format of the decoded stream. Any buffers returned should have this format. @@ -244,13 +244,13 @@ QAudioDecoderControl::QAudioDecoderControl(QObject *parent): */ /*! - \fn QAudioDecoderControl::position() + \fn QAudioDecoderControl::position() const Returns position (in milliseconds) of the last buffer read from the decoder or -1 if no buffers have been read. */ /*! - \fn QAudioDecoderControl::duration() + \fn QAudioDecoderControl::duration() const Returns total duration (in milliseconds) of the audio stream or -1 if not available. */ diff --git a/src/multimedia/controls/qcameracapturedestinationcontrol.cpp b/src/multimedia/controls/qcameracapturedestinationcontrol.cpp index 8cf6a5bc1..1740120b9 100644 --- a/src/multimedia/controls/qcameracapturedestinationcontrol.cpp +++ b/src/multimedia/controls/qcameracapturedestinationcontrol.cpp @@ -96,7 +96,7 @@ QCameraCaptureDestinationControl::~QCameraCaptureDestinationControl() /*! \fn QCameraCaptureDestinationControl::captureDestination() const - Returns the current capture \a destination. The default destination is QCameraImageCapture::CaptureToFile. + Returns the current capture destination. The default destination is QCameraImageCapture::CaptureToFile. */ /*! diff --git a/src/multimedia/controls/qcamerafeedbackcontrol.cpp b/src/multimedia/controls/qcamerafeedbackcontrol.cpp index 119032be9..0fc390fdb 100644 --- a/src/multimedia/controls/qcamerafeedbackcontrol.cpp +++ b/src/multimedia/controls/qcamerafeedbackcontrol.cpp @@ -139,7 +139,7 @@ QCameraFeedbackControl::~QCameraFeedbackControl() */ /*! - \fn bool QCameraFeedbackControl::setEventFeedbackEnabled(EventType event, bool enabled) const + \fn bool QCameraFeedbackControl::setEventFeedbackEnabled(EventType event, bool enabled) Turns on feedback for the specific \a event if \a enabled is true, otherwise disables the feedback. Returns true if the feedback could be modified, or false otherwise (e.g. this feedback @@ -150,7 +150,7 @@ QCameraFeedbackControl::~QCameraFeedbackControl() /*! - \fn void QCameraFeedbackControl::resetEventFeedback(EventType event) const + \fn void QCameraFeedbackControl::resetEventFeedback(EventType event) Restores the feedback setting for this \a event to its default setting. @@ -158,7 +158,7 @@ QCameraFeedbackControl::~QCameraFeedbackControl() */ /*! - \fn bool setEventFeedbackSound(EventType event, const QString &filePath) + \fn bool QCameraFeedbackControl::setEventFeedbackSound(EventType event, const QString &filePath) When the given \a event occurs, the sound effect referenced by \a filePath will be played instead of the default sound. diff --git a/src/multimedia/controls/qcamerafocuscontrol.cpp b/src/multimedia/controls/qcamerafocuscontrol.cpp index 865072e13..6f5b0598c 100644 --- a/src/multimedia/controls/qcamerafocuscontrol.cpp +++ b/src/multimedia/controls/qcamerafocuscontrol.cpp @@ -169,27 +169,27 @@ QCameraFocusControl::~QCameraFocusControl() /*! \fn void QCameraFocusControl::focusModeChanged(QCameraFocus::FocusModes mode) - Signal is emitted when the focus mode is chaged, + Signal is emitted when the focus \a mode is changed, usually in result of QCameraFocusControl::setFocusMode call or capture mode changes. - \sa QCameraFocusControl::focusMode QCameraFocusControl::setFocusMode + \sa QCameraFocusControl::focusMode() QCameraFocusControl::setFocusMode() */ /*! \fn void QCameraFocusControl::focusPointModeChanged(QCameraFocus::FocusPointMode mode) - Signal is emitted when the focus point mode is chaged, + Signal is emitted when the focus point \a mode is changed, usually in result of QCameraFocusControl::setFocusPointMode call or capture mode changes. - \sa QCameraFocusControl::focusPointMode QCameraFocusControl::setFocusPointMode + \sa QCameraFocusControl::focusPointMode() QCameraFocusControl::setFocusPointMode() */ /*! \fn void QCameraFocusControl::customFocusPointChanged(const QPointF &point) - Signal is emitted when the custom focus point is changed. + Signal is emitted when the custom focus \a point is changed. - \sa QCameraFocusControl::customFocusPoint QCameraFocusControl::setCustomFocusPoint + \sa QCameraFocusControl::customFocusPoint() QCameraFocusControl::setCustomFocusPoint() */ diff --git a/src/multimedia/controls/qcameraimagecapturecontrol.cpp b/src/multimedia/controls/qcameraimagecapturecontrol.cpp index 4384c4c70..da28fdcac 100644 --- a/src/multimedia/controls/qcameraimagecapturecontrol.cpp +++ b/src/multimedia/controls/qcameraimagecapturecontrol.cpp @@ -150,7 +150,9 @@ QCameraImageCaptureControl::~QCameraImageCaptureControl() /*! \fn QCameraImageCaptureControl::imageMetadataAvailable(int id, const QString &key, const QVariant &value) - Signals that a metadata for an image with request \a id is available. + Signals that a metadata for an image with request \a id is available. Signal + also contains the \a key and \a value of the metadata. + This signal should be emitted between imageExposed and imageSaved signals. */ diff --git a/src/multimedia/controls/qmediaaudioprobecontrol.cpp b/src/multimedia/controls/qmediaaudioprobecontrol.cpp index ba9a1b700..834f6de62 100644 --- a/src/multimedia/controls/qmediaaudioprobecontrol.cpp +++ b/src/multimedia/controls/qmediaaudioprobecontrol.cpp @@ -88,7 +88,7 @@ QMediaAudioProbeControl::~QMediaAudioProbeControl() /*! \fn QMediaAudioProbeControl::audioBufferProbed(const QAudioBuffer &buffer) - This signal should be emitted when an audio buffer is processed in the + This signal should be emitted when an audio \a buffer is processed in the media service. */ diff --git a/src/multimedia/controls/qmediagaplessplaybackcontrol.cpp b/src/multimedia/controls/qmediagaplessplaybackcontrol.cpp index 0b8be4cbf..0230e0a7c 100644 --- a/src/multimedia/controls/qmediagaplessplaybackcontrol.cpp +++ b/src/multimedia/controls/qmediagaplessplaybackcontrol.cpp @@ -99,13 +99,13 @@ QMediaGaplessPlaybackControl::QMediaGaplessPlaybackControl(QObject *parent): /*! \fn QMediaGaplessPlaybackControl::setNextMedia(const QMediaContent& media) - Sets the next media for smooth transition. + Sets the next \a media for smooth transition. */ /*! \fn QMediaGaplessPlaybackControl::nextMediaChanged(const QMediaContent& media) - Signals that the next media has changed (either explicitly via \l setNextMedia() or when the + Signals that the next \a media has changed (either explicitly via \l setNextMedia() or when the player clears the next media while advancing to it). \sa nextMedia() @@ -123,7 +123,7 @@ QMediaGaplessPlaybackControl::QMediaGaplessPlaybackControl(QObject *parent): \fn QMediaGaplessPlaybackControl::isCrossfadeSupported() const Indicates whether crossfading is supported or not. - If crossfading is not supported, \l setCrossfadTime() will be ignored and \l crossfadeTime() will + If crossfading is not supported, \l setCrossfadeTime() will be ignored and \l crossfadeTime() will always return 0. */ @@ -131,7 +131,7 @@ QMediaGaplessPlaybackControl::QMediaGaplessPlaybackControl(QObject *parent): /*! \fn QMediaGaplessPlaybackControl::setCrossfadeTime(qreal crossfadeTime) - Sets the crossfade time in seconds for smooth transition. + Sets the \a crossfadeTime in seconds for smooth transition. Positive value means how much time it will take for the next media to transit from silent to full volume and vice versa for current one. So both current and the next one will be playing @@ -151,7 +151,7 @@ QMediaGaplessPlaybackControl::QMediaGaplessPlaybackControl(QObject *parent): /*! \fn QMediaGaplessPlaybackControl::crossfadeTimeChanged(qreal crossfadeTime) - Signals that the crossfade time has changed. + Signals that the \a crossfadeTime has changed. \sa crossfadeTime() */ diff --git a/src/multimedia/controls/qmedianetworkaccesscontrol.cpp b/src/multimedia/controls/qmedianetworkaccesscontrol.cpp index 5d1f9072b..4554072e9 100644 --- a/src/multimedia/controls/qmedianetworkaccesscontrol.cpp +++ b/src/multimedia/controls/qmedianetworkaccesscontrol.cpp @@ -59,6 +59,9 @@ QT_BEGIN_NAMESPACE usage by the supported QMediaObject. */ +/*! + \internal +*/ QMediaNetworkAccessControl::QMediaNetworkAccessControl(QObject *parent) : QMediaControl(parent) { @@ -81,7 +84,7 @@ QMediaNetworkAccessControl::~QMediaNetworkAccessControl() and replaced with the new list. */ -/* +/*! \fn QNetworkConfiguration QMediaNetworkAccessControl::currentConfiguration() const Returns the current active configuration in use. diff --git a/src/multimedia/controls/qmediavideoprobecontrol.cpp b/src/multimedia/controls/qmediavideoprobecontrol.cpp index 0193896cc..67d6bf523 100644 --- a/src/multimedia/controls/qmediavideoprobecontrol.cpp +++ b/src/multimedia/controls/qmediavideoprobecontrol.cpp @@ -88,7 +88,7 @@ QMediaVideoProbeControl::~QMediaVideoProbeControl() /*! \fn QMediaVideoProbeControl::videoFrameProbed(const QVideoFrame &frame) - This signal should be emitted when a video frame is processed in the + This signal should be emitted when a video \a frame is processed in the media service. */ diff --git a/src/multimedia/controls/qradiodatacontrol.cpp b/src/multimedia/controls/qradiodatacontrol.cpp index 4d9970275..8f56b161d 100644 --- a/src/multimedia/controls/qradiodatacontrol.cpp +++ b/src/multimedia/controls/qradiodatacontrol.cpp @@ -154,6 +154,12 @@ QRadioDataControl::~QRadioDataControl() */ /*! + \fn QRadioDataControl::alternativeFrequenciesEnabledChanged(bool enabled) + + Signals that the alternative frequencies setting has changed to the value of \a enabled. +*/ + +/*! \fn void QRadioDataControl::stationIdChanged(QString stationId) Signals that the Program Identification \a stationId has changed diff --git a/src/multimedia/controls/qradiotunercontrol.cpp b/src/multimedia/controls/qradiotunercontrol.cpp index ca47ca663..573812c31 100644 --- a/src/multimedia/controls/qradiotunercontrol.cpp +++ b/src/multimedia/controls/qradiotunercontrol.cpp @@ -243,9 +243,10 @@ QRadioTunerControl::~QRadioTunerControl() */ /*! - \fn void QRadioTunerControl::searchAllStations() + \fn void QRadioTunerControl::searchAllStations(QRadioTuner::SearchMode searchMode) - Starts a scan through the whole frequency band searching all stations + Starts a scan through the whole frequency band searching all stations with a + specific \a searchMode. */ /*! @@ -328,9 +329,9 @@ QRadioTunerControl::~QRadioTunerControl() */ /*! - \fn void QRadioTunerControl::stationFound(int frequency) + \fn void QRadioTunerControl::stationFound(int frequency, QString stationId) - Signals that new station with \a frequency was found when scanning + Signals that new station with \a frequency and \a stationId was found when scanning */ /*! diff --git a/src/multimedia/playback/qmediaplaylistioplugin.cpp b/src/multimedia/playback/qmediaplaylistioplugin.cpp index 99ff8b038..5dd0f189f 100644 --- a/src/multimedia/playback/qmediaplaylistioplugin.cpp +++ b/src/multimedia/playback/qmediaplaylistioplugin.cpp @@ -162,12 +162,6 @@ QMediaPlaylistIOPlugin::~QMediaPlaylistIOPlugin() */ /*! - \fn QMediaPlaylistIOPlugin::keys() const - - Returns a list of format keys supported by a plug-in. -*/ - -/*! \fn QMediaPlaylistIOPlugin::createReader(QIODevice *device, const QByteArray &format) Returns a new QMediaPlaylistReader which reads \a format data from an I/O \a device. diff --git a/src/multimedia/playback/qmediaresource.cpp b/src/multimedia/playback/qmediaresource.cpp index 1f45c4443..92610caa9 100644 --- a/src/multimedia/playback/qmediaresource.cpp +++ b/src/multimedia/playback/qmediaresource.cpp @@ -93,6 +93,8 @@ namespace \typedef QMediaResourceList Synonym for \c QList<QMediaResource> + + \relates QMediaResource */ /*! diff --git a/src/multimedia/qmediaobject.cpp b/src/multimedia/qmediaobject.cpp index 3e5773cf1..dfb7a46e2 100644 --- a/src/multimedia/qmediaobject.cpp +++ b/src/multimedia/qmediaobject.cpp @@ -410,6 +410,12 @@ void QMediaObject::setupControls() Signal emitted when the availability state has changed to \a available */ +/*! + \fn QMediaObject::availabilityErrorChanged(QtMultimedia::AvailabilityError error) + + Signal emitted when the availability error has changed to \a error +*/ + #include "moc_qmediaobject.cpp" QT_END_NAMESPACE diff --git a/src/multimedia/qmediaserviceprovider.cpp b/src/multimedia/qmediaserviceprovider.cpp index 46d7c2f5c..6be99d243 100644 --- a/src/multimedia/qmediaserviceprovider.cpp +++ b/src/multimedia/qmediaserviceprovider.cpp @@ -651,12 +651,6 @@ QMediaServiceProvider *QMediaServiceProvider::defaultServiceProvider() */ /*! - \fn QMediaServiceProviderPlugin::keys() const - - Returns a list of keys for media services a plug-in can create. -*/ - -/*! \fn QMediaServiceProviderPlugin::create(const QString &key) Constructs a new instance of the QMediaService identified by \a key. diff --git a/src/multimedia/qmediatimerange.cpp b/src/multimedia/qmediatimerange.cpp index 37a638ba4..0e021fb94 100644 --- a/src/multimedia/qmediatimerange.cpp +++ b/src/multimedia/qmediatimerange.cpp @@ -477,7 +477,7 @@ void QMediaTimeRange::addInterval(qint64 start, qint64 end) If the specified interval is adjacent to, or overlaps existing intervals within the time range, these intervals will be merged. - This operation takes \l{linear time} + This operation takes linear time. \sa removeInterval() */ @@ -526,7 +526,7 @@ void QMediaTimeRange::removeInterval(qint64 start, qint64 end) such that no intervals within the time range include any part of the target interval. - This operation takes \l{linear time} + This operation takes linear time. \sa addInterval() */ @@ -689,6 +689,7 @@ bool operator!=(const QMediaTimeRange &a, const QMediaTimeRange &b) /*! \fn operator+(const QMediaTimeRange &r1, const QMediaTimeRange &r2) + \relates QMediaTimeRange Returns a time range containing the union between \a r1 and \a r2. */ @@ -699,6 +700,7 @@ QMediaTimeRange operator+(const QMediaTimeRange &r1, const QMediaTimeRange &r2) /*! \fn operator-(const QMediaTimeRange &r1, const QMediaTimeRange &r2) + \relates QMediaTimeRange Returns a time range containing \a r2 subtracted from \a r1. */ diff --git a/src/multimedia/radio/qradiodata.cpp b/src/multimedia/radio/qradiodata.cpp index 7a1fe1b49..1aa39647d 100644 --- a/src/multimedia/radio/qradiodata.cpp +++ b/src/multimedia/radio/qradiodata.cpp @@ -113,7 +113,7 @@ void QRadioDataPrivate::_q_serviceDestroyed() } /*! - Constructs a radio data based on a media object. + Constructs a radio data based on a \a mediaObject and \a parent. The \a mediaObject should be an instance of \l QRadioTuner. It is preferable to use the \l{QRadioTuner::radioData()}{radioData} property on a QRadioTuner instance to get an instance diff --git a/src/multimedia/radio/qradiotuner.cpp b/src/multimedia/radio/qradiotuner.cpp index 32fd14426..656043d23 100644 --- a/src/multimedia/radio/qradiotuner.cpp +++ b/src/multimedia/radio/qradiotuner.cpp @@ -104,7 +104,8 @@ public: /*! - Constructs a radio tuner based on a media service allocated by a media service \a provider. + Constructs a radio tuner based on a media service allocated by the default + media service provider. The \a parent is passed to QMediaObject. */ diff --git a/src/multimedia/video/qvideoprobe.cpp b/src/multimedia/video/qvideoprobe.cpp index 49d78c4a6..21e658c6a 100644 --- a/src/multimedia/video/qvideoprobe.cpp +++ b/src/multimedia/video/qvideoprobe.cpp @@ -83,7 +83,7 @@ public: }; /*! - Creates a new QVideoProbe class. After setting the + Creates a new QVideoProbe class with \a parent. After setting the source to monitor with \l setSource(), the \l videoFrameProbed() signal will be emitted when video frames are flowing in the source media object. @@ -160,8 +160,8 @@ bool QVideoProbe::setSource(QMediaObject *source) /*! Starts monitoring the given \a mediaRecorder. - If \a source is zero, this probe will be deactivated - and this function wil return true. + If there is no mediaObject associated with \a mediaRecorder, or if it is + zero, this probe will be deactivated and this function wil return true. If the media recorder instance does not support monitoring video, this function will return false. @@ -197,7 +197,7 @@ bool QVideoProbe::isActive() const /*! \fn QVideoProbe::videoFrameProbed(const QVideoFrame &frame) - This signal should be emitted when a video frame is processed in the + This signal should be emitted when a video \a frame is processed in the media service. */ diff --git a/src/multimediawidgets/qgraphicsvideoitem_maemo6.cpp b/src/multimediawidgets/qgraphicsvideoitem_maemo6.cpp index cdd8f66d0..de9de9fef 100644 --- a/src/multimediawidgets/qgraphicsvideoitem_maemo6.cpp +++ b/src/multimediawidgets/qgraphicsvideoitem_maemo6.cpp @@ -200,6 +200,7 @@ void QGraphicsVideoItemPrivate::_q_serviceDestroyed() /* \class QGraphicsVideoItem + \brief The QGraphicsVideoItem class provides a graphics item which display video produced by a QMediaObject. \inmodule QtMultimedia @@ -247,7 +248,7 @@ QGraphicsVideoItem::QGraphicsVideoItem(QGraphicsItem *parent) this, SLOT(_q_updateNativeSize()), Qt::QueuedConnection); } -/*! +/* Destroys a video graphics item. */ QGraphicsVideoItem::~QGraphicsVideoItem() |