cameracontroller.h

Go to the documentation of this file.

//=============================================================================================================
 
#ifndef CAMERACONTROLLER_H
#define CAMERACONTROLLER_H
 
//=============================================================================================================
// INCLUDES
//=============================================================================================================
 
#include "../disp3D_global.h"
 
#include "core/viewstate.h"
 
#include <QMatrix4x4>
#include <QQuaternion>
#include <QVector3D>
#include <QVector2D>
#include <QPoint>
#include <QSize>
 
//=============================================================================================================
struct CameraResult
{
    QMatrix4x4  projection;
    QMatrix4x4  view;
    QMatrix4x4  model;
    QVector3D   cameraPos;
    QVector3D   upVector;
    QVector3D   lookAt;
    float       distance = 0.0f;
};
 
//=============================================================================================================
class DISP3DSHARED_EXPORT CameraController
{
public:
    //=========================================================================================================
    CameraController() = default;
 
    // ── Scene geometry ─────────────────────────────────────────────────

    void setSceneCenter(const QVector3D &center) { m_sceneCenter = center; }

    void setSceneSize(float size)                { m_sceneSize = (size > 0.01f) ? size : 0.3f; }
 
    QVector3D sceneCenter() const { return m_sceneCenter; }
    float     sceneSize()   const { return m_sceneSize; }
 
    // ── Single-view camera state ───────────────────────────────────────

    void setRotation(const QQuaternion &q) { m_cameraRotation = q; }
    QQuaternion rotation() const           { return m_cameraRotation; }

    void  setZoom(float z)     { m_zoom = z; }
    float zoom() const         { return m_zoom; }

    void resetRotation()       { m_cameraRotation = QQuaternion(); }
 
    // ── Matrix computation ─────────────────────────────────────────────

    CameraResult computeSingleView(float aspectRatio) const;

    CameraResult computeMultiView(const SubView &subView, float aspectRatio) const;
 
    // ── Mouse interaction ──────────────────────────────────────────────

    static void applyMouseRotation(const QPoint &delta,
                                   QQuaternion &rotation,
                                   float speed = 0.5f);

    static void applyMousePan(const QPoint &delta,
                              QVector2D &pan,
                              float sceneSize);
 
private:
    CameraResult computeForRotation(const QQuaternion &effectiveRotation,
                                    float zoom,
                                    const QVector2D &pan,
                                    bool applyPan,
                                    float aspectRatio) const;
 
    QQuaternion m_cameraRotation;
    QVector3D   m_sceneCenter = QVector3D(0, 0, 0);
    float       m_sceneSize   = 0.3f;
    float       m_zoom        = 0.0f;
};
 
#endif // CAMERACONTROLLER_H