blob: 338826d584ee6b5735b7dd29321b9db127f524d7 (
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
|
// 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()
{
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);
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);
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
|