qgscompositionconverter.h

Go to the documentation of this file.

/***************************************************************************
  qgscompositionconverter.h - Convert  a QGIS 2.x composition to a layout
 
 ---------------------
 begin                : 13.12.2017
 copyright            : (C) 2017 by Alessandro Pasotti
 email                : elpaso at itopen dot it
 ***************************************************************************
 *                                                                         *
 *   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 QGSCOMPOSITIONCONVERTER_H
#define QGSCOMPOSITIONCONVERTER_H
 
 
#include "qgis_sip.h"
#include "qgspropertycollection.h"
 
#include <QDomDocument>
#include <QDomElement>
 
#define SIP_NO_FILE
 
class QgsPrintLayout;
class QgsLayoutItem;
class QgsLayoutObject;
class QgsReadWriteContext;
class QgsProperty;
class QgsPropertyCollection;
 
class QgsLayoutItemLabel;
class QgsLayoutItemShape;
class QgsLayoutItemPicture;
class QgsLayoutItemPolygon;
class QgsLayoutItemPolyline;
class QgsLayoutItemMap;
class QgsLayoutItemScaleBar;
class QgsLayoutItemLegend;
class QgsLayoutItemHtml;
class QgsLayoutItemAttributeTable;
class QgsLayoutItemGroup;
class QgsLayoutAtlas;
class QgsProject;

class CORE_EXPORT QgsCompositionConverter
{
  public:
    enum class DataDefinedProperty
    {
      NoProperty = 0, 
      AllProperties,  
      TestProperty,   
      //composer page properties
      PresetPaperSize,  
      PaperWidth,       
      PaperHeight,      
      NumPages,         
      PaperOrientation, 
      //general composer item properties
      PageNumber,         
      PositionX,          
      PositionY,          
      ItemWidth,          
      ItemHeight,         
      ItemRotation,       
      Transparency,       
      Opacity,            
      BlendMode,          
      ExcludeFromExports, 
      FrameColor,         
      BackgroundColor,    
      //composer map
      MapRotation,    
      MapScale,       
      MapXMin,        
      MapYMin,        
      MapXMax,        
      MapYMax,        
      MapAtlasMargin, 
      MapLayers,      
      MapStylePreset, 
      //composer picture
      PictureSource,             
      PictureSvgBackgroundColor, 
      PictureSvgStrokeColor,     
      PictureSvgStrokeWidth,     
      //html item
      SourceUrl, 
      //legend item
      LegendTitle,       
      LegendColumnCount, 
      //scalebar item
      ScalebarFillColor,  
      ScalebarFillColor2, 
      ScalebarLineColor,  
      ScalebarLineWidth,  
    };

    enum MarkerMode
    {
      DefaultMarker,
      NoMarker,
      SVGMarker
    };
 

    static std::unique_ptr<QgsPrintLayout> createLayoutFromCompositionXml( const QDomElement &composerElement, QgsProject *project );
 

    static QList<QgsLayoutObject *> addItemsFromCompositionXml( QgsPrintLayout *layout, const QDomElement &parentElement, QPointF *position = nullptr, bool pasteInPlace = false );

    static bool isCompositionTemplate( const QDomDocument &document );

    static QDomDocument convertCompositionTemplate( const QDomDocument &document, QgsProject *project );
 
 
  private:
    static QgsPropertiesDefinition sPropertyDefinitions;
 
 
    static bool readLabelXml( QgsLayoutItemLabel *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readShapeXml( QgsLayoutItemShape *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readPictureXml( QgsLayoutItemPicture *layoutItem, const QDomElement &itemElem, const QgsProject *project, const QgsStringMap &mapId2Uuid );

    template<class T, class T2> static bool readPolyXml( T *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readArrowXml( QgsLayoutItemPolyline *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readMapXml( QgsLayoutItemMap *layoutItem, const QDomElement &itemElem, const QgsProject *project, QgsStringMap &mapId2Uuid );
 
    static bool readScaleBarXml( QgsLayoutItemScaleBar *layoutItem, const QDomElement &itemElem, const QgsProject *project, const QgsStringMap &mapId2Uuid );
 
    static bool readLegendXml( QgsLayoutItemLegend *layoutItem, const QDomElement &itemElem, const QgsProject *project, const QgsStringMap &mapId2Uuid );
 
    static bool readAtlasXml( QgsLayoutAtlas *atlasItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readHtmlXml( QgsLayoutItemHtml *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readTableXml( QgsLayoutItemAttributeTable *layoutItem, const QDomElement &itemElem, const QgsProject *project );
 
    static bool readGroupXml( QgsLayoutItemGroup *layoutItem, const QDomElement &itemElem, const QgsProject *project, const QList<QgsLayoutObject *> &items );
 
    static bool readOldComposerObjectXml( QgsLayoutObject *layoutItem, const QDomElement &itemElem );
 
    static void readOldDataDefinedPropertyMap( const QDomElement &itemElem, QgsPropertyCollection &dataDefinedProperties );
 
    static QgsProperty readOldDataDefinedProperty( DataDefinedProperty property, const QDomElement &ddElem );
 
    static void initPropertyDefinitions();
 
    static QgsPropertiesDefinition propertyDefinitions();

    static bool readXml( QgsLayoutItem *layoutItem, const QDomElement &itemElem );

    static void adjustPos( QgsPrintLayout *layout, QgsLayoutItem *layoutItem, QPointF *position, bool &pasteInPlace, int zOrderOffset, QPointF &pasteShiftPos, int &pageNumber );

    static void restoreGeneralComposeItemProperties( QgsLayoutItem *layoutItem, const QDomElement &itemElem );

    static QRectF itemPosition( QgsLayoutItem *layoutItem, const QDomElement &itemElem );

    static QPointF minPointFromXml( const QDomElement &elem );
};
 
#endif // QGSCOMPOSITIONCONVERTER_H