/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** 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.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \page qtmultimedia-index.html
    \title Qt Multimedia
    \brief The Qt Multimedia module provides APIs for audio, video, radio, and
    camera-related functionality.

    Qt Multimedia is an essential module that provides a rich set of QML types
    and C++ classes to handle multimedia content. It also provides necessary
    APIs to access the camera and radio functionality. The included
    \l{Qt Audio Engine QML Types}{Qt Audio Engine} provides types for
    3D positional audio playback and management.

    The \l{Qt Multimedia Widgets} module provides widget based multimedia
    classes.

   \section1 Getting Started

    The QML types can be imported into your applciation using the following
    import statement in your \c {.qml} file.

    \code
     import QtMultimedia 5.0
    \endcode

    If you intend to use the C++ classes in your application, include the C++
    definitions using the following directive:

    \code
      #include <QtMultimedia>
    \endcode

    \note If you are using a few classes from this module, we recommend
    including those specific classes only instead of the module.

    To link against the corresponding C++ libraries, add the following to your
    \c {qmake} project file:

   \code
     QT += multimedia
   \endcode

    \section1 QML Types and C++ Classes

    The following is a list of important QML types and C++ classes provided by
    this module:

    \table
    \header
     \li Type
     \li Description
    \row
     \li \l {QtMultimedia::Audio}{Audio}
     \li Add audio playback functionality to a scene
    \row
     \li \l {QtMultimedia::Camera}{Camera}
     \li Access camera viewfinder frames
    \row
     \li MediaPlayer
     \li Add media playback functionality to a scene. It is same as Audio type,
     but can be used for video playback with the VideoOutput type.
    \row
     \li \l {QtMultimedia::Radio}{Radio}
     \li Access radio functionality
    \row
     \li \l {QtMultimedia::Video}{Video}
     \li Add Video playback functionality to a scene. It uses MediaPlayer and
     VideoOutput types to provide video playback functionality.
    \endtable

    \table
    \header
     \li Class
     \li Description
    \row
     \li QAudioOutput
     \li Sends audio data to an audio output device
    \row
     \li QCamera
     \li Access camera viewfinder.
    \row
     \li QCameraImageCapture
     \li Record media content. Intended to be used with QCamera to record media.
    \row
     \li QMediaPlayer
     \li Playback media from a source.
    \row
     \li QRadioTuner
     \li Access radio device.
    \row
     \li QVideoRendererControl
     \li Control video data.
    \endtable

    \section1 Related Information

    \section2 Guides
     \list
      \li \l Multimedia - overview of multimedia support in Qt
      \li \l{Audio Overview}
      \li \l{Video Overview}
      \li \l{Camera Overview}
      \li \l{Radio Overview}
     \endlist

    \section2 Platform Notes
     \list
      \li \l{Qt Multimedia on BlackBerry}{BlackBerry}
      \li \l{Qt Multimedia on Windows}{Windows}
     \endlist

    \section2 Reference
    \list
    \li Qt Multimedia
    \list
        \li \l{Qt Multimedia QML Types}{QML Types}
        \li \l{Qt Multimedia C++ Classes}{C++ Classes}
    \endlist
    \endlist

    \list
    \li Qt Audio Engine
    \list
        \li \l{Qt Audio Engine QML Types}{QML Types}
    \endlist
    \endlist

    \section2 Examples
     \list
      \li \l{Qt Multimedia Examples}
     \endlist
*/
