1// Copyright (C) 2024 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
3
4#ifndef QQUICK3DXRCONTROLLER_H
5#define QQUICK3DXRCONTROLLER_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists purely as an
12// implementation detail. This header file may change from version to
13// version without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include <QtQuick3DXr/qtquick3dxrglobal.h>
19#include "qquick3dxrhandinput_p.h"
20#include "qtquick3dxrglobal_p.h"
21#include <QtQuick3D/private/qquick3dnode_p.h>
22#include <QtQml/QQmlEngine>
23
24QT_BEGIN_NAMESPACE
25
26class QQuaternion;
27class QQuick3DXrInputManager;
28
29class Q_QUICK3DXR_EXPORT QQuick3DXrController : public QQuick3DNode
30{
31 Q_OBJECT
32 Q_PROPERTY(Controller controller READ controller WRITE setController NOTIFY controllerChanged FINAL)
33 Q_PROPERTY(bool isActive READ isActive NOTIFY isActiveChanged FINAL)
34 Q_PROPERTY(HandPoseSpace poseSpace READ poseSpace WRITE setPoseSpace NOTIFY poseSpaceChanged FINAL)
35
36 Q_PROPERTY(QVector3D pokePosition READ pokePosition NOTIFY pokePositionChanged FINAL)
37 Q_PROPERTY(QList<QVector3D> jointPositions READ jointPositions NOTIFY jointPositionsChanged FINAL)
38 Q_PROPERTY(QList<QQuaternion> jointRotations READ jointRotations NOTIFY jointRotationsChanged FINAL)
39
40 QML_NAMED_ELEMENT(XrController)
41 QML_ADDED_IN_VERSION(6, 8)
42public:
43 enum Controller {
44 ControllerLeft = 0,
45 ControllerRight = 1,
46 ControllerNone = 2,
47 LeftController = ControllerLeft,
48 RightController = ControllerRight,
49 LeftHand = ControllerLeft,
50 RightHand = ControllerRight,
51 UnknownController = ControllerNone,
52 };
53 Q_ENUM(Controller)
54
55 enum class HandPoseSpace {
56 GripPose,
57 AimPose
58 };
59 Q_ENUM(HandPoseSpace)
60
61 QQuick3DXrController();
62
63 QQuick3DXrController::Controller controller() const;
64 void setController(QQuick3DXrController::Controller newController);
65
66 QQuick3DXrHandInput *handInput() const;
67
68 HandPoseSpace poseSpace() const;
69 void setPoseSpace(HandPoseSpace newPoseSpace);
70
71 QVector3D pokePosition() const;
72
73 QList<QVector3D> jointPositions() const;
74 QList<QQuaternion> jointRotations() const;
75
76 bool isActive() const;
77
78Q_SIGNALS:
79 void controllerChanged();
80 void actionMapperChanged();
81
82 void poseSpaceChanged();
83
84 void pokePositionChanged();
85
86 void jointPositionsChanged();
87 void jointRotationsChanged();
88 void jointDataUpdated();
89
90 void isActiveChanged();
91
92private:
93 QPointer<QQuick3DXrInputManager> m_inputManager;
94 Controller m_controller = ControllerNone;
95 QMetaObject::Connection m_isActiveConnection;
96 HandPoseSpace m_poseSpace = HandPoseSpace::AimPose;
97 QVector3D m_pokePosition;
98 bool m_isActive;
99};
100
101namespace QtQuick3DXr
102{
103QtQuick3DXr::Hand handForController(QQuick3DXrController::Controller controller);
104QtQuick3DXr::HandPoseSpace pose_cast(QQuick3DXrController::HandPoseSpace poseSpace);
105}
106
107QT_END_NAMESPACE
108
109#endif // QQUICK3DXRCONTROLLER_H
110

source code of qtquick3d/src/xr/quick3dxr/qquick3dxrcontroller_p.h