speedyimage.h

#pragma once

#include <QQuickItem>
#include <memory>

class SpeedyImagePrivate;
class SpeedyImage : public QQuickItem
{
    Q_OBJECT
    Q_PROPERTY(QString source READ source WRITE setSource NOTIFY sourceChanged)
    Q_PROPERTY(QSize loadingSize READ loadingSize WRITE setLoadingSize NOTIFY loadingSizeChanged)

    Q_PROPERTY(Status status READ status NOTIFY statusChanged)
    Q_PROPERTY(QSize imageSize READ imageSize NOTIFY imageSizeChanged)
    Q_PROPERTY(QSizeF paintedSize READ paintedSize NOTIFY paintedSizeChanged)

public:
    enum Status {
        Null,
        Ready,
        Loading,
        Error
    };
    Q_ENUM(Status)

    explicit SpeedyImage(QQuickItem *parent = nullptr);
    virtual ~SpeedyImage();

    QString source() const;
    void setSource(const QString &source);

    // XXX Change zero dimensions of loadingSize to the actual size, as soon as imageSize is
    // available. Because it's constant, this isn't problematic, and then there is something
    // safe to bind to.
    QSize loadingSize() const;
    void setLoadingSize(QSize size);

    Status status() const;

    QSize imageSize() const;
    QSizeF paintedSize() const;

signals:
    void sourceChanged();
    void loadingSizeChanged();
    void statusChanged();
    void imageSizeChanged();
    void paintedSizeChanged();

protected:
    virtual QSGNode *updatePaintNode(QSGNode *oldNode, UpdatePaintNodeData *updatePaintNodeData);
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
    virtual void geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry) override;
#else
    virtual void geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry) override;
#endif
    virtual void componentComplete();

private:
    std::shared_ptr<SpeedyImagePrivate> d;
};