/**************************************************************************** ** ** Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB). ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt3D module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qlogicaldevice.h" #include #include #include #include QT_BEGIN_NAMESPACE namespace Qt3DInput { /*! \internal */ class QLogicalDevicePrivate : public Qt3DCore::QComponentPrivate { public: QLogicalDevicePrivate() : Qt3DCore::QComponentPrivate() {} QVector m_actions; QVector m_axes; }; /*! \class Qt3DInput::QLogicalDevice \inmodule Qt3DInput \inherits Qt3DCore::QNode \brief QLogicalDevice allows the user to define a set of actions that they wish to use within an application. \since 5.6 */ /*! \qmltype LogicalDevice \inqmlmodule Qt3D.Input \instantiates Qt3DInput::QLogicalDevice \brief QML frontend for the Qt3DInput::QLogicalDevice C++ class. Allows the user to define a set of actions that they wish to use within an application. \qml LogicalDevice { id: keyboardLogicalDevice actions: [ Action { name: "fire" inputs: [ ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_Space] }, InputChord { tolerance: 10 inputs: [ ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_A] }, ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_S] } ] }, ] }, Action { name: "reload" inputs: [ ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_Alt] } ] } Action { name: "combo" inputs: [ InputSequence { interval: 1000 timeout: 10000 inputs: [ ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_G] }, ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_D] }, ActionInput { sourceDevice: keyboardSourceDevice keys: [Qt.Key_J] } ] } ] } ] \endqml \since 5.6 */ /*! Constructs a new QLogicalDevice instance with parent \a parent. */ QLogicalDevice::QLogicalDevice(Qt3DCore::QNode *parent) : Qt3DCore::QComponent(*new QLogicalDevicePrivate(), parent) { } /*! Deletes the QLogicalDevice instance. */ QLogicalDevice::~QLogicalDevice() { QComponent::cleanup(); } /*! \qmlproperty QQmlListProperty Qt3D.Input::LogicalDevice::actions The actions used by this Logical Device */ /*! Add an action to the list of actions. */ void QLogicalDevice::addAction(QAction *action) { Q_D(QLogicalDevice); if (!d->m_actions.contains(action)) { d->m_actions.push_back(action); // Force creation in backend by setting parent if (!action->parent()) action->setParent(this); if (d->m_changeArbiter != Q_NULLPTR) { Qt3DCore::QScenePropertyChangePtr change(new Qt3DCore::QScenePropertyChange(Qt3DCore::NodeAdded, Qt3DCore::QSceneChange::Node, id())); change->setPropertyName("action"); change->setValue(QVariant::fromValue(action->id())); d->notifyObservers(change); } } } /*! Remove an action from the list of actions. */ void QLogicalDevice::removeAction(QAction *action) { Q_D(QLogicalDevice); if (d->m_actions.contains(action)) { if (d->m_changeArbiter != Q_NULLPTR) { Qt3DCore::QScenePropertyChangePtr change(new Qt3DCore::QScenePropertyChange(Qt3DCore::NodeRemoved, Qt3DCore::QSceneChange::Node, id())); change->setPropertyName("action"); change->setValue(QVariant::fromValue(action->id())); d->notifyObservers(change); } d->m_actions.removeOne(action); } } /*! Returns the list of actions. */ QVector QLogicalDevice::actions() const { Q_D(const QLogicalDevice); return d->m_actions; } /*! \qmlproperty QQmlListProperty Qt3D.Input::LogicalDevice::axis The axis used by this Logical Device */ /*! Add an axis to the list of axis. */ void QLogicalDevice::addAxis(QAxis *axis) { Q_D(QLogicalDevice); if (!d->m_axes.contains(axis)) { d->m_axes.push_back(axis); // Force creation in backend by setting parent if (!axis->parent()) axis->setParent(this); if (d->m_changeArbiter != Q_NULLPTR) { Qt3DCore::QScenePropertyChangePtr change(new Qt3DCore::QScenePropertyChange(Qt3DCore::NodeAdded, Qt3DCore::QSceneChange::Node, id())); change->setPropertyName("axis"); change->setValue(QVariant::fromValue(axis->id())); d->notifyObservers(change); } } } /*! Remove an axis drom the list of axis. */ void QLogicalDevice::removeAxis(QAxis *axis) { Q_D(QLogicalDevice); if (d->m_axes.contains(axis)) { if (d->m_changeArbiter != Q_NULLPTR) { Qt3DCore::QScenePropertyChangePtr change(new Qt3DCore::QScenePropertyChange(Qt3DCore::NodeRemoved, Qt3DCore::QSceneChange::Node, id())); change->setPropertyName("axis"); change->setValue(QVariant::fromValue(axis->id())); d->notifyObservers(change); } d->m_axes.removeOne(axis); } } /*! Returns the list of axis. */ QVector QLogicalDevice::axes() const { Q_D(const QLogicalDevice); return d->m_axes; } void QLogicalDevice::copy(const Qt3DCore::QNode *ref) { QNode::copy(ref); const QLogicalDevice *device = static_cast(ref); Q_FOREACH (QAction *action, device->actions()) d_func()->m_actions.push_back(qobject_cast(QNode::clone(action))); Q_FOREACH (QAxis *axis, device->axes()) d_func()->m_axes.push_back(qobject_cast(QNode::clone(axis))); } } // Qt3DInput QT_END_NAMESPACE