qgsdiagramrenderer.h

Go to the documentation of this file.

/***************************************************************************
    qgsdiagramrenderer.h
    ---------------------
    begin                : March 2011
    copyright            : (C) 2011 by Marco Hugentobler
    email                : marco dot hugentobler at sourcepole dot ch
 ***************************************************************************
 *                                                                         *
 *   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 QGSDIAGRAMRENDERER_H
#define QGSDIAGRAMRENDERER_H

#include "qgis_core.h"
#include "qgis_sip.h"
#include <QColor>
#include <QFont>
#include <QList>
#include <QPointF>
#include <QSizeF>
#include <QDomDocument>

#include "qgsexpressioncontext.h"
#include "qgsfields.h"
#include "qgscoordinatetransform.h"
#include "qgssymbol.h"
#include "qgsproperty.h"
#include "qgspropertycollection.h"
#include "qgsdatadefinedsizelegend.h"

#include "diagram/qgsdiagram.h"
#include "qgsreadwritecontext.h"

class QgsDiagramRenderer;
class QgsFeature;
class QgsRenderContext;
class QDomElement;
class QgsMapToPixel;
class QgsReadWriteContext;
class QgsVectorLayer;
class QgsLayerTreeModelLegendNode;
class QgsLayerTreeLayer;
class QgsPaintEffect;

namespace pal { class Layer; } SIP_SKIP

class CORE_EXPORT QgsDiagramLayerSettings
{
  public:

    //avoid inclusion of QgsPalLabeling
    enum Placement
    {
      AroundPoint = 0, // Point / Polygon
      OverPoint, // Point / Polygon
      Line, // Line / Polygon
      Curved, // Line
      Horizontal, // Polygon
      Free // Polygon
    };

    enum LinePlacementFlag
    {
      OnLine    = 1,
      AboveLine = 1 << 1,
      BelowLine = 1 << 2,
      MapOrientation = 1 << 4,
    };
    Q_DECLARE_FLAGS( LinePlacementFlags, LinePlacementFlag )

    
    enum Property
    {
      BackgroundColor, 
      StrokeColor, 
      StrokeWidth, 
      PositionX, 
      PositionY, 
      Distance, 
      Priority, 
      ZIndex, 
      IsObstacle, 
      Show, 
      AlwaysShow, 
      StartAngle, 
    };

    static const QgsPropertiesDefinition &propertyDefinitions();

    QgsDiagramLayerSettings();

    QgsDiagramLayerSettings( const QgsDiagramLayerSettings &rh );

    QgsDiagramLayerSettings &operator=( const QgsDiagramLayerSettings &rh );

    ~QgsDiagramLayerSettings();

    Placement placement() const { return mPlacement; }

    void setPlacement( Placement value ) { mPlacement = value; }

    LinePlacementFlags linePlacementFlags() const { return mPlacementFlags; }

    void setLinePlacementFlags( LinePlacementFlags flags ) { mPlacementFlags = flags; }

    int priority() const { return mPriority; }

    void setPriority( int value ) { mPriority = value; }

    double zIndex() const { return mZIndex; }

    void setZIndex( double index ) { mZIndex = index; }

    bool isObstacle() const { return mObstacle; }

    void setIsObstacle( bool isObstacle ) { mObstacle = isObstacle; }

    double distance() const { return mDistance; }

    void setDistance( double distance ) { mDistance = distance; }

    QgsDiagramRenderer *renderer() { return mRenderer; }

    const QgsDiagramRenderer *renderer() const { return mRenderer; } SIP_SKIP

    void setRenderer( QgsDiagramRenderer *diagramRenderer SIP_TRANSFER );

    QgsCoordinateTransform coordinateTransform() const { return mCt; }

    void setCoordinateTransform( const QgsCoordinateTransform &transform );

    bool showAllDiagrams() const { return mShowAll; }

    void setShowAllDiagrams( bool showAllDiagrams ) { mShowAll = showAllDiagrams; }

    void readXml( const QDomElement &elem );

    void writeXml( QDomElement &layerElem, QDomDocument &doc ) const;

    bool prepare( const QgsExpressionContext &context = QgsExpressionContext() ) const;

    QSet< QString > referencedFields( const QgsExpressionContext &context = QgsExpressionContext() ) const;

    QgsPropertyCollection &dataDefinedProperties() { return mDataDefinedProperties; }

    const QgsPropertyCollection &dataDefinedProperties() const { return mDataDefinedProperties; } SIP_SKIP

    void setDataDefinedProperties( const QgsPropertyCollection &collection ) { mDataDefinedProperties = collection; }

  private:

    QgsCoordinateTransform mCt;

    Placement mPlacement = AroundPoint;

    LinePlacementFlags mPlacementFlags = OnLine;

    int mPriority = 5;

    double mZIndex = 0.0;

    bool mObstacle = false;

    double mDistance = 0.0;

    QgsDiagramRenderer *mRenderer = nullptr;

    bool mShowAll = true;

    QgsPropertyCollection mDataDefinedProperties;

    static void initPropertyDefinitions();

    static QgsPropertiesDefinition sPropertyDefinitions;

};

class CORE_EXPORT QgsDiagramSettings
{
  public:

    enum LabelPlacementMethod
    {
      Height,
      XHeight
    };

    enum DiagramOrientation
    {
      Up,
      Down,
      Left,
      Right
    };

    enum Direction
    {
      Clockwise, 
      Counterclockwise, 
    };

    QgsDiagramSettings();
    ~QgsDiagramSettings();

    QgsDiagramSettings( const QgsDiagramSettings &other );

    QgsDiagramSettings &operator=( const QgsDiagramSettings &other );

    bool enabled = true;
    QFont font;
    QList< QColor > categoryColors;
    QList< QString > categoryAttributes;
    QList< QString > categoryLabels;
    QSizeF size; //size

    QgsUnitTypes::RenderUnit sizeType = QgsUnitTypes::RenderMillimeters;

    QgsMapUnitScale sizeScale;

    QgsUnitTypes::RenderUnit lineSizeUnit = QgsUnitTypes::RenderMillimeters;

    QgsMapUnitScale lineSizeScale;

    QColor backgroundColor;
    QColor penColor;
    double penWidth = 0.0;
    LabelPlacementMethod labelPlacementMethod = QgsDiagramSettings::Height;
    DiagramOrientation diagramOrientation = QgsDiagramSettings::Up;
    double barWidth = 5.0;

    double opacity = 1.0;

    bool scaleByArea = true;

    double rotationOffset = 270;

    bool scaleBasedVisibility = false;

    double maximumScale = 0;

    double minimumScale = 0;

    double minimumSize = 0.0;

    double spacing() const { return mSpacing; }

    void setSpacing( double spacing ) { mSpacing = spacing; }

    void setSpacingUnit( QgsUnitTypes::RenderUnit unit ) { mSpacingUnit = unit; }

    QgsUnitTypes::RenderUnit spacingUnit() const { return mSpacingUnit; }

    void setSpacingMapUnitScale( const QgsMapUnitScale &scale ) { mSpacingMapUnitScale = scale; }

    const QgsMapUnitScale &spacingMapUnitScale() const { return mSpacingMapUnitScale; }

    Direction direction() const;

    void setDirection( Direction direction );

    void readXml( const QDomElement &elem, const QgsReadWriteContext &context = QgsReadWriteContext() );
    void writeXml( QDomElement &rendererElem, QDomDocument &doc, const QgsReadWriteContext &context = QgsReadWriteContext() ) const;

    QList< QgsLayerTreeModelLegendNode * > legendItems( QgsLayerTreeLayer *nodeLayer ) const SIP_FACTORY;

    QgsLineSymbol *axisLineSymbol() const;

    void setAxisLineSymbol( QgsLineSymbol *symbol SIP_TRANSFER );

    bool showAxis() const;

    void setShowAxis( bool showAxis );

    QgsPaintEffect *paintEffect() const;

    void setPaintEffect( QgsPaintEffect *effect SIP_TRANSFER );

  private:

    double mSpacing = 0;
    QgsUnitTypes::RenderUnit mSpacingUnit = QgsUnitTypes::RenderMillimeters;
    QgsMapUnitScale mSpacingMapUnitScale;
    Direction mDirection = Counterclockwise;

    bool mShowAxis = false;
    std::unique_ptr< QgsLineSymbol > mAxisLineSymbol;
    std::unique_ptr< QgsPaintEffect > mPaintEffect;

};

class CORE_EXPORT QgsDiagramInterpolationSettings
{
  public:
    QSizeF lowerSize;
    QSizeF upperSize;
    double lowerValue;
    double upperValue;

    QString classificationField;

    QString classificationAttributeExpression;
    bool classificationAttributeIsExpression;
};


class CORE_EXPORT QgsDiagramRenderer
{

#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( sipCpp->rendererName() == QStringLiteral( "SingleCategory" ) )
      sipType = sipType_QgsSingleCategoryDiagramRenderer;
    else if ( sipCpp->rendererName() == QStringLiteral( "LinearlyInterpolated" ) )
      sipType = sipType_QgsLinearlyInterpolatedDiagramRenderer;
    else
      sipType = NULL;
    SIP_END
#endif

  public:

    QgsDiagramRenderer() = default;
    virtual ~QgsDiagramRenderer() = default;

    virtual QgsDiagramRenderer *clone() const = 0 SIP_FACTORY;

    virtual QSizeF sizeMapUnits( const QgsFeature &feature, const QgsRenderContext &c ) const;

    virtual QString rendererName() const = 0;

    virtual QList<QString> diagramAttributes() const = 0;

    virtual QSet< QString > referencedFields( const QgsExpressionContext &context = QgsExpressionContext() ) const;

    void renderDiagram( const QgsFeature &feature, QgsRenderContext &c, QPointF pos, const QgsPropertyCollection &properties = QgsPropertyCollection() ) const;

    void setDiagram( QgsDiagram *d SIP_TRANSFER );
    QgsDiagram *diagram() const { return mDiagram.get(); }

    virtual QList<QgsDiagramSettings> diagramSettings() const = 0;

    virtual void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) = 0;

    virtual void writeXml( QDomElement &layerElem, QDomDocument &doc, const QgsReadWriteContext &context ) const = 0;

    virtual QList< QgsLayerTreeModelLegendNode * > legendItems( QgsLayerTreeLayer *nodeLayer ) const SIP_FACTORY;

    bool attributeLegend() const { return mShowAttributeLegend; }

    void setAttributeLegend( bool enabled ) { mShowAttributeLegend = enabled; }

  protected:
    QgsDiagramRenderer( const QgsDiagramRenderer &other );
    QgsDiagramRenderer &operator=( const QgsDiagramRenderer &other );

    virtual bool diagramSettings( const QgsFeature &feature, const QgsRenderContext &c, QgsDiagramSettings &s ) const = 0;

    virtual QSizeF diagramSize( const QgsFeature &features, const QgsRenderContext &c ) const = 0;

    void convertSizeToMapUnits( QSizeF &size, const QgsRenderContext &context ) const;

    static int dpiPaintDevice( const QPainter * );

    //read / write diagram

    void _readXml( const QDomElement &elem, const QgsReadWriteContext &context );

    void _writeXml( QDomElement &rendererElem, QDomDocument &doc, const QgsReadWriteContext &context ) const;

    std::unique_ptr< QgsDiagram > mDiagram;

    bool mShowAttributeLegend = true;
};

class CORE_EXPORT QgsSingleCategoryDiagramRenderer : public QgsDiagramRenderer
{
  public:

    QgsSingleCategoryDiagramRenderer() = default;

    QgsSingleCategoryDiagramRenderer *clone() const override SIP_FACTORY;

    QString rendererName() const override { return QStringLiteral( "SingleCategory" ); }

    QList<QString> diagramAttributes() const override { return mSettings.categoryAttributes; }

    void setDiagramSettings( const QgsDiagramSettings &s ) { mSettings = s; }

    QList<QgsDiagramSettings> diagramSettings() const override;

    void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
    void writeXml( QDomElement &layerElem, QDomDocument &doc, const QgsReadWriteContext &context ) const override;

    QList< QgsLayerTreeModelLegendNode * > legendItems( QgsLayerTreeLayer *nodeLayer ) const override SIP_FACTORY;

  protected:
    bool diagramSettings( const QgsFeature &feature, const QgsRenderContext &c, QgsDiagramSettings &s ) const override;

    QSizeF diagramSize( const QgsFeature &, const QgsRenderContext &c ) const override;

  private:
    QgsDiagramSettings mSettings;
};

class CORE_EXPORT QgsLinearlyInterpolatedDiagramRenderer : public QgsDiagramRenderer
{
  public:
    QgsLinearlyInterpolatedDiagramRenderer();
    ~QgsLinearlyInterpolatedDiagramRenderer() override;

    QgsLinearlyInterpolatedDiagramRenderer *clone() const override SIP_FACTORY;

    QList<QgsDiagramSettings> diagramSettings() const override;

    void setDiagramSettings( const QgsDiagramSettings &s ) { mSettings = s; }

    QList<QString> diagramAttributes() const override;

    QSet< QString > referencedFields( const QgsExpressionContext &context = QgsExpressionContext() ) const override;

    QString rendererName() const override { return QStringLiteral( "LinearlyInterpolated" ); }

    void setLowerValue( double val ) { mInterpolationSettings.lowerValue = val; }
    double lowerValue() const { return mInterpolationSettings.lowerValue; }

    void setUpperValue( double val ) { mInterpolationSettings.upperValue = val; }
    double upperValue() const { return mInterpolationSettings.upperValue; }

    void setLowerSize( QSizeF s ) { mInterpolationSettings.lowerSize = s; }
    QSizeF lowerSize() const { return mInterpolationSettings.lowerSize; }

    void setUpperSize( QSizeF s ) { mInterpolationSettings.upperSize = s; }
    QSizeF upperSize() const { return mInterpolationSettings.upperSize; }

    QString classificationField() const { return mInterpolationSettings.classificationField; }

    void setClassificationField( const QString &field ) { mInterpolationSettings.classificationField = field; }

    QString classificationAttributeExpression() const { return mInterpolationSettings.classificationAttributeExpression; }
    void setClassificationAttributeExpression( const QString &expression ) { mInterpolationSettings.classificationAttributeExpression = expression; }

    bool classificationAttributeIsExpression() const { return mInterpolationSettings.classificationAttributeIsExpression; }
    void setClassificationAttributeIsExpression( bool isExpression ) { mInterpolationSettings.classificationAttributeIsExpression = isExpression; }

    void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
    void writeXml( QDomElement &layerElem, QDomDocument &doc, const QgsReadWriteContext &context ) const override;

    QList< QgsLayerTreeModelLegendNode * > legendItems( QgsLayerTreeLayer *nodeLayer ) const override SIP_FACTORY;

    void setDataDefinedSizeLegend( QgsDataDefinedSizeLegend *settings SIP_TRANSFER );

    QgsDataDefinedSizeLegend *dataDefinedSizeLegend() const;

  protected:
    bool diagramSettings( const QgsFeature &feature, const QgsRenderContext &c, QgsDiagramSettings &s ) const override;

    QSizeF diagramSize( const QgsFeature &, const QgsRenderContext &c ) const override;

    QgsLinearlyInterpolatedDiagramRenderer( const QgsLinearlyInterpolatedDiagramRenderer &other );

  private:
    QgsDiagramSettings mSettings;
    QgsDiagramInterpolationSettings mInterpolationSettings;

    QgsDataDefinedSizeLegend *mDataDefinedSizeLegend = nullptr;
};

#endif // QGSDIAGRAMRENDERER_H