/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/layout/qgslayoutitempicture.h                               *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/




class QgsLayoutItemPicture: QgsLayoutItem
{
%Docstring(signature="appended")
A layout item subclass that displays SVG files or raster format images
(jpg, png, ...).
%End

%TypeHeaderCode
#include "qgslayoutitempicture.h"
%End
  public:

    enum ResizeMode /BaseType=IntEnum/
    {
      Zoom,
      Stretch,
      Clip,
      ZoomResizeFrame,
      FrameToImageSize
    };

    enum NorthMode /BaseType=IntEnum/
    {
      GridNorth,
      TrueNorth,
    };

    QgsLayoutItemPicture( QgsLayout *layout );
%Docstring
Constructor for QgsLayoutItemPicture, with the specified parent
``layout``.
%End

    virtual int type() const;

    virtual QIcon icon() const;


    static QgsLayoutItemPicture *create( QgsLayout *layout ) /Factory/;
%Docstring
Returns a new picture item for the specified ``layout``.

The caller takes responsibility for deleting the returned object.
%End


    void setPicturePath( const QString &path, Qgis::PictureFormat format = Qgis::PictureFormat::Unknown );
%Docstring
Sets the source ``path`` of the image (may be svg or a raster format).
Data defined picture source may override this value. The path can either
be a local path or a remote (http) path.

Ideally, the ``format`` argument should specify the image format.

.. seealso:: :py:func:`picturePath`
%End

    QString picturePath() const;
%Docstring
Returns the path of the source image. Data defined picture source may
override this value. The path can either be a local path or a remote
(http) path.

:return: path for the source image

.. seealso:: :py:func:`setPicturePath`

.. seealso:: :py:func:`evaluatedPath`
%End

    double pictureRotation() const;
%Docstring
Returns the rotation used for drawing the picture within the item's
frame, in degrees clockwise.

.. seealso:: :py:func:`setPictureRotation`

.. seealso:: :py:func:`linkedMap`
%End

    void setLinkedMap( QgsLayoutItemMap *map );
%Docstring
Sets the ``map`` object for rotation.

If this is set then the picture will be rotated by the same amount as
the specified map object. This is useful especially for syncing north
arrows with a map item.

.. seealso:: :py:func:`setPictureRotation`

.. seealso:: :py:func:`linkedMap`
%End

    QgsLayoutItemMap *linkedMap() const;
%Docstring
Returns the linked rotation map, if set. An ``None`` means map rotation
is disabled. If this is set then the picture is rotated by the same
amount as the specified map object.

.. seealso:: :py:func:`setLinkedMap`
%End

    NorthMode northMode() const;
%Docstring
Returns the mode used to align the picture to a map's North.

.. seealso:: :py:func:`setNorthMode`

.. seealso:: :py:func:`northOffset`
%End

    void setNorthMode( NorthMode mode );
%Docstring
Sets the ``mode`` used to align the picture to a map's North.

.. seealso:: :py:func:`northMode`

.. seealso:: :py:func:`setNorthOffset`
%End

    double northOffset() const;
%Docstring
Returns the offset added to the picture's rotation from a map's North.

.. seealso:: :py:func:`setNorthOffset`

.. seealso:: :py:func:`northMode`
%End

    void setNorthOffset( double offset );
%Docstring
Sets the ``offset`` added to the picture's rotation from a map's North.

.. seealso:: :py:func:`northOffset`

.. seealso:: :py:func:`setNorthMode`
%End

    ResizeMode resizeMode() const;
%Docstring
Returns the resize mode used for drawing the picture within the layout
item's frame.

.. seealso:: :py:func:`setResizeMode`
%End

    void setPictureAnchor( QgsLayoutItem::ReferencePoint anchor );
%Docstring
Sets the picture's ``anchor`` point, which controls how it is placed
within the picture item's frame.

.. seealso:: :py:func:`pictureAnchor`
%End

    QgsLayoutItem::ReferencePoint pictureAnchor() const;
%Docstring
Returns the picture's current anchor, which controls how it is placed
within the picture item's frame.

.. seealso:: :py:func:`setPictureAnchor`
%End

    QColor svgFillColor() const;
%Docstring
Returns the fill color used for parametrized SVG files.

.. seealso:: :py:func:`setSvgFillColor`

.. seealso:: :py:func:`svgStrokeColor`
%End

    void setSvgFillColor( const QColor &color );
%Docstring
Sets the fill ``color`` used for parametrized SVG files.

.. note::

