qquick3dxrcontroller_p.h

Go to the documentation of this file.

// Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
 
#ifndef QQUICK3DXRCONTROLLER_H
#define QQUICK3DXRCONTROLLER_H
 
//
//  W A R N I N G
//  -------------
//
// This file is not part of the Qt API.  It exists purely as an
// implementation detail.  This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
 
#include <QtQuick3DXr/qtquick3dxrglobal.h>
#include "qquick3dxrhandinput_p.h"
#include "qtquick3dxrglobal_p.h"
#include <QtQuick3D/private/qquick3dnode_p.h>
#include <QtQml/QQmlEngine>
 
QT_BEGIN_NAMESPACE
 
class QQuaternion;
class QQuick3DXrInputManager;
 
class Q_QUICK3DXR_EXPORT QQuick3DXrController : public QQuick3DNode
{
    Q_OBJECT
    Q_PROPERTY(Controller controller READ controller WRITE setController NOTIFY controllerChanged FINAL)
    Q_PROPERTY(bool isActive READ isActive NOTIFY isActiveChanged FINAL)
    Q_PROPERTY(HandPoseSpace poseSpace READ poseSpace WRITE setPoseSpace NOTIFY poseSpaceChanged FINAL)
 
    Q_PROPERTY(QVector3D pokePosition READ pokePosition NOTIFY pokePositionChanged FINAL)
    Q_PROPERTY(QList<QVector3D> jointPositions READ jointPositions NOTIFY jointPositionsChanged FINAL)
    Q_PROPERTY(QList<QQuaternion> jointRotations READ jointRotations NOTIFY jointRotationsChanged FINAL)
 
    QML_NAMED_ELEMENT(XrController)
    QML_ADDED_IN_VERSION(6, 8)
public:
    enum Controller {
        ControllerLeft = 0,
        ControllerRight = 1,
        ControllerNone = 2,
        LeftController = ControllerLeft,
        RightController = ControllerRight,
        LeftHand = ControllerLeft,
        RightHand = ControllerRight,
        UnknownController = ControllerNone,
    };
    Q_ENUM(Controller)
 
    enum class HandPoseSpace {
        GripPose,
        AimPose
    };
    Q_ENUM(HandPoseSpace)
 
    QQuick3DXrController();
 
    QQuick3DXrController::Controller controller() const;
    void setController(QQuick3DXrController::Controller newController);
 
    QQuick3DXrHandInput *handInput() const;
 
    HandPoseSpace poseSpace() const;
    void setPoseSpace(HandPoseSpace newPoseSpace);
 
    QVector3D pokePosition() const;
 
    QList<QVector3D> jointPositions() const;
    QList<QQuaternion> jointRotations() const;
 
    bool isActive() const;
 
Q_SIGNALS:
    void controllerChanged();
    void actionMapperChanged();
 
    void poseSpaceChanged();
 
    void pokePositionChanged();
 
    void jointPositionsChanged();
    void jointRotationsChanged();
    void jointDataUpdated();
 
    void isActiveChanged();
 
private:
    QPointer<QQuick3DXrInputManager> m_inputManager;
    Controller m_controller = ControllerNone;
    QMetaObject::Connection m_isActiveConnection;
    HandPoseSpace m_poseSpace = HandPoseSpace::AimPose;
    QVector3D m_pokePosition;
    bool m_isActive;
};
 
namespace QtQuick3DXr
{
QtQuick3DXr::Hand handForController(QQuick3DXrController::Controller controller);
QtQuick3DXr::HandPoseSpace pose_cast(QQuick3DXrController::HandPoseSpace poseSpace);
}
 
QT_END_NAMESPACE
 
#endif // QQUICK3DXRCONTROLLER_H