qgslayoutitem.h

Go to the documentation of this file.

/***************************************************************************
                              qgslayoutitem.h
                             -------------------
    begin                : June 2017
    copyright            : (C) 2017 by Nyall Dawson
    email                : nyall dot dawson at gmail dot com
 ***************************************************************************/
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSLAYOUTITEM_H
#define QGSLAYOUTITEM_H
 
#include "qgis_core.h"
#include "qgslayoutmeasurement.h"
#include "qgslayoutobject.h"
#include "qgslayoutpoint.h"
#include "qgslayoutsize.h"
#include "qgslayoutundocommand.h"
#include "qgsrendercontext.h"
 
#include <QGraphicsRectItem>
#include <QIcon>
#include <QPainter>
 
class QgsLayout;
class QPainter;
class QgsLayoutItemGroup;
class QgsLayoutEffect;
class QgsStyleEntityVisitorInterface;

class CORE_EXPORT QgsLayoutItemRenderContext
{
  public:

    QgsLayoutItemRenderContext( QgsRenderContext &context, double viewScaleFactor = 1.0 );
 
    QgsLayoutItemRenderContext( const QgsLayoutItemRenderContext &other ) = delete;
    QgsLayoutItemRenderContext &operator=( const QgsLayoutItemRenderContext &other ) = delete;

    QgsRenderContext &renderContext() { return mRenderContext; }

    const QgsRenderContext &renderContext() const SIP_SKIP { return mRenderContext; }

    double viewScaleFactor() const { return mViewScaleFactor; }
 
  private:
 
#ifdef SIP_RUN
    QgsLayoutItemRenderContext( const QgsLayoutItemRenderContext &rh ) SIP_FORCE;
#endif
 
    QgsRenderContext &mRenderContext;
    double mViewScaleFactor = 1.0;
};

class CORE_EXPORT QgsLayoutItem : public QgsLayoutObject, public QGraphicsRectItem, public QgsLayoutUndoObjectInterface
{
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemgroup.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemmap.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitempicture.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemlabel.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemlegend.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitempolygon.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitempolyline.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemscalebar.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutframe.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemshape.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitempage.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemmarker.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemelevationprofile.h" );
    //SIP_TYPEHEADER_INCLUDE( "qgslayoutitemchart.h" );
 
#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
 
    // FREAKKKKIIN IMPORTANT!!!!!!!!!!!
    // IF YOU PUT SOMETHING HERE, PUT IT IN QgsLayoutObject CASTING *****ALSO******
    // (it's not enough for it to be in only one of the places, as sip inconsistently
    // decides which casting code to perform here)
 
