qgspointdisplacementrenderer.h

Go to the documentation of this file.

/***************************************************************************
                              qgspointdisplacementrenderer.cpp
                              --------------------------------
  begin                : January 26, 2010
  copyright            : (C) 2010 by Marco Hugentobler
  email                : marco at hugis dot net
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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 QGSPOINTDISPLACEMENTRENDERER_H
#define QGSPOINTDISPLACEMENTRENDERER_H
 
#include "qgis.h"
#include "qgis_core.h"
#include "qgspointdistancerenderer.h"

class CORE_EXPORT QgsPointDisplacementRenderer : public QgsPointDistanceRenderer
{
  public:
    enum Placement
    {
      Ring,            
      ConcentricRings, 
      Grid             
    };

    QgsPointDisplacementRenderer( const QString &labelAttributeName = QString() );
 
    Qgis::FeatureRendererFlags flags() const override;
    QgsPointDisplacementRenderer *clone() const override SIP_FACTORY;
    void startRender( QgsRenderContext &context, const QgsFields &fields ) override;
    void stopRender( QgsRenderContext &context ) override;
    QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) override;
    QSet<QString> usedAttributes( const QgsRenderContext &context ) const override;
    bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;

    static QgsFeatureRenderer *create( QDomElement &symbologyElem, const QgsReadWriteContext &context ) SIP_FACTORY;

    void setCircleWidth( double width ) { mCircleWidth = width; }

    double circleWidth() const { return mCircleWidth; }

    void setCircleColor( const QColor &color ) { mCircleColor = color; }

    QColor circleColor() const { return mCircleColor; }

    void setCircleRadiusAddition( double distance ) { mCircleRadiusAddition = distance; }

    double circleRadiusAddition() const { return mCircleRadiusAddition; }

    void setLabelDistanceFactor( double factor ) { mLabelDistanceFactor = factor; }

    double labelDistanceFactor() const { return mLabelDistanceFactor; }

    Placement placement() const { return mPlacement; }

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

    QgsMarkerSymbol *centerSymbol();

    void setCenterSymbol( QgsMarkerSymbol *symbol SIP_TRANSFER );

    static QgsPointDisplacementRenderer *convertFromRenderer( const QgsFeatureRenderer *renderer ) SIP_FACTORY;
 
  private:
#ifdef SIP_RUN
    QgsPointDisplacementRenderer( const QgsPointDisplacementRenderer & );
    QgsPointDisplacementRenderer &operator=( const QgsPointDisplacementRenderer & );
#endif

    std::unique_ptr< QgsMarkerSymbol > mCenterSymbol;

    Placement mPlacement = Ring;

    double mCircleWidth = 0.4;
    QColor mCircleColor;
    double mCircleRadiusAddition = 0;
    double mLabelDistanceFactor = 0.5;
 
    void drawGroup( QPointF centerPoint, QgsRenderContext &context, const QgsPointDistanceRenderer::ClusteredGroup &group ) const override SIP_FORCE;
 
    //helper functions
    void calculateSymbolAndLabelPositions(
      QgsSymbolRenderContext &symbolContext,
      QPointF centerPoint,
      int nPosition,
      double symbolDiagonal,
      QList<QPointF> &symbolPositions,
      QList<QPointF> &labelShifts,
      double &circleRadius,
      double &gridRadius,
      int &gridSize,
      QVector<double> &diagonals
    ) const;
    void drawCircle( double radiusPainterUnits, QgsSymbolRenderContext &context, QPointF centerPoint, int nSymbols ) const;
    void drawSymbols( const ClusteredGroup &group, QgsRenderContext &context, const QList<QPointF> &symbolPositions ) const;
    void drawGrid( int gridSizeUnits, QgsSymbolRenderContext &context, QList<QPointF> pointSymbolPositions, int nSymbols ) const;
    void centralizeGrid( QList<QPointF> &pointSymbolPositions, double radius, int size ) const;
};
 
#endif // QGSPOINTDISPLACEMENTRENDERER_H