File indexing completed on 2024-12-22 03:45:40

 /*
     SPDX-FileCopyrightText: 2010 Marco Martin <mart@kde.org>
     SPDX-FileCopyrightText: 2014 David Edmundson <davidedmundson@kde.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 #ifndef SVGITEM_P
 #define SVGITEM_P
 
 #include <QImage>
 #include <QQuickItem>
 
 namespace Kirigami
 {
 namespace Platform
 {
 class PlatformTheme;
 }
 };
 
 namespace KSvg
 {
 class Svg;
 
 /**
  * @class SvgItem
  * @short Displays an SVG or an element from an SVG file
  */
 class SvgItem : public QQuickItem
 {
     Q_OBJECT
 
     /**
      * @brief This property specifies the relative path of the Svg in the theme.
      *
      * Example: "widgets/background"
      *
      * @property QString imagePath
      */
     Q_PROPERTY(QString imagePath READ imagePath WRITE setImagePath NOTIFY imagePathChanged)
 
     /**
      * @brief This property specifies the sub-element of the SVG to be
      * rendered.
      *
      * If this is empty, the whole SVG document will be rendered.
      *
      * @property QString elementId
      */
     Q_PROPERTY(QString elementId READ elementId WRITE setElementId NOTIFY elementIdChanged)
 
     /**
      * @brief This property holds the SVG's natural, unscaled size.
      *
      * This is useful if a pixel-perfect rendering of outlines is needed.
      *
      * @property QSizeF naturalSize
      */
     Q_PROPERTY(QSizeF naturalSize READ naturalSize NOTIFY naturalSizeChanged)
 
     /**
      * @brief This property holds the rectangle of the selected elementId
      * relative to the unscaled size of the SVG document.
      *
      * Note that this property will holds the entire SVG if element id is not
      * selected.
      *
      * @property QRectF elementRect
      */
     Q_PROPERTY(QRectF elementRect READ elementRect NOTIFY elementRectChanged)
 
     /**
      * @brief This property holds the internal SVG instance.
      *
      * Usually, specifying just the imagePath is enough. Use this if you have
      * many items taking the same SVG as source, and you want to share the
      * internal SVG object.
      *
      * @property KSvg::Svg svg
      */
     Q_PROPERTY(KSvg::Svg *svg READ svg WRITE setSvg NOTIFY svgChanged)
 
 public:
     /// @cond INTERNAL_DOCS
 
     explicit SvgItem(QQuickItem *parent = nullptr);
     ~SvgItem() override;
 
     void setImagePath(const QString &path);
     QString imagePath() const;
 
     void setElementId(const QString &elementID);
     QString elementId() const;
 
     void setSvg(KSvg::Svg *svg);
     KSvg::Svg *svg() const;
 
     QSizeF naturalSize() const;
 
     QRectF elementRect() const;
 
     QSGNode *updatePaintNode(QSGNode *oldNode, UpdatePaintNodeData *updatePaintNodeData) override;
     /// @endcond
 
     void itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &data) override;
 
 protected:
     void componentComplete() override;
 
 Q_SIGNALS:
     void imagePathChanged();
     void elementIdChanged();
     void svgChanged();
     void naturalSizeChanged();
     void elementRectChanged();
 
 protected Q_SLOTS:
     /// @cond INTERNAL_DOCS
     void updateNeeded();
     /// @endcond
 
 private:
     void updateDevicePixelRatio();
     void scheduleImageUpdate();
     void updatePolish() override;
     void geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry) override;
 
     QPointer<KSvg::Svg> m_svg;
     Kirigami::Platform::PlatformTheme *m_kirigamiTheme;
     QString m_elementID;
     QImage m_image;
     bool m_textureChanged;
 };
 }
 
 #endif