    // the conversions have to be static, because they're using multiple inheritance
    // (seen in PyQt4 .sip files for some QGraphicsItem classes)
    switch ( sipCpp->type() )
    {
      // really, these *should* use the constants from QgsLayoutItemRegistry, but sip doesn't like that!
      case QGraphicsItem::UserType + 101:
        sipType = sipType_QgsLayoutItemGroup;
        *sipCppRet = static_cast<QgsLayoutItemGroup *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 102:
        sipType = sipType_QgsLayoutItemPage;
        *sipCppRet = static_cast<QgsLayoutItemPage *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 103:
        sipType = sipType_QgsLayoutItemMap;
        *sipCppRet = static_cast<QgsLayoutItemMap *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 104:
        sipType = sipType_QgsLayoutItemPicture;
        *sipCppRet = static_cast<QgsLayoutItemPicture *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 105:
        sipType = sipType_QgsLayoutItemLabel;
        *sipCppRet = static_cast<QgsLayoutItemLabel *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 106:
        sipType = sipType_QgsLayoutItemLegend;
        *sipCppRet = static_cast<QgsLayoutItemLegend *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 107:
        sipType = sipType_QgsLayoutItemShape;
        *sipCppRet = static_cast<QgsLayoutItemShape *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 108:
        sipType = sipType_QgsLayoutItemPolygon;
        *sipCppRet = static_cast<QgsLayoutItemPolygon *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 109:
        sipType = sipType_QgsLayoutItemPolyline;
        *sipCppRet = static_cast<QgsLayoutItemPolyline *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 110:
        sipType = sipType_QgsLayoutItemScaleBar;
        *sipCppRet = static_cast<QgsLayoutItemScaleBar *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 111:
        sipType = sipType_QgsLayoutFrame;
        *sipCppRet = static_cast<QgsLayoutFrame *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 117:
        sipType = sipType_QgsLayoutItemMarker;
        *sipCppRet = static_cast<QgsLayoutItemMarker *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 118:
        sipType = sipType_QgsLayoutItemElevationProfile;
        *sipCppRet = static_cast<QgsLayoutItemElevationProfile *>( sipCpp );
        break;
      case QGraphicsItem::UserType + 119:
        sipType = sipType_QgsLayoutItemChart;
        *sipCppRet = static_cast<QgsLayoutItemChart *>( sipCpp );
        break;
 
      // did you read that comment above? NO? Go read it now. You're about to break stuff.
 
      default:
        sipType = NULL;
    }
    SIP_END
#endif
 
 
    Q_OBJECT
    Q_PROPERTY( bool locked READ isLocked WRITE setLocked NOTIFY lockChanged )
 
  public:

    enum ReferencePoint
    {
      UpperLeft, 
      UpperMiddle, 
      UpperRight, 
      MiddleLeft, 
      Middle, 
      MiddleRight, 
      LowerLeft, 
      LowerMiddle, 
      LowerRight, 
    };

    enum UndoCommand
    {
      UndoNone = -1, 
      UndoIncrementalMove = 1, 
      UndoIncrementalResize, 
      UndoStrokeColor, 
      UndoStrokeWidth, 
      UndoBackgroundColor, 
      UndoOpacity, 
      UndoMarginLeft, 
      UndoMarginTop, 
      UndoMarginBottom, 
      UndoMarginRight, 
      UndoSetId, 
      UndoRotation, 
      UndoExportLayerName, 
      UndoShapeStyle, 
      UndoShapeCornerRadius, 
      UndoNodeMove, 
      UndoAtlasMargin, 
      UndoMapRotation, 
      UndoZoomContent, 
      UndoOverviewStyle, 
      UndoGridFramePenColor, 
      UndoMapGridFrameFill1Color, 
      UndoMapGridFrameFill2Color, 
      UndoMapAnnotationDistance, 
      UndoMapGridAnnotationFontColor, 
      UndoMapGridLineSymbol, 
      UndoMapGridMarkerSymbol, 
      UndoMapGridIntervalRange, 
      UndoMapLabelMargin, 
      UndoPictureRotation, 
      UndoPictureFillColor, 
      UndoPictureStrokeColor, 
      UndoPictureStrokeWidth, 
      UndoPictureNorthOffset, 
      UndoLabelText, 
      UndoLabelFont, 
      UndoLabelMargin, 
      UndoLabelFontColor, 
      UndoLegendText, 
      UndoLegendColumnCount, 
      UndoLegendSymbolWidth, 
      UndoLegendSymbolHeight, 
      UndoLegendMaxSymbolSize, 
      UndoLegendMinSymbolSize, 
      UndoLegendWmsLegendWidth, 
      UndoLegendWmsLegendHeight, 
      UndoLegendTitleSpaceBottom, 
      UndoLegendGroupSpace, 
      UndoLegendGroupIndent, 
      UndoLegendSubgroupIndent, 
      UndoLegendLayerSpace, 
      UndoLegendSymbolSpace, 
      UndoLegendIconSymbolSpace, 
      UndoLegendFontColor, 
      UndoLegendBoxSpace, 
      UndoLegendColumnSpace, 
      UndoLegendLineSpacing, 
      UndoLegendRasterStrokeWidth, 
      UndoLegendRasterStrokeColor, 
      UndoLegendTitleFont, 
      UndoLegendGroupFont, 
      UndoLegendLayerFont, 
      UndoLegendItemFont, 
      UndoLegendAutoWrapAfter, 
      UndoScaleBarLineWidth, 
      UndoScaleBarSegmentSize, 
      UndoScaleBarSegmentsLeft, 
      UndoScaleBarSegments, 
      UndoScaleBarHeight, 
      UndoScaleBarSubdivisions, 
      UndoScaleBarSubdivisionsHeight, 
      UndoScaleBarFontColor, 
      UndoScaleBarFillColor, 
      UndoScaleBarFillColor2, 
      UndoScaleBarStrokeColor, 
      UndoScaleBarUnitText, 
      UndoScaleBarMapUnitsSegment, 
      UndoScaleBarLabelBarSize, 
      UndoScaleBarBoxContentSpace, 
      UndoArrowStrokeWidth, 
      UndoArrowHeadWidth, 
      UndoArrowHeadFillColor, 
      UndoArrowHeadStrokeColor, 
      UndoElevationProfileTolerance, 
      UndoElevationProfileChartBackground, 
      UndoElevationProfileChartBorder, 
      UndoElevationProfileDistanceMajorGridlines, 
      UndoElevationProfileDistanceMinorGridlines, 
      UndoElevationProfileDistanceFormat, 
      UndoElevationProfileDistanceFont, 
      UndoElevationProfileDistanceLabels, 
      UndoElevationProfileElevationMajorGridlines, 
      UndoElevationProfileElevationMinorGridlines, 
      UndoElevationProfileElevationFormat, 
      UndoElevationProfileElevationFont, 
      UndoElevationProfileElevationLabels, 
      UndoElevationProfileMinimumDistance, 
      UndoElevationProfileMaximumDistance, 
      UndoElevationProfileMinimumElevation, 
      UndoElevationProfileMaximumElevation, 
      UndoElevationProfileSubsectionLines, 
 
