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
// Qt-Security score:significant reason:default
 
 
#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 class Controller {
        LeftController = uint(QtQuick3DXr::Controller::LeftController),
        RightController = uint(QtQuick3DXr::Controller::RightController),
        UnknownController = uint(QtQuick3DXr::Controller::UnknownController),
        LeftHand = uint(QtQuick3DXr::Controller::LeftHand),
        RightHand = uint(QtQuick3DXr::Controller::RightHand),
        ControllerLeft = LeftController,
        ControllerRight = RightController,
        ControllerNone = UnknownController,
    };
    Q_ENUM(Controller)
 
    enum class HandPoseSpace {
        GripPose = uint(QtQuick3DXr::HandPoseSpace::GripPose),
        AimPose = uint(QtQuick3DXr::HandPoseSpace::AimPose),
    };
    Q_ENUM(HandPoseSpace)
 
    QQuick3DXrController();
 
    Controller controller() const;
    void setController(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:
    void setIsActive(bool isActive);
 
    QPointer<QQuick3DXrInputManager> m_inputManager;
    Controller m_controller = Controller::UnknownController;
    QMetaObject::Connection m_isActiveConnection;
    HandPoseSpace m_poseSpace = HandPoseSpace::AimPose;
    QVector3D m_pokePosition;
    bool m_isActive = false;
};
 
namespace QtQuick3DXr
{
QtQuick3DXr::Handedness handednessForController(QtQuick3DXr::Controller controller);
}
 
QT_END_NAMESPACE
 
#endif // QQUICK3DXRCONTROLLER_H