/**************************************************************************** ** ** 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$ ** ****************************************************************************/ /*! \page changes.html \title Changes in Qt Multimedia \brief A description of changes in this version of Qt Multimedia 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 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 (Qt Multimedia Widgets). \section1 New features in 5.0 There are a number of new features in Qt Multimedia 5.0: \list \li Expanded QML API \li New \l QAudioRecorder class \li Volume support for QAudioOutput and QAudioInput \li More examples and documentation \li QML \l Torch class \li QSound moved from QtGui to QtMultimedia \li QSoundEffect available to C++ now, as well as QML \li FM Radio Data System classes and types now available (\l QRadioData, \l RadioData) \li Various other API improvements and bugfixes \endlist \section1 Removed features A number of classes or features previously offered in Qt Multimedia or Qt Multimedia Kit have been removed. \table 70% \header \li Removed feature \li Notes \row \li QMediaImageViewer \li This class (and related controls and services) were removed since their functionality was not suitable for many applications \endtable \section1 Changed features 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. \table 70% \header \li Changed feature \li Notes \row \li qmake .pro file changes \li If you've used QtMultimediaKit in the past, you needed to put \code CONFIG += mobility MOBILITY += multimedia \endcode in your .pro file. Now you need to use: \code QT += multimedia \endcode or \code QT += multimedia multimediawidgets \endcode if you need to use the widget classes. \row \li Namespace changes \li For Qt Multimedia Kit the majority of the classes were in the normal Qt namespace (usually nothing, unless built specially). There 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 AvailabilityStatus enumerations you'll need to change your code. In fact, running a global 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 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 \c {QtMultimedia::MetaData} type - you should replace these with \c QString. \row \li Meta-data method changes \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 you've used the \c extendedMetaData method of any class, you will need to change your code to combine the standard and extended metadata methods. \row \li Qt Metatype registration \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 Qt Multimedia class you will probably need to remove them. \row \li Video QML type \li If you've previously used \l Video you may be excited to learn that it should still work as expected, but you also have the choice of using \l MediaPlayer and \l VideoOutput together for more flexible and advanced use cases. \row \li QSoundEffect \li The SoundEffect QML type 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 \li Camera controls \li A large number of the camera controls (QCameraImageProcessingControl, QCameraFocusControl etc) have been updated to address a number of design flaws. If you have previously been using these classes, you should check the new design. In particular, a number of discrete accessor methods have been collapsed into parametrized methods, and the range or data type of some parameters has been adjusted. \endtable */