      UndoCustomCommand, 
    };

    enum Flag SIP_ENUM_BASETYPE( IntFlag )
    {
      FlagOverridesPaint = 1 << 1,  
      FlagProvidesClipPath = 1 << 2, 
      FlagDisableSceneCaching = 1 << 3, 
    };
    Q_DECLARE_FLAGS( Flags, Flag )
 
    
    explicit QgsLayoutItem( QgsLayout *layout, bool manageZValue = true );
 
    ~QgsLayoutItem() override;

    virtual void cleanup();

    int type() const override;

    virtual QIcon icon() const;

    virtual QString uuid() const { return mUuid; }

    virtual Flags itemFlags() const;

    QString id() const { return mId; }

    virtual void setId( const QString &id );

    virtual QString displayName() const;

    virtual void setSelected( bool selected );

    virtual void setVisibility( bool visible );

    void setLocked( bool locked );

    bool isLocked() const { return mIsLocked; }

    bool isGroupMember() const;

    QgsLayoutItemGroup *parentGroup() const;

    void setParentGroup( QgsLayoutItemGroup *group );

    enum ExportLayerBehavior
    {
      CanGroupWithAnyOtherItem, 
      CanGroupWithItemsOfSameType, 
      MustPlaceInOwnLayer, 
      ItemContainsSubLayers, 
    };

    virtual ExportLayerBehavior exportLayerBehavior() const;

    Q_DECL_DEPRECATED virtual int numberExportLayers() const SIP_DEPRECATED;

    virtual void startLayeredExport();

    virtual void stopLayeredExport();

    virtual bool nextExportPart();

    struct CORE_EXPORT ExportLayerDetail
    {
      QString name;

      QString mapLayerId;

      QPainter::CompositionMode compositionMode = QPainter::CompositionMode_SourceOver;

      double opacity = 1.0;

      QString mapTheme;

      QString groupName;
    };

