blob: ed4dbd58e518439215c2dbcd59218653b46ec16a (
plain)
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
|
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only
#include "qaudiolistener.h"
#include "qaudioengine_p.h"
#include "resonance_audio.h"
#include <qaudiosink.h>
#include <qurl.h>
#include <qdebug.h>
#include <qaudiodecoder.h>
QT_BEGIN_NAMESPACE
class QAudioListenerPrivate
{
public:
QAudioEngine *engine = nullptr;
QVector3D pos;
QQuaternion rotation;
};
/*!
\class QAudioListener
\inmodule QtSpatialAudio
\ingroup spatialaudio
\ingroup multimedia_audio
\brief Defines the position and orientation of the person listening to a sound field
defined by QAudioEngine.
A QAudioEngine can have exactly one listener that defines the position and orientation
of the person listening to the sound field.
*/
/*!
Creates a listener for the spatial audio engine for \a engine.
*/
QAudioListener::QAudioListener(QAudioEngine *engine)
: d(new QAudioListenerPrivate)
{
setEngine(engine);
}
/*!
Destroys the listener.
*/
QAudioListener::~QAudioListener()
{
// Unregister this listener from the engine
setEngine(nullptr);
delete d;
}
/*!
Sets the listener's position in 3D space to \a pos. Units are in centimeters
by default.
\sa QAudioEngine::distanceScale
*/
void QAudioListener::setPosition(QVector3D pos)
{
auto *ep = QAudioEnginePrivate::get(d->engine);
if (!ep)
return;
pos *= ep->distanceScale;
if (d->pos == pos)
return;
d->pos = pos;
if (ep && ep->resonanceAudio->api) {
ep->resonanceAudio->api->SetHeadPosition(pos.x(), pos.y(), pos.z());
ep->listenerPositionDirty = true;
}
}
/*!
Returns the current position of the listener.
*/
QVector3D QAudioListener::position() const
{
auto *ep = QAudioEnginePrivate::get(d->engine);
if (!ep)
return QVector3D();
return d->pos/ep->distanceScale;
}
/*!
Sets the listener's orientation in 3D space to \a q.
*/
void QAudioListener::setRotation(const QQuaternion &q)
{
d->rotation = q;
auto *ep = QAudioEnginePrivate::get(d->engine);
if (ep && ep->resonanceAudio->api)
ep->resonanceAudio->api->SetHeadRotation(d->rotation.x(), d->rotation.y(), d->rotation.z(), d->rotation.scalar());
}
/*!
Returns the listener's orientation in 3D space.
*/
QQuaternion QAudioListener::rotation() const
{
return d->rotation;
}
/*!
\internal
*/
void QAudioListener::setEngine(QAudioEngine *engine)
{
if (d->engine) {
auto *ed = QAudioEnginePrivate::get(d->engine);
ed->listener = nullptr;
}
d->engine = engine;
if (d->engine) {
auto *ed = QAudioEnginePrivate::get(d->engine);
if (ed->listener) {
qWarning() << "Ignoring attempt to add a second listener to the spatial audio engine.";
d->engine = nullptr;
return;
}
ed->listener = this;
}
}
/*!
Returns the engine associated with this listener.
*/
QAudioEngine *QAudioListener::engine() const
{
return d->engine;
}
QT_END_NAMESPACE
|
