display_manager.h

Go to the documentation of this file.

 
#pragma once
 
#include <memory>
#include <QObject>
#include <QSize>
#include <QPointF>
 
#include "common/image_region.h"
#include "viewport_manager.h"
 
// Forward declaration
namespace CaptureMoment::UI::Rendering {
class IRenderingItemBase;
}
 
namespace CaptureMoment::UI {
 
namespace Display {
 
class DisplayManager : public QObject {
    Q_OBJECT
 
    Q_PROPERTY(QSize sourceImageSize READ sourceImageSize NOTIFY sourceImageSizeChanged)
 
    
    Q_PROPERTY(QSize displayImageSize READ displayImageSize NOTIFY displayImageSizeChanged)
 
    Q_PROPERTY(QSize downsampleSize READ downsampleSize NOTIFY downsampleSizeChanged)
 
    Q_PROPERTY(float zoom READ zoom WRITE setZoom NOTIFY zoomChanged)
 
    Q_PROPERTY(QPointF pan READ pan WRITE setPan NOTIFY panChanged)
 
    Q_PROPERTY(QSize viewportSize READ viewportSize WRITE setViewportSize NOTIFY viewportSizeChanged)
 
    Q_PROPERTY(float displayScale READ displayScale NOTIFY displayScaleChanged)
 
    Q_PROPERTY(int maxDownsample READ maxDownsample NOTIFY maxDownsampleChanged)
 
 
public:
    explicit DisplayManager(QObject* parent = nullptr);
 
    DisplayManager(const DisplayManager&) = delete;
    DisplayManager& operator=(const DisplayManager&) = delete;
    DisplayManager(DisplayManager&&) = default;
    DisplayManager& operator=(DisplayManager&&) = default;
    
    ~DisplayManager() = default;
    
 
    // =========================================================================
    // Initialization
    // =========================================================================
 
    void initialize();
 
    Q_INVOKABLE void initialize(const QSize& viewport_logical, const ScreenInfo& screen);
 
    [[nodiscard]] bool isInitialized() const noexcept;
 
    // =========================================================================
    // Rendering Item
    // =========================================================================
 
    void setRenderingItem(Rendering::IRenderingItemBase* item);
    
    [[nodiscard]] Rendering::IRenderingItemBase* renderingItem() const noexcept { return m_rendering_item; };
 
    // =========================================================================
    // Image Operations
    // =========================================================================
 
    void createDisplayImage(std::unique_ptr<Core::Common::ImageRegion> source_image);
 
    void updateDisplayTile(std::unique_ptr<Core::Common::ImageRegion> source_tile);
 
    Q_INVOKABLE void setSourceImageSize(int width, int height);
 
    // =========================================================================
    // Zoom & Pan
    // =========================================================================
 
    Q_INVOKABLE void setZoom(float zoom);
 
    [[nodiscard]] float zoom() const noexcept { return m_zoom; };
 
    Q_INVOKABLE void setPan(const QPointF& pan);
 
    [[nodiscard]] QPointF pan() const noexcept { return m_pan; };
 
    Q_INVOKABLE void zoomAt(const QPointF& point, float zoom_delta);
 
    Q_INVOKABLE void fitToView();
 
    Q_INVOKABLE void resetView();
 
    Q_INVOKABLE void zoomIn();
 
    Q_INVOKABLE void zoomOut();
 
    // =========================================================================
    // Viewport
    // =========================================================================
 
    Q_INVOKABLE void setViewportSize(const QSize& size);
 
    [[nodiscard]] QSize viewportSize() const noexcept;
 
    Q_INVOKABLE void setQualityMargin(float margin);
 
    // =========================================================================
    // Coordinate Mapping
    // =========================================================================
 
    Q_INVOKABLE QPointF mapBackendToDisplay(int backend_x, int backend_y) const;
 
    Q_INVOKABLE QPoint mapDisplayToBackend(float display_x, float display_y) const;
 
    // =========================================================================
    // Property Getters
    // =========================================================================
 
    [[nodiscard]] QSize sourceImageSize() const noexcept { return m_source_image_size; };
    
    [[nodiscard]] QSize displayImageSize() const noexcept { return m_display_image_size; };
 
    [[nodiscard]] QSize downsampleSize() const noexcept { return m_downsample_size; };
 
    [[nodiscard]] float displayScale() const noexcept { return m_display_scale; };
 
    [[nodiscard]] int maxDownsample() const noexcept;
 
signals:
    void displayImageRequest(int target_width, int target_height);
 
    void zoomChanged(float zoom);
 
    void panChanged(const QPointF& pan);
 
    void viewportSizeChanged(const QSize& size);
 
    void sourceImageSizeChanged(const QSize& size);
 
    void displayImageSizeChanged(const QSize& size);
 
    void downsampleSizeChanged(const QSize& size);
 
    void displayScaleChanged(float scale);
 
    void maxDownsampleChanged(int max_dim);
 
    void initializedChanged(bool initialized);
 
private:
    // =========================================================================
    // Internal Methods
    // =========================================================================
 
    void constrainPan();
 
    [[nodiscard]] QSize calculateDisplaySize(const QSize& source_size) const;
 
    // =========================================================================
    // Member Variables
    // =========================================================================
 
    std::unique_ptr<ViewportManager> m_viewport_manager;
 
    float m_zoom{1.0f};
 
    QPointF m_pan{0, 0};
    
    QSize m_source_image_size;
 
    QSize m_display_image_size;
 
    QSize m_downsample_size;
 
    float m_display_scale{1.0f};
 
    Rendering::IRenderingItemBase* m_rendering_item{nullptr};
 
    float m_fit_zoom{1.0f};
};
 
} // namespace Display
} // namespace CaptureMoment::UI