1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/****************************************************************************
**
** Copyright (C) 2022 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Spatial Audio module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL-NOGPL2$
** 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 The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include <qquick3dspatialaudioengine_p.h>
#include <qaudiodevice.h>
QT_BEGIN_NAMESPACE
static QSpatialAudioEngine *globalEngine = nullptr;
/*!
\qmltype SpatialAudioEngine
\inqmlmodule QtQuick3D.SpatialAudio
\ingroup quick3d_spatialaudio
\brief SpatialAudioEngine manages sound objects inside a 3D scene.
SpatialAudioEngine manages sound objects inside a 3D scene. You can add
SpatialAudioSoundSource objects to the scene to define sounds that happen
at a specified location in 3D space. SpatialAudioStereoSource allows you to add
a stereo overlay (for example voice over or a sound track).
You can use SpatialAudioListener to define the position of the person listening
to the sound field relative to the sound sources. Sound sources will be less audible
if the listener is further away from source. They will also get mapped to the corresponding
loudspeakers depending on the direction between listener and source. In many cases, the
SpatialAudioListener object can simply be instantiated as a child object of the QtQuick3D.Camera
object.
Create SpatialAudioRoom objcects to simulate the sound (reflections and reverb) of a room with
certain dimensions and different types of walls.
SpatialAudioEngine does offer a mode where Qt is using simulating the effects of the ear
using head related impulse reponse functions (see also https://en.wikipedia.org/wiki/Sound_localization)
to localize the sound in 3D space when using headphones and create a spatial audio effect through
headphones.
*/
QQuick3DSpatialAudioEngine::QQuick3DSpatialAudioEngine()
{
auto *e = getEngine();
connect(e, &QSpatialAudioEngine::outputModeChanged, this, &QQuick3DSpatialAudioEngine::outputModeChanged);
connect(e, &QSpatialAudioEngine::outputDeviceChanged, this, &QQuick3DSpatialAudioEngine::outputDeviceChanged);
connect(e, &QSpatialAudioEngine::masterVolumeChanged, this, &QQuick3DSpatialAudioEngine::masterVolumeChanged);
}
QQuick3DSpatialAudioEngine::~QQuick3DSpatialAudioEngine()
{
}
/*!
\qmlproperty enumeration SpatialAudioEngine::outputMode
Sets or retrieves the current output mode of the engine.
\table
\header \li Property value
\li Description
\row \li Normal
\li Map the sounds to the loudspeaker configuration of the output device.
This is normally a stereo or surround speaker setup.
\row \li Headphone
\li Use Headphone spatialization to create a 3D audio effect when listening
to the sound field through headphones.
\endtable
*/
void QQuick3DSpatialAudioEngine::setOutputMode(OutputMode mode)
{
globalEngine->setOutputMode(QSpatialAudioEngine::OutputMode(mode));
}
QQuick3DSpatialAudioEngine::OutputMode QQuick3DSpatialAudioEngine::outputMode() const
{
return OutputMode(globalEngine->outputMode());
}
/*!
\qmlproperty QtMultimedia.AudioDevice SpatialAudioEngine::outputDevice
Sets or returns the device that is being used for outputting the sound field.
*/
void QQuick3DSpatialAudioEngine::setOutputDevice(const QAudioDevice &device)
{
globalEngine->setOutputDevice(device);
}
QAudioDevice QQuick3DSpatialAudioEngine::outputDevice() const
{
return globalEngine->outputDevice();
}
/*!
\qmlproperty float SpatialAudioEngine::masterVolume
Sets or returns overall volume being used to render the sound field.
*/
void QQuick3DSpatialAudioEngine::setMasterVolume(float volume)
{
globalEngine->setMasterVolume(volume);
}
float QQuick3DSpatialAudioEngine::masterVolume() const
{
return globalEngine->masterVolume();
}
QSpatialAudioEngine *QQuick3DSpatialAudioEngine::getEngine()
{
if (!globalEngine) {
globalEngine = new QSpatialAudioEngine;
globalEngine->start();
}
return globalEngine;
}
QT_END_NAMESPACE
#include "moc_qquick3dspatialaudioengine_p.cpp"
|
