base_image_item.h

Go to the documentation of this file.

 
#pragma once
 
#include <QQuickItem>
#include <QPointF>
#include <QMutex>
#include <QSize>
#include "rendering/i_rendering_item_base.h"
 
namespace CaptureMoment::UI {
 
namespace Rendering {
 
class BaseImageItem : public IRenderingItemBase
{
public:
    explicit BaseImageItem();
 
    void setZoom(float zoom) override;
 
    void setPan(const QPointF& pan) override;
 
    [[nodiscard]] QPointF pan() const override { return m_pan; };
 
    [[nodiscard]] float zoom() const override { return m_zoom; };
 
    [[nodiscard]] int imageWidth() const override;
 
    [[nodiscard]] int imageHeight() const override;
 
    [[nodiscard]] bool isImageValid() const override;
 
 
    [[nodiscard]] QMutex* getImageMutex() const override { return &m_image_mutex; };
 
    [[nodiscard]] const Core::Common::ImageRegion* getFullImage() const override {
        return m_full_image.get();}
 
protected:
 
    /* --------------------- Protected Members --------------------*/
 
    std::unique_ptr<Core::Common::ImageRegion> m_full_image;
 
    mutable QMutex m_image_mutex;
 
    float m_zoom{1.0f};
 
    QPointF m_pan{0, 0};
 
    /* --------------------- Protected Methods --------------------*/
    /*
     * @brief Virtual methods for handling state changes (can be overridden by derived classes).
     * These methods are called when the corresponding state changes (zoom, pan, image).
     * The base implementation does nothing, but derived classes can override to react to changes.
     */
    virtual void onZoomChanged(float new_zoom) {};
 
    /*
     * @brief Virtual method for handling pan changes.
     * This method is called when the pan offset changes.
     * The base implementation does nothing, but derived classes can override to react to pan changes.
     */
    virtual void onPanChanged(const QPointF& new_pan) {};
 
    /*
     * @brief Virtual method for handling image changes.
     * This method is called when the image data changes (setImage or updateTile).
     * The base implementation does nothing, but derived classes can override to react to image changes.
     */
    virtual void onImageChanged() {};
};
 
} // namespace Rendering
 
} // namespace CaptureMoment::UI