    virtual QgsLayoutItem::ExportLayerDetail exportLayerDetails() const;

    void paint( QPainter *painter, const QStyleOptionGraphicsItem *itemStyle, QWidget *pWidget ) override;

    void setReferencePoint( ReferencePoint point );

    ReferencePoint referencePoint() const { return mReferencePoint; }

    virtual QgsLayoutSize fixedSize() const { return mFixedSize; }

    virtual QgsLayoutSize minimumSize() const { return mMinimumSize; }

    virtual void attemptResize( const QgsLayoutSize &size, bool includesFrame = false );

    virtual void attemptMove( const QgsLayoutPoint &point, bool useReferencePoint = true, bool includesFrame = false, int page = -1 );

    void attemptSetSceneRect( const QRectF &rect, bool includesFrame = false );

    void attemptMoveBy( double deltaX, double deltaY );

    QgsLayoutPoint positionWithUnits() const { return mItemPosition; }

    int page() const;

    QPointF pagePos() const;

    QgsLayoutPoint pagePositionWithUnits() const;

    QgsLayoutSize sizeWithUnits() const { return mItemSize; }

    double itemRotation() const;

    bool writeXml( QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context ) const;

    bool readXml( const QDomElement &itemElement, const QDomDocument &document, const QgsReadWriteContext &context );

    virtual void finalizeRestoreFromXml();
 
    QgsAbstractLayoutUndoCommand *createCommand( const QString &text, int id, QUndoCommand *parent = nullptr ) override SIP_FACTORY;

    bool frameEnabled() const { return mFrame; }

    virtual void setFrameEnabled( bool drawFrame );

    void setFrameStrokeColor( const QColor &color );

    QColor frameStrokeColor() const { return mFrameColor; }

    virtual void setFrameStrokeWidth( QgsLayoutMeasurement width );

    QgsLayoutMeasurement frameStrokeWidth() const { return mFrameWidth; }

    Qt::PenJoinStyle frameJoinStyle() const { return mFrameJoinStyle; }

    void setFrameJoinStyle( Qt::PenJoinStyle style );

    bool hasBackground() const { return mBackground; }

    void setBackgroundEnabled( bool drawBackground );

    QColor backgroundColor( bool useDataDefined = true ) const;

    void setBackgroundColor( const QColor &color );

    QPainter::CompositionMode blendMode() const { return mBlendMode; }

    void setBlendMode( QPainter::CompositionMode mode );

    double itemOpacity() const { return mOpacity; }

    void setItemOpacity( double opacity );

    bool excludeFromExports() const;

    void setExcludeFromExports( bool exclude );

    virtual bool containsAdvancedEffects() const;

    virtual bool requiresRasterization() const;

    virtual double estimatedFrameBleed() const;

    virtual QRectF rectWithFrame() const;

    virtual void moveContent( double dx, double dy );

    virtual void setMoveContentPreviewOffset( double dx, double dy );

    virtual void zoomContent( double factor, QPointF point );

    void beginCommand( const QString &commandText, UndoCommand command = UndoNone );

    void endCommand();

    void cancelCommand();

    bool shouldDrawItem() const;
 
    QgsExpressionContext createExpressionContext() const override;

    virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;

    virtual QgsGeometry clipPath() const;

    virtual bool isRefreshing() const;
 
  public slots:

    void refresh() override;

    virtual void invalidateCache();

    virtual void redraw();

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

    virtual void setItemRotation( double rotation, bool adjustPosition = true );

    virtual void rotateItem( double angle, QPointF transformOrigin );
 
  signals:

    void frameChanged();

    void lockChanged();

    void rotationChanged( double newRotation );

    void sizePositionChanged();

    void backgroundTaskCountChanged( int count );

    void clipPathChanged();
 
  protected:

    virtual void drawDebugRect( QPainter *painter );

    virtual void draw( QgsLayoutItemRenderContext &context ) = 0;

    virtual QPainterPath framePath() const;

