Viewer3DCameraController.h

Go to the documentation of this file.

/****************************************************************************
 *
 * (c) 2009-2024 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/
 
#pragma once
 
#include <QtCore/QObject>
#include <QtCore/QPointF>
#include <QtCore/QSizeF>
#include <QtGui/QVector3D>
#include <QtQmlIntegration/QtQmlIntegration>
#include <optional>
 
class Viewer3DCameraController : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    Q_PROPERTY(QVector3D orbitCenter READ orbitCenter WRITE setOrbitCenter NOTIFY orbitCenterChanged)
    Q_PROPERTY(qreal heading READ heading WRITE setHeading NOTIFY headingChanged)
    Q_PROPERTY(qreal tilt READ tilt WRITE setTilt NOTIFY tiltChanged)
    Q_PROPERTY(qreal distance READ distance WRITE setDistance NOTIFY distanceChanged)
    Q_PROPERTY(QSizeF viewportSize READ viewportSize WRITE setViewportSize NOTIFY viewportSizeChanged)
    Q_PROPERTY(qreal fieldOfView READ fieldOfView WRITE setFieldOfView NOTIFY fieldOfViewChanged)
 
    friend class Viewer3DCameraControllerTest;
 
public:
    explicit Viewer3DCameraController(QObject* parent = nullptr);
 
    static constexpr qreal kMinDistance = 50.0;
    static constexpr qreal kMaxDistance = 50000.0;
    static constexpr qreal kMinTilt = 0.0;
    static constexpr qreal kMaxTilt = 85.0;
    static constexpr qreal kDefaultDistance = 1500.0;
    static constexpr qreal kDefaultFieldOfView = 60.0;
 
    QVector3D orbitCenter() const { return _orbitCenter; }
 
    void setOrbitCenter(const QVector3D& center);
 
    qreal heading() const { return _heading; }
 
    void setHeading(qreal heading);
 
    qreal tilt() const { return _tilt; }
 
    void setTilt(qreal tilt);
 
    qreal distance() const { return _distance; }
 
    void setDistance(qreal distance);
 
    QSizeF viewportSize() const { return _viewportSize; }
 
    void setViewportSize(const QSizeF& size);
 
    qreal fieldOfView() const { return _fieldOfView; }
 
    void setFieldOfView(qreal fov);
 
    Q_INVOKABLE void reset();
 
    Q_INVOKABLE void lookAt(const QVector3D& center, qreal heading, qreal tilt, qreal distance);
 
    Q_INVOKABLE void beginPan(const QPointF& screenPos);
    Q_INVOKABLE void panTo(const QPointF& screenPos);
 
    Q_INVOKABLE void beginOrbit(const QPointF& screenPos);
    Q_INVOKABLE void orbitTo(const QPointF& screenPos);
 
    Q_INVOKABLE void rotateBy(qreal degrees, const QPointF& screenPos);
 
    Q_INVOKABLE void tiltBy(qreal degrees, const QPointF& screenPos);
 
    Q_INVOKABLE void zoom(qreal amount, const QPointF& screenPos);
 
    Q_INVOKABLE void zoomBy(qreal factor, const QPointF& screenPos);
 
    Q_INVOKABLE qreal sceneUnitsPerPixel() const;
 
    QVector3D cameraPosition() const;
 
    std::optional<QVector3D> screenToGround(const QPointF& screenPos) const;
 
signals:
    void orbitCenterChanged();
    void headingChanged();
    void tiltChanged();
    void distanceChanged();
    void viewportSizeChanged();
    void fieldOfViewChanged();
 
private:
    QVector3D _orbitCenter;
    qreal _heading = 0.0;
    qreal _tilt = 0.0;
    qreal _distance = kDefaultDistance;
    QSizeF _viewportSize;
    qreal _fieldOfView = kDefaultFieldOfView;
 
    QVector3D _panAnchor;    
    bool _panAnchorValid = false;
    QVector3D _orbitAnchor;  
    bool _orbitAnchorValid = false;
    QPointF _lastOrbitPos;   
 
    void _rotateAboutAnchor(const QVector3D& anchor, qreal headingDelta, qreal tiltDelta);
};