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>
 
namespace DISP3DLIB
{
 
//=============================================================================================================
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;
};
 
} // namespace DISP3DLIB
 
#endif // CAMERACONTROLLER_H