qtspatialaudio-index.qdoc

Go to the documentation of this file.

// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
 
/*!
    \page qtspatialaudio-index.html
    \title Qt Spatial Audio
    \brief The Qt Spatial Audio module provides APIs for modeling sound source
    and their surrounds in 3D space
 
    Qt Spatial Audio is an add-on module that provides a rich set of QML types
    and C++ classes to implement sound fields in 3D space. It contains an easy to use
    API for positing a listener in space, adding localized sound sources around the
    listener and emulating virtual rooms with reverb and reflections.
 
    \section1 Getting started
 
    \include cmake-find-package-multimedia.qdocinc {qml-import-intro} {Qt Spatial Audio} {import QtQuick3D.SpatialAudio}
 
    To link against the C++ libraries, add the following to your project's
    \c CMakeLists.txt file. Substitute \c mytarget with the name of your
    project.
 
    \include cmake-find-package-multimedia.qdocinc {find-and-link} {SpatialAudio} {PRIVATE} {Qt6::SpatialAudio}
 
   \l{Spatial Audio Overview} provides a more detailed description about how
   to use the different classes listed below.
 
    \section1 QML Types
 
    The following table outlines some important QML types.
 
    \table
    \header
     \li Type
     \li Description
    \row
     \li \l{AudioEngine}
     \li The engine doing the processing of the audio scene
    \row
     \li \l {SpatialSound}
     \li A sound source located in 3D space.
    \row
     \li \l {AmbientSound}
     \li A location independent stereo sound track.
    \row
     \li \l {AudioRoom}
     \li Defines a room that generates audio reverb and reflections.
    \endtable
 
    \section1 C++ Classes
 
    The following table outlines some important C++ Classes
 
    \table
    \header
     \li Class
     \li Description
    \row
     \li \l{QAudioEngine}
     \li The engine doing the processing of the audio scene
    \row
     \li \l {QSpatialSound}
     \li A sound source located in 3D space.
    \row
     \li \l {QAmbientSound}
     \li A location independent stereo sound track.
    \row
     \li \l {QAudioRoom}
     \li Defines a room that generates audio reverb and reflections.
    \endtable
 
    \section1 Licenses and Attributions
 
    The Qt Spatial Audio module is available under commercial licenses from
    \l{The Qt Company}.
    In addition, it is available under free software licenses. These free software
    licenses are
    \l{GNU Lesser General Public License, version 3}, or
    the \l{GNU General Public License, version 3}.
    See \l{Qt Licensing} for further details.
 
    Note that Qt Spatial Audio is not available under the \l{GNU General Public License, version 2}.
 
    Furthermore, Qt Spatial Audio in Qt \QtVersion contains third party
    modules under the following permissive licenses:
 
    \annotatedlist attributions-qtspatialaudio
 
    \section1 Reference and Examples
    \list
      \li \l{Qt Spatial Audio QML Types}{QML Types}
      \li \l{Qt Spatial Audio C++ Classes}{C++ Classes}
      \li \l{Qt Spatial Audio Examples}{Examples}
    \endlist
*/