d1b6bf5fac
QDoc now has support for Doxygen style commands for italics, bold and list items. This change applies that change in QDoc to the actual documentation. Task-number: QTBUG-24578 Change-Id: Iec1c616e0d9a915a31a661916805916e19495dc9 Reviewed-by: Michael Goddard <michael.goddard@nokia.com>
158 lines
6.4 KiB
Plaintext
158 lines
6.4 KiB
Plaintext
/****************************************************************************
|
|
**
|
|
** 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 QtMultimedia
|
|
\brief A description of changes in this version of QtMultimedia
|
|
|
|
|
|
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
|
|
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).
|
|
|
|
One other change of note is that widget related classes (like \l QVideoWidget)
|
|
are now in a new library (QtMultimediaWidgets).
|
|
|
|
\section1 New features in 5.0
|
|
|
|
There are a number of new features in QtMultimedia 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 elements 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 QtMultimedia or QtMultimediaKit 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 QtMultimedia or QtMultimediaKit 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 QtMultimediaKit 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
|
|
\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
|
|
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
|
|
source code will mostly be compatible unless you have created variables or
|
|
parameters with the QtMultimedia::MetaData type - you should replace these
|
|
with QStrings.
|
|
\row
|
|
\li Meta-data method changes
|
|
\li In QtMultimediaKit 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 QtMultimedia 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.
|
|
\row
|
|
\li Video QML element
|
|
\li If you've previously used the Video QML element you may be excited
|
|
to learn that it should still work as expected, but you also have
|
|
the choice of using the new MediaPlayer and VideoOutput elements
|
|
together for more flexible and advanced use cases.
|
|
\row
|
|
\li QSoundEffect
|
|
\li The SoundEffect QML element was public and accessible in QtMultimedaKit,
|
|
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
|
|
|
|
*/
|