    virtual void drawFrame( QgsRenderContext &context );

    virtual void drawBackground( QgsRenderContext &context );

    void drawRefreshingOverlay( QPainter *painter, const QStyleOptionGraphicsItem *itemStyle );

    virtual void setFixedSize( const QgsLayoutSize &size );

    virtual void setMinimumSize( const QgsLayoutSize &size );

    virtual QSizeF applyItemSizeConstraint( QSizeF targetSize );

    void refreshItemSize();

    void refreshItemPosition();

    void refreshItemRotation( QPointF *origin = nullptr );

    void refreshOpacity( bool updateItem = true );

    void refreshFrame( bool updateItem = true );

    void refreshBackgroundColor( bool updateItem = true );

    void refreshBlendMode();

    QPointF adjustPointForReferencePosition( QPointF point, QSizeF size, ReferencePoint reference ) const;

    QPointF positionAtReferencePoint( ReferencePoint reference ) const;

    QgsLayoutPoint topLeftToReferencePoint( const QgsLayoutPoint &point ) const;

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

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

    QgsLayoutSize applyDataDefinedSize( const QgsLayoutSize &size );
 
  private:
 
    // true if layout manages the z value for this item
    bool mLayoutManagesZValue = false;

    QString mId;

    QString mUuid;

    QString mTemplateUuid;

    QString mParentGroupUuid;
 
    ReferencePoint mReferencePoint = UpperLeft;
    QgsLayoutSize mFixedSize;
    QgsLayoutSize mMinimumSize;
 
    QgsLayoutSize mItemSize;
    QgsLayoutPoint mItemPosition;
    double mItemRotation = 0.0;

    bool mExcludeFromExports = false;

    bool mEvaluatedExcludeFromExports = false;

    QPainter::CompositionMode mBlendMode = QPainter::CompositionMode_SourceOver;
    QPainter::CompositionMode mEvaluatedBlendMode = QPainter::CompositionMode_SourceOver;
 
    QPainter::CompositionMode blendModeForRender() const;

    double mOpacity = 1.0;
    double mEvaluatedOpacity = 1.0;
 
    QImage mItemCachedImage;
    double mItemCacheDpi = -1;
 
    bool mIsLocked = false;

    bool mFrame = false;
    QColor mFrameColor = QColor( 0, 0, 0 );
    QgsLayoutMeasurement mFrameWidth = QgsLayoutMeasurement( 0.3, Qgis::LayoutUnit::Millimeters );
    Qt::PenJoinStyle mFrameJoinStyle = Qt::MiterJoin;

    bool mBackground = true;
    QColor mBackgroundColor = QColor( 255, 255, 255 );
 
    bool mBlockUndoCommands = false;
 
    void initConnectionsToLayout();

    void preparePainter( QPainter *painter );
    bool shouldDrawAntialiased() const;
    bool shouldDrawDebugRect() const;
    QSizeF applyMinimumSize( QSizeF targetSize );
    QSizeF applyFixedSize( QSizeF targetSize );
    QgsLayoutPoint applyDataDefinedPosition( const QgsLayoutPoint &position );
 
    double applyDataDefinedRotation( double rotation );
    void updateStoredItemPosition();
    QPointF itemPositionAtReferencePoint( ReferencePoint reference, QSizeF size ) const;
    void setScenePos( QPointF destinationPos );
    bool shouldBlockUndoCommands() const;
 
    void applyDataDefinedOrientation( double &width, double &height, const QgsExpressionContext &context );
 
    friend class TestQgsLayoutItem;
    friend class TestQgsLayoutView;
    friend class QgsLayout;
    friend class QgsLayoutItemGroup;
    friend class QgsLayoutItemMap;
    friend class QgsLayoutItemLegend;
    friend class QgsLayoutItemElevationProfile;
    friend class QgsCompositionConverter;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsLayoutItem::Flags )
 
#endif //QGSLAYOUTITEM_H