   This setting only has an effect on parametrized SVG files, and is ignored for
   non-parametrized SVG files.

.. seealso:: :py:func:`svgFillColor`

.. seealso:: :py:func:`setSvgStrokeColor`
%End

    QColor svgStrokeColor() const;
%Docstring
Returns the stroke color used for parametrized SVG files.

.. seealso:: :py:func:`setSvgStrokeColor`

.. seealso:: :py:func:`svgFillColor`
%End

    void setSvgStrokeColor( const QColor &color );
%Docstring
Sets the stroke ``color`` used for parametrized SVG files.

:param color: stroke color.

.. note::

   This setting only has an effect on parametrized SVG files, and is ignored for
   non-parametrized SVG files.

.. seealso:: :py:func:`svgStrokeColor`

.. seealso:: :py:func:`setSvgFillColor`
%End

    double svgStrokeWidth() const;
%Docstring
Returns the stroke width (in layout units) used for parametrized SVG
files.

.. seealso:: :py:func:`setSvgStrokeWidth`

.. seealso:: :py:func:`svgStrokeColor`
%End

    void setSvgStrokeWidth( double width );
%Docstring
Sets the stroke ``width`` (in layout units) used for parametrized SVG
files.

.. note::

   This setting only has an effect on parametrized SVG files, and is ignored for
   non-parametrized SVG files.

.. seealso:: :py:func:`svgStrokeWidth`

.. seealso:: :py:func:`setSvgStrokeColor`
%End

    Qgis::PictureFormat mode() const;
%Docstring
Returns the current picture mode (image format), FormatUnknown if given
picture format is unknown

.. seealso:: :py:func:`setMode`

.. seealso:: :py:func:`originalMode`
%End

    Qgis::PictureFormat originalMode() const;
%Docstring
Returns the original set picture mode (image format). It could differ
from :py:func:`~QgsLayoutItemPicture.mode` if given picture format is
unknown

.. seealso:: :py:func:`setMode`

.. seealso:: :py:func:`mode`

.. versionadded:: 3.22
%End

    void setMode( Qgis::PictureFormat mode );
%Docstring
Sets the current picture ``mode`` (image format).

.. seealso:: :py:func:`mode`

.. versionadded:: 3.14
%End

    virtual void finalizeRestoreFromXml();


    bool isMissingImage() const;
%Docstring
Returns ``True`` if the source image is missing and the picture cannot
be rendered.

.. versionadded:: 3.6
%End

    QString evaluatedPath() const;
%Docstring
Returns the current evaluated picture path, which includes the result of
data defined path overrides.

.. seealso:: :py:func:`picturePath`

.. versionadded:: 3.6
%End

    QMap<QString, QgsProperty> svgDynamicParameters() const;
%Docstring
Returns the SVG dynamic parameters

.. versionadded:: 3.20
%End

    void setSvgDynamicParameters( const QMap<QString, QgsProperty> &parameters );
%Docstring
Sets the SVG dynamic parameters

.. versionadded:: 3.20
%End

  public slots:

    void setPictureRotation( double rotation );
%Docstring
Sets the picture ``rotation`` within the item bounds, in degrees
clockwise. This does not affect the item's frame, only the way the
picture is drawn within the item.

.. seealso:: :py:func:`pictureRotation`
%End

    void setResizeMode( QgsLayoutItemPicture::ResizeMode mode );
%Docstring
Sets the resize ``mode`` used for drawing the picture within the item
bounds.

:param mode: ResizeMode to use for image file

.. seealso:: :py:func:`resizeMode`
%End

    void refreshPicture( const QgsExpressionContext *context = 0 );
%Docstring
Recalculates the source image (if using an expression for picture's
source) and reloads and redraws the picture.

:param context: expression context for evaluating data defined picture
                sources
%End

    void recalculateSize();
%Docstring
Forces a recalculation of the picture's frame size
%End

    virtual void refreshDataDefinedProperty( QgsLayoutObject::DataDefinedProperty property = QgsLayoutObject::DataDefinedProperty::AllProperties );


  signals:
    void pictureRotationChanged( double newRotation );
%Docstring
Emitted on picture rotation change
%End

  protected:

    virtual void draw( QgsLayoutItemRenderContext &context );

    virtual QSizeF applyItemSizeConstraint( QSizeF targetSize );

    virtual bool writePropertiesToElement( QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context ) const;

    virtual bool readPropertiesFromElement( const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context );


};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/core/layout/qgslayoutitempicture.h                               *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/