/**************************************************************************** ** ** Copyright (C) 2014 Digia Plc ** All rights reserved. ** For any questions to Digia, please use contact form at http://qt.io ** ** This file is part of the Qt Data Visualization module. ** ** Licensees holding valid commercial license for Qt may use this file in ** accordance with the Qt License Agreement provided with the Software ** or, alternatively, in accordance with the terms contained in a written ** agreement between you and Digia. ** ** If you have questions regarding the use of this file, please use ** contact form at http://qt.io ** ****************************************************************************/ #include "datavisualizationglobal_p.h" #include "q3dinputhandler_p.h" #include "abstract3dcontroller_p.h" QT_BEGIN_NAMESPACE_DATAVISUALIZATION static const int halfSizeZoomLevel = 50; static const int oneToOneZoomLevel = 100; static const int driftTowardCenterLevel = 175; static const float wheelZoomDrift = 0.1f; static const int nearZoomRangeDivider = 12; static const int midZoomRangeDivider = 60; static const int farZoomRangeDivider = 120; static const float rotationSpeed = 100.0f; /*! * \class Q3DInputHandler * \inmodule QtDataVisualization * \brief Basic wheel mouse based input handler. * \since QtDataVisualization 1.0 * * Q3DInputHandler is the basic input handler for wheel mouse type of input devices. * * Default input handler has the following functionalty: * \table * \header * \li Mouse action * \li Action * \row * \li Drag with right button pressed * \li Rotate graph within limits set for Q3DCamera. * \row * \li Left click * \li Select item under cursor or remove selection if none. * May open the secondary view depending on the * \l {QAbstract3DGraph::selectionMode}{selection mode}. * \row * \li Mouse wheel * \li Zoom in/out within the allowable zoom range set for Q3DCamera. * \row * \li Left click on the primary view when the secondary view is visible * \li Closes the secondary view. * \note Secondary view is available only for Q3DBars and Q3DSurface graphs. * \endtable * * Rotation, zoom, and selection can each be individually disabled using * corresponding properties of this class. */ /*! * \qmltype InputHandler3D * \inqmlmodule QtDataVisualization * \since QtDataVisualization 1.2 * \ingroup datavisualization_qml * \instantiates Q3DInputHandler * \brief Basic wheel mouse based input handler. * * InputHandler3D is the basic input handler for wheel mouse type of input devices. * * See Q3DInputHandler documentation for more details. */ /*! * \qmlproperty bool InputHandler3D::rotationEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows graph rotation. * Defaults to \c{true}. */ /*! * \qmlproperty bool InputHandler3D::zoomEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows graph zooming. * Defaults to \c{true}. */ /*! * \qmlproperty bool InputHandler3D::selectionEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows selection from the graph. * Defaults to \c{true}. */ /*! * \qmlproperty bool InputHandler3D::zoomAtTargetEnabled * \since QtDataVisualization 1.2 * * This property specifies if zooming changes the camera target to the position of the input * at the time of the zoom. * Defaults to \c{true}. */ /*! * Constructs the basic mouse input handler. An optional \a parent parameter can be given * and is then passed to QObject constructor. */ Q3DInputHandler::Q3DInputHandler(QObject *parent) : QAbstract3DInputHandler(parent), d_ptr(new Q3DInputHandlerPrivate(this)) { } /*! * Destroys the input handler. */ Q3DInputHandler::~Q3DInputHandler() { } // Input event listeners /*! * Override this to change handling of mouse press events. * Mouse press event is given in the \a event and the mouse position in \a mousePos. */ void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos) { #if defined(Q_OS_IOS) Q_UNUSED(event); Q_UNUSED(mousePos); #else if (Qt::LeftButton == event->button()) { if (isSelectionEnabled()) { if (scene()->isSlicingActive()) { if (scene()->isPointInPrimarySubView(mousePos)) setInputView(InputViewOnPrimary); else if (scene()->isPointInSecondarySubView(mousePos)) setInputView(InputViewOnSecondary); else setInputView(InputViewNone); } else { // update mouse positions to prevent jumping when releasing or repressing a button setInputPosition(mousePos); scene()->setSelectionQueryPosition(mousePos); setInputView(InputViewOnPrimary); d_ptr->m_inputState = QAbstract3DInputHandlerPrivate::InputStateSelecting; } } } else if (Qt::MiddleButton == event->button()) { if (isRotationEnabled()) { // reset rotations setInputPosition(QPoint(0, 0)); } } else if (Qt::RightButton == event->button()) { if (isRotationEnabled()) { // disable rotating when in slice view if (!scene()->isSlicingActive()) d_ptr->m_inputState = QAbstract3DInputHandlerPrivate::InputStateRotating; // update mouse positions to prevent jumping when releasing or repressing a button setInputPosition(mousePos); } } #endif } /*! * Override this to change handling of mouse release events. * Mouse release event is given in the \a event and the mouse position in \a mousePos. */ void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos) { Q_UNUSED(event); #if defined(Q_OS_IOS) Q_UNUSED(mousePos); #else if (QAbstract3DInputHandlerPrivate::InputStateRotating == d_ptr->m_inputState) { // update mouse positions to prevent jumping when releasing or repressing a button setInputPosition(mousePos); } d_ptr->m_inputState = QAbstract3DInputHandlerPrivate::InputStateNone; setInputView(InputViewNone); #endif } /*! * Override this to change handling of mouse move events. * Mouse move event is given in the \a event and the mouse position in \a mousePos. */ void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos) { Q_UNUSED(event); #if defined(Q_OS_IOS) Q_UNUSED(mousePos); #else if (QAbstract3DInputHandlerPrivate::InputStateRotating == d_ptr->m_inputState && isRotationEnabled()) { // Calculate mouse movement since last frame float xRotation = scene()->activeCamera()->xRotation(); float yRotation = scene()->activeCamera()->yRotation(); float mouseMoveX = float(inputPosition().x() - mousePos.x()) / (scene()->viewport().width() / rotationSpeed); float mouseMoveY = float(inputPosition().y() - mousePos.y()) / (scene()->viewport().height() / rotationSpeed); // Apply to rotations xRotation -= mouseMoveX; yRotation -= mouseMoveY; scene()->activeCamera()->setXRotation(xRotation); scene()->activeCamera()->setYRotation(yRotation); setPreviousInputPos(inputPosition()); setInputPosition(mousePos); } #endif } /*! * Override this to change handling of wheel events. * The wheel event is given in the \a event. */ void Q3DInputHandler::wheelEvent(QWheelEvent *event) { if (isZoomEnabled()) { // disable zooming if in slice view if (scene()->isSlicingActive()) return; // Adjust zoom level based on what zoom range we're in. Q3DCamera *camera = scene()->activeCamera(); int zoomLevel = int(camera->zoomLevel()); const int minZoomLevel = int(camera->minZoomLevel()); const int maxZoomLevel = int(camera->maxZoomLevel()); if (zoomLevel > oneToOneZoomLevel) zoomLevel += event->angleDelta().y() / nearZoomRangeDivider; else if (zoomLevel > halfSizeZoomLevel) zoomLevel += event->angleDelta().y() / midZoomRangeDivider; else zoomLevel += event->angleDelta().y() / farZoomRangeDivider; zoomLevel = qBound(minZoomLevel, zoomLevel, maxZoomLevel); if (isZoomAtTargetEnabled()) { scene()->setGraphPositionQuery(event->pos()); d_ptr->m_zoomAtTargetPending = true; // If zoom at target is enabled, we don't want to zoom yet, as that causes // jitter. Instead, we zoom next frame, when we apply the camera position. d_ptr->m_requestedZoomLevel = zoomLevel; d_ptr->m_driftMultiplier = wheelZoomDrift; } else { camera->setZoomLevel(zoomLevel); } } } /*! * \property Q3DInputHandler::rotationEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows graph rotation. * Defaults to \c{true}. */ void Q3DInputHandler::setRotationEnabled(bool enable) { if (d_ptr->m_rotationEnabled != enable) { d_ptr->m_rotationEnabled = enable; emit rotationEnabledChanged(enable); } } bool Q3DInputHandler::isRotationEnabled() const { return d_ptr->m_rotationEnabled; } /*! * \property Q3DInputHandler::zoomEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows graph zooming. * Defaults to \c{true}. */ void Q3DInputHandler::setZoomEnabled(bool enable) { if (d_ptr->m_zoomEnabled != enable) { d_ptr->m_zoomEnabled = enable; emit zoomEnabledChanged(enable); } } bool Q3DInputHandler::isZoomEnabled() const { return d_ptr->m_zoomEnabled; } /*! * \property Q3DInputHandler::selectionEnabled * \since QtDataVisualization 1.2 * * This property specifies if this input handler allows selection from the graph. * Defaults to \c{true}. */ void Q3DInputHandler::setSelectionEnabled(bool enable) { if (d_ptr->m_selectionEnabled != enable) { d_ptr->m_selectionEnabled = enable; emit selectionEnabledChanged(enable); } } bool Q3DInputHandler::isSelectionEnabled() const { return d_ptr->m_selectionEnabled; } /*! * \property Q3DInputHandler::zoomAtTargetEnabled * \since QtDataVisualization 1.2 * * This property specifies if zooming should change the camera target so that the zoomed point * of the graph stays at the same location after the zoom. * Defaults to \c{true}. */ void Q3DInputHandler::setZoomAtTargetEnabled(bool enable) { if (d_ptr->m_zoomAtTargetEnabled != enable) { d_ptr->m_zoomAtTargetEnabled = enable; emit zoomAtTargetEnabledChanged(enable); } } bool Q3DInputHandler::isZoomAtTargetEnabled() const { return d_ptr->m_zoomAtTargetEnabled; } Q3DInputHandlerPrivate::Q3DInputHandlerPrivate(Q3DInputHandler *q) : q_ptr(q), m_inputState(QAbstract3DInputHandlerPrivate::InputStateNone), m_rotationEnabled(true), m_zoomEnabled(true), m_selectionEnabled(true), m_zoomAtTargetEnabled(true), m_zoomAtTargetPending(false), m_controller(0), m_requestedZoomLevel(0.0f), m_driftMultiplier(0.0f) { QObject::connect(q, &QAbstract3DInputHandler::sceneChanged, this, &Q3DInputHandlerPrivate::handleSceneChange); } Q3DInputHandlerPrivate::~Q3DInputHandlerPrivate() { } void Q3DInputHandlerPrivate::handleSceneChange(Q3DScene *scene) { if (scene) { if (m_controller) { QObject::disconnect(m_controller, &Abstract3DController::queriedGraphPositionChanged, this, &Q3DInputHandlerPrivate::handleQueriedGraphPositionChange); } m_controller = qobject_cast(scene->parent()); if (m_controller) { QObject::connect(m_controller, &Abstract3DController::queriedGraphPositionChanged, this, &Q3DInputHandlerPrivate::handleQueriedGraphPositionChange); } } } void Q3DInputHandlerPrivate::handleQueriedGraphPositionChange() { if (m_zoomAtTargetPending) { // Check if the zoom point is on graph QVector3D newTarget = m_controller->queriedGraphPosition(); float currentZoom = m_requestedZoomLevel; float previousZoom = q_ptr->scene()->activeCamera()->zoomLevel(); q_ptr->scene()->activeCamera()->setZoomLevel(currentZoom); float diffAdj = 0.0f; // If zooming in/out outside the graph, or zooming out after certain point, // move towards the center. if ((qAbs(newTarget.x()) > 1.0f || qAbs(newTarget.y()) > 1.0f || qAbs(newTarget.z()) > 1.0f) || (previousZoom > currentZoom && currentZoom <= driftTowardCenterLevel)) { newTarget = zeroVector; // Add some extra correction so that we actually reach the center eventually diffAdj = m_driftMultiplier; if (previousZoom > currentZoom) diffAdj *= 2.0f; // Correct towards center little more when zooming out } float zoomFraction = 1.0f - (previousZoom / currentZoom); // Adjust camera towards the zoom point, attempting to keep the cursor at same graph point QVector3D oldTarget = q_ptr->scene()->activeCamera()->target(); QVector3D origDiff = newTarget - oldTarget; QVector3D diff = origDiff * zoomFraction + (origDiff.normalized() * diffAdj); if (diff.length() > origDiff.length()) diff = origDiff; q_ptr->scene()->activeCamera()->setTarget(oldTarget + diff); if (q_ptr->scene()->selectionQueryPosition() == Q3DScene::invalidSelectionPoint()) m_zoomAtTargetPending = false; } } QT_END_NAMESPACE_DATAVISUALIZATION